The MESSAGEix framework
MESSAGEix is a versatile, dynamic, model framework for energy-engineering-economy-environment (E4) systems research.
MESSAGE (without āā¦ixā) is a specific formulation of a generic linear programming (LP) optimization model for strategic energy planning and integrated assessment of E4 systems, developed by the IIASA Energy, Climate, and Environment (ECE) Program since the 1980s. To incorporate feedback between prices and demand levels for energy and commodities, the LP model can optionally be linked to the economic general equilibrium (GE) MACRO model.
The message_ix
Python packageāalso fully usable from Rāincludes:
- Implementations of MESSAGE, MACRO, and their linkage, in GAMS,
- Application programming interfaces (APIs) and tools for model building and scientific programming,
- Extensive documentation and a complete test suite.
The framework is built on IIASA's ix modeling platform (ixmp
), which provides data warehouse features for high-powered numerical scenario analysis.
Documentation
Complete documentation of the framework is avaiable at https://docs.messageix.org/. This includes:
-
Installation and recommended pre-requisite learning.
See āGetting startedā, or the file
INSTALL.rst
. -
Tutorials that introduce and demonstrate core features of the model framework using simple, single-country models, for both independent and classroom learning.
See āTutorialsā or the file
tutorial/README.rst
. - The Python and R APIs.
- The complete mathematical formulation of MESSAGE and MACRO, created automatically from inline comments in the GAMS source code.
- How to cite MESSAGEix when using it in published scientific work.
See āUser guidelines and noticeā or the file
NOTICE.rst
.
Other forms of documentation:
- The online documentation is built automatically from the contents of the
message_ix
GitHub repository. - Documentation for the ālatestā or āstableā release is shown by default.
- Use the chooser to access the ālatestā version, corresponding to the
main
branch and including the latest development code; or to access docs for a specific release, e.g.v3.2.0
. - For offline use, the documentation can be built from the source code.
See the file
doc/README.rst
License
Copyright Ā© 2018ā2024 IIASA Energy, Climate, and Environment (ECE) 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 in LICENSE
or at http://www.apache.org/licenses/LICENSE-2.0.
In addition and per good scientific practice, you must cite the appropriate publications when you use MESSAGEix in scientific work.
Again, see āUser guidelines and noticeā or the file NOTICE.rst
.