{"id":38544821,"url":"https://github.com/ieeh-tu-dresden/power-system-data-model","last_synced_at":"2026-01-17T07:17:26.119Z","repository":{"id":143632948,"uuid":"605963567","full_name":"ieeh-tu-dresden/power-system-data-model","owner":"ieeh-tu-dresden","description":"A hierarchical data model for the description of electrical power systems.","archived":false,"fork":false,"pushed_at":"2025-12-19T11:58:18.000Z","size":15051,"stargazers_count":7,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-22T04:32:14.446Z","etag":null,"topics":["datamodel","powersystem","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ieeh-tu-dresden.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-24T09:35:59.000Z","updated_at":"2025-12-19T11:58:22.000Z","dependencies_parsed_at":"2023-05-19T05:15:27.500Z","dependency_job_id":"a2cb6434-a3e1-4d45-aa68-5a2685224cb8","html_url":"https://github.com/ieeh-tu-dresden/power-system-data-model","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/ieeh-tu-dresden/power-system-data-model","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ieeh-tu-dresden%2Fpower-system-data-model","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ieeh-tu-dresden%2Fpower-system-data-model/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ieeh-tu-dresden%2Fpower-system-data-model/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ieeh-tu-dresden%2Fpower-system-data-model/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ieeh-tu-dresden","download_url":"https://codeload.github.com/ieeh-tu-dresden/power-system-data-model/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ieeh-tu-dresden%2Fpower-system-data-model/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28503395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["datamodel","powersystem","python"],"created_at":"2026-01-17T07:17:26.036Z","updated_at":"2026-01-17T07:17:26.098Z","avatar_url":"https://github.com/ieeh-tu-dresden.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# PowerSystem Data Model\n[![image](https://img.shields.io/pypi/v/ieeh-power-system-data-model.svg)](https://pypi.python.org/pypi/ieeh-power-system-data-model)\n[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![Pydantic v2](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/pydantic/pydantic/main/docs/badge/v2.json)](https://docs.pydantic.dev/latest/contributing/#badges)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8087079.svg)](https://doi.org/10.5281/zenodo.8087079)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./docs/static/PSDM_icon_extended_360px.png\" width=\"200\"\u003e\n\u003c/div\u003e\n\nA data model for the description of electrical power systems.\n\n- [Field of Application](#field-of-application)\n  - [Grid Topology](#grid-topology)\n  - [Topology Case](#topology-case)\n  - [Steadystate Case](#steadystate-case)\n- [General Remarks](#general-remarks)\n- [Installation](#installation)\n- [Development](#development)\n- [Attribution](#attribution)\n\n## Field of Application\n\nThis data model is intended to describe electrical power systems.\nIt provides a hierarchical structure/schema to describe unique entity relations as well as parameter sets.\n\nRead also this comprehensive [blog post](https://medium.com/@Sebastian-DD/export-a-network-from-powerfactory-to-the-power-system-data-model-db46103bdabe) about the PSDM.\n\nThe data model is structured as the following schema:\n\n### Grid Topology\nThis is the base topology containing all elements of the exported grid:\n- Branches (symmetrical: overhead lines, cables, fuses from type \"branch\")\n- Nodes\n- Transformers (symmetrical: 2- or 3-winding)\n- External grids\n- Loads (consumer, producer, grid assets)\n![topology relationship diagram](./docs/entity_rel__topology.png)\n\nIn addition to the explicitly defined element attributes, it is possible to save user-specific additional information as optional AttributeData ([Export example of powerfactory-tools](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/examples/powerfactory_export.ipynb)).\n\n### Topology Case\nThis holds information about disabled elements to represent a specific operational case based on the base topology.\n  ![topology case relationship diagram](./docs/entity_rel__topology_case.png)\n\n### Steadystate Case\nThis holds information for a specific operational case such as:\n- power draw/infeed of load\n- tap position of transformer\n- operating point of external grid\n  ![steadystate case relationship diagram](./docs/entity_rel__steady_state_case.png)\n\n## General Remarks\n\nPlease find below some important general remarks and assumptions to consider for consistent usage across different applications:\n- The passive sign convention should be used for all types of loads (consumer as well as producer).\n- Numeric values should be set using the SI unit convention.\n- Topology\n  - Only **symmetrical** grid assets, e.g. transformer or line, are supported.\n  - The `Rated Power` should always be defined positive (absolute value).\n- The interaction between load models and controllers are depicted in the following schematic:\n  ![active/reactive power schematics](./docs/static/power_schematics.png)\n\n## Installation\n\nJust install via pip:\n\n```bash\npip install ieeh-power-system-data-model\n```\n\n## Development\n\n[Install the Python package and project manager uv](https://github.com/astral-sh/uv)\n\nClone `power-system-data-model`\n\n```bash\ngit@github.com:ieeh-tu-dresden/power-system-data-model.git\n```\n\n```bash\ncd power-system-data-model\n```\n\nInstall `power-system-data-model` as a production tool\n\n```bash\nuv sync --no-dev\n```\n\nInstall `power-system-data-model` in development mode\n\n```bash\nuv sync\n```\n\nFor development in [Visual Studio Code](https://github.com/microsoft/vscode), all configurations are already provided:\n\n- [ruff](https://github.com/astral-sh/ruff)\n- [mypy](https://github.com/python/mypy)\n\n## Attribution\n\nPlease provide a link to this repository:\n\n\u003chttps://github.com/ieeh-tu-dresden/power-system-data-model\u003e\n\nPlease cite as:\n\nInstitute 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. \u003chttps://doi.org/10.5281/zenodo.8087079\u003e.\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8087079.svg)](https://doi.org/10.5281/zenodo.8087079)\n\nAlternatively, when using the PSDM together with the [powerfactory-tools](https://github.com/ieeh-tu-dresden/powerfactory-tools), please cite also:\n\nS. Krahmer, S. J. Rasti, L. Fiedler and M. Schmidt, „PowerFactory-Tools: A Python Package to Facilitate the Control of DIgSILENT PowerFactory“. Journal of Open Source Software (JOSS), 10(116), 9281, 2025. doi: 10.21105/joss.09281.\n\n[![DOI](https://joss.theoj.org/papers/10.21105/joss.09281/status.svg)](https://doi.org/10.21105/joss.09281)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fieeh-tu-dresden%2Fpower-system-data-model","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fieeh-tu-dresden%2Fpower-system-data-model","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fieeh-tu-dresden%2Fpower-system-data-model/lists"}