Power Grid Model
power-grid-model is a library for steady-state distribution power system analysis distributed for Python and C.
The core of the library is written in C++.
Currently, it supports the following calculations:
- Power Flow
- State Estimation
- Short Circuit
See the power-grid-model documentation for more information. For various conversions to the power-grid-model, refer to the power-grid-model-io repository. For an extended python interface to the the power-grid-model, refer to the power-grid-model-ds repository.
Want to be updated on the latest news and releases? Subscribe to the Power Grid Model mailing list by sending an (empty)
email to: powergridmodel+subscribe@lists.lfenergy.org
Installation
Install from PyPI
You can directly install the package from PyPI.
pip install power-grid-model
Install from Conda
If you are using conda, you can directly install the package from conda-forge channel.
conda install -c conda-forge power-grid-model
Build and install from Source
To install the library from source, refer to the Build Guide.
Examples
Please refer to Examples for more detailed examples for power flow and state estimation. Notebooks for validating the input data and exporting input/output data are also included.
License
This project is licensed under the Mozilla Public License, version 2.0 - see LICENSE for details.
Licenses third-party libraries
This project includes third-party libraries, which are licensed under their own respective Open-Source licenses. SPDX-License-Identifier headers are used to show which license is applicable. The concerning license files can be found in the LICENSES directory.
Contributing
Please read CODE_OF_CONDUCT, CONTRIBUTING, PROJECT GOVERNANCE and RELEASE for details on the process for submitting pull requests to us.
Visit Contribute for a list of good first issues in this repo.
Citations
If you are using Power Grid Model in your research work, please consider citing our library using the following references.
@software{Xiang_PowerGridModel_power-grid-model,
author = {Xiang, Yu and Salemink, Peter and van Westering, Werner and Bharambe, Nitish and Govers, Martinus G.H. and van den Bogaard, Jonas and Stoeller, Bram and Wang, Zhen and Guo, Jerry Jinfeng and Figueroa Manrique, Santiago and Jagutis, Laurynas and Wang, Chenguang and van Raalte, Marc and {Contributors to the LF Energy project Power Grid Model}},
doi = {10.5281/zenodo.8054429},
license = {MPL-2.0},
title = {{PowerGridModel/power-grid-model}},
url = {https://github.com/PowerGridModel/power-grid-model}
}
@inproceedings{Xiang2023,
author = {Xiang, Yu and Salemink, Peter and Stoeller, Bram and Bharambe, Nitish and van Westering, Werner},
booktitle={27th International Conference on Electricity Distribution (CIRED 2023)},
title={Power grid model: a high-performance distribution grid calculation library},
year={2023},
volume={2023},
number={},
pages={1089-1093},
keywords={},
doi={10.1049/icp.2023.0633}
}
Contact
Please read SUPPORT for how to connect and get into contact with the Power Grid Model project.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
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 power_grid_model-1.13.150.tar.gz.
File metadata
- Download URL: power_grid_model-1.13.150.tar.gz
- Upload date:
- Size: 1.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5a0916ba2905a7f7902a8c725067a6acd2cdd53cb699a6eac5ef8ad7996fbbb1
|
|
| MD5 |
f8a6882a5ded1f1661acfc383e906bd6
|
|
| BLAKE2b-256 |
e313b11f200d53e4e4f09d1d6ce72a53951e9e7fa6dc7be6046ca2e7e4b35647
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150.tar.gz:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150.tar.gz -
Subject digest:
5a0916ba2905a7f7902a8c725067a6acd2cdd53cb699a6eac5ef8ad7996fbbb1 - Sigstore transparency entry: 2586657411
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
File details
Details for the file power_grid_model-1.13.150-py3-none-win_amd64.whl.
File metadata
- Download URL: power_grid_model-1.13.150-py3-none-win_amd64.whl
- Upload date:
- Size: 900.3 kB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
76288e2bc6a8e9705a2f54af880e93e59dac975472a04ba0a8c5156736160527
|
|
| MD5 |
551c1e57e8c1a739ed5ea87a33d3377a
|
|
| BLAKE2b-256 |
632fc5a8e79ac5dd149beaf9a10900636c262703b5fc41ef26d151064f86a6df
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150-py3-none-win_amd64.whl:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150-py3-none-win_amd64.whl -
Subject digest:
76288e2bc6a8e9705a2f54af880e93e59dac975472a04ba0a8c5156736160527 - Sigstore transparency entry: 2586658521
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
File details
Details for the file power_grid_model-1.13.150-py3-none-musllinux_1_2_x86_64.whl.
File metadata
- Download URL: power_grid_model-1.13.150-py3-none-musllinux_1_2_x86_64.whl
- Upload date:
- Size: 4.0 MB
- Tags: Python 3, musllinux: musl 1.2+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d1c1eb6ca56435f368122a4c3e9469f16ce9119964b4aaf776a16d2d44bbcb59
|
|
| MD5 |
d1a1d306d3517991d88d93db214603b7
|
|
| BLAKE2b-256 |
8023ad6ba137399a0614a07e31c7d982c2868e92d8b11bb6d373c7bcef5fd6ef
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150-py3-none-musllinux_1_2_x86_64.whl:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150-py3-none-musllinux_1_2_x86_64.whl -
Subject digest:
d1c1eb6ca56435f368122a4c3e9469f16ce9119964b4aaf776a16d2d44bbcb59 - Sigstore transparency entry: 2586657902
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
File details
Details for the file power_grid_model-1.13.150-py3-none-musllinux_1_2_aarch64.whl.
File metadata
- Download URL: power_grid_model-1.13.150-py3-none-musllinux_1_2_aarch64.whl
- Upload date:
- Size: 3.8 MB
- Tags: Python 3, musllinux: musl 1.2+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f04b57513ec9938fb30a1aed6153fafa72e57344f32a2797096e0a420f80e52e
|
|
| MD5 |
6456793c48eeb9b02ff1b65a89e6a79d
|
|
| BLAKE2b-256 |
967483f29310c933a462a655854f0f8d0ece27e5285e0806eb6ea673b39e8a49
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150-py3-none-musllinux_1_2_aarch64.whl:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150-py3-none-musllinux_1_2_aarch64.whl -
Subject digest:
f04b57513ec9938fb30a1aed6153fafa72e57344f32a2797096e0a420f80e52e - Sigstore transparency entry: 2586660400
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
File details
Details for the file power_grid_model-1.13.150-py3-none-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: power_grid_model-1.13.150-py3-none-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 3.3 MB
- Tags: Python 3, manylinux: glibc 2.26+ x86-64, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
72903671554733aa7048ad805b1ea1956f4b79b5f6a8f7feb12c7f4c7fa87529
|
|
| MD5 |
5a25fe9303554a607d5b0eef64103776
|
|
| BLAKE2b-256 |
7cb10bb2b30ef4f2ab65691ef5049b4dae72e67f0beca4db1ab6e3e33a908970
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150-py3-none-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150-py3-none-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl -
Subject digest:
72903671554733aa7048ad805b1ea1956f4b79b5f6a8f7feb12c7f4c7fa87529 - Sigstore transparency entry: 2586659173
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
File details
Details for the file power_grid_model-1.13.150-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl.
File metadata
- Download URL: power_grid_model-1.13.150-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
- Upload date:
- Size: 3.0 MB
- Tags: Python 3, manylinux: glibc 2.24+ ARM64, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3ad43ab35a14e410cbfe8227b2dc0f4d75c3b5989ecc3e3329ab0c63143bffd8
|
|
| MD5 |
615b8f55251f3405c128228e05eca458
|
|
| BLAKE2b-256 |
b11e3c17ec5adcb66e2657a1b03066f4e890fb26f541db9952e6b14ec0bc751a
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl -
Subject digest:
3ad43ab35a14e410cbfe8227b2dc0f4d75c3b5989ecc3e3329ab0c63143bffd8 - Sigstore transparency entry: 2586657723
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
File details
Details for the file power_grid_model-1.13.150-py3-none-macosx_13_0_x86_64.whl.
File metadata
- Download URL: power_grid_model-1.13.150-py3-none-macosx_13_0_x86_64.whl
- Upload date:
- Size: 2.5 MB
- Tags: Python 3, macOS 13.0+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
81cf7cff7d957af2c4a31317e067381fbcea3752e1d46ad81bb07fd3507e25ff
|
|
| MD5 |
ab7ec3dd14a68d77d8754dbe33a44a10
|
|
| BLAKE2b-256 |
cd0c193ae37a09b8f3f825d802f84f76526f11c013811c4abdedb1c7c31124a1
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150-py3-none-macosx_13_0_x86_64.whl:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150-py3-none-macosx_13_0_x86_64.whl -
Subject digest:
81cf7cff7d957af2c4a31317e067381fbcea3752e1d46ad81bb07fd3507e25ff - Sigstore transparency entry: 2586658255
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
File details
Details for the file power_grid_model-1.13.150-py3-none-macosx_13_0_arm64.whl.
File metadata
- Download URL: power_grid_model-1.13.150-py3-none-macosx_13_0_arm64.whl
- Upload date:
- Size: 2.2 MB
- Tags: Python 3, macOS 13.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
05a4efd8c6fb4d1f0ec1bd720e24d406e1384ec893c33ffba7346afeea5740ee
|
|
| MD5 |
b30c13a7d5a4a2a907dbf134bb98d79b
|
|
| BLAKE2b-256 |
ec97d1137b9990c033aedc04db50120cf579772e4cdac38730951afa73eff606
|
Provenance
The following attestation bundles were made for power_grid_model-1.13.150-py3-none-macosx_13_0_arm64.whl:
Publisher:
ci.yml on PowerGridModel/power-grid-model
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
power_grid_model-1.13.150-py3-none-macosx_13_0_arm64.whl -
Subject digest:
05a4efd8c6fb4d1f0ec1bd720e24d406e1384ec893c33ffba7346afeea5740ee - Sigstore transparency entry: 2586659410
- Sigstore integration time:
-
Permalink:
PowerGridModel/power-grid-model@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PowerGridModel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@3c9c4b44ac8337b9b1f1c8caca7e00f8d9e97370 -
Trigger Event:
push
-
Statement type:
