GridPACK

An open-source high-performance package for simulation of large-scale electrical grids.
https://github.com/gridoptics/gridpack

Category: Energy Systems
Sub Category: Grid Analysis and Planning

Keywords from Contributors

petsc parallel-computing e3sm-model ngee-arctic pflotran power-systems

Last synced: about 2 hours ago
JSON representation

Repository metadata

Host: GitHub
URL: https://github.com/gridoptics/gridpack
Owner: GridOPTICS
Created: 2014-07-22T21:01:57.000Z (over 11 years ago)
Default Branch: develop
Last Pushed: 2026-04-02T20:00:20.000Z (5 days ago)
Last Synced: 2026-04-03T21:31:26.526Z (4 days ago)
Language: C++
Homepage: https://gridpack.readthedocs.io/en/latest/index.html
Size: 112 MB
Stars: 61
Watchers: 15
Forks: 25
Open Issues: 23
Releases: 6
Metadata Files:
- Readme: README.md

GridPACK: High-Performance Electric Grid Simulation

Repo: https://github.com/gridoptics/gridpack
Issues: https://github.com/GridOPTICS/GridPACK/issues
Releases: https://github.com/GridOPTICS/GridPACK/releases

About

GridPACK is an open-source high-performance (HPC) package for simulation of large-scale electrical grids. Powered by distributed (parallel) computing and high-performance numerical solvers, GridPACK offers several applications forfast simulation of electrical transmission systems. GridPACK includes a number of prebuilt applications that can be directly used. The most commonly used and well-developed are:

AC Power Flow
Dynamics Simulation
Contingency Analysis
State Estimation

Other applications under development or not full featured are

Dynamic security assessment
Electromagnetic transient (EMT) simulation

In addition, GridPACK is also a framework to simplify the development of new applications on HPC platforms. To ease the development, GridPACK offers several building blocks such as setting up and distributing (partitioning) power grid networks, support for custom components on buses and branches, converting the network models to the corresponding algebraic equations, parallel routines for manipulating and solving large algebraic systems, and input and output modules as well as basic profiling and error management. GridPACK is written in C++ with python wrappers available.

Installation

See the instructions for installing GridPACK, prerequisite software, and installation notes for different platforms. Formal releases are available here.

Using Docker (Recommended)

GridPACK is available as a multi-architecture Docker image with all dependencies pre-installed:

# Pull the image
docker pull pnnl/gridpack:latest

# Run with your files (container starts in /app/workspace)
docker run -it --rm -v $(pwd):/app/workspace pnnl/gridpack:latest bash

# Run a specific semantic version
docker run -it --rm -v $(pwd):/app/workspace pnnl/gridpack:v3.6 bash

The Docker image supports both AMD64 and ARM64 architectures. See the Docker usage guide for more examples.

Building from Source

See the installation instructions for building GridPACK from source, prerequisite software, and platform-specific installation notes. Formal releases are available here.

Usage

See the user manual for a deep dive on GridPACK internals and/or refer to the tutorials for more info.

Quick Guide (To do)

Documentation

Contact us

The best (and fastest) way to reach us for any technical questions is by posting an issue here. You can also reach us via email gridpack.account@pnnl.gov.

Citing GridPACK

