# User guidelines and notice¶

We ask that you take the following four actions whenever you:

• use the MESSAGEix framework, ix modeling platform, or any model(s) you have built using these tools

• to produce any scientific publication, technical report, website, or other publicly-available material.

The aim of this request is to ensure good scientific practice and collaborative development of the platform.

## 1. Understand the code license¶

Use the most recent version of MESSAGEix from the Github repository. Specify clearly which version (e.g. release tag, such as v1.1.0, or commit hash, such as 26cc08f) you have used, and whether you have made any modifications to the code.

Read and understand the file LICENSE; in particular, clause 7 (“Disclaimer of Warranty”), which states:

Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

## 2. Cite the scientific publication¶

Cite the following manuscript:

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.
electronic pre-print available at pure.iiasa.ac.at/15157/.

## 3. Use the naming convention for new model instances¶

For any new model instance under the MESSAGEix framework, choose a name of the form “MESSAGEix [xxx]” or “MESSAGEix-[xxx]”, where [xxx] is replaced by:

• the institution or organization developing the model,

• the name of a country/region represented in the model, or

• a similar identifier.

For example, the national model for South Africa developed by Orthofer et al. [1] is named “MESSAGEix South Africa”.

Ensure there is no naming conflict with existing versions of the MESSAGEix model family. When in doubt, contact the IIASA Energy Program at <message_ix@iiasa.ac.at> for a list of existing model instances.

## 4. Give notice of publication¶

E-mail <message_ix@iiasa.ac.at> with notice of notice of any new or pending publication.

## References¶

[1] Clara Orthofer, Daniel Huppmann, and Volker Krey (2019).
“South Africa’s shale gas resources - chance or challenge?”
Frontiers in Energy Research 7:20. doi: 10.3389/fenrg.2019.00020