Adding basic impact diagnostics

.zenodo.json

@@ -466,6 +466,10 @@
       "affiliation": "BSC, Spain",
       "name": "Ghosh, Supriyo",
       "orcid": "0000-0003-0581-9907"
+    },
+    {
+      "affiliation": "DLR,Germany",
+      "name": "Caspers, Laura"
     }
   ],
   "description": "ESMValTool: A community diagnostic and performance metrics tool for routine evaluation of Earth system models in CMIP.",

CITATION.cff

@@ -462,6 +462,10 @@ authors:
     family-names: Ghosh
     given-names: Supriyo
     orcid: "https://orcid.org/0000-0003-0581-9907"
+  -
+    affiliation: "DLR, Germany"
+    family-names: Caspers
+    given-names: Laura
 
 cff-version: 1.2.0
 date-released: 2026-07-28

doc/sphinx/source/recipes/index.rst

@@ -142,6 +142,7 @@ Other
    :maxdepth: 1
 
    recipe_capacity_factor
+   recipe_climatic_impact-drivers
    recipe_cmorizers
    recipe_ensclus
    recipe_esacci_lst

doc/sphinx/source/recipes/recipe_climatic_impact-drivers.rst

@@ -0,0 +1,91 @@
+.. _recipe_climatic_impact-drivers:
+
+Climatic Impact-Drivers
+=======================
+
+Overview
+--------
+
+These recipes and the corresponding diagnostic provide plotting routine for a
+selection of the Climatic Impact-Drivers defined in Elling et al. (2026). For
+each of these variables the model output is compared to observational datasets.
+
+
+Available recipes and diagnostics
+---------------------------------
+
+Recipes are stored in `recipes/climatic_impact-drivers`
+
+* recipe_impacts_map.yml
+* recipe_impacts_timeseries.yml
+
+Diagnostics are stored in `diag_scripts/climatic_impact-drivers`
+
+* multi_datasets_with_threshold.py: Monitoring diagnostic to optionally count days exceeding some threshold and plot multiple datasets on a map or timeseries.
+
+
+User settings in recipe
+-----------------------
+
+A full list of all possible configuration options that can be specified in the
+recipe is given at the beginning of the diagnostic script (see previous section).
+
+The most relevant configuration options include:
+
+*Required settings*
+
+* plots: type of plot that is created (map, timeseries)
+
+*Optional settings*
+
+* options: additional pre-processing options that are applied. Available are:
+
+   * threshold_conversion: Option to count the number of days on which a variable exceeds a certain threshold value. Requires the argument 'threshold' with the threshold that should be exceeded within this option. Allows additionally the argument 'inverted' to count the number of days where the variable attains a value below the given threshold and the argument 'accumulated' to correctly count the number of days if the given dataset is not daily and the given variable is accumulating over time.
+
+
+Variables
+---------
+
+Any possible, but mainly designed for tasmin, tasmax, pr, snw, zostoga, tos, mlotst, rsds:
+
+* mlotst (ocean, monthly mean, longitude latitude time)
+* pr (atmos, daily mean, longitude latitude time)
+* rsds (atmos, daily mean, longitude latitude time)
+* snw (atmos, daily mean, longitude latitude time)
+* tasmax (atmos, daily max, longitude latitude time)
+* tasmin (atmos, daily min, longitude latitude time)
+* tos (ocean, monthly mean, longitude latitude time)
+* zostoga (ocean, monthly mean, longitude latitude time)
+
+
+Observations and reformat scripts
+---------------------------------
+
+* ESACCI-SNOW (snw)
+* ERA5 (tasmin, tasmax, pr, rsds - esmvaltool/recipes/cmorizers/recipe_daily_era5.yml)
+* ORAS5 (tos, mlotst)
+
+
+References
+----------
+
+* Elling, M.T., Ruane, A.C., De Mel, M. et al. An impact-driven framework for climate model evaluation. Climatic Change 179, 65 (2026). https://doi.org/10.1007/s10584-026-04157-w
+
+
+Example plots
+-------------
+
+.. _fig_tasmax_exceeds_climatology:
+.. figure::  /recipes/figures/climatic_impact-drivers/timeseries_tasmax_day.png
+   :align:   center
+   :width:   14cm
+
+   Global climatology of the number of days on which tasmax exceeds 40°C.
+
+.. _fig_pr_exceeds_map:
+.. figure::  /recipes/figures/climatic_impact-drivers/map_pr_day.png
+   :align:   center
+   :width:   14cm
+
+   Global map of the average number of days per year on which the precipitation
+   exceeds 10 mm.

esmvaltool/config-references.yml

@@ -170,6 +170,10 @@ authors:
     name: Caron, Louis-Philippe
     institute: BSC, Spain
     orcid: https://orcid.org/0000-0001-5221-0147
+  caspers_laura:
+    name: Caspers, Laura
+    institute: DLR, Germany
+    orcid:
   chen_jack:
     name: Chen, Jack
     institute: NCAR, USA

esmvaltool/diag_scripts/climatic_impact-drivers/__init__.py

@@ -0,0 +1 @@
+"""Climatic Impact-Drivers diagnostics recipe for ESMValTool."""