sltest.testmanager.TestIterationResult class

Package: sltest.testmanager

Access test iteration result data

Description

Instances of sltest.testmanager.TestIterationResult enable you to access the results from test execution performed by the Test Manager at a test-iteration level. The hierarchy of test results is Result Set > Test File Result > Test Suite Result > Test Case Result > Test Iteration Result.

The sltest.testmanager.TestIterationResult class is a handle class.

Class Attributes

HandleCompatible

true

For information on class attributes, see Class Attributes.

Creation

Description

The function sltest.testmanager.run creates a sltest.testmanager.ResultSet object, which contains the test case result object. For an example, see Get Test Iteration Results

Properties

Outcome — Outcome of test iteration result

0 | 1 | 2 | 3

The outcome of an individual test iteration result. The integer 0 means the test iteration was disabled, 1 means the test iteration execution was incomplete, 2 means the test iteration passed, and 3 means the test iteration failed.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: integer

Duration — Length of time the test iteration ran, in seconds

duration

Length of time the test iteration ran, in seconds, returned as a duration.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: duration

StartTime — Time the test iteration began to run

datetime

Time the test iteration began to run, returned as a datetime.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: datetime

StopTime — Time the test iteration completed

datetime

Time the test completed, returned as a datetime.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: datetime

TestFilePath — Test file path

character vector

The path of the test file used to create the test iteration result.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: char

TestCasePath — Result hierarchy path

character vector

The hierarchy path in the parent result set.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: char

TestCaseType — Type of test case

'Simulation' | 'Baseline' | 'Equivalence'

The type of test case from the three available test cases in the Test Manager: simulation, baseline, and equivalence.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: char

TestSequenceScenario — Test sequence scenario

struct

Test sequence scenario used in the test iteration, returned as a struct. The struct contains two fields, TestSequenceBlock and TestSequenceScenario. The TestSequenceBlock field is the path of the Test Sequence block containing the scenario that ran for this iteration. The TestSequenceScenario is the name of that scenario. The test sequence information is returned in a TestIterationResult object only if the test case included iterations. If iterations were not included, the TestSequenceScenario is returned in a TestCaseResults object.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: struct

RunOnTarget — Target indicator

cell array

Indicates if the simulation ran on the target or not, returned as an array of Booleans.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: logical

Parent — Parent of the result object

sltest.testmanager.TestCaseResult object

Parent of the result. The parent of a test iteration result is a test case result object.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: sltest.testmanager.TestCaseResult

ErrorMessages — Error messages

array of strings

Error messages produced by the iteration, returned as a array of strings.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: string

LogMessages — Log messages

array of strings

Log messages produced by the iteration, returned as a array of strings.

Attributes:

GetAccess	public
SetAccess	private
Dependent	true
NonCopyable	true

Data Types: string

UserData — Custom data stored with test iteration results

any data type

Custom data stored with the test iteration results, specified as any type of data. Use this field to add custom information, such as the settings used to obtain the results.

Methods

Public Methods

getBaselineRun	Get test iteration baseline dataset
getComparisonResult	Get test data comparison result
getComparisonRun	Get test iteration signal comparison results
getCoverageResults	Get coverage results
getCustomCriteriaPlots	Get plots from custom criteria
getCustomCriteriaResult	Get custom criteria results from test iteration
getOutputRuns	Get test iteration simulation output results
getSimulationPlots	Get plots from callbacks
getTestIteration	Get test iteration that produced result
getVerifyRuns	Get test iteration verify statement

Examples

Get Test Iteration Results

% Open the model for this example
openExample('sldemo_absbrake');

% Create the test file, suite, and case
tf = sltest.testmanager.TestFile...
   ('Get Test Iteration Results File');
ts = createTestSuite(tf,'Test Suite');
tc = createTestCase(ts,'baseline','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_absbrake');

% Specify iterations
vars = 32 : 0.5 : 34;

for k = 1 : length(vars)

    % Create test iteration object
    testItr = sltest.testmanager.TestIteration;

    % Set the parameter value for this iteration
    setVariable(testItr,'Name','g','Source',...
       'base workspace','Value',vars(k));

    str = sprintf('Iteration %d',k);

    % Add the iteration object to the test case
    addIteration(tc,testItr,str);
end

% Run the test and capture results
resultset = run(tf);
tfr = getTestFileResults(resultset);
tsr = getTestSuiteResults(tfr);
tcr = getTestCaseResults(tsr);
tir = getIterationResults(tcr);

% Get the test case type from first iteration
testType = tir(1).TestCaseType;

Version History

Introduced in R2016a