Add stash check to name()

docs/iris/src/whatsnew/contributions_2.1/newfeature_2018-May-03_stash_names.txt

@@ -0,0 +1,3 @@
+* Updated :func:`iris.cube.Cube.name` to return a STASH code if the cube has
+  one and no other valid names are present. This is now consistent with the
+  summary information.

lib/iris/_cube_coord_common.py

@@ -88,12 +88,13 @@ def name(self, default='unknown'):
         """
         Returns a human-readable name.
 
-        First it tries :attr:`standard_name`, then 'long_name', then 'var_name'
-        before falling back to the value of `default` (which itself defaults to
-        'unknown').
+        First it tries :attr:`standard_name`, then 'long_name', then
+        'var_name', then the STASH attribute before falling back to
+        the value of `default` (which itself defaults to 'unknown').
 
         """
-        return self.standard_name or self.long_name or self.var_name or default
+        return self.standard_name or self.long_name or self.var_name or \
+            str(self.attributes.get('STASH', '')) or default
 
     def rename(self, name):
         """

lib/iris/cube.py

@@ -1788,9 +1788,6 @@ def summary(self, shorten=False, name_padding=35):
 
         nameunit = '{name} / ({units})'.format(name=self.name(),
                                                units=self.units)
-        # If all unknown and a STASH attribute exists, use it.
-        if nameunit == 'unknown / (unknown)' and 'STASH' in self.attributes:
-            nameunit = '{}'.format(self.attributes['STASH'])
         cube_header = '{nameunit!s:{length}} ({dimension})'.format(
             length=name_padding,
             nameunit=nameunit,

lib/iris/tests/results/usecases/pp_to_cf_conversion/from_netcdf/002000000000.44.101.131200.1920.09.01.00.00.b_0.cml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <cubes xmlns="urn:x-iris:cubeml-0.2">
-  <cube dtype="float32" units="1" var_name="unknown">
+  <cube dtype="float32" units="1" var_name="m__s44i101">
     <attributes>
       <attribute name="Conventions" value="CF-1.5"/>
       <attribute name="STASH" value="m??s44i101"/>

lib/iris/tests/results/usecases/pp_to_cf_conversion/from_netcdf/008000000000.44.101.000128.1890.09.01.00.00.b_0.cml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <cubes xmlns="urn:x-iris:cubeml-0.2">
-  <cube dtype="float32" units="1" var_name="unknown">
+  <cube dtype="float32" units="1" var_name="m__s44i101">
     <attributes>
       <attribute name="Conventions" value="CF-1.5"/>
       <attribute name="STASH" value="m??s44i101"/>

lib/iris/tests/results/usecases/pp_to_cf_conversion/from_netcdf/st0fc699.b_0.cml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <cubes xmlns="urn:x-iris:cubeml-0.2">
-  <cube dtype="float32" units="1" var_name="unknown">
+  <cube dtype="float32" units="1" var_name="m02s00i___">
     <attributes>
       <attribute name="Conventions" value="CF-1.5"/>
       <attribute name="STASH" value="m02s00i???"/>

lib/iris/tests/results/usecases/pp_to_cf_conversion/from_netcdf/st0fc942.b_0.cml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <cubes xmlns="urn:x-iris:cubeml-0.2">
-  <cube dtype="float32" units="1" var_name="unknown">
+  <cube dtype="float32" units="1" var_name="m02s00i___">
     <attributes>
       <attribute name="Conventions" value="CF-1.5"/>
       <attribute name="STASH" value="m02s00i???"/>

lib/iris/tests/results/usecases/pp_to_cf_conversion/to_netcdf/002000000000.44.101.131200.1920.09.01.00.00.b_0.cdl

@@ -3,12 +3,12 @@ dimensions:
 	depth = 20 ;
 	latitude = 73 ;
 variables:
-	float unknown(depth, latitude) ;
-		unknown:_FillValue = 9.96921e+36f ;
-		unknown:um_stash_source = "m??s44i101" ;
-		unknown:ukmo__process_flags = "Mean_over_an_ensemble_of_parallel_runs Time_mean_field" ;
-		unknown:grid_mapping = "latitude_longitude" ;
-		unknown:coordinates = "forecast_period forecast_reference_time time" ;
+	float m__s44i101(depth, latitude) ;
+		m__s44i101:_FillValue = 9.96921e+36f ;
+		m__s44i101:um_stash_source = "m??s44i101" ;
+		m__s44i101:ukmo__process_flags = "Mean_over_an_ensemble_of_parallel_runs Time_mean_field" ;
+		m__s44i101:grid_mapping = "latitude_longitude" ;
+		m__s44i101:coordinates = "forecast_period forecast_reference_time time" ;
 	int latitude_longitude ;
 		latitude_longitude:grid_mapping_name = "latitude_longitude" ;
 		latitude_longitude:longitude_of_prime_meridian = 0. ;

lib/iris/tests/results/usecases/pp_to_cf_conversion/to_netcdf/008000000000.44.101.000128.1890.09.01.00.00.b_0.cdl

@@ -2,10 +2,10 @@ dimensions:
 	depth = 20 ;
 	time = 16 ;
 variables:
-	float unknown(depth, time) ;
-		unknown:_FillValue = 9.96921e+36f ;
-		unknown:um_stash_source = "m??s44i101" ;
-		unknown:cell_methods = "time: mean (interval: 24 hour)" ;
+	float m__s44i101(depth, time) ;
+		m__s44i101:_FillValue = 9.96921e+36f ;
+		m__s44i101:um_stash_source = "m??s44i101" ;
+		m__s44i101:cell_methods = "time: mean (interval: 24 hour)" ;
 	float depth(depth) ;
 		depth:axis = "Z" ;
 		depth:units = "m" ;

lib/iris/tests/results/usecases/pp_to_cf_conversion/to_netcdf/st0fc699.b_0.cdl

@@ -3,12 +3,12 @@ dimensions:
 	latitude = 144 ;
 	longitude = 288 ;
 variables:
-	float unknown(latitude, longitude) ;
-		unknown:_FillValue = 9.96921e+36f ;
-		unknown:um_stash_source = "m02s00i???" ;
-		unknown:cell_methods = "time: mean (interval: 2 hour)" ;
-		unknown:grid_mapping = "latitude_longitude" ;
-		unknown:coordinates = "forecast_period forecast_reference_time time" ;
+	float m02s00i___(latitude, longitude) ;
+		m02s00i___:_FillValue = 9.96921e+36f ;
+		m02s00i___:um_stash_source = "m02s00i???" ;
+		m02s00i___:cell_methods = "time: mean (interval: 2 hour)" ;
+		m02s00i___:grid_mapping = "latitude_longitude" ;
+		m02s00i___:coordinates = "forecast_period forecast_reference_time time" ;
 	int latitude_longitude ;
 		latitude_longitude:grid_mapping_name = "latitude_longitude" ;
 		latitude_longitude:longitude_of_prime_meridian = 0. ;

lib/iris/tests/results/usecases/pp_to_cf_conversion/to_netcdf/st0fc942.b_0.cdl

@@ -5,12 +5,12 @@ dimensions:
 	pseudo_level = 4 ;
 	time = 4 ;
 variables:
-	float unknown(pseudo_level, time, depth, grid_latitude) ;
-		unknown:_FillValue = 9.96921e+36f ;
-		unknown:um_stash_source = "m02s00i???" ;
-		unknown:cell_methods = "time: mean" ;
-		unknown:grid_mapping = "rotated_latitude_longitude" ;
-		unknown:coordinates = "forecast_period forecast_reference_time" ;
+	float m02s00i___(pseudo_level, time, depth, grid_latitude) ;
+		m02s00i___:_FillValue = 9.96921e+36f ;
+		m02s00i___:um_stash_source = "m02s00i???" ;
+		m02s00i___:cell_methods = "time: mean" ;
+		m02s00i___:grid_mapping = "rotated_latitude_longitude" ;
+		m02s00i___:coordinates = "forecast_period forecast_reference_time" ;
 	int rotated_latitude_longitude ;
 		rotated_latitude_longitude:grid_mapping_name = "rotated_latitude_longitude" ;
 		rotated_latitude_longitude:longitude_of_prime_meridian = 0. ;

lib/iris/tests/test_cdm.py

@@ -1,4 +1,4 @@
-# (C) British Crown Copyright 2010 - 2017, Met Office
+# (C) British Crown Copyright 2010 - 2018, Met Office
 #
 # This file is part of Iris.
 #
@@ -730,6 +730,16 @@ def test_var_name(self):
         self.t.var_name = 'bar'
         self.assertEqual(self.t.var_name, 'bar')
 
+    def test_default_name(self):
+        self.t.long_name = ''
+        self.assertEqual(self.t.name(), 'unknown')
+        self.assertEqual(self.t.name('a_default'), 'a_default')
+
+    def test_stash_name(self):
+        self.t.long_name = ''
+        self.t.attributes['STASH'] = iris.fileformats.pp.STASH(1, 2, 3)
+        self.assertEqual(self.t.name(), 'm01s02i003')
+
     def test_name_and_var_name(self):
         # Assign only var_name.
         self.t.standard_name = None

lib/iris/tests/test_quickplot.py

@@ -1,4 +1,4 @@
-# (C) British Crown Copyright 2010 - 2016, Met Office
+# (C) British Crown Copyright 2010 - 2018, Met Office
 #
 # This file is part of Iris.
 #
@@ -149,6 +149,7 @@ def test_contourf(self):
     def test_contourf_nameless(self):
         cube = self._small()
         cube.standard_name = None
+        cube.attributes['STASH'] = ''
         qplt.contourf(cube, coords=['grid_longitude', 'model_level_number'])
         self.check_graphic()
 

lib/iris/tests/unit/cube/test_CubeList.py

@@ -1,4 +1,4 @@
-# (C) British Crown Copyright 2014 - 2017, Met Office
+# (C) British Crown Copyright 2014 - 2018, Met Office
 #
 # This file is part of Iris.
 #
@@ -296,8 +296,8 @@ def test_summary_name_unit(self):
 
     def test_summary_stash(self):
         self.cubes[0].attributes['STASH'] = STASH.from_msi('m01s00i004')
-        expected = ('0: m01s00i004       '
-                    '                   (latitude: 3; longitude: 4)')
+        expected = ('0: m01s00i004 / (unknown)       '
+                    '       (latitude: 3; longitude: 4)')
         self.assertEqual(str(self.cubes), expected)