主要内容

通过使用度量仪表板收集和探索度量数据

度量仪表板收集并集成来自多个基于模型的设计工具的质量度量数据,为您提供对项目质量状态的评估。打开仪表盘:

  • 在“应用程序”库中,单击指标指示板

  • 在命令行中,输入metricsdashboard (系统.的系统可以是模型名,也可以是子系统的块路径。系统不能为a可配置子系统块。

方法以编程方式收集度量数据slmetric。引擎API。当您打开仪表板时,如果您之前已经为某个特定模型收集了度量数据,那么仪表板将从数据库中的现有数据中填充。

如果您想使用仪表板收集(或重新收集)度量数据,请在工具栏中:

  • 使用选项菜单指定是否在数据集合中包括模型引用和库。

  • 点击所有指标.如果您不想收集需要编译模型的度量标准,请单击Non-Compile指标

Metrics Dashboard提供系统名称和数据收集时间戳。如果在数据收集过程中出现问题,请单击警告图标以查看警告。

每个模型或子系统一次只能打开一个仪表板。同样,如果仪表板为模型或子系统打开,并且您以编程方式为该模型或子系统收集度量数据,则仪表板将自动关闭。

指标仪表板小部件

度量仪表板包含的小部件提供了以下类别的度量数据的可视化:大小、建模准则遵从性和架构。要更详细地查看数据,请单击单个度量小部件。对于您所选择的度量,一个表显示了模型组件级别的值、聚合值和度量(如果适用的话)。从表中,仪表板提供了到数据源的可跟踪性和超链接,以便您可以获得详细的结果和故障排除问题的建议操作。在查看钻取数据时,请注意:

  • 度量仪表板计算每个组件的度量数据。组件可以是模型、子系统、图表或MATLAB函数块。

  • 您可以通过任意一种方式查看结果表格视图。为高完整性而且马伯合规小部件,也可以选择一个网格视图。要查看突出显示的结果,请在网格视图中单击单元格。

  • 若要按值或聚合值对结果排序,请单击相应的值列标头。

  • 对于其他的度量高完整性而且马伯合规性小部件,您可以过滤结果。要筛选结果,请使用表格视图中,选择上下文菜单右侧的类型组件,路径列标题。从类型菜单,选择适用组件。从组件而且路径菜单中,在搜索栏中键入组件名称或路径。Metrics Dashboard保存了小部件的过滤器,因此您可以查看其他小部件的度量细节并返回过滤后的结果。

  • 表格而且视图中,值或聚合值为n/a表示结果对该组件不可用。如果该值和聚合值均为n/a,则表格视图没有列出组件。的视图没有列出这样的组件。为Stateflow LOC控件中,图像显示了比较。

  • 所收集的度量数据量化了整个系统,包括同一模型的实例。对于聚合的值,度量引擎聚合来自引用层次结构中模型的每个实例的数据。例如,如果同一个模型在系统层次结构中被引用了两次,那么它的块计数对整个系统块计数贡献了两次。

  • 如果是子系统、图表或MATLAB函数块使用一个参数或为一个问题标记,然后为父组件增加参数计数或问题计数。

  • 度量仪表板分析变量。

对于自定义指标,您可以指定要添加到仪表板的小部件。您还可以删除小部件。要了解有关自定义度量仪表板的更多信息,请参见自定义指标仪表板布局和功能

大小

此表列出了Metrics Dashboard小部件,这些小部件提供了系统大小的整体图片。在钻取小部件时,这个表还列出了可用的详细信息。

小部件 度规 在数据
金宝appSimulink块计数mathworks.metrics.金宝appSimulinkBlockCount 按组件划分的块数
模型 模型文件计数mathworks.metrics.ModelFileCount 按组件划分的模型文件数量
文件 文件数mathworks.metrics.FileCount 按组件划分的模型和库文件的数量
MATLAB代码行 有效的MATLAB代码行mathworks.metrics.MatlabLOCCount 有效的代码行,在MATLAB函数块和MATLAB函数在statflow,由组件
Stateflow LOC 状态流块的有效代码行mathworks.metrics.StateflowLOCCount 按组件划分的状态流块的有效代码行
系统接口
  • 输入和输出计数mathworks.metrics.ExplicitIOCount

  • 参数计算mathworks.metrics.ParameterCount

  • 各组件输入输出数量(含触发端口)

  • 按组件划分的参数个数

建模指南遵从性

对于这个特定的系统,模型遵从性小部件指示了与行业标准和指南的遵从程度。该表列出了与建模准则遵从性相关的Metrics Dashboard小部件,以及当您深入到小部件时可用的详细信息。

小部件 度规 在数据
高完整性合规 Model Advisor标准检查遵从性-高完整性mathworks.metrics.ModelAdvisorCheckCompliance.hisl_do178

对于每个组成部分:

  • 通过检查的百分比

  • 每一张支票的状态

与Model Advisor集成以获得更详细的结果。

马伯合规 Model Advisor标准检查遵从性- MABmathworks.metrics.ModelAdvisorCheckCompliance.maab

对于每个组成部分:

  • 通过检查的百分比

  • 每一张支票的状态

与Model Advisor集成以获得更详细的结果。

高完整性检查问题 Model Advisor标准问题-高完整性mathworks.metrics.ModelAdvisorCheckIssues.hisl_do178
  • 按组件进行合规性检查的数量(参见下面的说明)。

  • 没有问题或聚合问题的组件不会被列出。

马伯检查问题 模型顾问标准问题- MABmathworks.metrics.ModelAdvisorCheckIssues.maab
  • 按组件进行合规性检查的数量(参见下面的说明)。

  • 没有问题或聚合问题的组件不会被列出。

代码分析器警告 来自MATLAB代码分析器的警告mathworks.metrics.MatlabCodeAnalyzerWarnings 按组件划分的代码分析器警告数量。
诊断的警告 金宝appSimulink诊断警告计数mathworks.metrics.DiagnosticWarningsCount
  • 按组件划分的Simu金宝applink诊断警告数量。

  • 如果有警告,在仪表板顶部有一个打开诊断查看器的超链接。

请注意

分析配置参数的遵从性检查的问题会增加检查失败的模型的问题计数。

您可以使用Metrics Dashboard在您自己的Model Advisor检查组上执行遵从性和问题检查。有关更多信息,请参见自定义指标仪表板布局和功能

体系结构

这些小部件提供了系统架构的视图:

  • 潜在重用/实际重用Widget显示克隆子组件占总数量的百分比,以及链接库块的组件占总数量的百分比。橙色表示潜在的重用。蓝色表示实际重用。

  • 其他系统架构小部件使用价值尺度。对于度量的每个值范围,一个彩色条表示落在该范围内的组件的数量。颜色越深表示成分越多。

该表列出了与体系结构相关的Metrics Dashboard小部件,以及在选择小部件时可用的详细信息。

小部件 度规 在数据

潜在的重用/实际的重用

潜在的重用mathworks.metrics.CloneContent),实际的重用mathworks.metrics.LibraryContent

