Awesome

IPCC AR6 Chapter 9 Figures

Repository with the code and data for all figures from Chapter 9 of the Sixth Assesment Report from the Intergovernmental Panel on Climate Change (IPCC AR6).

How to use this repository

The code to plot each figure from Chapter 9 of IPCC AR6 is contained in the Plotting_code_and_data directory. Each figure has its own folder, named after its number in the report and a brief descriptor of the figure. If code from this repository substantially aids your work, it can be cited using this Zenodo reference. The plotted data is also provided in this repo and in the CEDA archives, and these data sets for each figure should be cited using these Zenodo references [LINKS TO BE ADDED].

All of the individual figure directories contain a .png, .pdf and/or .eps image of the final figure used in the IPCC AR6. In addition, many of these directories have a

1. Plot_Figure folder that contains the code and data used to create the figure,
2. Plotted_Data folder that contains the final plotted data in the NetCDF format required by the IPCC TSU,
3. PNGs folder where plotting code will output image files of each subpanel (not always .png, could be .pdf, .eps etc.) The exact structure varies between figure folders due to the various authors that contributed to different figures in this chapter.

Most of the plotting codes can plot the IPCC AR6 figures using the data already in this repository.

Note: the original code for several ocean figures require large data which cannot be uploaded to GitHub or shared easily, such as CMIP datasets. As a result, we have reproduced these plotting codes to read and use the IPCC/CEDA-formatted plotted datasets, with a caveat that maps use a different hatching technique. There are two routes if you wish to replot these data-intensive figures:

1. Use the codes suffixes _from_metadata.m, which are the codes linked in the Table below. These plots are identical to the AR6 plots, except for low confidence hatching which is replaced by stippling (it was not trivial to get the hatching function used for the report to work with the masked data format of the saved data).
2. Download required data & run the original code. Download and collate the required datasets (for example from ESGF nodes), and use the original calculation and plotting codes for these particular figures. The metadata of CMIP datasets and other datasets used within the figures are provided in the Appendix for Chapter 9 of IPCC AR6, and in the supplementary material from the IPCC TSU. The directory structure of this data can be inferred from the code in the repository.

List of ocean figures in Chapter 9

List of cryosphere figures in Chapter 9

List of sea level figures in Chapter 9

List of additional figures in chapter 9

Functions for IPCC processing/analysis

Matlab Functions

Many of the figures in Chapter 9 use Matlab functions created by Brodie Pearson and Baylor Fox-Kemper. These functions include scripts to plot maps, manipulate CMIP datasets, and use IPCC color schemes. They are found in the Functions directory in scripts with the naming convention IPCC_*.nc. The Matlab plotting code within this repository is set up to use these functions automatically.

The Functions directory also contains some Matlab scripts that are not distributed within Matlab's standard installation, but are available online through MathWorks.

ESMValTool recipes

Some of the code uses ESMValTool to perform certain pre-processing operations on CMIP ensembles and observational/reanalysis data. These operations include: re-gridding onto matching grids, extraction of specific time periods or regions, and temporal/spatial averaging. ESMValTool is a tool for processing and plotting CMIP data. In Chapter 9 ESMValTool was used to process some datasets, but it was not used to plot this data.

ESMValTool uses recipes and diagnostics which each perform a specific purpose. Recipes are used to extract and process the appropriate datasets from CMIP and other sources. Diagnostics are used to plot figures (or calculate diagnostics) using this extracted and processed data. The ESMValTool recipes for Chapter 9 are contained within this directory. The recipes in this repository are designed to crash after processing the data, although you may need to create an empty diagnostic file with the name contained at the end of the recipe, so that ESMValTool thinks it will eventually plot the processed data. After ESMValTool crashes, the processed data can be extracted from the appropriate pre-processor directory. Note that you may need to turn off a flag (such as switching remove_preproc_dir to false) to save the processed data.

The ESMValTool recipe directory contains the following files. All were run using ESMValTool v2.0.0:

• A config file, which sets various configuration switches including the directories that ESMValTool looks for data sets from CMIP and other sources.
• A Recipes directory containing the ESMValTool recipes used to extract and process data for Chapter 9.
• A CMIP6_Lists directory that contains terminal printouts of the list of available model datasets for a particular experiment and variable combination. Some models have multiple datasets (ensemble), in which case we used the first available dataset (which can be validated by looking at the recipes). This list contains information about the latest version release of each of these model datasets at the time the Chapter 9 figures were created.
• A Create_CMIP6_lists.sh script that was the basis for producing the printouts in the CMIP6_Lists directory.