主要内容

通用代码生成流程

统计和机器学习工具箱™功能(不是机器学习模型的对象函数)的一般代码生成工作流与中描述的工作流相同MATLAB®编码器™.有关详情,请参阅开始使用MATLAB编码器(MATLAB编码器).要了解如何为机器学习模型的对象函数生成代码,请参见代码生成简介

这个例子简要地解释了一般的代码生成工作流程,如下图所示:

通用代码生成工作流。步骤1:定义入口点函数。步骤2:生成代码。步骤3:验证生成的代码。

定义入口点功能

一个入口点函数,也称为顶级主要的函数,是为代码生成而定义的函数。因为你不能在顶层调用任何函数codegen(MATLAB编码器),则必须定义一个调用支持代码生成的函数的入口点函数,并使用codegen.入口点函数中的所有函数都必须支持代码生成。万博1manbetx

添加% # codegen编译器指令(或pragma)到入口点函数后的函数签名,以表明您打算为MATLAB算法生成代码。添加此指令将指示MATLAB代码分析器帮助您诊断和修复在代码生成期间可能导致错误的违规行为。看到用代码分析器检查代码(MATLAB编码器)

生成估算数据集的四分位数范围的代码位差,定义此函数。

函数r = iqrCodeGen(x)% # codegen估计四分位数范围% iqrCodeGen返回数据x的四分位数范围,%单精度或双精度向量。R = iqr(x);结束
允许可选的输入参数,通过指定变长度输入宗量作为输入参数。有关详情,请参阅可变长度参数列表的代码生成 (MATLAB编码器)为代码生成指定可变大小的参数

生成代码

设置编译器

要生成C/ c++代码,您必须能够访问配置正确的编译器。MATLAB编码器定位并使用受支持的已安装编译器。万博1manbetx要查看和更改默认的C编译器,输入:

墨西哥人设置
有关详细信息,请参见更改默认编译器

生成代码codegen

设置编译器后,使用codegen(MATLAB编码器)或者是MATLAB编码器来学习如何使用MATLAB编码器应用程序,请参阅使用MATLAB编码器应用程序生成MEX函数(MATLAB编码器)

要在命令行生成代码,请使用codegen(MATLAB编码器).因为C和c++是静态类型语言,所以必须在编译时确定入口点函数中所有变量的属性。在调用时指定入口点函数的所有输入的数据类型和大小codegen通过使用arg游戏选择。

  • 为了指定数据类型和精确的输入数组大小,传递一个MATLAB表达式,该表达式表示具有一定数据类型和数组大小的值集。例如,指定从中生成的代码iqrCodeGen.m必须接受包含100个元素的双精度数字列向量,输入:

    testX = randn(100,1);codegeniqrCodeGenarg游戏{testX}报告

    报告Flag生成代码生成报告。看到代码生成报告(MATLAB编码器)

  • 要指定至少一个维度可以具有任意长度,请使用arg游戏选项coder.typeof(MATLAB编码器)如下。

    args {coder.typeof (example_valuesize_vectorvariable_dims)}
    的值example_valuesize_vector,variable_dims指定生成的代码可以接受的输入数组的属性。

    • 输入数组具有与中的示例值相同的数据类型example_value

    • size_vector输入数组的大小是否对应variable_dims值是

    • size_vector数组大小的上界是否相应variable_dims值是真正的

    • variable_dims指定数组的每个维度是可变大小还是固定大小。的值真正的(逻辑1)表示对应维度具有可变大小;的值(逻辑0)表示相应的维度具有固定的大小。

    当您的数据在编译时具有未知数量的观察值时,指定可变大小的输入非常方便。例如,指定从中生成的代码iqrCodeGen.m可以接受任意长度的双精度数值列向量,输入:

    testX = coder.typeof(0,[Inf,1],[1,0]);codegeniqrCodeGenarg游戏{testX}报告

    0example_valueValue表示数据类型为因为是MATLAB的默认数值数据类型。(正,1)size_vector价值和(1,0)variable_dims值意味着第一个维度的大小是可变的、无界的,而第二个维度的大小固定为1。

    请注意

    规格可变大小的输入可能会影响性能。有关详情,请参阅控制可变大小数组的内存分配(MATLAB编码器)

  • 若要指定字符数组,例如支持的名称-值对参数,请使用万博1manbetx编码器。常数(MATLAB编码器).例如,假设“名字”是有效的名称-值对参数iqrCodeGen.m,以及对应的值价值是数字。然后输入:

    codegeniqrCodeGenarg游戏{testX, coder.Constant(“名字”),值}报告

有关详细信息,请参见在命令行生成C代码(MATLAB编码器)指定入口点函数输入的属性(MATLAB编码器)

构建类型

MATLAB编码器可以为这些类型生成代码:

  • MEX (MATLAB可执行)函数

  • 独立的C/ c++代码

  • 独立的C/ c++代码编译成一个静态库

  • 独立的C/ c++代码编译成一个动态链接库

  • 独立的C/ c++代码编译成可执行文件

控件指定构建类型配置选择codegen(MATLAB编码器).有关设置代码生成选项的详细信息,请参见配置生成设置(MATLAB编码器)

默认情况下,codegen生成一个MEX函数。MEX函数是一个可从MATLAB执行的C/ c++程序。您可以使用MEX函数来加速MATLAB算法,并测试生成的代码的功能和运行时问题。有关详情,请参阅MATLAB算法加速(MATLAB编码器)为什么在MATLAB中测试MEX函数?(MATLAB编码器)

代码生成报告

你可以使用报告标志以生成代码生成报告。此报告可帮助您调试代码生成问题并查看生成的C/ c++代码。有关详情,请参阅代码生成报告(MATLAB编码器)

验证生成的代码

测试一个MEX函数来验证生成的代码是否提供了与原始MATLAB代码相同的功能。要执行此测试,请使用用于运行原始MATLAB代码的相同输入运行MEX函数,然后比较结果。在生成独立代码之前在MATLAB中运行MEX函数还使您能够检测和修复在生成的独立代码中难以诊断的运行时错误。有关详细信息,请参见为什么在MATLAB中测试MEX函数?(MATLAB编码器)

传递一些数据来验证是否位差iqrCodeGen,iqrCodeGen_mex返回相同的四分位数范围。

testX = randn(100,1);r = iqr(testX);r_entrypoint = iqrCodeGen(testX);r_mex = iqrCodeGen_mex(testX);

使用比较输出isequal

isequal (r, r_entrypoint, r_mex)

isequal如果所有输入都相等,则返回逻辑1 (true)。

您还可以使用测试文件和来验证MEX函数coder.runTest(MATLAB编码器).有关详情,请参阅从MATLAB代码生成的测试代码(MATLAB编码器)

另请参阅

(MATLAB编码器)

相关的话题