matlabFunctionBlock

Преобразуйте символьное выражение в блок MATLAB function

Описание

пример

matlabFunctionBlock(block,f) преобразует f в MATLAB® функциональный блок, который можно использовать в Simulink® модели. Здесь, f может быть символьным выражением, функцией или вектором символьных выражений или функций.

block задает имя блока, который вы создаете или изменяете.

пример

matlabFunctionBlock(block,f1,...,fN) преобразует символьные выражения или функции f1,...,fN к блоку MATLAB function с N выходы. Каждый элемент f1,...,fN может быть символьным выражением, функцией или вектором символьных выражений или функций.

пример

matlabFunctionBlock(___,Name,Value) преобразует символьное выражение, функцию или вектор символьных выражений или функций в блок MATLAB function с помощью дополнительных опций, заданных одной или несколькими Name,Value аргументы в виде пар. Можно задать Name,Value после входных параметров, используемых в предыдущих синтаксисах.

Примеры

свернуть все

Создайте новую модель и преобразуйте символьное выражение в блок MATLAB function. Включите комментарии в блок путем определения Comments опция.

Создайте новую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте символическое выражение.

syms x y z
f = x^2 + y^2 + z^2;

Использование matlabFunctionBlock чтобы создать блок my_block содержащее символическое выражение. matlabFunctionBlock перезаписывает существующие блоки. Дважды кликните сгенерированный блок, чтобы открыть и отредактировать функцию, определяющую блок.

matlabFunctionBlock('my_system/my_block',f)
function f = my_block(x,y,z)
%#codegen

%    This function was generated by the Symbolic Math Toolbox version 7.3.
%    01-Jan-2017 00:00:00

f = x.^2+y.^2+z.^2;

Включите комментарий Version 1.1 в блоке.

matlabFunctionBlock('my_system/my_block',f,'Comments','Version: 1.1')
function f = my_block(x,y,z)
...
%Version: 1.1
f = x.^2+y.^2+z.^2;

Сохраните и закройте my_system.

save_system('my_system')
close_system('my_system')

Создайте новую модель и преобразуйте символьную функцию в блок MATLAB function.

Создайте новую пустую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте символическую функцию.

syms x y z
f(x, y, z) = x^2 + y^2 + z^2;

Преобразование f в блок MATLAB function. Дважды кликните блок, чтобы увидеть функцию.

matlabFunctionBlock('my_system/my_block',f)
function f = my_block(x,y,z)
%#codegen
f = x.^2+y.^2+z.^2;

Преобразуйте несколько символьных выражений в блок MATLAB function с несколькими выходными портами.

Создайте новую пустую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте три символических выражения.

syms x y z
f = x^2;
g = y^2;
h = z^2;

Преобразуйте их в блок MATLAB function. matlabFunctionBlock создает блок с тремя выходными портами. Дважды кликните блок, чтобы увидеть функцию.

matlabFunctionBlock('my_system/my_block',f,g,h)
function [f,g,h] = my_block(x,y,z)
%#codegen
f = x.^2;
if nargout > 1
    g = y.^2;
end
if nargout > 2
    h = z.^2;
end

Определение имени функции, определяющей сгенерированный блок MATLAB function.

Создайте новую пустую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте символическое выражение.

syms x y z
f = x^2 + y^2 + z^2;

Сгенерируйте блок и установите имя функции на my_function. Дважды кликните блок, чтобы увидеть функцию.

matlabFunctionBlock('my_system/my_block',f,...
                    'FunctionName', 'my_function')
function f = my_function(x,y,z)
%#codegen
f = x.^2+y.^2+z.^2;

Когда вы преобразовываете символическое выражение в блок MATLAB function, matlabFunctionBlock оптимизирует код по умолчанию. Этот подход может помочь упростить и ускорить дальнейшие расчеты, которые используют файл. Тем не менее, сгенерирование оптимизированного кода из некоторых символьных выражений и функций может быть очень длительным. Использование Optimize отключить оптимизацию кода.

Создайте новую пустую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте символическое выражение.

syms x
r = x^2*(x^2 + 1);

Использование matlabFunctionBlock чтобы создать блок my_block содержащее символическое выражение. Дважды кликните блок, чтобы увидеть функцию, определяющую блок. По умолчанию, matlabFunctionBlock создает файл, содержащий оптимизированный код.

matlabFunctionBlock('my_system/my_block',r)
function r = my_block(x)
%#codegen
t2 = x.^2;
r = t2.*(t2+1.0);

