add_block

Aggiungere un blocco al modello

Sintassi

h = add_block(source,dest)

h = add_block(source,dest,'MakeNameUnique','on')

h = add_block(___,'CopyOption','nolink')

h = add_block(sourceIn,destIn,'CopyOption','duplicate')

h = add_block(___,Name,Value)

Descrizione

h = add_block(source,dest) aggiunge una copia del blocco source da una libreria o da un modello al modello di destinazione specificato e al nome del blocco. Questa sintassi crea il blocco nella stessa posizione in cui appare nel modello o nel modello della libreria.

Se si sta copiando tra modelli o da una libreria, caricare per primo il modello di destinazione.

h = add_block(source,dest,'MakeNameUnique','on') garantisce che il nome del blocco destinazione sia univoco nel modello. Questa sintassi aggiunge un numero al nome del blocco destinazione se esiste un blocco con quel nome, che aumenterà progressivamente per garantire di avere sempre un nome univoco.

h = add_block(___,'CopyOption','nolink') copia il blocco o il sottosistema source da una libreria senza creare un link al blocco libreria.

h = add_block(sourceIn,destIn,'CopyOption','duplicate') duplica un blocco porta di input in un sottosistema, dando al blocco di destinazione lo stesso numero di porta del blocco sorgente. Duplicare un blocco porta di input per diramare un segnale da una porta di input senza creare una porta o aggiungere linee. Per ulteriori informazioni, vedere Create Duplicate Inport Blocks.

h = add_block(___,Name,Value) utilizza argomenti Name,Value opzionali.

Specificare coppie opzionali di argomenti Name,Value separate da una virgola. Name è il nome dell’argomento e Value è il valore corrispondente. Name deve apparire tra virgolette. È possibile specificare diversi argomenti per le coppie nome e valore in qualsiasi ordine come Name1,Value1,...,NameN,ValueN.

Con la funzione add_block, è possibile utilizzare le coppie parametro dei blocchi e valore. Per un elenco di tutti i parametri dei blocchi, vedere Common Block Properties e Programmatically Specify Block Parameters and Properties.

Esempi

Aggiunta di un blocco al modello dalla libreria

È possibile aggiungere un blocco da una libreria utilizzando la funzione add_block con questi argomenti di input:

• Il percorso del blocco libreria dal livello superiore della gerarchia ad albero del browser delle librerie al blocco libreria che si desidera aggiungere, ad esempio 'Simulink/Math Operations/Gain'

• Il percorso completo del blocco dal livello superiore della gerarchia del modello, fino al punto in cui si desidera aggiungere il nuovo blocco, ad esempio 'myModel/mySubsystem/myblock'

Entrambi i percorsi devono terminare con un nome di blocco.

In questo esempio, si aggiunge un misuratore circolare personalizzabile al sottosistema Controller nel modello f14.

Aprire l'esempio. Quindi, caricare o aprire il modello di destinazione.

open_system('f14')

Si supponga di non conoscere il nome esatto del blocco necessario per completare questa attività o la posizione del blocco nell'albero del browser delle librerie. Per ottenere il percorso del blocco libreria, eseguire una ricerca per parola chiave nel browser delle librerie. Aprire il browser delle librerie. Nella finestra di ricerca, digitare gauge e premere Invio.

Nei risultati della ricerca, soffermarsi sull'icona del misuratore circolare. Il percorso del blocco libreria viene visualizzato da una tooltip.

Aggiungere il blocco Circular Gauge al sottosistema Controller. Denominare il blocco myGauge.

• Il percorso del blocco libreria è 'simulink_hmi_customizable_blocks/Circular Gauge'.

• Il percorso completo del blocco è 'f14/Controller/myGauge'.

add_block('simulink_hmi_customizable_blocks/Circular Gauge','f14/Controller/myGauge');

Per visualizzare il blocco nel modello f14, navigare nel sottosistema Controller.

open_system('f14/Controller')

Aggiunta di un blocco da un altro modello

Aggiungere una copia di un blocco dal modello f14 al modello vdp.

Caricare o aprire il modello di destinazione.

open_system('vdp');

Aggiungere il blocco Actuator Model dal modello f14 al modello vdp.

