Skip to content

Breaker ​

Single-phase circuit breaker. Acts as a small R_on resistance when closed and a very large R_off resistance when open. The open/close command comes from a wired control input, a named signal (0 = open, > 0 = close), or a built-in time schedule that toggles the breaker open↔closed at each time in a list (starting from a chosen initial state — no wiring needed). When commanded to open, the breaker holds closed until the through-current can be interrupted — its magnitude falls to the Interrupt-current threshold, or the current crosses zero — modelling current-zero clearing (set the threshold large to open instantly under load, 0 to wait for a natural AC zero); this clearing logic applies to a time-triggered open as well. Optional per-branch current and open/closed-state observables. No arc model.

Category: Single-Phase / Switching

Ports ​

PortKindSignalNotes
N1Electrical terminal—
N2Electrical terminal—
ctrlControl inputIntegerShown when Trigger source is Control input

Parameters ​

Config ​

ParameterTypeDefaultUnitsDescriptionID
R_onNumber0.001Ω (also kΩ, MΩ)Closed-state resistance. Pick a unit from the dropdown.resistance_on
R_offNumber1000000000Ω (also kΩ, MΩ)Open-state resistance. Pick a unit from the dropdown.resistance_off
Trigger sourceChoice: Control input / Named signal / Time triggeredControl input—Where the open/close command comes from. `Control input`: a wired `ctrl` port (hidden for the other sources). `Named signal`: a portless signal resolved by name (GoTo / labelled wire / another component's observable), read 1-step delayed. `Time triggered`: a built-in schedule toggles the breaker open↔closed at each time on the Trigger time(s) list, starting from the Initial state (no wiring needed). For Control input / Named signal the command is an integer signal: 0 = open, any value > 0 = close (wire a flag block such as Relational Double or Relational Int, or convert a double with Double → Int).trigger_source
Trigger signal nameText(empty)—Name of the published signal that commands the breaker when Trigger source is `Named signal` (0 = open, > 0 = close). Resolved through the shared signal names and read 1-step delayed. Blank reads 0 (breaker stays open).trigger_signal_name
Trigger time(s)Text(empty)—Comma-separated trigger times in seconds, e.g. `2` or `2,4,6`. The breaker toggles state (open↔closed) at each time, starting from the Initial state. Blank = never toggles (stays at the Initial state for the whole run). A time-triggered open still respects the Interrupt current threshold below (instant by default).trigger_times
Initial stateChoice: Open / ClosedClosed—Breaker state at t = 0 (the state before the first trigger time), and the symbol drawn on the canvas (Closed = arm bridges the contacts; Open = arm lifted). Time-triggered mode only.initial_state
Interrupt currentNumber1000000000A (also kA)Largest through-current the breaker can interrupt the instant it is commanded open. While opening, the breaker stays closed until |I| falls to this value OR the current crosses zero, then opens. Default is very large, so it opens immediately under any load (an abrupt chop; the inductive L·di/dt shows up as a voltage spike). Set 0 to wait for a natural current zero (ideal AC interruption); a small value models a vacuum breaker's chopping current. Note: with 0 on a DC current (no zero crossing) the breaker stays closed.interrupt_current
Measure currentChoice: Off / OnOff—Emit the branch current (A) flowing N1 → N2 as a simulator observable.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 N1 terminal, toward N2. '+ve out' flips the sign.current_dir
Measure stateChoice: Off / OnOff—Emit the breaker's actual pole state as a simulator observable (1 = closed, 0 = open). Useful because the state lags the command while the breaker waits to interrupt.measure_state

Signal Names ​

ParameterTypeDefaultUnitsDescriptionID
Current nameTextI—Signal name for the measured branch current. Change the default `I` when you have multiple measured components — duplicate ids collide.current_name
State nameTextBRK—Signal name for the breaker state (1 = closed, 0 = open). Change the default `BRK` when you have multiple measured breakers.state_name

Observables ​

Default nameKindRecorded whenDescriptionID
set by Current nameSignalMeasure current is onBranch current through the breaker, N1 → N2 (A). Positive into the N1 terminal, toward N2 for '+ve in' (default); the other direction flips the sign.branchCurrent
set by State nameSignalMeasure state is onBreaker pole state (1 = closed, 0 = open).breakerState

Used in samples ​