The MESSAGEix framework

MESSAGEix is a versatile, dynamic systems-optimization modelling framework developed by the IIASA Energy, Climate, and Environment (ECE) Program [1] since the 1980s.

This is the documentation for message_ix, a Python package that ties together all components of the framework. message_ix and ixmp are free and open source, licensed under the APACHE 2.0 open-source license.

  • For the scientific reference of the framework, see Huppmann et al. (2019) [3].

  • For an overview and recent publications related to the specific MESSAGEix-GLOBIOM global model instance used at the IIASA ECE Program, see the MESSAGEix-GLOBIOM documentation.

Getting started

Modeling using MESSAGEix requires domain knowledge, understanding of certain research methods, and scientific computing skills.

Then, continue with the:

  • MESSAGEix model & framework detailed description and feature list.

  • Installation of the software and essential dependencies.

  • Tutorials for new users that demonstrate the basic features of the framework.

  • Usage of MESSAGEix in academic publications, research projects, and derived tools.

_images/ix_features.svg

Features of ixmp, message_ix, and related packages [3]

Mathematical specification

These pages provide comprehensive description of the variables and equations in the core MESSAGEix mathematical implementation.

Developing MESSAGEix models

Developing a valid, scientific MESSAGEix model requires careful use of the framework features. This section provides guidelines for how to make some common model design choices.

Using, getting help, and contributing

Everyone is encouraged to use the framework to develop energy system and integrated assessment models!

Everyone is required to please follow our Code of Conduct, which you can find on GitHub or in CODE_OF_CONDUCT.md included with the source code.

Have a question? Check…