Skip to content

Fault (1-phase) ​

Single-phase fault block. Inserts a configurable fault resistance between two electrical nodes for a timed window or under external trigger control. Use for short-circuit and ground-fault studies.

Category: Single-Phase / Sources

Ports ​

PortKindSignalNotes
N1Electrical terminal—
N2Electrical terminal—
enableControl inputIntegerShown when Trigger mode is Control input

Parameters ​

Config ​

ParameterTypeDefaultUnitsDescriptionID
R faultNumber0.01—Fault path resistance between N1 and N2 when active (Ω). Typical: 0.001 - 0.1 (bolted), 1 - 50 (arcing).fault_resistance
Trigger modeChoice: Timed window / Control inputTimed window—`timed` = active in [t_trigger, t_clear]. `control` = follows the integer `enable` input (≠0 = active; drive it from a flag block such as Relational Double or Relational Int, or through a Double → Int converter). After deactivation, branch waits for |i| < `i_threshold` before opening (current-zero clearing).trigger_mode
t trigger (s)Number0.05—Fault activation time (s) for `timed` mode.t_trigger
t clear (s)Number0.15—Clear-command time (s) for `timed` mode. Branch then waits for |i| < `i_threshold` before opening (avoids di/dt spike under load).t_clear
I clear threshold (A)Number1—|i| below which the branch may open after deactivation. Larger = clears earlier; smaller = waits closer to natural zero. 0 = true current-zero clearing (may delay up to one cycle).i_threshold
Measure fault currentChoice: Off / OnOff—Emit the fault current (A) flowing from N1 into the fault.measure_current
Positive directionChoice: +ve in / +ve out+ve in—Sign convention for this current. '+ve in' (default) is positive when current flows into the fault from N1. '+ve out' flips the sign.current_dir

Current Monitoring ​

ParameterTypeDefaultUnitsDescriptionID
Fault current nameTextIf—current_name

Observables ​

Default nameKindRecorded whenDescriptionID
set by Fault current nameSignalMeasure fault current is onFault current flowing from N1 into the fault (A). Positive into the fault from N1 for '+ve in' (default); the other direction flips the sign.i_fault