Main Content

sltest.testmanager.run

Run tests with Test Manager

Description

example

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

example

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

Examples

collapse all

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

collapse all

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"]

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

Simulation mode for running all test files in the Test Manager, specified as "Normal", "Accelerator", "Rapid Accelerator", "Software-in-the-Loop", or "Processor-in-the-Loop". When you specify this name-value argument, the setting overrides the simulation mode set in the Test Manager. You do not need to update the test parameters or settings when running the tests in the new mode.

The SimulationMode value

  • Applies to both simulations in an equivalence test.

  • Applies to all iterations in a test case.

  • Applies to multirelease tests.

  • Does not apply to baseline captures.

  • Does not apply to real-time tests or MATLAB-based Simulink tests.

If you set SimulationMode to "Software-in-the-Loop" or "Processor-in-the-Loop", and select Override model blocks in SIL/PIL mode to normal mode in the System Under Test section of the Test Manager, the Test Manager uses the SimulationMode value to run the test.

Example: "SimulationMode","Accelerator"

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

Example: "Tags",["safety"]

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

Data Types: cell | char | string

Output Arguments

collapse all

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

Extended Capabilities

Version History

Introduced in R2015a

expand all