以编程方式收集模型度量

R2026b
打开实时脚本

您可以使用模型度量 API 以编程方式收集模型度量，从而帮助评估模型的架构、复杂性和可读性。这些度量的结果可帮助您验证是否符合行业标准和规范。

此示例说明如何使用模型度量 API 以编程方式收集模型的子系统和模块计数度量。收集模型的度量后，您可以访问结果并将结果导出为文件。

注意：以后的版本中将会删除度量仪表板、模型度量、slmetric API 以及对应的自定义项。有关详细信息，请参阅Migrating from Metrics Dashboard to Model Design Dashboards。

示例模型

打开 vdp 模型。

model = 'vdp';
open_system(model);

Van der Pol Equation Simulink model (vdp) with integrators, gain, and scope blocks

收集度量

要收集模型的度量数据，请为要收集的度量创建一个 slmetric.Engine 对象并调用 execute。对于此示例，请指定 vdp 模型的模块计数和子系统计数度量。

metric_engine = slmetric.Engine();
setAnalysisRoot(metric_engine,'Root','vdp','RootType','Model');
execute(metric_engine,{'mathworks.metrics.SimulinkBlockCount',...
    'mathworks.metrics.SubSystemCount'});

访问结果

使用 getMetrics 方法指定您要获取度量结果的度量。getMetrics 会返回 slmetric.metric.ResultCollection 对象数组。

res_col = getMetrics(metric_engine,{'mathworks.metrics.SimulinkBlockCount',...
'mathworks.metrics.SubSystemCount'});

存储和显示结果

创建一个名为 metricData 的元胞数组来存储度量结果的 MetricID、ComponentPath 和 Value 属性。MetricID 属性是度量的标识符，ComponentPath 属性是计算度量时针对的组件的路径，Value 属性是度量值。编写一个循环来显示结果。

metricData ={'MetricID','ComponentPath','Value'};
cnt = 1;
for n=1:length(res_col)
    if res_col(n).Status == 0
        results = res_col(n).Results;

        for m=1:length(results)
            disp(['MetricID: ',results(m).MetricID]);
            disp(['  ComponentPath: ',results(m).ComponentPath]);
            disp(['  Value: ',num2str(results(m).Value)]);
            metricData{cnt+1,1} = results(m).MetricID;
            metricData{cnt+1,2} = results(m).ComponentPath;
            metricData{cnt+1,3} = results(m).Value;
            cnt = cnt + 1;
        end
    else
        disp(['No results for:',res_col(n).MetricID]);
    end
    disp(' ');
end
MetricID: mathworks.metrics.SimulinkBlockCount

  ComponentPath: vdp

  Value: 12

 

MetricID: mathworks.metrics.SubSystemCount

  ComponentPath: vdp

  Value: 0

导出结果

要将 MetricID、ComponentPath 和 Value 导出到电子表格，请使用 writetable 将 metricData 的内容写入到 MySpreadsheet.xlsx。

filename = 'MySpreadsheet.xlsx';
T=table(metricData);
writetable(T,filename);

要将度量结果导出到 XML 文件，请使用 exportMetrics 方法。对于每个度量结果，XML 文件都包括 ComponentID、ComponentPath、MetricID、Value、AggregatedValue 和 Measure。

filename='MyMetricResults.xml';
exportMetrics(metric_engine,filename)

关闭 vdp 模型。

bdclose(model);

限制

当收集度量数据时，这些数据会存储在仿真缓存文件夹内的数据库文件 Metrics.db 中。您不能在一个平台上收集度量数据，然后将数据库文件移动到另一个平台，再继续在该数据库文件中收集额外的度量数据。例如，如果您在 Windows 计算机上收集了度量数据，然后将数据库文件移动到 Linux 计算机，则无法在该数据库文件中收集和存储额外的度量数据。不过，您能够在度量仪表板中查看该数据。

另请参阅

| |

主题