verifySignalsMatch

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

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

`expected` — 用作比较基线的预期值
时间序列数据 | 字符串标量 | 字符数组

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

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

`diagnostic` — 诊断信息
字符串 | 字符向量 | 函数句柄 | `matlab.automation.diagnostics.Diagnostic` 实例

当实际值和预期值是否等效的验证失败时显示的诊断信息，指定为字符串、字符数组、函数句柄或 matlab.automation.diagnostics.Diagnostic 类的实例。

示例: 'Simulation output does not match.'

名称-值参数

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

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

示例: 'AbsTol',.02

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

`AbsTol` — 绝对容差
0 (默认) | 标量

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

示例: 'AbsTol',1e-9

`RelTol` — 相对容差
0 (默认) | 标量

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

示例: 'RelTol',.002

`TimeTol` — 时间容差
0 (默认) | 标量

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

示例: 'TimeTol',.2

属性

`Access`	`public`
`Sealed`	`true`

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

示例

全部展开

验证背靠背仿真是否匹配

创建一个用于交互使用的测试用例。然后，在普通模式下仿真模型以获得预期值，并在快速加速模式下仿真以获得实际值。使用 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.')