# The MESSAGEix framework¶

The ix modeling platform ([1])

MESSAGEix is a versatile, dynamic systems-optimization modelling framework developed by the IIASA Energy Program 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) [1].

• For an overview and recent publications related to the specific MESSAGEix-GLOBIOM global model instance used at the IIASA Energy 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:

## 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!

Have a question?