Main Content

Coverage Results Explorer

View, manage, and filter model coverage results

Description

Use the Coverage Results Explorer to view coverage results for cumulative or individual runs, create and load coverage filters, create coverage reports, and change coverage report settings.

The Coverage Results Explorer is a tool to interactively manage coverage data. You can mange which runs are included in the current cumulative data, manage coverage filters, and change coverage report settings. For more information, see Manage and Aggregate Coverage Results Using the Coverage Results Explorer.

From the Filter Editor pane, you can also invoke Simulink® Design Verifier™ to create model coverage justification filter rules for dead logic or invoke Polyspace® Code Prover™ to create code coverage justification filter rules for dead logic.

Coverage Results Explorer showing a summary of coverage results for the clutch model.

Open the Coverage Results Explorer

In the Coverage tab of the Simulink Toolstrip, under Review Results, click Results Explorer.

Examples

expand all

To create, load, and edit coverage filters, in the left pane, click Applied filters.

Default view of the Filter Editor pane of the Results Explorer.

This table describes the available options:

OptionDescription

New filter

Creates a blank filter and opens the Filter Editor pane.

Load filter

Opens the Load filter window. When you select a coverage filter and then click Apply, you apply that filter to the coverage results.

Make justification filter rules for dead logic (using Simulink Design Verifier)

Analyzes the model for design errors by running the Simulink Design Verifier design error detection analysis. For more information, see Analyze Models for Design Errors (Simulink Design Verifier).

Note

This option runs a non-exhaustive analysis, regardless of the setting of the Run exhaustive analysis parameter. For more information, see Design Verifier Pane: Design Error Detection (Simulink Design Verifier).

Make justification filter rules for dead logic (using Polyspace Code Prover results)

Opens the Polyspace Code Prover results file window. Select a results file to generate justification filter rules for dead logic and apply it to the coverage results.

In the Coverage Results Explorer, click Current Cumulative Data to see aggregated coverage data for multiple simulations. To see coverage results for a single simulation, expand Current Cumulative Data and click the run that you want to view.

To change the name of a coverage run, click the run name and set the Tag field to the desired string, then click Apply.

You can right-click coverage data and select Exclude from cumulative data to remove it from the Current Cumulative Data section. The coverage data removed remains in the Data Repository and you can add and remove it to or from the cumulative data.

Current Cumulative Data view of the Coverage Results Explorer for the clutch model.

You can select the Exclude inactive choices of variants option if your model contains variant blocks or variant configurations of Stateflow® charts. For more information, see Model Coverage for Variant Blocks.

To view recent coverage simulations, in the left pane, click Data Repository. The Data Repository pane displays recent coverage simulations performed, even you exclude them from the cumulative data.

Coverage Results Explorer with Data Repository selected. On the right it displays the name of the model, the full path to the coverage results, and the coverage checksum.

The Input folder field displays which folder the Coverage Results Explorer looks in for coverage results. You can change the value of the Input folder setting by setting the Output directory parameter. The Checksum section displays the checksum for the current coverage results. Each set of coverage data has its own checksum, and aggregating coverage data requires the checksums of the cvdata objects to match.

To synchronize the data in the input folder and the data in the Data Repository, click Synchronize with the current coverage data folder .

To load existing coverage data to the data repository:

  1. Right-click Data Repository.

  2. Select Load coverage data.

  3. Select existing coverage data for the current model and click Open.

Related Examples

Parameters

expand all

Specifies whether to aggregate coverage results from successive simulations. You specify the name and output folder of the CVT file by setting the Autosave data file name and Output directory parameters.

Specifies whether to show the cumulative coverage progress in the coverage report. The cumulative progress contains the current run coverage results, the delta of coverage compared to previous cumulative data, and the total cumulative data from all current cumulative data. If you do not select this option, Simulink Coverage™ displays the total result of all current cumulative data.

Specifies whether to show the coverage report in the Coverage Details pane when you analyze coverage for a model.

Specifies whether to open a web view report in the system browser when you click Generate report in the Coverage Results Explorer. For more information, see Export Model Coverage Web View.

Specifies whether to include each test in the model summary section of the coverage report. If you do not select this option, the model summary displays only the total coverage.

Specifies whether to include a table of aggregated tests in the coverage report.

Specifies whether to display bar graphs in the model summary of the coverage report.

Specifies whether to display the bar graphs in red and blue. If you clear this setting, the bar graphs appear in black and white.

Specifies whether to display coverage numbers as a hit/count ratio. For example, 67% (8/12).

Specifies whether to include only model objects that do not achieve 100% coverage. Use this setting to reduce the size of the generated report.

Specifies whether to omit the coverage tables for fully covered model objects in the Details by model object section of the coverage report.

Specifies whether to include cyclomatic complexity numbers in the summary section of the coverage report. For more information, see Types of Model Coverage.

Specifies whether to include the cyclomatic complexity metric in the block details section of the coverage report.

Specifies whether to exclude coverage data for Stateflow events.

Specifies whether to exclude coverage data for the block execution metric.

Specifies whether to include links to requirements in the Aggregated tests section of the coverage report.

Version History

Introduced in R2016b