Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add water variables #69

Merged
merged 4 commits into from
Jun 2, 2024
Merged

Add water variables #69

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
bdd721e
Add water variables
May 9, 2024
dfd503b
Fix incomplete long name
May 21, 2024
ef9966c
Add rule on total water
May 21, 2024
2cf1783
Update xml table
May 21, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions Metadata-standard-names.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -253,6 +253,14 @@ Note that appending '_on_previous_timestep' to standard_names in this section yi
* `real(kind=kind_phys)`: units = kg m-2
* `mass_content_of_cloud_liquid_water_in_atmosphere_layer`: Mass content of cloud liquid water in atmosphere layer
* `real(kind=kind_phys)`: units = kg m-2
* `mass_content_of_rain_in_atmosphere_layer`: Mass content of rain in atmosphere layer
* `real(kind=kind_phys)`: units = kg m-2
* `mass_content_of_snow_in_atmosphere_layer`: Mass content of snow in atmosphere layer
* `real(kind=kind_phys)`: units = kg m-2
* `mass_content_of_graupel_in_atmosphere_layer`: Mass content of graupel in atmosphere layer
* `real(kind=kind_phys)`: units = kg m-2
* `mass_content_of_hail_in_atmosphere_layer`: Mass content of hail in atmosphere layer
* `real(kind=kind_phys)`: units = kg m-2
* `nonconvective_cloud_area_fraction_in_atmosphere_layer`: cloud area fraction in atmosphere layer excluding clouds produced by the convective schemes
* `real(kind=kind_phys)`: units = fraction
* `relative_humidity`: Relative humidity
Expand Down Expand Up @@ -286,24 +294,58 @@ Note that appending '_on_previous_timestep' to standard_names in this section yi
* `real(kind=kind_phys)`: units = kg kg-1
* `water_vapor_mixing_ratio_wrt_moist_air_and_condensed_water`: Ratio of the mass of water vapor to the mass of moist air and hydrometeors
* `real(kind=kind_phys)`: units = kg kg-1
* `water_vapor_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces`: Ratio of the mass of water vapor to the mass of moist air and hydrometeors at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `mole_fraction_of_water_vapor`: Mole fraction of water vapor
* `real(kind=kind_phys)`: units = mol mol-1
* `water_vapor_mixing_ratio_wrt_dry_air`: Ratio of the mass of water vapor to the mass of dry air
* `real(kind=kind_phys)`: units = kg kg-1
* `water_vapor_mixing_ratio_wrt_dry_air_at_top_interfaces`: Ratio of the mass of water vapor to the mass of dry air at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_liquid_water_mixing_ratio_wrt_moist_air_and_condensed_water`: Ratio of the mass of liquid water to the mass of moist air and condensed water
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_liquid_water_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces`: Ratio of the mass of liquid water to the mass of moist air and condensed water at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_liquid_water_mixing_ratio_wrt_moist_air`: Ratio of the mass of liquid water to the mass of moist air
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_liquid_water_mixing_ratio_wrt_dry_air`: Ratio of the mass of liquid water to the mass of dry air
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_liquid_water_mixing_ratio_wrt_dry_air_at_top_interfaces`: Ratio of the mass of liquid water to the mass of dry air at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_ice_mixing_ratio_wrt_moist_air_and_condensed_water`: Ratio of the mass of ice to the mass of moist air and condensed water
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_ice_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces`: Ratio of the mass of ice to the mass of moist air and condensed water
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_ice_mixing_ratio_wrt_dry_air`: Ratio of the mass of ice to the mass of dry air
* `real(kind=kind_phys)`: units = kg kg-1
* `cloud_ice_mixing_ratio_wrt_dry_air_at_top_interfaces`: Ratio of the mass of ice to the mass of dry air at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `rain_mixing_ratio_wrt_moist_air_and_condensed_water`: ratio of the mass of rain to the mass of moist air and condensed water
* `real(kind=kind_phys)`: units = kg kg-1
* `rain_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces`: ratio of the mass of rain to the mass of moist air and condensed water at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `rain_mixing_ratio_wrt_moist_air`: ratio of the mass of rain to the mass of moist air
* `real(kind=kind_phys)`: units = kg kg-1
* `rain_mixing_ratio_wrt_dry_air`: ratio of the mass of rain to the mass of dry air
* `real(kind=kind_phys)`: units = kg kg-1
* `rain_mixing_ratio_wrt_dry_air_at_top_interfaces`: ratio of the mass of rain to the mass of dry air at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `total_water_mixing_ratio_wrt_moist_air_and_condensed_water`: ratio of the mass of water to the mass of moist air and condensed water
* `real(kind=kind_phys)`: units = kg kg-1
* `total_water_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces`: ratio of the mass of water to the mass of moist air and condensed water at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `total_water_mixing_ratio_wrt_dry_air`: ratio of the mass of water to the mass of dry air
* `real(kind=kind_phys)`: units = kg kg-1
* `total_water_mixing_ratio_wrt_dry_air_at_top_interfaces`: ratio of the mass of water to the mass of dry air at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `water_vapor_mixing_ratio_wrt_moist_air_and_condensed_water_assuming_saturation`: saturated water vapor mixing ratio with respect to moist air and condensed water
* `real(kind=kind_phys)`: units = kg kg-1
* `water_vapor_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces_assuming_saturation`: saturated water vapor mixing ratio with respect to moist air and condensed water at all interfaces excluding surface
* `real(kind=kind_phys)`: units = kg kg-1
* `derivative_of_ln_water_vapor_partial_pressure_assuming_saturation_wrt_air_temperature`: log derivative of the water vapor partial pressure at saturation with respect to air temperature
* `real(kind=kind_phys)`: units = K-1
* `derivative_of_ln_water_vapor_partial_pressure_assuming_saturation_wrt_air_temperature_at_top_interfaces`: log derivative of the water vapor partial pressure at saturation with respect to air temperature at all interfaces excluding surface
* `real(kind=kind_phys)`: units = K-1
* `mole_fraction_of_ozone_in_air`: Mole fraction of ozone in air
* `real(kind=kind_phys)`: units = mol mol-1
* `mole_fraction_of_carbon_dioxide_in_air`: Mole fraction of carbon dioxide in air
Expand Down
80 changes: 80 additions & 0 deletions standard_names.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -406,6 +406,18 @@
<standard_name name="mass_content_of_cloud_liquid_water_in_atmosphere_layer">
<type kind="kind_phys" units="kg m-2">real</type>
</standard_name>
<standard_name name="mass_content_of_rain_in_atmosphere_layer">
<type kind="kind_phys" units="kg m-2">real</type>
</standard_name>
<standard_name name="mass_content_of_snow_in_atmosphere_layer">
<type kind="kind_phys" units="kg m-2">real</type>
</standard_name>
<standard_name name="mass_content_of_graupel_in_atmosphere_layer">
<type kind="kind_phys" units="kg m-2">real</type>
</standard_name>
<standard_name name="mass_content_of_hail_in_atmosphere_layer">
<type kind="kind_phys" units="kg m-2">real</type>
</standard_name>
Comment on lines +415 to +420
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How do these two interact with do_graupel_instead_of_hail and do_hail_instead_of_graupel? Does the CCPP consider these either / or or are can you use both? Can you use do_graupel_instead_of_hail with mass_content_of_hail_in_atmosphere_layer? How does that work?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Graupel and hail are different things, so you can definitely use both hail "mass content" and graupel "mass content", although I kwow schemes which assume that all graupel and hail can be considered as graupel, for simplification.

