Evaluation & analysis for the Scenario Compass Initiative

Copyright 2026 IIASA and the Scenario Compass Initiative (SCI)

This repository is licensed under the MIT License.

Overview

This package provides utility functions for validation and analysis of Integrated-Assessment scenarios as used by the Scenario Compass Initiative.

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.

This package implements the scenario-evaluation criteria as specified in Release 2026-08-03 (August 3, 2026). Visit https://scenario-evaluation-criteria.iamconsortium.org/2026.08.03/ for more information and detailed explanation for the selected thresholds and ranges.

The current package is consistent with Release v1.1 of the Scenario Compass ensemble (doi 10.5281/zenodo.21805011) released on August 5, 2026. The criteria are given in the directory scenariocompass/criteria and the package source code.

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 Scenario Services team at the IIASA Energy, Climate, and Environment program. It is released under the MIT License.