Main Content

Simulink.fault.findFaultedElements

Retrieve paths of model elements that have faults

Since R2023b

collapse all in page

Syntax

elements = Simulink.fault.findFaultedElements(model)
elements = Simulink.fault.findFaultedElements(model,Enabled=status)

Description

elements = Simulink.fault.findFaultedElements(model) returns the model elements that have faults in the model, model.

example

elements = Simulink.fault.findFaultedElements(model,Enabled=status) returns the model elements that are or are not enabled, filtered by status.

example

Examples

collapse all

Open a model with a block that supports fault modeling.

openExample('simscape_shared/SimpleMotorArmatureWindingFaultExample')

Add two faults to the DC Motor block.

Simulink.fault.addFault(...
"SimpleMotorArmatureWindingFault/DC Motor/Armature winding"...
,Name="myFault1");
Simulink.fault.addFault(...
"SimpleMotorArmatureWindingFault/DC Motor/Armature winding"...
,Name="myFault2");

Retrieve the path of the model elements that have faults.

paths = Simulink.fault.findFaultedElements(...
"SimpleMotorArmatureWindingFault")

Open a model with a block that supports fault modeling.

openExample('simscape_shared/SimpleMotorArmatureWindingFaultExample')

Add two faults to the DC Motor block.

myFault1 = Simulink.fault.addFault(...
"SimpleMotorArmatureWindingFault/DC Motor/Armature winding"...
,Name="myFault1");
myFault2 = Simulink.fault.addFault(...
"SimpleMotorArmatureWindingFault/DC Motor/Armature winding"...
,Name="myFault2");

Assign noise behavior both faults and store the behavior in a fault model named myBehaviorModel.

addBehavior(myFault1,"myBehaviorModel",...
FaultBehavior="Add Noise")
addBehavior(myFault2,"myBehaviorModel",...
FaultBehavior="Add Noise")

Enable a fault.

Simulink.fault.enable(...
"SimpleMotorArmatureWindingFault/DC Motor/Armature winding",true)

Retrieve the paths of the model elements that have faults that are enabled for fault simulation.

paths = Simulink.fault.findFaultedElements(...
"SimpleMotorArmatureWindingFault",Enabled=true);

Input Arguments

collapse all

Path or handle to the model, specified as a string scalar, character vector, or model handle.

Data Types: string | char | double

Whether the model elements are enabled, specified as a numeric or logical 1 (true) or 0 (false).

Data Types: logical

Output Arguments

collapse all

Paths of the model elements, returned as a string array.

Version History

Introduced in R2023b

See Also

|