Review Requirements Verification Status
You can view the verification status of your requirements in the Requirements Browser and Requirements
Editor. The verification status reflects results from simulation testing using
Simulink®
Test™ or property proving using Simulink
Design Verifier™. Use Verify
type links from requirements to simulation
assessments or proof objectives. For more information, see Link Types.
Verify Functional Requirements
The requirement type specifies the role of a requirement. Functional requirements as
well as requirements with a custom type that is a subtype of the
Functional
type, are meant to be implemented and contribute to
the verification status summary. Other requirement types do not contribute to the
verification status. For more information, see Requirement Types and Define Custom Requirement and Link Types by Using sl_customization Files.
You can verify functional requirements by linking them with certain verification items
with Verify
type links.
MATLAB® testing: Requirement verification status reflects the results of MATLAB unit tests run in the Requirements Editor or tun by using
slreq.ReqSet.runTests
. For more information, see Verify Requirements with MATLAB Tests and Ways to Write Unit Tests.Note
Test results from the Test Browser and MATLAB Test Manager (MATLAB Test) do not affect the verification status in the Requirements Editor.
Simulation testing: Requirement verification status reflects the results of the following linkable Simulink Test items after you run these items in the Test Manager:
Test files
Test suites
Test cases
Iterations
Assessments
To learn how to verify requirements with Simulink Test items, see Test Model Against Requirements and Report Results.
Run tests from the Simulink Test Manager, or using
sltest.testmanager.run
(Simulink Test). For a brief tutorial on creating and running a test case, follow the first part of Create and Run a Baseline Test Case (Simulink Test).Capture run-time assessments from verify (Simulink Test) statements or Model Verification Blocks (Simulink Test) by monitoring those assessments through test cases in the Test Manager.
If you link a step in Test Sequence block that contains a verify (Simulink Test) statement to a requirement, then you can visualize the verification status of that corresponding
verify
statement when:Test Harness: You simulate the test harness containing the Test Sequence block and open the simulation results in Simulink Data Inspector (SDI)
Test Manager: You run tests in Simulink Test which executes the Test Sequence block with step containing
verify
statement.
Alternatively, use the Run Tests option from the Requirements menu or the
runTests
function to run batch tests for the specified requirements.If you manually set the link type for a step to be verified by when the step does not contain any
verify
statements, then the verification status will remainsunexecuted
.Assert
statements will not be marked as verified by in the Requirements Editor. For more information, see Assess Model Simulation Usingverify
Statements (Simulink Test).Property proving: Verification status reflects the analysis results of properties modeled using:
Simulink Design Verifier Proof Objective blocks
Model Verification blocks
Link blocks to requirements, then analyze the properties. For more information, see Validate Requirements by Analyzing Model Properties.
You can also verify requirements by linking to external result sources
with Confirm
type links. For more information, see Include Results from External Sources in Verification Status
Run Link Verification Analysis
Requirements Toolbox™ does not perform link verification analysis until you run it. You can run the analysis in Requirements Editor or Requirements Perspective.
A banner in the Requirements Editor or Requirements
Perspective indicates when results are pending. To run the analysis, click Analyze
now in the banner. Alternatively, click Refresh in the
Requirements Editor or the refresh button in the Requirements Perspective.
Link verification analysis continuously runs in the background until you use slreq.clear
.
Alternatively, you can use updateVerificationStatus
and getVerificationStatus
to view the verification status at the MATLAB command line without running the analysis in the Requirements
Editor or Requirements Perspective. You can also use slreq.ReqSet.runTests
to run tests linked to requirements in the
requirement set and get the verification status at the command line.
Display Verification Status
The verification status is summarized in the Verified column of the Requirements Browser and Requirements Editor. To display the column:
In the Requirements Editor, select
Columns > Verification Status
In the Requirements Browser pane of the model window, right-click a requirement and select Verification Status.
For example, the Verified column shows partial verification links for this requirement set, with one failed result.
The fullness of the bar indicates how many requirements in a group including the parent requirement and any children requirements are linked to verification items. The color indicates the test or analysis results:
Passed (green): The linked test(s) passed, or the analysis proved the objective(s).
Failed (red): The linked test(s) failed, or the analysis falsified the objective(s).
Justified (light blue): The requirement is excluded from the status with a justification. For more information, see Justify Requirements.
Unexecuted: (yellow): The linked test(s) or objective(s):
Have not run or executed
Have been updated more recently than the most recent result
None (colorless): The requirement does not have
Verify
type links.
Update Verification Status by Running Tests or Analyses
You can update the verification status by running tests or analyses linked to your requirements.
In the Requirements Editor, right-click the requirement and select Run Tests.
In the Run Tests dialog box, select the tests.
Click Run Tests.
You can also update verification status by running tests or analysis outside of the Requirements Editor.
In Simulink Test, run the tests in the Test Manager.
In Simulink Design Verifier, run property proving analysis.
In Simulink, run the model that contains the Model Verification blocks.
Note
If you have linked requirements to Simulink Design Verifier Proof Objective blocks in multiple models, the Run Tests dialog box runs a Simulink Design Verifier analysis when the corresponding models are open.
Include Verification Status in Report
You can include verification status in your requirements report.
In the Requirements Editor menu, select Report > Generate Report.
Select Verification Status.
Click Generate Report.
For more information, see Report Requirements Information.