New plot_type 1d_profile in monitor (#3178)

Co-authored-by: Manuel Schlund <32543114+schlunma@users.noreply.github.com>
Co-authored-by: Valeriu Predoi <valeriu.predoi@gmail.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: valeriupredoi <valeriupredoi@users.noreply.github.com>
Co-authored-by: Manuel Schlund <manuel.schlund@dlr.de>

doc/sphinx/source/recipes/recipe_monitor.rst

@@ -197,9 +197,16 @@ Annual cycle of tas including a reference dataset.
 
 Global climatology of tas including a reference dataset.
 
-.. _fig_profile_with_ref:
-.. figure::  /recipes/figures/monitor/profile_with_ref.png
+.. _fig_zonal_mean_profile_with_ref:
+.. figure::  /recipes/figures/monitor/zonalmean_profile_with_ref.png
    :align:   center
    :width:   14cm
 
-Vertical profile of ta including a reference dataset.
+Zonal mean profile of ta including a reference dataset.
+
+.. _fig_1d_profile_with_ref:
+.. figure::  /recipes/figures/monitor/1d_profile_with_ref.png
+   :align:   center
+   :width:   14cm
+
+1D profile of ta including a reference dataset.

esmvaltool/recipes/monitor/recipe_monitor_with_refs.yml

@@ -7,12 +7,15 @@ documentation:
     (ongoing) model simulations.
   authors:
     - schlund_manuel
+    - winterstein_franziska
   maintainer:
     - schlund_manuel
 
 
 datasets:
-  - {project: CMIP6, dataset: EC-Earth3, exp: historical, ensemble: r1i1p1f1, start_year: 1979, end_year: 2014, plot_label: 'EC-Earth3 historical'}  # Note: plot_label currently only used by diagnostic plot_multiple_annual_cycles
+  # Note: plot_label currently only used by diagnostic plot_multiple_annual_cycles
+  - {project: CMIP6, dataset: EC-Earth3, exp: historical, ensemble: r1i1p1f1, grid: gr, plot_label: 'EC-Earth3 historical'}
+  - {project: CMIP6, dataset: CanESM5,   exp: historical, ensemble: r1i1p1f1, grid: gn, plot_label: 'Reference (CanESM5 historical)', reference_for_monitor_diags: true}
 
 
 preprocessors:
@@ -53,6 +56,17 @@ preprocessors:
     zonal_statistics:
       operator: mean
 
+  extract_1d_profile:
+    custom_order: true
+    climate_statistics:
+      period: full
+    area_statistics:
+      operator: mean
+    extract_levels:
+      levels: {cmor_table: CMIP6, coordinate: plev39}
+      scheme: linear
+      coordinate: air_pressure
+
 
 diagnostics:
 
@@ -62,9 +76,7 @@ diagnostics:
       tas:
         mip: Amon
         preprocessor: timeseries_regular
-        grid: gr
-        additional_datasets:
-          - {project: native6, dataset: ERA5, type: reanaly, version: v1, tier: 3, start_year: 1979, end_year: 2014}
+        timerange: '2000/2014'
     scripts:
       plot: &plot_multi_dataset_default
         script: monitor/multi_datasets.py
@@ -77,7 +89,7 @@ diagnostics:
             plot_kwargs:
               EC-Earth3:  # = dataset since 'facet_used_for_labels' is 'dataset' by default
                 color: C0
-              ERA5:
+              CanESM5:
                 color: black
 
   plot_multiple_annual_cycles:
@@ -86,9 +98,7 @@ diagnostics:
       tas:
         mip: Amon
         preprocessor: annual_cycle_nh
-        grid: gr
-        additional_datasets:
-          - {project: native6, dataset: ERA5, type: reanaly, version: v1, tier: 3, start_year: 1979, end_year: 2014, plot_label: 'Reference (ERA5)'}
+        timerange: '2000/2014'
     scripts:
       plot:
         <<: *plot_multi_dataset_default
@@ -100,7 +110,7 @@ diagnostics:
             plot_kwargs:
               'EC-Earth3 historical':  # = plot_label since 'facet_used_for_labels: plot_label'
                 color: C0
-              'Reference (ERA5)':
+              'Reference (CanESM5 historical)':
                 color: black
             pyplot_kwargs:
               title: Near-Surface Air Temperature on Northern Hemisphere
@@ -112,9 +122,7 @@ diagnostics:
       tas:
         mip: Amon
         preprocessor: full_climatology
-        grid: gr
-        additional_datasets:
-          - {project: native6, dataset: ERA5, type: reanaly, version: v1, tier: 3, start_year: 1979, end_year: 2014, reference_for_monitor_diags: true}
+        timerange: '2000/2014'
     scripts:
       plot:
         <<: *plot_multi_dataset_default
@@ -125,21 +133,38 @@ diagnostics:
             plot_kwargs_bias:
               levels: [-10.0, -7.5, -5.0, -2.5, 0.0, 2.5, 5.0, 7.5, 10.0]
 
-  plot_profiles_with_references:
-    description: Plot vertical profiles including reference datasets.
+  plot_zonal_mean_profiles_with_references:
+    description: Plot 2D zonal mean profiles including reference datasets.
     variables:
       ta:
         mip: Amon
         preprocessor: zonal_mean
-        grid: gr
-        additional_datasets:
-          - {project: native6, dataset: ERA5, type: reanaly, version: v1, tier: 3, start_year: 1979, end_year: 2014, reference_for_monitor_diags: true}
+        timerange: '2000/2014'
     scripts:
       plot:
         <<: *plot_multi_dataset_default
         script: monitor/multi_datasets.py
         plots:
-          profile:
+          zonal_mean_profile:
             common_cbar: true
             plot_kwargs_bias:
               levels: [-10.0, -7.5, -5.0, -2.5, 0.0, 2.5, 5.0, 7.5, 10.0]
+
+  plot_1D_profiles_with_references:
+    description: Plot 1D profiles including reference datasets.
+    variables:
+      ta:
+        mip: Amon
+        preprocessor: extract_1d_profile
+        timerange: '2000/2014'
+    scripts:
+      plot:
+        <<: *plot_multi_dataset_default
+        script: monitor/multi_datasets.py
+        plots:
+          1d_profile:
+            plot_kwargs:
+              EC-Earth3:  # = dataset since 'facet_used_for_labels' is 'dataset' by default
+                color: C0
+              CanESM5:
+                color: black