symWriteSSC

Создайте новый компонент Simscape

Описание

пример

symWriteSSC(newComponentName,templateComponentName,eqns) создает новый компонент Simscape™ newComponentName использование существующего компонента templateComponentName как шаблон и добавление eqns. Таким образом, новый компонент имеет как существующие уравнения, взятые из компонента шаблона, так и добавленные уравнения.

пример

symWriteSSC(newComponentName,templateComponentName,eqns,Name,Value) использует дополнительные опции, заданные одним или несколькими Name,Value аргументы в виде пар.

Примеры

свернуть все

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

Предположим, что у вас есть компонент Simscape spring.ssc в текущей папке.

type('spring.ssc');
component spring < foundation.mechanical.rotational.branch

parameters
    spr_rate = { 10, 'N*m/rad' };
end

variables
    phi = { value = { 0, 'rad'}, priority = priority.high };
end

function setup
    if spr_rate <= 0
        pm_error('simscape:GreaterThanZero','Spring rate' )
    end
end

equations
    w == phi.der;
    t == spr_rate*phi;
end

end

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

syms spr_rate phi u

Создайте уравнение, определяющее энергетическую u.

eq = u == spr_rate*phi^2/2;

Создайте новый компонент, myRotationalSpring.ssc, это копия компонента spring.ssc с дополнительным уравнением, определяющим энергию вращательной пружины.

symWriteSSC('myRotationalSpring.ssc','spring.ssc',eq)
Warning: Equations contain undeclared variables 'u'. 
> In symWriteSSC (line 94) 

symWriteSSC создает компонент myRotationalSpring.ssc.

type('myRotationalSpring.ssc');
component myRotationalSpring

parameters
    spr_rate = { 10, 'N*m/rad' };
end

variables
    phi = { value = { 0, 'rad'}, priority = priority.high };
end

function setup
    if spr_rate <= 0
        pm_error('simscape:GreaterThanZero','Spring rate' )
    end
end

equations
    w == phi.der;
    t == spr_rate*phi;
    u == phi^2*spr_rate*(1.0/2.0);
end

end

Создайте компонент Simscape с заголовком и описательным текстом, отличным от текста компонента шаблона.

Предположим, что у вас есть компонент Simscape spring.ssc в текущей папке. Этот компонент не имеет никакого заголовка или описательного текста.

type('spring.ssc');
component spring < foundation.mechanical.rotational.branch

parameters
    spr_rate = { 10, 'N*m/rad' };
end

variables
    phi = { value = { 0, 'rad'}, priority = priority.high };
end

function setup
    if spr_rate <= 0
        pm_error('simscape:GreaterThanZero','Spring rate' )
    end
end

equations
    w == phi.der;
    t == spr_rate*phi;
end

end

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

syms spr_rate phi u

Создайте уравнение, определяющее энергетическую u.

eq = u == spr_rate*phi^2/2;

Создайте новый компонент, myRotationalSpring.ssc, на основе spring.ssc компонент. Добавьте уравнение eq, заголовок «Вращательная Пружина» и несколько линии описательного текста к новому компоненту.

symWriteSSC('myRotationalSpring.ssc','spring.ssc',eq,...
'H1Header','% Rotational Spring',...
'HelpText',{'% The block represents an ideal mechanical rotational linear spring.',...
            '% Connections R and C are mechanical rotational conserving ports.'...
            '% The block positive direction is from port R to port C. This means'...
            '% that the torque is positive if it acts in the direction from R to C.'})
Warning: Equations contain undeclared variables 'u'. 
> In symWriteSSC (line 94) 

symWriteSSC создает компонент myRotationalSpring.ssc.

type('myRotationalSpring.ssc');
component myRotationalSpring
% Rotational Spring
% The block represents an ideal mechanical rotational linear spring.
% Connections R and C are mechanical rotational conserving ports.
% The block positive direction is from port R to port C. This means
% that the torque is positive if it acts in the direction from R to C.

parameters
    spr_rate = { 10, 'N*m/rad' };
end

variables
    phi = { value = { 0, 'rad'}, priority = priority.high };
end

function setup
    if spr_rate <= 0
        pm_error('simscape:GreaterThanZero','Spring rate' )
    end
end

equations
    w == phi.der;
    t == spr_rate*phi;
    u == phi^2*spr_rate*(1.0/2.0);
end

end

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

свернуть все

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

Пример: 'MyNewComponent.ssc'

Имя шаблона компонента Simscape, заданное как имя файла, заключенное в одинарные кавычки. Файл должен иметь расширение .ssc. Если вы не предоставляете расширение файла, symWriteSSC принимает, что это .ssc. Компонент должен находиться в MATLAB® путь или в текущей папке.

Пример: 'TemplateComponent.ssc'

Символьные уравнения, заданные как вектор-строка.

Пример: [ y(t) == diff(x(t), t), m*diff(y(t), t, t) + b*y(t) + k*x(t) == F]

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: symWriteSSC('myComp.ssc','template.ssc',eq,'H1Header','% New title','HelpText',{'% Description of the','% new component'})

Заголовок, заданная как вектор-строка символов (тип char) начиная с%. Если первый символ не%, то symWriteSSC добавляет%.

Если компонент шаблона имеет заголовок, и вы используете H1Headerновый компонент будет иметь заголовок, заданную как H1Header. Если компонент шаблона имеет заголовок, и вы вызываете symWriteSSC без H1Headerновый компонент будет иметь тот же заголовок, что и компонент шаблона.

Пример: 'H1Header','% New title'

Описательный текст, заданный как массив ячеек из векторов-строк символов. Каждый вектор-строка должен начинаться с%. Если первый символ не%, то symWriteSSC добавляет%.

Если компонент шаблона имеет описательный текст, и вы используете HelpTextновый компонент будет иметь только текст, заданный как HelpText. В этом случае, symWriteSSC не копирует описательный текст компонента шаблона в новый компонент. Если компонент шаблона имеет заголовок, и вы вызываете symWriteSSC без HelpTextновый компонент будет иметь тот же описательный текст, что и компонент шаблона.

Пример: 'HelpText',{'% Description of the','% new component'}

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