metric.Engine

Collect metric data on model testing artifacts

Description

Use a metric.Engine object represents the metric engine that you can execute with the execute object function to collect metric data on the status and quality of requirements-based testing activities. Use getMetrics to access the metric data and return an array of metric.Result objects. The metrics analyze testing artifacts such as requirements, test results, and coverage results. Use the metric data to assess the status and quality of your requirements-based model testing.

Creation

Syntax

metric_engine = metric.Engine()

metric_engine = metric.Engine(projectPath)

Description

metric_engine = metric.Engine() creates a metric engine object that collects metric data on the current project.

metric_engine = metric.Engine(projectPath) opens the project projectPath and creates a metric engine object that collects metric data on the project.

Input Arguments

projectPath — Path of project

character vector | string scalar

Path of the project for which you want to collect metric data, specified as a character vector or string scalar.

Properties

ProjectPath — Project for metric collection

string scalar

This property is read-only.

Project for which the engine collects metric data, returned as a string.

Object Functions

execute	Collect metric data for Model Testing Dashboard
generateReport	Generate report file that contains metric results
getArtifactErrors	Return errors that occurred during artifact tracing
getAvailableMetricIds	Return metric identifiers for available metrics
getMetrics	Access metric data for model testing artifacts
openArtifact	Open testing artifact traced from the metric result
updateArtifacts	Update trace information for any pending artifact changes in the project

Examples

Collect Metric Data on Testing Artifacts in a Project

Use a metric.Engine object to collect metric data on the requirements-based testing artifacts in a project.

Open the project. At the command line, type dashboardCCProjectStart.

dashboardCCProjectStart

Create a metric.Engine object for the project.

metric_engine = metric.Engine();

Update the trace information for metric_engine to ensure that the artifact information is up to date.

updateArtifacts(metric_engine)

Collect results for the metric Requirements per test case by executing the metric engine.

execute(metric_engine,{'RequirementsPerTestCase'});

Use the function getMetrics to access the results.

results = getMetrics(metric_engine,'RequirementsPerTestCase');
for n = 1:length(results)
    disp(['Test Case: ',results(n).Artifacts(1).Name])
    disp(['  Number of Requirements: ',num2str(results(n).Value)])
end

Test Case: Set button
  Number of Requirements: 0
Test Case: Decrement button hold
  Number of Requirements: 1
Test Case: Resume button
  Number of Requirements: 1
Test Case: Cancel button
  Number of Requirements: 1
Test Case: Decrement button short
  Number of Requirements: 2
Test Case: Increment button hold
  Number of Requirements: 1
Test Case: Increment button short
  Number of Requirements: 2
Test Case: Enable button
  Number of Requirements: 1

The results show that the test case Set button is missing links to requirements. To fix this, you would link the test case to the requirement that it verifies.

Version History

Introduced in R2020b