ieeh-powerfactory-tools 1.4.0

A toolbox for Python based control of DIgSILENT PowerFactory

IEEH PowerFactory Tools

A toolbox for Python based control of DIgSILENT PowerFactory.

• IEEH PowerFactory Tools
  • Field of Application
  • Tutorials
  • Installation
  • Compatibility
  • Development
  • Acknowledgement
  • Attribution

Field of Application

This application is intended to use for an external usage ('engine mode') of the power flow calculation program DIgSILENT PowerFactory. Therefore, the Python-PowerFactory-API, provided by the company, is utilized.

The following functionalities are provided:

• export of calculation relevant grid data from a PowerFactory project into three common readable JSON files utilizing predefined schemas:
  • grid topology:
    • base topology containing all elements of the exported grid
  • topology case;
    • information about disabled elements to represent a specific operational case based on the base topology
  • steadystate case
    • information about power draw/infeed for a specific operational case
• [intended in future release] import from external grid data into the PowerFactory environment
• [intended in future release] basic control of PowerFactory

Tutorials

Jupyter notebooks are provided to get in touch with the usage of this toolbox:

• for export: powerfactory_export.ipynb

Installation

Just install via pip:

pip install ieeh-powerfactory-tools

Compatibility

Due to very useful features in python 3.10+ - which is supported by PowerFactory 2022, we decided to drop python 3.9 starting from version 1.4. Users that use an older PowerFactory version, please use version 1.3.

Development

Install pdm

Windows:

(Invoke-WebRequest -Uri https://raw.githubusercontent.com/pdm-project/pdm/main/install-pdm.py -UseBasicParsing).Content | python -

Linux/Mac:

curl -sSL https://raw.githubusercontent.com/pdm-project/pdm/main/install-pdm.py | python3 -

Install pdm-venv

pdm plugin add pdm-venv
pdm config venv.in_project true

Clone powerfactory-tools

[e-mail]:ieeh-tu-dresden/powerfactory-tools.git

cd powerfactory-tools

Install powerfactory-tools as a production tool

pdm install --prod

Install powerfactory-tools in development mode

pdm install

For development in Visual Studio Code, all configurations are already provided:

• flake8
• black
• mypy

Acknowledgement

Please note that this work is part of research activities and is still under active development.

This code was tested with DIgSILENT PowerFactory 2021 SP5 and DIgSILENT PowerFactory 2022 SP2.

Attribution

Please provide a link to this repository:

https://github.com/ieeh-tu-dresden/powerfactory-tools

Please cite as:

Institute of Electrical Power Systems and High Voltage Engineering - TU Dresden, PowerFactory Tools - A toolbox for Python based control of DIgSILENT PowerFactory, Zenodo, 2022. https://doi.org/10.5281/zenodo.7074968.