In the academic spirit of collaboration, the source code should be appropriately acknowledged in the resulting scientific disseminations.
You may cite it as follows:
- [1], for general reference to the EnergyScope project and the EnergyScope modeling framework
- [2], for reference to the origins of the EnergyScope project or to the first online version of the calculator energyscope.ch
- [3], for reference to the energyscope MILP modeling framework
- [4], for reference to the current code
You are welcome to report any bugs related to the code to the following:
[email protected]
This folder contains the third release (v2_1, hourly LP) of the EnergyScope model adapted to the Belgian case.
More recent releases are available @ the EnergyScope project repository: https://github.com/energyscope/EnergyScope
This version of the model corresponds to the one in [4].
The data used in this version of the model are fully documented in [4], Appendix B.
Copyright (C) <2018-2019> <Ecole Polytechnique Fédérale de Lausanne (EPFL), Switzerland and Université catholique de Louvain (UCLouvain), Belgium>
Licensed under the Apache License, Version 2.0 (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
The model is coded in GLPK, using the open-source solver GLPSOL. To run the model, perform the following 4 steps:
- Install GLPK:
a) on Mac OS X (Option 1, recommended): use homebrew http://arnab-deka.com/posts/2010/02/installing-glpk-on-a-mac/
b) on Mac Os X (Option 2)/Linux:
- Download the latest version of GLPK from: http://www.gnu.org/software/glpk/#downloading
- Install GLPK from the command line
$ cd ~/Downloads
$ tar -xzf glpk-4.63.tar.gz
$ cd glpk-4.63 [or newer version]
$ ./configure --prefix=/usr/local
$ make
$ sudo make install
See if your system recognises it:
$ which glpsol
should reveal:
$ /usr/local/bin/glpsol
Now try:
$ glpsol --help
Source: http://hichenwang.blogspot.ch/2011/08/fw-installing-glpk-on-mac.html
c) on Windows:
- Download the source files from: https://sourceforge.net/projects/winglpk/files/latest/download
- Extract the files in a folder. Depending on your operating system use glpsol.exe from: ./w64 if running on a 64 bit version ./w32 if running on a 64 bit version
- For facilitating the access to glpsol.exe you can add the full path (depending on your operating system, see below) from the previous point to the system variables PATH
- Clone/download the content of this folder
- Navigate to the folder 'STEP_2_Energy_Model' folder via terminal/cmd prompt and execute (check glpsol documentation for more options):
$ glpsol -m ESTD_model.mod -d ESTD_data.dat -d ESTD_12TD.dat -o ESTD_output.out (You might need to use 'glspol.exe' instead of 'glpsol' on Windows)
- Check the output files: if the ESTD_main.out file is correctly generated. If the command at point (3) did not run, it might be that glpsol is not on your PATH. Two solutions for that:
- (not best) instead of "glpsol" use the full path, e.g. on Mac '/usr/local/bin/glpsol -m ESTD_model.mod -d ESTD_data.dat -d ESTD_12TD.dat -o ESTD_output.out'
- (best) add the folder in which glpsol is installed to the PATH. e.g. on Windows 7 (http://geekswithblogs.net/renso/archive/2009/10/21/how-to-set-the-windows-path-in-windows-7.aspx). on mac (from terminal) 'export PATH=/usr/local/bin:$PATH' (if glpsol is installed in /usr/local/bin)
Descriptions of outputs files and folders:
- ./assets.txt : Installed capacity of each technology and its specific cost, gwp...
- ./cost_breakdown.txt : Cost of resources and technologies.
- ./gwp_breakdown.txt : GWP of resources and technologies.
- ./losses.txt : Losses in the networks.
- ./hourly_data/ : Folder containing the hourly data for each layer and for each storage technology.
- ./sankey/ : Folder containing the SANKEY diagram.
The model was originally developed in AMPL. Compatible solvers are CPLEX, Gurobi, etc. Running the model in AMPL requires the licences of AMPL and of at least one LP solver.
- first release (v1, monthly MILP) of the EnergyScope (ES) model: https://github.com/energyscope/EnergyScope/tree/v1.0 .
- second release (v2, hourly LP) of the EnergyScope (ES) model: https://github.com/energyscope/EnergyScope/tree/v2.0 .
Authors:
- Stefano Moret, Ecole Polytechnique Fédérale de Lausanne (Switzerland), [email protected]
- Gauthier Limpens, Université catholique de Louvain (Belgium), [email protected]
[1] G. Limpens, S . Moret, H. Jeanmart, F. Maréchal (2019). EnergyScope TD: a novel open-source model for regional energy systems and its application to the case of Switzerland. https://doi.org/10.1016/j.apenergy.2019.113729
[2] V. Codina Gironès, S. Moret, F. Maréchal, D. Favrat (2015). Strategic energy planning for large-scale energy systems: A modelling framework to aid decision-making. Energy, 90(PA1), 173–186. https://doi.org/10.1016/j.energy.2015.06.008
[3] S. Moret, M. Bierlaire, F. Maréchal (2016). Strategic Energy Planning under Uncertainty: a Mixed-Integer Linear Programming Modeling Framework for Large-Scale Energy Systems. https://doi.org/10.1016/B978-0-444-63428-3.50321-0
[4] G. Limpens (2021). Optimisation of energy transition pathways - application to the case of Belgium. PhD thesis (under review)