Appearance
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
| Port | Kind | Signal | Notes |
|---|---|---|---|
bus | Three-phase terminal | — | |
enable | Control input | Integer | Shown when Trigger mode is Control input |
Parameters
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Fault type | Choice: 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 fault | Number | 0.01 | — | Fault path resistance (Ω). Typical: 0.001 - 0.1 (bolted), 1 - 50 (arcing). | fault_resistance |
| Trigger mode | Choice: Timed window / Control input | Timed 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) | Number | 0.05 | — | Fault activation time (s) for `timed` mode. The fault then stays applied for `fault_duration`. | t_trigger |
| Fault duration | Number | 100 | ms (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) | Number | 0 | — | |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 currents | Choice: Off / On | Off | — | Emit per-phase fault currents (A) flowing from bus into the fault. Names per phase. | measure_currents |
| Positive direction | Choice: +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 A | Text | Ifa | A (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 B | Text | Ifb | A (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 C | Text | Ifc | A (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 name | Kind | Recorded when | Description | ID |
|---|---|---|---|---|
| set by Fault current name A | Signal | Measure fault currents is on | Phase 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 B | Signal | Measure fault currents is on | Phase 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 C | Signal | Measure fault currents is on | Phase 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 |