Open-Source Framework for Integrated Energy System Analysis

Integrated Energy System
Planning and Analysis with H2RES

H2RES is an open-source energy systems model designed to support the analysis of integrated and sector-coupled energy transitions. It brings together planning, system operation, and scenario comparison within a flexible framework intended for research, teaching, and applied energy studies.

Start Here

Let's help you understand the model, choose the right version for your work, and start your analysis.

1
Choose the version that fits your use case

Use the version tree to identify the branch that best matches the scope and structure of your study.

2
Review the resources linked to that release

Start from the online guidance, then move to the user manual and supporting documentation attached to the selected version.

3
Start from a baseline and build scenarios

Begin from a documented baseline setup, adjust assumptions, and compare outputs relevant for planning and transition analysis.

Generation and Flexibility options
Secondary transformation sectors
Final demand sectors
Non-dispatchable
SOLAR
WIND
HROR
Dispatchable units
Coal
Oil
Gas
Biomass
HDAM
HPHS
Heat generation
Boilers
CHP
Heat storage
H2 storage
H2
Electrolyzers
Fuel cells
Electricity
Heat pumps
EV storage
District Heating
Other Heat
Transport
Buildings
Industry
Agriculture
Get Started with H2RES

Start Here

Select the right model version for your work and set it up.

New Users

Start with a first working setup

Get Started →
Model Users

Select the version that fits the problem

Open Model →
Researchers

Understand the model and its resources

Open Model Resources →

Where H2RES is most useful

Policy and planning teams

For long-term planning and scenario comparison across electricity, heat, hydrogen, and transport systems.

Academic researchers

For reproducible studies on sector coupling, system flexibility, and low-carbon transition pathways.

Teaching and training contexts

For structured learning paths, workshops, summer schools, and introductory exercises in energy systems modelling.

About H2RES

What H2RES Represents

Overview

H2RES is an open-source energy systems model used to explore integrated transition pathways through a combination of planning, system operation, storage, and cross-sector interactions.

Development History

H2RES has existed for more than two decades and holds an important place in energy systems modelling as the first model used in a peer-reviewed study of a 100% renewable energy system. Since then, it has evolved from early renewable energy case studies into a broader framework for integrated energy systems analysis.

Institutions & Collaborations

H2RES is developed through collaboration among universities and research partners working on open and transferable approaches to energy systems modelling.

Governance & Licensing

H2RES follows an open development approach and is distributed under an open-source license to support transparent and reusable research workflows.

Guided learning

Learning Hub

Learn how to install H2RES, run simulations and interpret results.

Tutorials & Training

Learning resources for users moving from installation and baseline execution toward structured scenario development.

  • Quickstart tutorials for installation, first run, and baseline output validation
  • Scenario-building workflows covering assumptions, constraints, and sensitivity analysis
  • Sector-coupling examples across electricity, heat, transport, and hydrogen
  • Reproducibility guidance for versioning, inputs, and result interpretation
Browse materials →

Hands-On Tutorials

01

Install & First Run

Set up H2RES, execute a first baseline case, and verify that the expected outputs are produced correctly.

Start →
02

Build Your Scenario

Create a scenario by modifying demand trajectories, technology assumptions, and policy constraints.

Start →
03

Analyze & Compare Results

Compare scenarios using planning assumptions, cost indicators, and system-level outcome metrics.

Start →
Publications

Research Outputs

Peer-reviewed articles, in-proceedings papers, technical reports, theses, project deliverables, and curated databases developed with H2RES.

Loading publications from h2res_research_outputs.bib...
Team

The research team behind H2RES

Core Developers

Contributors & Alumni

Scientific Advisory Board

Community

Academic and Community Engagement

This section brings together the broader academic and community context of H2RES, including citation guidance, learning opportunities, collaborative activities, and ways to stay connected with ongoing developments around the model.

How to Cite

Academic citation

Use this reference when citing H2RES in academic work:

Feijoo, F., Pfeifer, A., Herc, L., Groppi, D., and Duic, N. (2022). A long-term capacity investment and operational energy planning model with power-to-X and flexibility technologies. Renewable and Sustainable Energy Reviews, 167, 112781. DOI: 10.1016/j.rser.2022.112781

Website citation

Use this reference when citing the H2RES website:

Duic, N., et al. (2026). H2RES Web Platform. Retrieved May 25, 2026, from https://h2res.org/

Summer School on Energy Planning of 100% Renewable Energy Systems

Summer School on Energy Planning of 100% Renewable Energy Systems

This summer school focuses on energy and climate planning, smart energy systems, and applied modelling workflows, with emphasis on data handling, scenario design, policy assessment, and exchange with experts in the field.

Summer School →

H2RES Competition

The competition recognizes national energy system models that satisfy the following criteria:

Eligibility Criteria

  • 100 % RES in total energy supply
  • Cheaper than the scenario based on fossil fuels
  • No more than 30 % of final energy supplied by biomass
  • Respects the limitations on installation of VRES capacities
  • Possesses no more than 48 hours worth of electricity storage in a form of battery stationary storage

Prize

Fee waiver for the next SDEWES conference.

Mailing List / Newsletter

Subscribe if you want updates on releases, publications, events, and training opportunities without following repository activity directly.

Model Resources

Model Guidance Lives in One Dedicated Page

Use the Model page when you need versions, documentation, and release-specific resources.

To keep the landing page focused, detailed model guidance now sits in a single external page where users can choose a version, review documentation, compare releases, and open version-specific manuals or formulations.

Version Selection

Open the version tree and release guidance to identify the model configuration that matches your study structure and planning question.

Review version guidance →

Documentation and PDFs

Move from general orientation into version-specific manuals and mathematical formulations without switching between separate parts of the site.

Open model resources →