sltest.testmanager.TestIterationResult 类

命名空间: sltest.testmanager

访问测试迭代结果数据

描述

sltest.testmanager.TestIterationResult 的实例使您能够访问测试管理器在测试迭代级别执行的测试执行的结果。测试结果的层次为结果集 > 测试文件结果 > 测试套件结果 > 测试用例结果 > 测试迭代结果。

sltest.testmanager.TestIterationResult 类是 handle 类。

类属性

HandleCompatible true

有关类属性的信息，请参阅类属性。

创建对象

描述

函数 sltest.testmanager.run 创建一个 sltest.testmanager.ResultSet 对象，其中包含测试用例结果对象。例如，请参阅获取测试迭代结果

属性

全部展开

`Outcome` — 测试迭代结果
0 | 1 | 2 | 3

单个测试迭代结果的结果。整数 0 表示测试迭代被禁用，1 表示测试迭代执行未完成，2 表示测试迭代通过，3 表示测试迭代失败。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: integer

`Name` — 测试迭代名称
字符串

测试迭代名称，以字符串形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TestDataPath` — 输入数据文件路径
字符串

输入数据文件的路径，以字符串形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TestFilePath` — 测试文件路径
字符向量

用于创建测试迭代结果的测试文件的路径，以字符向量形式返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: char

`TestCasePath` — 结果层次路径
字符向量

父结果集中的层次结构路径。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: char

`TestCaseType` — 测试用例类型
`'Simulation'` | `'Baseline'` | `'Equivalence'`

测试用例的类型来自测试管理器中的三个可用测试用例：仿真、基线和等效性。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: char

`RunOnTarget` — 目标指标
元胞数组

指示仿真是否在目标上运行，以布尔数组的数组返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: logical

`StartTime` — 测试迭代开始运行的时间
约会时间

测试迭代开始运行的时间，以日期时间形式返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: datetime

`StopTime` — 测试迭代完成的时间
约会时间

测试完成的时间，以日期时间形式返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: datetime

`Duration` — 测试迭代运行的时间长度（以秒为单位）
持续时间

测试迭代运行的时间长度（以秒为单位），以持续时间形式返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: duration

`Requirements` — 测试迭代需求
字符串数组

与测试迭代相关的需求，以字符串数组的形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`ErrorMessages` — 错误消息
字符串数组

迭代产生的错误消息，以字符串数组的形式返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: string

`LogMessages` — 日志消息
字符串数组

记录迭代产生的消息，以字符串数组的形式返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: string

`CauseOfFailure` — 测试迭代失败的原因
字符串数组

测试迭代失败的原因，以字符串数组的形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`DisablingReason` — 已禁用描述
字符串

禁用测试迭代的原因的描述文本，以字符串形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`Baseline` — 基线文件的名称
字符串

测试迭代中使用的基线文件的名称，以字符串形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`ExternalInput` — 外部输入文件的名称
字符串

外部输入文件的名称，以字符串形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`ParameterSet` — 测试迭代参数
`ParameterSet` 对象

测试可以覆盖模型参数的迭代参数，以包含 sltest.testmanager.ParameterSet 对象的名称、对象路径以及列出参数覆盖的结构体的结构返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`FaultSet` — 故障设置信息
结构体

故障集信息，以结构体返回。该结构体有两个字段：

FaultSetNames - 故障集的名称，以字符向量形式返回。
SpecifiedFaults - 故障集中启用的故障，以结构体返回。每个字段都是一个包含三个字段的结构体：
- ModelElement - 故障的模型元素路径，以字符向量形式返回。
- FaultName - 故障名称，以字符向量形式返回。
- Trigger - 故障触发类型，以字符向量形式返回。
有关这些故障属性的更多信息，请参阅 Specify Fault Properties (Simulink Fault Analyzer)。

如果您没有 Simulink^® Fault Analyzer™，则此属性为空。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`SignalEditorScenario` — 信号编辑器场景名称
字符串

测试迭代中使用的信号编辑器场景的名称，以字符串形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TestSequenceScenario` — 测试序列场景
结构体

测试迭代中使用的测试序列场景，以结构体形式返回。该结构包含两个字段，TestSequenceBlock 和 TestSequenceScenario。TestSequenceBlock 字段是包含本次迭代运行的场景的 Test Sequence 模块的路径。TestSequenceScenario 是该场景的名称。仅当测试用例包含迭代时，测试序列信息才会在 TestIterationResult 对象中返回。如果未包括迭代，则 TestSequenceScenario 将在 TestCaseResults 对象中返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: struct

`VariantConfiguration` — 测试迭代中使用的变体配置
字符串 | 字符向量

自 R2024a 起

在运行测试迭代之前应用于模型的变体配置，指定为字符串或字符向量。

此属性适用于使用 Simulink 的变体管理器创建的变体配置的模型，并且使用 setTestParam 方法在测试迭代对象上指定了 VariantConfiguration 测试参数。

有关示例，请参阅。

示例: "LinInterExpNoNoise"

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: char | string

`SimulationMetaData` — 仿真的元数据
`SimulationMetadata` 对象

仿真的元数据，以 Simulink.SimulationMetadata 对象的形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`Release` — 运行测试的版本
字符向量

运行测试的版本，以字符向量形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`Description` — 测试迭代描述
字符向量

测试迭代的描述，以字符向量形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`CoverageResults` — 测试覆盖率结果
字符数组

测试覆盖率结果，以字符数组形式返回。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`Tags` — 用于过滤测试文件结果的标签
字符串数组

用于过滤测试文件结果的标签。使用标签查看测试结果的子集。查看标签以了解更多信息。

属性：

`SetAccess`	`private`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`Parent` — 结果对象的父对象
`sltest.testmanager.TestCaseResult` 对象

测试迭代结果的父级，作为 TestCaseResult 对象返回。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: sltest.testmanager.TestCaseResult

`UserData` — 与测试迭代结果一起存储的自定义数据
任何数据类型

与测试迭代结果一起存储的自定义数据，指定为任何类型的数据。使用此字段添加自定义信息，例如用于获取结果的设置。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

方法

全部展开

公共方法

对于 getInputRuns，请参阅 sltest.testmanager.testcaseresult getInputRuns 方法。

`getAssessmentResults`	获取测试迭代结果的逻辑与时序评估结果
`getBaselineRun`	获取测试迭代基线数据集
`getComparisonResult`	获取测试数据比对结果
`getComparisonRun`	获取测试迭代信号对比结果
`getCoverageResults`	获取覆盖率结果
`getCustomCriteriaPlots`	根据自定义准则获取图
`getCustomCriteriaResult`	从测试迭代中获取自定义准则结果
`getOutputRuns`	获取测试迭代仿真输出结果
`getOutputTriggerResults`	为测试迭代创建输出触发器结果对象
`getSimulationPlots`	从回调中获取图
`getTestIteration`	获取产生结果的测试迭代
`getVerifyRuns`	获取测试迭代验证语句
`getTimingInfo`	测试迭代结果的计时执行信息

示例

全部折叠

获取测试迭代结果

打开实时脚本

打开此示例的模型。

sldemo_absbrake

创建测试文件，删除默认测试套件，并添加新的测试套件和测试用例。

tf = sltest.testmanager.TestFile('Get Test Iteration Results File');
tsDel = tf.getTestSuites;
remove(tsDel);
ts = createTestSuite(tf,'Test Suite');
tc = createTestCase(ts,'baseline','Test Case');

将在测系统分配给测试用例。

setProperty(tc,'Model','sldemo_absbrake');

指定每次迭代的参数值。然后运行一个 for 循环，为每次迭代创建一个测试迭代对象，设置参数值，并将迭代对象添加到测试用例结构体中。

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

运行测试并捕获结果。

resultset = run(tf);
tfr = getTestFileResults(resultset);
tsr = getTestSuiteResults(tfr);
tcr = getTestCaseResults(tsr);
tir = getIterationResults(tcr);

从第一次迭代中获取测试用例类型。

testType = tir(1).TestCaseType;

清理测试管理器。

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

版本历史记录

在 R2016a 中推出

全部展开

R2024a: 获取故障集结果的新属性

访问 FaultSet 属性以获取测试的激活故障集的属性。如果您没有 Simulink Fault Analyzer，则此属性为空。

R2024a: 变体配置的新属性

对于变体模型，VariantConfiguration 属性包含测试迭代对象中使用的变体配置的名称。

R2023a: 获取触发结果的新方法

使用新的 getOutputTriggerResults 方法来获取使用触发器控制何时记录信号的测试结果。

另请参阅

sltest.testmanager.TestIteration

sltest.testmanager.TestIterationResult 类

描述

类属性

创建对象

描述

属性

Outcome — 测试迭代结果 0 | 1 | 2 | 3

属性：

Name — 测试迭代名称 字符串

属性：

TestDataPath — 输入数据文件路径 字符串

属性：

TestFilePath — 测试文件路径 字符向量

属性：

TestCasePath — 结果层次路径 字符向量

属性：

TestCaseType — 测试用例类型 'Simulation' | 'Baseline' | 'Equivalence'

属性：

RunOnTarget — 目标指标 元胞数组

属性：

StartTime — 测试迭代开始运行的时间 约会时间

属性：

StopTime — 测试迭代完成的时间 约会时间

属性：

Duration — 测试迭代运行的时间长度（以秒为单位） 持续时间

属性：

Requirements — 测试迭代需求 字符串数组

属性：

ErrorMessages — 错误消息 字符串数组

属性：

LogMessages — 日志消息 字符串数组

属性：

CauseOfFailure — 测试迭代失败的原因 字符串数组

属性：

DisablingReason — 已禁用描述 字符串

属性：

Baseline — 基线文件的名称 字符串

属性：

ExternalInput — 外部输入文件的名称 字符串

属性：

ParameterSet — 测试迭代参数 ParameterSet 对象

属性：

FaultSet — 故障设置信息 结构体

属性：

SignalEditorScenario — 信号编辑器场景名称 字符串

属性：

TestSequenceScenario — 测试序列场景 结构体

属性：

VariantConfiguration — 测试迭代中使用的变体配置 字符串 | 字符向量

属性：

SimulationMetaData — 仿真的元数据 SimulationMetadata 对象

属性：

Release — 运行测试的版本 字符向量

属性：

Description — 测试迭代描述 字符向量

属性：

CoverageResults — 测试覆盖率结果 字符数组

属性：

Tags — 用于过滤测试文件结果的标签 字符串数组

属性：

Parent — 结果对象的父对象 sltest.testmanager.TestCaseResult 对象

属性：

UserData — 与测试迭代结果一起存储的自定义数据 任何数据类型

属性：

方法

公共方法

示例

获取测试迭代结果

版本历史记录

R2024a: 获取故障集结果的新属性

R2024a: 变体配置的新属性

R2023a: 获取触发结果的新方法

另请参阅

主题

`Outcome` — 测试迭代结果
0 | 1 | 2 | 3

`Name` — 测试迭代名称
字符串

`TestDataPath` — 输入数据文件路径
字符串

`TestFilePath` — 测试文件路径
字符向量

`TestCasePath` — 结果层次路径
字符向量

`TestCaseType` — 测试用例类型
`'Simulation'` | `'Baseline'` | `'Equivalence'`

`RunOnTarget` — 目标指标
元胞数组

`StartTime` — 测试迭代开始运行的时间
约会时间

`StopTime` — 测试迭代完成的时间
约会时间

`Duration` — 测试迭代运行的时间长度（以秒为单位）
持续时间

`Requirements` — 测试迭代需求
字符串数组

`ErrorMessages` — 错误消息
字符串数组

`LogMessages` — 日志消息
字符串数组

`CauseOfFailure` — 测试迭代失败的原因
字符串数组

`DisablingReason` — 已禁用描述
字符串

`Baseline` — 基线文件的名称
字符串

`ExternalInput` — 外部输入文件的名称
字符串

`ParameterSet` — 测试迭代参数
`ParameterSet` 对象

`FaultSet` — 故障设置信息
结构体

`SignalEditorScenario` — 信号编辑器场景名称
字符串

`TestSequenceScenario` — 测试序列场景
结构体

`VariantConfiguration` — 测试迭代中使用的变体配置
字符串 | 字符向量

`SimulationMetaData` — 仿真的元数据
`SimulationMetadata` 对象

`Release` — 运行测试的版本
字符向量

`Description` — 测试迭代描述
字符向量

`CoverageResults` — 测试覆盖率结果
字符数组

`Tags` — 用于过滤测试文件结果的标签
字符串数组

`Parent` — 结果对象的父对象
`sltest.testmanager.TestCaseResult` 对象

`UserData` — 与测试迭代结果一起存储的自定义数据
任何数据类型