模型度量
模型度量
模型度量会分析您的模型,并帮助您评估您的模型的大小、架构、可读性和标准合规性。Simulink® Check™ 提供以下类型的度量:
使用度量仪表板,您可以收集和查看模型度量,以评估工程质量状态。有关详细信息,请参阅使用度量仪表板收集和探查度量数据。
您可以使用模型度量 API 以编程方式运行模型度量并将结果导出到文件。有关详细信息,请参阅Collect Model Metrics Programmatically。
对于您公司的规范和标准,您还可以使用模型度量 API 创建自己的模型度量,计算这些度量并导出度量数据。有关详细信息,请参阅Create a Custom Model Metric for Nonvirtual Block Count。您还可以为模型顾问检查创建自定义度量。有关详细信息,请参阅Change Model Advisor Checks in Metrics Dashboard。
要获取您的度量引擎中可用度量的度量 ID,请使用 slmetric.metric.getAvailableMetrics
。
availableMetricIDs = slmetric.metric.getAvailableMetrics()
slmetric.metric.getAvailableMetrics()
返回您的度量引擎中的可用度量,包括自定义度量。有关如何配置和使用自定义度量来自定义仪表板的详细信息,请参阅Customize Metrics Dashboard Layout and Functionality。
大小度量
要收集模型或子系统的度量数据,请运行以下度量。
度量 | 描述 |
---|---|
Simulink Block Metric | 计算模型中的模块数。 |
Subsystem Metric | 计算模型中的子系统数。 |
Library Link Metric | 计算模型中的库链接模块数。 |
Effective Lines of MATLAB Code Metric | 计算 MATLAB® 代码的有效行数。 |
Stateflow Chart Objects Metric | 计算 Stateflow® 对象数。 |
Lines of Code for Stateflow Blocks Metric | 计算模型中下列 Stateflow 模块的代码行:
|
子系统深度度量 | 计算模型的子系统深度。 |
Input Output Metric | 计算您的模型中的输入和输出数。 |
Explicit Input Output Metric | 计算您的模型中的输入和输出数。 |
File Metric | 计算模型和库文件数。 |
MATLAB Function Metric | 计算您的模型中的 MATLAB Function 模块数。 |
Model File Count | 计算模型文件数。 |
Parameter Metric | 计算参数化模型行为的数据对象实例的数量。 |
Stateflow Chart Metric | 计算您的模型中的 Stateflow 图的数量。 |
有关模型度量的详细信息,请参阅收集模型和测试度量。
架构度量
要了解有关模型或子系统架构的详细信息,请运行以下度量。
度量 | 描述 |
---|---|
Cyclomatic Complexity Metric | 计算模型的圈复杂度。 |
Clone Content Metric | 计算克隆件子组件总数的百分比。 |
Clone Detection Metric | 计算整个模型层次结构中组件内的克隆件数量。 |
Library Content Metric | 计算链接库模块的组件总数的百分比。 |
有关模型度量的详细信息,请参阅收集模型和测试度量。
合规性度量
要确定您的模型或子系统是否符合标准和规范,请运行以下一个或多个度量。
度量 | 描述 |
---|---|
MATLAB Code Analyzer Warnings | 确定您的模型中 MATLAB 代码块的警告。 |
Diagnostic Warnings Metric | 计算报告的诊断警告次数。 |
Model Advisor Check Compliance for High-Integrity Systems | 返回根据模型顾问 DO-178C/DO-331 标准模型通过的检查的百分比。 |
Model Advisor Check Compliance for Modeling Standards for MAB | 返回根据模型顾问 MAB 标准模型通过的检查的百分比。 |
Model Advisor Check Issues for High-Integrity Systems | 报告根据模型顾问 DO-178C/DO-331 标准检查出的问题的数量。 |
Model Advisor Check Issues for MAB Standards | 报告根据模型顾问 MAAB 标准检查出的问题的数量。 |
有关获取关于模型顾问配置的合规性和问题度量数据的合规性度量的详细信息,请参阅模型顾问配置的合规性度量。
有关模型度量的详细信息,请参阅收集模型和测试度量。
可读性度量
运行以下指标以确定模型或子系统的可读性。
度量 | 描述 |
---|---|
Nondescriptive Block Name Metric | 确定非描述性的 Inport、Outport 和 Subsystem 模块名称。 |
Data and Structure Layer Separation Metric | 计算数据和结构层分离。 |
有关模型度量的详细信息,请参阅收集模型和测试度量。
模型顾问配置的合规性度量
使用度量仪表板和度量 API 可获取模型顾问配置或现有检查组(例如 MISRA 检查)的合规性和问题度量数据。要设置您自己的模型顾问配置,请参阅使用模型顾问配置编辑器来自定义模型顾问。
您可以通过为自定义模型顾问度量创建度量 ID 来配置模型顾问合规性度量和模型顾问合规性问题度量。有关详细信息,请参阅Change Model Advisor Checks in Metrics Dashboard。
模型顾问合规性度量
度量类型:合规性
族 ID:mathworks.metrics.ModelAdvisorCheckCompliance
度量 ID:<族 ID>.<Model Advisor 检查组 ID>
使用此度量来计算所选检查组通过的模型顾问检查的百分比。
对于模型顾问合规性度量,族 ID 为 mathworks.metrics.ModelAdvisorCheckCompliance
。
要获取模型顾问检查组 ID,请打开模型顾问配置编辑器并选择包含所需检查组的文件夹。检查组 ID 显示在信息选项卡中。有关模型顾问配置编辑器的信息,请参阅使用模型顾问配置编辑器来自定义模型顾问。
有关如何使用模型顾问合规性度量的示例,请参阅Change Model Advisor Checks in Metrics Dashboard。
模型顾问合规性问题度量
度量类型:合规性
族 ID:mathworks.metrics.ModelAdvisorCheckIssues
度量 ID:<族 ID>.<Model Advisor 检查组 ID>
使用此度量来计算所选模型顾问检查组报告的问题的数量。此度量对所选模型顾问检查组中产生警告或失败结果的每个模型顾问检查进行计数。
对于模型顾问合规性问题度量,族 ID 为 mathworks.metrics.ModelAdvisorCheckIssues
。
要获取模型顾问检查组 ID,请打开模型顾问配置编辑器并选择包含所需检查组的文件夹。检查组 ID 显示在信息选项卡中。有关模型顾问配置编辑器的信息,请参阅使用模型顾问配置编辑器来自定义模型顾问。
有关如何使用模型顾问合规性度量的示例,请参阅Change Model Advisor Checks in Metrics Dashboard。