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

Основные функции Simscape

Каждая основная функция должна находиться в отдельном файле Simscape. Имя файла должно совпадать с именем функции. Например, функция foo должен находиться в файле с именем foo.ssc.

Файл функции Simscape должен начинаться с ключевого слова function, за которым следует заголовок функции, который включает имя функции, входы и выходы. Например:

function out = MyFunction(in1,in2)

Если функция имеет несколько возвращаемых значений, синтаксис:

function [out1,out2] = MyFunction(in1,in2)

Тело функции должно быть заключено внутри definitions раздел, например:

function out = SumSquared(in1,in2)
   definitions
      out = in1^2 + 2*in1*in2 + in2^2;
   end
end

Использование основных функций Simscape

Назначение основных функций Simscape состоит в повторном использовании выражений в уравнениях нескольких компонентов, а также в объявлениях членов файлов домена или компонента.

Например, экспоненциальные диодные уравнения часто используют выражение, которое является модификацией exp(i), для обеспечения защиты больших величин i. Для получения более подробной информации см. справочные страницы блоков Diode (Simscape Electrical) и NPN Bipolar Transistor (Simscape Electrical). В примере Функции Simscape показано, как можно записать функцию Simscape для повторного использования этого выражения вместо повторения его в каждом блоке:

function out = userFunction(x,y,z)
definitions
    out = if x > y
        (x-z)*exp(y);
    elseif x < -z
        (x+y)*exp(-z);
    else
        exp(x)
    end
end
end

Затем диодный блок может вызвать эту функцию с помощью y и z значения 80 и 79, соответственно:

equations
   o == SimscapeFunction.Use.Functions.userFunction(i,80,79);
end

и блок биполярного транзистора NPN может вызывать ту же функцию со значениями 40 и 39:

equations
   o == SimscapeFunction.Use.Functions.userFunction(i,40,39);
end

Рекомендуемые способы повторного использования кода

Язык Simscape имеет множество инструментов, облегчающих повторное использование кода. Функции Simscape и функции объявления позволяют повторно использовать выражения. Подклассификация и составные компоненты позволяют повторно использовать уравнения.

Чтобы повторно использовать выражения для нескольких компонентов:

Чтобы повторно использовать уравнения для нескольких компонентов:

Локальные функции Simscape

Локальные функции Simscape находятся внутри файла Simscape, который определяет компонент, домен или другую функцию и доступен только для этого компонента, домена или основной функции. Например, если необходимо использовать функцию только в одном компоненте, определяя ее как локальную функцию:

Включить локальную функцию Simscape в файл компонента, домена или функции после завершения end ключевое слово, которое завершает описание компонента, домена или основной функции. Например, это spring компонент использует локальную функцию для изменения уравнения крутящего момента:

component spring
  nodes
    r = foundation.mechanical.rotational.rotational;
    c = foundation.mechanical.rotational.rotational;
  end
  parameters
    k = { 10, 'N*m/rad' };
  end
  variables
    theta = { 0, 'rad' };
    t = { 0, 'N*m' };        % torque through
    w = { 0, 'rad/s' };      % velocity across
  end
  branches
    t : r.t -> c.t; % torque through from node r to node c
  end
  equations
    assert(k>0)     % spring rate must be greater than zero
    w == r.w - c.w; % velocity across between node r and node c
    t == localTorque(k,theta);
    w == theta.der;
  end
end

function out = localTorque(in1,in2)
   definitions
      out = (in1*in2)*9.76 + 0.25; % Modification made to torque relationship
   end
end

Правила синтаксиса для локальных функций аналогичны правилам для основных функций. См. раздел Правила синтаксиса.

В одном и том же компоненте, домене или файле функций может быть объявлено несколько локальных функций.

Локальные функции могут содержать вызовы других локальных функций, в том же файле или основных функций в других файлах. В случае конфликта имен локальные функции имеют более высокий приоритет вызова, чем основные функции.