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

verifySignalsMatch

类: sltest.TestCase
命名空间: sltest

验证两组数据是否等效

全页展开

语法

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

说明

verifySignalsMatch(testCase,actual,expected) 验证实际和预期信号数据值是否等效。当验证失败时，将记录失败并让测试运行直至完成。有关更多信息，请参阅 matlab.unittest.qualifications.Verifiable。

示例

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

示例

verifySignalsMatch(___,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

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

示例

全部展开

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

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

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

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

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

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

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

版本历史记录

在 R2020b 中推出

另请参阅

| | | | | | | |

主题