# Sparlectra.jl

> Sparlectra.jl is a Julia framework for steady-state grid analysis: power flow, state estimation, IEC 60909 short circuit, and N-1 contingency studies, with CGMES and MATPOWER exchange.

## What it is

- Rectangular complex-state Newton-Raphson AC power flow with explicit PV/PQ Q-limit handling, plus a linear DC power flow and an optional analytic power-series solver (APSLF, via the AnalyticLoadFlow.jl package extension).
- Nonlinear weighted-least-squares (WLS) state estimation with observability checks.
- Balanced short-circuit analysis per IEC 60909-0 (Ik'' max/min, Sk'', peak current i_p) with safety flagging of substituted defaults.
- N-1 contingency batches on branch outages with voltage-band and loading evaluation, table and CSV output.
- Grid data exchange: ENTSO-E CGMES 2.4.15 and 3.0 import and export (roundtrip-stable identities), MATPOWER cases, native DTF files.
- Outer-loop controller framework: transformer tap and phase-shifter regulation incl. master/slave groups for parallel units, remote voltage control incl. the STATCOM current-based limit mode, SVC-style shunt control incl. MSC/MSR switched banks, TCSC series compensation incl. the SSSC injected-voltage limit mode, back-to-back HVDC pairs.
- Multi-core execution of independent work (island solves, short-circuit sweeps, contingency batches) on Julia threads with results identical to the serial runs.
- Local browser Web UI for MATPOWER/CGMES power-flow runs with persistent run history; loopback only.

## What it is not
- No commercial support.
- Not affiliated with any commercial power system tool.

## Links

- Documentation: https://welthulk.github.io/Sparlectra.jl/
- Feature matrix: https://welthulk.github.io/Sparlectra.jl/feature_matrix/
- Changelog: https://welthulk.github.io/Sparlectra.jl/changelog/
- Repository: https://github.com/Welthulk/Sparlectra.jl
- Announcement thread: https://discourse.julialang.org/t/ann-sparlectra-jl-v0-8-2-transparent-ac-power-flow-and-state-estimation/137349
