Main Content

add_block

Ajouter des blocs à un modèle

Description

h = add_block(source,dest) ajoute une copie du bloc source depuis une bibliothèque ou un modèle vers le modèle de destination et le nom de bloc spécifiés. Cette syntaxe crée le bloc au même emplacement que celui auquel il apparaît dans le modèle ou dans le modèle de la bibliothèque.

Si vous effectuez une copie entre des modèles ou à partir d'une bibliothèque, commencez par charger le modèle de destination.

exemple

h = add_block(source,dest,'MakeNameUnique','on') veille à ce que le nom du bloc de destination soit unique au sein du modèle. Si un nom de bloc existe déjà, cette syntaxe ajoute un numéro au nom du bloc de destination, en l’incrémentant pour garantir l’unicité du nom.

exemple

h = add_block(___,'CopyOption','nolink') copie le bloc ou le sous-système source à partir d’une bibliothèque sans créer de lien avec le bloc de la bibliothèque.

h = add_block(sourceIn,destIn,'CopyOption','duplicate') duplique un bloc de port d'entrée dans un sous-système en attribuant au bloc de destination le même numéro de port que le bloc source. Dupliquez un bloc de port d'entrée pour raccorder un signal à partir d'un port d'entrée sans créer de port ni ajouter de lignes. Pour plus d’informations, consultez Create Duplicate Inport Blocks.

exemple

h = add_block(___,Name,Value) utilise les arguments facultatifs Name,Value.

Spécifiez des paires d'arguments facultatifs Name,Value séparées par des virgules. Name est le nom de l'argument et Value, la valeur correspondante. Name doit apparaître entre guillemets. Vous pouvez spécifier plusieurs paires d’arguments nom-valeur dans n'importe quel ordre sous la forme Name1,Value1,...,NameN,ValueN.

Avec la fonction add_block, vous pouvez utiliser des paires paramètre de bloc-valeur. Pour connaître la liste de l’ensemble des paramètres de bloc, consultez Common Block Properties et Programmatically Specify Block Parameters and Properties.

exemple

Exemples

réduire tout

Vous pouvez ajouter un bloc à partir d’une bibliothèque au moyen de la fonction add_block avec les arguments d’entrée suivants :

  • Chemin d’accès du bloc de bibliothèque depuis le niveau supérieur de l'arborescence de l'explorateur de bibliothèques jusqu'au bloc de bibliothèque que vous souhaitez ajouter, par exemple, 'Simulink/Math Operations/Gain'

  • Chemin d'accès complet du bloc depuis le niveau supérieur de la hiérarchie du modèle jusqu’à l’endroit où vous souhaitez ajouter le nouveau bloc, par exemple, 'myModel/mySubsystem/myblock'

Les deux chemins d’accès doivent se terminer par un nom de bloc.

Dans cet exemple, vous ajoutez un cadran circulaire personnalisable au sous-système Controller dans le modèle f14.

Ouvrez l'exemple. Chargez ensuite ou ouvrez le modèle de destination.

open_system('f14')

Supposons que vous ne connaissiez pas le nom exact du bloc nécessaire à la réalisation de cette tâche ou l'emplacement du bloc dans l'arborescence de l'explorateur de bibliothèques. Pour obtenir le chemin d’accès du bloc de bibliothèque, procédez à une recherche par mot clé dans l'explorateur de bibliothèques. Ouvrez l'explorateur de bibliothèques. Dans la zone de recherche, saisissez gauge, puis appuyez sur Entrée.

Dans les résultats de la recherche, faites une pause sur l'icône du cadran circulaire. Une infobulle indique le chemin d’accès du bloc de bibliothèque.

Ajoutez le bloc Cadran circulaire au sous-système Controller. Attribuez au bloc le nom myGauge.

  • Le chemin d’accès du bloc de bibliothèque est ‘simulink_hmi_customizable_blocks/Circular Gauge'.

  • Le chemin d’accès complet du bloc est ‘f14/Controller/myGauge'.

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

