主要内容

matlabFunctionBlock

将符号表达式转换为MATLAB功能块

折叠所有页面

语法

matlabFunctionBlock(块)
matlabFunctionBlock (fN块,f1,…)
matlabFunctionBlock (___、名称、值)

描述

例子

matlabFunctionBlock (块，f）转换f到MATLAB®可以在Simulink中使用的函数块金宝app®模型。在这里,f可以是符号表达式、函数或符号表达式或函数的向量。

块指定要创建或修改的块的名称。

例子

matlabFunctionBlock (块，f1,…,fN）转换符号表达式或函数f1,…,fN到一个MATLAB函数块用N输出。的每个元素f1,…,fN可以是符号表达式、函数或符号表达式或函数的向量。

例子

matlabFunctionBlock (___，名称,值）使用一个或多个指定的附加选项将符号表达式、函数或符号表达式或函数的向量转换为MATLAB函数块名称,值对参数。你可以指定名称,值在前面语法中使用的输入参数之后。

例子

全部折叠

创建一个新模型并将符号表达式转换为MATLAB函数块。属性在块中包含注释评论选择。

创建一个新模型并打开它。

new_system (my_system) open_system(“my_system”)

创造一个象征性的表达。

Syms x y z f = x²+ y²+ z²;

使用matlabFunctionBlock要创建块my_block包含象征性的表达。matlabFunctionBlock覆盖现有的块。

matlabFunctionBlock (my_system / my_block, f)

MATLAB函数块为函数f = my_block(x,y,z)

双击生成的块，打开并编辑定义该块的函数。

这个函数是由符号数学工具箱7.3版生成的。f = x.^2+y.^2+z.^2;

包括注释版本1.1在街区里。

matlabFunctionBlock (my_system / my_block, f,“评论”,“版本:1.1”)
函数f = my_block(x,y,z)…f = x.^2+y.^2+z.^2;

保存并关闭my_system．

save_system (my_system) close_system(“my_system”)

创建一个新模型并将符号函数转换为MATLAB函数块。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创建一个符号函数。

信谊xyzF (x, y, z) = x²+ y²+ z²;

转换f到MATLAB函数块。双击块查看函数。

matlabFunctionBlock (“my_system / my_block”f)
函数f = my_block (x, y, z) % # codegen f = x ^ 2 + y ^ 2 + z。^ 2;

将几个符号表达式转换为具有多个输出端口的MATLAB函数块。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创造三个象征性的表达。

信谊xyzF = x^2;G = y^2;H = z^2;

将它们转换为MATLAB函数块。matlabFunctionBlock创建具有三个输出端口的块。双击块查看函数。

matlabFunctionBlock (“my_system / my_block”, f, g, h)
函数[f,g,h] = my_block(x,y,z) %#代码原f = x.^2;如果nargout > 1 g = y.^2;如果nargout > 2 h = z.^2;结束

指定定义生成的MATLAB函数块的函数的名称。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创造一个象征性的表达。

信谊xyzF = x²+ y²+ z²;

生成一个块，并将函数名称设置为my_function．双击块查看函数。

matlabFunctionBlock (“my_system / my_block”f.．.“FunctionName”，“my_function”）
函数f = my_function(x,y,z) %#代码原f = x.^2+y.^2+z.^2;

当您将符号表达式转换为MATLAB函数块时，matlabFunctionBlock默认情况下优化代码。这种方法可以帮助简化和加快使用该文件的进一步计算。然而，从一些符号表达式和函数生成优化的代码可能非常耗时。使用优化禁用代码优化。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创造一个象征性的表达。

信谊xR = x²*(x²+ 1);

使用matlabFunctionBlock要创建块my_block包含象征性的表达。双击该块以查看定义该块的函数。默认情况下,matlabFunctionBlock创建包含优化代码的文件。

matlabFunctionBlock (“my_system / my_block”右)
函数r = my_block(x) %#代码原t2 = x.^2;R = t2.*(t2+1.0);

的值禁用代码优化优化来假．

matlabFunctionBlock (“my_system / my_block”r.．.“优化”假)
函数r = my_block (x) % # codegen r = x ^ 2。* (x ^ 2 + 1.0);

指定在生成的块中形成输入端口的输入变量的顺序。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创造一个象征性的表达。

信谊xyzF = x²+ y²+ z²;

将表达式转换为MATLAB函数块。默认情况下,matlabFunctionBlock转换符号表达式时使用输入参数的字母顺序。

matlabFunctionBlock (“my_system / my_block”f)
函数f = my_block (x, y, z) % # codegen f = x ^ 2 + y ^ 2 + z。^ 2;

使用var参数指定输入端口的顺序。

matlabFunctionBlock (“my_system / my_block”f.．.“var”， [y z x])
函数f = my_block (y, z、x) % # codegen f = x ^ 2 + y ^ 2 + z。^ 2;

为自动生成的元素显式指定输入变量。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创建一个符号变量u还有一个3乘1的符号变量向量x．下面的命令还会自动生成符号变量x1，x2,x3在MATLAB工作空间中。

信谊u信谊x(3 - 1)谁
名称大小字节分类属性u 1x1 8 sym x 3x1 8 sym x1 1x1 8 sym x2 1x1 8 sym x3 1x1 8 sym

创建使用符号变量的符号表达式u而且x．

A = [0 10 0;0 0 1;-1 -2];B = [0;0;3);xdot = A*x+b*u
Xdot = x2 x3 3*u - x1 - x2 - 2*x3

转换xdot表达式转换为MATLAB函数块。因为元素xdot包含变量u以及自动生成的变量x1，x2,x3，指定var参数，而不是使用u而且x．

matlabFunctionBlock (“my_system / my_block”xdot,“var”, {u (x1, x2, x3})
函数xdot = my_block(u,x1,x2,x3) %#codegen xdot = [x2;x3;u.*3.0-x1-x2-x3.*2.0];

当生成一个块时，重命名输出变量和相应的端口。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创造一个象征性的表达。

信谊xyzF = x²+ y²+ z²;

将表达式转换为MATLAB函数块，并指定输出变量和端口的名称。双击该块以查看定义该块的函数。

matlabFunctionBlock (“my_system / my_block”f,f + 1,f + 2，.．.“输出”, {“name1”，“name2”，“name3”})
函数[name1,name2,name3] = my_block(x,y,z) %#代码原t2 = x.^2;T3 = y.^2;T4 = z.^2;Name1 = t2+t3+t4;nargout > 1 name2 = t2+t3+t4+1.0;如果name3 = t2+t3+t4+2.0;结束

调用matlabFunctionBlock同时使用多个名称-值对参数。

创建一个新的空模型并打开它。

new_system (“my_system”) open_system (“my_system”）

创造一个象征性的表达。

信谊xyzF = x²+ y²+ z²;

调用matlabFunctionBlock使用名称-值对参数指定函数名、输入端口的顺序和输出端口的名称。双击该块以查看定义该块的函数。

matlabFunctionBlock (“my_system / my_block”f,f + 1,f + 2，.．.“FunctionName”，“my_function”，“var”，[y z x]，.．.“输出”, {“name1”，“name2”，“name3”})
函数[name1,name2,name3] = my_function(y,z,x) %#代码原t2 = x.^2;T3 = y.^2;T4 = z.^2;Name1 = t2+t3+t4;nargout > 1 name2 = t2+t3+t4+1.0;如果name3 = t2+t3+t4+2.0;结束

输入参数

全部折叠

要创建或修改的块，指定为字符向量。

要转换为MATLAB函数块的符号输入，指定为符号表达式、函数、向量或矩阵。

符号输入要转换成MATLAB函数块用N输出，指定为若干符号表达式、函数、向量或矩阵，用逗号分隔。

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:matlabFunctionBlock (my_system / my_block, f,‘FunctionName’,‘myfun’)

要包含在文件头中的注释，指定为字符向量、字符向量的单元格数组或字符串向量。

函数的名称，指定为字符向量。默认情况下,matlabFunction(块,…)使用块作为函数名。

看到为生成的函数指定函数名．

代码优化的标志，指定为真正的或假．

写入文件时，matlabFunctionBlock使用命名为t0，t1,……

看到禁用代码优化．

所生成块的输入变量的顺序和相应的输入端口，指定为字符向量、符号变量向量或字符向量、符号变量向量或符号变量向量的一维单元格数组。

指定的输入端口的数量必须等于或超过中自由变量的数量f．输入端口不使用相同的名称var和指定的输出端口输出．

默认情况下，转换符号表达式时，顺序是字母顺序。转换符号函数时，它们的输入参数出现在其他变量前面，所有其他变量都按字母顺序排序。

看到为生成的块指定输入端口．

输出端口的名称，指定为字符向量的一维单元格数组。如果不指定输出端口名称，matlabFunctionBlock使用由单词组成的名称出后面跟着输出端口号，例如:out3．

输入端口不使用相同的名称var和指定的输出端口输出．看到指定输出端口．

限制

  • 一些符号函数没有对应的MATLAB函数操作双数据类型，例如简化而且解决，都作为符号函数保存在生成的MATLAB函数块中。由这些函数组成的转换函数块不能在Simulink模型中使用。金宝app方法创建自己的函数双数据类型来替换这些符号函数。如果您对不能在Simulink模型中使用的符号函数感兴趣，请联系金宝appMathWorks技术支持金宝app．

版本历史

在R2009a中引入

另请参阅

|||||

主题