# ESMValTool
# recipe_impact.yml
---
documentation:
  title: Quick insight for climate impact researchers
  description: >
    This recipe provides quick insight into the spread and performance of multiple models.

    Many impact researchers do not have the time and finances to use a large
    ensemble of climate model runs for their impact analysis. To get an idea of
    the range of impacts of climate change it also suffices to use a small
    number of climate model runs. In case a system is only sensitive to annual
    temperature, one can select a run with a high change and one with a low
    change of annual temperature, preferably both with a low bias.

    Results of this recipe can be viewed interactively at
    https://esmvaltool.dkrz.de/shared/esmvaltool/climate4impact/.

    Notes:

    - Bias is calcated with respect to the ERA5 reanalysis dataset over the period 1981-2015.
    - Future change is calculated for 2036-2065 as compared to 1986-2015.
    - Area is set to Europe (lon 0-39; lat 30-76.25)
    - All data are taken from the RCP/SSP 8.5 scenario

  authors:
    - kalverla_peter
    - andela_bouwe
  maintainer:
    - kalverla_peter
  project:
    - isenes3

datasets:
  # CMIP5
  - {project: CMIP5, exp: [historical, rcp85], dataset: ACCESS1-0, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: ACCESS1-3, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: bcc-csm1-1, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: bcc-csm1-1-m, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: BNU-ESM, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CanESM2, ensemble: r(1:5)i1p1,
     supplementary_variables: [{short_name: areacella, mip: fx, ensemble: r0i0p0, exp: historical}]}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CCSM4, ensemble: r(1:6)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CESM1-BGC, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CESM1-CAM5, ensemble: r(1:3)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CESM1-WACCM, ensemble: r(2:4)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CMCC-CESM, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CMCC-CM, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CMCC-CMS, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CNRM-CM5, ensemble: r(1:2)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CNRM-CM5, ensemble: r4i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CNRM-CM5, ensemble: r6i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CNRM-CM5, ensemble: r10i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: CSIRO-Mk3-6-0, ensemble: r(1:10)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: EC-EARTH, ensemble: r(1:2)i1p1}
  # The EC-EARTH r6i1p1, r7i1p1, r14i1p1 have issues in the time coordinate,
  # see https://github.com/ESMValGroup/ESMValTool/pull/2563 for details
  - {project: CMIP5, exp: [historical, rcp85], dataset: EC-EARTH, ensemble: r(8:9)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: EC-EARTH, ensemble: r(12:13)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: FGOALS-g2, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: FGOALS-s2, ensemble: r(1:3)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: FIO-ESM, ensemble: r(1:3)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GFDL-CM3, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GFDL-ESM2G, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GFDL-ESM2M, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-H, ensemble: r1i1p2}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-H, ensemble: r(1:2)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-H, ensemble: r(1:2)i1p3}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-H-CC, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-R, ensemble: r1i1p2}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-R, ensemble: r(1:2)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-R, ensemble: r(1:2)i1p3}
  - {project: CMIP5, exp: [historical, rcp85], dataset: GISS-E2-R-CC, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: HadGEM2-AO, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: HadGEM2-CC, ensemble: r(1:3)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: HadGEM2-ES, ensemble: r(1:4)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: inmcm4, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: IPSL-CM5A-LR, ensemble: r(1:4)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: IPSL-CM5A-MR, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: IPSL-CM5B-LR, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: MIROC-ESM, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: MIROC-ESM-CHEM, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: MIROC5, ensemble: r(1:3)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: MPI-ESM-LR, ensemble: r(1:3)i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: MPI-ESM-MR, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: MRI-CGCM3, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: MRI-ESM1, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: NorESM1-M, ensemble: r1i1p1}
  - {project: CMIP5, exp: [historical, rcp85], dataset: NorESM1-ME, ensemble: r1i1p1}
  # CMIP6
  - {project: CMIP6, exp: [historical, ssp585], dataset: ACCESS-CM2, ensemble: r(1:5)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: ACCESS-ESM1-5, ensemble: r(1:40)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: AWI-CM-1-1-MR, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: BCC-CSM2-MR, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CAMS-CSM1-0, ensemble: r(1:2)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CanESM5, ensemble: r(1:25)i1p(1:2)f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CanESM5-1, institute: CCCma, ensemble: r(1:10)i1p(1:2)f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CanESM5-CanOE, ensemble: r(1:3)i1p2f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CAS-ESM2-0, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CAS-ESM2-0, ensemble: r3i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CESM2, ensemble: r4i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CESM2, ensemble: r(10:11)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CESM2-WACCM, ensemble: r(1:3)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CIESM, ensemble: r1i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CMCC-CM2-SR5, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CMCC-ESM2, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CNRM-CM6-1, ensemble: r(1:6)i1p1f2, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CNRM-CM6-1-HR, ensemble: r1i1p1f2, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: CNRM-ESM2-1, ensemble: r(1:5)i1p1f2, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: E3SM-1-0, ensemble: r(1:5)i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: E3SM-1-1, ensemble: r1i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: E3SM-1-1-ECA, ensemble: r1i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r1i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r(3:4)i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r6i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r9i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r11i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r13i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r15i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3, ensemble: r(101:150)i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3-CC, ensemble: r1i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3-Veg, ensemble: r(1:4)i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3-Veg, ensemble: r6i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3-Veg, ensemble: r10i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3-Veg, ensemble: r12i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3-Veg, ensemble: r14i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: EC-Earth3-Veg-LR, ensemble: r(1:3)i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: FGOALS-f3-L, ensemble: r1i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: FGOALS-g3, ensemble: r(1:4)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: FIO-ESM-2-0, ensemble: r(1:3)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GFDL-CM4, ensemble: r1i1p1f1, grid: gr1}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GFDL-ESM4, ensemble: r1i1p1f1, grid: gr1}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GISS-E2-1-G, ensemble: r(1:4)i1p5f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GISS-E2-1-G, ensemble: r(1:5)i1p1f2, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GISS-E2-1-G, ensemble: r(1:5)i1p3f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GISS-E2-1-H, ensemble: r(1:5)i1p1f2, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GISS-E2-1-H, ensemble: r(1:5)i1p3f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: GISS-E2-2-G, ensemble: r(1:5)i1p3f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: HadGEM3-GC31-LL, ensemble: r(1:4)i1p1f3, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: HadGEM3-GC31-MM, ensemble: r(1:4)i1p1f3, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: IITM-ESM, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: INM-CM4-8, ensemble: r1i1p1f1, grid: gr1}
  - {project: CMIP6, exp: [historical, ssp585], dataset: INM-CM5-0, ensemble: r1i1p1f1, grid: gr1}
  - {project: CMIP6, exp: [historical, ssp585], dataset: IPSL-CM6A-LR, ensemble: r(1:4)i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: IPSL-CM6A-LR, ensemble: r6i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: IPSL-CM6A-LR, ensemble: r14i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: IPSL-CM6A-LR, ensemble: r33i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: KACE-1-0-G, ensemble: r(1:3)i1p1f1, grid: gr}
  - {project: CMIP6, exp: [historical, ssp585], dataset: KIOST-ESM, ensemble: r1i1p1f1, grid: gr1}
  - {project: CMIP6, exp: [historical, ssp585], dataset: MCM-UA-1-0, ensemble: r1i1p1f2, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: MIROC-ES2L, ensemble: r(1:10)i1p1f2, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: MIROC6, ensemble: r(1:50)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: MPI-ESM1-2-HR, ensemble: r(1:2)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: MPI-ESM1-2-LR, ensemble: r(1:30)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: MRI-ESM2-0, ensemble: r1i2p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: MRI-ESM2-0, ensemble: r(1:5)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: NESM3, ensemble: r(1:2)i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: NorESM2-LM, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: NorESM2-MM, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: TaiESM1, ensemble: r1i1p1f1, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: UKESM1-0-LL, ensemble: r(1:4)i1p1f2, grid: gn}
  - {project: CMIP6, exp: [historical, ssp585], dataset: UKESM1-0-LL, ensemble: r8i1p1f2, grid: gn}

