From b731a18ca507d3080a7304193860b8724d84cb9e Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Mon, 21 Sep 2026 15:56:31 -0600 Subject: [PATCH 01/15] Update rules per discussion on #150 --- StandardNamesRules.rst | 28 ++++++++++++++++++++++++---- 1 file changed, 24 insertions(+), 4 deletions(-) diff --git a/StandardNamesRules.rst b/StandardNamesRules.rst index 44e8d66..5f3d596 100644 --- a/StandardNamesRules.rst +++ b/StandardNamesRules.rst @@ -139,6 +139,21 @@ Variable scope Terminology ----------- + `annotated image detailing some of the terminology in this section `_ + +#. A "layer" is a vertical level of a model, as defined by the host. An "interface" is the boundary above or below a layer. + +#. By default, *surface* refers to the liquid or solid substance immediately beneath the atmosphere + for a given vertical column. This can be land, ocean, ice, lake, etc. + + For "surface" variables describing properties of the atmosphere, near/adjacent to the actual surface, + care should be taken to specify the specific "surface variable" quantity needed for a specific application: + + * ``[variable]_at_boa`` ("bottom of atmosphere") is the lowest point of the atmosphere, adjacent to the surface. + This is equivalent to the bottom interface (as described above). + * ``[variable]_at_surface_adjacent_layer`` is the bottom layer of the atmospheric model + * ``[variable]_at_[level]`` for variables defined at specific height above the surface, e.g. ``temperature_at_2m``, ``wind_at_10m`` + #. By default, *mixing_ratio* refers to mass mixing ratios. The description should explicitly specify that it refers to the *mass* mixing ratio. Mass mixing ratios should contain information regarding @@ -178,9 +193,8 @@ Terminology of clouds the variable represents (e.g. *ice_cloud* if only including glaciated clouds, or *cloud_at_500hPa* if only including clouds that exist at 500 hPa). -#. Spell out acronyms unless they are obvious to a vast majority of - scientists/developers who may come across them. A list of currently-used - aliases is below. Whenever such an alias exist, use the alias in the +#. Spell out acronyms unless they are defined in the list of "Acronyms, Abbreviations, and Aliases" + below. Whenever such an alias exist, use the alias in the standard name and the full term in the description. #. Chemical species in standard names should be denoted by chemical formulae (e.g. ``co2``, @@ -292,7 +306,8 @@ Prefixes None. Note that this is a departure from the CF conventions, which in many cases - but not all - use surface_ as a prefix. This departure from the CF convention is to maintain consistency with all other level -qualifiers that are used as _at_level-qualifier (i.e. as suffix). +qualifiers that are used as _at_level-qualifier (i.e. as suffix), as well as +reducing ambiguity between different uses of the word "surface" (see above). Suffixes ^^^^^^^^ @@ -311,6 +326,7 @@ Suffixes | at_top_of_atmosphere_model | at_top_of_dry_convection | at_interfaces +| at_boa | at_toa | at_tropopause | at_surface @@ -578,6 +594,8 @@ Special phrases +------------------------+-------------------------------------------------------------------------------------+ | specific | per unit mass unless otherwise stated | +------------------------+-------------------------------------------------------------------------------------+ +| surface | The top of the solid or liquid medium below the bottom of the atmosphere | ++------------------------+-------------------------------------------------------------------------------------+ | unfrozen_water | liquid and vapor | +------------------------+-------------------------------------------------------------------------------------+ | water | water in all phases if not otherwise qualified | @@ -599,6 +617,8 @@ Acronyms, Abbreviations, and Aliases +---------------------+---------------------------------------------------------+ | **Short** | **Meaning** | +=====================+=========================================================+ +| boa | bottom of atmosphere (atmosphere interface with surface)| ++---------------------+---------------------------------------------------------+ | cnvc90 | GFS Convective Cloud Diagnostics | +---------------------+---------------------------------------------------------+ | edmf | eddy-diffusivity/mass-flux | From 2a1cdb74c0efa9d746cf936e6fc0f952742e07af Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Mon, 21 Sep 2026 16:58:27 -0600 Subject: [PATCH 02/15] Starting update of "surface" variables; give a more detailed "surface_skin_temperature" definition, and return proper skin temperature naming accordingly --- standard_names.xml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/standard_names.xml b/standard_names.xml index 92723cc..5027df8 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -21,7 +21,7 @@ real - + real @@ -196,7 +196,7 @@ air_temperature real - + real @@ -228,7 +228,7 @@ real - + dimensionless_exner_function real @@ -338,7 +338,7 @@ solar_zenith_angle real - + surface_skin_temperature real @@ -3481,16 +3481,16 @@ sea_ice_thickness real - + real - + real - + real - + real @@ -3868,4 +3868,4 @@ real - \ No newline at end of file + From 8be6a3b49f9a707c4a3c428c1f53573eee7c026c Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Mon, 21 Sep 2026 18:50:32 -0600 Subject: [PATCH 03/15] Converting atmospheric references to 'at_surface' to 'at_boa'. We'll see if this sticks... --- standard_names.xml | 76 +++++++++++++++++++++++----------------------- 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/standard_names.xml b/standard_names.xml index 5027df8..fffec74 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -568,7 +568,7 @@ air_pressure_at_mean_sea_level real - + surface_air_pressure real @@ -655,7 +655,7 @@ real - + real @@ -785,16 +785,16 @@ real - + real - + real real - + real @@ -812,10 +812,10 @@ real - + real - + real @@ -825,7 +825,7 @@ atmosphere_upward_absolute_vorticity real - + surface_upward_heat_flux_in_air real @@ -859,7 +859,7 @@ real - + real @@ -1167,10 +1167,10 @@ real - + real - + real @@ -1916,7 +1916,7 @@ integer - + integer @@ -2389,10 +2389,10 @@ real - + integer - + integer @@ -2506,7 +2506,7 @@ integer - + integer @@ -2619,7 +2619,7 @@ real - + real @@ -3090,7 +3090,7 @@ real - + ddt @@ -3113,13 +3113,13 @@
- + real - + real - + real @@ -3176,10 +3176,10 @@ real - + real - + real @@ -3206,19 +3206,19 @@ real - + real - + real real - + real - + real @@ -3227,10 +3227,10 @@ real - + real - + real @@ -3403,10 +3403,10 @@ lwe_snowfall_rate real - + real - + real @@ -3418,13 +3418,13 @@ real - + real real - + real @@ -3436,7 +3436,7 @@ real - + lwe_thickness_of_surface_snow_amount real @@ -3512,10 +3512,10 @@ real - + real - + real @@ -3585,7 +3585,7 @@ real - + surface_upward_latent_heat_flux real @@ -3657,10 +3657,10 @@ real - + real - + real From 82609b277f0cfe9c031f3681eabda72be8b5c1ea Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Mon, 21 Sep 2026 18:51:28 -0600 Subject: [PATCH 04/15] "Surface friction velocity" is redundant...can just use "friction velocity" --- standard_names.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/standard_names.xml b/standard_names.xml index fffec74..df21eee 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -3533,10 +3533,10 @@ real - + real - + real From de4de4959abdc79dea41721207b052d34e16e5fd Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Mon, 21 Sep 2026 20:16:21 -0600 Subject: [PATCH 05/15] rename strangely named "surface temperature scale" to the better-defined "friction-temperature", including definition and citation. --- standard_names.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/standard_names.xml b/standard_names.xml index df21eee..d3120d6 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -3561,7 +3561,7 @@ ddt - + real From 9ffbdfa53dfd813cdf306d5612cd33e59faec15e Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 08:55:22 -0600 Subject: [PATCH 06/15] Reverting "boa" definitions...this is not an acceptable substitute for "at_surface_interface" due to existing conflicting definition of "bottom-of-atmosphere" in radiation community. Will stick with the slightly more ambiguous but overall less confusing "at_surface" as a synonym for "at_surface_interface", with appropriate definitions. --- StandardNamesRules.rst | 13 ++++----- standard_names.xml | 62 +++++++++++++++++++++--------------------- 2 files changed, 36 insertions(+), 39 deletions(-) diff --git a/StandardNamesRules.rst b/StandardNamesRules.rst index 5f3d596..bbba40f 100644 --- a/StandardNamesRules.rst +++ b/StandardNamesRules.rst @@ -141,16 +141,16 @@ Terminology `annotated image detailing some of the terminology in this section `_ -#. A "layer" is a vertical level of a model, as defined by the host. An "interface" is the boundary above or below a layer. +#. A "layer" is a vertical level of a model. A variable for a given layer is either at the vertical centerpoint of a level, or the vertical average of a level, as defined by the host (see above). An "interface" is the boundary above or below a layer. A variable specified at a given interface #. By default, *surface* refers to the liquid or solid substance immediately beneath the atmosphere for a given vertical column. This can be land, ocean, ice, lake, etc. - For "surface" variables describing properties of the atmosphere, near/adjacent to the actual surface, + For variables describing properties of the atmosphere near/adjacent to the actual surface, care should be taken to specify the specific "surface variable" quantity needed for a specific application: - * ``[variable]_at_boa`` ("bottom of atmosphere") is the lowest point of the atmosphere, adjacent to the surface. - This is equivalent to the bottom interface (as described above). + * ``[variable]_at_surface`` is the lowest interface of the atmospheric model, adjacent to the surface. + This is equivalent to the surface-adjacent/bottom interface (as described above). * ``[variable]_at_surface_adjacent_layer`` is the bottom layer of the atmospheric model * ``[variable]_at_[level]`` for variables defined at specific height above the surface, e.g. ``temperature_at_2m``, ``wind_at_10m`` @@ -326,7 +326,6 @@ Suffixes | at_top_of_atmosphere_model | at_top_of_dry_convection | at_interfaces -| at_boa | at_toa | at_tropopause | at_surface @@ -594,7 +593,7 @@ Special phrases +------------------------+-------------------------------------------------------------------------------------+ | specific | per unit mass unless otherwise stated | +------------------------+-------------------------------------------------------------------------------------+ -| surface | The top of the solid or liquid medium below the bottom of the atmosphere | +| surface | The top of the solid or liquid medium below the atmosphere | +------------------------+-------------------------------------------------------------------------------------+ | unfrozen_water | liquid and vapor | +------------------------+-------------------------------------------------------------------------------------+ @@ -617,8 +616,6 @@ Acronyms, Abbreviations, and Aliases +---------------------+---------------------------------------------------------+ | **Short** | **Meaning** | +=====================+=========================================================+ -| boa | bottom of atmosphere (atmosphere interface with surface)| -+---------------------+---------------------------------------------------------+ | cnvc90 | GFS Convective Cloud Diagnostics | +---------------------+---------------------------------------------------------+ | edmf | eddy-diffusivity/mass-flux | diff --git a/standard_names.xml b/standard_names.xml index d3120d6..7ddef69 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -228,7 +228,7 @@ real - + dimensionless_exner_function real @@ -568,7 +568,7 @@ air_pressure_at_mean_sea_level real - + surface_air_pressure real @@ -655,7 +655,7 @@ real - + real @@ -785,16 +785,16 @@ real - + real - + real real - + real @@ -812,10 +812,10 @@ real - + real - + real @@ -825,7 +825,7 @@ atmosphere_upward_absolute_vorticity real - + surface_upward_heat_flux_in_air real @@ -1167,10 +1167,10 @@ real - + real - + real @@ -2389,10 +2389,10 @@ real - + integer - + integer @@ -2619,7 +2619,7 @@ real - + real @@ -3090,7 +3090,7 @@ real - + ddt @@ -3113,13 +3113,13 @@
- + real - + real - + real @@ -3176,10 +3176,10 @@ real - + real - + real @@ -3206,19 +3206,19 @@ real - + real - + real real - + real - + real @@ -3227,10 +3227,10 @@ real - + real - + real @@ -3512,10 +3512,10 @@ real - + real - + real @@ -3585,7 +3585,7 @@ real - + surface_upward_latent_heat_flux real @@ -3657,10 +3657,10 @@ real - + real - + real From 996bb24d70c9ad03f2f644f132ac144be2beef01 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 08:56:49 -0600 Subject: [PATCH 07/15] Sort xml and generate new Metadata --- Metadata-standard-names.md | 92 +++++++++++++------------- Metadata-standard-names.yaml | 124 ++++++++++++++++++----------------- standard_names.xml | 62 +++++++++--------- 3 files changed, 142 insertions(+), 136 deletions(-) diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md index 2d3458a..1913173 100644 --- a/Metadata-standard-names.md +++ b/Metadata-standard-names.md @@ -41,7 +41,7 @@ The following names are too general to be chosen as standard names, but they can * `real`: units = kg m-3 * `energy`: Energy * `real`: units = J -* `energy_content`: Total energy within some surface +* `energy_content`: Total energy within some ideal surface * `real`: units = J m-2 * `energy_density`: Total energy within some volume * `real`: units = J m-3 @@ -151,7 +151,7 @@ These names are used as bases for other names, but may also be considered standa * `air_temperature`: The temperature of air * Equivalent CF name: `air_temperature` * `real`: units = K -* `albedo`: The fraction of incident radiation reflected by a surface +* `albedo`: The fraction of incident radiation reflected by a physical surface * `real`: units = 1 * `atmosphere_heat_diffusivity`: Atmosphere heat diffusivity * Equivalent CF name: `atmosphere_heat_diffusivity` @@ -245,7 +245,7 @@ These names are used as bases for other names, but may also be considered standa * `solar_zenith_angle`: The angle between the direction to the sun and the local zenith (vertical direction) * Equivalent CF name: `solar_zenith_angle` * `real`: units = degrees -* `surface_skin_temperature`: The temperature of the topmost layer of the surface +* `surface_skin_temperature`: The temperature of the interface of the surface and the atmosphere * Equivalent CF name: `surface_skin_temperature` * `real`: units = K * `temperature_flux`: Flux of temperature across a unit surface @@ -401,7 +401,7 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `air_pressure_at_mean_sea_level`: Air pressure at mean sea level * Equivalent CF name: `air_pressure_at_mean_sea_level` * `real`: units = Pa -* `air_pressure_at_surface`: Air pressure at local surface +* `air_pressure_at_surface`: Air pressure at surface; i.e. surface pressure * Equivalent CF name: `surface_air_pressure` * `real`: units = Pa * `air_pressure_at_surface_adjacent_layer`: Air pressure at surface adjacent layer @@ -460,7 +460,7 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = 1 * `dimensionless_exner_function_at_surface_adjacent_layer`: Dimensionless exner function (p/p0)^(Rd/cp), where p0 is 1000 hPa and p is the pressure at the surface-adjacent layer * `real`: units = 1 -* `dimensionless_exner_function_wrt_surface_pressure`: Dimensionless exner function with respect to surface pressure, (p/ps)^(Rd/cp) +* `dimensionless_exner_function_wrt_pressure_at_surface`: Dimensionless exner function with respect to surface pressure, (p/ps)^(Rd/cp) * `real`: units = 1 * `dry_static_energy`: Dry static energy content of atmosphere layer * Equivalent CF name: `dry_static_energy_content_of_atmosphere_layer` @@ -555,7 +555,7 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = 1 * `reference_pressure_in_atmosphere_layer`: Reference pressure in atmosphere layer * `real`: units = Pa -* `reference_pressure_in_atmosphere_layer_normalized_by_surface_reference_pressure`: Reference pressure in atmosphere layer normalized by surface reference pressure +* `reference_pressure_in_atmosphere_layer_normalized_by_reference_pressure_at_surface`: Reference pressure in atmosphere layer normalized by surface reference pressure * `real`: units = 1 * `relative_humidity_at_2m`: Relative humidity at 2m * `real`: units = fraction @@ -567,16 +567,16 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = kg kg-1 * `subgrid_scale_cloud_liquid_water_mixing_ratio_wrt_moist_air`: Subgrid-scale cloud liquid water mass mixing ratio with respect to moist air * `real`: units = kg kg-1 -* `surface_pressure_of_dry_air`: Surface pressure of dry air +* `pressure_of_dry_air_at_surface`: surface pressure of dry air * `real`: units = Pa -* `surface_reference_pressure`: Reference pressure used in definition of some other quantity (e.g. potential temperature, Exner function, etc.) +* `reference_pressure_at_surface`: Reference surface air pressure used in definition of some other quantity (e.g. potential temperature, Exner function, etc.) * `real`: units = Pa * `timestep_for_physics`: Timestep for physics * `integer`: units = s * `upward_absolute_vorticity_of_air`: The upward (kth) component of the curl of the vector wind field * Equivalent CF name: `atmosphere_upward_absolute_vorticity` * `real`: units = s-1 -* `upward_heat_flux_in_air_at_surface`: Upward heat flux in air at surface +* `upward_heat_flux_in_air_at_surface`: Upward heat flux in air at surface interface * Equivalent CF name: `surface_upward_heat_flux_in_air` * `real`: units = W m-2 * `us_standard_air_pressure_at_mean_sea_level`: US Standard Atmospheric pressure at sea level @@ -599,7 +599,7 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = kg kg-1 * `water_vapor_mixing_ratio_wrt_moist_air_on_previous_timestep_in_xyz_dimensioned_restart_array`: Specific humidity (water vapor mass mixing ratio with respect to moist air) on previous timestep in XYZ-dimensioned restart array * `real`: units = kg kg-1 -* `water_vapor_mixing_ratio_wrt_moist_air_two_timesteps_back`: Specific humidity (water vapor mass mixing ratio with respect to moist air) two timesteps back +* `water_vapor_mixing_ratio_wrt_moist_air_two_timesteps_back`: Specific humidity (water vapor mass mixing ratio with respect to moist air) two timesteps before the current timestep * `real`: units = kg kg-1 * `wind_from_direction_at_10m`: Direction (clockwise from north) wind vector is pointing away from, at 10 meters above surface. * `real`: units = degrees @@ -809,9 +809,9 @@ Tracers are numerically zero-mass particles advected in fluid flow, typically re * `real`: units = 1 * `aerosol_aware_multiplicative_rain_conversion_parameter_for_shallow_convection`: Aerosol aware multiplicative rain conversion parameter for shallow convection * `real`: units = 1 -* `cloud_condensed_water_mixing_ratio_wrt_moist_air_at_surface_over_ice`: Cloud condensed water mass mixing ratio with respect to moist air at surface over ice +* `cloud_condensed_water_mixing_ratio_wrt_moist_air_at_surface_over_ice`: Cloud condensed water mass mixing ratio with respect to moist air at surface interface over ice * `real`: units = kg kg-1 -* `cloud_condensed_water_mixing_ratio_wrt_moist_air_at_surface_over_land`: Cloud condensed water mass mixing ratio with respect to moist air at surface over land +* `cloud_condensed_water_mixing_ratio_wrt_moist_air_at_surface_over_land`: Cloud condensed water mass mixing ratio with respect to moist air at surface interface over land * `real`: units = kg kg-1 * `cloud_ice_mixing_ratio_wrt_dry_air`: Ratio of the mass of cloud ice to the mass of dry air * Equivalent CF name: `cloud_ice_mixing_ratio` @@ -1313,7 +1313,7 @@ Variables that indicate or control some action. * `real`: units = 1 * `control_for_vegetation_dataset`: Control for vegetation dataset * `integer`: units = 1 -* `control_for_vertical_index_direction`: control flag for direction of vertical index; 0 indicates index from toa to surface, 1 indicates index from surface to toa +* `control_for_vertical_index_direction`: control flag for direction of vertical index; 0 indicates index from top of atmosphere to surface, 1 indicates index from surface to toa * `integer`: units = 1 * `do_aerosol_physics`: Do aerosol physics * `logical`: units = flag @@ -1629,9 +1629,9 @@ Values indicating the index of some array or other data structure * `real`: units = 1 * `cumulative_min_vertical_index_at_cloud_base_between_sw_radiation_calls`: Cumulative min vertical index at cloud base between sw radiation calls * `real`: units = 1 -* `index_of_air_pressure_at_surface_on_previous_timestep_in_xyz_dimensioned_restart_array`: Index of air pressure at surface on previous timestep in xyz dimensioned restart array +* `index_of_air_pressure_at_surface_on_previous_timestep_in_xyz_dimensioned_restart_array`: Index of surface pressure on previous timestep in xyz-dimensioned restart array * `integer`: units = index -* `index_of_air_pressure_at_surface_two_timesteps_back_in_xyz_dimensioned_tracer_array`: Index of air pressure at surface two timesteps back in xyz dimensioned tracer array +* `index_of_air_pressure_at_surface_two_timesteps_back_in_xyz_dimensioned_tracer_array`: Index of surface pressure two timesteps before the current timestep in xyz-dimensioned tracer array * `integer`: units = index * `index_of_air_temperature_on_previous_timestep_in_xyz_dimensioned_restart_array`: Index of air temperature on previous timestep in xyz dimensioned restart array * `integer`: units = index @@ -1707,7 +1707,7 @@ Values indicating the index of some array or other data structure * `integer`: units = index * `index_of_water_vapor_mixing_ratio_wrt_moist_air_on_previous_timestep_in_xyz_dimensioned_restart_array`: Index of specific humidity (water vapor mass mixing ratio with respect to moist air) on previous timestep in xyz dimensioned restart array * `integer`: units = index -* `index_of_water_vapor_mixing_ratio_wrt_moist_air_two_timesteps_back_in_xyz_dimensioned_restart_array`: Index of specific humidity (water vapor mass mixing ratio with respect to moist air) two timesteps back in xyz dimensioned restart array +* `index_of_water_vapor_mixing_ratio_wrt_moist_air_two_timesteps_back_in_xyz_dimensioned_restart_array`: Index of specific humidity (water vapor mass mixing ratio with respect to moist air) two timesteps before the current timestep in xyz dimensioned restart array * `integer`: units = index * `index_of_water_vegetation_category`: Index of water vegetation category * `integer`: units = index @@ -1783,7 +1783,7 @@ Coefficients includes scaling factors, tunable parameters, and other similar var * `real`: units = 1 * `coefficient_w_d`: Coefficient w d * `real`: units = 1 -* `critical_relative_humidity_at_surface`: Critical relative humidity at surface +* `critical_relative_humidity_at_surface`: Critical relative humidity at the surface interface * `real`: units = fraction * `critical_relative_humidity_at_toa`: Critical relative humidity at the top of the atmosphere * `real`: units = fraction @@ -2097,7 +2097,7 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = 1 * `solar_constant`: Solar constant * `real`: units = W m-2 -* `surface_lw_fluxes_assuming_total_and_clear_sky_on_radiation_timestep`: Surface lw fluxes assuming total and clear sky on radiation timestep +* `lw_fluxes_at_surface_assuming_total_and_clear_sky_on_radiation_timestep`: longwave total sky fluxes at surface interface, assuming clear sky, on radiation timestep * `ddt`: units = W m-2 * `upwelling_diffuse_nir_shortwave_flux_at_surface_on_radiation_timestep`: upwelling diffuse near-infrared shortwave flux at the surface level on the radiation timestep * `real`: units = W m-2 @@ -2112,11 +2112,11 @@ Thresholds represent some value at which the behavior of some process changes, i * `upwelling_longwave_flux_at_surface_on_radiation_timestep`: Upwelling longwave flux at surface on radiation timestep * `real`: units = W m-2 ## Atmospheric surface and boundary layer -* `air_pressure_at_surface_for_coupling`: Air pressure at surface for coupling +* `air_pressure_at_surface_for_coupling`: Surface pressure for coupling * `real`: units = Pa -* `air_pressure_at_surface_on_previous_timestep`: Air pressure at surface on previous timestep +* `air_pressure_at_surface_on_previous_timestep`: Surface pressure on previous timestep * `real`: units = Pa -* `air_pressure_at_surface_two_timesteps_back`: Air pressure at surface two timesteps back +* `air_pressure_at_surface_two_timesteps_back`: Surface pressure two timesteps before the current timestep * `real`: units = Pa * `critical_relative_humidity_at_top_of_atmosphere_boundary_layer`: Critical relative humidity at top of atmosphere boundary layer * `real`: units = fraction @@ -2154,9 +2154,9 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = m * `updraft_area_fraction_in_scale_aware_tke_moist_edmf_pbl_scheme`: Updraft area fraction in scale-aware turbulent kinetic energy moist eddy-diffusivity/mass-flux planetary boundary layer scheme * `real`: units = fraction -* `upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface`: Upward specific humidity (water vapor mass mixing ratio with respect to moist air) flux at surface +* `upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface`: Upward specific humidity (water vapor mass mixing ratio with respect to moist air) flux at surface interface * `real`: units = kg kg-1 m s-1 -* `upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface_for_myj_surface_layer_scheme`: Upward flux of specific humidity (water vapor mass mixing ratio with respect to moist air) at surface for MYJ surface layer scheme +* `upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface_for_myj_surface_layer_scheme`: Upward flux of specific humidity (water vapor mass mixing ratio with respect to moist air) at surface interface for MYJ surface layer scheme * `real`: units = m s-1 kg kg-1 * `upward_latent_heat_flux_at_surface_for_coupling`: Upward latent heat flux at surface for coupling * `real`: units = W m-2 @@ -2174,23 +2174,23 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = K m s-1 * `water_vapor_mixing_ratio_wrt_moist_air_at_2m_for_coupling`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at 2 meters above surface used for coupling * `real`: units = kg kg-1 -* `water_vapor_mixing_ratio_wrt_moist_air_at_surface`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at surface +* `water_vapor_mixing_ratio_wrt_moist_air_at_surface`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at surface interface * `real`: units = kg kg-1 -* `water_vapor_mixing_ratio_wrt_moist_air_at_surface_for_myj_schemes`: Surface specific humidity (water vapor mass mixing ratio with respect to moist air) for Mellor-Yamada-Janjic physics schemes +* `water_vapor_mixing_ratio_wrt_moist_air_at_surface_for_myj_schemes`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at surface interface for Mellor-Yamada-Janjic physics schemes * `real`: units = kg kg-1 * `water_vapor_mixing_ratio_wrt_moist_air_at_top_of_viscous_sublayer`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at the top of the viscous sublayer * `real`: units = kg kg-1 -* `x_momentum_flux_at_surface_for_coupling`: X momentum flux at surface for coupling +* `x_momentum_flux_at_surface_for_coupling`: Momentum flux in the x-direction at the surface interface for coupling * `real`: units = Pa -* `x_momentum_flux_at_surface_from_coupled_process`: X momentum flux at surface from coupled process +* `x_momentum_flux_at_surface_from_coupled_process`: Momentum flux in the x-direction at the surface interface from a coupled process * `real`: units = Pa * `x_wind_at_10m_for_coupling`: X wind at 10m for coupling * `real`: units = m s-1 * `x_wind_at_top_of_viscous_sublayer`: X wind at top of viscous sublayer * `real`: units = m s-1 -* `y_momentum_flux_at_surface_for_coupling`: Y momentum flux at surface for coupling +* `y_momentum_flux_at_surface_for_coupling`: Momentum flux in the y-direction at the surface interface for coupling * `real`: units = Pa -* `y_momentum_flux_at_surface_from_coupled_process`: Y momentum flux at surface from coupled process +* `y_momentum_flux_at_surface_from_coupled_process`: Momentum flux in the y-direction at the surface interface from a coupled process * `real`: units = Pa * `y_wind_at_10m_for_coupling`: Y wind at 10m for coupling * `real`: units = m s-1 @@ -2308,9 +2308,9 @@ Thresholds represent some value at which the behavior of some process changes, i * `lwe_snowfall_rate`: Liquid water equivalent snowfall rate * Equivalent CF name: `lwe_snowfall_rate` * `real`: units = mm s-1 -* `lwe_surface_snow`: Liquid water equivalent surface snow +* `lwe_surface_snow`: Liquid water equivalent of snow accumulated on surface * `real`: units = mm -* `lwe_surface_snow_from_coupled_process`: Liquid water equivalent surface snow from coupled process +* `lwe_surface_snow_from_coupled_process`: Liquid water equivalent of snow accumulated on surface from coupled process * `real`: units = m * `lwe_thickness_of_convective_precipitation_on_previous_timestep`: Liquid water equivalent thickness of convective precipitation amount on previous timestep * `real`: units = m @@ -2318,11 +2318,11 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = m * `lwe_thickness_of_graupel_on_previous_timestep`: Liquid water equivalent thickness of graupel amount on previous timestep * `real`: units = m -* `lwe_thickness_of_ice_in_surface_snow`: Liquid water equivalent thickness of ice in surface snow +* `lwe_thickness_of_ice_in_surface_snow`: Liquid water equivalent thickness of ice in snow accumulated on surface * `real`: units = mm * `lwe_thickness_of_ice_precipitation_on_previous_timestep`: Liquid water equivalent thickness of ice precipitation amount on previous timestep * `real`: units = m -* `lwe_thickness_of_liquid_water_in_surface_snow`: Liquid water equivalent thickness of liquid water in surface snow +* `lwe_thickness_of_liquid_water_in_surface_snow`: Liquid water equivalent thickness of liquid water in snow accumulated on surface * `real`: units = mm * `lwe_thickness_of_rain_on_dynamics_timestep_for_coupling`: Liquid water equivalent thickness of rain amount on dynamics timestep for coupling * `real`: units = m @@ -2330,7 +2330,7 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = m * `lwe_thickness_of_snowfall_on_previous_timestep`: Liquid water equivalent thickness of snowfall amount on previous timestep * `real`: units = mm -* `lwe_thickness_of_surface_snow`: Liquid water equivalent thickness of surface snow amount +* `lwe_thickness_of_surface_snow`: Liquid water equivalent thickness of snow accumulated on surface * Equivalent CF name: `lwe_thickness_of_surface_snow_amount` * `real`: units = mm * `mass_content_of_water_in_top_soil_layer`: mass per unit area of water in top layer of soil @@ -2361,13 +2361,13 @@ Thresholds represent some value at which the behavior of some process changes, i * `sea_ice_thickness`: Sea ice thickness * Equivalent CF name: `sea_ice_thickness` * `real`: units = m -* `skin_temperature_at_surface_over_ice`: Skin temperature at surface over (or where) ice +* `surface_skin_temperature_over_ice`: Surface skin temperature over (or where) ice * `real`: units = K -* `skin_temperature_at_surface_over_land`: Skin temperature at surface over (or where) land +* `surface_skin_temperature_over_land`: Surface skin temperature over (or where) land * `real`: units = K -* `skin_temperature_at_surface_over_ocean`: Skin temperature at surface over (or where) ocean +* `surface_skin_temperature_over_ocean`: Surface skin temperatura over (or where) ocean * `real`: units = K -* `skin_temperature_at_surface_over_snow`: Skin temperature at surface over (or where) snow +* `surface_skin_temperature_over_snow`: Surface skin temperature over (or where) snow * `real`: units = K * `slow_soil_pool_mass_content_of_carbon`: Slow soil pool mass content of carbon * Equivalent CF name: `slow_soil_pool_mass_content_of_carbon` @@ -2382,9 +2382,9 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = mm s-1 * `soil_temperature_for_lsm`: Soil temperature for land surface model * `real`: units = K -* `specified_upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface`: Specified upward specific humidity (water vapor mass mixing ratio with respect to moist air) flux at surface +* `specified_upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface`: Specified upward specific humidity (water vapor mass mixing ratio with respect to moist air) flux at surface interface * `real`: units = kg kg-1 m s-1 -* `specified_upward_temperature_flux_at_surface`: Specified upward temperature flux at surface +* `specified_upward_temperature_flux_at_surface`: Specified upward temperature flux at surface interface * `real`: units = K m s-1 * `standard_deviation_of_subgrid_orography`: Standard deviation of subgrid orography * `real`: units = m @@ -2396,9 +2396,9 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = g m-2 * `strong_cosz_area_fraction`: Area fraction for albedo with strong dependence on cosine of zenith angle * `real`: units = fraction -* `surface_friction_velocity`: Surface friction velocity +* `friction_velocity`: Friction velocity * `real`: units = m s-1 -* `surface_friction_velocity_for_momentum`: Surface friction velocity for momentum +* `friction_velocity_for_momentum`: Friction velocity for momentum * `real`: units = m s-1 * `surface_longwave_emissivity`: Surface longwave emissivity * Equivalent CF name: `surface_longwave_emissivity` @@ -2415,7 +2415,7 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = kg m-2 * `surface_sw_fluxes_assuming_total_and_clear_sky_on_radiation_timestep`: Surface sw fluxes assuming total and clear sky on radiation timestep * `ddt`: units = W m-2 -* `surface_temperature_scale`: Surface temperature scale +* `friction_temperature`: Friction temperature, a.k.a. temperature scale * `real`: units = K * `temperature_in_ice_layer`: Temperature in ice layer * `real`: units = K @@ -2431,7 +2431,7 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = s * `upper_bound_of_max_albedo_assuming_deep_snow`: Upper bound of maximum albedo assuming deep snow * `real`: units = fraction -* `upward_latent_heat_flux_at_surface`: Upward latent heat flux at surface +* `upward_latent_heat_flux_at_surface`: Upward latent heat flux at surface interface * Equivalent CF name: `surface_upward_latent_heat_flux` * `real`: units = W m-2 * `urban_area_fraction_of_cell_area`: fraction of horizontal area of grid cell that is urban @@ -2480,9 +2480,9 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = kg kg-1 * `water_vapor_mixing_ratio_wrt_moist_air_at_2m`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at two meters above surface * `real`: units = kg kg-1 -* `water_vapor_mixing_ratio_wrt_moist_air_at_surface_over_ice`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at surface over ice +* `water_vapor_mixing_ratio_wrt_moist_air_at_surface_over_ice`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at surface interface over ice * `real`: units = kg kg-1 -* `water_vapor_mixing_ratio_wrt_moist_air_at_surface_over_land`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at surface over land +* `water_vapor_mixing_ratio_wrt_moist_air_at_surface_over_land`: Specific humidity (water vapor mass mixing ratio with respect to moist air) at surface interface over land * `real`: units = kg kg-1 * `weak_cosz_area_fraction`: Area fraction for albedo with weak dependence on cosine of zenith angle * `real`: units = fraction diff --git a/Metadata-standard-names.yaml b/Metadata-standard-names.yaml index 8879757..70bdeb1 100644 --- a/Metadata-standard-names.yaml +++ b/Metadata-standard-names.yaml @@ -37,7 +37,7 @@ section: type: real units: J - name: energy_content - description: Total energy within some surface + description: Total energy within some ideal surface type: real units: J m-2 - name: energy_density @@ -266,7 +266,7 @@ section: type: real units: K - name: albedo - description: The fraction of incident radiation reflected by a surface + description: The fraction of incident radiation reflected by a physical surface type: real units: 1 - name: atmosphere_heat_diffusivity @@ -457,7 +457,7 @@ section: units: degrees - name: surface_skin_temperature cfname: surface_skin_temperature - description: The temperature of the topmost layer of the surface + description: The temperature of the interface of the surface and the atmosphere type: real units: K - name: temperature_flux @@ -765,7 +765,7 @@ section: units: Pa - name: air_pressure_at_surface cfname: surface_air_pressure - description: Air pressure at local surface + description: Air pressure at surface; i.e. surface pressure type: real units: Pa - name: air_pressure_at_surface_adjacent_layer @@ -882,7 +882,7 @@ section: and p is the pressure at the surface-adjacent layer type: real units: 1 - - name: dimensionless_exner_function_wrt_surface_pressure + - name: dimensionless_exner_function_wrt_pressure_at_surface description: Dimensionless exner function with respect to surface pressure, (p/ps)^(Rd/cp) type: real units: 1 @@ -1072,7 +1072,7 @@ section: description: Reference pressure in atmosphere layer type: real units: Pa - - name: reference_pressure_in_atmosphere_layer_normalized_by_surface_reference_pressure + - name: reference_pressure_in_atmosphere_layer_normalized_by_reference_pressure_at_surface description: Reference pressure in atmosphere layer normalized by surface reference pressure type: real @@ -1098,13 +1098,13 @@ section: moist air type: real units: kg kg-1 - - name: surface_pressure_of_dry_air - description: Surface pressure of dry air + - name: pressure_of_dry_air_at_surface + description: surface pressure of dry air type: real units: Pa - - name: surface_reference_pressure - description: Reference pressure used in definition of some other quantity (e.g. - potential temperature, Exner function, etc.) + - name: reference_pressure_at_surface + description: Reference surface air pressure used in definition of some other quantity + (e.g. potential temperature, Exner function, etc.) type: real units: Pa - name: timestep_for_physics @@ -1118,7 +1118,7 @@ section: units: s-1 - name: upward_heat_flux_in_air_at_surface cfname: surface_upward_heat_flux_in_air - description: Upward heat flux in air at surface + description: Upward heat flux in air at surface interface type: real units: W m-2 - name: us_standard_air_pressure_at_mean_sea_level @@ -1167,7 +1167,7 @@ section: units: kg kg-1 - name: water_vapor_mixing_ratio_wrt_moist_air_two_timesteps_back description: Specific humidity (water vapor mass mixing ratio with respect to - moist air) two timesteps back + moist air) two timesteps before the current timestep type: real units: kg kg-1 - name: wind_from_direction_at_10m @@ -1607,12 +1607,12 @@ section: units: 1 - name: cloud_condensed_water_mixing_ratio_wrt_moist_air_at_surface_over_ice description: Cloud condensed water mass mixing ratio with respect to moist air - at surface over ice + at surface interface over ice type: real units: kg kg-1 - name: cloud_condensed_water_mixing_ratio_wrt_moist_air_at_surface_over_land description: Cloud condensed water mass mixing ratio with respect to moist air - at surface over land + at surface interface over land type: real units: kg kg-1 - name: cloud_ice_mixing_ratio_wrt_dry_air @@ -2671,7 +2671,7 @@ section: units: 1 - name: control_for_vertical_index_direction description: control flag for direction of vertical index; 0 indicates index from - toa to surface, 1 indicates index from surface to toa + top of atmosphere to surface, 1 indicates index from surface to toa type: integer units: 1 - name: do_aerosol_physics @@ -3329,13 +3329,13 @@ section: type: real units: 1 - name: index_of_air_pressure_at_surface_on_previous_timestep_in_xyz_dimensioned_restart_array - description: Index of air pressure at surface on previous timestep in xyz dimensioned + description: Index of surface pressure on previous timestep in xyz-dimensioned restart array type: integer units: index - name: index_of_air_pressure_at_surface_two_timesteps_back_in_xyz_dimensioned_tracer_array - description: Index of air pressure at surface two timesteps back in xyz dimensioned - tracer array + description: Index of surface pressure two timesteps before the current timestep + in xyz-dimensioned tracer array type: integer units: index - name: index_of_air_temperature_on_previous_timestep_in_xyz_dimensioned_restart_array @@ -3513,7 +3513,8 @@ section: units: index - name: index_of_water_vapor_mixing_ratio_wrt_moist_air_two_timesteps_back_in_xyz_dimensioned_restart_array description: Index of specific humidity (water vapor mass mixing ratio with respect - to moist air) two timesteps back in xyz dimensioned restart array + to moist air) two timesteps before the current timestep in xyz dimensioned restart + array type: integer units: index - name: index_of_water_vegetation_category @@ -3667,7 +3668,7 @@ section: type: real units: 1 - name: critical_relative_humidity_at_surface - description: Critical relative humidity at surface + description: Critical relative humidity at the surface interface type: real units: fraction - name: critical_relative_humidity_at_toa @@ -4365,8 +4366,9 @@ section: description: Solar constant type: real units: W m-2 - - name: surface_lw_fluxes_assuming_total_and_clear_sky_on_radiation_timestep - description: Surface lw fluxes assuming total and clear sky on radiation timestep + - name: lw_fluxes_at_surface_assuming_total_and_clear_sky_on_radiation_timestep + description: longwave total sky fluxes at surface interface, assuming clear sky, + on radiation timestep type: ddt units: W m-2 - name: upwelling_diffuse_nir_shortwave_flux_at_surface_on_radiation_timestep @@ -4401,15 +4403,15 @@ section: comment: null standard_names: - name: air_pressure_at_surface_for_coupling - description: Air pressure at surface for coupling + description: Surface pressure for coupling type: real units: Pa - name: air_pressure_at_surface_on_previous_timestep - description: Air pressure at surface on previous timestep + description: Surface pressure on previous timestep type: real units: Pa - name: air_pressure_at_surface_two_timesteps_back - description: Air pressure at surface two timesteps back + description: Surface pressure two timesteps before the current timestep type: real units: Pa - name: critical_relative_humidity_at_top_of_atmosphere_boundary_layer @@ -4491,12 +4493,12 @@ section: units: fraction - name: upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface description: Upward specific humidity (water vapor mass mixing ratio with respect - to moist air) flux at surface + to moist air) flux at surface interface type: real units: kg kg-1 m s-1 - name: upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface_for_myj_surface_layer_scheme description: Upward flux of specific humidity (water vapor mass mixing ratio with - respect to moist air) at surface for MYJ surface layer scheme + respect to moist air) at surface interface for MYJ surface layer scheme type: real units: m s-1 kg kg-1 - name: upward_latent_heat_flux_at_surface_for_coupling @@ -4534,12 +4536,12 @@ section: units: kg kg-1 - name: water_vapor_mixing_ratio_wrt_moist_air_at_surface description: Specific humidity (water vapor mass mixing ratio with respect to - moist air) at surface + moist air) at surface interface type: real units: kg kg-1 - name: water_vapor_mixing_ratio_wrt_moist_air_at_surface_for_myj_schemes - description: Surface specific humidity (water vapor mass mixing ratio with respect - to moist air) for Mellor-Yamada-Janjic physics schemes + description: Specific humidity (water vapor mass mixing ratio with respect to + moist air) at surface interface for Mellor-Yamada-Janjic physics schemes type: real units: kg kg-1 - name: water_vapor_mixing_ratio_wrt_moist_air_at_top_of_viscous_sublayer @@ -4548,11 +4550,12 @@ section: type: real units: kg kg-1 - name: x_momentum_flux_at_surface_for_coupling - description: X momentum flux at surface for coupling + description: Momentum flux in the x-direction at the surface interface for coupling type: real units: Pa - name: x_momentum_flux_at_surface_from_coupled_process - description: X momentum flux at surface from coupled process + description: Momentum flux in the x-direction at the surface interface from a + coupled process type: real units: Pa - name: x_wind_at_10m_for_coupling @@ -4564,11 +4567,12 @@ section: type: real units: m s-1 - name: y_momentum_flux_at_surface_for_coupling - description: Y momentum flux at surface for coupling + description: Momentum flux in the y-direction at the surface interface for coupling type: real units: Pa - name: y_momentum_flux_at_surface_from_coupled_process - description: Y momentum flux at surface from coupled process + description: Momentum flux in the y-direction at the surface interface from a + coupled process type: real units: Pa - name: y_wind_at_10m_for_coupling @@ -4801,11 +4805,12 @@ section: type: real units: mm s-1 - name: lwe_surface_snow - description: Liquid water equivalent surface snow + description: Liquid water equivalent of snow accumulated on surface type: real units: mm - name: lwe_surface_snow_from_coupled_process - description: Liquid water equivalent surface snow from coupled process + description: Liquid water equivalent of snow accumulated on surface from coupled + process type: real units: m - name: lwe_thickness_of_convective_precipitation_on_previous_timestep @@ -4823,7 +4828,7 @@ section: type: real units: m - name: lwe_thickness_of_ice_in_surface_snow - description: Liquid water equivalent thickness of ice in surface snow + description: Liquid water equivalent thickness of ice in snow accumulated on surface type: real units: mm - name: lwe_thickness_of_ice_precipitation_on_previous_timestep @@ -4832,7 +4837,8 @@ section: type: real units: m - name: lwe_thickness_of_liquid_water_in_surface_snow - description: Liquid water equivalent thickness of liquid water in surface snow + description: Liquid water equivalent thickness of liquid water in snow accumulated + on surface type: real units: mm - name: lwe_thickness_of_rain_on_dynamics_timestep_for_coupling @@ -4852,7 +4858,7 @@ section: units: mm - name: lwe_thickness_of_surface_snow cfname: lwe_thickness_of_surface_snow_amount - description: Liquid water equivalent thickness of surface snow amount + description: Liquid water equivalent thickness of snow accumulated on surface type: real units: mm - name: mass_content_of_water_in_top_soil_layer @@ -4912,20 +4918,20 @@ section: description: Sea ice thickness type: real units: m - - name: skin_temperature_at_surface_over_ice - description: Skin temperature at surface over (or where) ice + - name: surface_skin_temperature_over_ice + description: Surface skin temperature over (or where) ice type: real units: K - - name: skin_temperature_at_surface_over_land - description: Skin temperature at surface over (or where) land + - name: surface_skin_temperature_over_land + description: Surface skin temperature over (or where) land type: real units: K - - name: skin_temperature_at_surface_over_ocean - description: Skin temperature at surface over (or where) ocean + - name: surface_skin_temperature_over_ocean + description: Surface skin temperatura over (or where) ocean type: real units: K - - name: skin_temperature_at_surface_over_snow - description: Skin temperature at surface over (or where) snow + - name: surface_skin_temperature_over_snow + description: Surface skin temperature over (or where) snow type: real units: K - name: slow_soil_pool_mass_content_of_carbon @@ -4955,11 +4961,11 @@ section: units: K - name: specified_upward_flux_of_water_vapor_mixing_ratio_wrt_moist_air_at_surface description: Specified upward specific humidity (water vapor mass mixing ratio - with respect to moist air) flux at surface + with respect to moist air) flux at surface interface type: real units: kg kg-1 m s-1 - name: specified_upward_temperature_flux_at_surface - description: Specified upward temperature flux at surface + description: Specified upward temperature flux at surface interface type: real units: K m s-1 - name: standard_deviation_of_subgrid_orography @@ -4983,12 +4989,12 @@ section: angle type: real units: fraction - - name: surface_friction_velocity - description: Surface friction velocity + - name: friction_velocity + description: Friction velocity type: real units: m s-1 - - name: surface_friction_velocity_for_momentum - description: Surface friction velocity for momentum + - name: friction_velocity_for_momentum + description: Friction velocity for momentum type: real units: m s-1 - name: surface_longwave_emissivity @@ -5020,8 +5026,8 @@ section: description: Surface sw fluxes assuming total and clear sky on radiation timestep type: ddt units: W m-2 - - name: surface_temperature_scale - description: Surface temperature scale + - name: friction_temperature + description: Friction temperature, a.k.a. temperature scale type: real units: K - name: temperature_in_ice_layer @@ -5054,7 +5060,7 @@ section: units: fraction - name: upward_latent_heat_flux_at_surface cfname: surface_upward_latent_heat_flux - description: Upward latent heat flux at surface + description: Upward latent heat flux at surface interface type: real units: W m-2 - name: urban_area_fraction_of_cell_area @@ -5153,12 +5159,12 @@ section: units: kg kg-1 - name: water_vapor_mixing_ratio_wrt_moist_air_at_surface_over_ice description: Specific humidity (water vapor mass mixing ratio with respect to - moist air) at surface over ice + moist air) at surface interface over ice type: real units: kg kg-1 - name: water_vapor_mixing_ratio_wrt_moist_air_at_surface_over_land description: Specific humidity (water vapor mass mixing ratio with respect to - moist air) at surface over land + moist air) at surface interface over land type: real units: kg kg-1 - name: weak_cosz_area_fraction diff --git a/standard_names.xml b/standard_names.xml index 7ddef69..2e4f831 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -776,6 +776,9 @@ real + + real + real @@ -791,6 +794,9 @@ real + + real + real @@ -812,12 +818,6 @@ real - - real - - - real - integer @@ -3009,6 +3009,9 @@ real + + ddt + real @@ -3090,9 +3093,6 @@ real - - ddt - real @@ -3363,6 +3363,15 @@ real + + real + + + real + + + real + real @@ -3481,18 +3490,6 @@ sea_ice_thickness real - - real - - - real - - - real - - - real - slow_soil_pool_mass_content_of_carbon real @@ -3533,12 +3530,6 @@ real - - real - - - real - surface_longwave_emissivity real @@ -3552,6 +3543,18 @@ real + + real + + + real + + + real + + + real + real @@ -3561,9 +3564,6 @@ ddt - - real - real @@ -3868,4 +3868,4 @@ real
- + \ No newline at end of file From 6a246149d3efac4c55eb727d28996433d1ac2e65 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 09:02:56 -0600 Subject: [PATCH 08/15] Resolve issue 156 per discussion there --- Metadata-standard-names.md | 44 +++++++++--------- Metadata-standard-names.yaml | 88 ++++++++++++++++++------------------ StandardNamesRules.rst | 12 +++++ standard_names.xml | 4 +- 4 files changed, 80 insertions(+), 68 deletions(-) diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md index 1913173..d0ea6ec 100644 --- a/Metadata-standard-names.md +++ b/Metadata-standard-names.md @@ -543,6 +543,8 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = K * `potentially_advected_quantities`: Potentially advected quantities * `real`: units = various +* `pressure_of_dry_air_at_surface`: surface pressure of dry air + * `real`: units = Pa * `ratio_of_water_vapor_gas_constant_to_composition_dependent_dry_air_gas_constant_minus_one`: Ratio of gas constants of water vapor to composition-dependent dry air minus one; (Rwv / Rdair) - 1.0 * `real`: units = 1 * `reciprocal_of_air_pressure_thickness`: Reciprocal of air pressure thickness @@ -553,6 +555,8 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = 1 * `reference_air_pressure_normalized_by_air_pressure_at_surface`: reference pressure normalized by surface pressure * `real`: units = 1 +* `reference_pressure_at_surface`: Reference surface air pressure used in definition of some other quantity (e.g. potential temperature, Exner function, etc.) + * `real`: units = Pa * `reference_pressure_in_atmosphere_layer`: Reference pressure in atmosphere layer * `real`: units = Pa * `reference_pressure_in_atmosphere_layer_normalized_by_reference_pressure_at_surface`: Reference pressure in atmosphere layer normalized by surface reference pressure @@ -567,10 +571,6 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = kg kg-1 * `subgrid_scale_cloud_liquid_water_mixing_ratio_wrt_moist_air`: Subgrid-scale cloud liquid water mass mixing ratio with respect to moist air * `real`: units = kg kg-1 -* `pressure_of_dry_air_at_surface`: surface pressure of dry air - * `real`: units = Pa -* `reference_pressure_at_surface`: Reference surface air pressure used in definition of some other quantity (e.g. potential temperature, Exner function, etc.) - * `real`: units = Pa * `timestep_for_physics`: Timestep for physics * `integer`: units = s * `upward_absolute_vorticity_of_air`: The upward (kth) component of the curl of the vector wind field @@ -1895,7 +1895,7 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = m s-1 * `cloud_phase_transition_threshold_temperature`: Cloud phase transition threshold temperature * `real`: units = K -* `lower_bound_for_depth_of_sea_temperature_for_nsstm`: Lower bound for depth of sea temperature for GFS near-surface sea temperature scheme +* `lower_bound_for_depth_of_ocean_temperature_for_nsstm`: Lower bound for depth of sea temperature for GFS near-surface sea temperature scheme * `integer`: units = mm * `max_critical_relative_humidity`: Maximum critical relative humidity * `real`: units = fraction @@ -1935,7 +1935,7 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = fraction * `sigma_pressure_threshold_at_upper_extent_of_background_diffusion`: Sigma pressure threshold at upper extent of background diffusion * `real`: units = 1 -* `upper_bound_for_depth_of_sea_temperature_for_nsstm`: Upper bound for depth of sea temperature for GFS near-surface sea temperature scheme +* `upper_bound_for_depth_of_ocean_temperature_for_nsstm`: Upper bound for depth of sea temperature for GFS near-surface sea temperature scheme * `integer`: units = mm ## Stochastic physics variables * `atmosphere_heat_diffusivity_from_shoc`: Atmospheric heat diffusivity from Simplified Higher-Order Closure stochastic physics scheme @@ -2043,6 +2043,8 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = W m-2 * `downwelling_shortwave_flux_at_surface_on_radiation_timestep`: Downwelling shortwave flux at surface on radiation timestep * `real`: units = W m-2 +* `lw_fluxes_at_surface_assuming_total_and_clear_sky_on_radiation_timestep`: longwave total sky fluxes at surface interface, assuming clear sky, on radiation timestep + * `ddt`: units = W m-2 * `net_downwelling_diffuse_nir_shortwave_flux_at_surface_for_coupling`: net downwelling diffuse near-infrared shortwave flux at the surface level for coupling * `real`: units = W m-2 * `net_downwelling_diffuse_uv_and_vis_shortwave_flux_at_surface_for_coupling`: net downwelling diffuse ultraviolet and visible shortwave flux at the surface level for coupling @@ -2097,8 +2099,6 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = 1 * `solar_constant`: Solar constant * `real`: units = W m-2 -* `lw_fluxes_at_surface_assuming_total_and_clear_sky_on_radiation_timestep`: longwave total sky fluxes at surface interface, assuming clear sky, on radiation timestep - * `ddt`: units = W m-2 * `upwelling_diffuse_nir_shortwave_flux_at_surface_on_radiation_timestep`: upwelling diffuse near-infrared shortwave flux at the surface level on the radiation timestep * `real`: units = W m-2 * `upwelling_diffuse_uv_and_vis_shortwave_flux_at_surface_on_radiation_timestep`: upwelling diffuse ultraviolet and visible shortwave flux at the surface level on the radiation timestep @@ -2280,6 +2280,12 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = g m-2 * `fine_root_mass_content`: Fine root mass content * `real`: units = g m-2 +* `friction_temperature`: Friction temperature, a.k.a. temperature scale + * `real`: units = K +* `friction_velocity`: Friction velocity + * `real`: units = m s-1 +* `friction_velocity_for_momentum`: Friction velocity for momentum + * `real`: units = m s-1 * `frozen_precipitation_density`: Frozen precipitation density * `real`: units = kg m-3 * `graupel_precipitation_rate_on_previous_timestep`: Graupel precipitation rate on previous timestep @@ -2361,14 +2367,6 @@ Thresholds represent some value at which the behavior of some process changes, i * `sea_ice_thickness`: Sea ice thickness * Equivalent CF name: `sea_ice_thickness` * `real`: units = m -* `surface_skin_temperature_over_ice`: Surface skin temperature over (or where) ice - * `real`: units = K -* `surface_skin_temperature_over_land`: Surface skin temperature over (or where) land - * `real`: units = K -* `surface_skin_temperature_over_ocean`: Surface skin temperatura over (or where) ocean - * `real`: units = K -* `surface_skin_temperature_over_snow`: Surface skin temperature over (or where) snow - * `real`: units = K * `slow_soil_pool_mass_content_of_carbon`: Slow soil pool mass content of carbon * Equivalent CF name: `slow_soil_pool_mass_content_of_carbon` * `real`: units = g m-2 @@ -2396,10 +2394,6 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = g m-2 * `strong_cosz_area_fraction`: Area fraction for albedo with strong dependence on cosine of zenith angle * `real`: units = fraction -* `friction_velocity`: Friction velocity - * `real`: units = m s-1 -* `friction_velocity_for_momentum`: Friction velocity for momentum - * `real`: units = m s-1 * `surface_longwave_emissivity`: Surface longwave emissivity * Equivalent CF name: `surface_longwave_emissivity` * `real`: units = fraction @@ -2409,14 +2403,20 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = fraction * `surface_sensible_heat_due_to_rainfall`: Surface sensible heat due to rainfall * `real`: units = W +* `surface_skin_temperature_over_ice`: Surface skin temperature over (or where) ice + * `real`: units = K +* `surface_skin_temperature_over_land`: Surface skin temperature over (or where) land + * `real`: units = K +* `surface_skin_temperature_over_ocean`: Surface skin temperatura over (or where) ocean + * `real`: units = K +* `surface_skin_temperature_over_snow`: Surface skin temperature over (or where) snow + * `real`: units = K * `surface_snow_mass_content_over_ice`: Surface snow mass content over ice * `real`: units = kg m-2 * `surface_snow_mass_content_over_land`: Surface snow mass content over land * `real`: units = kg m-2 * `surface_sw_fluxes_assuming_total_and_clear_sky_on_radiation_timestep`: Surface sw fluxes assuming total and clear sky on radiation timestep * `ddt`: units = W m-2 -* `friction_temperature`: Friction temperature, a.k.a. temperature scale - * `real`: units = K * `temperature_in_ice_layer`: Temperature in ice layer * `real`: units = K * `temperature_in_surface_snow`: Temperature in surface snow diff --git a/Metadata-standard-names.yaml b/Metadata-standard-names.yaml index 70bdeb1..c2ad91b 100644 --- a/Metadata-standard-names.yaml +++ b/Metadata-standard-names.yaml @@ -1046,6 +1046,10 @@ section: description: Potentially advected quantities type: real units: various + - name: pressure_of_dry_air_at_surface + description: surface pressure of dry air + type: real + units: Pa - name: ratio_of_water_vapor_gas_constant_to_composition_dependent_dry_air_gas_constant_minus_one description: Ratio of gas constants of water vapor to composition-dependent dry air minus one; (Rwv / Rdair) - 1.0 @@ -1068,6 +1072,11 @@ section: description: reference pressure normalized by surface pressure type: real units: 1 + - name: reference_pressure_at_surface + description: Reference surface air pressure used in definition of some other quantity + (e.g. potential temperature, Exner function, etc.) + type: real + units: Pa - name: reference_pressure_in_atmosphere_layer description: Reference pressure in atmosphere layer type: real @@ -1098,15 +1107,6 @@ section: moist air type: real units: kg kg-1 - - name: pressure_of_dry_air_at_surface - description: surface pressure of dry air - type: real - units: Pa - - name: reference_pressure_at_surface - description: Reference surface air pressure used in definition of some other quantity - (e.g. potential temperature, Exner function, etc.) - type: real - units: Pa - name: timestep_for_physics description: Timestep for physics type: integer @@ -3912,7 +3912,7 @@ section: description: Cloud phase transition threshold temperature type: real units: K - - name: lower_bound_for_depth_of_sea_temperature_for_nsstm + - name: lower_bound_for_depth_of_ocean_temperature_for_nsstm description: Lower bound for depth of sea temperature for GFS near-surface sea temperature scheme type: integer @@ -3999,7 +3999,7 @@ section: description: Sigma pressure threshold at upper extent of background diffusion type: real units: 1 - - name: upper_bound_for_depth_of_sea_temperature_for_nsstm + - name: upper_bound_for_depth_of_ocean_temperature_for_nsstm description: Upper bound for depth of sea temperature for GFS near-surface sea temperature scheme type: integer @@ -4247,6 +4247,11 @@ section: description: Downwelling shortwave flux at surface on radiation timestep type: real units: W m-2 + - name: lw_fluxes_at_surface_assuming_total_and_clear_sky_on_radiation_timestep + description: longwave total sky fluxes at surface interface, assuming clear sky, + on radiation timestep + type: ddt + units: W m-2 - name: net_downwelling_diffuse_nir_shortwave_flux_at_surface_for_coupling description: net downwelling diffuse near-infrared shortwave flux at the surface level for coupling @@ -4366,11 +4371,6 @@ section: description: Solar constant type: real units: W m-2 - - name: lw_fluxes_at_surface_assuming_total_and_clear_sky_on_radiation_timestep - description: longwave total sky fluxes at surface interface, assuming clear sky, - on radiation timestep - type: ddt - units: W m-2 - name: upwelling_diffuse_nir_shortwave_flux_at_surface_on_radiation_timestep description: upwelling diffuse near-infrared shortwave flux at the surface level on the radiation timestep @@ -4752,6 +4752,18 @@ section: description: Fine root mass content type: real units: g m-2 + - name: friction_temperature + description: Friction temperature, a.k.a. temperature scale + type: real + units: K + - name: friction_velocity + description: Friction velocity + type: real + units: m s-1 + - name: friction_velocity_for_momentum + description: Friction velocity for momentum + type: real + units: m s-1 - name: frozen_precipitation_density description: Frozen precipitation density type: real @@ -4918,22 +4930,6 @@ section: description: Sea ice thickness type: real units: m - - name: surface_skin_temperature_over_ice - description: Surface skin temperature over (or where) ice - type: real - units: K - - name: surface_skin_temperature_over_land - description: Surface skin temperature over (or where) land - type: real - units: K - - name: surface_skin_temperature_over_ocean - description: Surface skin temperatura over (or where) ocean - type: real - units: K - - name: surface_skin_temperature_over_snow - description: Surface skin temperature over (or where) snow - type: real - units: K - name: slow_soil_pool_mass_content_of_carbon cfname: slow_soil_pool_mass_content_of_carbon description: Slow soil pool mass content of carbon @@ -4989,14 +4985,6 @@ section: angle type: real units: fraction - - name: friction_velocity - description: Friction velocity - type: real - units: m s-1 - - name: friction_velocity_for_momentum - description: Friction velocity for momentum - type: real - units: m s-1 - name: surface_longwave_emissivity cfname: surface_longwave_emissivity description: Surface longwave emissivity @@ -5014,6 +5002,22 @@ section: description: Surface sensible heat due to rainfall type: real units: W + - name: surface_skin_temperature_over_ice + description: Surface skin temperature over (or where) ice + type: real + units: K + - name: surface_skin_temperature_over_land + description: Surface skin temperature over (or where) land + type: real + units: K + - name: surface_skin_temperature_over_ocean + description: Surface skin temperatura over (or where) ocean + type: real + units: K + - name: surface_skin_temperature_over_snow + description: Surface skin temperature over (or where) snow + type: real + units: K - name: surface_snow_mass_content_over_ice description: Surface snow mass content over ice type: real @@ -5026,10 +5030,6 @@ section: description: Surface sw fluxes assuming total and clear sky on radiation timestep type: ddt units: W m-2 - - name: friction_temperature - description: Friction temperature, a.k.a. temperature scale - type: real - units: K - name: temperature_in_ice_layer description: Temperature in ice layer type: real diff --git a/StandardNamesRules.rst b/StandardNamesRules.rst index bbba40f..22e5ceb 100644 --- a/StandardNamesRules.rst +++ b/StandardNamesRules.rst @@ -154,6 +154,18 @@ Terminology * ``[variable]_at_surface_adjacent_layer`` is the bottom layer of the atmospheric model * ``[variable]_at_[level]`` for variables defined at specific height above the surface, e.g. ``temperature_at_2m``, ``wind_at_10m`` +#. By default, `water` refers to all types of water in any phase (e.g. solid, liquid, gas, + fresh water, salt water, etc.). The terms `sea` and `ocean` are synonymous, though new names + should default to using `ocean` unless part of one of the following phrases: + * sea_water + * sea_ice + * sea_level + * sea_salt + * sea_surface + * sea_floor + * sea_binary_mask + * sea_area + #. By default, *mixing_ratio* refers to mass mixing ratios. The description should explicitly specify that it refers to the *mass* mixing ratio. Mass mixing ratios should contain information regarding diff --git a/standard_names.xml b/standard_names.xml index 2e4f831..0b66315 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -2786,7 +2786,7 @@ real - + integer @@ -2846,7 +2846,7 @@ real - + integer From ca4b78eb7255f22ca8477e1833c569f5aee9e199 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 09:10:37 -0600 Subject: [PATCH 09/15] Missed one abbreviation in description --- Metadata-standard-names.md | 2 +- Metadata-standard-names.yaml | 2 +- standard_names.xml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md index d0ea6ec..e30da85 100644 --- a/Metadata-standard-names.md +++ b/Metadata-standard-names.md @@ -1313,7 +1313,7 @@ Variables that indicate or control some action. * `real`: units = 1 * `control_for_vegetation_dataset`: Control for vegetation dataset * `integer`: units = 1 -* `control_for_vertical_index_direction`: control flag for direction of vertical index; 0 indicates index from top of atmosphere to surface, 1 indicates index from surface to toa +* `control_for_vertical_index_direction`: control flag for direction of vertical index; 0 indicates index from top-of-atmosphere to surface, 1 indicates index from surface to top-of-atmosphere * `integer`: units = 1 * `do_aerosol_physics`: Do aerosol physics * `logical`: units = flag diff --git a/Metadata-standard-names.yaml b/Metadata-standard-names.yaml index c2ad91b..62e8cf7 100644 --- a/Metadata-standard-names.yaml +++ b/Metadata-standard-names.yaml @@ -2671,7 +2671,7 @@ section: units: 1 - name: control_for_vertical_index_direction description: control flag for direction of vertical index; 0 indicates index from - top of atmosphere to surface, 1 indicates index from surface to toa + top-of-atmosphere to surface, 1 indicates index from surface to top-of-atmosphere type: integer units: 1 - name: do_aerosol_physics diff --git a/standard_names.xml b/standard_names.xml index 0b66315..177ee86 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -1916,7 +1916,7 @@ integer - + integer From 23d782dcff121395f0528603f8012817a5e24c50 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 09:23:06 -0600 Subject: [PATCH 10/15] Remove duplicate "friction_velocity" entry, clarify description of base name --- Metadata-standard-names.md | 4 +--- Metadata-standard-names.yaml | 8 ++------ standard_names.xml | 5 +---- 3 files changed, 4 insertions(+), 13 deletions(-) diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md index e30da85..38a6e31 100644 --- a/Metadata-standard-names.md +++ b/Metadata-standard-names.md @@ -195,7 +195,7 @@ These names are used as bases for other names, but may also be considered standa * `character`: units = none * `forecast_time`: Forecast time * `real`: units = h -* `friction_velocity`: A measure of shear stress within a fluid layer with units of distance per time +* `friction_velocity`: A measure of shear stress within a fluid layer due to friction against a surface, with units of distance per time * `real`: units = m s-1 * `geopotential`: Gravitational potential energy of a unit mass relative to sea level * Equivalent CF name: `geopotential` @@ -2282,8 +2282,6 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = g m-2 * `friction_temperature`: Friction temperature, a.k.a. temperature scale * `real`: units = K -* `friction_velocity`: Friction velocity - * `real`: units = m s-1 * `friction_velocity_for_momentum`: Friction velocity for momentum * `real`: units = m s-1 * `frozen_precipitation_density`: Frozen precipitation density diff --git a/Metadata-standard-names.yaml b/Metadata-standard-names.yaml index 62e8cf7..7e55311 100644 --- a/Metadata-standard-names.yaml +++ b/Metadata-standard-names.yaml @@ -355,8 +355,8 @@ section: type: real units: h - name: friction_velocity - description: A measure of shear stress within a fluid layer with units of distance - per time + description: A measure of shear stress within a fluid layer due to friction + against a surface, with units of distance per time type: real units: m s-1 - name: geopotential @@ -4756,10 +4756,6 @@ section: description: Friction temperature, a.k.a. temperature scale type: real units: K - - name: friction_velocity - description: Friction velocity - type: real - units: m s-1 - name: friction_velocity_for_momentum description: Friction velocity for momentum type: real diff --git a/standard_names.xml b/standard_names.xml index 177ee86..55226e1 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -262,7 +262,7 @@ real - + real @@ -3366,9 +3366,6 @@ real - - real - real From 3a2f92cf30228121bd6a39bebd5f4cbe9805df47 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 13:01:24 -0600 Subject: [PATCH 11/15] More clarity and additional "skin temperature" definitions --- Metadata-standard-names.md | 5 +++++ Metadata-standard-names.yaml | 11 +++++++++++ StandardNamesRules.rst | 5 +++++ standard_names.xml | 9 ++++++++- 4 files changed, 29 insertions(+), 1 deletion(-) diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md index 38a6e31..5cd6878 100644 --- a/Metadata-standard-names.md +++ b/Metadata-standard-names.md @@ -655,6 +655,9 @@ Variables defining or relating to timing, dates, calendar, and related concepts * `real`: units = m * `reference_sea_surface_temperature`: Foundation/reference temperature for calculating diurnal ocean temperature changes * `real`: units = K +* `sea_surface_skin_temperature`: The temperature of the upper layer of sea surface, typically ~10-100 micrometers, as measured by an infrared radiometer + * Equivalent CF name: `sea_surface_skin_temperature` + * `real`: units = K * `sea_surface_temperature`: Sea surface temperature * Equivalent CF name: `sea_surface_temperature` * `real`: units = K @@ -2097,6 +2100,8 @@ Thresholds represent some value at which the behavior of some process changes, i * `real`: units = W m-2 * `sine_of_solar_declination_angle`: Sine of solar declination angle * `real`: units = 1 +* `skin_temperature_at_toa`: The temperature that a theoretical infinitely thin air layer above the atmosphere would have in radiative equilibrium + * `real`: units = K * `solar_constant`: Solar constant * `real`: units = W m-2 * `upwelling_diffuse_nir_shortwave_flux_at_surface_on_radiation_timestep`: upwelling diffuse near-infrared shortwave flux at the surface level on the radiation timestep diff --git a/Metadata-standard-names.yaml b/Metadata-standard-names.yaml index 7e55311..732bf1f 100644 --- a/Metadata-standard-names.yaml +++ b/Metadata-standard-names.yaml @@ -1287,6 +1287,12 @@ section: changes type: real units: K + - name: sea_surface_skin_temperature + cfname: sea_surface_skin_temperature + description: The temperature of the upper layer of sea surface, typically ~10-100 + micrometers, as measured by an infrared radiometer + type: real + units: K - name: sea_surface_temperature cfname: sea_surface_temperature description: Sea surface temperature @@ -4367,6 +4373,11 @@ section: description: Sine of solar declination angle type: real units: 1 + - name: skin_temperature_at_toa + description: The temperature that a theoretical infinitely thin air layer above + the atmosphere would have in radiative equilibrium + type: real + units: K - name: solar_constant description: Solar constant type: real diff --git a/StandardNamesRules.rst b/StandardNamesRules.rst index 22e5ceb..b85ff45 100644 --- a/StandardNamesRules.rst +++ b/StandardNamesRules.rst @@ -154,6 +154,11 @@ Terminology * ``[variable]_at_surface_adjacent_layer`` is the bottom layer of the atmospheric model * ``[variable]_at_[level]`` for variables defined at specific height above the surface, e.g. ``temperature_at_2m``, ``wind_at_10m`` + Note that some commonly used terms with a prefix ``surface_`` are unavoidable due to the common + definition being fundamentally different from unqualified ``X``. For example, ``surface_skin_temperature`` + is a fundamentally different quantity than the unqualified ``skin_temperature``. In cases such as these, + a comment should be included noting this special usage of the word "surface". + #. By default, `water` refers to all types of water in any phase (e.g. solid, liquid, gas, fresh water, salt water, etc.). The terms `sea` and `ocean` are synonymous, though new names should default to using `ocean` unless part of one of the following phrases: diff --git a/standard_names.xml b/standard_names.xml index 55226e1..b6575c3 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -338,7 +338,7 @@ solar_zenith_angle real - + surface_skin_temperature real @@ -942,6 +942,10 @@ real + + sea_surface_skin_temperature + real + sea_surface_temperature real @@ -3090,6 +3094,9 @@ real + + real + real From 36899d195b1e5f4dff5c0674f97e51470ff637f1 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 13:04:09 -0600 Subject: [PATCH 12/15] Fix non-ASCII character --- standard_names.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/standard_names.xml b/standard_names.xml index b6575c3..6792042 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -3094,7 +3094,7 @@ real - + real From efce0411ccbb5fb0d88c8e94dde96a0ea136429d Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Tue, 22 Sep 2026 13:13:54 -0600 Subject: [PATCH 13/15] Fix abandoned sentence fragment --- StandardNamesRules.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/StandardNamesRules.rst b/StandardNamesRules.rst index b85ff45..97a2227 100644 --- a/StandardNamesRules.rst +++ b/StandardNamesRules.rst @@ -141,7 +141,9 @@ Terminology `annotated image detailing some of the terminology in this section `_ -#. A "layer" is a vertical level of a model. A variable for a given layer is either at the vertical centerpoint of a level, or the vertical average of a level, as defined by the host (see above). An "interface" is the boundary above or below a layer. A variable specified at a given interface +#. A "layer" is a vertical level of a model. A variable for a given layer is either at the vertical + centerpoint of a level, or the vertical average of a level, as defined by the host (see above). + An "interface" is the boundary above or below a layer. #. By default, *surface* refers to the liquid or solid substance immediately beneath the atmosphere for a given vertical column. This can be land, ocean, ice, lake, etc. From 06ca426975574603450012909fcf2da9bad1afb7 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Fri, 25 Sep 2026 11:08:12 -0600 Subject: [PATCH 14/15] Clarify 'skin_temperature' is not a stand-alone name --- StandardNamesRules.rst | 5 +++-- standard_names.xml | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/StandardNamesRules.rst b/StandardNamesRules.rst index 97a2227..747c5ad 100644 --- a/StandardNamesRules.rst +++ b/StandardNamesRules.rst @@ -158,8 +158,9 @@ Terminology Note that some commonly used terms with a prefix ``surface_`` are unavoidable due to the common definition being fundamentally different from unqualified ``X``. For example, ``surface_skin_temperature`` - is a fundamentally different quantity than the unqualified ``skin_temperature``. In cases such as these, - a comment should be included noting this special usage of the word "surface". + is a fundamentally different quantity than the unqualified ``skin_temperature`` (as in the name + ``skin_temperature_at_toa``). In cases such as these, a comment should be included noting this + special usage of the word "surface". #. By default, `water` refers to all types of water in any phase (e.g. solid, liquid, gas, fresh water, salt water, etc.). The terms `sea` and `ocean` are synonymous, though new names diff --git a/standard_names.xml b/standard_names.xml index 6792042..62b5516 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -3872,4 +3872,4 @@ real - \ No newline at end of file + From 9cdc9cc549c825f5d26a3268ecc96dafab71e163 Mon Sep 17 00:00:00 2001 From: "Michael Kavulich, Jr" Date: Fri, 25 Sep 2026 11:42:44 -0600 Subject: [PATCH 15/15] Attempt to clarify "interface" usage and definition --- Metadata-standard-names.md | 2 +- Metadata-standard-names.yaml | 3 ++- StandardNamesRules.rst | 4 +++- standard_names.xml | 6 +++--- 4 files changed, 9 insertions(+), 6 deletions(-) diff --git a/Metadata-standard-names.md b/Metadata-standard-names.md index 5cd6878..6a04078 100644 --- a/Metadata-standard-names.md +++ b/Metadata-standard-names.md @@ -245,7 +245,7 @@ These names are used as bases for other names, but may also be considered standa * `solar_zenith_angle`: The angle between the direction to the sun and the local zenith (vertical direction) * Equivalent CF name: `solar_zenith_angle` * `real`: units = degrees -* `surface_skin_temperature`: The temperature of the interface of the surface and the atmosphere +* `surface_skin_temperature`: The temperature of the shared interface between the surface and the atmosphere * Equivalent CF name: `surface_skin_temperature` * `real`: units = K * `temperature_flux`: Flux of temperature across a unit surface diff --git a/Metadata-standard-names.yaml b/Metadata-standard-names.yaml index 732bf1f..51e86ed 100644 --- a/Metadata-standard-names.yaml +++ b/Metadata-standard-names.yaml @@ -457,7 +457,8 @@ section: units: degrees - name: surface_skin_temperature cfname: surface_skin_temperature - description: The temperature of the interface of the surface and the atmosphere + description: The temperature of the shared interface between the surface and + the atmosphere type: real units: K - name: temperature_flux diff --git a/StandardNamesRules.rst b/StandardNamesRules.rst index 747c5ad..2672e01 100644 --- a/StandardNamesRules.rst +++ b/StandardNamesRules.rst @@ -139,11 +139,13 @@ Variable scope Terminology ----------- + In this section we define terms that are used within these rules, the Standard Names, and their descriptions. + `annotated image detailing some of the terminology in this section `_ #. A "layer" is a vertical level of a model. A variable for a given layer is either at the vertical centerpoint of a level, or the vertical average of a level, as defined by the host (see above). - An "interface" is the boundary above or below a layer. + An "interface" is the boundary at the top or bottom of a layer. #. By default, *surface* refers to the liquid or solid substance immediately beneath the atmosphere for a given vertical column. This can be land, ocean, ice, lake, etc. diff --git a/standard_names.xml b/standard_names.xml index 62b5516..1f4e081 100644 --- a/standard_names.xml +++ b/standard_names.xml @@ -338,7 +338,7 @@ solar_zenith_angle real - + surface_skin_temperature real @@ -425,7 +425,7 @@ integer - + integer @@ -3872,4 +3872,4 @@ real - + \ No newline at end of file