Pour afficher le bloc, dans le modèle f14, accédez au sous-système Controller.

open_system('f14/Controller')

Ajouter la copie d’un bloc du modèle f14 au modèle vdp.

Chargez ou ouvrez le modèle de destination.

open_system('vdp');

Ajoutez le bloc Modèle d'actionneur du modèle f14 au modèle vdp.

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

Ajouter un bloc Scope de la bibliothèque Simulink® au modèle vdp. Comme le modèle vdp contient déjà un bloc du nom de Scope, utilisez l’option MakeNameUnique pour faire en sorte que le nouveau nom de bloc soit unique.

Chargez ou ouvrez le modèle de destination.

open_system('vdp');

Ajoutez le bloc Scope de la bibliothèque Simulink® Sinks au modèle vdp en veillant à ce que son nom soit unique.

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

Ajoutez un bloc Inport au sous-système f14/Controller qui utilise le même numéro de port qu’un autre bloc Inport de ce même sous-système.

Dupliquez le bloc Inport du nom de Stick Input (in) dans le sous-système Controller. Attribuez à la copie le nom Stick Input (in)2.

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

Le bloc ainsi obtenu utilise le même numéro de port que le bloc du nom de Stick Input (in) mais n'ajoute pas de port d'entrée au sous-système parent. Le signal qui entre dans ce port est raccordé aux deux blocs Inport.

Ajouter un bloc d’une bibliothèque vers un modèle, puis définissez les paramètres au moyen d’un argument nom-valeur.

Chargez ou ouvrez le modèle de destination.

open_system('vdp');

Ajoutez un bloc Gain de la bibliothèque au modèle vdp. Définissez ensuite la valeur Gain sur 5.

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

Arguments d'entrée

réduire tout

Bloc à copier dans le modèle, spécifié comme suit :

  • Chemin d’accès complet du bloc si vous copiez le bloc depuis un modèle, par exemple, 'vdp/Mu'. Cette méthode copie le bloc et ses paramètres.

  • Chemin d’accès du bloc de bibliothèque si vous souhaitez ajouter un bloc depuis une bibliothèque, par exemple, 'simulink/Math Operations/Gain'.

    Pour obtenir le chemin d’accès du bloc de bibliothèque, vous pouvez effectuer une pause sur le bloc dans l'explorateur de bibliothèques. Vous pouvez également ouvrir le modèle de bibliothèque, sélectionner le bloc, puis saisir gcb dans la ligne de commande. Pour ouvrir le modèle de bibliothèque, dans l’explorateur de bibliothèques, cliquez avec le bouton droit de la souris sur le nom de la bibliothèque dans la liste et sélectionnez Open library_name library.

Vous pouvez également utiliser la syntaxe 'built-in/blocktype' en tant que chemin d’accès du bloc source, où blocktype désigne le nom de bloc programmatique, valeur du paramètre BlockType (voir Common Block Properties). Cependant, les blocs ajoutés au moyen de la syntaxe 'built-in/blocktype' présentent parfois des valeurs de paramètres par défaut différentes des blocs de bibliothèque.

Pour les sous-systèmes et les blocs masqués, utilisez le chemin d’accès du bloc de bibliothèque. La valeur BlockType (SubSystem) crée un sous-système vide.

Exemple : 'vdp/Mu', 'simulink/Sinks/Scope'

Nom et emplacement du nouveau bloc dans le modèle, indiqués sous la forme du chemin d’accès du bloc.

Exemple : 'f14/Controller/MyNewBlock'

Bloc de port d’entrée à dupliquer, indiqué sous la forme du chemin d’accès du bloc.

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

Bloc de port d’entrée à créer, indiqué sous la forme du chemin d’accès du bloc. Créez le bloc de destination dans le même système que le bloc source.

Exemple : 'myModel/mySubsystem/DupPortIn'

Arguments en sortie

réduire tout

Nouveau bloc retourné en tant que handle.

Historique des versions

Introduit avant R2006a