Развертывание языкового компонента Simscape в виде пользовательского блока на схеме модели
Утилиты
Блок компонента Simscape позволяет создавать блок Simscape™ непосредственно из текстового файла компонента, пропуская процесс построения библиотеки.
Вы можете использовать ssc_build для создания пользовательской библиотеки блоков из полного пакета файлов компонентов Simscape. Однако с помощью блока компонента Simscape можно выполнить преобразование файла компонента непосредственно в пользовательский блок в модели.
Чтобы развернуть файл компонента непосредственно в блок-схеме, выполните следующие действия.
Откройте библиотеку «Simscape > Utilities» и добавьте в модель блок «Компонент Simscape». Сначала блок не указывает ни на один файл компонента. Поэтому он не имеет портов, и значок блока указывает, что он Unspecified.
Дважды щелкните блок, чтобы открыть диалоговое окно выбора исходного файла.
Перейдите к нужному файлу языкового компонента Simscape. Файл не обязательно должен находиться в пакете. Однако каталог, в котором находится файл, должен находиться по пути MATLAB ®. Если файл находится в пакете, то родительский каталог пакета должен находиться в пути MATLAB.
Если выбран файл, который не находится в пути MATLAB, откроется диалоговое окно «Файл не в пути». Нажмите "Добавить".
Нажмите кнопку ОК, чтобы закрыть диалоговое окно селектора файлов. Значок блока изменяется, и блок получает порты, параметры и переменные на основе выбранного исходного компонента.
Если теперь дважды щелкнуть блок, его диалоговое окно будет содержать все те же элементы, как если бы оно было создано из файла компонента в процессе построения библиотеки: имя, описание, параметры, переменные и ссылка на исходный код. Однако в диалоговом окне блока имеется дополнительная кнопка «Выбор источника», позволяющая указать блок на другой файл компонента.
Когда блок компонента Simscape указывает на допустимый файл компонента языка Simscape, его диалоговое окно имеет имя, описание, параметры и переменные, определенные этим исходным файлом. Диалоговое окно выбора исходного файла открывается в следующих случаях:
При добавлении нового блока компонента Simscape в модель можно выбрать исходный файл компонента.
При нажатии кнопки «Выбор источника» в существующем диалоговом окне «Компонент Simscape» можно выбрать другой файл исходного компонента.
При открытии модели с неразрешенным блоком «Компонент Simscape» (поскольку базовый исходный компонент больше не находится на пути) и двойном щелчке на блоке можно разрешить расположение источника или выбрать другой файл исходного компонента.
Можно найти исходный файл компонента:
В текущей рабочей папке
В каталоге по пути MATLAB
В пакете с родительским каталогом пакета по пути MATLAB
Чтобы указать исходный файл, можно либо перейти к нему, либо ввести его имя непосредственно в поле имени диалогового окна селектора:
При вводе имени файла он должен соответствовать указанным выше требованиям к расположению. Если файл находится в пакете, необходимо указать имя файла относительно корня пакета. Если эти условия не выполняются при вводе имени файла, исходное расположение не может быть разрешено, и появляется сообщение об ошибке.
При переходе к исходному файлу можно выбрать любой исходный или защищенный файл Simscape (то есть любой файл с .ssc или .sscp внутренний номер). Однако если выбранный файл не удовлетворяет требованиям к расположению, открывается диалоговое окно «Файл не по пути». Щелкните Добавить (Add), чтобы добавить соответствующий каталог к пути MATLAB и разрешить расположение источника. Если нажать кнопку Отмена (Cancel), исходное расположение не будет разрешено, и процесс выбора источника будет отменен.
После успешного разрешения исходного местоположения имя исходного файла отображается в текстовом поле диалогового окна выбора исходного файла. Имя блока, описание (если доступно) и ссылка на исходный код отображаются на панели предварительного просмотра. Нажмите «ОК» или «Применить», чтобы указать блок компонента Simscape на выбранный исходный файл:
Нажатие кнопки «Применить» обновляет значок блока, закрывает диалоговое окно селектора файлов и открывает диалоговое окно блока, содержащее параметры и переменные.
Нажатие кнопки «ОК» обновляет значок блока и закрывает диалоговое окно селектора файлов, но не открывает диалоговое окно блока. Дважды щелкните блок, если требуется просмотреть или изменить параметры и переменные блока.
Кнопки рядом с текстовым полем в диалоговом окне выбора исходного файла выполняют следующие действия:
 | Открытие обозревателя файлов, позволяющего выбрать исходный файл компонента. По умолчанию в браузере отображаются только файлы с .ssc или .sscp расширение. Если блок компонента Simscape в настоящее время указывает на исходный файл и местоположение источника успешно определено, браузер открывается в папке, в которой находится этот исходный файл. В противном случае браузер откроется в текущей рабочей папке. |
 | Обновление панели предварительного просмотра диалогового окна выбора исходного файла. При вводе имени исходного компонента непосредственно в текстовое поле диалогового окна селектора панель предварительного просмотра не обновляется автоматически. Чтобы просмотреть имя блока, описание или исходный код исходного компонента перед завершением выбора, нажмите эту кнопку. |
 | Открытие диалогового окна блока, содержащего параметры и переменные на основе выбранного компонента. Эта кнопка и кнопка выбора источника позволяют переключаться между селектором файлов и диалоговым окном блока компонента Simscape. |
Внешний вид значка блока компонента Simscape изменяется в зависимости от состояния блока.
| Блок компонента Simscape в библиотеке. |
| Блок Simscape Component только что добавлен в модель, если он еще не указывает на исходный компонент. |
 | Блок компонента Simscape, указывающий на допустимый файл компонента. Порты блока определяются базовым компонентом. По умолчанию значок блока отображает имя компонента (например, my_resistor). При наличии файла изображения с соответствующим именем (например, my_resistor.png) в том же каталоге, что и исходный файл компонента, это изображение заменяет значок блока по умолчанию. Для получения дополнительной информации см. раздел Настройка пиктограммы блокирования. |
 | блок «Компонент Simscape», указывающий на неразрешенный файл компонента. Это может произойти, если исходный файл компонента был перемещен или если он больше не находится в пути. Кнопка Добавить добавляет папку к пути только в течение текущего сеанса MATLAB. Если не сохранить траекторию и затем открыть модель в следующей сессии, блок компонента Simscape становится неразрешенным. Если исходный компонент находится в текущей рабочей папке, то нет необходимости, чтобы он находился в пути. Однако если позже попытаться открыть модель из другой папки, блок компонента Simscape также станет неразрешенным. |