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.

Configuration

Get a thourough description of the configuration of PowSyBl for different usages.

iTools

Know more about the available commands you can use and how to use them.

User stories

Get to know better what PowSybl can be used for.

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

Merging

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.

CIM-CGMES

The most up-to-date format for European grid data exchanges.

UCTE-DEF

The legacy format for European grid data exchanges.

XIIDM

The internal data model of PowSyBl.

PSS/E

The internal data model of PSS/E.

AMPL

A data separated value format easy to parse with AMPL

Simulation

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

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.

Slurm

Use PowSyBl with the SLURM job scheduler

MPI

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

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.

Microservices

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.

Architecture

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

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.

Repositories

This page lists the available repositories and their purpose.

Artifacts

This page lists the available artifacts and their use.

Patterns

Describes some of the programming patterns used in PowSyBl.

API guide

Describes the PowSyBl Java API for the various PowSyBl features.

Tutorials

Learn how to develop with PowSyBl.