Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions docs/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,16 +69,19 @@ Results from these simulations are then processed across the project's lifecycle
Depending on the models used and the size of the system, H2Integrate can simulate systems ranging from the kW to GW scale in seconds on a personal computer.
Additionally, H2Integrate tracks the flow of electricity, molecules (e.g., hydrogen, ammonia, methanol), and other products (e.g., steel) between different technologies in the energy system.

For each technology there are 4 different types of models: control, performance, cost, and finance. These model categories allow for modular pieces to be brought in or re-used throughout H2Integrate, as well as ease of development and organization. Note that the only required models for a technology are performance and cost, while control and finance are optional. The figure below shows these four categories and some of the technologies included in H2Integrate. For a full list of models available, please see [Model Overview](user_guide/model_overview.md).
Copy link

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There’s an extra space in “ease of” that should be removed to avoid rendering/editing artifacts.

Suggested change
For each technology there are 4 different types of models: control, performance, cost, and finance. These model categories allow for modular pieces to be brought in or re-used throughout H2Integrate, as well as ease of development and organization. Note that the only required models for a technology are performance and cost, while control and finance are optional. The figure below shows these four categories and some of the technologies included in H2Integrate. For a full list of models available, please see [Model Overview](user_guide/model_overview.md).
For each technology there are 4 different types of models: control, performance, cost, and finance. These model categories allow for modular pieces to be brought in or re-used throughout H2Integrate, as well as ease of development and organization. Note that the only required models for a technology are performance and cost, while control and finance are optional. The figure below shows these four categories and some of the technologies included in H2Integrate. For a full list of models available, please see [Model Overview](user_guide/model_overview.md).

Copilot uses AI. Check for mistakes.
![A representation of a single technology model in H2Integrate](tech-model.png)
Copy link

Copilot AI Feb 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For consistency with the existing image reference on line 81, consider adding the "./" prefix to the image path. The splash_image.png reference uses "./splash_image.png" while this new reference uses "tech-model.png" without the prefix. While both may work, consistency in image path formatting improves maintainability.

Copilot uses AI. Check for mistakes.

H2Integrate models hybrid energy systems by:
- Generating electricity output profiles from renewable energy sources (e.g., wind, solar, hydro) and storage systems (e.g., batteries, pumped hydro, vanadium flow batteries)
- Modeling the performance of hydrogen electrolyzers, steel furnaces, methanol plants, or ammonia synthesis systems using the generated electricity profiles
- Performing techno-economic analysis of the system to evaluate its costs and financial viability
The individual technology models are then connected to create the hybrid system model, as shown in the simplistic example below. Here, data from the performance, cost, and finance models of the grid and battery technologies feed into the overall system performance and finance calculations. There is also a physical connection between the grid and battery performance models in the form of an electrical cable. Lastly, within the battery technology, the control model and performance models are connected for dispatching of electricity.
![A representation of a system model in H2Integrate](system-model.png)
Copy link

Copilot AI Feb 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For consistency with the existing image reference on line 81, consider adding the "./" prefix to the image path. The splash_image.png reference uses "./splash_image.png" while this new reference uses "system-model.png" without the prefix. While both may work, consistency in image path formatting improves maintainability.

Suggested change
![A representation of a system model in H2Integrate](system-model.png)
![A representation of a system model in H2Integrate](./system-model.png)

Copilot uses AI. Check for mistakes.
Comment on lines +73 to +76
Copy link

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image links use mixed relative-path styles (tech-model.png vs ./splash_image.png). For consistency (and to reduce ambiguity across doc build tooling), consider standardizing on one form (e.g., prefixing all local images with ./).

Copilot uses AI. Check for mistakes.

This process is shown for an example energy system in the figure below:
If technologies require resource or price profiles, they can be provided by the user, or in many cases pulled automatically from existing databases. The costs and performance of the technology models in the system are combined into system-level performance and finance components for techno-economic analysis of the hybrid system. H2Integrate systems may include multiple system-level finance models to assess results with different system boundaries if desired. Besides simulation and analysis, H2Integrate can also perform system and sub-system optimization.

A more complex and generalized example of an H2Integrate model is shown below:
![H2Integrate Splash Image](./splash_image.png)
Copy link

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image links use mixed relative-path styles (tech-model.png vs ./splash_image.png). For consistency (and to reduce ambiguity across doc build tooling), consider standardizing on one form (e.g., prefixing all local images with ./).

Copilot uses AI. Check for mistakes.

The modular nature of the H2Integrate system makes adding custom models, including proprietary models for local analysis only, very straightforward.

## How does H2Integrate differ from other tools?

H2Integrate is developed at NREL, which has a long history of developing high-quality tools for renewable energy systems.
Expand Down
Binary file added docs/system-model.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/tech-model.png
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The main comment I have here is that by separating out steel, it looks like that is separate from the ammonia, methanol, etc. end uses. Is the steel modeling different materially, or do we just have more detail there?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I separated steel out and not ammonia because we have more technologies that are specifically related to the steel supply chain. I debated just leaving the tech lists out of the figures, but I think it does help.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.