High Resolution Energy Demand model (HIRE) ==================================== .. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg :target: http://ed.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status
HIRE was written and developed at the Environmental Change Institute, University of Oxford within the EPSRC sponsored MISTRAL programme, as part of the Infrastructure Transition Research Consortium.
More information on the model can be found here
- Eggimann et al. (2019): Modelling energy demand and supply within a system-of-systems approach. (working paper)
Note: A previous energy demand model has been developped within NISMOD by Pranab et al. 2014. HIRE is an extensive further development into a high temporal and spatial energy demand simulation model.
In order to run HIRED, first the model needs to be set up (Section 1.1). The scenario setup needs to be run every time the model is run with different configurations (Section 1.2).
HIRE is written in Python (Python>=3.6)
Add all necessary data into a local directory such as
path/to/energy_data_folder
and download the energy_demand python code.Note: Because some data is not open source, the full data needs to be optained from the consortium. However, the model can be run with dummy data (see Section 1.2)
- Update the paths in the
wrapperconfig.ini
file in the config folder Navigate to the folder where the python code is saved. Open a command and type into a command line (in a virtual environment):
python setup.py develop
orpython setup.py install
Install HIRE from within the console with the command
energy_demand setup -d path/to/energy_data_folder
The
path/to/energy_data_folder
is the path to the location with the necessary data to run the model.Note: The
setup
command generates new subfolders in theenergy_data_folder
.
1.2 Alternative Model Set-Up (with restricted data) ---------------------------------------------
- Add the minimum data requirements into a local directory as
path/to/energy_data_folder
and download the energy_demand python code. - Update the paths in the
wrapperconfig.ini
file in the config folder Navigate to the folder where the python code is saved. Open a command and type into a command line (in a virtual environment):
python setup.py develop
orpython setup.py install
Install HIRE from within the console with the command
energy_demand minimal_setup -d path/to/energy_data_folder
Example: energy_demand minimal_setup -d C:/Users/fred1234/data_energy_demand
The
path/to/energy_data_folder
is the path to the location with the necessary minimum dummy data to run the model.Note: The
minimal_setup
command generates new folders in theenergy_data_folder
.
2. Running the model with smif ========================
- Set up the model as outlined in 1.1 'Model Set-Up'
- Install and set-up smif (see instructions here)
- pip install
energy_demand
Run the energy demand model for a scenario with the command:
smif run NAME_SCENARIO
For an overview of all possible scenario and their explanation, see here here
To change the logger level of an individual sector model with smif, type:
smif -v run modelrun_id
or smif -vv run modelrun_id
Eggimann et al. (2018): In progress