Model Metrics

Collect model compliance metric data and create custom model metrics

Note

The Metrics Dashboard will be removed in a future release.

If you currently only use the Metrics Dashboard to analyze your model size, architecture, and complexity, then you can use the Model Maintainability Dashboard instead. For information, see Migrating from Metrics Dashboard to Model Maintainability Dashboard.

You can use model metrics to assess that your model and code comply with size, complexity, and readability requirements. Use the model metric API to create custom model metrics, compute metric results, and export metric data. Use the Metrics Dashboard to visualize the metric data and compliance status for your model. To get started, see Collect and Explore Metric Data by Using Metrics Dashboard.

Classes

expand all

Collect Model Metric Data

`slmetric.Engine`	(To be removed) Collect metric data on models or model components
`slmetric.metric.MetaInformation`	(To be removed) Access meta-information for metrics
`slmetric.metric.Result`	(To be removed) Metric data for specified model component and metric algorithm
`slmetric.metric.ResultCollection`	(To be removed) Metric data for specified model metric
`slmetric.metric.ResultDetail`	(To be removed) Details about instances of `slmetric.metric.Result` objects
`slmetric.metric.ResultClassification`	(To be removed) Access metric data thresholds results

Customize Metrics Dashboard

`slmetric.config.Configuration`	(To be removed) Specify metric data categories and custom metric families
`slmetric.config.ThresholdConfiguration`	(To be removed) Specify metric and `slmetric.metric.Result` property for thresholding
`slmetric.config.Threshold`	(To be removed) Object for holding metric result thresholds
`slmetric.config.Classification`	(To be removed) Specify categorical metric data ranges
`slmetric.config.MetricRange`	(To be removed) Specify metric data threshold values
`slmetric.dashboard.Configuration`	(To be removed) Object containing information on Metrics Dashboard layout and widgets
`slmetric.dashboard.Container`	(To be removed) Widget for holding `slmetric.dashboard.Widget` and `slmetric.dashboard.CustomWidget` objects in Metrics Dashboard
`slmetric.dashboard.CustomWidget`	(To be removed) Object for holding custom Metrics Dashboard widgets
`slmetric.dashboard.Group`	(To be removed) Widget for holding `slmetric.dashboard.Container`, `slmetric.dashboard.Widget` and `slmetric.dashboard.CustomWidget` objects on Metrics Dashboard
`slmetric.dashboard.Layout`	(To be removed) Create object for holding Metrics Dashboard customizations
`slmetric.dashboard.Widget`	(To be removed) Object for holding Actual/Potential Reuse, System Interface, or System Info widgets

Create Custom Model Metric

`Advisor.component.Component`	Create component for metric analysis
`Advisor.component.Types`	Create `enum` class specifying component type
`slmetric.metric.Metric`	(To be removed) Abstract class for creating model metrics

Functions

expand all

Collect Model Metric Data

`metricsdashboard`	(To be removed) Open Metrics Dashboard
`slmetric.metric.getAvailableMetrics`	(To be removed) Obtain available metrics

Customize Metrics Dashboard

`slmetric.config.getActiveConfiguration`	(To be removed) Obtain file path and name of XML file containing active Metrics Dashboard custom configuration
`slmetric.config.setActiveConfiguration`	(To be removed) Activate custom configuration for metric engine to use
`slmetric.dashboard.setActiveConfiguration`	(To be removed) Activate custom metric dashboard layout
`slmetric.dashboard.getActiveConfiguration`	(To be removed) Obtain file path and name of XML file containing active Metrics Dashboard layout

Create Custom Model Metric

`slmetric.metric.createNewMetricClass`	(To be removed) Create new metric class for a custom model metric
`slmetric.metric.registerMetric`	(To be removed) Register a custom model metric with the model metric repository
`slmetric.metric.unregisterMetric`	(To be removed) Unregister a custom model metric from the model metric repository
`slmetric.metric.refresh`	(To be removed) Update available model metrics

Topics

Migrate to Model Maintainability Dashboard

Migrating from Metrics Dashboard to Model Maintainability Dashboard
Use the Model Maintainability Dashboard to analyze model size, architecture, and complexity.

Explore Metric Data

Collect and Explore Metric Data by Using Metrics Dashboard
Collect and view metric data for quality assessment.
Collect Model Metrics Programmatically
Use the model metric API to programmatically collect metrics for a model, such as subsystem and block counts.
Model Metrics
Model metrics provided by MathWorks^® that return metric data on your model for size, complexity, readability, and compliance to standards and guidelines.
Model Metric Data Aggregation
Options for defining model metric data aggregation and returning aggregated model metric results.
Identify Modeling Clones with the Metrics Dashboard
You can use the Metrics Dashboard tool to enable subsystem reuse by identifying exact graphical clones across a model hierarchy.
Collect Model Metrics Using the Model Advisor
Assess model size, complexity, and readability, using the Model Advisor to run model metric checks.
Collect Compliance Data and Explore Results in the Model Advisor
This example shows how to collect model metric data by using the Metrics Dashboard and explore detailed compliance results and, fix compliance issues by using the Model Advisor.
Collect Metric Data Programmatically and View Data Through the Metrics Dashboard
This example shows how to use the model metrics API to collect model metric data for your model, and then explore the results by using the Metrics Dashboard.
Fix Metric Threshold Violations in a Continuous Integration Systems Workflow
Use a continuous integration workflow to investigate whether your model violates metric threshold values.
Compare Model Complexity and Code Complexity Metrics
Assess the complexity of your system in model-based design.

Customize Metrics and Dashboard Functionality

Rearrange and Remove Widgets in Metrics Dashboard
Rearrange and remove widgets in the default Metrics Dashboard layout.
Modify, Remove, and Add Metric Thresholds in Metrics Dashboard
Customize metric thresholds for the Metrics Dashboard.
Change Model Advisor Checks in Metrics Dashboard
Create custom Model Advisor metrics and display the results in the Metrics Dashboard.
Create a Custom Model Metric for Nonvirtual Block Count
Create a new model metric by using the slmetric.metric.createNewMetricClass function and defining the metric algorithm.
Create Layout with Custom Metric
Create a new Metrics Dashboard layout and add custom widgets.
Customize Metrics Dashboard Layout and Functionality
Configure compliance metrics, add metric thresholds, and customize Metrics Dashboard layout.