I didn't know about the do_hail_instead_of_graupel and do_graupel_instead_of_hail flags. My guess is that these flags are used in the some part of GFS microphysics scheme do activate similar simplifications.
Maybe @grantfirl (who added these flag names) or @gthompsnJCSDA can give some insight on this.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Graupel and hail are different things

Well for sure I'd rather get hit on the head with graupel :)

<standard_name
name="nonconvective_cloud_area_fraction_in_atmosphere_layer"
long_name="cloud area fraction in atmosphere layer excluding clouds produced by the convective schemes">
Expand Down Expand Up @@ -467,17 +479,29 @@
long_name="Ratio of the mass of water vapor to the mass of moist air and hydrometeors">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="water_vapor_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces"
long_name="Ratio of the mass of water vapor to the mass of moist air and hydrometeors at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="mole_fraction_of_water_vapor">
<type kind="kind_phys" units="mol mol-1">real</type>
</standard_name>
<standard_name name="water_vapor_mixing_ratio_wrt_dry_air"
long_name="Ratio of the mass of water vapor to the mass of dry air">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="water_vapor_mixing_ratio_wrt_dry_air_at_top_interfaces"
long_name="Ratio of the mass of water vapor to the mass of dry air at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_liquid_water_mixing_ratio_wrt_moist_air_and_condensed_water"
long_name="Ratio of the mass of liquid water to the mass of moist air and condensed water">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_liquid_water_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces"
long_name="Ratio of the mass of liquid water to the mass of moist air and condensed water at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_liquid_water_mixing_ratio_wrt_moist_air"
long_name="Ratio of the mass of liquid water to the mass of moist air">
<type kind="kind_phys" units="kg kg-1">real</type>
Expand All @@ -486,14 +510,34 @@
long_name="Ratio of the mass of liquid water to the mass of dry air">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_liquid_water_mixing_ratio_wrt_dry_air_at_top_interfaces"
long_name="Ratio of the mass of liquid water to the mass of dry air at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_ice_mixing_ratio_wrt_moist_air_and_condensed_water"
long_name="Ratio of the mass of ice to the mass of moist air and condensed water">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_ice_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces"
long_name="Ratio of the mass of ice to the mass of moist air and condensed water">
MayeulDestouches marked this conversation as resolved.
Show resolved Hide resolved
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_ice_mixing_ratio_wrt_dry_air"
long_name="Ratio of the mass of ice to the mass of dry air">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="cloud_ice_mixing_ratio_wrt_dry_air_at_top_interfaces"
long_name="Ratio of the mass of ice to the mass of dry air at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="rain_mixing_ratio_wrt_moist_air_and_condensed_water"
long_name="ratio of the mass of rain to the mass of moist air and condensed water">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="rain_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces"
long_name="ratio of the mass of rain to the mass of moist air and condensed water at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="rain_mixing_ratio_wrt_moist_air"
long_name="ratio of the mass of rain to the mass of moist air">
<type kind="kind_phys" units="kg kg-1">real</type>
Expand All @@ -502,6 +546,42 @@
long_name="ratio of the mass of rain to the mass of dry air">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="rain_mixing_ratio_wrt_dry_air_at_top_interfaces"
long_name="ratio of the mass of rain to the mass of dry air at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="total_water_mixing_ratio_wrt_moist_air_and_condensed_water"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add a new rule to StandardNamesRules.rst stating that the phrase total_water includes all types of water in all phases? I realize that it is somewhat obvious, but I would rather be overly-pedantic then risk potential confusion/argument later.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nusbaume I did not pick up on it before, but now I think I am also confused in the same way you are. In this particular case, "total water" would imply that this ratio is:

