sltest.testmanager.run

Run tests with Test Manager

Syntax

resultObj = sltest.testmanager.run

resultObj = sltest.testmanager.run(Name,Value)

Description

resultObj = sltest.testmanager.run runs all of the Simulink^® Test™ test files in the Test Manager.

resultObj = sltest.testmanager.run(Name,Value) uses additional options specified by one or more name-value arguments.

Examples

Use API Commands to Run a Test File in the Test Manager

This example shows how to use sltest.testmanager.run to run a test file in the Test Manager. A simulation test case runs on the sldemo_autotrans model

Open the Model

sldemo_autotrans

Create a Test File, Test Suite, and Test Case

tf = sltest.testmanager.TestFile("API Test File");
ts = createTestSuite(tf,"API Test Suite");
tc = createTestCase(ts,"simulation","Simulation Test Case");

Remove the Default Test Suite

tsDel = getTestSuiteByName(tf,"New Test Suite 1");
remove(tsDel);

Assign the System Under Test to the Test case

setProperty(tc,"Model","sldemo_autotrans");

Run the Test File and Get the Test Results

ro = sltest.testmanager.run;

To run this example with Parallel Computing Toolbox, instead use

ro = sltest.testmanager.run("Parallel", true).

Open the Test Manager and View the Results

sltest.testmanager.view

View the Results in the Test Manager

Go to the Results and Artifacts pane and expand the Results.

Clear the Test Manager

sltest.testmanager.clear
sltest.testmanager.clearResults
sltest.testmanager.close

Input Arguments

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Parallel=true,Tags=["safety","regression"]

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: "Parallel",true,"Tags",["safety","regression"]

Parallel — Run with parallel computing

false (default) | true

Specifies whether to run tests with Parallel Computing Toolbox™ or MATLAB^® Parallel Server™. This option requires Parallel Computing Toolbox or MATLAB Parallel Server license, respectively.

Example: "Parallel",true

Data Types: logical

Tags — Run only tests with specified tags

string array | cell array of character vectors

Specifies test tags for execution. For more information, see Tags.

Example: "Tags",["safety"]

Example: "Tags",["safety","regression"]

Data Types: cell | char | string

Output Arguments

resultObj — Results set object

sltest.testmanager.ResultSet object

Results set object to get results from, returned as a sltest.testmanager.ResultSet object.

Extended Capabilities

Automatic Parallel Support

Accelerate code by automatically running computation in parallel using Parallel Computing Toolbox™.

To run in parallel, set Parallel to true.

For more information, see Run Tests Using Parallel Execution.

Version History

Introduced in R2015a