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.

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

Clarification wrt mixing ratios #16

Merged
merged 2 commits into from
Aug 3, 2021
Merged
Changes from all commits
Commits
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
23 changes: 21 additions & 2 deletions StandardNamesRules.rst
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,24 @@ CCPP Standard Name Rules
representing quantities at the interface between grid cells vertically,
use at_interface.

#. By default, *mixing_ratio* refers to mass mixing ratios. The long name should
explicitly specify that it refers to the *mass* mixing ratio.
Mass mixing ratios should contain information regarding
with respect to what quantity they are defined, and options are *wrt_dry_air*, *wrt_moist_air*,
or *wrt_total_mass*, where *moist_air* refers to dry air plus vapor and *total_mass* refers
to dry air plus vapor and hydrometeors. A special case exists in the case of mixing ratio
of vapor: the standard name *specific_humidity* should be used instead of
*mixing_ratio_of_vapor_wrt_moist_air*.

#. Volume mixing ratios should be qualified as *volume_mixing_ratio*.

#. When referring to soil quantities,
*volume_fraction* should be used to express the volumetric soil moisture.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Soil moisture should be a separate point from the microphysics paragraph above.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

OK, we can put the soil aspect in a different bullet

Copy link
Collaborator

Choose a reason for hiding this comment

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

Looks fine now.

#. Number concentration should appear as a prefix, that is, *number_concentration_of*. By default,
number concentrations are specified per unit of volume. When they are specified per
unit of mass, they should be written as *mass_number_concentration_of*.

#. If possible, qualifiers should be limited in order to allow for a wide
applicability of the variable. In other words, don't qualify with _for ``_xyz``
unless a variable could not conceivably be used outside of the more
Expand Down Expand Up @@ -253,7 +271,6 @@ Prefixes
| **index_of**
| **vertical_index_at**
| **vertical_dimension_of**
| **volumetric**
| **cumulative**
| **iounit_of**
| **filename_of**
Expand Down Expand Up @@ -438,7 +455,7 @@ standard names.
+-------------------------------------------+-----------------+
| mass_fraction | 1 |
+-------------------------------------------+-----------------+
| mass_mixing_ratio | 1 |
| mixing_ratio | kg kg-1 |
+-------------------------------------------+-----------------+
| mass_transport k | g s-1 |
+-------------------------------------------+-----------------+
Expand Down Expand Up @@ -478,6 +495,8 @@ standard names.
+-------------------------------------------+-----------------+
| volume_fraction | 1 |
+-------------------------------------------+-----------------+
| volume_mixing_ratio | mol mol-1 |
+-------------------------------------------+-----------------+
gold2718 marked this conversation as resolved.
Show resolved Hide resolved
| volume_transport | m3 s-1 |
+-------------------------------------------+-----------------+
| vorticity | s-1 |
Expand Down