User documentation

In this section, you'll discover the basics about PowSyBl: how to install it, run your first commands, configure it for your needs, etc.

Getting started
Discover how to install PowSyBl and run your first iTools command from the terminal.
Get a thorough description of the configuration of PowSyBl for different usages.
User stories
Get to know better what PowSybl can be used for.
Learn how to use and develop with PowSyBl.
Learn how to use PowSyBl through Python or Groovy scripts.
Know more about the available commands you can use and how to use them.

Developer documentation

This section is dedicated to the developer documentation. You'll find a description of all the repositories and artifacts of the project, but also documentation about the framework itself and the way it has been designed, and a set of tutorials aimed at helping developers get into the code.

This page lists the available repositories and their purpose.
This page lists the available artifacts and their use.
Describes some of the programming patterns used in PowSyBl.
API guide
Describes the PowSyBl Java API for the various PowSyBl features.

Grid model

This section provides information about the way the network is modelled at the core of PowSyBl, i.e. in the IIDM internal format, and also how to manage network merging or extraction.

Grid modelling
Learn about the way the topology is handled, with different available views, the way synchronous components are treated, etc.
Grid extension
Learn about the way to attach additional data to the grid components using extensions
Discover how you can merge networks, for handling European data for instance.
Network extraction
Learn how to extract sub-parts of the network to keep only what you need from the data.

Grid exchange formats

This section is dedicated to the description of the various grid formats available in PowSyBl. While IIDM is at the core of it, it is possible to import or export data in a number of formats that may be dedicated to European data exchanges or network simulation via different tools: check them out below.

The most up-to-date format for European grid data exchanges.
The legacy format for European grid data exchanges.
The internal data model of PowSyBl.
Data required for power flow analysis on Siemens PSS®E software.
A free and open-source Matlab toolbox for power system simulation and optimization
A data separated value format easy to parse with AMPL


One major aim of the PowSyBl project is to make it easy to plug it with different solvers for grid simulation. At the moment, four types of simulations are supported: power flow, security analysis, time-domain simulation and sensitivity analysis. For each of them, one or several simulators is officially supported, but it is also possible to plug your own simulator within the framework. Below comes a description of the various types of simulation and supported solvers.

Power flow
Compute the flow of electric power in an interconnected system in normal steady-state operation
Security analysis
Detect security violations on a network for a list of contingencies. This simulation can be done with or without remedial actions.
Time domain simulation
Capture the transient response of the system, with or without events activations.
Sensitivity analysis
Compute the linearized impact of small network variations on the state variables of some components
Metrix simulation
Compute optimal power load flow on a range of time series mapped on network variants

High Performance Computing

Grid simulation comes with a computational cost, and in this section we describe how to take advantage of the High Performance Computing capabilities of PowSyBl to reduce computational times to a minimum.

Use PowSyBl with the SLURM job scheduler
Use MPI parallelism for PowSyBl-powered simulations

Data management

This section is dedicated to data management: PowSyBl makes it possible to handle study data in a scalable way through an Application File System (AFS). Besides, it also makes it possible to output time-series of the network data. These two features are described here.

AFS (Application File System) is a data management system to manage grid studies.
Time series
Get to know the comprehensive and flexible time series modeling of PowSyBl.


Since PowSyBl is meant to make it easy to build state-of-the-art applications for grid modeling, it also comes with a set of microservices. The aim is to make it easier to build web-based applications. Check them out below.

Get to know how the PowSyBl microservices are meant to be assembled.