Using Simulink

Model Coverage Commands

cvhtml

Produce an HTML report of cvdata object(s).

cvhtml(file,data) 

Create an HTML report of the coverage results in the cvdata object data. The report will be written to file.

cvhtml(file,data1,data2,...) 

Create a combined report of several data objects. The results from each object will be displayed in a separate column. Each data object must correspond to the same root subsystem or the function will produce errors.

cvhtml(file,data,data2,...,detail)

Specify the detail level of the report with the value of detail, an integer between 0 and 3. Greater numbers indicate greater detail. The default value is 2.

cvload

Load coverage tests and results from file.

[TESTS, DATA] = CVLOAD(FILENAME)

Load the tests and data stored in the text file FILENAME.CVT. The tests that are successfully loaded are returned in TESTS, a cell array of cvtest objects. DATA is a cell array of cvdata objects that were successfully loaded. DATA has the same size as TESTS but may contain empty elements if a particular test has no results.

Special considerations:

• If a model with the same name exists in the coverage database, only the compatible results will be loaded from file and they will reference the existing model to prevent duplication.
• If the Simulink models referenced from the file are open but do not exist in the coverage database, the coverage tool resolves the links to the existing models.

• When loading several files that reference the same model, only the results that are consistent with the earlier files will be loaded.

cvreport

Report the information in a cvdata object. This command has the following forms.

cvreport(file,data) 

Create a text report of the coverage results in the cvdata object data. The report will be written to file. If file is empty the report will be displayed at the command prompt.

cvreport(file,data1,data2,...)

Create a combined report of several test objects. The results from each object will be displayed in a separate column. Each data object must correspond to the same root subsystem or the function will produce errors.

cvreport(file,data1,data2,...,detail)

Specify the detail level of the report with the value of detail, an integer between 0 and 3. Greater numbers indicate greater detail. The default value is 2.

cvsave

Save coverage tests and results to file.

cvsave(filename,model) 

Save all the tests and results related to model in the text file filename.cvt.

cvsave(filename, test1, test2, ...) 

Save the specified tests in the text file filename.cvt. Information about the referenced model(s) is also saved.

cvsave(filename, data1, data2, ...) 

Save the specified data objects, the tests that created them, and the referenced model(s) structure in the text file filename.cvt.

cvsim

Run a test case.

Note    You do not have to enable model coverage reporting (see Creating and Running Test Cases) to use this command.

This command can take the following forms.

data = cvsim(test) 

Execute the cvtest object test by starting a simulation run for the corresponding model. The results are returned in a cvdata object.

[data,t,x,y] = cvsim(test) 

Returns the simulation time vector, t, state values, x, and output values, y.

[data,t,x,y] = cvsim( test, timespan, options)

Override the default simulation values. For more information see the sim command.

[data1, data2, ...] = cvsim( test1, test2, ... )

Execute a set of tests and return the results in cvdata objects.

[data1,t,x,y] = cvsim(root, label, setupcmd) 

Create and execute a cvtest object.

cvtest

Creates a test case. This command has the following syntax.

test = cvtest(root, label, setupcmd)

where root is the name or handle to the model or subsystem to be tested, label is a string that identifies the test case, and setupcmd is a MATLAB command that cvsim executes in the base workspace before running the instrumented model. The second two arguments are optional. The cvtest command returns a handle to the registered test case.

Coverage Settings Dialog Box

Model and Block Parameters