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.
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
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)