/powerfactory-tools

A toolbox for Python based control of DIgSILENT PowerFactory

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

IEEH PowerFactory Tools

License

A toolbox for Python based control of DIgSILENT PowerFactory.

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 to the IEEH Power System Data Model
  • [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:

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

git@github.com: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:

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.

DOI