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

Keywords: 1-phase, 1-ph, 1 ph, 1ph, single, single-phase, single phase, phase, ph, short, short circuit, SC, ground fault

Ports

Name	Direction	Value type	Notes
N1	electrical	double
N2	electrical	double
enable	input	double	Visible when trigger_mode == 'control'

Parameters

Config

Name	Label	Type	Default	Units	Description
fault_resistance	R fault	double	0.01	—	Fault path resistance between N1 and N2 when active (Ω). Typical: 0.001 - 0.1 (bolted), 1 - 50 (arcing).
trigger_mode	Trigger mode	enum (Timed window / Control input)	timed	—	`timed` = active in [t_trigger, t_clear]. `control` = follows `enable` input (≠0 = active). After deactivation, branch waits for |i| < `i_threshold` before opening (current-zero clearing).
t_trigger	t trigger (s)	double	0.05	—	Fault activation time (s) for `timed` mode.
t_clear	t clear (s)	double	0.15	—	Clear-command time (s) for `timed` mode. Branch then waits for |i| < `i_threshold` before opening (avoids di/dt spike under load).
i_threshold	I clear threshold (A)	double	1	—	|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).
measure_current	Measure fault current	enum (Off / On)	0	—	Emit the fault current (A) flowing from N1 into the fault.

Current Monitoring

Name	Label	Type	Default	Units	Description
current_name	Fault current name	string	If	—

Observables

Signal	Type	Default name	Enable	Description
i_fault	signal	from current_name	measure_current	Fault current flowing from N1 into the fault (A).

---

Implemented in C++ class SimCompElecFault (components/electrical/sim_comp_elec_fault/sim_comp_elec_fault.h).