decisioninfo - Display decision coverage information for model object

Syntax

Description

coverage = decisioninfo(cvdo, object) returns decision coverage results from the cvdata object cvdo for the model component specified by object.

coverage = decisioninfo(cvdo, object, ignore_descendants) returns decision coverage results for object, depending on the value of ignore_descendants.

[coverage, description] = decisioninfo(cvdo, object) returns decision coverage results and text descriptions of decision points associated with object.

Input Arguments

cvdo	cvdata object
ignore_descendants	Specifies to ignore the coverage of descendant objects if ignore_descendants is set to 1.
object	The object argument specifies an object in the model or Stateflow chart that received decision coverage. Valid values for object include the following: Object Specification Description BlockPath Full path to a model or block BlockHandle Handle to a model or block slObj Handle to a Simulink API object sfID Stateflow ID sfObj Handle to a Stateflow API object from a singly instantiated Stateflow chart {BlockPath, sfID} Cell array with the path to a Stateflow chart or atomic subchart and the ID of an object contained in that chart or subchart {BlockPath, sfObj} Cell array with the path to a Stateflow chart or subchart and a Stateflow object API handle contained in that chart or subchart [BlockHandle, sfID] Array with a handle to a Stateflow chart or atomic subchart and the ID of an object contained in that chart or subchart

Output Arguments

coverage	The value of coverage is a two-element vector of the form [covered_outcomes total_outcomes].coverage is empty if cvdo does not contain decision coverage results for object. The two elements are: covered_outcomes Number of decision outcomes satisfied for object total_outcomes Number of decision outcomes for object
description	description is a structure array containing the following fields: decision.text String describing a decision point, e.g., 'U > LL' decision.outcome.text String describing a decision outcome, i.e., 'true' or 'false' decision.outcome. executionCount Number of times a decision outcome occurred in a simulation

Examples

Open the slvnvdemo_cv_small_controller model and create the test specification object testObj. Enable decision coverage for slvnvdemo_cv_small_controller and execute testObj using cvsim. Use decisioninfo to retrieve the decision coverage results for the Saturation block and determine the percentage of decision outcomes covered:

mdl = 'slvnvdemo_cv_small_controller';
open_system(mdl)
testObj = cvtest(mdl)
testObj.settings.decision = 1;
data = cvsim(testObj)
blk_handle = get_param([mdl, '/Saturation'], 'Handle');
cov = decisioninfo(data, blk_handle)
percent_cov = 100 * cov(1) / cov(2)

Alternatives

To collect and display decision coverage results:

1. Open the model.

2. In the Model Editor, select Tools > Coverage Settings.

3. On the Coverage tab, under Coverage Metrics, select Decision.

4. Click OK to close the Coverage Settings dialog box and save your changes.

5. Simulate the model and review the results.

See Also

complexityinfo | conditioninfo | cvsim | getCoverageInfo | mcdcinfo | sigrangeinfo | sigsizeinfo | tableinfo

How To

• Condition Coverage (CC)

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS