Skip to content

Repository files navigation

Future Energy Lab

GridQA

Open-Source-Lösung zur automatisierten Datenqualitätsprüfung und -verbesserung
im Netzbetrieb und in der Netzplanung.

Status Python License Docs

A project by dena

GridQA ist eine CIM-orientierte Sammlung automatisierter Datentests für Stromnetzmodelle samt Import-/Exportsoftware zur Integration bei Netzbetreibern. Die Tests prüfen systematisch auf Vollständigkeit, Korrektheit, Struktur, Konsistenz und fachliche Konformität — ohne Eigenentwicklung durch den Netzbetreiber nutzbar.

Entwickelt für die Deutsche Energie-Agentur (dena) durch ein Konsortium aus inframind GmbH und Fraunhofer FIT.

Status: Pre-Alpha / Gerüst. Laufzeit Mai 2026 – Apr 2027.

Über das Projekt

Die Energiewende erfordert präzise, aktuelle und konsistente Netzdaten: dezentrale Erzeugung, Wärmepumpen, Ladeinfrastruktur und neue Betriebsanforderungen machen belastbare Daten unverzichtbar. Gerade kleinere und mittlere Netzbetreiber sichern Datenqualität bislang zeitaufwendig und manuell.

GridQA setzt hier an und entwickelt eine offene, praxistaugliche Datentestsammlung, mit der sich Datenqualität systematisch prüfen und verbessern lässt. Gemeinsam mit Netzbetreibern werden typische Probleme — unvollständige Stammdaten, lückenhafte Betriebsmitteldaten, widersprüchliche Netzanschlussangaben — in Prüfregeln übersetzt.

Zielgruppe: Netzbetreiber sowie Fachleute aus Datenqualität, Netzplanung, Data Hubs und energiewirtschaftlicher Datenmodellierung.

Ausführliche Projektbeschreibung: Future Energy Lab – GridQA.

Testkategorien

  1. Stammdatenqualität
  2. Plausibilität physikalischer Attribute
  3. Topologische Konsistenz
  4. Vollständigkeit von Asset-Informationen
  5. Logische Widerspruchsfreiheit

Zielwert: ca. 100 Datentests, organisiert in logischen Clustern, mit einheitlichen Metadaten, Namenskonventionen, Schweregraden, Vorbedingungen und standardisierten Ergebnisstrukturen.

Installation

pip install gridqa                 # Kern (native Tests, CLI)
pip install "gridqa[pandapower]"   # pandapower-Importer + pandapower.diagnostic-Tests
pip install "gridqa[cim]"          # CIM/CGMES-Import via pandapower (zieht lxml)
pip install -e ".[dev]"            # Entwicklung

Schnellstart

gridqa list                              # registrierte Tests auflisten
gridqa show COMP-001                     # Metadaten eines Tests
gridqa run --pp-example example_simple   # gegen ein pandapower-Beispielnetz
gridqa run --demo                        # gegen ein In-Memory-Demo-Modell

Ein pandapower-Netz prüfen (niederschwellig, inkl. pandapower.diagnostic):

import pandapower.networks as nw
from gridqa import from_pandapower, Runner

model = from_pandapower(nw.example_simple())   # -> CIM-orientiertes GridModel
report = Runner().run(model)                    # native Tests + PPDIAG-* (pandapower)
print(report.to_json())

Eigenes Modell prüfen:

from gridqa import GridElement, InMemoryGridModel, Runner

model = InMemoryGridModel([
    GridElement("line_1", "ACLineSegment", {"length": 120.0, "node1": "bus_1", "node2": "bus_1"}),
])
report = Runner().run(model)   # CONS-001 erkennt die Selbstschleife
print(report.to_json())

Projektstruktur

src/gridqa/
├── core/        # Severity, Metadaten, Ergebnis, Basisklasse, Registry, Runner
├── model/       # CIM-orientiertes Kernmodell (GridModel-Abstraktion)
├── catalog/     # Native Datentests, gruppiert nach den 5 Kategorien
├── io/
│   ├── importers/   # pandapower-Importer (-> CIM-orientiertes GridModel)
│   └── diagnostics/ # pandapower.diagnostic als GridQA-Tests (PPDIAG-*)
├── validation/  # Fault-Injection-Suite (Validierung der Tests)
└── cli.py       # Kommandozeile
docs/            # technische Dokumentation (Sphinx/ReadTheDocs)
tests/           # pytest
examples/        # Beispielmodelle & Skripte

Dokumentation

Technische Dokumentation unter docs/ (Sphinx). Einstiegspunkte:

Lizenz

Apache-2.0.

About

Automatisierte Datentests für Netzbetreiber: Stromnetzmodelle systematisch auf Vollständigkeit, Plausibilität und Konsistenz prüfen.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages