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.

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.
Flow decomposition
Compute for each network element a decomposition of the active flow into different parts (loop flows, allocated flows,...)
Short circuit analysis
Compute the impact on a network of the abnormal connection of two nodes.
Remedial Action Optimizer
Optimize remedial actions in the network in order to relieve operational limits violations.

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.
API guide
Describes the PowSyBl Java API for the various PowSyBl features.

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.