Evaluation and analysis for the Scenario Compass Initiative

Copyright 2026 IIASA Scenario Services team and the Scenario Compass consortium

This repository is licensed under the MIT License.

Overview

This package provides utility functions for evaluation and analysis of Integrated-Assessement scenarios.

Visit https://scenariocompass.org for more information.

Scenario evaluation

The Scenario Compass Initiative develops criteria for scenario evaluation, specifically validation of key variables against historical reference data. The criteria are given in the directory scenariocompass/criteria and the package source code.

The current package implementation is (mostly) consistent with Release v1.0 of the Scenario Compass ensemble (doi: https:/doi.org/10.5281/zenodo.18598251 ) released on February 16, 2026.

Climate categorization

The Scenario Compass Initiative developed a new set of climate categories, incorporating insights from IPCC AR6 WG3 and recent publications. Refer to the supplementary material of Riahi et al. (in review) for more information.

Using the package

To use the scenariocompass package, you can use the following code, where df is a pyam.IamDataFrame following the common-definitions variable template.

from scenariocompass import ScenarioCompassProcessor, ClimateCategorization

# run the scenario evaluation on the scenario data
sci_processor = ScenarioCompassProcessor()
df = sci_processor.apply(df)

# assign the SCI climate categorization
sci_categories = ClimateCategorization()
df = sci_categories.apply(df)

Refer to the documentation for more information.

Acknowledgement

This package and related tools build on the work by the Integrated Assessment Modeling Consortium (IAMC).

The Scenario Compass Initiative is grateful for the generous support from the Bezos Earth Fund.

This package is developed and maintained by the |ScSe team|. It is released under the MIT License.