sltest.testmanager.TestIterationResult 类
命名空间: sltest.testmanager
访问测试迭代结果数据
描述
sltest.testmanager.TestIterationResult
的实例使您能够访问测试管理器在测试迭代级别执行的测试执行的结果。测试结果的层次为结果集 > 测试文件结果 > 测试套件结果 > 测试用例结果 > 测试迭代结果。
sltest.testmanager.TestIterationResult
类是 handle
类。
创建对象
描述
函数 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
方法来获取使用触发器控制何时记录信号的测试结果。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
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)