slreportgen.report.LookupTable 类
命名空间: slreportgen.report
超类: slreportgen.report.Reporter
查找表模块报告器
描述
创建对象
描述
输入参量
属性
方法
示例
此示例显示如何向自定义 HTML LookupTable 报告器模板添加固定内容。您还可以通过直接编辑报告生成器程序来自定义查找表报告输出。自定义模板的好处是您可以重用它作为自定义其他报告生成器程序的基础。
LookupTable 报告器的模板和样式表位于 matlab\toolbox\shared\slreportgen\rpt\rpt\+slreportgen\+report\@LookupTable\resources\templates 文件夹中。复制默认模板时不需要指定此路径。
创建默认 html 模板的副本。在此示例中，模板包将保存为当前工作文件夹中名为 CustomTemplate.htmtx 的压缩文件。
import mlreportgen.report.* import slreportgen.report.* LookupTable.createTemplate('CustomTemplate','html');
解压缩模板包。
unzipTemplate('CustomTemplate.htmtx');CustomTemplate，并保存在当前工作文件夹中。root.css 文件位于 stylesheets 子文件夹中，定义了控制所生成报告的外观和格式的样式。docpart_templates.html 文件指定生成报告时保存报告内容的孔。从 CustomTemplate 文件夹中，在 MATLAB® 之外的文本编辑器中打开 docpart_templates.html 文件。
<html>
<head>
<meta charset="utf-8" />
<title>Document Part Templates</title>
<link rel="StyleSheet" href="./stylesheets/root.css" type="text/css" />
</head> <body>
<dplibrary>
<!-- NOTE: temporary in the template library until the -->
<! DOM supports a source without template name -->
<dptemplate name="LookupTable">
<hole id="Content">LUT_CONTENT</hole>
<hole id="LUTDataTypes">DATA_TYPE</hole>
<hole id="FootNoteContent">LUT_FOOTNOTE_CONTENT</hole>
</dptemplate>
<dptemplate name="LookupTableContent">
<hole id="TableContent">TABLECONTENT</hole>
<hole id="FigureContent">FIGURECONTENT</hole>
</dptemplate>
</dplibrary>
</body>
</html>要向模板添加固定文本，请将其放在所需位置并使用标准 HTML 标记。此示例添加了在生成的报告中的数据类型表上方显示的文本。仅显示文件的 <dptemplate name="LookupTable"> 部分。
<dptemplate name="LookupTable"> <hole id="Content">LUT_CONTENT</hole> <p><scan>This lookup table block contains the following data types:</scan></p> <hole id="LUTDataTypes">DATA_TYPE</hole> <hole id="FootNoteContent">LUT_FOOTNOTE_CONTENT</hole> </dptemplate>
保存文件。
在 MATLAB 命令行中，将模板文件夹压缩成模板包。对于此示例，模板包被压缩到 CustomTemplate.htmtx 文件中。
zipTemplate('CustomTemplate');要将保存的模板用于您的报告，请在报告生成器程序中指定模板源。
lutable = LookupTable();
lutable.TemplateSrc = 'CustomTemplate';创建一个 PDF 报告生成器，指定由 LookupTable 报告器返回的绘图高度和宽度。此示例使用 sf_car 模型并报告其 Torque ratio 查找表(nD)模块。该模块是一个一维查找表，位于 transmission/Torque Converter 模型的 sf_car 子系统中。要设置图的高度和宽度，请使用 PlotReporter 属性。
import slreportgen.report.* import mlreportgen.report.* model_name = "sf_car"; load_system(model_name); lutable = "sf_car/transmission/Torque Converter/Torque ratio"; rpt = slreportgen.report.Report("output","pdf"); chapter = Chapter(lutable); rptr = LookupTable(lutable); rptr.IncludeTable = false; add(chapter,rptr); rptr_resized = LookupTable(lutable); rptr_resized.IncludeTable = false; rptr_resized.PlotReporter.Snapshot.Width = "3in"; rptr_resized.PlotReporter.Snapshot.Height = "4in"; add(chapter,rptr_resized); add(rpt,chapter); close(rpt) ; close_system(model_name) rptview(rpt);
报告第一页上的默认绘图使用预定义的大小以使绘图适合页面大小。
报告第二页上调整大小的图使用指定的 3 英寸宽度和 4 英寸高度。
创建一个报告查找表模块的 PDF 报告生成器。此示例使用 sf_car 模型并报告其 engine torque 查找表(nD)模块。这个模块是一个二维查找表。engine torque 模块位于 Engine 模型的 sf_car 子系统中。默认情况下，报告包括输出值与断点的表、表面图、模块数据类型表以及有关报告值与从仿真获得的值之间可能存在的差异的注释。
import slreportgen.report.* import mlreportgen.report.* model_name = "sf_car"; load_system(model_name); lutable = "sf_car/Engine/engine torque"; rpt = slreportgen.report.Report('output','pdf'); chapter = Chapter(lutable); rptr = LookupTable(lutable); add(chapter,rptr); add(rpt,chapter); close(rpt); close_system(model_name); rptview(rpt)
此示例展示了如何创建一个 PDF 报告生成器，该生成器可查找 sf_car 模型中的 Engine 子系统中的模块。然后，报告生成程序循环遍历模块，识别查找表模块，并使用 LookupTable 报告器报告这些模块的信息。对于其他模块，生成的报告使用 BlockFinder 类报告模块属性。
import slreportgen.report.* import slreportgen.finder.* import mlreportgen.report.* model_name = "sf_car"; load_system(model_name) subsys_name = "sf_car/Engine"; rpt = Report; blkfinder = BlockFinder(subsys_name); blks = find(blkfinder); for i=1:length(blks) if slreportgen.utils.isLookupTable(blks(i).Object) rptr = LookupTable(blks(i).Object); ch = Chapter(blks(i).Name); add(ch,rptr); add(rpt,ch); else ch = Chapter(blks(i).Name); add(ch,blks(i)); add(rpt,ch); end end close(rpt); rptview(rpt); close_system(model_name);
第一章显示了 Inport 模块的参数。
第五章显示了 Lookup Table 模块报告器的输出。默认输出是一个输出值与断点相对应的表格、一个图和一个数据类型表。
版本历史记录
在 R2018a 中推出
