HES-OFF

Description

Despite the efforts to move towards a carbon-neutral future, the global demand of fossil fuels continues to grow. As a result, the oil and gas (O&G) industry if facing a double challenge: meet the increased need for energy while simultaneously reducing its overall emissions. One way to achieve these goals is through the use of hybrid energy systems that combine renewable energies with conventional power generation.

In this context, HES-OFF Python package offers a platform-independent environment for the simulation of hybrid energy systems for stable heat and power supply in off-shore oil and gas installations. The code was developed aiming at ease of use and computational speed. Some notable features of the package are listed below:

Supports the simulation of off-shore energy systems that integrate offshore wind power with gas turbines and an energy storage solution based on proton exchange membrane fuel cells and electrolysers.
Contains commercial and user-defined numerical models to simulate the performance of the different system components.
Includes an intuitive, web-based graphical user interface to perform the simulations and visualize the results.
- The backend of the interface was developed using the Flask framework
- The frontend of the interface was developed using the Bootstrap framework
- The web-based app is currently hosted in the Heroku platform
Uses the Numba JIT compiler to achieve execution times comparable with those of compiled languages such as C++ or FORTRAN.

Getting started

Running the all online

There is not need to install anything to start using the online web application! Just open the app and start playing around with the different parameters and settings. The user interface has many tooltips and warnings to guide the users and help them understand what inputs are expected.

Running the app locally

If you want to have access to the core functionality of the HES-OFF package, you can install it with pip:

pip install hes_off

Once the package is installed, you can run the web application locally typing the following command in your terminal:

python -c "import hes_off; hes_off.launch_app()"

Documentation

To be completed

Add link to Read the Docs documentation
Add the links to related publications

License

The hes_off package is licensed under the terms of the MIT license. See the license file for more information.

Contact information

To be completed

To-do list

Add option to export Excel files with results (Roberto)
Add option to add a user-defined model for the electrolyzer and fuel cell systems (Roberto)
Prepare some test cases and compare results with MATLAB (Luca)
Prepare a documentation page using Read the Docs (Erick)
Implement the electric grid surrogate model (Erick)
Implement a gradient-free optimization for design
Prepare a paper for an open-software journal
- Journal of open-source software
- Elsevier's SoftwareX journal

Pip deployment

This section is intended for developers

In order to add the hes_off package to the pip installer, you must create a PyPi account. Once you are set, open a terminal in the project's root directory and type the following commands:

Remove any existing build, dist and egg folders:
```
rm -r build dist *.egg-info
```
Create a source archive and a wheel for your package:
```
python setup.py sdist bdist_wheel
```
Upload the package to PyPi using twine (you may need to install twine):
```
python -m twine upload dist/*
```
Fill in your user name and credentials and wait until the package upload is complete

Heroku deployment