Skip to content

Fault (3-phase) ​

Three-phase fault block. Applies a configurable fault (single-line-to-ground, line-to-line, double-line-to-ground, three-phase, or three-phase-to-ground) with a chosen fault resistance, on a timed window or under external trigger control.

Category: Three-Phase / Sources

Ports ​

PortKindSignalNotes
busThree-phase terminal—
enableControl inputIntegerShown when Trigger mode is Control input

Parameters ​

ParameterTypeDefaultUnitsDescriptionID
Fault typeChoice: A-G (1φ to gnd) / B-G (1φ to gnd) / C-G (1φ to gnd) / A-B (φ-φ) / B-C (φ-φ) / C-A (φ-φ) / AB-G (2φ to gnd) / BC-G (2φ to gnd) / CA-G (2φ to gnd) / ABC (3φ sym) / ABC-G (3φ to gnd)A-G (1φ to gnd)—Fault topology at the bus port. AG/BG/CG = single line-to-ground. AB/BC/CA = phase-to-phase. ABG/BCG/CAG = double line-to-ground. ABC = three-phase symmetrical (ungrounded). ABCG = three-phase-to-ground. Ground topologies use the internal simulator ground (no external port).fault_type
R faultNumber0.01—Fault path resistance (Ω). Typical: 0.001 - 0.1 (bolted), 1 - 50 (arcing).fault_resistance
Trigger modeChoice: Timed window / Control inputTimed window—`timed` = active for `fault_duration` starting at `t_trigger` (window [t_trigger, t_trigger + fault_duration]). `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, each phase waits for |i| < `i_threshold` before opening (current-zero clearing).trigger_mode
t trigger (s)Number0.05—Fault activation time (s) for `timed` mode. The fault then stays applied for `fault_duration`.t_trigger
Fault durationNumber100ms (also s)How long the fault stays applied in `timed` mode. The fault activates at `t trigger` and clears `fault_duration` later (window [t_trigger, t_trigger + fault_duration]). Pick ms or s from the dropdown. After the clear command, each phase waits independently for |i| < `i_threshold` before opening (avoids the di/dt spike).fault_duration
I clear threshold (A)Number0—|i| below which a phase may open after deactivation. Larger = clears earlier; smaller = waits closer to natural zero. Phases clear independently. 0 = true current-zero (may delay up to one cycle).i_threshold
Measure fault currentsChoice: Off / OnOff—Emit per-phase fault currents (A) flowing from bus into the fault. Names per phase.measure_currents
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 the bus, on every phase. '+ve out' flips the sign.current_dir
Fault current name ATextIfaA (also kA)Signal name for the Phase A fault current. Blank = skip. Pick the unit from the dropdown; the published value is scaled to it.i_fault_name_a
Fault current name BTextIfbA (also kA)Signal name for the Phase B fault current. Blank = skip. Pick the unit from the dropdown; the published value is scaled to it.i_fault_name_b
Fault current name CTextIfcA (also kA)Signal name for the Phase C fault current. Blank = skip. Pick the unit from the dropdown; the published value is scaled to it.i_fault_name_c

Observables ​

Default nameKindRecorded whenDescriptionID
set by Fault current name ASignalMeasure fault currents is onPhase A fault current flowing from bus into fault, scaled to the chosen current unit (A / kA). Positive into the fault from the bus, on every phase for '+ve in' (default); the other direction flips the sign.i_fault_a
set by Fault current name BSignalMeasure fault currents is onPhase B fault current, scaled to the chosen current unit (A / kA). Positive into the fault from the bus, on every phase for '+ve in' (default); the other direction flips the sign.i_fault_b
set by Fault current name CSignalMeasure fault currents is onPhase C fault current, scaled to the chosen current unit (A / kA). Positive into the fault from the bus, on every phase for '+ve in' (default); the other direction flips the sign.i_fault_c

Used in samples ​