sltest.testmanager.SpecifiedFault 类

命名空间: sltest.testmanager

创建或修改测试中添加到故障集的故障

自 R2024a 起

全页展开

描述

sltest.testmanager.SpecifiedFault 类的对象是添加到测试用例的故障集中的故障。您必须具有 Simulink^® Fault Analyzer™ 才能使用此类。

sltest.testmanager.SpecifiedFault 类是 handle 类。

类属性

HandleCompatible true

有关类属性的信息，请参阅类属性。

创建对象

要创建 sltest.testmanager.SpecifiedFault 对象：

使用 addSpecifiedFault 方法。
在测试用例中交互地创建故障集，然后使用 getSpecifiedFaults 函数获取关联的 sltest.testmanager.SpecifiedFault 对象。

属性

全部展开

`FaultName` — 故障名称
字符串标量 | 字符向量

故障名称，指定为字符串标量或字符向量。您可以将此故障的名称更改为同一模型元素上的另一个故障。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: string | char

`IsActive` — 是否可以注入故障
`true` 或 `1` (默认) | `false` 或 `0`

是否可以在测试仿真期间注入故障，指定为数字或逻辑 1 (true) 或 0 (false)。每个模型元素上只能激活一个故障。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: logical

`ModelElement` — 模型元素路径
字符向量

模型元素的路径，以字符向量形式返回。在 Simulink 模型中，此参量是模块输出或输入端口的路径。在 Simscape™ 模块中，此参量是指向具有故障能力的模型子元素的路径。在 System Composer™ 模型中，此参量是组件输出或输入端口的路径。

属性：

`GetAccess`	`public`
`SetAccess`	`受保护`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: char

`Trigger` — 故障触发类型和值
字符向量

故障触发类型和值，以字符向量形式返回。故障可能由以下因素引发：

扳機類型	描述
始终打开	故障在仿真开始时注入。
计时	当仿真达到指定的仿真时间时注入故障。该值是一个实标量。
条件	当指定的条件为 true 时，就会注入故障。请参阅Create and Manage Conditionals (Simulink Fault Analyzer)。
手动	您可以在故障仪表板窗格中控制注入状态。请参阅Manually Trigger Faults in Models (Simulink Fault Analyzer)。Simulink 测试管理器使用模型中分配的状态，并且您无法在运行测试时更改它。
行为	故障是由于仿真过程中的故障参数值而注入的。您仅可以为 Simscape 模块上的故障指定此触发类型。

该属性显示触发器类型，后跟冒号、空格和触发器值。

有关更多信息，请参阅Trigger type (Simulink Fault Analyzer)。

示例: 'Timed: 5' 表示该故障的定时触发时间为五秒。

属性：

`GetAccess`	`public`
`SetAccess`	`受保护`
`Dependent`	`true`
`NonCopyable`	`true`

数据类型: char

方法

全部展开

公共方法

remove 从故障集中移除故障

示例

全部折叠

将故障添加到测试用例中的新故障集中

假设您有一个名为 myTestFile 的测试文件，其中包含一个测试用例。测试使用 myModel 作为被测模型，该模型在 Sine Wave 模块的输出端口上包含一个名为 myFault 的故障。创建测试用例和故障集，并将故障添加到故障集中。

tf = sltest.testmanager.TestFile("myTestFile.mldatx");
ts = sltest.testmanager.TestSuite(tf,"myTestSuite");
tc = sltest.testmanager.TestCase(ts,"simulation","myTestCase");
faultSet = addFaultSet(tc);
sltest.testmanager.refreshFaults("myModel")
testFault = addSpecifiedFault(faultSet,...
  "myModel/Sine Wave/Outport/1","myFault")

版本历史记录

在 R2024a 中推出

另请参阅

sltest.testmanager.TestCase | sltest.testmanager.FaultSet | Fault (Simulink Fault Analyzer)