Simscape Component

Разверните компонент языка Simscape как пользовательский блок в диаграмме модели

Библиотека

Утилиты

Описание

Блок Simscape Component позволяет вам сгенерировать блок Simscape™ непосредственно из текстового файла компонента, пропуская процесс сборки библиотеки.

Можно использовать ssc_build команда, чтобы сгенерировать библиотеку пользовательского блока от полного пакета файлов компонента Simscape. Однако можно также сделать непрерывное преобразование файла компонента непосредственно в пользовательский блок в модели при помощи блока Simscape Component.

Развернуть файл компонента непосредственно в блок-схему:

  1. Откройте библиотеку Simscape> Utilities и добавьте блок Simscape Component в вашу модель. Сначала, блок не указывает ни на какой файл компонента. Поэтому это не имеет никаких портов, и значок блока утверждает, что это - Unspecified.

  2. Дважды кликните блок, чтобы открыть диалоговое окно селектора исходного файла.

  3. Просмотрите к желаемому файлу компонента языка Simscape. Файл не должен быть в пакете. Однако директория, где файл находится, должна быть на пути MATLAB®. Если файл находится в пакете, то родительский каталог пакета должен быть на пути MATLAB.

  4. Если вы выбрали файл, который не находится на пути MATLAB, Файл Не На диалоговом окне Пути открывается. Нажмите Add.

  5. Нажмите OK, чтобы закрыть диалоговое окно селектора файла. Изменения значка блока и блок получают порты, параметры и переменные на основе выбранного исходного компонента.

    Если вы теперь дважды кликаете блок, его диалоговое окно имеет весь одинаковый элементы, как будто он был сгенерирован от файла компонента до процесса сборки библиотеки: имя, описание, параметры, переменные и ссылка на Source code. Однако диалоговое окно блока имеет дополнительную кнопку Choose source, которая позволяет вам указать блок на различный файл компонента.

Диалоговое окно селектора исходного файла

Когда блок Simscape Component указывает на допустимый файл компонента языка Simscape, его диалоговое окно имеет имя, описание, параметры и переменные, заданные тем исходным файлом. Диалоговое окно селектора исходного файла открывается в следующих случаях:

  • Когда вы добавляете новый блок Simscape Component в свою модель, чтобы позволить вам выбрать исходный файл компонента.

  • Когда вы нажимаете кнопку Choose source в существующем диалоговом окне блока Simscape Component, чтобы позволить вам выбрать файл компонента другого источника.

  • Когда вы открываете модель с неразрешенным блоком Simscape Component (потому что базовый исходный компонент больше не находится на пути), и дважды кликните блок, чтобы позволить вам разрешить исходное местоположение или выбрать файл компонента другого источника.

Исходный файл компонента может быть расположен:

  • В текущей рабочей директории

  • В директории на пути MATLAB

  • В пакете, с родительским каталогом пакета, находящимся на пути MATLAB

Чтобы задать исходный файл, можно или просмотреть к нему или ввести его имя непосредственно в поле имени селекторного диалогового окна:

  • Если вы вводите имя файла, оно должно удовлетворить требованиям местоположения, упомянутым выше. Если файл находится в пакете, необходимо обеспечить имя файла относительно корня пакета. Если эти условия не соблюдают, когда вы вводите имя файла, исходное местоположение не может быть разрешено, и вы получаете сообщение об ошибке.

  • Если вы просматриваете к исходному файлу, можно выбрать любой источник Simscape или защищенный файл (то есть, любой файл с .ssc или .sscp расширение. Однако, если выбранный файл не удовлетворяет требованиям местоположения, Файл Не На диалоговом окне Пути открывается. Нажмите Add, чтобы добавить соответствующую директорию в путь MATLAB и разрешить исходное местоположение. Если вы нажимаете Cancel, исходное местоположение не может быть разрешено, и исходный процесс выбора отменяется.

Когда исходное местоположение успешно разрешено, имя исходного файла появляется в текстовом поле диалогового окна селектора исходного файла. Имя блока, описание (при наличии) и ссылка на исходный код появляется в панели предварительного просмотра. Нажмите OK или Apply, чтобы указать блок Simscape Component на выбранный исходный файл:

  • Нажатие на Apply обновляет значок блока, закрывает диалоговое окно селектора файла и открывает диалоговое окно блока, которое содержит параметры и переменные.

  • Нажатие на OK обновляет значок блока и закрывает диалоговое окно селектора файла, но не открывает диалоговое окно блока. Дважды кликните блок, если вы хотите просмотреть или изменить параметры блоков и переменные.

Кнопки рядом с текстовым полем в диалоговом окне селектора исходного файла выполняют следующие действия:

Открывает файловый браузер, чтобы позволить вам выбрать исходный файл компонента. По умолчанию браузер отображает только файлы с .ssc или .sscp расширение. Если блок Simscape Component в настоящее время указывает на исходный файл, и исходное местоположение успешно разрешено, браузер открывается в директории, где тот исходный файл находится. В противном случае браузер открывается в текущей рабочей директории.
Обновляет панель предварительного просмотра диалогового окна селектора исходного файла. Если вы вводите исходное имя компонента непосредственно в текстовое поле селекторного диалогового окна, панель предварительного просмотра автоматически не обновляется. Если вы хотите предварительно просмотреть имя блока, описание или исходный код исходного компонента прежде, чем завершить выбор, нажмите эту кнопку.
Открывает диалоговое окно блока, которое содержит параметры и переменные на основе выбранного компонента. Эта кнопка и кнопка Choose source позволяют вам переключиться между селектором файла и диалоговым окном блока для блока Simscape Component.

Блокируйте вид значка

Вид значка блока Simscape Component изменяется в зависимости от состояния блока.

Блок Simscape Component в библиотеке.
Блок Simscape Component только добавил к модели, когда это еще не указывает на исходный компонент.
Блок Simscape Component, указывающий на допустимый файл компонента. Порты блока заданы базовым компонентом. По умолчанию значок блока отображает имя компонента (например, my_resistor). Если существует файл изображения с соответствующим именем (например, my_resistor.png) в той же директории как исходный файл компонента это изображение заменяет значок блока по умолчанию. Для получения дополнительной информации смотрите Настройку Значка Блока.
Блок Simscape Component, указывающий на неразрешенный файл компонента. Это может произойти, если исходный файл компонента был перемещен, или если это больше не находится на пути. Кнопка Add добавляет папку в путь только на время текущего сеанса работы с MATLAB. Если вы не сохраняете путь и затем открываете модель на последующем сеансе, блок Simscape Component становится неразрешенным. Если исходный компонент расположен в текущей рабочей директории, то нет никакого требования для него, чтобы быть на пути. Однако, если вы позже пытаетесь открыть модель из другой директории, блок Simscape Component также становится неразрешенным.

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Введенный в R2016a

Для просмотра документации необходимо авторизоваться на сайте