pypsa-usa
An open-source power systems model of the bulk transmission systems in the United States.
https://github.com/PyPSA/pypsa-usa
Category: Energy Systems
Sub Category: Global and Regional Energy System Models
Keywords from Contributors
energy-system-model energy-system climate-change energy-model
Last synced: about 9 hours ago
JSON representation
Repository metadata
PyPSA-USA: An Open-Source Energy System Optimization Model for the United States
- Host: GitHub
- URL: https://github.com/PyPSA/pypsa-usa
- Owner: PyPSA
- License: mit
- Created: 2022-06-07T15:13:26.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2026-08-17T19:22:13.000Z (3 days ago)
- Last Synced: 2026-08-19T17:05:53.062Z (1 day ago)
- Language: Python
- Homepage: https://pypsa-usa.readthedocs.io
- Size: 201 MB
- Stars: 144
- Watchers: 7
- Forks: 55
- Open Issues: 110
- Releases: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Citation: CITATION.cff
README.md
PyPSA-USA: An Open-Source Energy System Optimization Model for the United States
See our readthedocs for installation and usage instructions.
PyPSA-USA is an open-source power systems model of the bulk transmission systems in the United States. This workflow draws from the work of pypsa-eur to build a highly configurable power systems model that can be used for capacity expansion modeling, production cost simulation, and power flow analysis.

