L

Inductor

Physical Networks
Run the live example Free · no sign-up · runs in your browser

The Inductor block models an ideal linear two-terminal electrical inductor that stores energy in a magnetic field. The voltage drop between the positive terminal p and negative terminal n is proportional to the time rate of change of the current passing through the component.

The inductor introduces a continuous dynamic state variable (branch current ILI_L) into the differential-algebraic equation (DAE) network. The system evaluates current derivatives and integrates them stably using the engine's higher-order implicit integration algorithms.

Real-World Analog: Represents a copper-wound choke coil, transformer primary winding, or motor stator coil opposing rapid changes in current.

Mathematical Model

The constituent equation for the linear inductor is:

v(t)=Vp(t)−Vn(t)=L⋅diL(t)dtv(t) = V_p(t) - V_n(t) = L \cdot \frac{d i_L(t)}{dt}

Where:

  • V_p(t) is the voltage at the positive terminal p (V).
  • V_n(t) is the voltage at the negative terminal n (V).
  • L is the inductance in Henrys (H).
  • i_L(t) is the branch current flowing from p to n (A).

Inputs & Outputs

Direction ID Label Type Status
→ In p + number Required
→ In n - number Required
→ In H H number Optional
← Out q_diss Q_diss number Output

Parameters

Parameters Label Type Default Description
inductance Inductance (H) number 0.001
initial_current Initial Current (A) number 0
dcr DC Resistance (DCR) number 0 Winding DC resistance in Ohms (0 = ideal lossless)
i_sat Saturation Current (Isat) number 0 Magnetic core saturation current threshold in Amperes (0 = no saturation)

Usage Examples

RL Current Settling Transient

In examples/basic-inductor.json, a 10 V step drives an inductor (L = 5 H) through a resistor (R = 10 Ω) to Ground, demonstrating inductive energy storage and current rise towards 1.0 A with time constant τ = 0.5 s.

High-Frequency Choke

Attenuate rapid AC current fluctuations on a power line:

SupplyRail → Inductor(inductance: 10e-3) → SensitiveLoad

Remarks & Best Practices

  • Dynamic State: The branch current is integrated as an independent dynamic continuous state.
  • Initial Current: Use initial_current to simulate pre-charged inductive components or transient step responses.
  • MNA Matrix Augmentation: Inductor branch equations augment the MNA system with an auxiliary branch variable.
  • DAE Formulation: Solved with exact numerical coupling to prevent unphysical high-frequency oscillation.

Related Components

  • Capacitor: Electrostatic energy storage component
  • Resistor: Resistive damping element
  • CurrentSensor: Measure branch current in an electrical loop
  • Ground: Zero-potential reference terminal