# ESMValTool
# recipe_deangelis15nat.yml
---
documentation:
  title: "Evaluate water vapor short wave radiance absorption schemes of ESMs with the observations"
  description: |
    Recipe for reproducing the plots in DeAngelis et al., 2015 Nature

  authors:
    - weigel_katja

  maintainer:
    - weigel_katja

  references:
    - deangelis15nat

  projects:
    - eval4cmip

preprocessors:
  spatial_mean:
    area_statistics:
      operator: mean

  tropical_ocean:
    mask_landsea:
      mask_out: land
    regrid:
      target_grid: 2.5x2.5
      scheme: linear
    extract_region:
      start_latitude: -30
      end_latitude: 30
      start_longitude: 0
      end_longitude: 360

  tropical:
    regrid:
      target_grid: 2.5x2.5
      scheme: linear
    extract_region:
      start_latitude: -30
      end_latitude: 30
      start_longitude: 0
      end_longitude: 360


diagnostics:

  deangelisf1b:
    description: Bar plot similar to (DeAngelis Fig. 1b).
    # Global multi-model experiment mean for flux variables, e.g. rlnst, rsnst, lvp, hfss
    variables:
      rlnst: &spatial_mean_cmip5_r1i1p1_amon_t2ms
        preprocessor: spatial_mean
        project: CMIP5
        ensemble: r1i1p1
        mip: Amon
        field: T2Ms
        derive: true
        force_derivation: false
      rsnst:
        <<: *spatial_mean_cmip5_r1i1p1_amon_t2ms
      lvp:
        <<: *spatial_mean_cmip5_r1i1p1_amon_t2ms
      hfss:
        <<: *spatial_mean_cmip5_r1i1p1_amon_t2ms
        derive: false
    additional_datasets:
      - {dataset: GFDL-CM3, exp: piControl, start_year: 1,
         end_year: 150}
      - {dataset: GFDL-CM3, exp: rcp85, start_year: 2091,
         end_year: 2100}
      - {dataset: GFDL-CM3, exp: abrupt4xCO2, start_year: 141, end_year: 150}
      - {dataset: ACCESS1-0, exp: piControl, start_year: 300, end_year: 449}
      - {dataset: ACCESS1-0, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: ACCESS1-0, exp: abrupt4xCO2, start_year: 300, end_year: 449}
      - {dataset: ACCESS1-3, exp: piControl, start_year: 250, end_year: 399}
      - {dataset: ACCESS1-3, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: ACCESS1-3, exp: abrupt4xCO2, start_year: 250, end_year: 399}
      # Strange values in lvp
      # - {dataset: bcc-csm1-1, exp: piControl, start_year: 160, end_year: 309}
      # - {dataset: bcc-csm1-1, exp: rcp85, start_year: 2091, end_year: 2100}
      # - {dataset: bcc-csm1-1, exp: abrupt4xCO2, start_year: 300, end_year: 309}
      # - {dataset: bcc-csm1-1-m, exp: piControl, start_year: 240, end_year: 389}
      # - {dataset: bcc-csm1-1-m, exp: rcp85, start_year: 2091, end_year: 2100}
      # - {dataset: bcc-csm1-1-m, exp: abrupt4xCO2, start_year: 380,
      #    end_year: 389}
      - {dataset: CanESM2, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: CanESM2, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: CanESM2, exp: abrupt4xCO2, start_year: 1990, end_year: 1999}
      # data not available completely on DKRZ
      # - {dataset: CCSM4, exp: piControl, start_year: 800, end_year: 949}
      # - {dataset: CCSM4, exp: rcp85, start_year: 2091, end_year: 2100}
      # - {dataset: CCSM4, exp: abrupt4xCO2, start_year: 1990, end_year: 1999}
      - {dataset: CNRM-CM5, exp: piControl, start_year: 1850, end_year: 1999}
      - {dataset: CNRM-CM5, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: CNRM-CM5, exp: abrupt4xCO2, start_year: 1990, end_year: 1999}
      - {dataset: GFDL-ESM2G, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2G, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: GFDL-ESM2G, exp: abrupt4xCO2, start_year: 141, end_year: 150}
      - {dataset: GFDL-ESM2M, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2M, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: GFDL-ESM2M, exp: abrupt4xCO2, start_year: 141, end_year: 150}
      - {dataset: GISS-E2-R, exp: piControl, start_year: 3331, end_year: 3480}
      - {dataset: GISS-E2-R, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: GISS-E2-R, exp: abrupt4xCO2, start_year: 1990,
         end_year: 1999}
      - {dataset: inmcm4, exp: piControl, start_year: 2090, end_year: 2239}
      - {dataset: inmcm4, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: inmcm4, exp: abrupt4xCO2, start_year: 2230, end_year: 2239}
      # IPSL-CM5A-MR only 140 years available
      - {dataset: IPSL-CM5A-MR, exp: piControl, start_year: 1850,
         end_year: 1989}
      - {dataset: IPSL-CM5A-MR, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: IPSL-CM5A-MR, exp: abrupt4xCO2, start_year: 1980,
         end_year: 1989}
      - {dataset: IPSL-CM5B-LR, exp: piControl, start_year: 1850,
         end_year: 1999}
      - {dataset: IPSL-CM5B-LR, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: IPSL-CM5B-LR, exp: abrupt4xCO2, start_year: 1990,
         end_year: 1999}
      - {dataset: MIROC-ESM, exp: piControl, start_year: 1800, end_year: 1949}
      - {dataset: MIROC-ESM, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: MIROC-ESM, exp: abrupt4xCO2, start_year: 141, end_year: 150}
      - {dataset: MIROC5, exp: piControl, start_year: 2100, end_year: 2249}
      - {dataset: MIROC5, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: MIROC5, exp: abrupt4xCO2, start_year: 2240, end_year: 2249}
      - {dataset: MPI-ESM-LR, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: MPI-ESM-LR, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: MPI-ESM-LR, exp: abrupt4xCO2, start_year: 1990,
         end_year: 1999}
      - {dataset: MPI-ESM-MR, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: MPI-ESM-MR, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: MPI-ESM-MR, exp: abrupt4xCO2, start_year: 1990,
         end_year: 1999}
      - {dataset: MRI-CGCM3, exp: piControl, start_year: 1851, end_year: 2000}
      - {dataset: MRI-CGCM3, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: MRI-CGCM3, exp: abrupt4xCO2, start_year: 1991,
         end_year: 2000}
      - {dataset: NorESM1-M, exp: piControl, start_year: 700, end_year: 849}
      - {dataset: NorESM1-M, exp: rcp85, start_year: 2091, end_year: 2100}
      - {dataset: NorESM1-M, exp: abrupt4xCO2, start_year: 141, end_year: 150}

    scripts:
      deangelisf1b:
        script: deangelis15nat/deangelisf1b.py


  deangelisf2ext:
    description: Plots scatter plot and linear regression for LvP/dtas.
    # dLWC/dtas, dSWA/dtas, and dSH/dtas (DeAngelis extended data Fig. 1,
    # one plot for each model) and temperature-mediated responses of
    # LvP (i.e. LvdP/dT) and SWA (i.e., dSWA/dT) for all-sky and clear-sky
    # conditions (DeAngelis Fig. 2a) and Scatterplot of the model-produced
    # LvdP/dT versus clear-sky dSWA/dT conditions (DeAngelis Fig. 2a).

    variables:
      rlnst: &spatial_mean2_cmip5_r1i1p1_amon_t2ms
        preprocessor: spatial_mean
        project: CMIP5
        ensemble: r1i1p1
        mip: Amon
        derive: true
        force_derivation: false
      rsnst:
        <<: *spatial_mean2_cmip5_r1i1p1_amon_t2ms
      rlnstcs:
        <<: *spatial_mean2_cmip5_r1i1p1_amon_t2ms
      rsnstcs:
        <<: *spatial_mean2_cmip5_r1i1p1_amon_t2ms
      lvp:
        <<: *spatial_mean2_cmip5_r1i1p1_amon_t2ms
      hfss:
        <<: *spatial_mean2_cmip5_r1i1p1_amon_t2ms
        derive: false
      tas:
        <<: *spatial_mean2_cmip5_r1i1p1_amon_t2ms
        derive: false
    additional_datasets:
      - {dataset: GFDL-CM3, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-CM3, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: ACCESS1-0, exp: piControl, start_year: 300, end_year: 449}
      - {dataset: ACCESS1-0, exp: abrupt4xCO2, start_year: 300, end_year: 449}
      - {dataset: ACCESS1-3, exp: piControl, start_year: 250, end_year: 399}
      - {dataset: ACCESS1-3, exp: abrupt4xCO2, start_year: 250, end_year: 399}
      # strange values in lvp
      # - {dataset: bcc-csm1-1, exp: piControl, start_year: 160, end_year: 309}
      # - {dataset: bcc-csm1-1, exp: abrupt4xCO2, start_year: 160, end_year: 309}
      # - {dataset: bcc-csm1-1-m, exp: piControl, start_year: 240, end_year: 389}
      # - {dataset: bcc-csm1-1-m, exp: abrupt4xCO2, start_year: 240,
      #    end_year: 389}
      - {dataset: CanESM2, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: CanESM2, exp: abrupt4xCO2, start_year: 1850, end_year: 1999}
      # data not available completely on DKRZ
      # - {dataset: CCSM4, exp: piControl, start_year: 800, end_year: 949}
      # - {dataset: CCSM4, exp: abrupt4xCO2, start_year: 1850, end_year: 1999}
      - {dataset: CNRM-CM5, exp: piControl, start_year: 1850, end_year: 1999}
      - {dataset: CNRM-CM5, exp: abrupt4xCO2, start_year: 1850, end_year: 1999}
      - {dataset: GFDL-ESM2G, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2G, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2M, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2M, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: GISS-E2-R, exp: piControl, start_year: 3331, end_year: 3480}
      - {dataset: GISS-E2-R, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: inmcm4, exp: piControl, start_year: 2090, end_year: 2239}
      - {dataset: inmcm4, exp: abrupt4xCO2, start_year: 2090, end_year: 2239}
      # IPSL-CM5A-MR only 140 years available
      - {dataset: IPSL-CM5A-MR, exp: piControl, start_year: 1850,
         end_year: 1989}
      - {dataset: IPSL-CM5A-MR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1989}
      - {dataset: IPSL-CM5B-LR, exp: piControl, start_year: 1850,
         end_year: 1999}
      - {dataset: IPSL-CM5B-LR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: MIROC-ESM, exp: piControl, start_year: 1800, end_year: 1949}
      - {dataset: MIROC-ESM, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: MIROC5, exp: piControl, start_year: 2100, end_year: 2249}
      - {dataset: MIROC5, exp: abrupt4xCO2, start_year: 2100, end_year: 2249}
      - {dataset: MPI-ESM-LR, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: MPI-ESM-LR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: MPI-ESM-MR, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: MPI-ESM-MR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: MRI-CGCM3, exp: piControl, start_year: 1851,
         end_year: 2000}
      - {dataset: MRI-CGCM3, exp: abrupt4xCO2, start_year: 1851,
         end_year: 2000}
      - {dataset: NorESM1-M, exp: piControl, start_year: 700, end_year: 849}
      - {dataset: NorESM1-M, exp: abrupt4xCO2, start_year: 1, end_year: 150}

    scripts:
      deangelisf2ext:
        script: deangelis15nat/deangelisf2ext.py


  deangelisf3f4:
    description: Plot fig 3 and fig 4 of DeAngelis et al., 2015
    variables:
      rsnstcs: &spatial_mean3_cmip5_r1i1p1_amon_t2ms
        preprocessor: spatial_mean
        project: CMIP5
        ensemble: r1i1p1
        mip: Amon
        derive: true
        force_derivation: false
      rsnstcsnorm: &tropical_cmip5_r1i1p1_amon_t2ms
        preprocessor: tropical_ocean
        project: CMIP5
        ensemble: r1i1p1
        mip: Amon
        derive: true
        force_derivation: false
        additional_datasets:
          - {dataset: CERES-EBAF, project: obs4MIPs, type: satellite,
             level: L3B, version: Ed2-8, start_year: 2001,
             end_year: 2009, tier: 1}
      tas:
        <<: *spatial_mean3_cmip5_r1i1p1_amon_t2ms
        derive: false
      prw:
        <<: *tropical_cmip5_r1i1p1_amon_t2ms
        derive: false
        additional_datasets:
          - {dataset: ERA-Interim, project: OBS6, type: reanaly, version: 1,
             start_year: 2001, end_year: 2009, tier: 3}
          - {dataset: SSMI, project: obs4MIPs, type: satellite, level: L3,
             version: RSSv07r00, start_year: 2001, end_year: 2009, tier: 1}
    additional_datasets:
      - {dataset: GFDL-CM3, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-CM3, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: ACCESS1-0, exp: piControl, start_year: 300, end_year: 449}
      - {dataset: ACCESS1-0, exp: abrupt4xCO2, start_year: 300, end_year: 449}
      - {dataset: ACCESS1-3, exp: piControl, start_year: 250, end_year: 399}
      - {dataset: ACCESS1-3, exp: abrupt4xCO2, start_year: 250, end_year: 399}
      # strange values in lvp
      # - {dataset: bcc-csm1-1, exp: piControl, start_year: 160, end_year: 309}
      # - {dataset: bcc-csm1-1, exp: abrupt4xCO2, start_year: 160, end_year: 309}
      # - {dataset: bcc-csm1-1-m, exp: piControl, start_year: 240, end_year: 389}
      # - {dataset: bcc-csm1-1-m, exp: abrupt4xCO2, start_year: 240,
      #    end_year: 389}
      - {dataset: CanESM2, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: CanESM2, exp: abrupt4xCO2, start_year: 1850, end_year: 1999}
      # data not available completely on DKRZ
      # - {dataset: CCSM4, exp: piControl, start_year: 800, end_year: 949}
      # - {dataset: CCSM4, exp: abrupt4xCO2, start_year: 1850, end_year: 1999}
      - {dataset: CNRM-CM5, exp: piControl, start_year: 1850, end_year: 1999}
      - {dataset: CNRM-CM5, exp: abrupt4xCO2, start_year: 1850, end_year: 1999}
      - {dataset: GFDL-ESM2G, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2G, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2M, exp: piControl, start_year: 1, end_year: 150}
      - {dataset: GFDL-ESM2M, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: GISS-E2-R, exp: piControl, start_year: 3331, end_year: 3480}
      - {dataset: GISS-E2-R, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: inmcm4, exp: piControl, start_year: 2090, end_year: 2239}
      - {dataset: inmcm4, exp: abrupt4xCO2, start_year: 2090, end_year: 2239}
      # IPSL-CM5A-MR only 140 years available
      - {dataset: IPSL-CM5A-MR, exp: piControl, start_year: 1850,
         end_year: 1989}
      - {dataset: IPSL-CM5A-MR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1989}
      - {dataset: IPSL-CM5B-LR, exp: piControl, start_year: 1850,
         end_year: 1999}
      - {dataset: IPSL-CM5B-LR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: MIROC-ESM, exp: piControl, start_year: 1800, end_year: 1949}
      - {dataset: MIROC-ESM, exp: abrupt4xCO2, start_year: 1, end_year: 150}
      - {dataset: MIROC5, exp: piControl, start_year: 2100, end_year: 2249}
      - {dataset: MIROC5, exp: abrupt4xCO2, start_year: 2100, end_year: 2249}
      - {dataset: MPI-ESM-LR, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: MPI-ESM-LR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: MPI-ESM-MR, exp: piControl, start_year: 2015, end_year: 2164}
      - {dataset: MPI-ESM-MR, exp: abrupt4xCO2, start_year: 1850,
         end_year: 1999}
      - {dataset: MRI-CGCM3, exp: piControl, start_year: 1851, end_year: 2000}
      - {dataset: MRI-CGCM3, exp: abrupt4xCO2, start_year: 1851,
         end_year: 2000}
      - {dataset: NorESM1-M, exp: piControl, start_year: 700, end_year: 849}
      - {dataset: NorESM1-M, exp: abrupt4xCO2, start_year: 1, end_year: 150}

    scripts:
      deangelisf3f4:
        script: deangelis15nat/deangelisf3f4.py