ssc_build

Создайте пользовательскую библиотеку из набора файлов Simscape

Описание

пример

ssc_build(package) генерирует пользовательский файл библиотеки Simscape™ из указанного пакета, package. Звонить ssc_build из родительской директории пакета, то есть из директории, содержащего директорию пакета верхнего уровня. Дополнительные сведения о структуре директорий пакетов см. в разделе Организация файлов Simscape.

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

пример

ssc_build(package,'-output',outputlibrary) генерирует пользовательский файл библиотеки Simscape из указанного пакета, package, с outputlibrary определение имени и расположения файла библиотеки. Этот синтаксис использует пару аргументов имя-значение, где '-output' - имя необязательного аргумента и outputlibrary - значение аргумента. Функция реализует частичное совпадение имен аргумента, поэтому задает '-o' так как имя аргумента также работает.

пример

ssc_build package - команда форма синтаксиса. Команду форма требует меньшего количества специальных символов. Вам не нужно вводить круглые скобки или заключать вход в одинарные или двойные кавычки. Разделите входы пространствами вместо запятыми.

Например, чтобы создать пакет с именем +MyPackage, эти операторы эквивалентны:

ssc_build MyPackage        % command form
ssc_build('MyPackage')     % function form

Можно также использовать форму команды с парой аргументов имя-значение, описанной в предыдущем синтаксисе, пока путь и имя библиотеки выхода являются вектором символов. Например, чтобы создать пакет с именем +MyPackage и сохраните библиотеку выхода следующим образом 'C:\Work\MyLibrary', эти операторы эквивалентны:

ssc_build MyPackage -output C:\Work\MyLibrary          % command form
ssc_build('MyPackage','-output','C:\Work\MyLibrary')   % function form

Не используйте командную форму при outputlibrary использует переменные или такие функции, как fullfile, чтобы задать имя и расположение выхода библиотеки. Для получения дополнительной информации о двойственности двойственности команд и функций Раздел «Выбор синтаксиса команды» или «Синтаксис функции».

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

Примеры

свернуть все

Предположим, что ваша директория пакета верхнего уровня, где вы храните свои файлы Simscape, названа +SimscapeCustomBlocks и расположен в C:\Work\MyLibraries.

Чтобы сгенерировать библиотеку пользовательских блоков, измените текущую рабочую директорию на C:\Work\MyLibraries. Затем, в MATLAB® Командная строка, введите:

ssc_build('SimscapeCustomBlocks');

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

ssc_build SimscapeCustomBlocks;

Эта команда генерирует Simulink® файл модели называется SimscapeCustomBlocks_lib в родительской директории пакета, C:\Work\MyLibraries (то есть в той же директории, который содержит вашу +SimscapeCustomBlocks пакет).

Предположим, что ваша директория пакета верхнего уровня, где вы храните свои файлы Simscape, названа +CustomElectricalBlocks и расположен в C:\Work. Вы хотите сгенерировать библиотеку пользовательских блоков из этого пакета, поместите ее в C:\Work\MyLibrariesи дать ему более короткое и содержательное имя, CustomDiodes. Вы делаете это, предоставляя пару аргумент имя-значение ssc_build функция.

Чтобы сгенерировать библиотеку пользовательских блоков, измените текущую рабочую директорию на C:\Work. Затем в командной строке MATLAB введите:

ssc_build('CustomElectricalBlocks','-output','C:\Work\MyLibraries\CustomDiodes')
Generating Simulink library 'CustomDiodes' in the output directory 'C:\Work\MyLibraries' ...

Этот вызов функции генерирует файл модели Simulink, называемый CustomDiodes.slx в указанной директории. Добавьте C:\Work\MyLibraries директория к пути MATLAB, чтобы облегчить использование этих пользовательских блоков в различных моделях.

Предположим, что ваш пакет с исходными файлами расположен в директории только для чтения. Для примера, +BatteryPack пакет используется в Блок батарей Lithium-Ion с отказом Используя Массивы пример. Для получения дополнительной информации об этом пакете смотрите Пример примера - Блока батарей с отказом с использованием массивов.

Чтобы сгенерировать библиотеку пользовательских блоков из +BatteryPack необходимо указать расположение для библиотеки выхода, отличное от родительской директории пакета, доступного только для чтения. Вы делаете это, предоставляя пару аргумент имя-значение ssc_build функция. В этом примере выхода директории name является вектор символов, что позволяет использовать команду форму синтаксиса.

Измените текущую рабочую директорию на директорию, содержащую +BatteryPack пакет.

cd(matlabroot)
cd toolbox/physmod/simscape/simscapedemos 

В командной строке MATLAB введите:

ssc_build BatteryPack -output C:\Work\BatteryPack_lib
Generating Simulink library 'BatteryPack_lib' in the output directory 'C:\Work' ...

Эта команда генерирует файл модели Simulink под названием BatteryPack_lib в указанной выходной директории, C:\Work.

Можно также воспользоваться частичным совпадением имен аргумента и еще больше сократить синтаксис команды:

ssc_build BatteryPack -o C:\Work\BatteryPack_lib

Эта команда эквивалентна предыдущей.

Входные параметры

свернуть все

Имя пакета, содержащего файлы Simscape, заданное в виде вектора символов или строкового скаляра и расположенное в директории, из которого вы вызываете ssc_build функция. package - имя директории пакета верхнего уровня без начального + символ. Когда вы звоните ssc_build используя синтаксис команды, не используйте кавычки вокруг package. Для получения дополнительной информации о двойственности двойственности команд и функций Раздел «Выбор синтаксиса команды» или «Синтаксис функции».

Пример: ssc_build MyPackage синтаксис команды для создания библиотеки из пакета +MyPackage. Синтаксис эквивалентной функции ssc_build('MyPackage').

Имя и расположение файла библиотеки блоков, сгенерированного из пакета, заданные в виде вектора символов или строкового скаляра. Когда вы звоните ssc_build используя синтаксис функции, можно также использовать переменный MATLAB MATLAB и функции, такие как fullfile или genpath, чтобы указать путь к файлу библиотеки.

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

Пример: fullfile(tempdir,'MyLibrary.slx') с синтаксисом функции можно использовать переменный MATLAB и функции, чтобы задать путь.

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