自定义指标仪表板布局和功能
通过使用模型度量编程接口定制度量仪表板。定制仪表板扩展了您使用模型度量来评估模型和代码是否符合大小、复杂性和可读性需求的能力。您可以执行以下指标仪表板定制:
配置遵从性度量以获得遵从性并在Model Advisor配置上发布度量数据。
通过添加自定义指标、删除小部件和配置现有小部件来定制仪表板布局。
通过指定度量阈值，将度量数据分类为符合、警告和不符合。
配置合规指标
使用Metrics Dashboard和度量api来获取遵从性，并在Model Advisor配置或现有检查组(如MISRA检查)上发布度量数据。要设置自己的Model Advisor配置，请参见使用模型Advisor配置编辑器定制模型Advisor．在您设置了Model Advisor配置之后，按照以下步骤指定您想要获得遵从性和问题度量数据的检查组:
1.要打开模型，在MATLAB命令提示符下输入以下命令:
sf_car
2.打开默认配置(即Metrics Dashboard附带的配置)。添加一个相应的slmetric.config.Configuration对象指向基本工作区。
metricconfig = slmetric.config.Configuration.openDefaultConfiguration ();
3.创建由与这些检查组对应的检查组id组成的单元格数组。通过打开Model Advisor Configuration Editor并选择包含检查组的文件夹来获取检查组ID。该文件夹包含检查组ID参数。
值= {“maab”，“hisl_do178”，“_SYSTEM_By Task_misra_c”}；
这个单元格数组指定MAAB、High-Integrity和MISRA检查组。的值maab和hisl_do178对应于MAAB和高完整性系统检查的子集。要包含所有检查，请指定检查组ID参数来自Model Advisor配置编辑器。
4.要设置配置，请通过值单元格数组setMetricFamilyParameterValues方法。的“ModelAdvisorStandard”控件提供的标准字符串setMetricFamilyParameterValues方法。
setMetricFamilyParameterValues (metricconfig“ModelAdvisorStandard”、价值观);
5.打开Metrics Dashboard布局的默认配置(即，Metrics Dashboard附带的配置)。
dashboardconfig = slmetric.dashboard.Configuration.openDefaultConfiguration ();
6.获得slmetric.dashboard.Layout对象的slmetric.dashboard.Configuration对象。
布局= getDashboardLayout (dashboardconfig);
7.获取布局对象中的小部件对象。
layoutWidget = getWidgets(布局);
8.的slmetric.dashboard.Layout对象包含以下对象:
一个
slmetric.dashboard.Container对象，该对象包含slmetrics.dashboard.Widget类型的对象系统信息．下图中红色的数字1表示系统信息小部件。一个
slmetric.dashboard.Group具有标题的对象大小．一个
slmetrics.dashboard.Group具有标题的对象建模指南依从性．一个
slmetrics.dashboard.Group具有标题的对象体系结构．
在图中，红色的数字1、2、3和4表示它们在layoutWidget数组中。从布局图中获取合规组。
complianceGroup = layoutWidget (3);
9.建模指南遵从性组包含两个容器。顶部的容器装着高完整性和MAAB遵从性和检查问题小部件。红色数字3.1.1、3.1.2和3.1.3表示三个小部件在第一个容器中的顺序。第二个容器包含代码分析警告和诊断的警告小部件。
删除高完整性合规小部件。
complianceContainers = getWidgets (complianceGroup);complianceContainerWidgets = getWidgets (complianceContainers (1));complianceContainers (1) .removeWidget (complianceContainerWidgets (1));
10.创建一个自定义小部件来可视化MISRA检查问题指标。
misraWidget = complianceContainers (1) .addWidget (“自定义”1);misraWidget。标题= (“MISRA”）;misraWidget。VisualizationType =“RadialGauge”；misraWidget.setMetricIDs (“mathworks.metrics.ModelAdvisorCheckCompliance。_SYSTEM_By Task_misra_c”）;misraWidget.setWidths (slmetric.dashboard.Width.Medium);
11.条形图小部件可视化了High Integrity和MAAB检查组。将这个小部件指向MISRA和MAAB检查组。
setMetricIDs (complianceContainerWidgets (3),..．({“mathworks.metrics.ModelAdvisorCheckIssues。_SYSTEM_By Task_misra_c”，..．“mathworks.metrics.ModelAdvisorCheckIssues.maab”}));complianceContainerWidgets(3)。标签= {“MISRA”，“MAAB”}；
12.要在示例中的此时运行Metrics Dashboard，取消注释以下代码行。save命令将API信息序列化为XML文件。的slmetric.config.setActiveConfiguration和slmetric.dashboard.setActiveConfiguration命令用于设置激活的配置对象。
%保存(metricconfig“文件名”、“MetricConfig.xml”);%保存(dashboardconfig“文件名”、“DashboardConfig.xml”);% slmetric.config.setActiveConfiguration (fullfile (pwd, ' MetricConfig.xml '));% slmetric.dashboard.setActiveConfiguration (fullfile (pwd, ' DashboardConfig.xml '));
14.要打开Metrics Dashboard，取消注释此代码。
% metricsdashboard sf_car
15.单击所有指标按钮并运行所有指标。Metrics Dashboard显示MISRA检查结果，而不是High Integrity检查结果。
16.关闭Metrics Dashboard。
向仪表板添加自定义指标
创建一个自定义度量来计数非虚拟块。要在Metrics Dashboard上显示此指标，请指定一个小部件。将其添加到大小组中。
1.使用createNewMetricClass函数，创建一个名为nonvirtualblockcount．函数创建一个文件，nonvirtualblockcount.m，在当前工作文件夹中。该文件包含一个构造函数和空的度量算法方法。对于本例，请确保您处于可写文件夹中。
className =“nonvirtualblockcount”；slmetric.metric.createNewMetricClass(名称);
2.要编写度量算法，请打开nonvirtualblockcount.m文件并将度量添加到文件中。对于本例，文件nonvirtualblockcount_orig.m包含创建计数非虚块的指标的逻辑。把这个文件复制到nonvirtualblockcount.m．
拷贝文件nonvirtualblockcount_orig.mnonvirtualblockcount.mf
3.在度量存储库中注册新度量。
[id_metric, err_msg] = slmetric.metric.registerMetric(名称);
4.删除表示Simulink块计数指标的小部件。金宝app这个小部件是大小组中的第一个。尺寸组是第二layoutWidget数组中。
sizeGroup = layoutWidget (2);sizeGroupWidgets = sizeGroup.getWidgets ();sizeGroup.removeWidget (sizeGroupWidgets (1));
5.添加一个显示非虚拟块计数指标的小部件。对于自定义小部件，默认的可视化类型是单值。如果要使用不同的可视化类型，请为VisualizationType财产。
newWidget = sizeGroup.addWidget (“自定义”1);newWidget。标题= (“Nonvirtual块计数”）;newWidget.setMetricIDs (“nonvirtualblockcount”）;newWidget.setWidths (slmetric.dashboard.Width.Medium);newWidget.setHeight (70);
6.指定组中是否有行将自定义小部件与其他小部件分隔开来。这些命令指定小部件右侧有一行。
s.top = false;s.bottom = false;s.left = false;s.right = true;newWidget。setSeparators([s, s, s]);
7.要在示例中的此时运行Metrics Dashboard，取消注释以下代码行。save命令将API信息序列化为XML文件。的slmetric.config.setActiveConfiguration和slmetric.dashboard.setActiveConfiguration命令用于设置激活的配置对象。
%保存(metricconfig“文件名”、“MetricConfig.xml”);%保存(dashboardconfig“文件名”、“DashboardConfig.xml”);% slmetric.config.setActiveConfiguration (fullfile (pwd, ' MetricConfig.xml '));% slmetric.dashboard.setActiveConfiguration (fullfile (pwd, ' DashboardConfig.xml '));
8.要打开Metrics Dashboard，取消注释此代码。
% metricsdashboard sf_car
9.单击所有指标按钮并运行所有指标。Metrics Dashboard显示非虚拟块计数指标的结果，而不是Simulink块计数指标。金宝app
10.关闭Metrics Dashboard。
添加指标阈值
对于非虚拟块计数和MISRA度量，指定度量阈值。通过指定这些值，您可以按如下方式对度量数据进行分类，从而访问模型的质量:
兼容-在可接受范围内的度量数据。
警告-需要审查的度量数据。
不合规——要求您修改模型的度量数据。
1.访问slmetric.config.ThresholdConfiguration对象slmetric.config.Configuration对象metricconfig．创建相应的slmetric.config.ThresholdConfiguration对象(TC)。
TC = getThresholdConfigurations (metricconfig);
2.添加两个slmetric.config.Threshold对象TC．每一个slmetric.config.Threshold对象包含默认值slmetric.config.Classification兼容的对象。指定符合要求的度量范围。
T1 = addThreshold (TC),“mathworks.metrics.ModelAdvisorCheckIssues。_SYSTEM_By Task_misra_c”，..．“AggregatedValue”）;C = getClassifications (T1);C.Range.Start =无穷;C.Range.End = 0;C.Range.IncludeStart = 0;C.Range.IncludeEnd = 1;T2 = addThreshold (TC,“mathworks.metrics.ModelAdvisorCheckCompliance。_SYSTEM_By Task_misra_c”，..．“AggregatedValue”）;C = getClassifications (T2);C.Range.Start = 1;C.Range.End =正;C.Range.IncludeStart = 1;C.Range.IncludeEnd = 0;
3.为每一个slmetric.config.Threshold对象，指定警告范围。
C = addClassification (T1,“警告”）;C.Range.Start = 0;C.Range.End =正;C.Range.IncludeStart = 0;C.Range.IncludeEnd = 1;C = addClassification (T2,“警告”）;C.Range.Start =无穷;C.Range.End = 1;C.Range.IncludeStart = 0;C.Range.IncludeEnd = 0;
这些命令指定，如果MISRA检查有问题，则模型状态为警告。如果没有问题，则模型状态是兼容的。
4.添加一个第三slmetric.config.Threshold对象TC．为此指定符合、警告和不符合的范围slmetric.config.Threshold对象。
T3 = addThreshold (TC),“nonvirtualblockcount”，“AggregatedValue”）;C = getClassifications (T3);C.Range.Start =无穷;C.Range.End = 20;C.Range.IncludeStart = 1;C.Range.IncludeEnd = 1;C = addClassification (T3,“警告”）;C.Range.Start = 20;C.Range.End = 30;C.Range.IncludeStart = 0;C.Range.IncludeEnd = 1;C = addClassification (T3,“不合格”）;C.Range.Start = 30;C.Range.End =正;C.Range.IncludeStart = 0;C.Range.IncludeEnd = 1;
这些命令指定符合的范围小于或等于20。警告范围从20到30，但不包括30。不符合范围大于30。
5.保存配置对象。这些命令将API信息序列化为XML文件。
保存(metricconfig,“文件名”，“MetricConfig.xml”）;保存(dashboardconfig,“文件名”，“DashboardConfig.xml”）;
6.设置激活配置。
slmetric.config.setActiveConfiguration (fullfile (pwd,“MetricConfig.xml”));slmetric.dashboard.setActiveConfiguration (fullfile (pwd,“DashboardConfig.xml”));
7.对于您的模型，打开Metrics Dashboard。
metricsdashboardsf_car
对于MISRA检查符合性问题，标尺是黄色的，因为76%的检查通过了。任何低于100%的百分比都是一个警告。柱状图还显示黄色，因为模型包含三个MISRA检查问题。任何大于零的数字都是警告。
的Nonvirtual块计数小部件在兼容范围内，因为有15个非虚拟块。
8.要重置配置并注销度量值，请取消注释并执行以下命令:
% slmetric.metric.unregisterMetric(名称);% slmetric.dashboard.setActiveConfiguration (");% slmetric.config.setActiveConfiguration (");
另请参阅
slmetric.config.Configuration|slmetric.dashboard.Configuration
相关的话题
你也可以从以下列表中选择一个网站:
