主要内容

控件中以编程方式定义输入属性MATLAB文件

对于代码生成,可以使用MATLAB®断言函数直接在MATLAB文件中定义主函数输入的属性。

如何用护肤品MATLAB编码器

使用断言函数调用标准MATLAB函数来指定主要函数输入的类、大小和复杂性。

属性指定输入属性时断言函数,请使用下列方法之一。使用提供的精确语法;不要修改它。

指定任何类

断言(isa)参数”,class_name'))

设置输入参数参数MATLAB课程class_name.例如,设置输入的类U对于32位有符号整数,调用:

...断言(isa (U, ' int32 '));...

指定fi类

断言(isfi (参数断言(isa (参数嵌入式。fi '))

设置输入参数参数MATLAB课程fi(定点设计师)(定点数字对象)。例如,设置输入的类Ufi,电话:

...断言(isfi (U));...

...断言(isa (U, ' embedded.fi '));...

您必须指定两个fi类和numerictype(定点设计师).看到指定定点输入的数字类型.您也可以设置fimath(定点设计师)属性,看到指定定点输入的fmath.如果不设置fimath(定点设计师)属性,codegen使用MATLAB默认fimath价值。

指定结构类

Assert (isstruct (参数断言(isa (参数, 'struct'))

设置输入参数参数MATLAB课程结构体(结构)。例如,设置输入的类U到一个结构体,电话:

...断言(isstruct (U));...

...断言(isa (U,“结构”));...

如果将输入参数的类设置为结构体,则必须按照所有字段在结构定义中出现的顺序指定它们的属性。

指定单元格数组类

断言(iscell (参数)维护(isa (参数“细胞”))

设置输入参数参数MATLAB课程细胞(单元阵列)。例如,设置输入的类C到一个细胞,电话:

...断言(iscell (C));...

...断言(isa (C,“细胞”));...

要指定单元格数组元素的属性,请参见指定单元格数组的属性

指定固定大小

Assert (all (size (参数) = =会变暗)))

设置输入参数参数到那个尺寸会变暗指定。例如,设置输入的大小U对于一个3 × 2矩阵,调用:

...断言(所有(大小(U) = = 2 [3]));...

指定标量大小

Assert (isscalar (参数)) assert (all (size (参数) == [1]))

设置输入参数的大小参数标量。设置输入的大小U标量,电话:

...断言(isscalar (U));...
...断言(所有(大小(U) = = [1]));...

指定可变大小输入的上界

断言(所有(大小(参数) < = (N0 N1…)));断言(所有(大小(参数) < [N0 N1…]));

设置输入参数的每个维度的上限大小参数.设置输入的上限大小U要小于或等于一个3 × 2矩阵,调用:

断言((大小(U) < = 2 [3]));

请注意

您还可以使用coder.varsize

指定具有固定尺寸和可变尺寸的输入

断言(所有(大小(参数) > = (M0 M1…)));断言(所有(大小(参数) < = (N0 N1…)));

当你使用断言(所有(大小(参数) > = [M0 M1…]))指定输入参数每个维度的下限大小:

  • 还必须为输入参数的每个维度指定上限大小。

  • 对于每一个尺寸,k,下界必须小于或等于上限吗Nk

  • 若要指定固定大小的维度,请将维度的上下边界设置为相同的值。

  • 边界必须是非负的。

来确定输入的第一个维度的大小U,并将第2维设置为可变大小,上限为2,调用:

断言(所有(大小(U) > = 0 [3]));断言((大小(U) < = 2 [3]));

指定单个尺寸的大小

断言(大小(参数k) = =Nk);断言(大小(参数k) < =Nk);断言(大小(参数k) <Nk);

您可以同时指定单个维度和所有维度。您还可以指定单个维度,而不是同时指定所有维度。以下规则适用:

  • 必须至少一次指定每个维度的大小。

  • 最后一个维度规范优先于前面的规范。

设置维度的上限大小k的输入参数参数.设置输入第一个维度的上限大小U3,电话:

断言(大小(U, 1) < = 3)

来确定输入的第二个维度的大小U2,电话:

断言(大小(U, 2) = = 2)

指定的输入

断言(以色列)参数) )

指定输入参数参数是真实的。指定输入U是真实的,叫:

...断言(伊斯雷尔(U));...

指定复杂的输入

Assert (~isreal (参数) )

指定输入参数参数是复杂的。指定输入U是复杂的,电话:

...断言(~伊斯雷尔(U));...

指定定点输入的数字类型

Assert (isequal (numerictype (fiparam),T) )

设置numerictype的属性fi输入参数fiparamnumerictype(定点设计师)对象T.例如,要指定numerictype定点输入的性质U作为一个签名numerictype对象T对于32位字长度和30位分数长度,使用以下代码:

% # codegen…定义numerictype对象。T = numerictype(1,32, 30);%设置输入U的numerictype属性为T。assert(isequal(numerictype(U),T));...

指定numerictype对于一个变量不自动指定该变量为固定点。您必须指定两个fi类和numerictype

指定定点输入的fmath

Assert (isequal (fimath (fiparam),F) )

设置fimath的属性fi输入参数fiparamfimath(定点设计师)对象F.例如,要指定fimath定点输入的性质U为了使它在整数溢出时饱和,请使用以下代码:

% # codegen…定义fimath对象。F = fimath(“OverflowMode”、“饱和”);%设置输入U的fimath属性为F。assert(isequal(fimath_u),F));...
如果不指定fimath属性的使用断言codegen使用MATLAB默认fimath价值。

指定输入的多个属性

维护(function1参数个数) & &function2参数个数) & &function3参数个数) &&…

指定一个或多个输入的类、大小和复杂性断言函数调用。例如,下面的代码指定了该输入U是一个二重复数,3 × 3矩阵和输入吗V是一个16位无符号整数:

% # codegen…断言(isa (U,“双”)& & ~伊斯雷尔(U) & &(大小(U) = = 3 [3]) & & isa (V, ' uint16 '));...

使用assert函数的规则

当使用断言函数要指定主函数输入的属性,请遵循以下规则:

  • 调用断言函数位于主要函数的开头,在控制流操作之前,例如如果语句或子程序调用。

  • 不叫断言条件构造中的函数,例如如果,开关语句。

  • 对于定点输入,必须同时指定fi类和numerictype(定点设计师).看到指定定点输入的数字类型.您也可以设置fimath(定点设计师)属性。看到指定定点输入的fmath.如果不设置fimath(定点设计师)属性,codegen使用MATLAB默认fimath价值。

  • 如果将输入参数的类设置为结构体,则必须按照所有字段在结构定义中出现的顺序指定它们的类、大小和复杂性。

  • 当你使用断言(所有(大小(参数) > = [M0 M1…]))指定输入参数每个维度的下限大小:

    • 还必须为输入参数的每个维度指定上限大小。

    • 对于每一个尺寸,k,下界必须小于或等于上限吗Nk

    • 若要指定固定大小的维度,请将维度的上下边界设置为相同的值。

    • 边界必须是非负的。

  • 如果指定单个尺寸,则适用以下规则:

    • 必须至少一次指定每个维度的大小。

    • 最后一个维度规范优先于前面的规范。

指定主要输入的一般属性

在下面的代码摘录中,一个主要的MATLAB函数mcspecgram有两个输入:pennywhistle赢得.代码为这些输入指定以下属性。

输入 财产 价值
pennywhistle int16
大小 220500 - 1的向量
复杂性 真正的(默认)
赢得
大小 1024 - 1的向量
复杂性 真正的(默认)

%#codegen函数y = McSpecgram (pennywhistle,win) nx = 220500;nfft = 1024;断言(isa (pennywhistle int16));Assert (all(size(pennywhistle) == [nx 1]));断言(isa(赢,“双”));Assert (all(size(win) == [nfft 1]));...

或者,您可以为一个或多个输入组合属性规范断言命令:

%#codegen函数y = McSpecgram (pennywhistle,win) nx = 220500;nfft = 1024;Assert (isa(pennywhistle,'int16') && all(size(pennywhistle) == [nx 1]));断言(isa(赢,“双”)& &(大小(赢得)= = [nfft 1]));...

指定主要定点输入的属性

要指定定点输入,必须安装定点设计器™软件。

在下面的例子中,主要是MATLAB函数mcsqrtfi接受一个定点输入x.该代码为该输入指定以下属性。

财产 价值
fi
numerictype numerictype对象T,如主要功能中所述
fimath fimath对象F,如主要功能中所述
大小 标量
复杂性 真正的(默认)

函数y = mcsqrtfi(x) %#codegen T = numerictype('WordLength',32,'FractionLength',23,…“签署”,真正的);F = fimath(‘SumMode’,‘SpecifyPrecision’,……“SumWordLength”,32岁的“SumFractionLength”,23岁……“ProductMode”、“SpecifyPrecision’,……“ProductWordLength”,32岁的“ProductFractionLength”,23);断言(isfi (x));断言(isequal (numerictype (x), T));断言(isequal (fimath (x), F));y =√x);

您必须指定两个fi类和numerictype

指定单元格数组的属性

要指定类细胞(单元格数组),使用下列语法之一:

断言(iscell (参数)维护(isa (参数“细胞”))

例如,设置输入的类C细胞使用:

...断言(iscell (C));...

...断言(isa (C,“细胞”));...

您还可以指定单元格数组的大小和单元格数组元素的属性。指定的元素数量决定单元格数组是同质的还是异构的。看到单元格数组的代码生成

如果只指定第一个元素的属性,则单元格数组是同构的。例如,下面的代码指定C是一个1x3的齐次单元格数组,其元素为1x1 double。

...断言(isa (C,“细胞”));assert(all(size(C) == [1 3]));断言(isa (C{1},“双”));...

如果只指定第一个元素的属性,但又为单元格数组分配结构类型名称,则单元格数组是异构的。每个元素都具有第一个元素的属性。例如,下面的代码指定C为1x3异质细胞阵列。每个元素都是1x1 double。

...断言(isa (C,“细胞”));assert(all(size(C) == [1 3]));断言(isa (C{1},“双”));编码器。cstructname (C,“名字”);...

如果指定每个元素的属性,则单元格数组是异构的。例如,下面的代码指定了一个1x2的异构单元格数组,它的第一个元素是1x1 char,第二个元素是1x3 double。

...断言(isa (C,“细胞”));assert(all(size(C) == [1 2]));断言(isa (C {1}, char));assert(all(size(C{2}) == [1 3]));断言(isa (C{2},“双”));...

如果指定多个元素,则不能指定单元格数组为可变大小,即使所有元素具有相同的属性。例如,下面的代码指定了一个可变大小的单元格数组。因为代码指定了第一个和第二个元素的属性,所以代码生成失败。

...断言(isa (C,“细胞”));assert(all(size(C) <= [1 2]));断言(isa (C{1},“双”));断言(isa (C{2},“双”));...

在前面的示例中,如果只指定第一个元素,则可以指定单元格数组为可变大小。例如:

...断言(isa (C,“细胞”));assert(all(size(C) <= [1 2]));断言(isa (C{1},“双”));...

指定标量结构的类和大小

假设你定义年代为如下标量MATLAB结构:

S =结构(“r”、双(1),“我”,int8 (4));
下面的代码指定函数输入的属性年代和它的字段:
function y = fcn(S) %#codegen %指定输入的类为struct。断言(isstruct (S));%按照定义的顺序指定字段r和i的类和大小。断言(isa (S.r '双层'));受到打击还得追溯到断言(isa (, ' int8 ');...

在大多数情况下,当您没有显式地为属性指定值时,MATLAB编码器™使用默认值——结构字段除外。在结构中命名字段的唯一方法是设置至少一个属性。至少,您必须指定结构字段的类。

指定结构数组的类和大小

对于结构数组,必须选择数组的代表性元素来指定每个字段的属性。例如,假设您已经定义了年代为以下MATLAB结构的1 × 2数组:

S =结构(‘r’,{双(1)双(2)},‘我’,{int8 (4), int8 (5)});

下面的代码指定了结构输入的每个字段的类和大小年代通过使用数组的第一个元素:

%#codegen function y = fcn(S) %指定输入S的类为struct。断言(isstruct (S));%根据数组的第一个元素指定字段r和i %的大小。assert(all(size(S) == [1 2]));断言(isa (S (1) r '双层'));断言(isa (S(1)我,' int8 '));
在结构中命名字段的唯一方法是设置至少一个属性。至少,您必须指定所有字段的类。