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

Основные функции 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

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

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

и блок NPN Bipolar Transistor может вызвать ту же функцию со значениями 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

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

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

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