From 3b6f87faaf79c759d65730e249453d79f0e29440 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 12 Jul 2019 11:18:36 +0200
Subject: [PATCH 01/47] First working version

---
 .../primavera/eady_growth_rate.py             | 130 ++++++++++++++++++
 .../recipes/recipe_eady_growth_rate.yml       |  61 ++++++++
 2 files changed, 191 insertions(+)
 create mode 100644 esmvaltool/diag_scripts/primavera/eady_growth_rate.py
 create mode 100644 esmvaltool/recipes/recipe_eady_growth_rate.yml

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
new file mode 100644
index 0000000000..19c436df12
--- /dev/null
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -0,0 +1,130 @@
+import os
+import logging
+import string
+
+import iris
+import iris.cube
+import iris.analysis
+import iris.util
+
+import numpy as np
+
+import numba
+from numba import guvectorize, float64
+
+
+from dask import array as da
+
+import esmvaltool.diag_scripts.shared
+import esmvaltool.diag_scripts.shared.names as n
+from esmvaltool.diag_scripts.shared import group_metadata
+
+logger = logging.getLogger(os.path.basename(__file__))
+
+
+class EadyGrowthRate(object):
+    def __init__(self, config):
+        self.cfg = config
+        self.filenames = esmvaltool.diag_scripts.shared.Datasets(self.cfg)
+        self.g = 9.80665
+        self.con = 0.3098
+        self.omega = 7.292e-5
+
+    def compute(self):
+        data = group_metadata(self.cfg['input_data'].values(), 'dataset')
+        for key in data:
+
+            ta = iris.load_cube(data[key][0]['filename'])
+            plev = ta.dim_coords[1]
+            min_plev = plev.points.min()
+
+            theta = self.potential_temperature(ta, plev)
+
+            del ta
+
+            zg = iris.load_cube(data[key][1]['filename'])
+
+            brunt =  self.brunt_vaisala_frq(theta, zg)
+
+            del theta
+
+            lats = zg.dim_coords[2]
+            fcor = self.coriolis(lats, zg.shape)
+
+            ua = iris.load_cube(data[key][2]['filename'])
+
+            egr = self.eady_growth_rate(fcor, ua, zg, brunt)
+
+
+            iris.save(iris.cube.Cube(egr), '/scratch/Earth/sloosvel/esmvaltool/output/brun.nc')
+
+
+
+
+
+
+        a=1
+
+
+    def potential_temperature(self, ta, plev):
+        p0 = iris.coords.AuxCoord(1000.0, long_name='reference_pressure',
+                                  units='hPa')
+        p0.convert_units(plev.units)
+        p = (p0.points/plev.points)**(2/7)
+        theta = ta * iris.util.broadcast_to_shape(p, ta.shape, (1,))
+        theta.long_name = 'potential_air_temperature'
+        return theta
+
+    def vertical_integration(self, x, y):
+        # Weird attempt to perform a non-cyclic centered difference to integrate along pressure levels
+        plevs = x.shape[1]
+        dxdy_0 = (x[:, 1, :, :].lazy_data() - x[:, 0, :, :].lazy_data()) / (y[:, 1, :, :].lazy_data() - y[:, 0, :, :].lazy_data())
+
+
+        dxdy_centre = (x[:, 2:plevs, :, :].lazy_data() - x[:, 0:plevs-2, :, :].lazy_data()) / (y[:, 2:plevs, :, :].lazy_data() - y[:, 0:plevs-2, :, :].lazy_data())
+        dxdy_end = (x[:, plevs-1, :, :].lazy_data() - x[:, plevs-2, :, :].lazy_data()) / (y[:, plevs-1, :, :].lazy_data() - y[:, plevs-2, :, :].lazy_data())
+
+        bounds = [dxdy_end, dxdy_0]
+        stacked_bounds = da.stack(bounds, axis=1)
+        total = [dxdy_centre, stacked_bounds]
+
+        dxdy = da.concatenate(total, axis=1)
+
+        dxdy = da.roll(dxdy, 1, axis=1)
+
+        return dxdy
+
+    def brunt_vaisala_frq(self, theta, zg):
+        dthdz = self.vertical_integration(theta, zg)
+        dthdz = da.where(dthdz > 0, dthdz, 0)
+        buoy = (self.g / theta.lazy_data()) * dthdz
+        brunt = da.sqrt(buoy)
+        brunt = da.where(brunt != 0, brunt, 1e20)
+
+        return brunt
+
+    def coriolis(self, lats, ndim):
+        fcor = 2*self.omega*np.sin(np.radians(lats.points))
+        fcor = fcor[np.newaxis, np.newaxis, :, np.newaxis]
+        fcor = da.broadcast_to(fcor, ndim)
+
+
+        return fcor
+
+    def eady_growth_rate(self, fcor, ua, zg, brunt):
+        dudz = self.vertical_integration(ua, zg)
+        egr = self.con * abs(fcor) * abs(dudz) / brunt
+
+        return egr
+
+
+
+
+
+def main():
+    with esmvaltool.diag_scripts.shared.run_diagnostic() as config:
+        EadyGrowthRate(config).compute()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
new file mode 100644
index 0000000000..edd1c7a16b
--- /dev/null
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -0,0 +1,61 @@
+# ESMValTool
+---
+documentation:
+  description: |
+    This is an example recipe for a personal diagnostic.
+    You can run any Python diagnostic of your choice
+    without installing ESMValTool as developer or git pushing.
+    Simply include the full path to your script of choice in script,
+    see example /path/to/your/my_little_diagnostic.py
+    An example personal diagnostic can be found in
+    esmvaltool/diag_scripts/examples/my_little_diagnostic.py
+
+  authors:
+    - pred_va
+
+  maintainer:
+    - pred_va
+
+datasets:
+  - {dataset: MPI-ESM-LR,  project: CMIP5, exp: decadal1997,  ensemble: r1i1p1,  mip: Amon, start_year: 2000,  end_year: 2002}
+
+preprocessors:
+  annual_mean:
+    annual_mean:
+#  summer_mean:
+#    seasonal_mean: 'JJA'
+#  winter_mean:
+#    seasonal_mean: 'DJF'
+
+diagnostics:
+  annual_EGR:
+    variables:
+      ta:
+        preprocessor: annual_mean
+      zg:
+        preprocessor: annual_mean
+      ua:
+        preprocessor: annual_mean
+    scripts:
+      annual_eady_growth_rate:
+        script: primavera/eady_growth_rate.py
+
+ # summer_EGR:
+ #   variables:
+ #     ta:
+ #       preprocessor: summer_mean
+ #     zg:
+ #       preprocessor: summer_mean
+ #     ua:
+ #       preprocessor: summer_mean
+ #   script: primavera/eady_growth_rate.py
+
+ # winter_EGR:
+ #   variables:
+ #     ta:
+ #       preprocessor: winter_mean
+ #     zg:
+ #       preprocessor: winter_mean
+ #     ua:
+ #       preprocessor: winter_mean
+ #   script: primavera/eady_growth_rate.py

From b22adde5840421b53f7c926825bb97a460ad7344 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 12 Jul 2019 16:29:48 +0200
Subject: [PATCH 02/47] Perform temporal mean

---
 .../primavera/eady_growth_rate.py             | 71 +++++++++++--------
 1 file changed, 42 insertions(+), 29 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 19c436df12..0eb3dbd919 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -9,16 +9,14 @@
 
 import numpy as np
 
-import numba
-from numba import guvectorize, float64
-
-
 from dask import array as da
 
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
 from esmvaltool.diag_scripts.shared import group_metadata
 
+from esmvalcore.preprocessor import _time
+
 logger = logging.getLogger(os.path.basename(__file__))
 
 
@@ -26,48 +24,41 @@ class EadyGrowthRate(object):
     def __init__(self, config):
         self.cfg = config
         self.filenames = esmvaltool.diag_scripts.shared.Datasets(self.cfg)
+        self.fill_value = 1e20
+        self.ref_p = 1000.0
         self.g = 9.80665
         self.con = 0.3098
         self.omega = 7.292e-5
 
     def compute(self):
         data = group_metadata(self.cfg['input_data'].values(), 'dataset')
-        for key in data:
-
-            ta = iris.load_cube(data[key][0]['filename'])
+        for dataset in data:
+            ta = iris.load_cube(data[dataset][0]['filename'])
             plev = ta.dim_coords[1]
-            min_plev = plev.points.min()
 
             theta = self.potential_temperature(ta, plev)
 
             del ta
 
-            zg = iris.load_cube(data[key][1]['filename'])
+            zg = iris.load_cube(data[dataset][1]['filename'])
 
-            brunt =  self.brunt_vaisala_frq(theta, zg)
-
-            del theta
+            brunt = self.brunt_vaisala_frq(theta, zg)
 
             lats = zg.dim_coords[2]
             fcor = self.coriolis(lats, zg.shape)
 
-            ua = iris.load_cube(data[key][2]['filename'])
+            ua = iris.load_cube(data[dataset][2]['filename'])
 
             egr = self.eady_growth_rate(fcor, ua, zg, brunt)
 
+            cube_egr = ua.copy(egr * 86400)
 
-            iris.save(iris.cube.Cube(egr), '/scratch/Earth/sloosvel/esmvaltool/output/brun.nc')
-
-
-
-
-
-
-        a=1
+            cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
 
+            self.save(cube_egr, dataset)
 
     def potential_temperature(self, ta, plev):
-        p0 = iris.coords.AuxCoord(1000.0, long_name='reference_pressure',
+        p0 = iris.coords.AuxCoord(self.ref_p, long_name='reference_pressure',
                                   units='hPa')
         p0.convert_units(plev.units)
         p = (p0.points/plev.points)**(2/7)
@@ -76,20 +67,32 @@ def potential_temperature(self, ta, plev):
         return theta
 
     def vertical_integration(self, x, y):
-        # Weird attempt to perform a non-cyclic centered difference to integrate along pressure levels
+        # Perform a non-cyclic centered finite-difference to integrate
+        # along pressure levels
+
         plevs = x.shape[1]
-        dxdy_0 = (x[:, 1, :, :].lazy_data() - x[:, 0, :, :].lazy_data()) / (y[:, 1, :, :].lazy_data() - y[:, 0, :, :].lazy_data())
 
+        dxdy_0 = ((x[:, 1, :, :].lazy_data() - x[:, 0, :, :].lazy_data()) /
+                  (y[:, 1, :, :].lazy_data() - y[:, 0, :, :].lazy_data()))
+
+        dxdy_centre = ((x[:, 2:plevs, :, :].lazy_data() -
+                       x[:, 0:plevs-2, :, :].lazy_data()) /
+                       (y[:, 2:plevs, :, :].lazy_data() -
+                       y[:, 0:plevs-2, :, :].lazy_data()))
 
-        dxdy_centre = (x[:, 2:plevs, :, :].lazy_data() - x[:, 0:plevs-2, :, :].lazy_data()) / (y[:, 2:plevs, :, :].lazy_data() - y[:, 0:plevs-2, :, :].lazy_data())
-        dxdy_end = (x[:, plevs-1, :, :].lazy_data() - x[:, plevs-2, :, :].lazy_data()) / (y[:, plevs-1, :, :].lazy_data() - y[:, plevs-2, :, :].lazy_data())
+        dxdy_end = ((x[:, plevs-1, :, :].lazy_data() -
+                    x[:, plevs-2, :, :].lazy_data()) /
+                    (y[:, plevs-1, :, :].lazy_data() -
+                    y[:, plevs-2, :, :].lazy_data()))
 
         bounds = [dxdy_end, dxdy_0]
         stacked_bounds = da.stack(bounds, axis=1)
         total = [dxdy_centre, stacked_bounds]
 
+        # Concatenate arrays where the last slice is dxdy_0
         dxdy = da.concatenate(total, axis=1)
 
+        # Move dxdy_0 to the beggining of the array
         dxdy = da.roll(dxdy, 1, axis=1)
 
         return dxdy
@@ -99,16 +102,15 @@ def brunt_vaisala_frq(self, theta, zg):
         dthdz = da.where(dthdz > 0, dthdz, 0)
         buoy = (self.g / theta.lazy_data()) * dthdz
         brunt = da.sqrt(buoy)
-        brunt = da.where(brunt != 0, brunt, 1e20)
+        brunt = da.where(brunt != 0, brunt, self.fill_value)
 
         return brunt
 
     def coriolis(self, lats, ndim):
-        fcor = 2*self.omega*np.sin(np.radians(lats.points))
+        fcor = 2.0*self.omega*np.sin(np.radians(lats.points))
         fcor = fcor[np.newaxis, np.newaxis, :, np.newaxis]
         fcor = da.broadcast_to(fcor, ndim)
 
-
         return fcor
 
     def eady_growth_rate(self, fcor, ua, zg, brunt):
@@ -117,8 +119,19 @@ def eady_growth_rate(self, fcor, ua, zg, brunt):
 
         return egr
 
+    def save(self, egr, dataset):
+        egr.standard_name = None
+        egr.long_name = 'eady_growth_rate'
+        egr.var_name = 'egr'
+        egr.units = 'day-1'
 
+        script = self.cfg[n.SCRIPT]
+        filename = '{dataset}_{script}.nc'.format(
+            dataset=dataset,
+            script=script
+        )
 
+        iris.save(egr, os.path.join(self.cfg[n.WORK_DIR], filename))
 
 
 def main():

From 41a832bbb9d430902e9071a2515902fd8f1ead7d Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 12 Jul 2019 16:32:17 +0200
Subject: [PATCH 03/47] Fix some lint issues

---
 esmvaltool/diag_scripts/primavera/eady_growth_rate.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 0eb3dbd919..4778ddc11d 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -15,7 +15,6 @@
 import esmvaltool.diag_scripts.shared.names as n
 from esmvaltool.diag_scripts.shared import group_metadata
 
-from esmvalcore.preprocessor import _time
 
 logger = logging.getLogger(os.path.basename(__file__))
 
@@ -76,14 +75,14 @@ def vertical_integration(self, x, y):
                   (y[:, 1, :, :].lazy_data() - y[:, 0, :, :].lazy_data()))
 
         dxdy_centre = ((x[:, 2:plevs, :, :].lazy_data() -
-                       x[:, 0:plevs-2, :, :].lazy_data()) /
+                        x[:, 0:plevs-2, :, :].lazy_data()) /
                        (y[:, 2:plevs, :, :].lazy_data() -
-                       y[:, 0:plevs-2, :, :].lazy_data()))
+                        y[:, 0:plevs-2, :, :].lazy_data()))
 
         dxdy_end = ((x[:, plevs-1, :, :].lazy_data() -
-                    x[:, plevs-2, :, :].lazy_data()) /
+                     x[:, plevs-2, :, :].lazy_data()) /
                     (y[:, plevs-1, :, :].lazy_data() -
-                    y[:, plevs-2, :, :].lazy_data()))
+                     y[:, plevs-2, :, :].lazy_data()))
 
         bounds = [dxdy_end, dxdy_0]
         stacked_bounds = da.stack(bounds, axis=1)

From 36c5444d6f3e9fdaa4700da4172e280f370d6ca7 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Mon, 15 Jul 2019 12:38:39 +0200
Subject: [PATCH 04/47] Extract season properly

---
 .../recipes/recipe_eady_growth_rate.yml       | 44 +++++++++++--------
 1 file changed, 25 insertions(+), 19 deletions(-)

diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index edd1c7a16b..09b7fabacd 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -22,34 +22,40 @@ datasets:
 preprocessors:
   annual_mean:
     annual_mean:
