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

assertSignalsMatch

类: sltest.TestCase
命名空间: sltest

断言两个数据集是等价的

全页展开

语法

assertSignalsMatch(testCase,actual,expected)
assertSignalsMatch(___,diagnostic)
assertSignalsMatch(___,Name,Value)

说明

assertSignalsMatch(testCase,actual,expected) 通过断言实际和预期信号数据值相等来过滤测试内容。当断言失败时，测试点或测试文件停止运行，并且该测试被标记为失败。当断言点的失败导致当前测试方法的其余部分无效，但不会阻止其他测试方法的正确执行时，此限定很有用。通常，您使用断言来检查当前测试的预条件是否被违反或装置是否设置正确。有关更多信息，请参阅 matlab.unittest.qualifications.Assertable。

示例

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

示例

assertSignalsMatch(___,Name,Value) 使用由一个或多个 Name,Value 对参量指定的附加选项来过滤测试内容。

示例

输入参数

全部展开

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

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

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

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

示例: '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

要了解方法的属性，请参阅方法属性。

示例

全部展开

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

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

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

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

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

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

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

版本历史记录

在 R2020b 中推出

另请参阅

| | | | | | | |

主题