observations: &observations
  - {mip: Amon, dataset: ERA5, project: native6, type: reanaly, version: v1, tier: 3, tag: observations}

preprocessors:

  calculate_anomalies:
    custom_order: true
    extract_region: &region
      start_longitude: 0.0
      end_longitude: 39.0
      start_latitude: 30.0
      end_latitude: 76.25
    area_statistics:
      operator: mean
    anomalies:
      period: full
      reference: &reference_period
        start_year: 1986
        start_month: 1
        start_day: 1
        end_year: 2015
        end_month: 12
        end_day: 31
      standardize: false
    extract_time:  # Future period
      start_year: 2035
      start_month: 1
      start_day: 1
      end_year: 2065
      end_month: 12
      end_day: 31
    climate_statistics:
      operator: mean

  prepare_for_bias_calculation:
    regrid:
      scheme: linear
      target_grid: 2.5x2.5
    extract_region:
      <<: *region
    extract_time:
      <<: *reference_period

diagnostics:
  bias_and_change:
    description: >
      Provide quick insights into the behaviour of each model by plotting the
      bias with respect to observations and change with respect to the reference
      period.

    themes:
      - phys
    realms:
      - atmos

    variables:
      tas_change:
        short_name: tas
        mip: Amon
        tag: model
        timerange: '1981/2099'
        preprocessor: calculate_anomalies
      pr_change:
        short_name: pr
        mip: Amon
        tag: model
        timerange: '1981/2099'
        preprocessor: calculate_anomalies
      tas_bias:
        short_name: tas
        mip: Amon
        tag: model
        timerange: '1981/2010'
        preprocessor: prepare_for_bias_calculation
        additional_datasets: *observations
      pr_bias:
        short_name: pr
        mip: Amon
        tag: model
        timerange: '1981/2010'
        preprocessor: prepare_for_bias_calculation
        additional_datasets: *observations

    scripts:
      visualize:
        script: impact/bias_and_change.py