RIME - Rapid Impact Model Emulator

2023 IIASA

Overview

---

RIME is a lightweight software tool for using global warming level approaches to link climate impacts data to Integrated Assessment Models (IAMs).

When accompanied by climate impacts data (table and/or maps), RIME can be used to take a global mean temperature timeseries (e.g. from an IAM or climate model like FaIR/MAGICC), and return tables and maps of climate impacts through time consistent with the warming of the scenario.

There are two key use-cases for the RIME approach:

1. Post-process: Estimating a suite of climate impacts from a global emissions or temperature scenario.
2. Input: Reformulating climate impacts data to be used as an input to an integrated assessment model scenario.

RIME is Rapid! It's in the name...

• RIME is intended and designed to be rapid. It uses Xarray and Dask for parallelized processing and lazy reading of big data. Processing climate impacts data takes in the order of seconds per scenario on a desktop computer.
• RIME is intended and designed with the IAMC and ISIMIP communities in mind. It uses Pyam for processing IAM scenarios and follows community data formats.

Core files

rime_functions.py

Contains the key functions that can be used to process data and generate outputs.

utils.py

A collection of helper functions related to data processing, used within functions and as standalone, if needed.

process_config.py

A script to host a large number of configurable settings for running the software on datasets. Needs to be imported at the beginning of a script, e.g. from process_config import *.
Settings for Dask, filepaths and data directories should be configured in here for your local configuration.

Example processing and workflow scripts

generate_aggregated_inputs.py

Pre-processing of tabular impacts data of exposure by GWL, into netcdf datasets that will be used in emulation. Only needs to run once to pre-process the impacts data. Only required if working with IAMC table impacts data.

pp_combined example.ipynb

Example jupyter notebook that demonstrates methods of processing both table and map impacts data for IAM scenarios.

or [

process_tabledata.py

Example script that takes input table of emissions scenarios with global temperature timeseries, and output tables of climate impacts data in IAMC format. Can be done for multiple scenarios and indicators at a time. and

process_maps.py

Example script that takes input table of emissions scenarios with global temperature timeseries, and output maps of climate impacts through time as netCDF. Ouptut netCDF can be specified for either for 1 scenario and multiple climate impacts, or multiple scenarios for 1 indicator. ]

test_map_notebook.html

Example html maps dashboard. CLick download in the top right corner and open locally in your browser.

Installation

At command line, navigate to the directory where you want the installation, e.g. your Github folder.

git clone https://github.com/iiasa/rime.git

Change to the rime folder and install the package including the requirements.

pip install --editable .

Further information

This package is in a pre-release mode, currently work in progress, under-going testing and not yet formally published.

Examples provided use climate impacts data that is currently under-going peer-review (Werning et al. 2024), currently hosted on the Climate Solutions Explorer.