Отключите оптимизацию кода, задав значение Optimize на false.

matlabFunctionBlock('my_system/my_block',r,...
                    'Optimize',false)
function r = my_block(x)
%#codegen
r = x.^2.*(x.^2+1.0);

Задайте порядок входных переменных, которые образуют входные порты в сгенерированном блоке.

Создайте новую пустую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте символическое выражение.

syms x y z
f = x^2 + y^2 + z^2;

Преобразуйте выражение в блок MATLAB function. По умолчанию, matlabFunctionBlock использует алфавитный порядок входных параметров при преобразовании символьных выражений.

matlabFunctionBlock('my_system/my_block',f)
function f = my_block(x,y,z)
%#codegen
f = x.^2+y.^2+z.^2;

Используйте Vars аргумент для определения порядка входных портов.

matlabFunctionBlock('my_system/my_block',f,...
                    'Vars', [y z x])
function f = my_block(y,z,x)
%#codegen
f = x.^2+y.^2+z.^2;

При генерации блока переименуйте выходные переменные и соответствующие порты.

Создайте новую пустую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте символическое выражение.

syms x y z
f = x^2 + y^2 + z^2;

Преобразуйте выражение в блок MATLAB function и задайте имена выходных переменных и портов. Дважды кликните блок, чтобы увидеть функцию, определяющую блок.

matlabFunctionBlock('my_system/my_block',f,f + 1,f + 2,...
                    'Outputs', {'name1','name2','name3'})
function [name1,name2,name3] = my_block(x,y,z)
%#codegen
t2 = x.^2;
t3 = y.^2;
t4 = z.^2;
name1 = t2+t3+t4;
if nargout > 1
    name2 = t2+t3+t4+1.0;
end
if nargout > 2
    name3 = t2+t3+t4+2.0;
end

Функции matlabFunctionBlock использование нескольких аргументов пары "имя-значение" одновременно.

Создайте новую пустую модель и откройте ее.

new_system('my_system')
open_system('my_system')

Создайте символическое выражение.

syms x y z
f = x^2 + y^2 + z^2;

Функции matlabFunctionBlock используя аргументы пары "имя-значение", чтобы задать имя функции, порядок входных портов и имена выходных портов. Дважды кликните блок, чтобы увидеть функцию, определяющую блок.

matlabFunctionBlock('my_system/my_block',f,f + 1,f + 2,...
                    'FunctionName', 'my_function','Vars',[y z x],...
                    'Outputs',{'name1','name2','name3'})
function [name1,name2,name3] = my_function(y,z,x)
%#codegen
t2 = x.^2;
t3 = y.^2;
t4 = z.^2;
name1 = t2+t3+t4;
if nargout > 1
    name2 = t2+t3+t4+1.0;
end
if nargout > 2
    name3 = t2+t3+t4+2.0;
end

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

свернуть все

Блок для создания модификации, заданный как вектор символов.

Символьный вход для преобразования в блок MATLAB function, заданный как символьное выражение, функция, вектор или матрица

Символьный вход, который будет преобразован в блок MATLAB function с N выходы, заданные как несколько символьных выражений, функций, векторов или матриц, разделенных запятыми.

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

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

Пример: matlabFunctionBlock('my_system/my_block',f,'FunctionName','myfun')

Комментарии для включения в заголовок файла, заданные как вектор символов, массив ячеек из векторов символов или строковый вектор.

Имя функции, заданное как вектор символов. По умолчанию matlabFunction(block,…) использует block как имя функции.

Смотрите Задать Имя Функции для Сгенерированной Функции.

Флаг, препятствующий оптимизации кода, задается как false или true.

При записи в файл, matlabFunctionBlock оптимизирует код с помощью промежуточных переменных с именем t0, t1, ....

См. «Отключить оптимизацию кода».

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

Количество заданных входных портов должно равняться или превышать количество свободных переменных в f. Не используйте те же имена для входных портов, заданных Vars и выходные порты, заданные как Outputs.

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

Смотрите Задать Входные Порты для Сгенерированного Блока.

Имена выхода портов, заданные как одномерный массив векторов символов. Если вы не задаете имена выхода портов, matlabFunctionBlock использует имена, которые состоят из слова out далее указываются выходы портов, например out3.

Не используйте те же имена для входных портов, заданных Vars и выходные порты, заданные как Outputs. См. «Задание выходных портов».

Введенный в R2009a