@article{doi:10.1177/1094342015607609, 
  author = {Bruce Palmer and William Perkins and Yousu Chen and Shuangshuang Jin and David C allahan and Kevin Glass and Ruisheng Diao and Mark Rice and Stephen Elbert and Mallikarjun a Vallem and Zhenyu Huang}, 
  title ={GridPACKTM: A framework for developing power grid simulations on high-performance computing platforms}, 
  journal = {The International Journal of High Performance Computing Applications}, 
  volume = {30}, 
  number = {2}, 
  pages = {223-240}, 
  year = {2016}, 
  doi = {10.1177/1094342015607609}, 
  URL = {https://doi.org/10.1177/1094342015607609}, 
  eprint = {https://doi.org/10.1177/1094342015607609}
}

Authors

Bruce Palmer
William Perkins
Yousu Chen
Renke Huang
Yuan Liu
Shuangshuang Jin
Shrirang Abhyankar

Acknowledgement

GridPACK has been developed through funding from various sources over the years.

PNNL LDRD Future Grid Initiative
DOE OE Advanced Grid Modeling (AGM) program
Grid Modernization Laboratory Consortium
DOE EERE Solar Energy Technologies Office
DOE EERE Wind Energy Technologies Office

Copyright

GridPACKTM is a free software distributed under a BSD 2-clause license. You may reuse, modify, and redistribute the software.

See the license file for details.

Disclaimer

The Software was produced by Battelle under Contract No. DE-AC05-76RL01830 with
the Department of Energy. For five years from October 10, 2013, the Government is granted
for itself and others acting on its behalf a nonexclusive, paid-up, irrevocable worldwide license in this data to reproduce, prepare derivative works, and perform publicly and display
publicly, by or on behalf of the Government. There is provision for the possible extension
of the term of this license. Subsequent to that period or any extension granted, the Government is granted for itself and others acting on its behalf a nonexclusive, paid-up, irrevocable
worldwide license in this data to reproduce, prepare derivative works, distribute copies to
the public, perform publicly and display publicly, and to permit others to do so. The specific
term of the license can be identified by inquiry made to Battelle or DOE. Neither the United
States nor the United States Department of Energy, nor any of their employees, makes any
warranty, express or implied, or assumes any legal liability or responsibility for the accuracy,
completeness or usefulness of any data, apparatus, product or process disclosed, or represents that its use would not infringe privately owned rights.

Owner metadata

Name: GridOPTICS
Login: GridOPTICS
Email:
Kind: organization
Description:
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/6787372?v=4
Repositories: 30
Last ynced at: 2024-05-07T18:10:37.079Z
Profile URL: https://github.com/GridOPTICS

GitHub Events

Total

Release event: 1
Delete event: 10
Member event: 1
Pull request event: 36
Fork event: 3
Issues event: 13
Watch event: 11
Issue comment event: 35
Push event: 172
Pull request review event: 24
Pull request review comment event: 23
Create event: 30

Last Year

Release event: 1
Delete event: 6
Member event: 1
Pull request event: 15
Fork event: 2
Issues event: 9
Watch event: 7
Issue comment event: 16
Push event: 70
Create event: 14

Committers metadata

Last synced: 2 days ago

Total Commits: 2,777
Total Committers: 55
Avg Commits per committer: 50.491
Development Distribution Score (DDS): 0.803

Commits in past year: 139
Committers in past year: 11
Avg Commits per committer in past year: 12.636
Development Distribution Score (DDS) in past year: 0.554

Name	Email	Commits
William Perkins	w**s@p**v	546
bruce	b****e	525
Bruce J Palmer	d**3@c**v	262
billp	b****p	216
Bruce J Palmer	d**3@c**v	213
Shri Abhyankar	s**i@p**v	158
Bruce J Palmer	d**3@o**l	125
bjpalmer	d**3@p**v	96
huan495	r**g@p**v	68
Your Name	y**n@p**v	67
Bruce J Palmer	d**3@c**v	64
Jed Brown	j**d@5**g	47
bjpalmer	d**3@p**v	45
chen	c****n	45
Yilin Fang	d**5@j**v	36
Thom Williams	t**s@p**v	34
Yousu Chen	d**8@g**v	32
jin	j****n	31
Renke Huang	h**e@g**m	31
kevin	k****n	25
bjpalmer	b****r	18
dave_c	d****c	15
Palmer	d**3@w**v	9
Bruce J Palmer	d**3@c**v	9
yliu250	y**u@p**v	7
Bruce J Palmer	d**3@d**v	4
Shuangshuang Jin	j**6@l**u	4
GlazerMann	k**t@i**m	3
Bruce J Palmer	d**3@c**v	3
Bruce J Palmer	d**3@c**v	3
and 25 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 79
Total pull requests: 126
Average time to close issues: over 1 year
Average time to close pull requests: 3 months
Total issue authors: 20
Total pull request authors: 12
Average comments per issue: 3.94
Average comments per pull request: 1.21
Merged pull request: 96
Bot issues: 0
Bot pull requests: 0

Past year issues: 1
Past year pull requests: 16
Past year average time to close issues: 23 days
Past year average time to close pull requests: 16 days
Past year issue authors: 1
Past year pull request authors: 5
Past year average comments per issue: 0.0
Past year average comments per pull request: 0.38
Past year merged pull request: 11
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/gridoptics/gridpack

Top Issue Authors

abhyshr (25)
bjpalmer (16)
wperkins (14)
lzheng28 (4)
pelesh (3)
eshoubak (2)
diaoruisheng (2)
rahmanha (1)
zzzoom (1)
yliu250 (1)
sumathil (1)
jacksavage (1)
Triangel000 (1)
temcdrm (1)
cpslab-nsu (1)

Top Pull Request Authors

abhyshr (56)
bjpalmer (21)
wperkins (21)
yliu250 (7)
chenyousu (6)
GlazerMann (3)
jacksavage (3)
yasirroni (2)
tank723 (2)
ta7mid (2)
jainmilan (2)
tahmid-khan (1)

Top Issue Labels

python (6)
bug (5)
enhancement (5)
dynamic simulation (4)
parser (3)
cleanup (2)
testing (2)
documentation (1)
cmake (1)

Top Pull Request Labels

enhancement (16)
python (13)
dynamic simulation (13)
cleanup (7)
bug (3)
documentation (3)
cmake (2)
environment (2)
testing (1)
state estimation (1)
power flow (1)

Dependencies

python/setup.py pypi

.github/workflows/docker-build.yml actions

actions/checkout v4 composite
actions/download-artifact v4 composite
actions/upload-artifact v4 composite
docker/build-push-action v5 composite
docker/login-action v3 composite
docker/metadata-action v5 composite
docker/setup-buildx-action v3 composite

Dockerfile docker

ubuntu questing build

python/pyproject.toml pypi

docs/user_manual/sphinx/requirements.txt pypi

sphinx-subfigure *
sphinx_rtd_theme *

Score: 8.438149984075785

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology