Создание библиотек авторского блока

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

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

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

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

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

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

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

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

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

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

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

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

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

Например, у вас может быть директория пакета верхнего уровня, названная +SimscapeCustomBlocks, и он имеет три подкаталога, Electrical, Hydraulic и Mechanical, каждый содержащий файлы Simscape. Библиотека авторского блока, сгенерированная от этого пакета, будет названа SimscapeCustomBlocks_lib и будет иметь три соответствующих подбиблиотеки. Для получения информации о создании библиотек авторского блока смотрите Преобразование Ваших файлов 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 на директории пакета верхнего уровня. Это обновляет все подбиблиотеки.

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

Связанные примеры

Больше о