Main Content

本页采用了机器翻译。点击此处可查看英文原文。

fatalAssertSignalsMatch

类: sltest.TestCase
命名空间: sltest

致命断言两个数据集是等效的

自 R2020b 起

说明

示例

fatalAssertSignalsMatch(testCase,actual,expected) 致命地断言实际信号数据值和预期信号数据值是等价的。当致命断言失败时,整个测试会话将停止。当测试包含太多错误以至于继续测试会话没有意义时这很有用。

示例

当实际数据值和预期数据值不等时,fatalAssertSignalsMatch(___,diagnostic) 返回诊断信息。

示例

fatalAssertSignalsMatch(___,Name,Value) 通过一个或多个 Name,Value 对参数指定的附加选项进行致命参量。

输入参数

全部展开

测试用例的实例,指定为 sltest.TestCase 对象。

要与预期值进行比较的实际值,指定为时间序列数据、字符串或字符数组。每个实际值的数据必须将数据值与时间值配对。数据必须采用仿真数据检查器支持的格式。仿真数据检查器需要将样本值与时间相关联的格式的数据。支持的格式包括 timeseriesStructure with timeDataset

示例: 'C:/matlab/data/actualData.mat'

用作比较基线的预期值。每个预期值的数据必须将数据值与时间值配对。数据必须采用仿真数据检查器支持的格式。仿真数据检查器需要将样本值与时间相关联的格式的数据。支持的格式包括 timeseriesStructure with timeDataset

示例: 'C:/matlab/data/expectedData.mat'

当实际值和预期值相等的致命断言失败时显示的诊断信息,指定为字符串、字符数组、函数句柄或 matlab.automation.diagnostics.Diagnostic 类的实例。

示例: 'Simulation output does not match.'

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来

示例: 'AbsTol',.02

除了列出的名称-值对之外,您还可以使用 Simulink.sdi.constraints.MatchesSignal 名称-值对。

绝对容差,指定为由 'AbsTol' 和容差标量值组成的逗号分隔的对。容差指定了实际值和预期值之间的差异的大小。

示例: 'AbsTol',1e-9

相对容差,指定为由 'RelTol' 和容差标量值组成的逗号分隔的对。相对容差指定了实际值和预期值之间的差异相对于预期值的大小。

示例: 'RelTol',.002

时间容差,指定为由 'TimeTol' 和容差的标量值组成的逗号分隔的对。

示例: 'TimeTol',.2

属性

Accesspublic
Sealedtrue

要了解方法的属性,请参阅方法属性

示例

全部展开

创建一个用于交互使用的测试用例。然后,在普通模式下仿真模型以获得预期值,并在快速加速模式下仿真以获得实际值。使用 fatalAssertSignalsMatch 来比较值。

testCase =...
   sltest.TestCase.forInteractiveUse;
 
expected = testCase.simulate('myModel',...
   'SimulationMode','Normal');
actual = testCase.simulate('myModel',...
   'SimulationMode','Rapid-Accelerator');
 
testCase.fatalAssertSignalsMatch(actual,expected)

创建一个用于交互使用的测试用例。在快速加速器模式下仿真模型以获得实际值。使用 fatalAssertSignalsMatch 将实际值与 MAT 文件中保存的基线值进行比较。设定相对容差。

testCase =...
   sltest.TestCase.forInteractiveUse;
 
actual = testCase.simulate('myModel',...
   'SimulationMode','Rapid-Accelerator');

testCase.fatalAssertSignalsMatch(actual,'baseline.mat',...
   'RelTol',0.001)
 

创建一个用于交互使用的测试用例。然后,在快速加速器模式下仿真模型以获得实际值。使用 fatalAssertSignalsMatch 将实际值与 MAT 文件中保存的基线值进行比较。指定断言失败时显示的诊断消息。

testCase =...
   sltest.TestCase.forInteractiveUse;
 
actual = testCase.simulate('myModel',...
   'SimulationMode','Rapid-Accelerator');
 
testCase.fatalAssertSignalsMatch(actual,'baseline.mat',...
   'Rapid-Accel output did not match.')
 

版本历史记录

在 R2020b 中推出