PowerNetworkMatrices.jl
Overview
PowerNetworkMatrices.jl is a Julia package for building the network matrices used in DC/AC power flow, sensitivity, and contingency analysis. Given a PowerSystems.jl System, it produces the linear-algebra layer of the Sienna power-systems platform: it reads the network data and returns matrix objects, it does not own the data model.
PowerNetworkMatrices.jl is an active project under development, and we welcome your feedback, suggestions, and bug reports.
Installation
] add PowerNetworkMatricesWhere to start
The documentation follows the Diátaxis framework, split into four kinds of material:
- Tutorials — learning-oriented journeys, each answering one question end to end. Start with the Introduction, which screens a line outage on a small network with a PTDF, an LODF, and a reduction; then Analysis at Scale does the same at scale with virtual matrices and cache control.
- How-To Guides — task recipes for a specific goal (build matrices efficiently, choose a solver, reproduce industry DFAX values, define contingencies, diagnose connectivity).
- Reference — exhaustive descriptions of every matrix type, accessor, and setting. Begin at the Matrix Overview and Indexing hub.
- Explanation — the concepts and trade-offs: the DC approximation, network-reduction theory, computational considerations, concurrency, and slack conventions.
About
PowerNetworkMatrices.jl has been developed as part of the Scalable Integrated Infrastructure Planning (SIIP) initiative at the U.S. Department of Energy's National Laboratory of the Rockies (formerly known as NREL) (NLR).