RLC Analyzer

Analytical Reference & Energy Visualization Lab

Documentation target: v1.1.9

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

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

• Avoid ODE drift
• Avoid numerical instability
• Expose real state variables
• Make energy accounting transparent
• Keep diagnostics physically interpretable
• 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.
No duplicated physics paths.

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 analytical solutions. There is no numerical integration loop in steady-state pulse mode.

Solver Strategy

Pulse Mode

• Exact steady-periodic solutions
• Matrix exponential solution path (series RLC)
• Piecewise analytical RL branch solution (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, and reactive power decomposition

State-Space Integrity

Metrics respect this. Algebraic derivatives such as vL = L·di/dt are not treated as independent states.

Metrics & Validation

• Periodicity closure check (pulse)
• Energy per period accounting
• Reactive power decomposition (Q_L, Q_C, Q_net)
• Detuning measure \((\omega - \omega_0)/\omega_0\)
• Q-factor and bandwidth
• Window-based magnetic and capacitor energy checks
• Conservation consistency tests

If the badge is green, it indicates true steady-state closure rather than visual stability alone.

Diagnostics System

Version 1.1.9 strengthens the simulator with a more explicit diagnostics layer. These checks are not cosmetic warnings. They are derived from the same analytical waveform arrays that drive the rest of the instrument.

• Consistency checks between current, voltage, and derived quantities
• Energy-integral checks against instantaneous power relationships
• Inductive and capacitive energy-window checks
• Status readouts for OK, CHECK, ERROR, and UNDEFINED

The purpose of this layer is to make solver integrity visible without introducing a second hidden calculation path. Diagnostics remain subordinate to the authoritative waveform and metrics model.

Power Quality & Energy Flow Analysis

The RLC Analyzer includes a power-quality analysis layer derived directly from the analytical waveform solutions. In addition to waveform visualization, the simulator exposes the same classes of quantities commonly provided by laboratory power analyzers.

• Apparent power (S)
• Active power (P)
• Reactive power (Q)
• Power factor and phase angle
• Fundamental versus distortion decomposition
• Inductive and capacitive reactive components

Reactive energy exchange between inductive and capacitive elements is visualized explicitly. This allows resonant systems, detuning behavior, and reactive compensation effects to be studied in a physically transparent way.

Reference Layer & Value Integrity

The documentation layer is designed to remain synchronized with the simulator’s exposed quantities. For v1.1.9, this traceability is reinforced through the value-reference workflow.

• Runtime values are mapped into a structured registry
• Reference pages are generated from the same value definitions
• Displayed quantities, naming, and interpretation are kept aligned
• Documentation is intended to reflect actual computation, not a parallel hand-written model

This improves auditability across UI panels, exported data, and reference documentation.

Visualization Modes

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

Rendering is strictly separated from solver logic. Visual layers exist to reveal physics, not to replace it.

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 with zero internal impedance unless explicitly modeled 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

Many educational simulators hide numerical integration and obscure state-space structure. This project exposes the true dynamic variables and keeps the modeling auditable. It is intended to behave more like a transparent analytical instrument than a black-box teaching toy.

Future Directions

• Optional ESR / parasitic modeling
• Controlled current-source excitation mode
• Automated resonance sweep
• Regression validation harness
• Expanded analytical diagnostics and reference traceability

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.9)

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

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

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