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

example

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.

Examples

collapse all

Open the fault_analyzer_intro model.

openExample('faultanalyzer/FaultAnalyzerIntroExample')

Add two faults to the output port of the Sine Wave block and one fault to the output port of the Constant block.

Simulink.fault.addFault("fault_analyzer_intro/Sine Wave/Outport/1"...
,Name="myFault1");
Simulink.fault.addFault("fault_analyzer_intro/Sine Wave/Outport/1"...
,Name="myFault2");
Simulink.fault.addFault("fault_analyzer_intro/Constant/Outport/1"...
,Name="myFault3");

Retrieve the path of the model elements that have faults.

paths = Simulink.fault.findFaultedElements(...
"fault_analyzer_intro");

Open the fault_analyzer_intro model.

openExample('faultanalyzer/FaultAnalyzerIntroExample')

Add two faults to the output port of the Sine Wave block and one fault to the output port of the Constant block.

Simulink.fault.addFault(...
"fault_analyzer_intro/Sine Wave/Outport/1",Name="myFault1");
Simulink.fault.addFault(...
"fault_analyzer_intro/Sine Wave/Outport/1",Name="myFault2");
Simulink.fault.addFault(...
"fault_analyzer_intro/Constant/Outport/1",Name="myFault3");

Enable a fault.

Simulink.fault.enable("fault_analyzer_intro/Sine Wave/Outport/1",true)

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

paths = Simulink.fault.findFaultedElements(...
"fault_analyzer_intro",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

|