Simscape Component
Развертывание компонента языка Simscape как пользовательского блока в диаграмме модели
Библиотека
Утилиты
Описание
Блок Simscape Component позволяет вам сгенерировать блок Simscape™ непосредственно из текстового файла компонента, пропуская процесс сборки библиотеки.
Вы можете использовать ssc_build Команда, чтобы сгенерировать библиотеку пользовательских блоков из полного пакета файлов компонентов Simscape. Однако можно также выполнить преобразование файла компонента на лету непосредственно в пользовательский блок в модели с помощью блока Simscape Component.
Чтобы развернуть файл компонента непосредственно в блок:
Откройте библиотеку Simscape > Utilities и добавьте блок Simscape Component к модели. Сначала блок не указывает ни на один файл компонента. Поэтому у него нет никаких портов, и значок блока утверждает, что он
Unspecified.
Дважды кликните блок, чтобы открыть диалоговое окно выбора исходного файла.
Перейдите к требуемому файлу компонента языка Simscape. Файл не должен быть в пакете. Однако директория, в котором находится файл, должен находиться в MATLAB® путь. Если файл находится в пакете, то родительская директория пакета должен находиться в пути MATLAB.
Если вы выбрали файл, который не указан в пути MATLAB, откроется диалоговое окно File Not On Path. Нажмите Add.
Нажмите кнопку OK, чтобы закрыть диалоговое окно выбора файлов. Значок блока меняется, и блок получает порты, параметры и переменные на основе выбранного исходного компонента.
Если вы теперь дважды кликните блок, его диалоговое окно имеет все те же элементы, как если бы он был сгенерирован из файла компонента через процесс сборки библиотеки: имя, описание, параметры, переменные и ссылка на Source code. Однако диалоговое окно блока имеет дополнительную кнопку Choose source, которая позволяет указывать блок на другой файл компонента.
Диалоговое окно «Выбор исходного файла»
Когда блок Simscape Component указывает на действительный файл компонента языка Simscape, его диалоговое окно имеет имя, описание, параметры и переменные, заданные этим исходным файлом. Диалоговое окно селектора исходных файлов открывается в следующих случаях:
Когда вы добавляете новый Simscape Component блок к модели, чтобы позволить вам выбрать исходный файл компонента.
Когда вы нажимаете кнопку Choose source в существующем диалоговом окне Simscape Component блока, чтобы позволить вам выбрать другой исходный файл компонента.
Когда вы открываете модель с неразрешенным Simscape Component блоком (поскольку базовый исходный компонент больше не находится в пути) и дважды кликните блок, чтобы разрешить исходное расположение или выбрать другой исходный файл компонента.
Исходный файл компонента может быть найден:
В текущей рабочей директории
В директории по пути MATLAB
В пакете, с родительской директорией пакета на пути MATLAB
Чтобы указать исходный файл, можно либо просмотреть его, либо ввести его имя непосредственно в поле имени диалогового окна селектора:
Если вы вводите имя файла, оно должно удовлетворять требованиям расположения, перечисленным выше. Если файл находится в пакете, необходимо указать имя файла относительно корня пакета. Если эти условия не выполняются при вводе имени файла, исходное расположение не может быть разрешено, и вы получаете сообщение об ошибке.
Если вы просматриваете исходный файл, можно выбрать любой исходный или защищенный файл Simscape (то есть любой файл с
.sscили.sscpрасширение). Однако, если выбранный файл не удовлетворяет требованиям к расположению, откроется диалоговое окно Файл не по пути (File Not On Path). Щелкните 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 блок также становится неразрешенным. |