-#  summer_mean:
-#    seasonal_mean: 'JJA'
-#  winter_mean:
-#    seasonal_mean: 'DJF'
+  summer_mean:
+    extract_season:
+      season: 'JJA'
+    seasonal_mean:
+  winter_mean:
+    extract_season:
+      season: 'DJF'
+    seasonal_mean:
 
 diagnostics:
-  annual_EGR:
+ # annual_EGR:
+ #   variables:
+ #     ta:
+ #       preprocessor: annual_mean
+ #     zg:
+ #       preprocessor: annual_mean
+ #     ua:
+ #       preprocessor: annual_mean
+ #   scripts:
+ #     annual_eady_growth_rate:
+ #       script: primavera/eady_growth_rate.py
+
+  summer_EGR:
     variables:
       ta:
-        preprocessor: annual_mean
+        preprocessor: summer_mean
       zg:
-        preprocessor: annual_mean
+        preprocessor: summer_mean
       ua:
-        preprocessor: annual_mean
+        preprocessor: summer_mean
     scripts:
-      annual_eady_growth_rate:
+      summer_eady_growth_rate:
         script: primavera/eady_growth_rate.py
 
- # summer_EGR:
- #   variables:
- #     ta:
- #       preprocessor: summer_mean
- #     zg:
- #       preprocessor: summer_mean
- #     ua:
- #       preprocessor: summer_mean
- #   script: primavera/eady_growth_rate.py
-
  # winter_EGR:
  #   variables:
  #     ta:

From 81e1e874e67014f23fdfb811b25d6f3888215b0f Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Mon, 15 Jul 2019 13:07:45 +0200
Subject: [PATCH 05/47] Add recipe documentation

---
 esmvaltool/config-references.yml              | 13 +++-
 .../recipes/recipe_eady_growth_rate.yml       | 60 +++++++++----------
 2 files changed, 41 insertions(+), 32 deletions(-)

diff --git a/esmvaltool/config-references.yml b/esmvaltool/config-references.yml
index f0558ed81c..56e458331d 100644
--- a/esmvaltool/config-references.yml
+++ b/esmvaltool/config-references.yml
@@ -218,6 +218,10 @@ authors:
     name: Lledó, Llorenç
     institute: BSC, Spain
     email: llorenç.lledo 'at' bsc.es
+  loos_sa:
+    name: Loosveldt-Tomas, Saskia
+    institute: BSC, Spain
+    email: saskia.loosveldt 'at' bsc.es
   lore_ru:
     name: Lorenz, Ruth
     institute: ETH Zurich, Switzerland
@@ -300,6 +304,10 @@ authors:
     name: Roehrig, Romain
     institute: MeteoFr, France
     email: romain.roehrig 'at' meteo.fr
+  sanc_em:
+    name: Sanchez, Emilia
+    institute: CERFACS, France
+    email: emilia.sanchez 'at' cerfacs.fr
   senf_da:
     name: Senftleben, Daniel
     institute: DLR, Germany
@@ -584,7 +592,7 @@ references:
   lloyd-hughes02jclim: "Lloyd-Hughes, B. and Saunders, M. A., Int. J. Climatol., 22, 1571-1592, doi:10.1002/joc.846, 2002."
   locarini10usgov: "Locarnini, R. A. et al., World Ocean Atlas 2009, Volume 1: Temperature. S. Levitus, Ed. NOAA Atlas NESDIS 68, U.S. Government Printing Office, Washington, D.C., 184 pp.,2010."
   lucarini14revgeop: "Lucarini et al., Rev. Geophys., 52, 809-859, doi:https://doi.org/10.1002/2013RG000446"
-  mehran14jgr: "Mehran, A. et al., J. Geophys. Res., 119, 4, 1695-1707, doi: 10.1002/2013JD021152, 2014." 
+  mehran14jgr: "Mehran, A. et al., J. Geophys. Res., 119, 4, 1695-1707, doi: 10.1002/2013JD021152, 2014."
   manubens:  "Manubens, N., et al., ENVIRON MODELL SOFTW 103, 29-42. doi:10.1016/j.envsoft.2018.01.018"
   mckee93: "McKee, T. B. and Doesken, N. J. and Kleist, J.  In Proceedings of the 8th Conference on Applied Climatology, 17(22), 179-183, Boston, MA: American Meteorological Society, 1993."
   mueller14grl: "Mueller, B. and Seneviratne, S. I. Geophys. Res. Lett., 41, 128-134, doi:10.1002/2013GL058055, 2014."
@@ -633,7 +641,7 @@ references:
   patmos-x: "Heidinger et al., NOAA National Centers for Environmental Information, doi:10.7289/V5348HCK, last access: 10 February 2019."
   woa: "Locarnini et al., World Ocean Atlas 2013, Vol. 1: Temperature, 2013."
   zhang-2011: "Zhang et al., WIREs Clim. Change, doi:10.1002/wcc.147, 2011"
-  sillman-2013: "Sillmann et al., J. Geophys. Res., doi:10.1029/2012JD018390, 2013" 
+  sillman-2013: "Sillmann et al., J. Geophys. Res., doi:10.1029/2012JD018390, 2013"
 
 projects:
   c3s-magic: Copernicus Climate Change Service 34a Lot 2 (MAGIC) project
@@ -647,6 +655,7 @@ projects:
   esmval: DLR project ESMVal
   eval4cmip: DLR and University of Bremen project funded by the Initiative and Networking Fund of the Helmholtz Society
   qa4ecv: QA4ECV
+  primavera: EU H2020 project PRIMAVERA
   trr181: DFG Project TRR-181
   ukesm: UKESM, UK Earth System Model project (NERC)
 
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 09b7fabacd..c6c2a8f573 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -2,22 +2,22 @@
 ---
 documentation:
   description: |
-    This is an example recipe for a personal diagnostic.
-    You can run any Python diagnostic of your choice
-    without installing ESMValTool as developer or git pushing.
-    Simply include the full path to your script of choice in script,
-    see example /path/to/your/my_little_diagnostic.py
-    An example personal diagnostic can be found in
-    esmvaltool/diag_scripts/examples/my_little_diagnostic.py
+    Recipe to compute the annual, summer and winter Eady Growth Rates. The
+    output produces netcdf files for each model and season.
+
 
   authors:
-    - pred_va
+    - sanc_em
 
   maintainer:
-    - pred_va
+    - loos_sa
+
+  projects:
+    - primavera
 
 datasets:
-  - {dataset: MPI-ESM-LR,  project: CMIP5, exp: decadal1997,  ensemble: r1i1p1,  mip: Amon, start_year: 2000,  end_year: 2002}
+  - {dataset: CNRM-CM5,  project: CMIP5, exp: historical,  ensemble: r1i1p1,
+     mip: Amon, start_year: 1979,  end_year: 2005}
 
 preprocessors:
   annual_mean:
@@ -32,17 +32,17 @@ preprocessors:
     seasonal_mean:
 
 diagnostics:
- # annual_EGR:
- #   variables:
- #     ta:
- #       preprocessor: annual_mean
- #     zg:
- #       preprocessor: annual_mean
- #     ua:
- #       preprocessor: annual_mean
- #   scripts:
- #     annual_eady_growth_rate:
- #       script: primavera/eady_growth_rate.py
+  annual_EGR:
+    variables:
+      ta:
+        preprocessor: annual_mean
+      zg:
+        preprocessor: annual_mean
+      ua:
+        preprocessor: annual_mean
+    scripts:
+      annual_eady_growth_rate:
+        script: primavera/eady_growth_rate.py
 
   summer_EGR:
     variables:
@@ -56,12 +56,12 @@ diagnostics:
       summer_eady_growth_rate:
         script: primavera/eady_growth_rate.py
 
- # winter_EGR:
- #   variables:
- #     ta:
- #       preprocessor: winter_mean
- #     zg:
- #       preprocessor: winter_mean
- #     ua:
- #       preprocessor: winter_mean
- #   script: primavera/eady_growth_rate.py
+  winter_EGR:
+    variables:
+      ta:
+        preprocessor: winter_mean
+      zg:
+        preprocessor: winter_mean
+      ua:
+        preprocessor: winter_mean
+    script: primavera/eady_growth_rate.py

From 5ad70bae3cbde4cbffe819b2f071f048223d12be Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Mon, 12 Aug 2019 16:55:23 +0200
Subject: [PATCH 06/47] Load vars by shortname

---
 .../diag_scripts/primavera/eady_growth_rate.py   | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 4778ddc11d..fb8c7fce05 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -30,23 +30,24 @@ def __init__(self, config):
         self.omega = 7.292e-5
 
     def compute(self):
-        data = group_metadata(self.cfg['input_data'].values(), 'dataset')
-        for dataset in data:
-            ta = iris.load_cube(data[dataset][0]['filename'])
+        data = group_metadata(self.cfg['input_data'].values(), 'alias')
+        for alias in data:
+            var = group_metadata(data[alias], 'short_name')
+            ta = iris.load_cube(var['ta'][0]['filename'])
             plev = ta.dim_coords[1]
 
             theta = self.potential_temperature(ta, plev)
 
             del ta
 
-            zg = iris.load_cube(data[dataset][1]['filename'])
+            zg = iris.load_cube(var['zg'][0]['filename'])
 
             brunt = self.brunt_vaisala_frq(theta, zg)
 
             lats = zg.dim_coords[2]
             fcor = self.coriolis(lats, zg.shape)
 
-            ua = iris.load_cube(data[dataset][2]['filename'])
+            ua = iris.load_cube(var['ua'][0]['filename'])
 
             egr = self.eady_growth_rate(fcor, ua, zg, brunt)
 
@@ -54,7 +55,7 @@ def compute(self):
 
             cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
 
