REHO 2.1.0

Renewable Energy Hub Optimizer (REHO) is a decision support tool for sustainable urban energy system planning. REHO simultaneously addresses the optimal design and operation of capacities, catering to multi-objective considerations across economic, environmental, and efficiency criteria.

Key features:

• MILP Framework
• Multi-Objective Optimization
• Multi-Scale Capabilities
• Multi-Service Consideration
• Multi-Energy Integration
• Open-Source and Open-Data

For more information about the model foundations and features, please refer to the REHO documentation.

Authors

REHO is developed by EPFL (Switzerland), within the Industrial Process and Energy Systems Engineering (IPESE) group.

Dorsan Lepour dorsan.lepour@epfl.ch
Cédric Terrier cedric.terrier@epfl.ch
Joseph Loustau

Licence

Copyright (C) <2021-2026> <Ecole Polytechnique Fédérale de Lausanne (EPFL), Switzerland>

Licensed under the Apache License, (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Description and complete License: see LICENSE file.

Installation

REHO is available as a PyPI package and can be installed via pip with:

pip install --extra-index-url https://pypi.ampl.com REHO

Full code can be accessed from the REHO GitHub repository and cloned with:

git clone https://github.com/IPESE/REHO.git

Please refer to the "Getting started" section of the documentation for step-by-step guidelines.

A first run

from reho import REHO, QBuildingsReader, initialize_grids, initialize_units

reader = QBuildingsReader()
reader.establish_connection('Geneva')
qbuildings_data = reader.read_db({'transformers': 234}, nb_buildings=2)

cluster = {'Location': 'Geneva', 'Attributes': ['T', 'I', 'W'], 'Periods': 10, 'PeriodDuration': 24}
scenario = {'Objective': 'TOTEX', 'name': 'totex'}

grids = initialize_grids()
units = initialize_units(scenario, grids)

reho = REHO(qbuildings_data=qbuildings_data, units=units, grids=grids,
            cluster=cluster, scenario=scenario, method={'building-scale': True})
reho.single_optimization()
reho.save_results(format=['xlsx', 'pickle'], filename='my_run')

The examples cover the other features: district-scale decomposition, Pareto fronts, district heating, electric mobility, renovation, seasonal storage and the multi-actor formulation.

Documentation

Suggestions and contributions

All suggestions or implementation must be tracked with dedicated issues and reported in the project repository.

Refer to the "Contributing" section of the developer guide for further guidance.

Running the tests

pytest reho/test -m "not slow"        # offline: no AMPL license, solver or database needed
REHO_RUN_EXAMPLES=1 pytest reho/test  # full: runs every example script