主要内容

基于MATLAB编码器的机器学习模型预测代码生成

此示例显示如何使用MATLAB®Coder™应用程序生成用于预测分类和回归模型对象的C / C ++代码。您还可以使用命令行生成代码codegen(MATLAB编码器).看到机器学习模型在命令行预测的代码生成获取详细信息。

一定的分类和回归模型对象有预测随机支持代码生成的功能。金宝app使用这些对象函数预测需要训练的分类或回归模型对象,但代码生成的入口点函数不能将这些对象作为输入变量。通过使用解决此限制Savelarnerforcoder.loadLearnerForCoder如该示例中所述。

该流程图展示了分类和回归模型对象的对象函数的代码生成流程。

在本例中,您使用以下方法训练分类集成模型k-最近邻弱学习者,使用保存训练模型Savelarnerforcoder..然后,定义一个入口点函数,通过使用loadLearnerForCoder并调用对象函数。编写脚本以测试入口点函数。最后,通过使用MATLAB编码器应用程序生成代码并验证生成的代码。

训练分类模型

加载电离层数据集。该数据集有34个预测器和351个雷达返回的二进制响应,或坏(“b”)或好('G').

负载电离层

用。训练分类集成模型k-最近邻弱学习器,利用随机子空间方法。关于使用随机子空间集合的分类的详细信息,请参见随机子空间分类

