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).
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file grid_data_models-2.3.7.tar.gz.
File metadata
- Download URL: grid_data_models-2.3.7.tar.gz
- Upload date:
- Size: 88.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ecf8c7fa1edfde2ffea19cc034028136f437f7f3beeac892bf38060d6353c7a1
|
|
| MD5 |
49016a8def1a5668f06025b45844d39c
|
|
| BLAKE2b-256 |
abcef4a64cca37006fef0fc0f25dbf76840dab0166b5dcd1aa93f5371b1ebc19
|
Provenance
The following attestation bundles were made for grid_data_models-2.3.7.tar.gz:
Publisher:
publish_to_pypi.yml on NLR-Distribution-Suite/grid-data-models
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
grid_data_models-2.3.7.tar.gz -
Subject digest:
ecf8c7fa1edfde2ffea19cc034028136f437f7f3beeac892bf38060d6353c7a1 - Sigstore transparency entry: 2139248758
- Sigstore integration time:
-
Permalink:
NLR-Distribution-Suite/grid-data-models@7379aea8d7957b27b262af7d1c3798fd3e081f66 -
Branch / Tag:
refs/tags/v2.3.7 - Owner: https://github.com/NLR-Distribution-Suite
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_to_pypi.yml@7379aea8d7957b27b262af7d1c3798fd3e081f66 -
Trigger Event:
release
-
Statement type:
File details
Details for the file grid_data_models-2.3.7-py3-none-any.whl.
File metadata
- Download URL: grid_data_models-2.3.7-py3-none-any.whl
- Upload date:
- Size: 145.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0d15e87cb36cface660e6a0c6c30d5f0461f575d14c4fff5a68ce3aa3b92cd5b
|
|
| MD5 |
1382c89bd47975371fc8fbbfdb9a63c8
|
|
| BLAKE2b-256 |
a24cf8945c80e81cb4232b200bf42dfa8323e493546f2cad1f6d44d4050d56a6
|
Provenance
The following attestation bundles were made for grid_data_models-2.3.7-py3-none-any.whl:
Publisher:
publish_to_pypi.yml on NLR-Distribution-Suite/grid-data-models
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
grid_data_models-2.3.7-py3-none-any.whl -
Subject digest:
0d15e87cb36cface660e6a0c6c30d5f0461f575d14c4fff5a68ce3aa3b92cd5b - Sigstore transparency entry: 2139248760
- Sigstore integration time:
-
Permalink:
NLR-Distribution-Suite/grid-data-models@7379aea8d7957b27b262af7d1c3798fd3e081f66 -
Branch / Tag:
refs/tags/v2.3.7 - Owner: https://github.com/NLR-Distribution-Suite
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_to_pypi.yml@7379aea8d7957b27b262af7d1c3798fd3e081f66 -
Trigger Event:
release
-
Statement type:
