add_block

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

Синтаксис

h = add_block(source,dest)
h = add_block(source,dest,'MakeNameUnique','on')
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(sourceIn,destIn,'CopyOption','duplicate') копирует блок импорта в подсистеме, давание места назначения блокирует тот же номер порта как исходный блок. Копируйте импорт в ответвление сигнал от входного порта, не создавая порт или добавив строки. Для получения дополнительной информации смотрите Копию Создания Inports.

пример

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: 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');

Добавьте Блок модели Привода от 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.

Можно также использовать синтаксис '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 (в)', 'myModel/mySubsystem/In1'

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

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

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

свернуть все

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

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

Была ли эта тема полезной?