克隆子组件总数的百分比

链接库块的组件总数的百分比

与识别建模克隆工具集成单击开放式转换工具按钮。

模型的复杂性 圈复杂度mathworks.metrics.CyclomaticComplexity 按组件划分的模型复杂性
金宝appSimulink块计数mathworks.metrics.金宝appSimulinkBlockCount 按组件划分的块数
Stateflow LOC 状态流块的有效代码行mathworks.metrics.StateflowLOCCount 按组件划分的状态流块的有效代码行
MATLAB代码行 有效的MATLAB代码行mathworks.metrics.MatlabLOCCount 有效的代码行,在MATLAB函数块和MATLAB函数在statflow,由组件

指标阈值

对于模型复杂性、建模指南遵从性和重用小部件,度量仪表板包含默认的阈值。这些值指示您的数据是否符合要求或是否需要审查(警告)。对于合规数据,小部件包含绿色。对于警告数据,小部件包含黄色。没有度量阈值的小部件包含蓝色。

  • 对于建模指南遵从性度量,度量阈值为0 Model Advisor问题。如果您的模型有问题,小部件包含黄色。如果没有问题,小部件包含绿色。

  • 如果您的模型有警告,则代码分析器而且诊断小部件是黄色的。如果没有警告,则小部件包含绿色。

  • 对于重用小部件,度量阈值为零。如果您的模型有潜在的克隆,小部件将显示黄色。如果没有潜在的克隆,则小部件包含绿色。

  • 模型的复杂性Widget中,度量阈值为30。如果模型的圈复杂度大于30,则小部件包含黄色。如果该值小于或等于30,则小部件包含绿色。

您可以为Metrics Dashboard中的所有小部件指定自己的度量阈值。您还可以指定与不兼容范围对应的值。有关更多信息,请参见自定义指标仪表板布局和功能

仪表板的局限性

在使用度量仪表板时,请注意以下注意事项:

  • 度量指标仪表板的分析根不能是可配置子系统块。

  • Model Advisor是Metrics Dashboard用于数据收集的工具,每个模型只能有一个开放会话。因此,当仪表板收集数据时,它会关闭现有的Model Advisor会话。

  • 如果你使用sl_customization.m文件来定制Model Advisor检查,这些定制可以改变仪表板结果。例如,如果隐藏了仪表板用于收集指标的Model Advisor检查,则仪表板不会收集这些指标的结果。

  • 当仪表板收集需要模型编译的指标时,软件将更改到一个临时文件夹。由于这个文件夹更改,模型中的相对路径依赖关系可能会失效。

  • 度量仪表板不将与块无关的MAB检查计算为问题。示例包括警告字体格式或文件名的检查。在Model Advisor Check Issues小部件中,该工具可能报告零MAB问题,但仍然在MAB Modeling guidelines Compliance小部件中报告问题。有关这些问题的更多信息,请单击MAB建模指南遵从性小部件。

相关的话题