-            self.save(cube_egr, dataset)
+            self.save(cube_egr, alias, data)
 
     def potential_temperature(self, ta, plev):
         p0 = iris.coords.AuxCoord(self.ref_p, long_name='reference_pressure',
@@ -118,13 +119,14 @@ def eady_growth_rate(self, fcor, ua, zg, brunt):
 
         return egr
 
-    def save(self, egr, dataset):
+    def save(self, egr, alias, data):
         egr.standard_name = None
         egr.long_name = 'eady_growth_rate'
         egr.var_name = 'egr'
         egr.units = 'day-1'
 
         script = self.cfg[n.SCRIPT]
+        dataset = data[alias][0]['dataset']
         filename = '{dataset}_{script}.nc'.format(
             dataset=dataset,
             script=script

From 4f4bb8c5c4ca3432fe53eb1de8c4173b7b473696 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 28 Aug 2019 10:29:42 +0200
Subject: [PATCH 07/47] Fix winter script

---
 esmvaltool/recipes/recipe_eady_growth_rate.yml | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index c6c2a8f573..7ac315eb30 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -32,7 +32,7 @@ preprocessors:
     seasonal_mean:
 
 diagnostics:
-  annual_EGR:
+  annual_egr:
     variables:
       ta:
         preprocessor: annual_mean
@@ -44,7 +44,7 @@ diagnostics:
       annual_eady_growth_rate:
         script: primavera/eady_growth_rate.py
 
-  summer_EGR:
+  summer_egr:
     variables:
       ta:
         preprocessor: summer_mean
@@ -56,7 +56,7 @@ diagnostics:
       summer_eady_growth_rate:
         script: primavera/eady_growth_rate.py
 
-  winter_EGR:
+  winter_egr:
     variables:
       ta:
         preprocessor: winter_mean
@@ -64,4 +64,6 @@ diagnostics:
         preprocessor: winter_mean
       ua:
         preprocessor: winter_mean
-    script: primavera/eady_growth_rate.py
+    scripts:
+      winter_eady_growth_rate:
+        script: primavera/eady_growth_rate.py

From 5be048a33bb557b7d0b13a5fc68e23264e3962f8 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 28 Aug 2019 12:01:36 +0200
Subject: [PATCH 08/47] Improve output file name

---
 .../primavera/eady_growth_rate.py             | 35 ++++++++++++++++---
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index fb8c7fce05..da6ff5bddf 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -14,6 +14,7 @@
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
 from esmvaltool.diag_scripts.shared import group_metadata
+# from esmvaltool.diag_scripts.shared._base import ProvenanceLogger
 
 
 logger = logging.getLogger(os.path.basename(__file__))
@@ -64,6 +65,7 @@ def potential_temperature(self, ta, plev):
         p = (p0.points/plev.points)**(2/7)
         theta = ta * iris.util.broadcast_to_shape(p, ta.shape, (1,))
         theta.long_name = 'potential_air_temperature'
+
         return theta
 
     def vertical_integration(self, x, y):
@@ -107,7 +109,7 @@ def brunt_vaisala_frq(self, theta, zg):
         return brunt
 
     def coriolis(self, lats, ndim):
-        fcor = 2.0*self.omega*np.sin(np.radians(lats.points))
+        fcor = 2.0 * self.omega * np.sin(np.radians(lats.points))
         fcor = fcor[np.newaxis, np.newaxis, :, np.newaxis]
         fcor = da.broadcast_to(fcor, ndim)
 
@@ -126,13 +128,38 @@ def save(self, egr, alias, data):
         egr.units = 'day-1'
 
         script = self.cfg[n.SCRIPT]
+        project = data[alias][0]['project']
         dataset = data[alias][0]['dataset']
-        filename = '{dataset}_{script}.nc'.format(
+        exp = data[alias][0]['exp']
+        start = data[alias][0]['start_year']
+        end = data[alias][0]['end_year']
+        output = '{project}_{dataset}_{exp}_{script}_{start}_{end}.nc'.format(
+            project=project,
             dataset=dataset,
-            script=script
+            exp=exp,
+            script=script,
+            start=start,
+            end=end
         )
 
-        iris.save(egr, os.path.join(self.cfg[n.WORK_DIR], filename))
+        iris.save(egr, os.path.join(self.cfg[n.WORK_DIR], output))
+
+        # caption = ("{script} between {start} and {end}"
+        #           "according to {dataset}").format(
+        #               script=script.split('_'),
+        #               start=start,
+        #               end=end,
+        #               dataset=dataset
+        #           )
+
+        # record = {
+        #    'caption': caption,
+        #    'domains': ['global'],
+        #    'autors': ['sanc_em'],
+        #    'references': ['primavera'],
+        #    'ancestors': output
+        # }
+        # ProvenanceLogger(self.cfg).log(output, record)
 
 
 def main():

From 9339c6f40dc8c9ae053f94be7a0e05ba2b533950 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 11 Oct 2019 16:23:15 +0200
Subject: [PATCH 09/47] Update preproc names

---
 esmvaltool/recipes/recipe_eady_growth_rate.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 7ac315eb30..d2e61480c3 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -21,15 +21,15 @@ datasets:
 
 preprocessors:
   annual_mean:
-    annual_mean:
+    annual_statistics:
   summer_mean:
     extract_season:
       season: 'JJA'
-    seasonal_mean:
+    seasonal_statistics:
   winter_mean:
     extract_season:
       season: 'DJF'
-    seasonal_mean:
+    seasonal_statistics:
 
 diagnostics:
   annual_egr:

From e72f4df36b98f5f6d20ca071eb039d480e912c10 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Mon, 14 Oct 2019 16:35:32 +0200
Subject: [PATCH 10/47] Update recipe

---
 esmvaltool/recipes/recipe_eady_growth_rate.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index d2e61480c3..90f5760380 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -7,10 +7,10 @@ documentation:
 
 
   authors:
-    - sanc_em
+    - sanchez-gomez_emilia
 
   maintainer:
-    - loos_sa
+    - loosveldt-tomas_saskia
 
   projects:
     - primavera

From a28c92679c28d07118e887c28b75491d8bd8400e Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 15 Oct 2019 11:12:33 +0200
Subject: [PATCH 11/47] Add provenance

---
 .../primavera/eady_growth_rate.py             | 45 ++++++++++---------
 1 file changed, 23 insertions(+), 22 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index da6ff5bddf..315c36881f 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -14,7 +14,7 @@
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
 from esmvaltool.diag_scripts.shared import group_metadata
-# from esmvaltool.diag_scripts.shared._base import ProvenanceLogger
+from esmvaltool.diag_scripts.shared._base import ProvenanceLogger
 
 
 logger = logging.getLogger(os.path.basename(__file__))
@@ -35,7 +35,7 @@ def compute(self):
         for alias in data:
             var = group_metadata(data[alias], 'short_name')
             ta = iris.load_cube(var['ta'][0]['filename'])
-            plev = ta.dim_coords[1]
+            plev = ta.coord('air_pressure')
 
             theta = self.potential_temperature(ta, plev)
 
@@ -63,7 +63,7 @@ def potential_temperature(self, ta, plev):
                                   units='hPa')
         p0.convert_units(plev.units)
         p = (p0.points/plev.points)**(2/7)
-        theta = ta * iris.util.broadcast_to_shape(p, ta.shape, (1,))
+        theta = ta * iris.util.broadcast_to_shape(p, ta.shape, ta.coord_dims('air_pressure'))
         theta.long_name = 'potential_air_temperature'
 
         return theta
@@ -133,7 +133,7 @@ def save(self, egr, alias, data):
         exp = data[alias][0]['exp']
         start = data[alias][0]['start_year']
         end = data[alias][0]['end_year']
-        output = '{project}_{dataset}_{exp}_{script}_{start}_{end}.nc'.format(
+        output_name = '{project}_{dataset}_{exp}_{script}_{start}_{end}.nc'.format(
             project=project,
             dataset=dataset,
             exp=exp,
@@ -141,25 +141,26 @@ def save(self, egr, alias, data):
             start=start,
             end=end
         )
+        output_file = os.path.join(self.cfg[n.WORK_DIR], output_name)
+        iris.save(egr, output_file)
+        caption = ("{script} between {start} and {end}"
+                   "according to {dataset}").format(
+                       script=script.split('_'),
+                       start=start,
+                       end=end,
+                       dataset=dataset
+                   )
+        ancestors = [data[alias][i]['filename'] for i in range(len(data[alias]))]
+        record = {
+            'caption': caption,
+            'domains': ['global'],
+            'autors': ['sanchez-gomez_emilia'],
+            'references': ['acknow_project'],
+            'ancestors': ancestors
+         }
+        with ProvenanceLogger(self.cfg) as provenance_logger:
+            provenance_logger.log(output_file, record)
 
-        iris.save(egr, os.path.join(self.cfg[n.WORK_DIR], output))
-
-        # caption = ("{script} between {start} and {end}"
-        #           "according to {dataset}").format(
-        #               script=script.split('_'),
-        #               start=start,
-        #               end=end,
-        #               dataset=dataset
-        #           )
-
-        # record = {
-        #    'caption': caption,
-        #    'domains': ['global'],
-        #    'autors': ['sanc_em'],
-        #    'references': ['primavera'],
-        #    'ancestors': output
-        # }
-        # ProvenanceLogger(self.cfg).log(output, record)
 
 
 def main():

From cf00614b7b0d8777c9284a1fc338130c6e228378 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 15 Oct 2019 12:42:54 +0200
Subject: [PATCH 12/47] Fix lint issues

---
 .../primavera/eady_growth_rate.py             | 32 ++++++++++++-------
 1 file changed, 20 insertions(+), 12 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 315c36881f..2f833a655a 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -1,6 +1,5 @@
 import os
 import logging
-import string
 
 import iris
 import iris.cube
@@ -59,11 +58,14 @@ def compute(self):
             self.save(cube_egr, alias, data)
 
     def potential_temperature(self, ta, plev):
-        p0 = iris.coords.AuxCoord(self.ref_p, long_name='reference_pressure',
+        p0 = iris.coords.AuxCoord(self.ref_p, 
+                                  long_name='reference_pressure',
                                   units='hPa')
         p0.convert_units(plev.units)
         p = (p0.points/plev.points)**(2/7)
-        theta = ta * iris.util.broadcast_to_shape(p, ta.shape, ta.coord_dims('air_pressure'))
+        theta = ta * iris.util.broadcast_to_shape(p, 
+                                                  ta.shape, 
+                                                  ta.coord_dims('air_pressure'))
         theta.long_name = 'potential_air_temperature'
 
         return theta
@@ -133,16 +135,20 @@ def save(self, egr, alias, data):
         exp = data[alias][0]['exp']
         start = data[alias][0]['start_year']
         end = data[alias][0]['end_year']
-        output_name = '{project}_{dataset}_{exp}_{script}_{start}_{end}.nc'.format(
-            project=project,
-            dataset=dataset,
-            exp=exp,
-            script=script,
-            start=start,
-            end=end
-        )
+        output_name = '{project}_'
+                      '{dataset}_'
+                      '{exp}_'
+                      '{script}_'
+                      '{start}_'
+                      '{end}.nc'.format(project=project,
+                                        dataset=dataset,
+                                        exp=exp,
+                                        script=script,
+                                        start=start,
+                                        end=end)
         output_file = os.path.join(self.cfg[n.WORK_DIR], output_name)
         iris.save(egr, output_file)
+
         caption = ("{script} between {start} and {end}"
                    "according to {dataset}").format(
                        script=script.split('_'),
@@ -150,7 +156,9 @@ def save(self, egr, alias, data):
                        end=end,
                        dataset=dataset
                    )
-        ancestors = [data[alias][i]['filename'] for i in range(len(data[alias]))]
+        for i in range(len(data[alias])):
+            ancestors = [data[alias][i]['filename']]
+
         record = {
             'caption': caption,
             'domains': ['global'],

From ee46ae3b43d4d02bc83bf87234dec5baed07e6f8 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 16 Oct 2019 11:00:33 +0200
Subject: [PATCH 13/47] Fix identation

---
 .../diag_scripts/primavera/eady_growth_rate.py       | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 2f833a655a..10b50a71d9 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -44,7 +44,7 @@ def compute(self):
 
             brunt = self.brunt_vaisala_frq(theta, zg)
 
-            lats = zg.dim_coords[2]
+            lats = zg.coord('latitude')
             fcor = self.coriolis(lats, zg.shape)
 
             ua = iris.load_cube(var['ua'][0]['filename'])
@@ -135,11 +135,11 @@ def save(self, egr, alias, data):
         exp = data[alias][0]['exp']
         start = data[alias][0]['start_year']
         end = data[alias][0]['end_year']
-        output_name = '{project}_'
-                      '{dataset}_'
-                      '{exp}_'
-                      '{script}_'
-                      '{start}_'
+        output_name = '{project}_' \
+                      '{dataset}_' \
+                      '{exp}_' \
+                      '{script}_' \
+                      '{start}_' \
                       '{end}.nc'.format(project=project,
                                         dataset=dataset,
                                         exp=exp,

From b2ffc0b1e6f48625237cf43baa17c3cc14068b23 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 16 Oct 2019 12:31:25 +0200
Subject: [PATCH 14/47] Fix lint issues

---
 esmvaltool/diag_scripts/primavera/eady_growth_rate.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 10b50a71d9..30b6f33027 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -58,14 +58,16 @@ def compute(self):
             self.save(cube_egr, alias, data)
 
     def potential_temperature(self, ta, plev):
-        p0 = iris.coords.AuxCoord(self.ref_p, 
+        p0 = iris.coords.AuxCoord(self.ref_p,
                                   long_name='reference_pressure',
                                   units='hPa')
         p0.convert_units(plev.units)
         p = (p0.points/plev.points)**(2/7)
-        theta = ta * iris.util.broadcast_to_shape(p, 
-                                                  ta.shape, 
-                                                  ta.coord_dims('air_pressure'))
+        theta = ta * iris.util.broadcast_to_shape(
+                    p,
+                    ta.shape,
+                    ta.coord_dims('air_pressure')
+                    )
         theta.long_name = 'potential_air_temperature'
 
         return theta
@@ -170,7 +172,6 @@ def save(self, egr, alias, data):
             provenance_logger.log(output_file, record)
 
 
-
 def main():
     with esmvaltool.diag_scripts.shared.run_diagnostic() as config:
         EadyGrowthRate(config).compute()

From e02c40627425ae822fabd865c4d17e12f5a69a64 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 18 Oct 2019 09:51:08 +0200
Subject: [PATCH 15/47] Fix identation

---
 esmvaltool/diag_scripts/primavera/eady_growth_rate.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 30b6f33027..b2eda7ec96 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -64,10 +64,10 @@ def potential_temperature(self, ta, plev):
         p0.convert_units(plev.units)
         p = (p0.points/plev.points)**(2/7)
         theta = ta * iris.util.broadcast_to_shape(
-                    p,
-                    ta.shape,
-                    ta.coord_dims('air_pressure')
-                    )
+            p,
+            ta.shape,
+            ta.coord_dims('air_pressure')
+            )
         theta.long_name = 'potential_air_temperature'
 
         return theta
@@ -167,7 +167,7 @@ def save(self, egr, alias, data):
             'autors': ['sanchez-gomez_emilia'],
             'references': ['acknow_project'],
             'ancestors': ancestors
-         }
+            }
         with ProvenanceLogger(self.cfg) as provenance_logger:
             provenance_logger.log(output_file, record)
 

From 24c2e27b0dfb45e56e4afd302d4932acb0df202c Mon Sep 17 00:00:00 2001
From: sloosvel <45196700+sloosvel@users.noreply.github.com>
Date: Fri, 18 Oct 2019 10:20:17 +0200
Subject: [PATCH 16/47] Update
 esmvaltool/diag_scripts/primavera/eady_growth_rate.py

Co-Authored-By: Bouwe Andela <bouweandela@users.noreply.github.com>
---
 esmvaltool/diag_scripts/primavera/eady_growth_rate.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index b2eda7ec96..8e6b5c7600 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -13,7 +13,7 @@
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
 from esmvaltool.diag_scripts.shared import group_metadata
-from esmvaltool.diag_scripts.shared._base import ProvenanceLogger
+from esmvaltool.diag_scripts.shared import ProvenanceLogger
 
 
 logger = logging.getLogger(os.path.basename(__file__))

From e3c469324c789b8315b91c84ba1ed5734a64d110 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 18 Oct 2019 17:46:22 +0200
Subject: [PATCH 17/47] Update recipe with PRIMAVERA datasets

---
 esmvaltool/recipes/recipe_eady_growth_rate.yml | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 90f5760380..c78957bec9 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -16,8 +16,17 @@ documentation:
     - primavera
 
 datasets:
-  - {dataset: CNRM-CM5,  project: CMIP5, exp: historical,  ensemble: r1i1p1,
-     mip: Amon, start_year: 1979,  end_year: 2005}
+  - {dataset: CMCC-CM2-HR4,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn,start_year: 1950,  end_year: 2014}
+  - {dataset: CNRM-CM6-1,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
+  - {dataset: CNRM-CM6-1-HR,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
+  - {dataset: ECMWF-IFS-HR,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
+  - {dataset: ECMWF-IFS-LR,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
+  - {dataset: HadGEM3-GC31-HM,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
+  - {dataset: HadGEM3-GC31-LM,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
+  - {dataset: HadGEM3-GC31-MM,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
+  - {dataset: MPI-ESM1-2-XR,  institute: MPI-M, project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
+  - {dataset: MPI-ESM1-2-HR,  institute: MPI-M, project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
+
 
 preprocessors:
   annual_mean:

From 37cdb166c601bd6fcc975f55405943f843803b59 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 18 Oct 2019 17:48:24 +0200
Subject: [PATCH 18/47] Consider models that need ua to be regridded

---
 esmvaltool/diag_scripts/primavera/eady_growth_rate.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
index 8e6b5c7600..ba7fef49e8 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate.py
@@ -10,6 +10,8 @@
 
 from dask import array as da
 
+from esmvalcore.preprocessor import regrid
+
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
 from esmvaltool.diag_scripts.shared import group_metadata
@@ -48,6 +50,8 @@ def compute(self):
             fcor = self.coriolis(lats, zg.shape)
 
             ua = iris.load_cube(var['ua'][0]['filename'])
+            if ua.shape is not zg.shape:
+                ua = regrid(ua, zg, scheme='linear')
 
             egr = self.eady_growth_rate(fcor, ua, zg, brunt)
 

From ddf46fdc00bab2b6e7d0c109224520348223587f Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 18 Oct 2019 18:01:44 +0200
Subject: [PATCH 19/47] Update references properly

---
 esmvaltool/config-references.yml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/esmvaltool/config-references.yml b/esmvaltool/config-references.yml
index e420886e7c..0ebe790076 100644
--- a/esmvaltool/config-references.yml
+++ b/esmvaltool/config-references.yml
@@ -245,8 +245,7 @@ authors:
   lledo_llorenc:
     name: Lledo, Llorenc
     institute: BSC, Spain
-    orcid: 
-    email: 
+    orcid:
   loosveldt-tomas_saskia:
     name: Loosveldt-Tomas, Saskia
     institute: BSC, Spain
@@ -712,8 +711,8 @@ projects:
   esmval: DLR project ESMVal
   eval4cmip: DLR and University of Bremen project funded by the Initiative and Networking Fund of the Helmholtz Society
   ewatercycle: eWaterCycle project
-  qa4ecv: QA4ECV
   primavera: EU H2020 project PRIMAVERA
+  qa4ecv: QA4ECV
   trr181: DFG Project TRR-181
   ukesm: UKESM, UK Earth System Model project (NERC)
 

From 0c6d5092823862da8c736aa37805545c3b814d20 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 23 Oct 2019 15:13:18 +0200
Subject: [PATCH 20/47] Fix yamllint issues

---
 .../recipes/recipe_eady_growth_rate.yml       | 32 +++++++++++++------
 1 file changed, 22 insertions(+), 10 deletions(-)

diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index c78957bec9..91a37421ce 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -16,16 +16,28 @@ documentation:
     - primavera
 
 datasets:
-  - {dataset: CMCC-CM2-HR4,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn,start_year: 1950,  end_year: 2014}
-  - {dataset: CNRM-CM6-1,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
-  - {dataset: CNRM-CM6-1-HR,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
-  - {dataset: ECMWF-IFS-HR,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
-  - {dataset: ECMWF-IFS-LR,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950,  end_year: 2014}
-  - {dataset: HadGEM3-GC31-HM,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
-  - {dataset: HadGEM3-GC31-LM,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
-  - {dataset: HadGEM3-GC31-MM,  project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
-  - {dataset: MPI-ESM1-2-XR,  institute: MPI-M, project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
-  - {dataset: MPI-ESM1-2-HR,  institute: MPI-M, project: CMIP6, exp: highresSST-present,  ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950,  end_year: 2014}
+  - {dataset: CMCC-CM2-HR4, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+  - {dataset: CNRM-CM6-1, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+  - {dataset: CNRM-CM6-1-HR, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+  - {dataset: ECMWF-IFS-HR, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+  - {dataset: ECMWF-IFS-LR, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+  - {dataset: HadGEM3-GC31-HM, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+  - {dataset: HadGEM3-GC31-LM, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+  - {dataset: HadGEM3-GC31-MM, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+  - {dataset: MPI-ESM1-2-XR, institute: MPI-M, project: CMIP6,
+     exp: highresSST-present, ensemble: r1i1p1f1, mip: Amon, grid: gn,
+     start_year: 1950, end_year: 2014}
+  - {dataset: MPI-ESM1-2-HR, institute: MPI-M, project: CMIP6,
+     exp: highresSST-present, ensemble: r1i1p1f1, mip: Amon, grid: gn,
+     start_year: 1950, end_year: 2014}
 
 
 preprocessors:

From 4d4dd0c89f8910bf6cdc4b37d336a3dbc72058cf Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Thu, 7 Nov 2019 17:01:28 +0100
Subject: [PATCH 21/47] Remove institute

---
 esmvaltool/recipes/recipe_eady_growth_rate.yml | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 91a37421ce..5e485be25e 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -32,12 +32,10 @@ datasets:
      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
   - {dataset: HadGEM3-GC31-MM, project: CMIP6, exp: highresSST-present,
      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-  - {dataset: MPI-ESM1-2-XR, institute: MPI-M, project: CMIP6,
-     exp: highresSST-present, ensemble: r1i1p1f1, mip: Amon, grid: gn,
-     start_year: 1950, end_year: 2014}
-  - {dataset: MPI-ESM1-2-HR, institute: MPI-M, project: CMIP6,
-     exp: highresSST-present, ensemble: r1i1p1f1, mip: Amon, grid: gn,
-     start_year: 1950, end_year: 2014}
+  - {dataset: MPI-ESM1-2-XR, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+  - {dataset: MPI-ESM1-2-HR, project: CMIP6, exp: highresSST-present,
+     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
 
 
 preprocessors:

From dae04f40f710d68ab622298a2855ba30cc09a040 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 19 Nov 2019 17:37:37 +0100
Subject: [PATCH 22/47] Reorder files

---
 .../primavera/{ => eady_growth_rate}/eady_growth_rate.py    | 0
 esmvaltool/recipes/recipe_eady_growth_rate.yml              | 6 +++---
 2 files changed, 3 insertions(+), 3 deletions(-)
 rename esmvaltool/diag_scripts/primavera/{ => eady_growth_rate}/eady_growth_rate.py (100%)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
similarity index 100%
rename from esmvaltool/diag_scripts/primavera/eady_growth_rate.py
rename to esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 5e485be25e..8a88633d14 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -61,7 +61,7 @@ diagnostics:
         preprocessor: annual_mean
     scripts:
       annual_eady_growth_rate:
-        script: primavera/eady_growth_rate.py
+        script: primavera/eady_growth_rate/eady_growth_rate.py
 
   summer_egr:
     variables:
@@ -73,7 +73,7 @@ diagnostics:
         preprocessor: summer_mean
     scripts:
       summer_eady_growth_rate:
-        script: primavera/eady_growth_rate.py
+        script: primavera/eady_growth_rate/eady_growth_rate.py
 
   winter_egr:
     variables:
@@ -85,4 +85,4 @@ diagnostics:
         preprocessor: winter_mean
     scripts:
       winter_eady_growth_rate:
-        script: primavera/eady_growth_rate.py
+        script: primavera/eady_growth_rate/eady_growth_rate.py

From 1bdbf78fd2ca2de287822bbae6bac4f195e7695b Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 20 Nov 2019 15:07:31 +0100
Subject: [PATCH 23/47] Fix provenance

---
 .../primavera/eady_growth_rate/eady_growth_rate.py            | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index ba7fef49e8..621e7249c6 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -162,9 +162,9 @@ def save(self, egr, alias, data):
                        end=end,
                        dataset=dataset
                    )
+        ancestors = []
         for i in range(len(data[alias])):
-            ancestors = [data[alias][i]['filename']]
-
+            ancestors.append(data[alias][i]['filename'])
         record = {
             'caption': caption,
             'domains': ['global'],

From 777a7bc22e1c3b90909733060d321c3f460573bc Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Thu, 20 Feb 2020 13:26:25 +0100
Subject: [PATCH 24/47] Compute climatology as an option

---
 .../primavera/eady_growth_rate/eady_growth_rate.py           | 5 +++--
 esmvaltool/recipes/recipe_eady_growth_rate.yml               | 1 +
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 621e7249c6..f1d1ace567 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -30,6 +30,7 @@ def __init__(self, config):
         self.g = 9.80665
         self.con = 0.3098
         self.omega = 7.292e-5
+        self.compute_climatology = self.cfg['compute_climatology']
 
     def compute(self):
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
@@ -56,8 +57,8 @@ def compute(self):
             egr = self.eady_growth_rate(fcor, ua, zg, brunt)
 
             cube_egr = ua.copy(egr * 86400)
-
-            cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
+            if self.compute_climatology:
+                cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
 
             self.save(cube_egr, alias, data)
 
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 8a88633d14..1adbf62ff7 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -86,3 +86,4 @@ diagnostics:
     scripts:
       winter_eady_growth_rate:
         script: primavera/eady_growth_rate/eady_growth_rate.py
+        compute_climatology: True

From f7b1a7457d1fa40393ee3ee3095533e86785eae2 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Thu, 20 Feb 2020 17:30:29 +0100
Subject: [PATCH 25/47] Add option to compute means at the end

---
 .../primavera/eady_growth_rate/eady_growth_rate.py    | 11 ++++++++++-
 esmvaltool/recipes/recipe_eady_growth_rate.yml        | 11 ++++++++++-
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index f1d1ace567..02ee60d817 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -10,7 +10,8 @@
 
 from dask import array as da
 
-from esmvalcore.preprocessor import regrid
+from esmvalcore.preprocessor import (
+    regrid, annual_statistics, seasonal_statistics)
 
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
@@ -31,6 +32,8 @@ def __init__(self, config):
         self.con = 0.3098
         self.omega = 7.292e-5
         self.compute_climatology = self.cfg['compute_climatology']
+        self.compute_annual_mean = self.cfg['compute_annual_mean']
+        self.compute_seasonal_mean = self.cfg['compute_seasonal_mean']
 
     def compute(self):
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
@@ -57,6 +60,12 @@ def compute(self):
             egr = self.eady_growth_rate(fcor, ua, zg, brunt)
 
             cube_egr = ua.copy(egr * 86400)
+
+            if self.compute_annual_mean:
+                cube_egr = annual_statistics(cube_egr)
+            elif self.compute_seasonal_mean:
+                cube_egr = seasonal_statistics(cube_egr)
+
             if self.compute_climatology:
                 cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
 
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 1adbf62ff7..5bea4a4544 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -62,6 +62,10 @@ diagnostics:
     scripts:
       annual_eady_growth_rate:
         script: primavera/eady_growth_rate/eady_growth_rate.py
+        compute_annual_mean: false 
+        compute_seasonal_mean: false
+        compute_climatology: true
+
 
   summer_egr:
     variables:
@@ -74,6 +78,9 @@ diagnostics:
     scripts:
       summer_eady_growth_rate:
         script: primavera/eady_growth_rate/eady_growth_rate.py
+        compute_annual_mean: false
+        compute_seasonal_mean: false
+        compute_climatology: true
 
   winter_egr:
     variables:
@@ -86,4 +93,6 @@ diagnostics:
     scripts:
       winter_eady_growth_rate:
         script: primavera/eady_growth_rate/eady_growth_rate.py
-        compute_climatology: True
+        compute_annual_mean: false
+        compute_seasonal_mean: false
+        compute_climatology: true

From 895d26cc5988499a49b4ff6bf541b31b697c8658 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Fri, 21 Feb 2020 15:42:16 +0100
Subject: [PATCH 26/47] Fix style issues

---
 .../eady_growth_rate/eady_growth_rate.py      | 27 ++++++-------------
 1 file changed, 8 insertions(+), 19 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 02ee60d817..23946905f7 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -146,31 +146,20 @@ def save(self, egr, alias, data):
         egr.units = 'day-1'
 
         script = self.cfg[n.SCRIPT]
-        project = data[alias][0]['project']
-        dataset = data[alias][0]['dataset']
-        exp = data[alias][0]['exp']
-        start = data[alias][0]['start_year']
-        end = data[alias][0]['end_year']
-        output_name = '{project}_' \
-                      '{dataset}_' \
-                      '{exp}_' \
-                      '{script}_' \
-                      '{start}_' \
-                      '{end}.nc'.format(project=project,
-                                        dataset=dataset,
-                                        exp=exp,
-                                        script=script,
-                                        start=start,
-                                        end=end)
+        info = data[alias][0]
+        keys = [str(info[key]) for key in (
+            'project', 'dataset', 'exp', 'ensemble', 'start_year', 'end_year'
+        ) if key in info]
+        output_name = '_'.join(keys)+'.nc'
         output_file = os.path.join(self.cfg[n.WORK_DIR], output_name)
         iris.save(egr, output_file)
 
         caption = ("{script} between {start} and {end}"
                    "according to {dataset}").format(
                        script=script.split('_'),
-                       start=start,
-                       end=end,
-                       dataset=dataset
+                       start=info['start_year'],
+                       end=info['end_year'],
+                       dataset=info['dataset']
                    )
         ancestors = []
         for i in range(len(data[alias])):

From f25464222292d4a0c1217233be7bd484b385a084 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 15 Sep 2020 17:50:17 +0200
Subject: [PATCH 27/47] First version of plot, pending to clean

---
 .../eady_growth_rate/eady_growth_rate.py      | 50 ++++++++++++++++---
 .../recipes/recipe_eady_growth_rate.yml       |  1 +
 2 files changed, 43 insertions(+), 8 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 23946905f7..fc46110372 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -1,17 +1,25 @@
 import os
 import logging
 
+import matplotlib
+matplotlib.use('agg')
+
+
 import iris
 import iris.cube
 import iris.analysis
 import iris.util
+import iris.quickplot as qplt
+import matplotlib.pyplot as plt
+
+import cartopy.crs as ccrs
 
 import numpy as np
 
 from dask import array as da
 
 from esmvalcore.preprocessor import (
-    regrid, annual_statistics, seasonal_statistics)
+    regrid, annual_statistics, seasonal_statistics, extract_levels)
 
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
@@ -35,6 +43,7 @@ def __init__(self, config):
         self.compute_annual_mean = self.cfg['compute_annual_mean']
         self.compute_seasonal_mean = self.cfg['compute_seasonal_mean']
 
+
     def compute(self):
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
         for alias in data:
@@ -61,11 +70,18 @@ def compute(self):
 
             cube_egr = ua.copy(egr * 86400)
 
+            cube_egr.standard_name = None
+            cube_egr.long_name = 'eady_growth_rate'
+            cube_egr.var_name = 'egr'
+            cube_egr.units = 'day-1'
+
+
+            # pending to clean this
             if self.compute_annual_mean:
                 cube_egr = annual_statistics(cube_egr)
             elif self.compute_seasonal_mean:
                 cube_egr = seasonal_statistics(cube_egr)
-
+                self.seasonal_plots(cube_egr)
             if self.compute_climatology:
                 cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
 
@@ -139,17 +155,35 @@ def eady_growth_rate(self, fcor, ua, zg, brunt):
 
         return egr
 
-    def save(self, egr, alias, data):
-        egr.standard_name = None
-        egr.long_name = 'eady_growth_rate'
-        egr.var_name = 'egr'
-        egr.units = 'day-1'
+    def seasonal_plots(self, egr):
+        try:
+            levels = self.cfg['plot_levels']
+        except KeyError:
+            levels = egr.coord('air_pressure').points
+        for level in levels:
+            cube = extract_levels(egr, level, scheme='linear')
+            crs_latlon = ccrs.PlateCarree()
+            ax = plt.axes(projection=ccrs.PlateCarree())
+            ax.coastlines(linewidth=1, color='black')
+            # North Atlantic
+            ax.set_extent((-90.0, 30.0, 20.0, 80.0), crs=crs_latlon)
+            ax.set_yticks(np.linspace(25,75,6))
+            qplt.contourf(cube, levels=np.arange(0, np.max(cube.data), 0.05))
+            extension = self.cfg['output_file_type']
+            diagnostic = self.cfg['script']
+            plotname = '_'.join([diagnostic, str(level), f'.{extension}']) # fix this
+            plt.savefig(os.path.join(self.cfg[n.PLOT_DIR], plotname))
+            plt.close()
+
 
+
+
+    def save(self, egr, alias, data):
         script = self.cfg[n.SCRIPT]
         info = data[alias][0]
         keys = [str(info[key]) for key in (
             'project', 'dataset', 'exp', 'ensemble', 'start_year', 'end_year'
-        ) if key in info]
+        ) if key in info] # fix this
         output_name = '_'.join(keys)+'.nc'
         output_file = os.path.join(self.cfg[n.WORK_DIR], output_name)
         iris.save(egr, output_file)
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 5bea4a4544..12bfe30c3b 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -96,3 +96,4 @@ diagnostics:
         compute_annual_mean: false
         compute_seasonal_mean: false
         compute_climatology: true
+        plot_levels: [70000]

From aeaf4c683196daded9e59ae674b04022d2832cdb Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 22 Sep 2020 15:52:35 +0200
Subject: [PATCH 28/47] Clean recipe and diag

---
 .../eady_growth_rate/eady_growth_rate.py      | 100 ++++++++----------
 .../recipes/recipe_eady_growth_rate.yml       |  81 ++++++--------
 2 files changed, 81 insertions(+), 100 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index fc46110372..ebd585753f 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -1,31 +1,25 @@
-import os
 import logging
+import os
+import sys
 
-import matplotlib
-matplotlib.use('agg')
-
-
+import cartopy.crs as ccrs
 import iris
-import iris.cube
 import iris.analysis
-import iris.util
+import iris.cube
 import iris.quickplot as qplt
+import iris.util
+import matplotlib
 import matplotlib.pyplot as plt
-
-import cartopy.crs as ccrs
-
 import numpy as np
-
 from dask import array as da
 
-from esmvalcore.preprocessor import (
-    regrid, annual_statistics, seasonal_statistics, extract_levels)
-
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as n
-from esmvaltool.diag_scripts.shared import group_metadata
-from esmvaltool.diag_scripts.shared import ProvenanceLogger
+from esmvalcore.preprocessor import (annual_statistics, extract_levels, regrid,
+                                     seasonal_statistics)
+from esmvaltool.diag_scripts.shared import ProvenanceLogger, group_metadata
 
+matplotlib.use('agg')
 
 logger = logging.getLogger(os.path.basename(__file__))
 
@@ -39,10 +33,7 @@ def __init__(self, config):
         self.g = 9.80665
         self.con = 0.3098
         self.omega = 7.292e-5
-        self.compute_climatology = self.cfg['compute_climatology']
-        self.compute_annual_mean = self.cfg['compute_annual_mean']
-        self.compute_seasonal_mean = self.cfg['compute_seasonal_mean']
-
+        self.time_statistic = self.cfg['time_statistic']
 
     def compute(self):
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
@@ -75,15 +66,18 @@ def compute(self):
             cube_egr.var_name = 'egr'
             cube_egr.units = 'day-1'
 
-
-            # pending to clean this
-            if self.compute_annual_mean:
+            if self.time_statistic == 'annual_mean':
                 cube_egr = annual_statistics(cube_egr)
-            elif self.compute_seasonal_mean:
+                cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
+            elif self.time_statistic == 'seasonal_mean':
                 cube_egr = seasonal_statistics(cube_egr)
-                self.seasonal_plots(cube_egr)
-            if self.compute_climatology:
                 cube_egr = cube_egr.collapsed('time', iris.analysis.MEAN)
+                self.seasonal_plots(cube_egr, alias)
+            else:
+                logger.info(
+                    "Parameter time_statistic is not well set in the recipe."
+                    "Must be 'annual' or 'seasonal'")
+                sys.exit()
 
             self.save(cube_egr, alias, data)
 
@@ -92,12 +86,9 @@ def potential_temperature(self, ta, plev):
                                   long_name='reference_pressure',
                                   units='hPa')
         p0.convert_units(plev.units)
-        p = (p0.points/plev.points)**(2/7)
+        p = (p0.points / plev.points)**(2 / 7)
         theta = ta * iris.util.broadcast_to_shape(
-            p,
-            ta.shape,
-            ta.coord_dims('air_pressure')
-            )
+            p, ta.shape, ta.coord_dims('air_pressure'))
         theta.long_name = 'potential_air_temperature'
 
         return theta
@@ -112,14 +103,14 @@ def vertical_integration(self, x, y):
                   (y[:, 1, :, :].lazy_data() - y[:, 0, :, :].lazy_data()))
 
         dxdy_centre = ((x[:, 2:plevs, :, :].lazy_data() -
-                        x[:, 0:plevs-2, :, :].lazy_data()) /
+                        x[:, 0:plevs - 2, :, :].lazy_data()) /
                        (y[:, 2:plevs, :, :].lazy_data() -
-                        y[:, 0:plevs-2, :, :].lazy_data()))
+                        y[:, 0:plevs - 2, :, :].lazy_data()))
 
-        dxdy_end = ((x[:, plevs-1, :, :].lazy_data() -
-                     x[:, plevs-2, :, :].lazy_data()) /
-                    (y[:, plevs-1, :, :].lazy_data() -
-                     y[:, plevs-2, :, :].lazy_data()))
+        dxdy_end = ((x[:, plevs - 1, :, :].lazy_data() -
+                     x[:, plevs - 2, :, :].lazy_data()) /
+                    (y[:, plevs - 1, :, :].lazy_data() -
+                     y[:, plevs - 2, :, :].lazy_data()))
 
         bounds = [dxdy_end, dxdy_0]
         stacked_bounds = da.stack(bounds, axis=1)
@@ -155,10 +146,12 @@ def eady_growth_rate(self, fcor, ua, zg, brunt):
 
         return egr
 
-    def seasonal_plots(self, egr):
+    def seasonal_plots(self, egr, alias):
         try:
             levels = self.cfg['plot_levels']
         except KeyError:
+            logger.info("Parameter plot_levels is not set in the recipe."
+                        "Plotting all pressure levels instead.")
             levels = egr.coord('air_pressure').points
         for level in levels:
             cube = extract_levels(egr, level, scheme='linear')
@@ -167,34 +160,33 @@ def seasonal_plots(self, egr):
             ax.coastlines(linewidth=1, color='black')
             # North Atlantic
             ax.set_extent((-90.0, 30.0, 20.0, 80.0), crs=crs_latlon)
-            ax.set_yticks(np.linspace(25,75,6))
+            ax.set_yticks(np.linspace(25, 75, 6))
             qplt.contourf(cube, levels=np.arange(0, np.max(cube.data), 0.05))
             extension = self.cfg['output_file_type']
             diagnostic = self.cfg['script']
-            plotname = '_'.join([diagnostic, str(level), f'.{extension}']) # fix this
+            plotname = '_'.join([alias, diagnostic,
+                                 str(int(level))]) + f'.{extension}'
             plt.savefig(os.path.join(self.cfg[n.PLOT_DIR], plotname))
             plt.close()
 
-
-
-
     def save(self, egr, alias, data):
         script = self.cfg[n.SCRIPT]
         info = data[alias][0]
-        keys = [str(info[key]) for key in (
-            'project', 'dataset', 'exp', 'ensemble', 'start_year', 'end_year'
-        ) if key in info] # fix this
-        output_name = '_'.join(keys)+'.nc'
+        keys = [
+            str(info[key]) for key in ('project', 'dataset', 'exp', 'ensemble',
+                                       'diagnostic', 'start_year', 'end_year')
+            if key in info
+        ]
+        output_name = '_'.join(keys) + '.nc'
         output_file = os.path.join(self.cfg[n.WORK_DIR], output_name)
         iris.save(egr, output_file)
 
         caption = ("{script} between {start} and {end}"
-                   "according to {dataset}").format(
-                       script=script.split('_'),
-                       start=info['start_year'],
-                       end=info['end_year'],
-                       dataset=info['dataset']
-                   )
+                   "according to {dataset}").format(script=script.replace(
+                       " ", '_'),
+                                                    start=info['start_year'],
+                                                    end=info['end_year'],
+                                                    dataset=info['dataset'])
         ancestors = []
         for i in range(len(data[alias])):
             ancestors.append(data[alias][i]['filename'])
@@ -204,7 +196,7 @@ def save(self, egr, alias, data):
             'autors': ['sanchez-gomez_emilia'],
             'references': ['acknow_project'],
             'ancestors': ancestors
-            }
+        }
         with ProvenanceLogger(self.cfg) as provenance_logger:
             provenance_logger.log(output_file, record)
 
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 12bfe30c3b..dad979e032 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -2,12 +2,14 @@
 ---
 documentation:
   description: |
-    Recipe to compute the annual, summer and winter Eady Growth Rates. The
-    output produces netcdf files for each model and season.
+    Recipe to compute the annual mean or the seasonal mean the Eady Growth Rate (EGR). 
+    The output produces netcdf files for each model. In the case of the seasonal means, a plot is
+    produced for each specified level showing the EGR values over the North-Atlantic region.
 
 
   authors:
     - sanchez-gomez_emilia
+   # - moreno-chamarro_eduardo add to authors
 
   maintainer:
     - loosveldt-tomas_saskia
@@ -16,84 +18,71 @@ documentation:
     - primavera
 
 datasets:
-  - {dataset: CMCC-CM2-HR4, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-  - {dataset: CNRM-CM6-1, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-  - {dataset: CNRM-CM6-1-HR, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-  - {dataset: ECMWF-IFS-HR, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-  - {dataset: ECMWF-IFS-LR, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-  - {dataset: HadGEM3-GC31-HM, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-  - {dataset: HadGEM3-GC31-LM, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-  - {dataset: HadGEM3-GC31-MM, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-  - {dataset: MPI-ESM1-2-XR, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-  - {dataset: MPI-ESM1-2-HR, project: CMIP6, exp: highresSST-present,
-     ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+   - {dataset: CMCC-CM2-HR4, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+   - {dataset: CNRM-CM6-1, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+   - {dataset: CNRM-CM6-1-HR, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+   - {dataset: ECMWF-IFS-HR, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+   - {dataset: ECMWF-IFS-LR, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
+   - {dataset: HadGEM3-GC31-HM, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+   - {dataset: HadGEM3-GC31-LM, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+   - {dataset: HadGEM3-GC31-MM, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+   - {dataset: MPI-ESM1-2-XR, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
+   - {dataset: MPI-ESM1-2-HR, project: CMIP6, exp: highresSST-present,
+      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
 
 
 preprocessors:
-  annual_mean:
-    annual_statistics:
-  summer_mean:
+  summer:
     extract_season:
       season: 'JJA'
-    seasonal_statistics:
-  winter_mean:
+  winter:
     extract_season:
       season: 'DJF'
-    seasonal_statistics:
 
 diagnostics:
   annual_egr:
     variables:
       ta:
-        preprocessor: annual_mean
       zg:
-        preprocessor: annual_mean
       ua:
-        preprocessor: annual_mean
     scripts:
       annual_eady_growth_rate:
         script: primavera/eady_growth_rate/eady_growth_rate.py
-        compute_annual_mean: false 
-        compute_seasonal_mean: false
-        compute_climatology: true
+        time_statistic: 'annual_mean'
 
 
   summer_egr:
     variables:
       ta:
-        preprocessor: summer_mean
+        preprocessor: summer
       zg:
-        preprocessor: summer_mean
+        preprocessor: summer
       ua:
-        preprocessor: summer_mean
+        preprocessor: summer
     scripts:
       summer_eady_growth_rate:
         script: primavera/eady_growth_rate/eady_growth_rate.py
-        compute_annual_mean: false
-        compute_seasonal_mean: false
-        compute_climatology: true
+        time_statistic: 'seasonal_mean'
 
   winter_egr:
     variables:
       ta:
-        preprocessor: winter_mean
+        preprocessor: winter
       zg:
-        preprocessor: winter_mean
+        preprocessor: winter
       ua:
-        preprocessor: winter_mean
+        preprocessor: winter
     scripts:
       winter_eady_growth_rate:
         script: primavera/eady_growth_rate/eady_growth_rate.py
-        compute_annual_mean: false
-        compute_seasonal_mean: false
-        compute_climatology: true
+        time_statistic: 'seasonal_mean'
         plot_levels: [70000]

From babbcc52dea8fadd30b9037e8eb21ef8709d5401 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 22 Sep 2020 15:52:54 +0200
Subject: [PATCH 29/47] Add documentation, pending to add figure

---
 .../recipes/recipe_eady_growth_rate.rst       | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
new file mode 100644
index 0000000000..be823b7d21
--- /dev/null
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -0,0 +1,61 @@
+.. _recipes_eady_growth_rate:
+
+Eady growth rate
+=====
+
+Overview
+--------
+
+This recipe computes the Eady growth rate and performs the annual and seasonal means, storing 
+the results for each dataset. 
+For the seasonal means, the results are plotted over the North-Atlantic region for the selected
+levels to reproduce Figure ? from PAPER.
+
+
+Available recipes and diagnostics
+---------------------------------
+
+Recipes are stored in esmvaltool/recipes/
+
+    * recipe_eady_growth_rate.yml
+
+Diagnostics are stored in esmvaltool/diag_scripts/eady_growth_rate/
+
+    * eady_growth_rate.py: Computes and stores the eady growth rate. 
+    Plots can be produced for the seasonal mean over the North Atlantic region.
+
+
+User settings in recipe
+-----------------------
+
+#. Script eady_growth_rate.py
+
+   *Required settings for script*
+
+   * time_statistic: Set to 'annual' to compute the annual mean. Set to 'seasonal' to compute the seasonal mean.
+
+   *Optional settings for script*
+
+   * plot_levels: list of pressure levels to be plotted for the seasonal mean. If not specified, all levels will be plotted.
+
+
+Variables
+---------
+
+* ta (atmos, monthly mean, longitude latitude level time)
+* zg (atmos, monthly mean, longitude latitude level time)
+* ua (atmos, monthly mean, longitude latitude level time) 
+
+References
+----------
+
+* xxx
+
+Example plots # TO BE ADDED
+-------------
+
+.. _fig_eady_growth_rate:
+.. figure::  /recipes/figures/<mynewdiagnostic>/awesome1.png 
+   :align:   center
+
+   Add figure caption here.

From fad670bee0283ec51fa3a54359b402dce6c30861 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 23 Sep 2020 18:42:59 +0200
Subject: [PATCH 30/47] Add figure to documentation

---
 ...M3-GC31-LM_winter_eady_growth_rate_70000.png | Bin 0 -> 89993 bytes
 .../source/recipes/recipe_eady_growth_rate.rst  |   4 ++--
 2 files changed, 2 insertions(+), 2 deletions(-)
 create mode 100644 doc/sphinx/source/recipes/figures/eady_growth_rate/HadGEM3-GC31-LM_winter_eady_growth_rate_70000.png

diff --git a/doc/sphinx/source/recipes/figures/eady_growth_rate/HadGEM3-GC31-LM_winter_eady_growth_rate_70000.png b/doc/sphinx/source/recipes/figures/eady_growth_rate/HadGEM3-GC31-LM_winter_eady_growth_rate_70000.png
new file mode 100644
index 0000000000000000000000000000000000000000..6c2eb7bf9b3e5d254a279f343ae635d8f1e1b7ba
GIT binary patch
literal 89993
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
Bfm;9o

literal 0
HcmV?d00001

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index be823b7d21..95b2506566 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -51,11 +51,11 @@ References
 
 * xxx
 
-Example plots # TO BE ADDED
+Example plots
 -------------
 
 .. _fig_eady_growth_rate:
-.. figure::  /recipes/figures/<mynewdiagnostic>/awesome1.png 
+.. figure::  /recipes/figures/eady_growth_rate/HadGEM3-GC31-LM_winter_eady_growth_rate_70000.png 
    :align:   center
 
    Add figure caption here.

From 44fde952a93f8362544024d5624d29d07d0f279b Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 24 Nov 2020 12:00:39 +0100
Subject: [PATCH 31/47] Add missing author

---
 .zenodo.json                                              | 4 ++++
 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst     | 8 ++------
 esmvaltool/config-references.yml                          | 4 ++++
 .../primavera/eady_growth_rate/eady_growth_rate.py        | 4 ++--
 esmvaltool/recipes/recipe_eady_growth_rate.yml            | 2 +-
 5 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/.zenodo.json b/.zenodo.json
index b89a54d409..26395f4aab 100644
--- a/.zenodo.json
+++ b/.zenodo.json
@@ -238,6 +238,10 @@
             "name": "Mohr, Christian Wilhelm",
             "orcid": "0000-0003-2656-1802"
         },
+        {
+            "affiliation": "BSC, Spain",
+            "name": "Moreno-Chamarro, Eduardo"
+        },
         {
             "affiliation": "University of Arizona, USA",
             "name": "Amarjiit, Pandde"
diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index 95b2506566..ba5d00c6fc 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -9,7 +9,7 @@ Overview
 This recipe computes the Eady growth rate and performs the annual and seasonal means, storing 
 the results for each dataset. 
 For the seasonal means, the results are plotted over the North-Atlantic region for the selected
-levels to reproduce Figure ? from PAPER.
+pressure levels.
 
 
 Available recipes and diagnostics
@@ -46,10 +46,6 @@ Variables
 * zg (atmos, monthly mean, longitude latitude level time)
 * ua (atmos, monthly mean, longitude latitude level time) 
 
-References
-----------
-
-* xxx
 
 Example plots
 -------------
@@ -58,4 +54,4 @@ Example plots
 .. figure::  /recipes/figures/eady_growth_rate/HadGEM3-GC31-LM_winter_eady_growth_rate_70000.png 
    :align:   center
 
-   Add figure caption here.
+   Eady Growth Rate values over the North-Atlantic region at 
diff --git a/esmvaltool/config-references.yml b/esmvaltool/config-references.yml
index d0c92b8ffd..c3cbbed855 100644
--- a/esmvaltool/config-references.yml
+++ b/esmvaltool/config-references.yml
@@ -321,6 +321,10 @@ authors:
     name: Mello, Felipe
     institute: INPE, Brazil
     orcid: https://orcid.org/0000-0002-8832-2869
+  moreno-chamarro_eduardo:
+    name: Moreno-Chamarro, Eduardo
+    institute: BSC, Spain
+    orcid:
   dalvi_mohit:
     name: Dalvi, Mohit
     institute: MetOffice, UK
diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index ebd585753f..2acba8cca6 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -76,7 +76,7 @@ def compute(self):
             else:
                 logger.info(
                     "Parameter time_statistic is not well set in the recipe."
-                    "Must be 'annual' or 'seasonal'")
+                    "Must be 'annual_mean' or 'seasonal_mean'")
                 sys.exit()
 
             self.save(cube_egr, alias, data)
@@ -193,7 +193,7 @@ def save(self, egr, alias, data):
         record = {
             'caption': caption,
             'domains': ['global'],
-            'autors': ['sanchez-gomez_emilia'],
+            'authors': ['sanchez-gomez_emilia', 'moreno-chamarro_eduardo'],
             'references': ['acknow_project'],
             'ancestors': ancestors
         }
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index dad979e032..832e6f2d26 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -9,7 +9,7 @@ documentation:
 
   authors:
     - sanchez-gomez_emilia
-   # - moreno-chamarro_eduardo add to authors
+    - moreno-chamarro_eduardo
 
   maintainer:
     - loosveldt-tomas_saskia

From 47d9154ae2c091015fed2a6886241623e2b6cc84 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 24 Nov 2020 12:07:34 +0100
Subject: [PATCH 32/47] Fix documentation

---
 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index ba5d00c6fc..9a35f202b9 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -1,7 +1,7 @@
 .. _recipes_eady_growth_rate:
 
 Eady growth rate
-=====
+==========================================================================================================================
 
 Overview
 --------
@@ -54,4 +54,4 @@ Example plots
 .. figure::  /recipes/figures/eady_growth_rate/HadGEM3-GC31-LM_winter_eady_growth_rate_70000.png 
    :align:   center
 
-   Eady Growth Rate values over the North-Atlantic region at 
+   Eady Growth Rate values over the North-Atlantic region at 70000 Pa.

From bc35afbb5bdd30531be76f549b62f695fc5e8672 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 24 Nov 2020 12:26:29 +0100
Subject: [PATCH 33/47] Fix more documentation

---
 doc/sphinx/source/recipes/index.rst                   | 1 +
 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/sphinx/source/recipes/index.rst b/doc/sphinx/source/recipes/index.rst
index 0272e86e6c..598a28675e 100644
--- a/doc/sphinx/source/recipes/index.rst
+++ b/doc/sphinx/source/recipes/index.rst
@@ -19,6 +19,7 @@ Atmosphere
    recipe_consecdrydays
    recipe_deangelis15nat
    recipe_diurnal_temperature_index
+   recipe_eady_growth_rate
    recipe_extreme_events
    recipe_eyring06jgr
    recipe_heatwaves_coldwaves
diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index 9a35f202b9..7208a5a2ed 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -22,7 +22,7 @@ Recipes are stored in esmvaltool/recipes/
 Diagnostics are stored in esmvaltool/diag_scripts/eady_growth_rate/
 
     * eady_growth_rate.py: Computes and stores the eady growth rate. 
-    Plots can be produced for the seasonal mean over the North Atlantic region.
+      Plots can be produced for the seasonal mean over the North Atlantic region.
 
 
 User settings in recipe

From ab9a78fca56e860e8916f6a745e8e6aa83c6ded8 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Tue, 24 Nov 2020 17:05:58 +0100
Subject: [PATCH 34/47] Address suggestions from code review

---
 .../eady_growth_rate/eady_growth_rate.py      | 220 +++++++++++++-----
 1 file changed, 165 insertions(+), 55 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 2acba8cca6..878ce170a9 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -8,58 +8,78 @@
 import iris.cube
 import iris.quickplot as qplt
 import iris.util
-import matplotlib
 import matplotlib.pyplot as plt
 import numpy as np
 from dask import array as da
 
 import esmvaltool.diag_scripts.shared
-import esmvaltool.diag_scripts.shared.names as n
+import esmvaltool.diag_scripts.shared.names as shared_names
 from esmvalcore.preprocessor import (annual_statistics, extract_levels, regrid,
                                      seasonal_statistics)
 from esmvaltool.diag_scripts.shared import ProvenanceLogger, group_metadata
 
-matplotlib.use('agg')
 
 logger = logging.getLogger(os.path.basename(__file__))
 
 
 class EadyGrowthRate(object):
+    """Class used to compute the Eady Growth Rate."""
     def __init__(self, config):
+        """
+        Set diagnostic parameters and constants.
+
+        Parameters
+        ----------
+            config : dict
+                Dictionary containing configuration settings
+        """
+
         self.cfg = config
         self.filenames = esmvaltool.diag_scripts.shared.Datasets(self.cfg)
         self.fill_value = 1e20
+        """Fill Value."""
         self.ref_p = 1000.0
-        self.g = 9.80665
+        """Reference Pressure [Pa]"""
+        self.gravity = 9.80665
+        """Gravity [m/s]"""
         self.con = 0.3098
+        """Constant"""
         self.omega = 7.292e-5
+        """Rotation of the Earth [rad/s]"""
         self.time_statistic = self.cfg['time_statistic']
+        """Time statistic to perform"""
 
     def compute(self):
+        """
+        Computes the Eady Growth Rate and
+        either it's annual or the seasonal mean.
+        """
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
         for alias in data:
             var = group_metadata(data[alias], 'short_name')
-            ta = iris.load_cube(var['ta'][0]['filename'])
-            plev = ta.coord('air_pressure')
+            temperature = iris.load_cube(var['ta'][0]['filename'])
+            plev = temperature.coord('air_pressure')
 
-            theta = self.potential_temperature(ta, plev)
+            theta = self.potential_temperature(temperature, plev)
 
-            del ta
+            del temperature
 
-            zg = iris.load_cube(var['zg'][0]['filename'])
+            geopotential = iris.load_cube(var['zg'][0]['filename'])
 
-            brunt = self.brunt_vaisala_frq(theta, zg)
+            brunt = self.brunt_vaisala_frq(theta, geopotential)
 
-            lats = zg.coord('latitude')
-            fcor = self.coriolis(lats, zg.shape)
+            lats = geopotential.coord('latitude')
+            fcor = self.coriolis(lats, geopotential.shape)
 
-            ua = iris.load_cube(var['ua'][0]['filename'])
-            if ua.shape is not zg.shape:
-                ua = regrid(ua, zg, scheme='linear')
+            eastward_wind = iris.load_cube(var['ua'][0]['filename'])
+            if eastward_wind.shape is not geopotential.shape:
+                eastward_wind = regrid(
+                    eastward_wind, geopotential, scheme='linear')
 
-            egr = self.eady_growth_rate(fcor, ua, zg, brunt)
+            egr = self.eady_growth_rate(
+                fcor, eastward_wind, geopotential, brunt)
 
-            cube_egr = ua.copy(egr * 86400)
+            cube_egr = eastward_wind.copy(egr * 86400)
 
             cube_egr.standard_name = None
             cube_egr.long_name = 'eady_growth_rate'
@@ -81,36 +101,70 @@ def compute(self):
 
             self.save(cube_egr, alias, data)
 
-    def potential_temperature(self, ta, plev):
-        p0 = iris.coords.AuxCoord(self.ref_p,
-                                  long_name='reference_pressure',
-                                  units='hPa')
-        p0.convert_units(plev.units)
-        p = (p0.points / plev.points)**(2 / 7)
-        theta = ta * iris.util.broadcast_to_shape(
-            p, ta.shape, ta.coord_dims('air_pressure'))
+    def potential_temperature(self, temperature, plev):
+        """Computes the potential temperature.
+
+        Parameters
+        ----------
+        temperature: iris.cube.Cube
+            Cube of air temperature ta.
+        plev: iris.coords.Coord
+            Pressure level coordinates
+
+        Returns
+        -------
+        theta: iris.cube.Cube
+            Cube of potential temperature theta.
+
+        """
+        reference_pressure = iris.coords.AuxCoord(
+            self.ref_p,
+            long_name='reference_pressure',
+            units='hPa')
+        reference_pressure.convert_units(plev.units)
+        pressure = (reference_pressure.points / plev.points)**(2 / 7)
+        theta = temperature * iris.util.broadcast_to_shape(
+            pressure,
+            temperature.shape,
+            temperature.coord_dims('air_pressure'))
         theta.long_name = 'potential_air_temperature'
 
         return theta
 
-    def vertical_integration(self, x, y):
-        # Perform a non-cyclic centered finite-difference to integrate
-        # along pressure levels
-
-        plevs = x.shape[1]
-
-        dxdy_0 = ((x[:, 1, :, :].lazy_data() - x[:, 0, :, :].lazy_data()) /
-                  (y[:, 1, :, :].lazy_data() - y[:, 0, :, :].lazy_data()))
-
-        dxdy_centre = ((x[:, 2:plevs, :, :].lazy_data() -
-                        x[:, 0:plevs - 2, :, :].lazy_data()) /
-                       (y[:, 2:plevs, :, :].lazy_data() -
-                        y[:, 0:plevs - 2, :, :].lazy_data()))
-
-        dxdy_end = ((x[:, plevs - 1, :, :].lazy_data() -
-                     x[:, plevs - 2, :, :].lazy_data()) /
-                    (y[:, plevs - 1, :, :].lazy_data() -
-                     y[:, plevs - 2, :, :].lazy_data()))
+    def vertical_integration(self, var_x, var_y):
+        """Perform a non-cyclic centered finite-difference to integrate
+        variable x with respect to variable y along pressure levels.
+
+        Parameters
+        ----------
+        x: iris.cube.Cube
+            Cube of variable x.
+        y: iris.cube.Cube
+            Cube of variable y.
+
+        Returns:
+        --------
+        dxdy: iris.cube.Cube
+            Cube of variable integrated along pressure levels.
+        """
+
+        plevs = var_x.shape[1]
+
+        dxdy_0 = (
+            (var_x[:, 1, :, :].lazy_data() - var_x[:, 0, :, :].lazy_data()) /
+            (var_y[:, 1, :, :].lazy_data() - var_y[:, 0, :, :].lazy_data()))
+
+        dxdy_centre = (
+            (var_x[:, 2:plevs, :, :].lazy_data() -
+             var_x[:, 0:plevs - 2, :, :].lazy_data()) /
+            (var_y[:, 2:plevs, :, :].lazy_data() -
+             var_y[:, 0:plevs - 2, :, :].lazy_data()))
+
+        dxdy_end = (
+            (var_x[:, plevs - 1, :, :].lazy_data() -
+             var_x[:, plevs - 2, :, :].lazy_data()) /
+            (var_y[:, plevs - 1, :, :].lazy_data() -
+             var_y[:, plevs - 2, :, :].lazy_data()))
 
         bounds = [dxdy_end, dxdy_0]
         stacked_bounds = da.stack(bounds, axis=1)
@@ -124,29 +178,81 @@ def vertical_integration(self, x, y):
 
         return dxdy
 
-    def brunt_vaisala_frq(self, theta, zg):
-        dthdz = self.vertical_integration(theta, zg)
+    def brunt_vaisala_frq(self, theta, geopotential):
+        """Compute Brunt-Väisälä frequency.
+
+        Parameters
+        ----------
+        theta: iris.cube.Cube
+            Cube of potential temperature.
+        geopotential: iris.cube.Cube
+            Cube of variable zg.
+
+        Returns:
+        --------
+        brunt: da.array
+            Array containing Brunt-Väisälä frequency.
+        """
+        dthdz = self.vertical_integration(theta, geopotential)
         dthdz = da.where(dthdz > 0, dthdz, 0)
-        buoy = (self.g / theta.lazy_data()) * dthdz
+        buoy = (self.gravity / theta.lazy_data()) * dthdz
         brunt = da.sqrt(buoy)
         brunt = da.where(brunt != 0, brunt, self.fill_value)
 
         return brunt
 
     def coriolis(self, lats, ndim):
+        """Compute Coriolis force.
+
+        Parameters
+        ----------
+        lats: iris.coord.Coord
+            Latitude coordinate.
+        ndim: int
+            Number of dimension.
+
+        Returns:
+        --------
+        fcor: da.array
+            Array containing Coriolis force.
+        """
         fcor = 2.0 * self.omega * np.sin(np.radians(lats.points))
         fcor = fcor[np.newaxis, np.newaxis, :, np.newaxis]
         fcor = da.broadcast_to(fcor, ndim)
 
         return fcor
 
-    def eady_growth_rate(self, fcor, ua, zg, brunt):
-        dudz = self.vertical_integration(ua, zg)
+    def eady_growth_rate(self, fcor, eastward_wind, geopotential, brunt):
+        """Compute Eady Growth Rate.
+
+        Parameters
+        ----------
+        eastward_wind: iris.cube.Cube
+            Cube containing variable ua.
+        geopotential: iris.cube.Cube
+            Cube containing variable zg.
+        brunt: da.array
+            Array containing Brunt-Väisäla frequency
+
+        Returns:
+        --------
+        egr: da.array
+            Array containing Eady Growth Rate.
+        """
+        dudz = self.vertical_integration(eastward_wind, geopotential)
         egr = self.con * abs(fcor) * abs(dudz) / brunt
 
         return egr
 
     def seasonal_plots(self, egr, alias):
+        """Plot seasonal Eady Growth rate values.
+        Parameters
+        ----------
+        egr: iris.cube.Cube
+            Cube containing variable egr.
+        alias: str
+            Alias of the dataset.
+        """
         try:
             levels = self.cfg['plot_levels']
         except KeyError:
@@ -156,21 +262,23 @@ def seasonal_plots(self, egr, alias):
         for level in levels:
             cube = extract_levels(egr, level, scheme='linear')
             crs_latlon = ccrs.PlateCarree()
-            ax = plt.axes(projection=ccrs.PlateCarree())
-            ax.coastlines(linewidth=1, color='black')
+            axes = plt.axes(projection=ccrs.PlateCarree())
+            axes.coastlines(linewidth=1, color='black')
             # North Atlantic
-            ax.set_extent((-90.0, 30.0, 20.0, 80.0), crs=crs_latlon)
-            ax.set_yticks(np.linspace(25, 75, 6))
+            axes.set_extent((-90.0, 30.0, 20.0, 80.0), crs=crs_latlon)
+            axes.set_yticks(np.linspace(25, 75, 6))
             qplt.contourf(cube, levels=np.arange(0, np.max(cube.data), 0.05))
             extension = self.cfg['output_file_type']
             diagnostic = self.cfg['script']
             plotname = '_'.join([alias, diagnostic,
                                  str(int(level))]) + f'.{extension}'
-            plt.savefig(os.path.join(self.cfg[n.PLOT_DIR], plotname))
+            plt.savefig(os.path.join(
+                self.cfg[shared_names.PLOT_DIR], plotname))
             plt.close()
 
     def save(self, egr, alias, data):
-        script = self.cfg[n.SCRIPT]
+        """Save results and write provenance."""
+        script = self.cfg[shared_names.SCRIPT]
         info = data[alias][0]
         keys = [
             str(info[key]) for key in ('project', 'dataset', 'exp', 'ensemble',
@@ -178,7 +286,8 @@ def save(self, egr, alias, data):
             if key in info
         ]
         output_name = '_'.join(keys) + '.nc'
-        output_file = os.path.join(self.cfg[n.WORK_DIR], output_name)
+        output_file = os.path.join(
+            self.cfg[shared_names.WORK_DIR], output_name)
         iris.save(egr, output_file)
 
         caption = ("{script} between {start} and {end}"
@@ -202,6 +311,7 @@ def save(self, egr, alias, data):
 
 
 def main():
+    """Run Eady Growth Rate diagnostic"""
     with esmvaltool.diag_scripts.shared.run_diagnostic() as config:
         EadyGrowthRate(config).compute()
 

From ba32f33cacd53e72993ef7c8d62000cde81d4c31 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 25 Nov 2020 10:28:47 +0100
Subject: [PATCH 35/47] Fix style issues

---
 .../eady_growth_rate/eady_growth_rate.py      | 77 +++++++++++--------
 1 file changed, 46 insertions(+), 31 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 878ce170a9..f912d83088 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -11,19 +11,24 @@
 import matplotlib.pyplot as plt
 import numpy as np
 from dask import array as da
+from esmvalcore.preprocessor import (
+    annual_statistics,
+    extract_levels,
+    regrid,
+    seasonal_statistics,
+)
 
 import esmvaltool.diag_scripts.shared
 import esmvaltool.diag_scripts.shared.names as shared_names
-from esmvalcore.preprocessor import (annual_statistics, extract_levels, regrid,
-                                     seasonal_statistics)
 from esmvaltool.diag_scripts.shared import ProvenanceLogger, group_metadata
 
-
 logger = logging.getLogger(os.path.basename(__file__))
 
 
 class EadyGrowthRate(object):
-    """Class used to compute the Eady Growth Rate."""
+    """
+    Class used to compute the Eady Growth Rate.
+    """
     def __init__(self, config):
         """
         Set diagnostic parameters and constants.
@@ -39,15 +44,15 @@ def __init__(self, config):
         self.fill_value = 1e20
         """Fill Value."""
         self.ref_p = 1000.0
-        """Reference Pressure [Pa]"""
+        """Reference Pressure [Pa]."""
         self.gravity = 9.80665
-        """Gravity [m/s]"""
+        """Gravity [m/s]."""
         self.con = 0.3098
-        """Constant"""
+        """Constant."""
         self.omega = 7.292e-5
-        """Rotation of the Earth [rad/s]"""
+        """Rotation of the Earth [rad/s]."""
         self.time_statistic = self.cfg['time_statistic']
-        """Time statistic to perform"""
+        """Time statistic to perform."""
 
     def compute(self):
         """
@@ -102,7 +107,8 @@ def compute(self):
             self.save(cube_egr, alias, data)
 
     def potential_temperature(self, temperature, plev):
-        """Computes the potential temperature.
+        """
+        Computes the potential temperature.
 
         Parameters
         ----------
@@ -132,7 +138,8 @@ def potential_temperature(self, temperature, plev):
         return theta
 
     def vertical_integration(self, var_x, var_y):
-        """Perform a non-cyclic centered finite-difference to integrate
+        """
+        Perform a non-cyclic centered finite-difference to integrate
         variable x with respect to variable y along pressure levels.
 
         Parameters
@@ -142,8 +149,8 @@ def vertical_integration(self, var_x, var_y):
         y: iris.cube.Cube
             Cube of variable y.
 
-        Returns:
-        --------
+        Returns
+        -------
         dxdy: iris.cube.Cube
             Cube of variable integrated along pressure levels.
         """
@@ -179,7 +186,8 @@ def vertical_integration(self, var_x, var_y):
         return dxdy
 
     def brunt_vaisala_frq(self, theta, geopotential):
-        """Compute Brunt-Väisälä frequency.
+        """
+        Compute Brunt-Väisälä frequency.
 
         Parameters
         ----------
@@ -188,8 +196,8 @@ def brunt_vaisala_frq(self, theta, geopotential):
         geopotential: iris.cube.Cube
             Cube of variable zg.
 
-        Returns:
-        --------
+        Returns
+        -------
         brunt: da.array
             Array containing Brunt-Väisälä frequency.
         """
@@ -202,7 +210,8 @@ def brunt_vaisala_frq(self, theta, geopotential):
         return brunt
 
     def coriolis(self, lats, ndim):
-        """Compute Coriolis force.
+        """
+        Compute Coriolis force.
 
         Parameters
         ----------
@@ -211,8 +220,8 @@ def coriolis(self, lats, ndim):
         ndim: int
             Number of dimension.
 
-        Returns:
-        --------
+        Returns
+        -------
         fcor: da.array
             Array containing Coriolis force.
         """
@@ -223,7 +232,8 @@ def coriolis(self, lats, ndim):
         return fcor
 
     def eady_growth_rate(self, fcor, eastward_wind, geopotential, brunt):
-        """Compute Eady Growth Rate.
+        """
+        Compute Eady Growth Rate.
 
         Parameters
         ----------
@@ -234,8 +244,8 @@ def eady_growth_rate(self, fcor, eastward_wind, geopotential, brunt):
         brunt: da.array
             Array containing Brunt-Väisäla frequency
 
-        Returns:
-        --------
+        Returns
+        -------
         egr: da.array
             Array containing Eady Growth Rate.
         """
@@ -245,7 +255,8 @@ def eady_growth_rate(self, fcor, eastward_wind, geopotential, brunt):
         return egr
 
     def seasonal_plots(self, egr, alias):
-        """Plot seasonal Eady Growth rate values.
+        """
+        Plot seasonal Eady Growth rate values.
         Parameters
         ----------
         egr: iris.cube.Cube
@@ -277,25 +288,27 @@ def seasonal_plots(self, egr, alias):
             plt.close()
 
     def save(self, egr, alias, data):
-        """Save results and write provenance."""
+        """
+        Save results and write provenance.
+        """
         script = self.cfg[shared_names.SCRIPT]
         info = data[alias][0]
         keys = [
             str(info[key]) for key in ('project', 'dataset', 'exp', 'ensemble',
                                        'diagnostic', 'start_year', 'end_year')
             if key in info
-        ]
+            ]
         output_name = '_'.join(keys) + '.nc'
         output_file = os.path.join(
             self.cfg[shared_names.WORK_DIR], output_name)
         iris.save(egr, output_file)
 
         caption = ("{script} between {start} and {end}"
-                   "according to {dataset}").format(script=script.replace(
-                       " ", '_'),
-                                                    start=info['start_year'],
-                                                    end=info['end_year'],
-                                                    dataset=info['dataset'])
+                   "according to {dataset}").format(
+                       script=script.replace(" ", '_'),
+                       start=info['start_year'],
+                       end=info['end_year'],
+                       dataset=info['dataset'])
         ancestors = []
         for i in range(len(data[alias])):
             ancestors.append(data[alias][i]['filename'])
@@ -311,7 +324,9 @@ def save(self, egr, alias, data):
 
 
 def main():
-    """Run Eady Growth Rate diagnostic"""
+    """
+    Run Eady Growth Rate diagnostic.
+    """
     with esmvaltool.diag_scripts.shared.run_diagnostic() as config:
         EadyGrowthRate(config).compute()
 

From 063d0efa4bfcf311ebba415db6b148f9e5ccd95c Mon Sep 17 00:00:00 2001
From: sloosvel <45196700+sloosvel@users.noreply.github.com>
Date: Wed, 25 Nov 2020 12:10:02 +0100
Subject: [PATCH 36/47] Update
 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst

Co-authored-by: Stef Smeets <stefsmeets@users.noreply.github.com>
---
 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index 7208a5a2ed..1f8c51361b 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -1,7 +1,7 @@
 .. _recipes_eady_growth_rate:
 
 Eady growth rate
-==========================================================================================================================
+===========
 
 Overview
 --------

From 2ae2cdd0a4e1d2acb8afac6df6d767b2466916d7 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 25 Nov 2020 12:43:58 +0100
Subject: [PATCH 37/47] Fix more style issues

---
 .../primavera/eady_growth_rate/eady_growth_rate.py     | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index f912d83088..adc7aa288c 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -26,9 +26,7 @@
 
 
 class EadyGrowthRate(object):
-    """
-    Class used to compute the Eady Growth Rate.
-    """
+    """Class used to compute the Eady Growth Rate."""
     def __init__(self, config):
         """
         Set diagnostic parameters and constants.
@@ -137,7 +135,8 @@ def potential_temperature(self, temperature, plev):
 
         return theta
 
-    def vertical_integration(self, var_x, var_y):
+    @staticmethod
+    def vertical_integration(var_x, var_y):
         """
         Perform a non-cyclic centered finite-difference to integrate
         variable x with respect to variable y along pressure levels.
@@ -296,8 +295,7 @@ def save(self, egr, alias, data):
         keys = [
             str(info[key]) for key in ('project', 'dataset', 'exp', 'ensemble',
                                        'diagnostic', 'start_year', 'end_year')
-            if key in info
-            ]
+            if key in info]
         output_name = '_'.join(keys) + '.nc'
         output_file = os.path.join(
             self.cfg[shared_names.WORK_DIR], output_name)

From c22825e4944188ceef1132c85dabdd2ecbc69ca7 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 25 Nov 2020 12:50:56 +0100
Subject: [PATCH 38/47] Fix documentation

---
 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index 1f8c51361b..9fd6b49321 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -1,7 +1,7 @@
 .. _recipes_eady_growth_rate:
 
 Eady growth rate
-===========
+================
 
 Overview
 --------

From 1d009caed50186bf4c181642b49b8de1b151da16 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 25 Nov 2020 12:57:16 +0100
Subject: [PATCH 39/47] Fix more style issues

---
 .../primavera/eady_growth_rate/eady_growth_rate.py            | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index adc7aa288c..25219c23a3 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -27,6 +27,7 @@
 
 class EadyGrowthRate(object):
     """Class used to compute the Eady Growth Rate."""
+
     def __init__(self, config):
         """
         Set diagnostic parameters and constants.
@@ -34,7 +35,8 @@ def __init__(self, config):
         Parameters
         ----------
             config : dict
-                Dictionary containing configuration settings
+                Dictionary containing configuration settings.
+
         """
 
         self.cfg = config

From fa2b28782454c05be2a38ce2d48b990a092c1530 Mon Sep 17 00:00:00 2001
From: sloosvel <45196700+sloosvel@users.noreply.github.com>
Date: Wed, 2 Dec 2020 12:23:01 +0100
Subject: [PATCH 40/47] Apply suggestions from code review

Co-authored-by: Stef Smeets <stefsmeets@users.noreply.github.com>
---
 .../source/recipes/recipe_eady_growth_rate.rst     | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index 9fd6b49321..ff80dfd839 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -15,28 +15,28 @@ pressure levels.
 Available recipes and diagnostics
 ---------------------------------
 
-Recipes are stored in esmvaltool/recipes/
+Recipes are stored in ``esmvaltool/recipes/``
 
-    * recipe_eady_growth_rate.yml
+    * ``recipe_eady_growth_rate.yml``
 
-Diagnostics are stored in esmvaltool/diag_scripts/eady_growth_rate/
+Diagnostics are stored in ``esmvaltool/diag_scripts/eady_growth_rate/``
 
-    * eady_growth_rate.py: Computes and stores the eady growth rate. 
+    * ``eady_growth_rate.py``: Computes and stores the eady growth rate. 
       Plots can be produced for the seasonal mean over the North Atlantic region.
 
 
 User settings in recipe
 -----------------------
 
-#. Script eady_growth_rate.py
+#. Script ``eady_growth_rate.py``
 
    *Required settings for script*
 
-   * time_statistic: Set to 'annual' to compute the annual mean. Set to 'seasonal' to compute the seasonal mean.
+   * ``time_statistic``: Set to `'annual'` to compute the annual mean. Set to `'seasonal'` to compute the seasonal mean.
 
    *Optional settings for script*
 
-   * plot_levels: list of pressure levels to be plotted for the seasonal mean. If not specified, all levels will be plotted.
+   * ``plot_levels``: list of pressure levels to be plotted for the seasonal mean. If not specified, all levels will be plotted.
 
 
 Variables

From 8c4f27a75d755bbcf40acf52021a1c3ef306b4df Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Wed, 9 Dec 2020 15:36:41 +0100
Subject: [PATCH 41/47] Fix more style issues

---
 .../eady_growth_rate/eady_growth_rate.py      | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 25219c23a3..d88a29ef54 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -1,3 +1,4 @@
+"""Diagnostic for PRIMAVERA Eady Growth Rate"""
 import logging
 import os
 import sys
@@ -18,14 +19,16 @@
     seasonal_statistics,
 )
 
-import esmvaltool.diag_scripts.shared
-import esmvaltool.diag_scripts.shared.names as shared_names
-from esmvaltool.diag_scripts.shared import ProvenanceLogger, group_metadata
-
+from esmvaltool.diag_scripts.shared import (
+    group_metadata,
+    names,
+    ProvenanceLogger,
+    run_diagnostic
+)
 logger = logging.getLogger(os.path.basename(__file__))
 
 
-class EadyGrowthRate(object):
+class EadyGrowthRate:
     """Class used to compute the Eady Growth Rate."""
 
     def __init__(self, config):
@@ -36,11 +39,9 @@ def __init__(self, config):
         ----------
             config : dict
                 Dictionary containing configuration settings.
-
         """
 
         self.cfg = config
-        self.filenames = esmvaltool.diag_scripts.shared.Datasets(self.cfg)
         self.fill_value = 1e20
         """Fill Value."""
         self.ref_p = 1000.0
@@ -285,14 +286,14 @@ def seasonal_plots(self, egr, alias):
             plotname = '_'.join([alias, diagnostic,
                                  str(int(level))]) + f'.{extension}'
             plt.savefig(os.path.join(
-                self.cfg[shared_names.PLOT_DIR], plotname))
+                self.cfg[names.PLOT_DIR], plotname))
             plt.close()
 
     def save(self, egr, alias, data):
         """
         Save results and write provenance.
         """
-        script = self.cfg[shared_names.SCRIPT]
+        script = self.cfg[names.SCRIPT]
         info = data[alias][0]
         keys = [
             str(info[key]) for key in ('project', 'dataset', 'exp', 'ensemble',
@@ -300,7 +301,7 @@ def save(self, egr, alias, data):
             if key in info]
         output_name = '_'.join(keys) + '.nc'
         output_file = os.path.join(
-            self.cfg[shared_names.WORK_DIR], output_name)
+            self.cfg[names.WORK_DIR], output_name)
         iris.save(egr, output_file)
 
         caption = ("{script} between {start} and {end}"
@@ -327,7 +328,7 @@ def main():
     """
     Run Eady Growth Rate diagnostic.
     """
-    with esmvaltool.diag_scripts.shared.run_diagnostic() as config:
+    with run_diagnostic() as config:
         EadyGrowthRate(config).compute()
 
 

From fd5e1f0561f627c9594a506cd0b0c717e065fd74 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Thu, 10 Dec 2020 10:19:28 +0100
Subject: [PATCH 42/47] More codacy issues

---
 .../primavera/eady_growth_rate/eady_growth_rate.py           | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index d88a29ef54..cbc00f9cdb 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -1,4 +1,4 @@
-"""Diagnostic for PRIMAVERA Eady Growth Rate"""
+"""Diagnostic for PRIMAVERA Eady Growth Rate."""
 import logging
 import os
 import sys
@@ -32,8 +32,7 @@ class EadyGrowthRate:
     """Class used to compute the Eady Growth Rate."""
 
     def __init__(self, config):
-        """
-        Set diagnostic parameters and constants.
+        """Set diagnostic parameters and constants.
 
         Parameters
         ----------

From 35169859f8031941071a5448c0fe5bed878cec19 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Mon, 15 Feb 2021 12:27:00 +0100
Subject: [PATCH 43/47] Add suggestion fro scientific review

---
 .../recipes/recipe_eady_growth_rate.rst       |  6 +++++-
 .../eady_growth_rate/eady_growth_rate.py      |  8 +++-----
 .../recipes/recipe_eady_growth_rate.yml       | 20 +++----------------
 3 files changed, 11 insertions(+), 23 deletions(-)

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index ff80dfd839..15d492d8ba 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -6,7 +6,7 @@ Eady growth rate
 Overview
 --------
 
-This recipe computes the Eady growth rate and performs the annual and seasonal means, storing 
+This recipe computes the maximum Eady Growth Rate and performs the annual and seasonal means, storing 
 the results for each dataset. 
 For the seasonal means, the results are plotted over the North-Atlantic region for the selected
 pressure levels.
@@ -46,6 +46,10 @@ Variables
 * zg (atmos, monthly mean, longitude latitude level time)
 * ua (atmos, monthly mean, longitude latitude level time) 
 
+References
+----------
+
+Brian J Hoskins and Paul J Valdes. On the existence of storm-tracks. Journal of the atmospheric sciences, 47(15):1854–1864, 1990.)
 
 Example plots
 -------------
diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index cbc00f9cdb..3d9d6c9696 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -27,7 +27,6 @@
 )
 logger = logging.getLogger(os.path.basename(__file__))
 
-
 class EadyGrowthRate:
     """Class used to compute the Eady Growth Rate."""
 
@@ -39,7 +38,6 @@ def __init__(self, config):
             config : dict
                 Dictionary containing configuration settings.
         """
-
         self.cfg = config
         self.fill_value = 1e20
         """Fill Value."""
@@ -56,8 +54,7 @@ def __init__(self, config):
 
     def compute(self):
         """
-        Computes the Eady Growth Rate and
-        either it's annual or the seasonal mean.
+        Computes the Eady Growth Rate and either it's annual or seasonal mean.
         """
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
         for alias in data:
@@ -279,7 +276,8 @@ def seasonal_plots(self, egr, alias):
             # North Atlantic
             axes.set_extent((-90.0, 30.0, 20.0, 80.0), crs=crs_latlon)
             axes.set_yticks(np.linspace(25, 75, 6))
-            qplt.contourf(cube, levels=np.arange(0, np.max(cube.data), 0.05))
+            # Relevant range
+            qplt.contourf(cube, levels=np.arange(0, 1.1, 0.05))
             extension = self.cfg['output_file_type']
             diagnostic = self.cfg['script']
             plotname = '_'.join([alias, diagnostic,
diff --git a/esmvaltool/recipes/recipe_eady_growth_rate.yml b/esmvaltool/recipes/recipe_eady_growth_rate.yml
index 832e6f2d26..7e3be8ca14 100644
--- a/esmvaltool/recipes/recipe_eady_growth_rate.yml
+++ b/esmvaltool/recipes/recipe_eady_growth_rate.yml
@@ -2,7 +2,9 @@
 ---
 documentation:
   description: |
-    Recipe to compute the annual mean or the seasonal mean the Eady Growth Rate (EGR). 
+    Recipe to compute the annual mean or the seasonal mean of the maximum Eady Growth Rate 
+    (EGR, Brian J Hoskins and Paul J Valdes. On the existence of storm-tracks. 
+    Journal of the atmospheric sciences, 47(15):1854–1864, 1990.). 
     The output produces netcdf files for each model. In the case of the seasonal means, a plot is
     produced for each specified level showing the EGR values over the North-Atlantic region.
 
@@ -18,26 +20,10 @@ documentation:
     - primavera
 
 datasets:
-   - {dataset: CMCC-CM2-HR4, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-   - {dataset: CNRM-CM6-1, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-   - {dataset: CNRM-CM6-1-HR, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f2, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-   - {dataset: ECMWF-IFS-HR, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-   - {dataset: ECMWF-IFS-LR, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f1, mip: Amon, grid: gr, start_year: 1950, end_year: 2014}
-   - {dataset: HadGEM3-GC31-HM, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
    - {dataset: HadGEM3-GC31-LM, project: CMIP6, exp: highresSST-present,
       ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
    - {dataset: HadGEM3-GC31-MM, project: CMIP6, exp: highresSST-present,
       ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-   - {dataset: MPI-ESM1-2-XR, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
-   - {dataset: MPI-ESM1-2-HR, project: CMIP6, exp: highresSST-present,
-      ensemble: r1i1p1f1, mip: Amon, grid: gn, start_year: 1950, end_year: 2014}
 
 
 preprocessors:

From 3b81d945dba76ab67685e8bd69ba1380c0e67914 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Mon, 15 Feb 2021 12:55:27 +0100
Subject: [PATCH 44/47] Codacy

---
 .../eady_growth_rate/eady_growth_rate.py      | 89 ++++++++-----------
 1 file changed, 37 insertions(+), 52 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 3d9d6c9696..ebb1e94ce5 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -20,16 +20,17 @@
 )
 
 from esmvaltool.diag_scripts.shared import (
+    ProvenanceLogger,
     group_metadata,
     names,
-    ProvenanceLogger,
-    run_diagnostic
+    run_diagnostic,
 )
+
 logger = logging.getLogger(os.path.basename(__file__))
 
+
 class EadyGrowthRate:
     """Class used to compute the Eady Growth Rate."""
-
     def __init__(self, config):
         """Set diagnostic parameters and constants.
 
@@ -53,9 +54,8 @@ def __init__(self, config):
         """Time statistic to perform."""
 
     def compute(self):
-        """
-        Computes the Eady Growth Rate and either it's annual or seasonal mean.
-        """
+        """Computes the Eady Growth Rate and either it's annual or seasonal
+        mean."""
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
         for alias in data:
             var = group_metadata(data[alias], 'short_name')
@@ -75,11 +75,12 @@ def compute(self):
 
             eastward_wind = iris.load_cube(var['ua'][0]['filename'])
             if eastward_wind.shape is not geopotential.shape:
-                eastward_wind = regrid(
-                    eastward_wind, geopotential, scheme='linear')
+                eastward_wind = regrid(eastward_wind,
+                                       geopotential,
+                                       scheme='linear')
 
-            egr = self.eady_growth_rate(
-                fcor, eastward_wind, geopotential, brunt)
+            egr = self.eady_growth_rate(fcor, eastward_wind, geopotential,
+                                        brunt)
 
             cube_egr = eastward_wind.copy(egr * 86400)
 
@@ -104,8 +105,7 @@ def compute(self):
             self.save(cube_egr, alias, data)
 
     def potential_temperature(self, temperature, plev):
-        """
-        Computes the potential temperature.
+        """Computes the potential temperature.
 
         Parameters
         ----------
@@ -118,17 +118,13 @@ def potential_temperature(self, temperature, plev):
         -------
         theta: iris.cube.Cube
             Cube of potential temperature theta.
-
         """
         reference_pressure = iris.coords.AuxCoord(
-            self.ref_p,
-            long_name='reference_pressure',
-            units='hPa')
+            self.ref_p, long_name='reference_pressure', units='hPa')
         reference_pressure.convert_units(plev.units)
         pressure = (reference_pressure.points / plev.points)**(2 / 7)
         theta = temperature * iris.util.broadcast_to_shape(
-            pressure,
-            temperature.shape,
+            pressure, temperature.shape,
             temperature.coord_dims('air_pressure'))
         theta.long_name = 'potential_air_temperature'
 
@@ -136,8 +132,7 @@ def potential_temperature(self, temperature, plev):
 
     @staticmethod
     def vertical_integration(var_x, var_y):
-        """
-        Perform a non-cyclic centered finite-difference to integrate
+        """Perform a non-cyclic centered finite-difference to integrate
         variable x with respect to variable y along pressure levels.
 
         Parameters
@@ -159,17 +154,15 @@ def vertical_integration(var_x, var_y):
             (var_x[:, 1, :, :].lazy_data() - var_x[:, 0, :, :].lazy_data()) /
             (var_y[:, 1, :, :].lazy_data() - var_y[:, 0, :, :].lazy_data()))
 
-        dxdy_centre = (
-            (var_x[:, 2:plevs, :, :].lazy_data() -
-             var_x[:, 0:plevs - 2, :, :].lazy_data()) /
-            (var_y[:, 2:plevs, :, :].lazy_data() -
-             var_y[:, 0:plevs - 2, :, :].lazy_data()))
+        dxdy_centre = ((var_x[:, 2:plevs, :, :].lazy_data() -
+                        var_x[:, 0:plevs - 2, :, :].lazy_data()) /
+                       (var_y[:, 2:plevs, :, :].lazy_data() -
+                        var_y[:, 0:plevs - 2, :, :].lazy_data()))
 
-        dxdy_end = (
-            (var_x[:, plevs - 1, :, :].lazy_data() -
-             var_x[:, plevs - 2, :, :].lazy_data()) /
-            (var_y[:, plevs - 1, :, :].lazy_data() -
-             var_y[:, plevs - 2, :, :].lazy_data()))
+        dxdy_end = ((var_x[:, plevs - 1, :, :].lazy_data() -
+                     var_x[:, plevs - 2, :, :].lazy_data()) /
+                    (var_y[:, plevs - 1, :, :].lazy_data() -
+                     var_y[:, plevs - 2, :, :].lazy_data()))
 
         bounds = [dxdy_end, dxdy_0]
         stacked_bounds = da.stack(bounds, axis=1)
@@ -184,8 +177,7 @@ def vertical_integration(var_x, var_y):
         return dxdy
 
     def brunt_vaisala_frq(self, theta, geopotential):
-        """
-        Compute Brunt-Väisälä frequency.
+        """Compute Brunt-Väisälä frequency.
 
         Parameters
         ----------
@@ -208,8 +200,7 @@ def brunt_vaisala_frq(self, theta, geopotential):
         return brunt
 
     def coriolis(self, lats, ndim):
-        """
-        Compute Coriolis force.
+        """Compute Coriolis force.
 
         Parameters
         ----------
@@ -230,8 +221,7 @@ def coriolis(self, lats, ndim):
         return fcor
 
     def eady_growth_rate(self, fcor, eastward_wind, geopotential, brunt):
-        """
-        Compute Eady Growth Rate.
+        """Compute Eady Growth Rate.
 
         Parameters
         ----------
@@ -282,31 +272,28 @@ def seasonal_plots(self, egr, alias):
             diagnostic = self.cfg['script']
             plotname = '_'.join([alias, diagnostic,
                                  str(int(level))]) + f'.{extension}'
-            plt.savefig(os.path.join(
-                self.cfg[names.PLOT_DIR], plotname))
+            plt.savefig(os.path.join(self.cfg[names.PLOT_DIR], plotname))
             plt.close()
 
     def save(self, egr, alias, data):
-        """
-        Save results and write provenance.
-        """
+        """Save results and write provenance."""
         script = self.cfg[names.SCRIPT]
         info = data[alias][0]
         keys = [
             str(info[key]) for key in ('project', 'dataset', 'exp', 'ensemble',
                                        'diagnostic', 'start_year', 'end_year')
-            if key in info]
+            if key in info
+        ]
         output_name = '_'.join(keys) + '.nc'
-        output_file = os.path.join(
-            self.cfg[names.WORK_DIR], output_name)
+        output_file = os.path.join(self.cfg[names.WORK_DIR], output_name)
         iris.save(egr, output_file)
 
         caption = ("{script} between {start} and {end}"
-                   "according to {dataset}").format(
-                       script=script.replace(" ", '_'),
-                       start=info['start_year'],
-                       end=info['end_year'],
-                       dataset=info['dataset'])
+                   "according to {dataset}").format(script=script.replace(
+                       " ", '_'),
+                                                    start=info['start_year'],
+                                                    end=info['end_year'],
+                                                    dataset=info['dataset'])
         ancestors = []
         for i in range(len(data[alias])):
             ancestors.append(data[alias][i]['filename'])
@@ -322,9 +309,7 @@ def save(self, egr, alias, data):
 
 
 def main():
-    """
-    Run Eady Growth Rate diagnostic.
-    """
+    """Run Eady Growth Rate diagnostic."""
     with run_diagnostic() as config:
         EadyGrowthRate(config).compute()
 

From 17a3f0caeaff225621264178a9d2abdaa33278f9 Mon Sep 17 00:00:00 2001
From: sloosvel <saskia.loosveldt@bsc.es>
Date: Mon, 15 Feb 2021 13:16:41 +0100
Subject: [PATCH 45/47] Remove uneeded parenthesis

---
 doc/sphinx/source/recipes/recipe_eady_growth_rate.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
index 15d492d8ba..afad17703f 100644
--- a/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
+++ b/doc/sphinx/source/recipes/recipe_eady_growth_rate.rst
@@ -49,7 +49,7 @@ Variables
 References
 ----------
 
-Brian J Hoskins and Paul J Valdes. On the existence of storm-tracks. Journal of the atmospheric sciences, 47(15):1854–1864, 1990.)
+Brian J Hoskins and Paul J Valdes. On the existence of storm-tracks. Journal of the atmospheric sciences, 47(15):1854–1864, 1990.
 
 Example plots
 -------------

From 5d02859fc2859ba460692cfc619261cb08816518 Mon Sep 17 00:00:00 2001
From: Javier Vegas-Regidor <javier.vegas@bsc.es>
Date: Tue, 16 Feb 2021 11:11:09 +0100
Subject: [PATCH 46/47] Fix doc format

---
 .../eady_growth_rate/eady_growth_rate.py      | 26 ++++++++++---------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index ebb1e94ce5..406a069ab0 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -32,7 +32,8 @@
 class EadyGrowthRate:
     """Class used to compute the Eady Growth Rate."""
     def __init__(self, config):
-        """Set diagnostic parameters and constants.
+        """
+        Set diagnostic parameters and constants.
 
         Parameters
         ----------
@@ -54,8 +55,7 @@ def __init__(self, config):
         """Time statistic to perform."""
 
     def compute(self):
-        """Computes the Eady Growth Rate and either it's annual or seasonal
-        mean."""
+        """Compute Eady Growth Rate and either it's annual or seasonal mean."""
         data = group_metadata(self.cfg['input_data'].values(), 'alias')
         for alias in data:
             var = group_metadata(data[alias], 'short_name')
@@ -105,7 +105,7 @@ def compute(self):
             self.save(cube_egr, alias, data)
 
     def potential_temperature(self, temperature, plev):
-        """Computes the potential temperature.
+        """Compute potential temperature.
 
         Parameters
         ----------
@@ -132,7 +132,10 @@ def potential_temperature(self, temperature, plev):
 
     @staticmethod
     def vertical_integration(var_x, var_y):
-        """Perform a non-cyclic centered finite-difference to integrate
+        """
+        Vertical integration.
+
+        Perform a non-cyclic centered finite-difference to integrate
         variable x with respect to variable y along pressure levels.
 
         Parameters
@@ -147,7 +150,6 @@ def vertical_integration(var_x, var_y):
         dxdy: iris.cube.Cube
             Cube of variable integrated along pressure levels.
         """
-
         plevs = var_x.shape[1]
 
         dxdy_0 = (
@@ -225,6 +227,8 @@ def eady_growth_rate(self, fcor, eastward_wind, geopotential, brunt):
 
         Parameters
         ----------
+        fcor: da.array
+            Array containing Coriolis force.
         eastward_wind: iris.cube.Cube
             Cube containing variable ua.
         geopotential: iris.cube.Cube
@@ -245,6 +249,7 @@ def eady_growth_rate(self, fcor, eastward_wind, geopotential, brunt):
     def seasonal_plots(self, egr, alias):
         """
         Plot seasonal Eady Growth rate values.
+
         Parameters
         ----------
         egr: iris.cube.Cube
@@ -288,12 +293,9 @@ def save(self, egr, alias, data):
         output_file = os.path.join(self.cfg[names.WORK_DIR], output_name)
         iris.save(egr, output_file)
 
-        caption = ("{script} between {start} and {end}"
-                   "according to {dataset}").format(script=script.replace(
-                       " ", '_'),
-                                                    start=info['start_year'],
-                                                    end=info['end_year'],
-                                                    dataset=info['dataset'])
+        script_name = script.replace(" ", '_')
+        caption = (f"{script_name} between {info['start_year']} "
+                   f"and {info['end_year']} according to {info['dataset']}")
         ancestors = []
         for i in range(len(data[alias])):
             ancestors.append(data[alias][i]['filename'])

From d6d1d628099e403d6a7f75e2d2bdb74bbe4de9ee Mon Sep 17 00:00:00 2001
From: Javier Vegas-Regidor <javier.vegas@bsc.es>
Date: Tue, 16 Feb 2021 11:11:21 +0100
Subject: [PATCH 47/47] Fix doc format

---
 .../diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
index 406a069ab0..113b8a35af 100644
--- a/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
+++ b/esmvaltool/diag_scripts/primavera/eady_growth_rate/eady_growth_rate.py
@@ -31,6 +31,7 @@
 
 class EadyGrowthRate:
     """Class used to compute the Eady Growth Rate."""
+
     def __init__(self, config):
         """
         Set diagnostic parameters and constants.