Code Quality Dashboard

View code quality metrics for projects

Since R2023a

Description

Use the Code Quality Dashboard to view project quality metrics, including code issues, test and code coverage results, and the requirements verification status.

Use the Code Quality Dashboard to view metrics for the current project, including:

• The Code Issues section displays a summary of MATLAB^® Code Analyzer report.

• The Tests section displays a summary of test results.

• The MATLAB Code Coverage section displays code coverage for the MATLAB source code.

• The Generated Code Coverage section displays code coverage for generated C/C++ code when you run SIL and PIL equivalence tests. (since R2024b)

• The Requirements section displays the verification status of requirements.

The metrics update when you click the run button . If you run tests from the MATLAB Test Manager or change files in the project, the metrics in the Code Quality Dashboard become out of date. To update the dashboard, click Refresh Metrics in the banner.

Open the Code Quality Dashboard App

Open a project, then use one of these approaches to open the app:

• MATLAB Toolstrip: In the Project tab, in the Tools menu, under Apps, click Code Quality Dashboard.

• MATLAB command prompt: Enter codeQualityDashboard.

Examples

Collect Test and Requirements Metric Results

Since R2023a

This example shows how to collect test and requirements metric results and reflect the results in the Code Quality Dashboard.

Open the MATLABShortestPath project.

openProject("MATLABShortestPath");

Open the Code Quality Dashboard.

codeQualityDashboard

Run the tests in the project by clicking the Run button .

Collect MATLAB Coverage Metric Results

Since R2023a

This example shows how to collect MATLAB coverage metric results and display the results in the Code Quality Dashboard.

Open the MATLABShortestPath project.

openProject("MATLABShortestPath");

Open the MATLAB Test Manager.

matlabTestManager

In the toolstrip, click the Configure code coverage collection button , select Enable MATLAB code coverage, and set the coverage metric level to MC/DC.

Open the Code Quality Dashboard.

codeQualityDashboard

Run tests and collect coverage by clicking the Run button .

Programmatically Update, Get, and Export Code Quality Dashboard Metrics

Since R2024a

This example shows how to update, get, and export metrics from the Code Quality Dashboard.

Open the ShortestPath project.

openProject("MATLABShortestPath");

Open the Code Quality Dashboard.

codeQualityDashboard

Run the tests in the project, collect coverage for the tests, verify the requirements, and update the metrics in the dashboard.

matlabtest.codequalitydashboard.runTestsAndRefreshData

pathLength = 
3

Get the metrics from the Code Quality Dashboard.

metrics = matlabtest.codequalitydashboard.getMetrics

metrics = struct with fields:
    ProjectPath: "C:/Users/user/OneDrive - MathWorks/Documents/MATLAB/ExampleManager/user.examples/matlabtest-ex46234077/MATLABShortestPath"
        Metrics: [1×1 struct]

Export the metrics to a JSON file.

filePath = matlabtest.codequalitydashboard.exportMetrics

filePath = 
"C:\Users\user\OneDrive - MathWorks\Documents\MATLAB\ExampleManager\user.examples\matlabtest-ex46234077\MATLABShortestPath\CodeQualityMetrics.json"

Open Requirement Sets in the Current Project

Since R2024b

If you have Requirements Toolbox™, you can open the requirement sets in the current project in the Requirements Editor (Requirements Toolbox).

To open the requirement sets, open the Code Quality Dashboard and click the Requirements section title.

If you have loaded requirement sets that are not in the current project, a dialog box prompts you to save and close them.

The Requirements Editor (Requirements Toolbox) opens and displays the loaded requirement sets.

Generate Traceability Matrix for Requirements and Tests in Current Project

Since R2024b

If you have Requirements Toolbox, you can generate a traceability matrix that contains the requirement sets and MATLAB tests in the current project.

To generate the traceability matrix, open the Code Quality Dashboard. Then, in the Requirements section, click the three-dot icon and select Generate Traceability Matrix.

If you have loaded requirement sets that are not in the current project, a dialog box prompts you to save and close them.

The Traceability Matrix window opens and displays the loaded requirement sets on the top and the tests on the left.

For more information about traceability matrices, see Track Requirement Links with a Traceability Matrix (Requirements Toolbox).

Version History

Introduced in R2023a

R2026a: Tests and Requirements section color change

The Tests and Requirements sections of the Code Quality Dashboard now use colors with better contrast.

R2026a: Code Coverage and Code Analyzer sections have new names

The Code Coverage section is now MATLAB Code Coverage. The Code Analyzer section is now Code Issues.

R2025a: View requirements justified for verification in Code Quality Dashboard

The requirements section of Code Quality Dashboard shows a justified status for requirements justified for verification.

R2025a: Refreshing the Code Quality Dashboard updates the metrics with added or removed tests

Refreshing the Code Quality Dashboard updates the metrics with added or removed test files or test methods. For more information, see Update the Dashboard.

R2024b: Open requirement sets in current project

If you have Requirements Toolbox, you can open the requirement sets in the current project by clicking the Requirements section in the dashboard.

R2024b: Generate traceability matrix for requirements and tests in the current project

If you have Requirements Toolbox, you can generate a traceability matrix that contains the requirement sets and MATLAB tests in the current project. In the dashboard, in the Requirements section, click the three-dot icon and select Generate Traceability Matrix.

R2024b: View code coverage results for generated C/C++ code

If you have Embedded Coder^®, you can use the MATLAB Test Manager to collect coverage for generated C/C++ code that you execute in SIL and PIL equivalence tests. View a summary of the coverage results in the Generated Code Coverage section and open an HTML coverage report by clicking the section.

R2024a: Run tests by using the Code Quality Dashboard

Run tests by using the Run button . Stop the tests from running to completion by clicking the Stop button .

R2023b: View timestamps for metric results in the Code Quality Dashboard

Each section of the Code Quality Dashboard displays a timestamp that indicates when the software collected the results.

R2023b: View tests and results from referenced projects in the Code Quality Dashboard

When a parent project references other projects, the Code Quality Dashboard collects and displays quality metrics for the parent project and its referenced projects.