Example recipes


These are example recipes calling example diagnostic scripts.

The recipe examples/recipe_python.yml produces time series plots of global mean temperature and for the temperature in Amsterdam. It also produces a map of global temperature in January 2020.

The recipe examples/recipe_extract_shape.yml produces a map of the mean temperature in the Elbe catchment over the years 2000 to 2002. Some example shapefiles for use with this recipe are available here, make sure to download all files with the same name but different extensions.

For detailed instructions on obtaining input data, please refer to Obtaining input data. However, in case you just quickly want to run through the example, you can use the following links to obtain the data from ESGF:

Please refer to the terms of use for CMIP5 and CMIP6 data.

Available recipes and diagnostics

Recipes are stored in esmvaltool/recipes/

  • examples/recipe_python.yml

  • examples/recipe_extract_shape.yml

Diagnostics are stored in esmvaltool/diag_scripts/

  • examples/diagnostic.py: visualize results and store provenance information

User settings in recipe

  1. Script examples/diagnostic.py

    Required settings for script

    • quickplot: plot_type: which of the iris.quickplot functions to use. Arguments that are accepted by these functions can also be specified here, e.g. cmap. Preprocessors need to be configured such that the resulting data matches the plot type, e.g. a timeseries or a map.

    Optional settings for script

    • write_netcdf: true (default) or false. This can be used to disable writing the results to netcdf files.


  • tas (atmos, monthly, longitude, latitude, time)

Example plots


Fig. 175 Air temperature in January 2000 (BCC-ESM1 CMIP6).


Fig. 176 Amsterdam air temperature (multimodel mean of CMIP5 CanESM2 and CMIP6 BCC-ESM1).


Fig. 177 Mean air temperature over the Elbe catchment during 2000-2002 according to CMIP5 CanESM2.