Создание пользовательских библиотек блоков

Обзор рабочего процесса

Чтобы сгенерировать библиотеку пользовательских блоков из Simscape™ файлов компонентов, выполните следующие шаги:

  1. Организуйте файлы Simscape. Файлы Simscape должны быть сохранены в директориях пакетов. Иерархия пакетов определяет полученную структуру библиотеки.

  2. Опционально обеспечьте защиту источника. Если вы хотите поделиться своими моделями с клиентами, не раскрывая источник компонента или области, можно сгенерировать файлы, защищенные Simscape, и поделиться ими.

  3. Создайте библиотеку пользовательских блоков. Для этого можно использовать обычные исходные файлы Simscape или защищенные файлы Simscape. Каждый пакет верхнего уровня генерирует отдельную пользовательскую библиотеку блоков Simscape.

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

Организация файлов Simscape

Файлы Simscape должны быть сохранены в директориях пакетов. Важными точками являются:

  • Имя директории пакета должно начинаться с + символ.

  • Остальная часть имени директории пакета (без + символ) должен быть допустимым MATLAB® идентификатор.

  • Родительская директория директории должен располагаться в пути MATLAB.

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

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

Для примера у вас может быть директория пакета верхнего уровня с именем +SimscapeCustomBlocksи имеет три подкаталога, +Electrical, +Hydraulic, и +Mechanical, каждый из которых содержит файлы Simscape. По умолчанию библиотека пользовательских блоков, сгенерированная из этого пакета, будет называться SimscapeCustomBlocks_lib (можно задать другое имя). Библиотека будет иметь три подмножества с именами, соответствующими подкаталогам пакета (Electrical, Hydraulic, и Mechanical). Для получения информации о создании пользовательских библиотек блоков см. Раздел «Преобразование файлов Simscape».

Использование защиты исходного кода для файлов Simscape

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

  • ssc_protect - Защищает отдельные файлы и директории. Если вы шифруете файлы, можно делиться ими, не раскрывая источник компонента или области. Используйте их, так же как и исходные файлы Simscape, чтобы создать пользовательский блок библиотеки с ssc_build команда.

  • ssc_mirror - Создает защищенную копию целого пакета в указанной директории. Установка флага позволяет вам также создать библиотеку пользовательского блока из защищенных файлов и поместить ее в зеркальную директорию, таким образом устраняя необходимость запуска ssc_build команда. Используйте ssc_mirror команда, чтобы быстро подготовить целый пакет для совместного использования с вашими клиентами, не раскрывая источник компонента или области.

В отличие от исходных файлов Simscape, которые имеют расширение .sscФайлы, защищенные Simscape, имеют расширение .sscp и не читаемы по-человечески. Можно использовать их, так же как и исходные файлы Simscape, для создания пользовательских библиотек блоков. Защищенные файлы должны быть организованы в директориях пакетов так же, как и исходные файлы Simscape. Для получения информации об организации файлов см. раздел «Организация файлов Simscape». Для получения информации о создании пользовательских библиотек блоков см. Раздел «Преобразование файлов Simscape».

Преобразование файлов Simscape

После того, как вы создали текстовые файлы компонентов и организовали их в директориях пакетов, необходимо преобразовать их в блоки Simscape, чтобы иметь возможность использовать их в блок-схемах. Вы делаете это, запуская ssc_build команда в директории пакета верхнего уровня, содержащем ваши файлы Simscape. Пакет может содержать либо обычные исходные файлы Simscape, либо защищенные файлы Simscape.

Например, у вас можешь быть директория пакета верхнего уровня, где вы храните свои файлы Simscape с именем +SimscapeCustomBlocks. Можно сгенерировать библиотеку пользовательских блоков либо из родительской директории пакета, либо из директории внутри пакета. Из родительской директории пакета в командной строке MATLAB введите:

ssc_build SimscapeCustomBlocks;

Примечание

Имя директории пакета начинается с начального + символ, в то время как аргумент ssc_build должен опускать + символ.

Эта команда генерирует Simulink® файл модели называется SimscapeCustomBlocks_lib в родительской директории пакета верхнего уровня (то есть в той же директории, который содержит ваш +SimscapeCustomBlocks пакет). Поскольку эта директория находится в пути MATLAB, можно открыть библиотеку, введя ее имя в командной строке MATLAB. В нашем примере введите:

SimscapeCustomBlocks_lib 

Файл модели, сгенерированный при запуске ssc_build Команда является пользовательской библиотекой Simscape, содержащей все подбрарии и блоки, сгенерированные из файлов Simscape, расположенных в пакете верхнего уровня. Когда вы открываете пользовательскую библиотеку Simscape, можно перетащить настроенные блоки из нее в модели.

При построении пользовательской библиотеки из пакета, ssc_build позволяет указать другое имя и расположение файла библиотеки, отличное от таковых по умолчанию. Для получения дополнительной информации см. ssc_build.

Создание сублибрариев

Директории пакетов могут быть организованы в подкаталоги с именами, также начинающимися со + символ. После того, как вы запустите ssc_build команда, каждый такой подкаталог будет отображаться в виде подбрючки под пользовательской библиотекой верхнего уровня. Вы можете настроить имя и внешний вид сублибрариев с помощью файлов строения библиотеки.

Примечание

Когда вы добавляете или изменяете файлы компонентов в подкаталогах пакета, вы все еще запускаете ssc_build команда в директории пакета верхнего уровня. Это обновляет все сублибрарии.

У вас может быть несколько директории пакетов верхнего уровня, то есть несколько директории пакетов, расположенных в директории по пути MATLAB. Каждая директория пакета верхнего уровня генерирует отдельную пользовательскую библиотеку верхнего уровня.

См. также

| |

Похожие примеры

Подробнее о