RLC Analyzer

Analytical Reference & Energy Visualization Lab

A deterministic, closed-form RL / RLC simulator for pulse and sinusoidal excitation.

This project is not a numerical toy. It is a physics-defensible analytic engine designed to:

• Avoid ODE drift
• Avoid numerical instability
• Expose real state variables
• Make energy accounting transparent
• Separate physics from presentation

Design Philosophy

Physics first. Rendering second. UI last.

Strict architectural direction:

state → core → physics → metrics → panels → rendering → ui → main

No circular imports. No hidden coupling. No solver logic inside UI.

Physics Model

Supported Topologies

1. RL (pulse + sine)
2. Series RLC (pulse + sine)
3. Parallel C ∥ (R+L) (pulse + sine)

Each topology is implemented using closed-form analytic solutions. There is no numerical integration loop in steady-state pulse mode.

Solver Strategy

Pulse Mode

• Exact steady-periodic solutions
• Matrix exponential (series RLC)
• Piecewise analytic RL branch (parallel topology)
• Edge-aware handling to avoid artificial impulses
• True state-space closure validation

Sine Mode

• Phasor-domain solutions
• Exact amplitude–phase relationships
• Impedance, admittance, reactive power decomposition

State-Space Integrity

Metrics respect this. Algebraic derivatives (e.g., vL = L·di/dt) are not treated as independent states.

Metrics & Validation

• Periodicity closure check (pulse)
• Energy per period accounting
• Reactive power decomposition (QL, QC, Qnet)
• Detuning measure (ω − ω₀)/ω₀
• Q-factor & bandwidth
• Window-based magnetic and capacitor energy checks
• Conservation consistency tests

If the badge is green, it means true steady-state closure.

Visualization Modes

• Scope view
• Field view
• Helix view
• Lissajous (XY domain)

Rendering is strictly separated from solver logic.

Architectural Layers

/state – Mutable runtime state only.

/core – Pure helpers (τ, R_total, duty, period).

/physics kernels – Closed-form RL / RLC equations.

/metrics – Derived quantities and validation checks.

/panels – UI readout synthesis only.

/rendering – Canvas drawing only.

/ui – Event binding and DOM interaction.

Known Assumptions

• Ideal voltage source unless stated otherwise.
• No parasitic ESR unless explicitly modeled.
• Capacitor in parallel topology is clamped to source voltage.
• No magnetic saturation model.
• Linear components only.

Validation Philosophy

• Analytical textbook results
• State closure checks
• Energy conservation consistency
• Controlled parameter sweeps

For formal derivations and implemented equations, see the Mathematical Foundations page.

Why This Exists

Most educational simulators hide numerical integration and obscure state-space structure. This project exposes the true dynamic variables and keeps the modeling auditable.

Future Directions

• Optional ESR / parasitic modeling
• Controlled current-source excitation mode
• Automated resonance sweep
• Regression validation harness

License

This project is licensed under the GNU General Public License v3.0 (GPLv3). See the LICENSE file for full details.

Download

The simulator is available as a self-contained static bundle.

Download Self-Host Bundle (v1.1.4)

The package includes simulator, documentation, license, and release metadata. No build step required.

docker run --rm -p 8080:80 aridev1/rlc-analyzer:latest

docker run --rm -p 8080:80 aridev1/rlc-analyzer:1.1.4