Use Best Practices While Modeling and Simulating Faults
During model compilation and simulation, some fault modeling practices can cause errors in models that otherwise run without issue. Additionally, changing the properties of the signals can cause simulation errors if the signal has faults. Resolve some of these common issues by deploying these best practices.
Save Faults and Conditionals
When you create the first fault, fault model, or conditional associated with a model, Simulink® Fault Analyzer™ automatically saves the information to the fault information file. If you update properties or create additional faults, fault behaviors, or conditionals, you must save the model to save the fault information. If you attempt to close the model without saving after making changes to these artifacts, Simulink displays a dialog box that allows you to save the fault model and fault information file before closing.
Add Faults to Buses
You cannot simulate faults on virtual buses. For more information on virtual blocks, see Nonvirtual and Virtual Blocks. However, you can add and simulate faults on nonvirtual buses.
For example, this model uses a Bus Creator block that outputs a virtual bus.
Adding faults to either of the virtual buses causes an error during model compilation.
By contrast, this model has a fault on a nonvirtual bus. For more information on creating nonvirtual buses, see Create Nonvirtual Buses. You can simulate this model.
Avoid changing nonvirtual signals to virtual signals when modeling with faults. If you add faults to a nonvirtual bus and change the faulted signal to virtual, the model generates an error during compilation.
Faults added to buses affect each bus element. To fault individual signals, use a Bus Selector block to split the signal from the Fault Inport block, apply behaviors to the bus elements, and then recombine them with a Bus Creator block. For example, this fault behavior applies offsets to each bus element before recombining them.
To ensure the output signal and input signal are compatible, assign the signal created by the Bus Creator block to the same bus sent to the fault.
If you do not apply faults to the individual bus elements, the blocks that you use in
the fault behavior must support buses. See Bus-Capable Blocks. In this situation, you can only use the stuck-at-ground fault behavior in the
default fault library,
mwfaultlib. For more information on creating
custom behaviors, see Create Predefined and Custom Fault Behaviors.
If you use an incompatible signal data type or an alias of an incompatible data type, a simulation error occurs.
Limitations on Fault Injection
To avoid possible simulation errors, follow these guidelines when simulating models that contain faults:
You can only use fast restart for models that have faults on Simscape™ blocks.
You can only use accelerator or rapid accelerator mode in models that have faults on Simscape blocks.
Virtual blocks support faults only on their input and output ports.
Atomic subsystems support faults only on their ports that correspond to Inport and Outport blocks.
You cannot add faults to duplicate Inport blocks.
If you add a fault to a continuous signal, the signal must enter a block with a discrete sample time. For more information on sample time, see What Is Sample Time?
You cannot simulate faults on variable-size signals.
You cannot simulate faults on signals with constant sample times.
You cannot simulate faults on signals at the top level of export-function models or models that execute concurrently. However, you can simulate faults on signals in referenced models or atomic subsystems in these models.
The blocks that you use in Fault Subsystem blocks must have inherited or constant sample times.