Requirements Execution Coverage Breakdown

R2026b

Since R2022b

RequirementsExecutionCoverageBreakdown

This metric returns the fraction of overall achieved execution coverage that comes from requirements-based tests.

This metric collects metric results for Units in the project. To control what the dashboard classifies as a unit, see Categorize Models in Hierarchy as Components or Units.

The metric:

Analyzes the overall aggregated coverage results.
Does not analyze coverage from tests that run in software-in-the-loop (SIL) or processor-in-the-loop (PIL) mode.

To collect metric results, execute the metric engine using the metric ID.

metricEngine = metric.Engine;
metricResults = execute(metricEngine,"RequirementsExecutionCoverageBreakdown")

Collecting data for this metric loads the model file and test results files and requires a Simulink^® Coverage™ license.

For this metric, instances of metric.Result return the Value as a structure that contains these fields:

Numerator — The number of requirements-based tests that contribute to the overall achieved execution coverage.
Denominator — The total number of tests (requirements-based and non-requirements-based) that contribute to the overall achieved execution coverage.
Value — The ratio of requirements-based tests to all tests that contribute to execution coverage, calculated by dividing the Numerator by the Denominator.

The default compliance thresholds for this metric are:

Compliant — 100% of the overall achieved execution coverage comes from requirements-based tests
Non-Compliant — Less than 100% of the overall achieved execution coverage comes from requirements-based tests
Warning — None

See Also