Grid Data Models (GDM)
GDM is a python package containing data models for power system assets and datasets. This package is actively being developed at National Renewable Energy Laboratory (NREL).
GDM models distribution networks and utility substations as complementary
systems. DistributionSystem represents feeder and network connectivity;
SubstationSystem represents station topology, primary equipment, protection,
metering, and automation. They can remain separate or be joined at explicit
feeder boundaries. See the system model guide and the
guide to connecting systems.
Installation
You can install the latest version of grid-data-models from PyPi.
pip install grid-data-models
Why Grid Data Models?
In an effort to reduce code duplication and provide client packages a standard interface to interact with power system data, a group of research engineers at NREL is working on developing standard data models. Features:
- Built-in validation layer: Use of pydantic allows us to validate model fields.
- Time series data management: GDM uses infrasys package which enables efficient time series data management by sharing arrays across components and offloading system memory. For example, we can attach time series power consumption data to a load profile.
- Built-in unit conversion: GDM leverages pint for unit conversion for power system quantities. For example, power, voltage, time, etc.
- JSON serialization/deserialization: GDM uses infrasys to serialize and deserialize distribution system components to/from JSON.
- Track System Changes: Supports tracking changes within a distribution model (both temporal and scenario-based static updates), enabling powerful scenario management capabilities.
- Graph-Based Analysis: Exposes a connectivity graph using NetworkX, allowing advanced graph-based algorithms and visualizations.
- Interoperability: Easily integrates with existing tools.
- Model reduction: Built-in support for multiple model reduction algorithms.
How to get started?
To get started, you can clone and pip install this library from here.
Model Context Protocol (MCP) Integration
GDM includes an MCP server that enables AI assistants to interact with power system models through natural language. The MCP integration provides:
- System inspection and analysis - Query components, analyze topology, validate connectivity
- Validation and diagnostics - Diagnose errors, suggest fixes, and automatically apply corrections
- System operations - Merge, split, and extract subsystems
- Documentation and API access - Search documentation and get component API references
To install with MCP support:
pip install -e ".[mcp]"
To run the MCP server:
gdm-mcp-server
For more details, see the MCP documentation.
Contributors
- Aadil Latif
- Daniel Thom
- Jeremy Keen
- Kapil Duwadi
- Tarek Elgindy
- Pedro Andres Sanchez Perez
2 maintainers
Metadata
2 maintainers
Release files for grid-data-models 2.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| grid_data_models-2.4.0.tar.gz | 126.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| grid_data_models-2.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 316.8 kB
Release files / grid_data_models-2.4.0.tar.gz
| Download URL | grid_data_models-2.4.0.tar.gz |
|---|---|
| Size | 126.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
975c34c500f504b3d0d3dab087d110cc5f1c9c5ed3ece40f6c2cbeea18a620f5
|
|
BLAKE2b-256 checksum How to use checksums |
33ca8e1c32d7a62e2bcaa7bb15458a442836ca88cf0ade3ecc7017644e483bfa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / grid_data_models-2.4.0-py3-none-any.whl
| Download URL | grid_data_models-2.4.0-py3-none-any.whl |
|---|---|
| Size | 190.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a7e366f17f1bb2d9e1cf28b99b675fb2b1ec264e0acc9106355d8d25341ffcb9
|
|
BLAKE2b-256 checksum How to use checksums |
e8810b0885e612c15be8c94f57ddf54f88864ff9d125049dbef6aa439e11f755
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency log
