ieeh-power-system-data-model 2.0.1

A data model for describing power systems

IEEH Power System Data Model

A data model for the description of electrical power systems.

• IEEH Power System Data Model
  • Field of Application
  • General Remarks
  • Installation
  • Development
  • Attribution

Field of Application

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:

• 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

General Remarks

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
  • The Rated Power should always be defined positive (absolute value).
• SteadyState
  • The interaction between load models and controllers are depicted in the following schematic:

Installation

Just install via pip:

pip install ieeh-power-system-data-model

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 -

Or using pipx or pip:

pipx install pdm

pip install --user pdm

Clone power-system-data-model

[e-mail]:ieeh-tu-dresden/power-system-data-model.git

cd power-system-data-model

Install power-system-data-model as a production tool

pdm install --prod

Install power-system-data-model in development mode

pdm install

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

• ruff
• black
• mypy

Attribution

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.