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, задавать выходное название и местоположение библиотеки. Для получения дополнительной информации о двойственности команд и функций смотрите, Выбирают Command Syntax или Function Syntax.

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 пакет используется в Пакете литий-ионного аккумулятора С Отказом Используя пример Массивов. Для получения дополнительной информации об этом пакете смотрите Тематическое исследование — Блок батарей с Отказом Используя Массивы.

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

Измените свою текущую рабочую директорию в директорию, содержащую +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. Для получения дополнительной информации о двойственности команд и функций смотрите, Выбирают Command Syntax или Function Syntax.

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

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

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

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

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