add_block

Добавьте блок в модель

Синтаксис

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 = (___,Name,Value)

Описание

пример

h = add_block(source,dest) добавляет копия блока source от библиотеки или модели к заданной целевой модели и имени блока. Этот синтаксис создает блок в том же местоположении, как это появляется в модели или модели библиотеки.

Если вы копируете между моделями или от библиотеки, загружаете целевую модель сначала.

пример

h = add_block(source,dest,'MakeNameUnique','on') гарантирует, что целевое имя блока уникально в модели. Этот синтаксис добавляет номер в целевое имя блока, если блок с тем именем существует, постепенно увеличиваясь, чтобы гарантировать уникальное имя.

h = add_block(___,'CopyOption','nolink') копирует блок или подсистему source от библиотеки, не создавая ссылку на блок библиотеки.

пример

h = add_block(sourceIn,destIn,'CopyOption','duplicate') копирует блок импорта в подсистеме, давание места назначения блокирует тот же номер порта как исходный блок. Копируйте импорт в ответвление сигнал от входного порта, не создавая порт или добавив строки. Для получения дополнительной информации смотрите Копию Создания Inports.

пример

h = (___,Name,Value) использует дополнительные аргументы Name,Value.

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

С функцией add_block можно использовать пары значения и параметры блоков. Для списка всех параметров блоков смотрите Common Block Properties и Специфичные для блока Параметры.

Примеры

свернуть все

Добавьте блок от библиотеки Simulink® до модели f14.

Загрузите или откройте целевую модель.

open_system('f14');

Добавьте блок Scope от библиотеки Simulink Sinks до f14, назвав новый блок MyScope.

add_block('simulink/Sinks/Scope','f14/MyScope');

Добавьте копию блока от модели f14 до vdp.

Загрузите или откройте целевую модель.

open_system('vdp');

Добавьте блок Model Привода от f14 до vdp.

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

Добавьте блок от Библиотеки Simulink до модели vdp. Поскольку уже существует блок под названием Осциллограф в vdp, используйте опцию MakeNameUnique, чтобы гарантировать, что новое имя блока уникально.

Загрузите или откройте целевую модель.

open_system('vdp');

Добавьте блок Scope от библиотеки Simulink Sinks до vdp, гарантируя, что имя уникально.

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

Добавьте блок импорта в подсистеме f14/Controller, которая использует тот же номер порта в качестве другого импорта в той подсистеме.

Копируйте Вход Палки (в) блоке в Подсистеме контроллера, назвав Вход Палки копии (в) 2. Получившийся блок использует тот же номер порта в качестве Входа Палки (в), но не добавляет импорт на родительской подсистеме. Сигнал, который вводит тот порт ответвления в оба импорта.

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

Добавьте блок от библиотеки до модели и установите параметры с помощью пары Name,Value.

Загрузите или откройте целевую модель.

open_system('vdp');

Добавьте блок Gain от библиотеки до vdp и установите значение Gain к 5.

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

Входные параметры

свернуть все

Блокируйтесь, чтобы скопировать в модель, заданную как:

  • Полный путь блока, если вы копируете блок от другой модели, например, 'vdp/Mu'. Это использование копирует блок и его настройки.

  • Путь блока библиотеки, если вы хотите добавить блок от библиотеки, например, 'simulink/Math Operations/Gain'.

    Чтобы получить библиотеку блокируют путь, можно навести на блок в Браузере Библиотеки. Также можно открыть модель библиотеки, выбрать блок и ввести gcb в командной строке. Чтобы открыть модель библиотеки, в Браузере Библиотеки, щелкают правой кнопкой по имени библиотеки по библиотеке, перечисляют и выбирают Open library_name library.

Можно также использовать синтаксис 'built-in/blocktype' в качестве пути исходного блока, где blocktype является программируемым именем блока - — значение параметра BlockType (см. Common Block Properties). Однако блоки, добавленные с помощью 'built-in/blocktype' иногда, имеют различные значения параметров по умолчанию от блоков библиотеки.

Для подсистем и маскированных блоков, используйте путь блока библиотеки. Используя значение BlockType (SubSystem) создает пустую подсистему.

Пример: 'vdp/Mu', 'simulink/Sinks/Scope'

Название и местоположение нового блока в модели, заданной как путь блока.

Пример: 'f14/Controller/MyNewBlock'

Блок Inport, чей номер порта, чтобы скопировать, заданный как путь блока.

Пример: 'f14/Controller/Stick Input (in)', 'myModel/mySubsystem/In1'

Блок Inport с дублирующимся номером порта, чтобы создать, заданный как путь блока. Создайте целевой блок в той же системе как исходный блок.

Пример: 'myModel/mySubsystem/DupPortIn'

Выходные аргументы

свернуть все

Новый блок, возвращенный как указатель.

Представлено до R2006a