Copyright 2026 IIASA and the Scenario Compass Initiative (SCI)
This repository is licensed under the MIT License.
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.
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 v2.0 of the Scenario Compass ensemble (doi 10.5281/zenodo.23232097) released on October 8, 2026 as well as Release v1.1 released on August 5, 2026. The criteria are given in the directory scenariocompass/criteria and the package source code.
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.
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.
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 and the FUTURA project. funded by the European Commission.
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.