RNG('默认'重复性的%学习者= templateKNN (“NumNeighbors”2);Mdl = fitcensemble (X, Y,“方法”'子空间''npredtosample',5,...“学习者”学习者,“NumLearningCycles”,13);

保存模型使用Savelarnerforcoder.

将培训的合奏模型保存到名为的文件knnEnsemble.mat在当前文件夹中。

SavelAlnerForCoder(MDL,“knnEnsemble”

Savelarnerforcoder.建立了完整的分类模型Mdl然后将其保存到MATLAB二进制文件中knnEnsemble.mat作为当前文件夹中的结构数组。

定义入口点函数

一个入口点函数,又称顶级基本的函数,是您为代码生成定义的函数。您必须定义一个入门点函数,可调用启用代码生成的函数,并从入口点函数生成C / C ++代码。入口点函数中的所有功能必须支持代码生成。金宝app

在当前文件夹中的新文件中,定义命名的入口点函数myknnEnsemblePredict它的作用如下:

  • 接受输入数据(X),所保存模型的文件名(文件名)和有效的名称 - 值对参数预测函数(变长度输入宗量).

  • 通过使用加载训练的集合模型loadLearnerForCoder

  • 从加载模型预测标签和相应的分数。

通过指定,您可以允许可选的名称值参数变长度输入宗量作为输入参数。有关详细信息,请参见可变长度参数列表的代码生成(MATLAB编码器)

类型myknnensemblepredict.m.显示myknnEnsemblePredict的内容。m文件。
功能[标签,分数] = myknnensemblepredict(x,filename,varargin)%#codegen compactmdl = loadlearnerforcoder(文件名);[标签,分数] =预测(CompactMDL,X,Varargin {:});结尾

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

注意:如果单击页面右上方的按钮并在MATLAB中打开此示例,则MATLAB将打开示例文件夹。此文件夹包括入口点函数文件(myknnensemblepredict.m.)和测试文件(test_myknnensemblepredict.m.,后来描述)。

设置编译器

要生成C/ c++代码,您必须访问配置正确的C/ c++编译器。MATLAB编码器定位并使用一个受支持的、安装的编译器。金宝app您可以使用墨西哥人设置查看和更改默认编译器。有关详细信息,请参见改变默认的编译器

创建测试文件

编写一个测试脚本来调用myknnEnsemblePredict函数。在测试脚本中,指定在生成的代码中使用的输入参数和名称-值对参数。在使用MATLAB Coder应用程序生成代码时,可以使用此测试脚本自动定义输入类型。

在本例中,创建test_myknnensemblepredict.m.文件,如所示。

类型test_myknnensemblepredict.m.显示test_myknnEnsemblePredict的内容。m文件。
%% Load样本数据负载电离层%% Test myknnEnsemblePredict [label,score] = myknnEnsemblePredict(X,'knnEnsemble','学习者',1:13);

有关详细信息,请参见使用应用程序自动定义输入类型(MATLAB编码器)

使用MATLAB编码器应用程序生成代码

MATLAB Coder应用程序从MATLAB代码生成C或c++代码。基于工作流的用户界面引导您完成代码生成过程。下面的步骤描述了MATLAB Coder应用程序的简短工作流MATLAB编码器(MATLAB编码器)使用MATLAB Coder App生成C代码(MATLAB编码器)

1.打开MATLAB编码器应用程序,选择入口点函数文件。

应用程序选项卡,应用程序部分,单击显示更多箭头打开应用程序库。下代码生成, 点击MATLAB编码器.应用程序打开选择源文件页面。输入或选择入口点函数的名称,myknnEnsemblePredict

点击下一个定义输入类型页面。

2.定义输入类型

因为C使用静态类型,MATLAB编码器必须在编译时确定MATLAB文件中所有变量的属性。因此,您需要指定入口点函数输入的属性。

输入或选择测试脚本test_myknnensemblepredict然后点击Autodefine输入类型

MATLAB编码器应用程序识别输入类型的myknnEnsemblePredict函数基于测试脚本。

修改输入类型:

  • X- 应用程序的InfersX双(351x34).预测器的数量必须固定为与训练模型中的预测器数量相同。然而,你可以有不同数量的观测来进行预测。如果观测次数未知,则改变双(351x34)双(:351x34)双(infx34):.设置双(:351x34)允许观察次数达351次,且设置双(infx34):允许无限数量的观察。在本例中,指定双(infx34):通过点击351并选择:正

  • 文件名——点击char中,选择定义常量,用单引号输入文件名,“knnEnsemble”

  • 变长度输入宗量{1}- 名称 - 值对参数中的名称必须是编译时常量。点击char中,选择定义常量和类型“学习者”

  • 变长度输入宗量{2}-在生成的代码中允许用户自定义索引多达13个弱学习者,更改双(1x13)双(1x:13)

点击下一个检查运行时问题页面。这个可选步骤生成一个MEX文件,运行MEX函数,并报告问题。点击下一个生成代码页面。

3.生成C代码

构建类型,单击生成.该应用程序生成一个MEX函数,myknnensemblepredict_mex..MEX函数是可从MATLAB执行的C / C ++程序。您可以使用MEX功能来加速MATLAB算法并测试生成的功能和运行时问题的代码。有关详细信息,请参见MATLAB算法加速(MATLAB编码器)为什么在MATLAB中测试MEX函数?(MATLAB编码器)

根据指定的构建类型,MATLAB Coder生成一个MEX函数或编译为静态库、动态链接库或可执行文件的独立C/ c++代码。有关设置生成类型的详细信息,请参见配置构建设置(MATLAB编码器)

点击下一个完成工作流程页面。

4.检查完成工作流页面

完成工作流程页表示代码生成成功。此页面还提供了项目摘要和到生成的输出的链接。

使用脚本生成代码

在定义输入类型之后,您可以将MATLAB Coder项目转换为MATLAB命令的等效脚本。然后运行脚本生成代码。有关详细信息,请参见转换MATLAB编码器项目到MATLAB脚本(MATLAB编码器)

在Matlab编码器应用程序工具栏上,单击开放操作菜单按钮:

选择转换为脚本,然后单击保存.应用程序创建文件myknnensemblepredict_script.m.,它在配置对象中重新生成项目,并运行codegen(MATLAB编码器)函数。

显示文件的内容myknnensemblepredict_script.m.

类型myknnensemblepredict_script.m.
从myknnEnsemblePredict生成MEX-function myknnEnsemblePredict_mex %。% %从项目“myknnEnsemblePredict”生成的脚本。撮合下2017年- 11月17日。% %参见CODER, CODER。配置,编码器。TYPEOF CODEGEN。%%创建类'coder.MexCodeConfig'的配置对象。cfg = coder.config(墨西哥人);cfg。GenerateReport = true;cfg。ReportPotentialDifferences = false; %% Define argument types for entry-point 'myknnEnsemblePredict'. ARGS = cell(1,1); ARGS{1} = cell(4,1); ARGS{1}{1} = coder.typeof(0,[Inf 34],[1 0]); ARGS{1}{2} = coder.Constant('knnEnsemble'); ARGS{1}{3} = coder.Constant('Learners'); ARGS{1}{4} = coder.typeof(0,[1 13],[0 1]); %% Invoke MATLAB Coder. codegen -config cfg myknnEnsemblePredict -args ARGS{1} -nargout 2

运行脚本。

myknnEnsemblePredict_script
代码生成成功:要查看报告,请打开('codegen / mex / myknnensemblepredict / html / eport.mldatx')。

验证生成的代码

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

传递一些预测数据来验证myknnEnsemblePredictMEX函数返回相同的结果。

[label1, score1] =预测(Mdl X,“学习者”、1:10);[label2, score2] = myknnEnsemblePredict (X,“knnEnsemble”“学习者”、1:10);[label3, score3] = myknnEnsemblePredict_mex (X,“knnEnsemble”“学习者”、1:10);

相比label1label2,label3通过使用isequal

isequal (label1 label2 label3)
ans =逻辑1

isequal返回逻辑1(真正的),这意味着所有的输入都是相等的。

score3的输出可能包含舍入差值预测函数。在这种情况下,比较score1score3,允许有一个小的公差。

查找(ABS(Score1-Score3)> 1E-12)
Ans = 0x1空双列向量

找到如果元素明智的绝对差异,则返回空向量score1score3是否大于规定的公差1E-12.比较证实了myknnEnsemblePredictMEX函数返回相同的结果。

另请参阅

|||(MATLAB编码器)

相关的话题