Welcome to the Roseau Load Flow documentation¶
Roseau Load Flow is a powerful load flow solver and static analysis tool that offers:
Multi-phase, unbalanced power flow analysis
A performance optimized solver written in C++
A catalogue of real-world transformer and line models
An ergonomic object-oriented Python interface with unit-aware quantities
A comprehensive documentation with code examples
Advanced built-in plotting tools for network visualization on interactive maps and voltage profile plots
Real-world distribution network data samples in the library (with more available here)
In addition to the following unique set of features:
Floating neutrals for loads, sources, and transformers
Actual four-wire multi-phase modelling with no Kron’s reduction and no transformations
Ideal or impedant ground connections at any point in the network
Flexible loads with Volt-Watt and Volt-VAr control directly in the Newton loop, which is more stable and results in a faster convergence than with the traditional outer loop approach
Out-of-the-box support for Single-Wire Earth Return (SWER), American bi-phase systems with center-tapped transformers, zero-sequence modelling, and other non-standard configurations
Roseau Load Flow ships with a sample of 20 low-voltage and 20 medium-voltage feeder networks. Each network is provided with its summer and winter load points.
We also maintain a set of 150 MV feeders representative of the French distribution system at https://github.com/RoseauTechnologies/Representative_French_Power_Grids. Each feeder is modeled with its downstream LV networks. The repository also contains the cluster size that indicates how representative is each network of the French distribution system. These networks are the result of the study Representative MV feeders for the analysis of French distribution networks, made and published by Mines Paris Tech.
More details are given in the Catalogues page.
Installation¶
roseau-load-flow is the python interface to the power flow solver. It is compatible with Python version 3.11 and newer
and can be installed with:
Installation and License
License¶
Read more about the license of this project:
Usage¶
The following tutorials are available to help you get started:
Models¶
A description of the electrical models used for each component, an example usage, and a reference to the API of the classes are available here:
Advanced¶
Advanced concepts, edge cases and more are explained in this section:
Changelog¶
API Reference¶
If you want the full documentation of all the classes and functions, you can refer to the following references: