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.
Release files for power-grid-model 1.13.169
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| power_grid_model-1.13.169.tar.gz | 1.6 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| power_grid_model-1.13.169-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| power_grid_model-1.13.169-py3-none-musllinux_1_2_x86_64.whl | Python 3 | none | Linux musl 1.2+ x86-64 | Details |
| power_grid_model-1.13.169-py3-none-musllinux_1_2_aarch64.whl | Python 3 | none | Linux musl 1.2+ ARM64 | Details |
| power_grid_model-1.13.169-py3-none-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.26+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| power_grid_model-1.13.169-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64, Linux glibc 2.24+ ARM64 | Details |
| power_grid_model-1.13.169-py3-none-macosx_13_0_x86_64.whl | Python 3 | none | macOS 13.0+ x86-64 | Details |
| power_grid_model-1.13.169-py3-none-macosx_13_0_arm64.whl | Python 3 | none | macOS 13.0+ ARM64 | Details |
Total release size: 21.7 MB
Release files / power_grid_model-1.13.169.tar.gz
| Download URL | power_grid_model-1.13.169.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
83cea54ef0954eae479def756548d40d316972fb05887ab6753f91962065a471
|
|
BLAKE2b-256 checksum How to use checksums |
724c60b89fcf9dd85326dbef0cd65ced7501bae59621d92ef9197dfbab773ba6
|
| 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 Sep 10, 2026.
Transparency logRelease files / power_grid_model-1.13.169-py3-none-win_amd64.whl
| Download URL | power_grid_model-1.13.169-py3-none-win_amd64.whl |
|---|---|
| Size | 926.2 kB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
5d8fa820e4d092e7e53b956e53b13aff4f56952d7f1c1f48cb48bc7c367460b3
|
|
BLAKE2b-256 checksum How to use checksums |
11b49c7cea356bddb796bdaa4232d1dc7a84ca7052c73373d03bd9b1ff333aad
|
| 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 Sep 10, 2026.
Transparency logRelease files / power_grid_model-1.13.169-py3-none-musllinux_1_2_x86_64.whl
| Download URL | power_grid_model-1.13.169-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
b6c2c0892771f8b7e914c765dd6815fed9accb203241a2e29f1f2834f17e0a41
|
|
BLAKE2b-256 checksum How to use checksums |
089c78732ca999593781e008efacfade471014c7910d07ddc6fde893f21c866d
|
| 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 Sep 10, 2026.
Transparency logRelease files / power_grid_model-1.13.169-py3-none-musllinux_1_2_aarch64.whl
| Download URL | power_grid_model-1.13.169-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 3.9 MB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
1ac262e96ed08888afa173e80662708690af3de23cdba0c1c5f7963365ad8d88
|
|
BLAKE2b-256 checksum How to use checksums |
b9e2d80249aff52b151a031a8f29715f0c00e1223ab3574082026cc521feb5e1
|
| 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 Sep 10, 2026.
Transparency logRelease files / power_grid_model-1.13.169-py3-none-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl
| Download URL | power_grid_model-1.13.169-py3-none-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | Linux glibc 2.26+ x86-64 Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
d97a79e97635a847b28f79224cafb5f2a1340fbf29e0b6f5e58817217b1c34ae
|
|
BLAKE2b-256 checksum How to use checksums |
62b6a3c5fc1abff0ba7f8fa9dec24eff6391ca18332a1774677ab7149ea7f764
|
| 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 Sep 10, 2026.
Transparency logRelease files / power_grid_model-1.13.169-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
| Download URL | power_grid_model-1.13.169-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
343ba4c037d566a5dd8b4db80ce58f07e2064664b3b12a20c40bd9d133365ac3
|
|
BLAKE2b-256 checksum How to use checksums |
b8b6aceec10bd2a9e0dbbf4475656ff27019955a4c08021ba607f59706441cf2
|
| 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 Sep 10, 2026.
Transparency logRelease files / power_grid_model-1.13.169-py3-none-macosx_13_0_x86_64.whl
| Download URL | power_grid_model-1.13.169-py3-none-macosx_13_0_x86_64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Python 3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
9d2b2ad1e61a31e2c34eebe2817a917b2eba719203423a18eea651b6fc96578b
|
|
BLAKE2b-256 checksum How to use checksums |
ad27cf938ea3bcf413c546eeb80d2e94ef00461296400ada754e4c6c51bc1ef1
|
| 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 Sep 10, 2026.
Transparency logRelease files / power_grid_model-1.13.169-py3-none-macosx_13_0_arm64.whl
| Download URL | power_grid_model-1.13.169-py3-none-macosx_13_0_arm64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | Python 3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3e5e78a33abc96b6f76e36b058885321ace523c25f044ea10f1c192ec5897d91
|
|
BLAKE2b-256 checksum How to use checksums |
53a696abe084852c11bc182914dd96912e052ee6eb5e14ad6d60292ad064b178
|
| 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 Sep 10, 2026.
Transparency log