add_block('f14/Actuator Model','vdp/Actuator Model');

Aggiunta di un blocco utilizzando un nome univoco

Aggiungere un blocco Scope dalla libreria Simulink® al modello vdp. Poiché il modello vdp contiene già un blocco denominato Scope, utilizzare l'opzione MakeNameUnique per garantire che il nome del nuovo blocco sia univoco.

Caricare o aprire il modello di destinazione.

open_system('vdp');

Aggiungere il blocco Scope dalla libreria Simulink® Sinks al modello vdp, assicurandosi che il nome sia univoco.

add_block('simulink/Sinks/Scope','vdp/Scope','MakeNameUnique','on')

Duplicazione del bloccoInportnel sottosistema

Aggiungere un blocco Inport nel sottosistema f14/Controller che utilizzi lo stesso numero di porta di un altro blocco Inport in quel sottosistema.

Duplicare il blocco Inport denominato Stick Input (in) nel sottosistema Controller. Denominare la copia di Stick Input (in)2.

add_block('f14/Controller/Stick Input (in)',...
'f14/Controller/Stick Input (in)2','CopyOption','duplicate')

Il blocco risultante utilizza lo stesso numero di porta del blocco denominato Stick Input (in), ma non aggiunge una porta di input sul sottosistema superiore. Il segnale che entra in quella porta si dirama in entrambi i blocchi Inport.

Aggiunta di un blocco e impostazione dei parametri

Aggiungere un blocco da una libreria a un modello e impostare i parametri utilizzando un argomento nome-valore.

Caricare o aprire il modello di destinazione.

open_system('vdp');

Aggiungere un blocco Gain dalla libreria al modello vdp. Quindi, impostare il valore di Gain su 5.

add_block('simulink/Math Operations/Gain','vdp/Five','Gain','5')

Argomenti di input

source — Blocco da copiare nel modello

percorso del blocco | percorso del blocco libreria

Blocco da copiare nel modello, specificato come:

• Il percorso dell’intero blocco, se si sta copiando il blocco da un modello, ad esempio 'vdp/Mu'. Questo utilizzo copia il blocco e le sue impostazioni.

• Il percorso del blocco libreria, se si desidera aggiungere un blocco da una libreria, ad esempio 'simulink/Math Operations/Gain'.

  Per ottenere il percorso del blocco libreria, è possibile soffermarsi sul blocco nel browser delle librerie. In alternativa, è possibile aprire il modello della libreria, selezionare il blocco e inserire gcb nella riga di comando. Per aprire il modello della libreria, nel browser delle librerie, fare clic con il tasto destro del mouse sul nome della libreria nell’elenco delle librerie e selezionare Open library_name library.

È inoltre possibile utilizzare la sintassi 'built-in/blocktype' come percorso del blocco sorgente, dove blocktype è il nome del blocco programmatico -— il valore del parametro BlockType (vedere Common Block Properties). Tuttavia, i blocchi aggiunti utilizzando 'built-in/blocktype' a volte presentano valori dei parametri predefiniti diversi dai blocchi libreria.

Per i sottosistemi e i blocchi mascherati, utilizzare il percorso del blocco libreria. Utilizzando il valore BlockType (SubSystem) si crea un sottosistema vuoto.

Esempio 'vdp/Mu', 'simulink/Sinks/Scope'

dest — Nome e posizione del nuovo blocco

percorso del blocco

Nome e posizione del nuovo blocco nel modello, specificato come percorso del blocco.

Esempio 'f14/Controller/MyNewBlock'

sourceIn — Blocco porta di input da duplicare

percorso del blocco

Blocco porta di input da duplicare, specificato come percorso del blocco.

Esempio 'f14/Controller/Stick Input (in)', 'myModel/mySubsystem/In1'

destIn — Blocco porta di input da creare

percorso del blocco

Blocco porta di input da creare, specificato come percorso del blocco. Creare il blocco di destinazione nello stesso sistema come blocco sorgente.

Esempio 'myModel/mySubsystem/DupPortIn'

Argomenti di output

h — Nuovo blocco

handle

Nuovo blocco, restituito come handle.

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

delete_block

Argomenti

• Create and Edit Annotations Programmatically
• Programmatically Create Bus Element Ports