这个例子展示了如何在MATLAB之间进行跟踪®源代码和生成的C/C++代码。源代码和生成的代码之间的跟踪可帮助您:
了解代码生成器如何实现您的算法。
调试生成的代码中的问题。
评估生成代码的质量。
如果你有嵌入式编码器®并使生成的代码报告具有可追溯性,可以查看MATLAB源代码和生成的C/ c++代码相邻。当您将指针移动到代码上时,您可以沿着高亮显示的跟踪到相应的生成代码或MATLAB源代码。
为了说明交互式可跟踪性,此示例生成一个报告,用于生成MATLAB函数的C静态库lpsolve
这就解决了线性规划问题:
最大化y=c*x
受制于A*x<=b
其中x>=0和b>=0
该示例还使用了一个测试函数lpsolve_test
那叫lpsolve
具有代表性的输入值。
复制lpsolve.m
和LPU测试
到可写文件夹。
拷贝文件(fullfile (docroot,“工具箱”,“ecoder”,“例子”,'lpsolve.m'))复制文件(完整文件(docroot、,“工具箱”,“ecoder”,“例子”,“lpsolve_test.m”))
在生成C/C++代码之前,最好先筛选MATLAB代码,以便为代码生成做好准备。
编码筛选器(“lpsolve”)
代码生成就绪报告表明lpsolve
适用于代码生成。
通过生成和测试MEX函数来检查运行时问题也是一种最佳实践。
要指定输入参数的类型,请将具有代表性的输入值传递给编码基因
arg游戏
选择。或者,因为您有一个测试函数,您可以使用coder.getArgTypes
来确定类型。
要生成和测试MEX函数,请使用以及
选择。
c=[2 3 1];A=[2 3 1-1;1 0 2 1;0 2 1];b=[27;9;18];codegenlpsolvearg游戏{c A b}以及lpsolve_test
正在运行测试文件:“lpsolve\u test”和MEX函数“lpsolve\u MEX”。x=5 7 0 4 y=35
编码基因
成功生成并运行MEX函数。
要生成具有交互式可跟踪性的报告,请执行以下操作:
创建一个coder.EmbeddedCodeConfig
对象。的EnableTraceability
属性控制的可追溯性。默认情况下,EnableTraceability
财产是真正的
.
属性指定输入参数的类型,将有代表性的输入值传递给arg游戏
选择。
使用-报告
选择。
cfg = coder.config (“自由”,“ecoder”,对);编码基因-配置cfglpsolvearg游戏{c A b}-报告
要打开代码生成报告,请单击查看报告.
在代码窗格中,您会看到lpsolve.m
.
要启用跟踪,请在报告选项卡上,单击跟踪代码.
您可以看到MATLAB源代码和生成的C代码彼此相邻。
您可以从MATLAB代码跟踪到C代码,也可以从C代码跟踪到MATLAB代码。可跟踪代码在您要跟踪的一侧用蓝色标记,在您要跟踪的一侧用橙色标记。当您将指针移动到可跟踪代码上时,代码会以紫色突出显示,并且您可以在屏幕上看到对应代码的跟踪另一面。当您通过单击选择突出显示的代码时,代码将变为黄色,即使您将指针移离所选内容,也可以看到痕迹。在按之前,代码将保持选中状态Esc或者选择不同的代码。要更改跟踪的起始端,请选择另一端的代码。
在示例报告中探索跟踪。
在MATLAB代码中,指向而
-循环,从第38行开始向下滚动,直到整个而
-回路在视图中。
可以看到这个符号,它告诉您高亮显示的MATLAB代码有一个不在视图中的跟踪。
您可以在C代码窗格的单独窗口中看到相应的C代码。
在C代码窗格中,向下滚动,直到看到对应于而
循环。
在MATLAB代码中,将指针移动到而
循环。突出显示变量、表达式和代码块。
当您将指针移动到属于较大表达式的一部分的表达式上时,不同颜色的紫色将帮助您在相应的C代码中找到相关的表达式。例如,在第43行,暂停我
.
在MATLAB代码中,将指针移回而
-从第38行开始的循环。当整个循环以紫色突出显示时,通过单击将其选中。当您将指针移到跟踪之外时,黄色突出显示将标识所选跟踪。
要清除所选内容,请按Esc或者选择不同的代码。
当代码跟踪到相应源代码或生成代码中的多个位置时:
如果您在正在跟踪的代码上暂停,在代码窗格的顶部,您将看到跟踪的数量。
如果某些记录道不在视图中,您会看到一个符号,告诉您有多少记录道不在视图中。
在“代码”窗格中,如果选择要跟踪的代码,则可以在“代码”窗格顶部选择要查看的跟踪。
在报告中lpsolve
,查看多个轨迹。
停线36
.
在代码窗格的顶部,您可以看到这一行36
有两个痕迹。
选择一行36
.
在代码窗格的顶部,您可以看到第一个跟踪的位置。
要列出所有记录道,请单击记录道右侧的箭头。
在的代码生成报告中lpsolve
,所有来自MATLAB代码的跟踪都会转到一个C文件中lpsolve.c
.如果MATLAB代码跟踪到多个C文件,在C代码上面,您会看到一个符号,例如这提供了可以在其中找到跟踪的其他文件的数量。如果单击符号,则可以选择要查看的文件。如果选择MATLAB代码,则可以选择要查看的跟踪。
同样,上面的MATLAB源代码中,有一个符号如指示高亮显示的C代码跟踪到多个MATLAB文件。
查看lpsolve.c
在代码窗格的左侧,在生成的文件列表中,单击lpsolve.c
.
要查看代码窗格左侧的MATLAB代码,请单击一个MATLAB函数,例如,lpsolve
.
当您不在跟踪模式时:
在MATLAB代码中,如果指向变量或表达式,工具提示将提供类型等信息。
在C代码中,链接指向代码的其他部分,如类型或函数定义。
当您处于跟踪模式时,要启用MATLAB代码工具提示和C代码链接,请长按Ctrl键.MATLAB代码工具提示仅适用于选定的MATLAB函数。
在报告中lpsolve
,查看变量的类型信息。
在MATLAB源代码窗格中,选择支点
.
在代码窗格中,按住Ctrl键并在输入参数上暂停我
.
请注意
在麦金塔电脑平台,使用命令键而不是Ctrl键.
要生成不包含可追溯性的代码生成报告,请执行以下操作:
在一个coder.EmbeddedCodeConfig
对象,设置EnableTraceability
财产假
.
在MATLAB编码器™应用程序,设置使代码可追溯性到不
.