Overview

The following tutorials illustrate the functionality of powfacpy. You can use the PowerFactory project under *tests_input_tests.pfd* to run the commands in the tutorials locally. You can follow the link to Github on the right to download the tutorials in .qmd format (quarto). If you prefer jupyter notebook format, you can convert them with quarto convert <tutorial_name.qmd> (assuming quarto is installed).

1 Getting started

Start here with the getting started tutorial. This tutorial gives an overview of the interaction with the PowerFactory database using powfacpy. The methods introduced in this tutorial serve as a basis to do more complex things and to write more readable code using less lines of code.

2 Dynamic Simulation and Plotting

The tutorial shows how to conveniently simulate and plot with a syntax similar to matplotlib. It is also depicted how to export data to pandas and csv formats and use external plotting libraries such as matplotlib.

3 Static Calculations (Load Flow etc.)

The static calculations in this tutorial like power flow (or load flow as it’s called in PowerFactory) or short circuit analysis are not the main focus of powfacpy. However, powfacpy provides a convenient interface to perform these calculations and to access the results.

4 Study Cases

The study cases tutorial illustrates how to automatically create study cases for parameter studies.

5 Parameter Studies

This tutorial shows how to perform parameter studies in a concise and structured way and to generate targeted parameter modifications with minimal code. Compared to the ‘Study Cases’ tutorial, the focus is not on creating study cases, variations and operation scenarios, but rather on the parameter sets.

6 Network Matrices and Pandapower Interface

This tutorial demonstrates how to export network matrices such as admittance or Jacobian matrix using the Pandapower interface as an intermediate step.

7 Topology and Groupings

The tutorial on topology and groupings focuses on the grouping of network elements into boundaries, zones and areas.

8 Subsystems

The Subsystems tutorial covers similar topics as the topology and groupings tutorial on zones, areas and boundaries. However, the SubSystem and SubSystemContainer clases of powfacpy go beyond the functionality and add further analysis for coherent network areas and their interactions (e.g. power exchange, connectivity, etc.).

9 CGMES Model Exchange

In the cgmes model exchange tutorial you can learn how to get started with the application.model_exchange tool to export, import or update grid models using CGMES.

10 A Word on Performance

This tutorial evaluates the performance characteristics of the Python API of PowerFactory. The powfacpy wrapper is benchmarked against the native API. Moreover, the performance improvements achieved through the caching mechanisms provided by powfacpy are demonstrated.