A data model for the description of electrical power systems.
This data model is intended to describe electrical power systems. It provides a hierarchical structure/schema to describe unique entity relations as well as parameter sets.
The data model is structured as the following schema:
This is the base topology containing all elements of the exported grid:
- Branches (symmetrical: overhead lines, cables, fuses from type "branch")
- Nodes
- Transformers (symmetrical: 2- or 3-winding)
- External grids
- Loads (consumer, producer, grid assets)
In addition to the explicitly defined element attributes, it is possible to save user-specific additional information as optional AttributeData (Export example of powerfactory-tools).
This holds information about disabled elements to represent a specific operational case based on the base topology.
This holds information for a specific operational case such as:
Please find below some important general remarks and assumptions to consider for consistent usage across different applications:
- The passive sign convention should be used for all types of loads (consumer as well as producer).
- Numeric values should be set using the SI unit convention.
- Topology
- Only symmetrical grid assets, e.g. transformer or line, are supported.
- The
Rated Power
should always be defined positive (absolute value).
- The interaction between load models and controllers are depicted in the following schematic:
Just install via pip:
pip install ieeh-power-system-data-model
Install the Python package and project manager uv
Clone power-system-data-model
git@github.com:ieeh-tu-dresden/power-system-data-model.git
cd power-system-data-model
Install power-system-data-model
as a production tool
uv sync --no-dev
Install power-system-data-model
in development mode
uv sync
For development in Visual Studio Code, all configurations are already provided:
Please provide a link to this repository:
https://github.com/ieeh-tu-dresden/power-system-data-model
Please cite as:
Institute of Electrical Power Systems and High Voltage Engineering - TU Dresden, Power System Data Model - A data model for the description of electrical power systems, Zenodo, 2023. https://doi.org/10.5281/zenodo.8087079.