Exponenta Banner
exponenta event banner

sscnewfile

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

свернуть все на странице

Синтаксис

sscnewfile (имя)
sscnewfile (name,template_keyword)
sscnewfile (name,template_file)
sscnewfile -list

Описание

пример

sscnewfile(name) создает компонент с указанным name с использованием шаблона компонента по умолчанию. Функция автоматически сохраняет новый файл Simscape™, name, в текущей папке.

пример

sscnewfile(name,template_keyword) создает компонент с указанным name с использованием шаблона домена, указанного в template_keyword. Для получения списка доступных ключевых слов используйте -list вариант. Функция автоматически сохраняет новый файл Simscape, name, в текущей папке.

пример

sscnewfile(name,template_file) создает файл компонента, домена или функции с указанным name используя файл того же типа, template_file, в качестве шаблона. Имя файла шаблона должно содержать путь к файлу. Различные файлы шаблонов доступны в simscape.template пакет; однако в качестве шаблона можно использовать любой файл Simscape. Функция копирует содержимое файла шаблона в новый файл, заменяет имя компонента, домена или функции на nameи сохраняет новый файл в текущей папке.

пример

sscnewfile -list возвращает список доступных ключевых слов шаблона и перечисляет все файлы, доступные в simscape.template пакет.

Примеры

свернуть все

Создание компонента с именем MyComponent используя шаблон компонента по умолчанию, сохраните его как MyComponent.ssc в текущей папке.

sscnewfile('MyComponent')

Новый файл откроется в редакторе MATLAB ®.

component MyComponent
% Simple Simscape component

parameters
   % Add parameters here
   % p = { value , 'unit' }; % Parameter name
end

nodes
   % A = package_name.domain_name; % A:left
   % B = package_name.domain_name; % B:right
end

variables
   % x = { value , 'unit' }; % Through variable name
   % y = { value , 'unit' }; % Across variable name
end

branches
   % x : A.x -> B.x;
end

equations
   % Add equations here
   % y == A.y - B.y;
   % x == fcn(y);
end

end

Используйте этот файл в качестве начальной точки для разработки нового компонента. Строки, начинающиеся с % являются комментариями. При необходимости замените их фактическими объявлениями и уравнениями. Можно также удалить ненужные разделы и добавить другие, например components, connections, или intermediates.

Создание компонента с именем MyResistor использование шаблона компонента по умолчанию для электрической области и сохранение его как MyResistor.ssc в текущей папке.

sscnewfile('MyResistor','electrical')

Новый файл откроется в редакторе MATLAB.

component MyResistor
% Two-port electrical component

parameters
   % Add parameters here
   % R = { 1, 'Ohm' }; % Resistance
end

nodes
    p = foundation.electrical.electrical; % +:left
    n = foundation.electrical.electrical; % -:right
end

variables
    i = { 0, 'A' }; % Current
    v = { 0, 'V' }; % Voltage
end

branches
    i : p.i -> n.i;
end

equations
    % Voltage difference between nodes
    v == p.v - n.v;

    % Add equations here
    % v == i*R;
end

end

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

Создать домен с именем MyGasDomain использование газового домена Foundation в качестве шаблона и сохранение его как MyGasDomain.ssc в текущей папке.

sscnewfile('MyGasDomain', 'foundation.gas.gas')

Новый файл откроется в редакторе MATLAB. Имя нового домена: MyGasDomain, соответствует name аргумент. Остальная часть файла является копией определения газового домена Foundation.

Используйте этот файл в качестве начальной точки для создания нового домена. Измените параметры и свойства домена в соответствии с требованиями приложения.

Перечислите ключевые слова шаблона и файлы шаблона, доступные в simscape.template пакет.

sscnewfile -list
--------------------------------------------------------------------------
Template keywords
--------------------------------------------------------------------------
    default            simscape.template.simple_component
    electrical         simscape.template.electrical.two_port
    gas                simscape.template.gas.two_port_steady
    hydraulic          simscape.template.hydraulic.two_port
    magnetic           simscape.template.magnetic.two_port
    moist_air          simscape.template.moist_air.two_port_steady
    rotational         simscape.template.mechanical.rotational.two_port
    signal             simscape.template.signal.simple_component
    thermal            simscape.template.thermal.two_port
    thermal_liquid     simscape.template.thermal_liquid.two_port_steady
    translational      simscape.template.mechanical.translational.two_port
    two_phase_fluid    simscape.template.two_phase_fluid.two_port_steady
-------------------------------------------------
Files in package simscape.template
-------------------------------------------------
    simple_component    Simple Simscape component
    simple_function     
------------------------------------------------------------------
Files in package simscape.template.two_phase_fluid
------------------------------------------------------------------
    two_port_dynamic    Two-port dynamic two-phase fluid component
    two_port_steady     Two-port steady two-phase fluid component
-----------------------------------------------------------
Files in package simscape.template.mechanical.translational
-----------------------------------------------------------
    two_port    Two-port translational component
--------------------------------------------------------
Files in package simscape.template.mechanical.rotational
--------------------------------------------------------
    two_port    Two-port rotational component
--------------------------------------------
Files in package simscape.template.hydraulic
--------------------------------------------
    two_port    Two-port hydraulic component
------------------------------------------------------
Files in package simscape.template.gas
------------------------------------------------------
    two_port_dynamic    Two-port dynamic gas component
    two_port_steady     Two-port steady gas component
------------------------------------------
Files in package simscape.template.thermal
------------------------------------------
    two_port    Two-port thermal component
--------------------------------------------------------------
Files in package simscape.template.signal
--------------------------------------------------------------
    simple_component    Simple component with physical signals
-------------------------------------------
Files in package simscape.template.magnetic
-------------------------------------------
    two_port    Two-port magnetic component
-----------------------------------------------------------------
Files in package simscape.template.thermal_liquid
-----------------------------------------------------------------
    two_port_dynamic    Two-port dynamic thermal liquid component
    two_port_steady     Two-port steady thermal liquid component
------------------------------------------------------------
Files in package simscape.template.moist_air
------------------------------------------------------------
    two_port_dynamic    Two-port dynamic moist_air component
    two_port_steady     Two-port steady moist air component
---------------------------------------------
Files in package simscape.template.electrical
---------------------------------------------
    two_port    Two-port electrical component

Чтобы использовать один из этих файлов в качестве шаблона для нового компонента, укажите полный путь и имя файла в качестве второго входного аргумента, например: 'simscape.template.gas.two_port_dynamic'.

Входные аргументы

свернуть все

Имя нового компонента, домена или функции, указанного как вектор символа или скаляр строки. Это имя также служит именем создаваемого нового файла Simscape. Файл автоматически сохраняется в текущей папке.

Пример: 'MyResistor'

Типы данных: char | string

Тип файла компонента, используемого в качестве шаблона для нового файла, заданного как вектор символов или скаляр строки. Эти ключевые слова используются для создания файлов компонентов для определенного типа домена. Для получения списка доступных ключевых слов используйте -list вариант.

Пример: 'electrical'

Типы данных: char | string

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

Пример: 'foundation.electrical.elements.resistor'

Типы данных: char | string

См. также

| |

Темы

Представлен в R2019b

Документация по Simscape

Поддержка