(mass water vapor) + (mass liquid water) + (mass water ice)
---------------------------------------------------------
(mass water vapor) + (mass liquid water) + (mass dry air)

@MayeulDestouches am I interpreting that correctly?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have added a rule to clarify what total_water is.

@mkavulich, this ratio is

       (mass water vapor) + (mass liquid water) + (mass water ice)
----------------------------------------------------------------------------
(mass water vapor) + (mass liquid water) + (mass water ice) + (mass dry air)

long_name="ratio of the mass of water to the mass of moist air and condensed water">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="total_water_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces"
long_name="ratio of the mass of water to the mass of moist air and condensed water at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="total_water_mixing_ratio_wrt_dry_air"
long_name="ratio of the mass of water to the mass of dry air">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="total_water_mixing_ratio_wrt_dry_air_at_top_interfaces"
long_name="ratio of the mass of water to the mass of dry air at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="water_vapor_mixing_ratio_wrt_moist_air_and_condensed_water_assuming_saturation"
long_name="saturated water vapor mixing ratio with respect to moist air and condensed water">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="water_vapor_mixing_ratio_wrt_moist_air_and_condensed_water_at_top_interfaces_assuming_saturation"
long_name="saturated water vapor mixing ratio with respect to moist air and condensed water at all interfaces excluding surface">
<type kind="kind_phys" units="kg kg-1">real</type>
</standard_name>
<standard_name name="derivative_of_ln_water_vapor_partial_pressure_assuming_saturation_wrt_air_temperature"
long_name="log derivative of the water vapor partial pressure at saturation with respect to air temperature">
<type kind="kind_phys" units="K-1">real</type>
</standard_name>
<standard_name name="derivative_of_ln_water_vapor_partial_pressure_assuming_saturation_wrt_air_temperature_at_top_interfaces"
long_name="log derivative of the water vapor partial pressure at saturation with respect to air temperature at all interfaces excluding surface">
<type kind="kind_phys" units="K-1">real</type>
</standard_name>
<standard_name name="mole_fraction_of_ozone_in_air">
<type kind="kind_phys" units="mol mol-1">real</type>
</standard_name>
Expand Down
Loading