symWriteSSC

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

Синтаксис

symWriteSSC(newComponentName,templateComponentName,eqns)
symWriteSSC(newComponentName,templateComponentName,eqns,Name,Value)

Описание

пример

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, заголовок “Вращательный Spring” и несколько строк описательного текста к новому компоненту.

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

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