Skip to main content

The MESSAGEix integrated assessment model framework

Project description

The MESSAGEix framework

DOI PyPI version Anaconda version Documentation build Build status Test coverage Contributor Covenant

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 numerical scenario analysis.

Documentation

Complete documentation of the framework is available at https://docs.messageix.org. This includes:

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

Commitment to our Community

  • We aim to create a community that is welcoming to everyone. Please respect our Code of Conduct at all times when interacting with message_ix and the community.
  • We warmly welcome all contributions to our community. Please take a look at our guidelines for contributing to development.
  • If you are looking to understand how the message_ix team operates and how we decide what to do with your contributions, please read our governance guidelines.
  • We highly value code security. To learn more about our security practice and advice, please visit our security policy.
  • We strive to entertain a welcoming and inclusive community. If you struggle to use message_ix, please check our guidelines for getting support.
  • We also:
    • Host an annual MESSAGEix Community Meeting.
    • Publish, at least once per year, a community newsletter. You are cordially invited to subscribe by filling this form and ticking the box for “MESSAGEix Community”.

License

Copyright © 2018–2025 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

message_ix-3.11.1.tar.gz (6.2 MB view details)

Uploaded Source

Built Distribution

message_ix-3.11.1-py3-none-any.whl (6.3 MB view details)

Uploaded Python 3

File details

Details for the file message_ix-3.11.1.tar.gz.

File metadata

  • Download URL: message_ix-3.11.1.tar.gz
  • Upload date:
  • Size: 6.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for message_ix-3.11.1.tar.gz
Algorithm Hash digest
SHA256 12dab141f542d766f0e77ebfa29011bb3668e03af9e8873511fe3c1b3e288810
MD5 bd3577c37f239c8cc7a6694d4d6b3cda
BLAKE2b-256 818ac01687c56dd1d4cbbb9aa4389a0ce8e9885e039091a8cfa5024ab5fd6085

See more details on using hashes here.

File details

Details for the file message_ix-3.11.1-py3-none-any.whl.

File metadata

  • Download URL: message_ix-3.11.1-py3-none-any.whl
  • Upload date:
  • Size: 6.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for message_ix-3.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5de2c57d9d907488317a6c33993229d76b18999a2ff131636f9e5a88a5bb3677
MD5 66db95fc1dcd71b3f1b8371214c33041
BLAKE2b-256 c6943921406472f0e5a9459b7bccb5353c39b57a9b79a9903f210a6e69b75caa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page