Skip to content

oHYSEM is a Python library designed to provide optimal planning, operation, and management strategies for hybrid renewable electricity-hydrogen systems. It enables both stand-alone and grid-connected systems to participate in energy and hydrogen markets, ensuring the integration of new assets and efficient system scheduling.

License

Notifications You must be signed in to change notification settings

IIT-EnergySystemModels/oHySEM

Repository files navigation

logo

optimized Hybrid Systems for Energy and Market management (oHySEM)


PyPI PyPI - Python Version Read the Docs Codacy Badge PyPI - License Pepy Total Downloads

Simplicity and Transparency in Power Systems Operation and Planning

oHySEM is an open-source model distributed as a Python library, designed to provide optimal planning, operation, and management strategies for hybrid renewable electricity-hydrogen systems. It supports both stand-alone and grid-connected systems in participating in electricity and hydrogen markets, ensuring the seamless integration of new assets and efficient system scheduling.

Table of Contents

  1. Overview
  2. Features
  3. Installation
  4. Use Cases
  5. Contributing
  6. License

---

Overview

oHySEM provides a robust framework for optimizing hybrid energy systems, incorporating renewable electricity and hydrogen networks. The library is designed for users needing advanced tools for integrated resource planning, asset integration, system scheduling, and market participation in electricity and hydrogen markets.

Key Applications:

  • Optimal Planning & Scheduling: Ensure efficient energy resource management in hybrid systems.
  • Integrated Resource Planning (IRP): Plan long-term energy strategies integrating multiple energy sources.
  • Market Participation: Engage in real-time electricity markets and future hydrogen markets.
  • Asset Integration: Seamlessly incorporate new assets (e.g., renewable generators, storage units) into the system.
  • Self-scheduling: Operation planning of the hybrid system.

---

Features

  • Hybrid System Modeling: Simulate and optimize the interaction between renewable electricity and hydrogen systems.
  • Market Integration: Enable systems to participate in energy markets and optimize based on market conditions.
  • Asset Integration: Support dynamic integration of new energy assets into the system.
  • Grid and Stand-alone Systems: Model systems that are either grid-connected or self-sufficient.
  • Scalable: Suitable for small- to large-scale hybrid power plants and virtual power plants (VPPs).

---

Installation

Installing solvers:

  • Gurobi: conda install -c gurobi gurobi
  • HiGHS: pip install highspy
  • SCIP: conda install -c conda-forge pyscipopt
  • GLPK: conda install glpk

Installing oHySEM via pip:

pip install ohysem

For the full setup guide, refer to the installation guide.

From GitHub:

  1. Clone the oHySEM repository
  2. Navigate to the folder: cd path_to_repository
  3. Install with: pip install .

Running oHySEM:

After installation, you can run the model via the command line:

oHySEM

or using the Python script:

python -m oHySEM --dir {path_to_input_data} --case {case_name} --solver {solver_name}

Running the API:

To run the Streamlit API, execute the following command in the terminal that should be located in the path where the API.py file is located:

streamlit run API3.py

Solvers:

Additional requirements:

---

Use Cases

  • Grid-connected Hybrid Systems: Optimize energy flows between electricity and hydrogen markets while meeting grid regulations.
  • Stand-alone VPPs: Use oHySEM to ensure optimal operation for off-grid renewable systems.
  • Integrated Resource Planning (IRP): Plan the addition of new renewable assets and storage units to meet long-term energy goals.
  • Market Participation: Optimize market bids for both electricity and future hydrogen markets.

---

Contributing

Contributions to oHySEM are welcome! Please refer to our Contributing Guide for more information on how to contribute to the project.

---

License

oHySEM is licensed under the GPL-3.0 license. See the LICENSE file for details.

About

oHYSEM is a Python library designed to provide optimal planning, operation, and management strategies for hybrid renewable electricity-hydrogen systems. It enables both stand-alone and grid-connected systems to participate in energy and hydrogen markets, ensuring the integration of new assets and efficient system scheduling.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages