Exponenta Banner
exponenta event banner

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, название «Вращательная пружина» и несколько строк описательного текста к новому компоненту.

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

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

Поддержка