# ieeh-tu-dresden/powerfactory-tools architecture

> Architecture diagram of the GitHub repository ieeh-tu-dresden/powerfactory-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ieeh-tu-dresden/powerfactory-tools
- Repository: https://github.com/ieeh-tu-dresden/powerfactory-tools

## Overview

IEEH PowerFactory Tools is a Python control and grid-export toolbox for DIgSILENT PowerFactory. The principal workflow is a user connecting through a version-specific interface, working with PowerFactory elements, and exporting calculation-relevant grid data to PSDM. Its runtime is organized as parallel PowerFactory-version implementations, with shared I/O and constants. The README documents the interface/exporter relationship and supported versioning; source excerpts also show exporter-to-load-power module references. Other internal calls are omitted where excerpts do not establish them.

Main entry points: [`src/powerfactory_tools/versions/pf2026/exporter/exporter.py`](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/exporter/exporter.py) (PF 2026 exporter), [`src/powerfactory_tools/versions/pf2026/interface.py`](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/interface.py) (PF 2026 interface), [`src/powerfactory_tools/versions/pf2022/exporter/exporter.py`](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/exporter/exporter.py) (PF 2022 exporter), [`src/powerfactory_tools/versions/pf2024/exporter/exporter.py`](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/exporter/exporter.py) (PF 2024 exporter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["PowerFactory control"]
  node_iface22["PF 2022 interface<br/>[interface.py]"]
  node_iface24["PF 2024 interface<br/>[interface.py]"]
  node_iface25["PF 2025 interface<br/>[interface.py]"]
  node_iface26["PF 2026 interface<br/>[interface.py]"]
  node_types22["PF 2022 types<br/>[types.py]"]
  node_types24["PF 2024 types<br/>[types.py]"]
  node_types25["PF 2025 types<br/>[types.py]"]
  node_types26["PF 2026 types<br/>[types.py]"]
  node_quant22["PF 2022 quantities<br/>[quantities.py]"]
  node_quant24["PF 2024 quantities<br/>[quantities.py]"]
  node_quant25["PF 2025 quantities<br/>[quantities.py]"]
  node_quant26["PF 2026 quantities<br/>[quantities.py]"]
end

subgraph group_export["Grid export"]
  node_export22["PF 2022 exporter<br/>[exporter.py]"]
  node_export24["PF 2024 exporter<br/>[exporter.py]"]
  node_export25["PF 2025 exporter<br/>[exporter.py]"]
  node_export26["PF 2026 exporter<br/>[exporter.py]"]
  node_load22["PF 2022 load power<br/>[load_power.py]"]
  node_load24["PF 2024 load power<br/>[load_power.py]"]
  node_load25["PF 2025 load power<br/>[load_power.py]"]
  node_load26["PF 2026 load power<br/>[load_power.py]"]
end

subgraph group_shared["Shared utilities"]
  node_io["File I/O<br/>[io.py]"]
  node_strings["String constants<br/>[str_constants.py]"]
  node_errors["Error codes"]
end

subgraph group_external["External systems"]
  node_pf["PowerFactory"]
  node_psdm["PSDM model"]
end

node_user(("Python user"))

node_user -->|"uses"| node_iface26
node_iface26 -->|"connects"| node_pf
node_export26 -->|"connects through"| node_iface26
node_export26 -->|"exports grid data"| node_psdm
node_export22 -->|"references"| node_load22
node_export24 -->|"references"| node_load24
node_export25 -->|"references"| node_load25
node_export26 -->|"references"| node_load26
node_export22 -->|"exports grid data"| node_psdm
node_export24 -->|"exports grid data"| node_psdm
node_export25 -->|"exports grid data"| node_psdm
node_iface22 -->|"controls"| node_pf
node_iface24 -->|"controls"| node_pf
node_iface25 -->|"controls"| node_pf

click node_iface22 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/interface.py"
click node_iface24 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/interface.py"
click node_iface25 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/interface.py"
click node_iface26 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/interface.py"
click node_types22 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/types.py"
click node_types24 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/types.py"
click node_types25 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/types.py"
click node_types26 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/types.py"
click node_export22 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/exporter/exporter.py"
click node_export24 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/exporter/exporter.py"
click node_export25 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/exporter/exporter.py"
click node_export26 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/exporter/exporter.py"
click node_load22 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/exporter/load_power.py"
click node_load24 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/exporter/load_power.py"
click node_load25 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/exporter/load_power.py"
click node_load26 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/exporter/load_power.py"
click node_io "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/utils/io.py"
click node_strings "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/str_constants.py"
click node_errors "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/powerfactory_error_codes.py"
click node_quant22 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/quantities.py"
click node_quant24 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/quantities.py"
click node_quant25 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/quantities.py"
click node_quant26 "https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/quantities.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_iface22,node_iface24,node_iface25,node_iface26,node_types22,node_types24,node_types25,node_types26,node_quant22,node_quant24,node_quant25,node_quant26,node_user toneBlue
class node_export22,node_export24,node_export25,node_export26,node_load22,node_load24,node_load25,node_load26 toneAmber
class node_io,node_strings,node_errors toneMint
class node_pf,node_psdm toneRose
```

## Components

### PowerFactory control

- [PF 2022 interface](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/interface.py): `src/powerfactory_tools/versions/pf2022/interface.py`
- [PF 2024 interface](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/interface.py): `src/powerfactory_tools/versions/pf2024/interface.py`
- [PF 2025 interface](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/interface.py): `src/powerfactory_tools/versions/pf2025/interface.py`
- [PF 2026 interface](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/interface.py): `src/powerfactory_tools/versions/pf2026/interface.py`
- [PF 2022 types](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/types.py): `src/powerfactory_tools/versions/pf2022/types.py`
- [PF 2024 types](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/types.py): `src/powerfactory_tools/versions/pf2024/types.py`
- [PF 2025 types](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/types.py): `src/powerfactory_tools/versions/pf2025/types.py`
- [PF 2026 types](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/types.py): `src/powerfactory_tools/versions/pf2026/types.py`
- [PF 2022 quantities](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/quantities.py): `src/powerfactory_tools/versions/pf2022/quantities.py`
- [PF 2024 quantities](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/quantities.py): `src/powerfactory_tools/versions/pf2024/quantities.py`
- [PF 2025 quantities](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/quantities.py): `src/powerfactory_tools/versions/pf2025/quantities.py`
- [PF 2026 quantities](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/quantities.py): `src/powerfactory_tools/versions/pf2026/quantities.py`

### Grid export

- [PF 2022 exporter](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/exporter/exporter.py): `src/powerfactory_tools/versions/pf2022/exporter/exporter.py`
- [PF 2024 exporter](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/exporter/exporter.py): `src/powerfactory_tools/versions/pf2024/exporter/exporter.py`
- [PF 2025 exporter](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/exporter/exporter.py): `src/powerfactory_tools/versions/pf2025/exporter/exporter.py`
- [PF 2026 exporter](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/exporter/exporter.py): `src/powerfactory_tools/versions/pf2026/exporter/exporter.py`
- [PF 2022 load power](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2022/exporter/load_power.py): `src/powerfactory_tools/versions/pf2022/exporter/load_power.py`
- [PF 2024 load power](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2024/exporter/load_power.py): `src/powerfactory_tools/versions/pf2024/exporter/load_power.py`
- [PF 2025 load power](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2025/exporter/load_power.py): `src/powerfactory_tools/versions/pf2025/exporter/load_power.py`
- [PF 2026 load power](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/versions/pf2026/exporter/load_power.py): `src/powerfactory_tools/versions/pf2026/exporter/load_power.py`

### Shared utilities

- [File I/O](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/utils/io.py): `src/powerfactory_tools/utils/io.py`
- [String constants](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/str_constants.py): `src/powerfactory_tools/str_constants.py`
- [Error codes](https://github.com/ieeh-tu-dresden/powerfactory-tools/blob/main/src/powerfactory_tools/powerfactory_error_codes.py): `src/powerfactory_tools/powerfactory_error_codes.py`

### External systems

- **PowerFactory**
- **PSDM model**

### Other components

- **Python user**

## Connections

- Python user → PF 2026 interface: uses (evidence: `README.md`)
- PF 2026 interface → PowerFactory: connects (evidence: `README.md`)
- PF 2026 exporter → PF 2026 interface: connects through (evidence: `README.md`)
- PF 2026 exporter → PSDM model: exports grid data (evidence: `README.md`)
- PF 2022 exporter → PF 2022 load power: references (evidence: `src/powerfactory_tools/versions/pf2022/exporter/exporter.py`)
- PF 2024 exporter → PF 2024 load power: references (evidence: `src/powerfactory_tools/versions/pf2024/exporter/exporter.py`)
- PF 2025 exporter → PF 2025 load power: references (evidence: `src/powerfactory_tools/versions/pf2025/exporter/exporter.py`)
- PF 2026 exporter → PF 2026 load power: references (evidence: `src/powerfactory_tools/versions/pf2026/exporter/exporter.py`)
- PF 2022 exporter → PSDM model: exports grid data (evidence: `README.md`)
- PF 2024 exporter → PSDM model: exports grid data (evidence: `README.md`)
- PF 2025 exporter → PSDM model: exports grid data (evidence: `README.md`)
- PF 2022 interface → PowerFactory: controls (evidence: `README.md`)
- PF 2024 interface → PowerFactory: controls (evidence: `README.md`)
- PF 2025 interface → PowerFactory: controls (evidence: `README.md`)
