H2Integrate
An open-source Python package for modeling and designing hybrid energy systems producing electricity, hydrogen, ammonia, steel, and other products.
https://github.com/nrel/h2integrate
Category: Energy Systems
Sub Category: Energy System Modeling Frameworks
Keywords from Contributors
wind openmdao systems-engineering wisdem wind-energy
Last synced: about 14 hours ago
JSON representation
Repository metadata
- Host: GitHub
- URL: https://github.com/nrel/h2integrate
- Owner: NREL
- License: other
- Created: 2024-10-07T15:12:46.000Z (8 months ago)
- Default Branch: develop
- Last Pushed: 2025-05-29T18:34:40.000Z (6 days ago)
- Last Synced: 2025-05-31T10:03:48.111Z (5 days ago)
- Language: PowerBuilder
- Homepage: https://h2integrate.readthedocs.io/
- Size: 539 MB
- Stars: 10
- Watchers: 6
- Forks: 18
- Open Issues: 62
- Releases: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
README.md
H2Integrate: Holistic Hybrids Optimization and Design Tool
H2Integrate is an open-source Python package for modeling and designing hybrid energy systems producing electricity, hydrogen, ammonia, steel, and other products.
Note: The current version of H2Integrate is under active development and may be missing features that existed previously. H2Integrate v0.2.0 is the last version that uses the prior framework.
Publications where H2Integrate has been used
For more context about H2Integrate and to see analyses that have been performed using the tool, please see some of these publications.
PDFs are available in the linked titles.
Nationwide techno-economic analysis of clean hydrogen production powered by a hybrid renewable energy plant for over 50,000 locations in the United States.
The levelized cost of hydrogen is calculated for varying technology costs, and tax credits to
explore cost sensitivities independent of plant design, performance, and site selection. Our
findings suggest that strategies for cost reduction include selecting sites with abundant wind
resources, complementary wind and solar resources, and optimizing the sizing of wind and solar
assets to maximize the hybrid plant capacity factor.
Grant, E., et al. "Hybrid power plant design for low-carbon hydrogen in the United States." Journal of Physics: Conference Series. Vol. 2767. No. 8. IOP Publishing, 2024.
Exploring the role of producing low-carbon hydrogen using water electrolysis powered by offshore wind in facilitating the United States’ transition to a net-zero emissions economy by 2050.
Conducting a regional techno-economic analysis at four U.S. coastal sites, the study evaluates two
energy transmission configurations and examines associated costs for the years 2025, 2030, and 2035.
The results highlight that locations using fixed-bottom technology may achieve cost-competitive
water electrolysis hydrogen production by 2030 through leveraging geologic hydrogen storage and
federal policy incentives.
Brunik, K., et al. "Potential for large-scale deployment of offshore wind-to-hydrogen systems in the United States." Journal of Physics: Conference Series. Vol. 2767. No. 6. IOP Publishing, 2024.
Examining how tightly-coupled gigawatt-scale wind- and solar-sourced H2 depends on the ability to store and deliver otherwise-curtailed H2 during times of shortages.
Modeling results suggest that the levelized cost of storage is highly spatially heterogeneous, with
minor impact on the cost of H2 in the Midwest, and potentially significant impact in areas with
emerging H2 economies such as Central California and the Southeast. While TOL/MCH may be the
cheapest aboveground bulk storage solution evaluated, upfront capital costs, modest energy
efficiency, reliance on critical materials, and greenhouse gas emissions from heating remain
concerns.
Breunig, Hanna, et al. "Hydrogen Storage Materials Could Meet Requirements for GW-Scale Seasonal Storage and Green Steel." (2024).
DOE Hydrogen Program review presentation of H2Integrate
King, J. and Hammond, S. "Integrated Modeling, TEA, and Reference Design for Renewable Hydrogen to Green Steel and Ammonia - GreenHEART" (2024).
Software requirements
- Python version 3.11, 3.12, 3.13 64-bit
- Other versions may still work, but have not been extensively tested at this time
Installing from Package Repositories
pip install h2integrate
Installing from Source
Easiest approach (recommended)
-
Using Git, navigate to a local target directory and clone repository:
git clone https://github.com/NREL/H2Integrate.git
-
Navigate to
H2Integrate
cd H2Integrate
-
Create a conda environment and install H2Integrate and all its dependencies
conda env create -f environment.yml
-
Install Cbc.
-
If using a Unix machine (not Windows), install a final dependency
conda install -y -c conda-forge coin-or-cbc=2.10.8
-
Windows users will have to manually install Cbc: https://github.com/coin-or/Cbc
-
An additional step can be added if additional dependencies are required, or you plan to use this
environment for development work.
- Pass
-e
for an editable developer install - Use one of the extra flags as needed:
examples
: allows you to use the Jupyter Notebooksdevelop
: adds developer and documentation toolsall
simplifies adding all the dependencies
This looks like the following for a developer installation:
pip install -e ".[all]"
Customizable
-
Using Git, navigate to a local target directory and clone repository:
git clone https://github.com/NREL/H2Integrate.git
-
Navigate to
H2Integrate
cd H2Integrate
-
Create a new virtual environment and change to it. Using Conda Python 3.11 (choose your favorite
supported version) and naming it 'h2integrate' (choose your desired name):conda create --name h2integrate python=3.11 -y conda activate h2integrate
-
Install H2Integrate and its dependencies:
conda install -y -c conda-forge glpk
Note: Unix users should install Cbc via:
conda install -y -c conda-forge coin-or-cbc=2.10.8
Windows users will have to manually install Cbc: https://github.com/coin-or/Cbc.
-
If you want to just use H2Integrate:
pip install .
-
If you want to work with the examples:
pip install ".[examples]"
-
If you also want development dependencies for running tests and building docs:
pip install -e ".[develop]"
Please be sure to also install the pre-commit hooks if contributing code back to the main
repository via the following. This enables a series of automated formatting and code linting
(style and correctness checking) to ensure the code is stylistically consistent.pre-commit install
If a check (or multiple) fails (commit is blocked), and reformatting was done, then restage
(git add
) your files and commit them again to see if all issues were resolved without user
intervention. If changes are required follow the suggested fix, or resolve the stated
issue(s). Restaging and committing may take multiple attempts steps if errors are unaddressed
or insufficiently addressed. Please see pre-commit,
ruff, or isort for more
information. -
In one step, all dependencies can be installed as:
pip install -e ".[all]"
-
-
The functions which download resource data require an NREL API key. Obtain a key from:
-
To set up the
NREL_API_KEY
andNREL_API_EMAIL
required for resource downloads, you can create
Environment Variables calledNREL_API_KEY
andNREL_API_EMAIL
. Otherwise, you can keep the key
in a new file called ".env" in the root directory of this project.Create a file ".env" that contains the single line:
NREL_API_KEY=key NREL_API_EMAIL=[email protected]
-
Verify setup by running tests:
pytest
-
To set up
NREL_API_KEY
for resource downloads, first refer to section 7 and 8 above. But for
the.env
file method, the file should go in the working directory of your Python project, e.g.
directory from where you runpython
.
Parallel processing for H2Integrate finite differences and design of experiments
H2Integrate is set up to run in parallel using MPI and PETSc for finite differencing and for design
of experiments runs through OpenMDAO. To use this capability you will need to follow the additional
installation
instruction below:
conda install -c conda-forge mpi4py petsc4py
For more details on implementation and installation, reference the documentation for OpenMDAO.
To check that your installation is working, do the following:
cd tests/h2integrate/
mpirun -n 2 pytest test_openmdao_mpi.py
Getting Started
The Examples contain Jupyter notebooks and sample YAML files for common usage
scenarios in H2Integrate. These are actively maintained and updated to demonstrate H2Integrate's
capabilities. For full details on simulation options and other features, documentation is
forthcoming.
Contributing
Interested in improving H2Integrate? Please see the Contributor's Guide
section for more information.
Owner metadata
- Name: National Renewable Energy Laboratory
- Login: NREL
- Email:
- Kind: organization
- Description:
- Website: http://www.nrel.gov
- Location: Golden, CO
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/1906800?v=4
- Repositories: 599
- Last ynced at: 2024-12-18T09:41:07.898Z
- Profile URL: https://github.com/NREL
GitHub Events
Total
- Create event: 3
- Issues event: 14
- Release event: 2
- Watch event: 5
- Delete event: 2
- Issue comment event: 8
- Push event: 35
- Pull request review comment event: 61
- Pull request review event: 59
- Pull request event: 39
- Fork event: 1
Last Year
- Create event: 3
- Issues event: 14
- Release event: 2
- Watch event: 5
- Delete event: 2
- Issue comment event: 8
- Push event: 35
- Pull request review comment event: 61
- Pull request review event: 59
- Pull request event: 39
- Fork event: 1
Committers metadata
Last synced: 26 days ago
Total Commits: 1,529
Total Committers: 32
Avg Commits per committer: 47.781
Development Distribution Score (DDS): 0.785
Commits in past year: 273
Committers in past year: 9
Avg Commits per committer in past year: 30.333
Development Distribution Score (DDS) in past year: 0.736
Name | Commits | |
---|---|---|
Jared Thomas | j****8@g****m | 328 |
kbrunik | k****k@g****m | 217 |
dguittet | d****t@n****v | 148 |
Evan | E****k@n****v | 129 |
bayc | c****y@g****m | 108 |
Aaron Barker | b****9@g****m | 103 |
elenya-grant | 1****t | 78 |
RHammond2 | 1****2 | 72 |
Cameron Irmas | c****s@p****m | 51 |
Masha | m****a@n****v | 45 |
John Jasa | j****1@g****m | 36 |
nriccobo | N****o@n****v | 32 |
Cory Frontin | c****n@n****v | 28 |
Genevieve Starke | G****e@n****v | 26 |
WHamilt2 | w****n@n****v | 24 |
King | j****g@n****v | 18 |
Matthew Boyd | m****d@g****m | 17 |
jmartin4nrel | j****n@n****v | 16 |
PJ Stanley | a****y@n****v | 13 |
Bhaskar | p****r@n****v | 9 |
svijaysh | s****h@n****v | 6 |
Jamie | J****e@n****v | 6 |
AbhineetGupta | a****a@n****v | 5 |
Kiefer | c****r@n****v | 3 |
jlcox119 | j****x@m****u | 3 |
Dakota Sky Ramos | 8****s | 2 |
Caitlyn E. Clark, PhD | c****k@n****v | 1 |
Charles Kiefer | 1****4 | 1 |
Jamie | j****e@g****m | 1 |
King | j****i@j****v | 1 |
and 2 more... |
Committer domains:
- nrel.gov: 16
- .nrel.gov: 1
- jannoni-31697s.nrel.gov: 1
- mines.edu: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 78
Total pull requests: 88
Average time to close issues: 13 days
Average time to close pull requests: 5 days
Total issue authors: 9
Total pull request authors: 8
Average comments per issue: 0.69
Average comments per pull request: 0.7
Merged pull request: 72
Bot issues: 0
Bot pull requests: 0
Past year issues: 78
Past year pull requests: 88
Past year average time to close issues: 13 days
Past year average time to close pull requests: 5 days
Past year issue authors: 9
Past year pull request authors: 8
Past year average comments per issue: 0.69
Past year average comments per pull request: 0.7
Past year merged pull request: 72
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- johnjasa (59)
- kbrunik (5)
- jmartin4nrel (4)
- bayc (3)
- jaredthomas68 (2)
- ZackTully (2)
- dakotaramos (1)
- elenya-grant (1)
- RHammond2 (1)
Top Pull Request Authors
- johnjasa (31)
- jaredthomas68 (21)
- RHammond2 (19)
- jmartin4nrel (7)
- bayc (4)
- elenya-grant (3)
- kbrunik (2)
- dakotaramos (1)
Top Issue Labels
- h2integrate (19)
- enhancement (5)
- medium priority (3)
- code cleanup (3)
- low priority (2)
- question (2)
- high priority (2)
- bug (1)
- complete awaiting release (1)
- documentation (1)
Top Pull Request Labels
- enhancement (10)
- documentation (9)
- code cleanup (7)
- high priority (7)
- release (5)
- h2integrate (2)
- low priority (1)
- medium priority (1)
Package metadata
- Total packages: 1
-
Total downloads:
- pypi: 217 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 2
- Total maintainers: 2
pypi.org: h2integrate
Holistic Hybrids Optimization and Design Tool
- Homepage:
- Documentation: https://h2integrate.readthedocs.io/
- Licenses: **Note: The ProFAST model is distributed with H2Integrate but operates under a separate license agreement. Users must agree to the license terms of ProFAST located at `ProFAST/InternalUseTermsForDownloadableSoftware-ProFAST.docx`.** BSD 3-Clause License Copyright (c) 2024, Alliance for Sustainable Energy, LLC All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- Latest release: 0.3.0 (published about 1 month ago)
- Last Synced: 2025-06-03T14:00:52.853Z (1 day ago)
- Versions: 2
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 217 Last month
-
Rankings:
- Dependent packages count: 9.338%
- Average: 30.969%
- Dependent repos count: 52.6%
- Maintainers (2)
Dependencies
- actions/checkout v3 composite
- actions/setup-python v3 composite
- actions/checkout v2 composite
- conda-incubator/setup-miniconda v2 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- pypa/gh-action-pypi-publish release/v1 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- pypa/gh-action-pypi-publish release/v1 composite
- CoolProp *
- Cython *
- HOPP >=3.0
- NREL-PySAM ==4.2.0
- Pillow *
- Plotly *
- Pyomo >=6.1.2
- attrs *
- diskcache *
- fastkml *
- floris *
- future *
- global_land_mask *
- humpday *
- hybridbosse *
- lcoe *
- lxml *
- matplotlib *
- multiprocessing-on-dill *
- nevergrad *
- numpy *
- numpy-financial *
- openmdao [all]
- openpyxl *
- optuna *
- orbit-nrel >=1.1
- pandas >=2.0.3
- pint *
- plotly *
- pvmismatch *
- pyDOE2 *
- pymoo *
- pyproj *
- pysolar *
- pysot *
- python-dotenv *
- python-rapidjson *
- pytz *
- rainflow *
- requests *
- scikit-learn *
- scikit-optimize *
- scipy *
- setuptools *
- shapely *
- timezonefinder *
- urllib3 *
- utm *
Score: 13.131473751632283