Documentation

Access, Manage, and Accumulate Coverage Results​​

After you Specify Coverage Options and record coverage results, you can use the Results Explorer to access, manage, and accumulate the coverage data that you record. After you accumulate the coverage results you need, you can then create a Top-Level Model Coverage Report or Export Model Coverage Web View using your accumulated coverage data.

Accessing Coverage Data from the Results Explorer

In the Configuration Parameters dialog box, on the Coverage > Results Pane, you can specify whether to show the Results Explorer after each simulation. You can also specify whether to generate an HTML report after each simulation. If you do not specify to show the Results Explorer or generate an HTML report, you can access the Results Explorer by selecting Analysis > Coverage > Open Results Explorer after you record coverage. The Coverage Results Explorer opens to show the most recent coverage run:

You can view the current data results summary from within the Results Explorer or click Generate Report to create a full coverage report. If you do not make any changes to your model after you record coverage, you do not need to resimulate the model to generate a new coverage report. For more information on coverage reports, see Top-Level Model Coverage Report.

Click Highlight model with coverage results to provide highlighted results in your model that allow you to quickly see coverage results for model objects. For more information, see Overview of Model Coverage Highlighting.

Settings

In the coverage Results Explorer, you can access the data and reporting settings for your coverage data. To access these settings, click Settings.

OptionDescription

Enable collecting cumulative data

Accumulates coverage results from successive simulations, by default. You specify the name and output folder of the .cvt file in the Configuration Parameters dialog box, on the Results Pane. For more information, see .Cumulative Coverage Data

Show cumulative progress report

Shows the Current Run coverage results, the Delta of coverage compared to the previous cumulative data, and the total Cumulative data from all current cumulative data separately in the coverage reports. If you do not select this option, only the total Cumulative data from all current cumulative data are shown.

Show report

Opens a generated HTML coverage report in a MATLAB® browser window at the end of model simulation. For more information, see Top-Level Model Coverage Report.

Generate Web View Report

Opens a generated Model Coverage Web View in a MATLAB browser window at the end of model simulation. For more information, see Export Model Coverage Web View.

Include each test in the model summary

At the top of the HTML report, the model hierarchy table includes columns listing the coverage metrics for each test. If you do not select this option, the model summary reports only the total coverage.

Produce bar graphs in the model summary

Causes the model summary to include a bar graph for each coverage result for a visual representation of the coverage.

Use two color bar graphs (red, blue)

Red and blue bar graphs are displayed in the report instead of black and white bar graphs.

Display hit/count ratio in the model summary

Reports coverage numbers as both a percentage and a ratio, for example, 67% (8/12).

Exclude fully covered model objects from report

The coverage report includes only model objects that the simulation does not cover fully, useful when developing tests, because it reduces the size of the generated reports.

Exclude fully covered model object details from report

If you choose to include fully covered model objects in the report, the report does not include the details of the fully covered model objects

Include cyclomatic complexity numbers in summary

Includes the cyclomatic complexity (see Types of Model Coverage) of the model and its top-level subsystems and charts in the report summary. A cyclomatic complexity number shown in boldface indicates that the analysis considered the subsystem itself to be an object when computing its complexity. Boldface text can occur for atomic and conditionally executed subsystems and Stateflow® Chart blocks.

Include cyclomatic complexity numbers in block details

Includes the cyclomatic complexity metric in the block details section of the report.

Filter Stateflow events from report

Excludes coverage data on Stateflow events.

Filter Execution metric from report

Excludes coverage data on Execution metrics

Creating and Managing Filters

You can create, load, or edit filters for the current coverage data from within the Results Explorer.

  1. Open the Results Explorer.

  2. Click the Current Cumulative Data.

  3. Click the Filter tab.

For more information on filtering model objects, see Creating and Using Coverage Filters.

Managing Coverage Data from the Results Explorer

After you record coverage, you can manage the coverage data from the Results Explorer. To view coverage data details, under Current Cumulative Data, click the coverage data of interest. You can edit the description and tags for each run. Before you leave the coverage data details view, click Apply to apply your changes. Otherwise, the changes are reverted.

When you apply changes to coverage data, such as adding descriptions and tags, the data shows an asterisk next to its icon. To save these changes, right-click the data and click Save modified coverage data.

Accumulating Coverage Data from the Results Explorer

If you record multiple coverage runs, each run is listed separately in the Data Repository. You can drag and drop runs from the Data Repository to the Current Cumulative Data to manage which runs to include in the cumulative coverage data. Alternatively, right-click runs in the Data Repository or the Current Cumulative Data to include or exclude them in the cumulative coverage data.

To save the current cumulative data set to a .cvt file, click Save cumulative coverage data. Alternatively, you can right-click the Current Cumulative Data and select Save cumulative coverage data.

Load Existing Coverage Data

The Data Repository contains the coverage data, which is saved to the Input folder. You specify the Input folder on the Configuration Parameters dialog box > Coverage > Results Pane, in the Output directory field.

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 the Data Repository.

  2. Select Load coverage data.

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

Was this topic helpful?