主要内容

金宝appSimulink.sdi.report

生成一个模拟数据检查器报告

描述

金宝appSimulink.sdi.report控件中绘制的信号的图快照和元数据创建一个报告检查窗格的模拟数据检查器。

例子

金宝appSimulink.sdi.report (名称,值创建一个或多个指定的报表名称,值对参数。类型中绘制的数据的报告检查窗格或比较结果报告。您可以为每个报表指定详细信息。

例子

全部折叠

创建一个报告,其中包含有关信号的信息和图检查窗格的模拟数据检查器。默认情况下,该报告包含显示在表中的信号的元数据检查窗格。此示例显示如何指定在报表中包含哪些元数据。

加载会话文件

本例通过加载保存的会话文件,用数据和绘制的信号填充模拟数据检查器。会话文件包含信号数据以及关于绘制信号和绘制布局的信息。加载会话文件。

金宝appSimulink.sdi.load (“ex_sldemo_absbrake_slp_Ww.mldatx”);

session_screenshot.png

为绘制的信号创建一个报告

该报告包括绘制信号的图和元数据。上的信号表中显示的列默认情况下,该报告包括与之对应的元数据检查窗格。控件中显示更多列,可以在报表中包含更多数据检查窗格。控件以编程方式指定报表中所需的信息“ColumnsToReport”名称-值对和枚举类金宝appSimulink.sdi.SignalMetaData

signalMetadata = [金宝appSimulink.sdi.SignalMetaData.Run,...金宝appSimulink.sdi.SignalMetaData.Line,...金宝appSimulink.sdi.SignalMetaData.BlockName,...金宝appSimulink.sdi.SignalMetaData.SignalName];金宝appSimulink.sdi.report (“ReportType”“检查”“ReportOutputFile”...“absbrake_slp_report.html”“ColumnsToReport”, signalMetadata);

该报告显示了绘图信号的元数据表,由run组织,位于绘图快照的上方。

使用金宝appSimulink.sdi.report函数创建比较结果的报告。该报告是基于web的交互式报告,您可以在交互式视图和可打印视图之间进行切换。

负载对比结果

方法加载以前计算的比较结果,这些结果保存在MLDATX文件中saveResult函数。数据来自于两个模拟slexAircraftExample为输入过滤器使用不同时间常数值的模型。

金宝appSimulink.sdi.load (“slexAircraftExampleTsComparison.mldatx”);

创建比较报告

属性创建包含比较结果的报告金宝appSimulink.sdi.report函数。您可以为显示在报表标头中的报表指定标题和作者。

金宝appSimulink.sdi.report (“ReportType”“比较”“ReportTitle”...比较:Ts = 0.1 vs Ts = 1“ReportAuthor”“简·史密斯”);

报表生成后将在系统浏览器中打开。选择信号以查看图中显示的结果和图中信号的元数据属性窗格。报表HTML文件在sdireports工作目录下的文件夹。

输入参数

全部折叠

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。

在R2021a之前,使用逗号分隔每个名称和值,并将其括起来的名字在报价。

例子:“ReportType”、“比较”、“ShortenBlockPath’,真的

要创建的报表类型,指定为逗号分隔的对,由“ReportType”而且“检查”“比较”

  • “检查”——创建一个包含图快照和元数据的报告检查窗格的模拟数据检查器。

  • “比较”—创建一个总结比较结果的报告。比较报告是交互式的,包括比较结果的图快照以及比较信号的元数据。

例子:“ReportType”,“比较”

显示在比较报告标题中的报告标题,指定为逗号分隔的对,由“ReportTitle”和一个字符向量。

只能为比较报表指定报表标题。

例子:“报告标题”,“审判1 vs.审判2”

显示在比较报告标题中的报告作者,指定为逗号分隔的对,由“ReportAuthor”和一个字符向量。

您只能为比较报表指定报表作者。

例子:“ReportAuthor”,“约翰·史密斯”

保存报表的文件夹,指定为逗号分隔的对,由“ReportOutputFolder”和一个字符向量。

例子:“ReportOutputFolder”、“C: \ \ user1 \用户桌面的

报告文件名,指定为逗号分隔的对,由“ReportOutputFile”和一个字符向量。

例子:“ReportOutputFile”、“MyReport.html”

是否防止覆盖报表文件,指定为由逗号分隔的对组成“PreventOverwritingFile”而且真正的

  • 真正的启用文件覆盖保护。

  • 禁用文件覆盖保护。

文件覆盖保护通过在文件名中附加一个每次生成报告时递增的数字来防止模拟数据检查器覆盖现有文件。禁用文件覆盖保护时,除非指定惟一的文件名,否则模拟数据检查器将覆盖现有的报表文件。

例子:“PreventOverwritingFile”,假的

信号元数据要包括在报告中绘制的信号检查窗格的模拟数据检查器,指定为逗号分隔的对,由“ColumnsToReport”和一个数组。默认情况下,检查报告包括每个绘制信号的块路径、名称、线条样式和颜色以及数据源参数。

请注意

ColumnsToReport输入不影响比较报告。比较报告始终包含所有信号元数据,比较报告顶部的摘要始终包含每个信号比较的信号名称、绝对公差、相对公差、最大差值和结果。

使用枚举类指定要作为数组包含的元数据金宝appSimulink.sdi.SignalMetaData.例如,要包含模拟运行的名称和信号名称:

signal_metadata = [金宝appSimulink.sdi.SignalMetaData.Run,…金宝appSimulink.sdi.SignalMetaData.SignalName];

然后,指定ColumnsToReport作为signal_metadata在名称-值对中:

金宝appSimulink.sdi.report (ColumnsToReport, signal_metadata)

该表总结了用于的元数据检查报告。

列值 描述
SignalName(默认) 信号的名字
(默认) 信号线的样式和颜色
SID

自动分配Simulink金宝app®标识符

单位 信号测量单元
SigDataType 信号数据类型
SigSampleTime 对信号进行采样的方法
模型 产生信号的模型名称
BlockName 信号的源块的名称
BlockPath 信号源块的路径
港口 信号在其块的输出端口上的索引
包含信号的矩阵的维数
通道 信号在矩阵中的索引
运行 包含信号的模拟运行的名称
AbsTol 信号的绝对容差
RelTol 信号的相对容差
OverrideGlobalTol 属性,指定信号容差是否优先于全局容差
TimeTol 信号的时间容差
InterpMethod 插值法
SyncMethod 同步方法用于协调信号进行比较
TimeSeriesRoot 从MATLAB中导入的信号与信号相关的变量名®工作空间
TimeSource 包含从MATLAB工作区导入的信号的时间数据的数组的名称
数据源 包含从MATLAB工作区导入的信号的信号数据的数组的名称

例子:“ColumnsToReport”,元数据

是否缩短报告中的块路径,指定为由逗号分隔的对组成“ShortenBlockPath”而且真正的

  • 真正的——在报告中使用缩短的块路径。

  • ——在报告中包含完整的块路径。

例子:“ShortenBlockPath”,假的

是否在创建报表时打开报表,指定为逗号分隔的对,由“LaunchReport”而且真正的

  • 真正的—创建报表时打开报表。

  • —不要自动打开报告。

例子:“LaunchReport”,假的

要包含在比较报告中的信号,指定为逗号分隔的对,由“SignalsToReport”而且“ReportOnlyMismatchedSignals”“ReportAllSignals”

  • ReportOnlyMismatchedSignals—只包含超出公差比较结果的信号。

  • ReportAllSignals——包括所有信号。

例子:“SignalsToReport”、“ReportAllSignals”

版本历史

在R2011b中引入

全部展开