MESSAGEix is a versatile, open-source, dynamic systems-optimization model. It was developed for strategic energy planning and integrated assessment of energy-engineering-economy-environment systems (E4). The framework includes the possibility for integration with the general-economy MACRO model to incorporate the feedback from price changes on demand for commodities or energy services. The mathematical formulation is based on the MESSAGE Integrated Assessment model developed at IIASA since the 1980s.
The MESSAGEix and MACRO models are implemented in GAMS. This repository contains the GAMS code and a number of tutorials and examples using stylized national energy system models.
The MESSAGEix framework is fully integrated with IIASA's ix modeling platform (ixmp), a data warehouse for high-powered numerical scenario analysis.
Copyright 2018 IIASA Energy Program
The MESSAGEix framework is licensed under the Apache License, Version 2.0 (the "License"); you may not use the files in this repository except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
Please refer to the NOTICE for details and user guidelines.
A documentation of the MESSAGEix framework, including the complete mathematical formulation and associated files, is automatically created from mark-up comments in the GAMS code and the R/Python packages. The online documentation is synchronyzed with the contents of the master branch of the repository www.github.com/iiasa/message_ix.
Please cite the following manuscript when using the MESSAGEix framework and/or the ix modeling platform for scientific publications or technical reports:
Daniel Huppmann, Matthew Gidden, Oliver Fricko, Peter Kolp, Clara Orthofer, Michael Pimmer, Nikolay Kushin, Adriano Vinca, Alessio Mastrucci, Keywan Riahi, and Volker Krey.
"The |MESSAGEix| Integrated Assessment Model and the ix modeling platform".
Environmental Modelling & Software 112:143-156, 2019.
doi: 10.1016/j.envsoft.2018.11.012
electronic pre-print available at pure.iiasa.ac.at/15157/
-
Install Python via Anaconda. We recommend the latest version, e.g., Python 3.6+.
-
Install GAMS. Importantly:
- Windows:
- Check the box labeled
Use advanced installation mode
- Check the box labeled
Add GAMS directory to PATH environment variable
on the Advanced Options page.
- Check the box labeled
- MacOSX/Linux:
-
Add the following line to you
.bash_profile
(Mac) or.bashrc
(Linux)export PATH=$PATH:/path/to/gams-directory-with-gams-binary
-
- Windows:
-
Open a command prompt and type
conda install -c conda-forge message-ix
-
Follow the installation instructions of the ixmp package.
-
Fork this repository and clone the forked repository (
<user>/message_ix
) to your machine. Addiiasa/message_ix
asupstream
to your clone. -
Open a command prompt in the
message_ix
directory and typepython setup.py install && py.test tests
By default, the model files (e.g., GAMS files) are installed with message_ix
(in your Python site-packages
directory). Many users will simply want to run
MESSAGEix, and will never need to see the these files; however, some users will
want to edit the files directly to change the mathematical formulation, such as
adding new types of parameters, constraints, etc. Accordingly, we provide a
utility to place the model files in a local directory of your choosing:
messageix-config --model_path /path/to/model
Please note, if you cloned this repository and installed MESSAGEix with
install.bat
, this command has already been run, pointing to
message_ix/model
.
If you installed from source, all tutorial files are in the tutorial
folder. If you installed from conda, you can download them to your machine by
opening a command prompt and typing
messageix-dl --local_path /path/to/tutorials
-
Additionally install the following package:
conda install nb_conda
-
Open Jupyter Notebooks from Anaconda's "Home" Tab (or directly if you have the option)
-
Open the tutorial notebook file
-
Make sure the Kernel is aligned with your conda environment
- Change kernels with menu options
Kernel
->Change Kernel
->Python [conda root]
(for example)
- Change kernels with menu options
Navigate to the tutorial folder and type
jupyter notebook
Navigate to the doc
folder and in a command prompt type
make doc