Contributing
We welcome your contributions to this project. Please see the contributions guide in our readthedocs page for more information. Please do not hesitate to reachout to ktehranchi@stanford.edu with specific questions, requests, or feature ideas.
License
The project is licensed under MIT License.
Citation
See the CITATION.cff and github citation button on the right to generate your citation.
Citation (CITATION.cff)
cff-version: 1.2.0 message: "If you use this software, please cite it as below." title: "PyPSA-USA: An Open-Source Energy System Optimization Model for the United States" version: 0.0.1 repository: https://github.com/PyPSA/pypsa-usa license: MIT authors: - family-names: "Tehranchi" given-names: "Kamran" orchid: https://orcid.org/0009-0009-6186-6426 - family-names: "Barnes" given-names: "Trevor" orchid: https://orcid.org/0000-0003-2458-2968 - family-names: "Frysztacki" given-names: "Martha" - family-names: "Hofmann" given-names: "Fabian" - family-names: "Azevedo" given-names: "Inês L." doi: 10.5281/zenodo.10815964
Owner metadata
- Name: PyPSA
- Login: PyPSA
- Email:
- Kind: organization
- Description: Python for Power System Analysis
- Website: www.pypsa.org
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/32890768?v=4
- Repositories: 29
- Last ynced at: 2024-03-26T13:25:46.062Z
- Profile URL: https://github.com/PyPSA
GitHub Events
Total
- Create event: 77
- Delete event: 65
- Fork event: 19
- Gollum event: 1
- Issue comment event: 204
- Issues event: 185
- Member event: 5
- Pull request event: 260
- Pull request review comment event: 79
- Pull request review event: 70
- Push event: 275
- Release event: 5
- Watch event: 48
Last Year
- Create event: 15
- Delete event: 11
- Fork event: 4
- Issue comment event: 51
- Issues event: 30
- Member event: 2
- Pull request event: 35
- Pull request review comment event: 8
- Pull request review event: 4
- Push event: 95
- Release event: 1
- Watch event: 14
Committers metadata
Last synced: 1 day ago
Total Commits: 1,894
Total Committers: 15
Avg Commits per committer: 126.267
Development Distribution Score (DDS): 0.536
Commits in past year: 33
Committers in past year: 6
Avg Commits per committer in past year: 5.5
Development Distribution Score (DDS) in past year: 0.455
| Name | Commits | |
|---|---|---|
| ktehranchi | 8****i | 879 |
| trevorb1 | t****s@s****a | 767 |
| pre-commit-ci[bot] | 6****] | 126 |
| martacki | m****i@k****u | 44 |
| Fabian | f****f@g****e | 25 |
| Flypig12 | 8****2 | 19 |
| Stephen Young | s****g@s****m | 16 |
| Asia Zhang | a****z@g****m | 6 |
| Chen Chen | c****n@g****m | 4 |
| nomineb | 1****b | 2 |
| Wei Ai | w****w@g****m | 2 |
| aljubrmj | m****n@g****m | 1 |
| Henry Daniels-Koch | h****h@g****m | 1 |
| Copilot | 1****t | 1 |
| trevorb1 | t****r@s****a | 1 |
Committer domains:
- srye-deltae-06.see.sfu.ca: 1
- signal-ai.com: 1
- gmx.de: 1
- kit.edu: 1
- sfu.ca: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 353
Total pull requests: 561
Average time to close issues: 2 months
Average time to close pull requests: 8 days
Total issue authors: 22
Total pull request authors: 21
Average comments per issue: 0.76
Average comments per pull request: 0.52
Merged pull request: 461
Bot issues: 0
Bot pull requests: 46
Past year issues: 27
Past year pull requests: 52
Past year average time to close issues: 14 days
Past year average time to close pull requests: 19 days
Past year issue authors: 6
Past year pull request authors: 12
Past year average comments per issue: 0.93
Past year average comments per pull request: 0.65
Past year merged pull request: 25
Past year bot issues: 0
Past year bot pull requests: 5
Top Issue Authors
- trevorb1 (192)
- ktehranchi (107)
- WeiAi-Energy (10)
- casinocullen (8)
- jpvelez (5)
- apigott (4)
- ricnogfer (3)
- nomineb (3)
- lfreese (3)
- aljubrmj (3)
- huainie (2)
- Mailisyorlik (2)
- degleris1 (2)
- JB3NNETT (1)
- jaclynr109 (1)
Top Pull Request Authors
- trevorb1 (231)
- ktehranchi (212)
- pre-commit-ci[bot] (46)
- WeiAi-Energy (20)
- asiazzzhang (9)
- aljubrmj (6)
- casinocullen (6)
- hdanielskoch (5)
- stephendeyoung (4)
- nomineb (4)
- WilsonHM18 (3)
- ricnogfer (3)
- mchjones (3)
- lfreese (2)
- apigott (1)
Top Issue Labels
- enhancement (168)
- bug (132)
- Sector (65)
- documentation (13)
- good first issue (11)
- question (5)
Top Pull Request Labels
- enhancement (6)
- documentation (1)
- bug (1)
Package metadata
- Total packages: 2
- Total downloads: unknown
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 18
proxy.golang.org: github.com/PyPSA/pypsa-usa
- Homepage:
- Documentation: https://pkg.go.dev/github.com/PyPSA/pypsa-usa#section-documentation
- Licenses: mit
- Latest release: v0.8.0 (published 6 months ago)
- Last Synced: 2026-08-19T17:06:56.207Z (1 day ago)
- Versions: 9
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.395%
- Average: 5.576%
- Dependent repos count: 5.758%
proxy.golang.org: github.com/pypsa/pypsa-usa
- Homepage:
- Documentation: https://pkg.go.dev/github.com/pypsa/pypsa-usa#section-documentation
- Licenses: mit
- Latest release: v0.8.0 (published 6 months ago)
- Last Synced: 2026-08-19T17:11:27.187Z (1 day ago)
- Versions: 9
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.395%
- Average: 5.576%
- Dependent repos count: 5.758%
Dependencies
- atlite >=0.2.9
- cartopy *
- dask *
- matplotlib *
- myst-parser *
- plotly *
- pydata-sphinx-theme *
- pypsa *
- pyyaml *
- scikit-learn *
- seaborn *
- snakemake *
- sphinx-book-theme *
- sphinxcontrib-bibtex *
- actions/cache v3 composite
- actions/checkout v3 composite
- actions/upload-artifact v4.3.0 composite
- mamba-org/setup-micromamba v1 composite
- atlite 0.3.0
- cartopy 0.23.0
- country_converter 1.0.0
- cyipopt
- dask >=2023.7.0
- descartes 1.1.0
- geopandas 1.0.1
- geopy 2.4.0
- graphviz
- ipykernel 6.25.2
- ipython 8.16.1
- jupyter 1.0.0
- linopy 0.3.14
- lxml 4.9.3
- matplotlib 3.8.0
- memory_profiler 0.61.0
- netcdf4 1.6.4
- networkx 3.1
- notebook 7.0.6
- numpy 1.26.0
- openpyxl 3.1.2
- pandas 2.2.2
- pip
- plotly 5.17.0
- progressbar2 4.3.2
- pyarrow 16.1.0
- pycountry 22.3.5
- pyomo 6.6.1
- pypsa 0.30.2
- pytables 3.9.1
- python 3.11.9
- rasterio 1.3.8
- scipy 1.11.3
- seaborn 0.13.2
- shapely 2.0.2
- snakemake-minimal 7.32.4
- tqdm 4.66.1
- xarray 2024.9.0
- xlrd 2.0.1
- yaml 0.2.5
- 198 dependencies
- atlite ==0.3.0
- cartopy ==0.23.0
- dask ==2024.12.0
- dask-expr ==1.1.20
- descartes ==1.1.0
- dill >=0.3.9
- distributed ==2024.12.0
- duckdb ==0.10.0
- geopandas ==1.0.1
- geopy ==2.4.0
- graphviz >=0.20.3
- gurobipy ==11.0.3
- highspy >=1.9.0
- linopy ==0.3.14
- matplotlib ==3.8.0
- netcdf4 ==1.6.4
- networkx ==3.1
- numpy ==1.26.0
- openpyxl ==3.1.2
- pandas ==2.2.2
- plotly ==5.17.0
- pre-commit >=4.1.0
- progressbar2 ==4.3.2
- pulp ==2.7.0
- pyarrow ==16.1.0
- pycountry ==22.3.5
- pyomo ==6.6.1
- pypsa ==0.30.2
- pyyaml >=6.0.2
- rasterio ==1.3.8
- scipy ==1.11.3
- seaborn ==0.13.2
- shapely ==2.0.2
- snakemake ==7.32.4
- tsam >=2.3.6
- xarray ==2024.9.0
- xlrd ==2.0.1
Score: -Infinity