add_block

Añadir un bloque a un modelo

Sintaxis

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)

Descripción

h = add_block(source,dest) añade una copia del bloque source de un modelo o biblioteca al modelo de destino y nombre del bloque especificados. Esta sintaxis crea el bloque en la misma ubicación en la que aparece en el modelo o el modelo de biblioteca.

Si está copiando entre modelos o desde una biblioteca, cargue primero el modelo de destino.

h = add_block(source,dest,'MakeNameUnique','on') asegura que el nombre del bloque de destino sea único en el modelo. Esta sintaxis añade un número al nombre del bloque de destino si existe un bloque con ese nombre, con incremento para asegurar un nombre único.

h = add_block(___,'CopyOption','nolink') copia el bloque o subsistema source de una biblioteca sin crear un enlace al bloque de biblioteca.

h = add_block(sourceIn,destIn,'CopyOption','duplicate') duplica un bloque de puerto de entrada en un subsistema, dando al bloque de destino el mismo número de puerto que el bloque de origen. Duplique un bloque de puerto de entrada para bifurcar una señal desde un puerto de entrada sin crear un puerto ni añadir líneas. Para obtener más información, consulte Create Duplicate Inport Blocks.

h = add_block(___,Name,Value) usa argumentos Name,Value opcionales.

Especifique pares de argumentos Name,Value separados por comas. Name es el nombre del argumento y Value es el valor correspondiente. Name debe aparecer entre comillas. Puede especificar varios argumentos de par nombre-valor en cualquier orden como Name1,Value1,...,NameN,ValueN.

Con la función add_block, puede usar pares de valores y parámetros de bloque. Para obtener una lista de todos los parámetros de bloque, consulte Common Block Properties y Programmatically Specify Block Parameters and Properties.

Ejemplos

Añadir un bloque a un modelo desde una biblioteca

Puede añadir un bloque desde una biblioteca usando la función add_block con estos argumentos de entrada:

• Ruta del bloque de biblioteca desde el nivel superior de la jerarquía de árbol de Library Browser hasta el bloque de biblioteca que desea añadir; por ejemplo, 'Simulink/Math Operations/Gain'.

• Ruta completa del bloque desde el nivel superior de la jerarquía del modelo hasta donde desee añadir el bloque nuevo; por ejemplo, 'myModel/mySubsystem/myblock'.

Ambas rutas deben terminar con el nombre de un bloque.

En este ejemplo, añada un indicador circular personalizable al subsistema Controller en el modelo f14.

Abra el ejemplo. Luego, cargue o abra el modelo de destino.

open_system('f14')

Supongamos que no sabe el nombre exacto del bloque necesario para completar esta tarea o la ubicación del bloque dentro del árbol de Library Browser. Para obtener la ruta del bloque de biblioteca, realice una búsqueda por palabra clave en Library Browser. Abra Library Browser. En el cuadro de búsqueda, introduzca gauge y presione Enter.

En los resultados de la búsqueda, coloque el cursor en el icono de indicador circular. Aparecerá ayuda contextual con la ruta del bloque de biblioteca.

Añada el bloque Circular Gauge al subsistema Controller. Asigne el nombre myGauge al bloque.

• La ruta del bloque de biblioteca es 'simulink_hmi_customizable_blocks/Circular Gauge'.

• La ruta del bloque completa es 'f14/Controller/myGauge'

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

Para ver el bloque, en el modelo f14, vaya al subsistema Controller.

open_system('f14/Controller')

Añadir un bloque de otro modelo

Añada una copia de un bloque del modelo f14 al modelo vdp.

Cargue o abra el modelo de destino.

open_system('vdp');

Añada el bloque Actuator Model del modelo f14 al modelo vdp.

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

Añadir un bloque usando un nombre único

Añada el bloque Scope de la biblioteca de Simulink® al modelo vdp. Dado que el modelo vdp ya contiene un bloque denominado Scope, use la opción MakeNameUnique para asegurarse de que el nombre del nuevo bloque sea único.

Cargue o abra el modelo de destino.

open_system('vdp');

Añada el bloque Scope de la biblioteca Sinks de Simulink® al modelo vdp, asegurándose de que el nombre sea único.

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

Duplicar el bloque Inport en el subsistema

Añada un bloque Inport en el subsistema f14/Controller que use el mismo número de puerto que otro bloque Inport en ese subsistema.

Duplique el bloque Inport denominado Stick Input (in) en el subsistema Controller. Asigne el nombre Stick Input (in)2 a la copia.

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

El bloque resultante usa el mismo número de puerto que el bloque denominado Stick Input (in), pero no añade un puerto de entrada en el subsistema principal. La señal que entra a ese puerto se bifurca a ambos bloques Inport.

Añadir un bloque y establecer parámetros

Añada un bloque de una biblioteca a un modelo y establezca los parámetros usando un argumento nombre-valor.

Cargue o abra el modelo de destino.

open_system('vdp');

Añada el bloque Gain de la biblioteca al modelo vdp. Luego, establezca el valor de Gain en 5.

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

Argumentos de entrada

source — Bloque para copiar al modelo

ruta del bloque | ruta del bloque de biblioteca

Bloque para copiar al modelo, especificado como:

• La ruta completa del bloque si está copiando el bloque de un modelo; por ejemplo, 'vdp/Mu'. Este uso copia el bloque y su configuración.

• La ruta del bloque de la biblioteca si desea añadir un bloque de una biblioteca; por ejemplo, 'simulink/Math Operations/Gain'.

  Para obtener la ruta del bloque de la biblioteca, puede hacer una pausa en el bloque en Library Browser. Alternativamente, puede abrir el modelo de la biblioteca, seleccionar el bloque y escribir gcb en la línea de comandos. Para abrir el modelo de la biblioteca, en Library Browser, haga clic con el botón secundario en el nombre de la biblioteca en la lista de bibliotecas y seleccione Open library_name library.

También puede usar la sintaxis 'built-in/blocktype' como la ruta del bloque de origen, donde blocktype es el nombre del bloque programático: el valor del parámetro BlockType (consulte Common Block Properties). Sin embargo, los bloques añadidos usando 'built-in/blocktype' a veces tienen valores de parámetros predeterminados diferentes de los bloques de la biblioteca.

Para subsistemas y bloques enmascarados, use la ruta del bloque de la biblioteca. Utilizar el valor BlockType (SubSystem) se crea un subsistema vacío.

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

dest — Nombre y ubicación del nuevo bloque

ruta del bloque

Nombre y ubicación del nuevo bloque en el modelo, especificados como la ruta del bloque.

Ejemplo: 'f14/Controller/MyNewBlock'

sourceIn — Bloque de puerto de entrada a duplicar

ruta del bloque

Bloque de puerto de entrada para duplicar, especificado como la ruta del bloque.

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

destIn — Bloque de puerto de entrada a crear

ruta del bloque

Bloque de puerto de entrada a crear, especificado como la ruta del bloque. Cree el bloque de destino en el mismo sistema que el bloque de origen.

Ejemplo: 'myModel/mySubsystem/DupPortIn'

Argumentos de salida

h — Nuevo bloque

identificador

Nuevo bloque, devuelto como un identificador.

Historial de versiones

Introducido antes de R2006a

Consulte también

delete_block

Temas

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