From 8e471f65a21014d18e3bf76869390668b472775d Mon Sep 17 00:00:00 2001
From: SamanthaPullen <samantha.pullen@metoffice.gov.uk>
Date: Thu, 7 Mar 2024 11:46:47 +0000
Subject: [PATCH 1/2] add new sub-section and variable names for land surface

---
 Metadata-standard-names.md | 16 ++++++++++++++++
 standard_names.xml         | 29 +++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+)

diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md
index e77ba1e..8431017 100644
--- a/Metadata-standard-names.md
+++ b/Metadata-standard-names.md
@@ -4,6 +4,7 @@
 * [constants](#constants)
 * [coordinates](#coordinates)
 * [state_variables](#state_variables)
+* [land_surface](#land_surface)
 * [diagnostics](#diagnostics)
 * [atmospheric_composition](#atmospheric_composition)
 * [atmospheric_composition: GOCART aerosols](#atmospheric_composition-gocart-aerosols)
@@ -258,6 +259,21 @@ Note that appending '_on_previous_timestep' to standard_names in this section yi
     * `real(kind=kind_phys)`: units = 1
 * `gravitational_acceleration`: Gravitational acceleration
     * `real(kind=kind_phys)`: units = m s-2
+## land_surface
+* `land_ice_area_fraction`: fraction of horizontal area of grid cell that is land ice
+    * `real(kind=kind_phys)`: units = frac
+* `mass_content_of_water_in_top_soil_layer`: content per unit area of water in top layer of soil
+    * `real(kind=kind_phys)`: units = kg m-2
+* `surface_snow_density`: Surface snow density
+    * `real(kind=kind_phys)`: units = kg m-3
+* `urban_area_fraction`: fraction of horizontal area of grid cell that is urban
+    * `real(kind=kind_phys)`: units = frac
+* `volume_fraction_of_liquid_water_in_soil_at_critical_point`: volume fraction of water in liquid phase in soil at critical point
+    * `real(kind=kind_phys)`: units = m3 m-3
+* `volume_fraction_of_liquid_water_in_soil_at_saturation`: volume fraction of water in liquid phase in soil at saturation
+    * `real(kind=kind_phys)`: units = m3 m-3
+* `volume_fraction_of_liquid_water_in_soil_at_wilting_point`: volume fraction of water in liquid phase in soil at wilting point
+    * `real(kind=kind_phys)`: units = m3 m-3
 ## diagnostics
 * `total_precipitation_rate_at_surface`: Total precipitation rate at surface
     * `real(kind=kind_phys)`: units = m s-1
diff --git a/standard_names.xml b/standard_names.xml
index 242c52e..c6c49cf 100644
--- a/standard_names.xml
+++ b/standard_names.xml
@@ -418,6 +418,35 @@
       <type kind="kind_phys" units="m s-2">real</type>
     </standard_name>
   </section>
+  <section name="land_surface">
+    <standard_name name="land_ice_area_fraction"
+                   long_name="fraction of horizontal area of grid cell that is land ice">
+      <type kind="kind_phys" units="frac">real</type>
+    </standard_name>
+    <standard_name name="mass_content_of_water_in_top_soil_layer"
+                   long_name="content per unit area of water in top layer of soil">
+      <type kind="kind_phys" units="kg m-2">real</type>
+    </standard_name>
+    <standard_name name="surface_snow_density">
+      <type kind="kind_phys" units="kg m-3">real</type>
+    </standard_name>
+    <standard_name name="urban_area_fraction"
+                   long_name="fraction of horizontal area of grid cell that is urban">
+      <type kind="kind_phys" units="frac">real</type>
+    </standard_name>
+    <standard_name name="volume_fraction_of_liquid_water_in_soil_at_critical_point"
+                   long_name="volume fraction of water in liquid phase in soil at critical point">
+      <type kind="kind_phys" units="m3 m-3">real</type>
+    </standard_name>
+    <standard_name name="volume_fraction_of_liquid_water_in_soil_at_saturation"
+                   long_name="volume fraction of water in liquid phase in soil at saturation">
+      <type kind="kind_phys" units="m3 m-3">real</type>
+    </standard_name>
+    <standard_name name="volume_fraction_of_liquid_water_in_soil_at_wilting_point"
+                   long_name="volume fraction of water in liquid phase in soil at wilting point">
+      <type kind="kind_phys" units="m3 m-3">real</type>
+    </standard_name>
+  </section>
   <section name="diagnostics">
     <standard_name name="total_precipitation_rate_at_surface">
       <type kind="kind_phys" units="m s-1">real</type>

From a5115645e42277eb03ad1e4488e2254718da7b81 Mon Sep 17 00:00:00 2001
From: SamanthaPullen <samantha.pullen@metoffice.gov.uk>
Date: Wed, 3 Apr 2024 11:22:59 +0100
Subject: [PATCH 2/2] modify land_ice_area_fraction and urban_area_fraction to
 append _of_cell_area

---
 Metadata-standard-names.md | 4 ++--
 standard_names.xml         | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md
index 8431017..d13f79a 100644
--- a/Metadata-standard-names.md
+++ b/Metadata-standard-names.md
@@ -260,13 +260,13 @@ Note that appending '_on_previous_timestep' to standard_names in this section yi
 * `gravitational_acceleration`: Gravitational acceleration
     * `real(kind=kind_phys)`: units = m s-2
 ## land_surface
-* `land_ice_area_fraction`: fraction of horizontal area of grid cell that is land ice
+* `land_ice_area_fraction_of_cell_area`: fraction of horizontal area of grid cell that is land ice
     * `real(kind=kind_phys)`: units = frac
 * `mass_content_of_water_in_top_soil_layer`: content per unit area of water in top layer of soil
     * `real(kind=kind_phys)`: units = kg m-2
 * `surface_snow_density`: Surface snow density
     * `real(kind=kind_phys)`: units = kg m-3
-* `urban_area_fraction`: fraction of horizontal area of grid cell that is urban
+* `urban_area_fraction_of_cell_area`: fraction of horizontal area of grid cell that is urban
     * `real(kind=kind_phys)`: units = frac
 * `volume_fraction_of_liquid_water_in_soil_at_critical_point`: volume fraction of water in liquid phase in soil at critical point
     * `real(kind=kind_phys)`: units = m3 m-3
diff --git a/standard_names.xml b/standard_names.xml
index c6c49cf..495820f 100644
--- a/standard_names.xml
+++ b/standard_names.xml
@@ -419,7 +419,7 @@
     </standard_name>
   </section>
   <section name="land_surface">
-    <standard_name name="land_ice_area_fraction"
+    <standard_name name="land_ice_area_fraction_of_cell_area"
                    long_name="fraction of horizontal area of grid cell that is land ice">
       <type kind="kind_phys" units="frac">real</type>
     </standard_name>
@@ -430,7 +430,7 @@
     <standard_name name="surface_snow_density">
       <type kind="kind_phys" units="kg m-3">real</type>
     </standard_name>
-    <standard_name name="urban_area_fraction"
+    <standard_name name="urban_area_fraction_of_cell_area"
                    long_name="fraction of horizontal area of grid cell that is urban">
       <type kind="kind_phys" units="frac">real</type>
     </standard_name>