Access, Manage, and Aggregate Coverage Results
After you Specify Coverage Options and collect coverage results, you can use the Results Explorer to access, manage, and aggregate the coverage data that you collect. After you aggregate the coverage results you need, you can then create a Top-Level Model Coverage Report or Export Model Coverage Web View using your aggregated coverage data.
Accessing Coverage Data from the Results Explorer
To open the Results Explorer after coverage analysis, in the Coverage Analyzer app, click on Results Explorer. The 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 collect coverage, you do not need to re-simulate the model to generate a new coverage report. For more information on coverage reports, see Top-Level Model Coverage Report.
Select Exclude inactive choices of variants to filter out
coverage results for inactive variant choices. Clear this option to receive coverage
information about inactive variant choices. This option applies to variant blocks
that have the Variant activation time set to
Startup and to variant configurations in Stateflow® charts. For more information, see Model Coverage for Variant Blocks.
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.
Click Open Simulation Data Inspector to view the current selected run simulation data in the Simulation Data Inspector. The model must generate valid data that can be opened in the Simulation Data Inspector for this option to become available, for example, by selecting signals for signal logging. For more information about the Simulation Data Inspector, see View Data in the Simulation Data Inspector.
In the coverage Results Explorer, you can access the data and reporting settings for your coverage data. To access these settings, click Settings.
Enable collecting cumulative data
Aggregates coverage results from successive
simulations, by default. You specify the name and output
folder of the
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.
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.
You access the HTML report from the Simulink® Coverage™ contextual tabs, which appear when you open the Coverage Analyzer app.
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.
|Show aggregated tests information|
If you collect coverage for one or more subsystem harness, the Aggregated Tests section lists each unit test run. For more information, see Aggregated Tests.
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
|Include linked requirements in aggregate coverage report|
If you run at least two test cases in Simulink Test™ that are linked to requirements in Requirements Toolbox™, the aggregated coverage report details the links between model elements, test cases, and linked requirements. For more information, see Requirement Testing Details.
Creating and Managing Filters
You can create, load, or edit filters for the current coverage data from within the Results Explorer.
Open the Results Explorer.
Click the Applied filters tab.
Creates a blank filter and opens the Filter Editor pane of the Coverage Results Explorer.
Opens the Load filter selection window.
Make justification filter rules for dead logic (using Simulink Design Verifier™)
Launches Simulink Design Verifier design error detection. For more information, see Analyze Models for Design Errors (Simulink Design Verifier).
Make justification filter rules for dead logic (using Polyspace® Code Prover™ results)
Opens a file selection window which asks for a Polyspace Code Prover results file.
For more information on filtering model objects, see Creating and Using Coverage Filters.
Managing Coverage Data from the Results Explorer
After you collect 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.
When you highlight the model with coverage results, the Coverage Results Explorer displays (H) next to Current Cumulative Data.
Accumulating Coverage Data from the Results Explorer
If you collect 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 section, 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:
Right-click the Data Repository.
Select Load coverage data.
Select existing coverage data for the current model and click Open.