Guidelines for Construction of CF Standard Names
Version 1, 3 December 2008
Table of Contents
Most of the CF standard names in the Standard Name Table have been constructed following the guidelines described here, which have themselves drawn on the ECMWF and NCEP GRIB tables, the PCMDI standard variable names, and the NASA Global Change Master Directory . The guidelines may help to interpret the names and to suggest how new names could be derived. Please send requests and questions concerning standard names to the CF metadata mailing list.
Standard names consist of lower-letters, digits and underscores, and begin with a letter. Upper case is not used.
Standard names may be qualified by the addition of phrases in certain standard forms and order. These qualifications do not change the units of the quantity. All of the following phrases in  are optional. The words in
typewriter type appear explicitly as stated, while the words in italic indicate other words or phrases to be substituted. The new standard name is constructed by joining the base standard name to the qualifiers using underscores.
A surface is defined as a function of horizontal position. Surfaces which are defined using a coordinate value (e.g. height of 1.5 m) are indicated by a single-valued coordinate variable, not by the standard name. In the standard name, some surfaces are named by single words which are placed at the start:
toa (top of atmosphere),
surface. Other surfaces are named by multi-word phrases put after
The surface called "
surface" means the lower boundary of the atmosphere.
sea_level means mean sea level, which is close to the geoid in sea areas.
ground_level means the land surface (beneath the snow and surface water, if any).
cloud_base refers to the base of the lowest cloud.
cloud_top refers to the top of the highest cloud. Fluxes at the
top_of_atmosphere_model differ from TOA fluxes only if the model TOA fluxes make some allowance for the atmosphere above the top of the model; if not, it is usual to give standard names with
toa to the fluxes at the top of the model atmosphere.
The direction of the spatial component of a vector is indicated by one of the words
The last two indicate directions along the horizontal grid being used when they are not true longitude and latitude (if there is a rotated pole, for instance).
If the standard name indicates a tensor quantity, two of these direction words may be included, applying to two of the spatial dimensions Z Y X, in that order. If only one component is indicated for a tensor, it means the flux in the indicated direction of the magnitude of the vector quantity in the plane of the other two spatial dimensions.
The names of vertical components of radiative fluxes are prefixed with
net_upward. This treatment is not applied for any kinds of flux other than radiative. Radiative fluxes from above and below are often measured and calculated separately, the "net" being the difference. Within the atmosphere, radiation from below (not net) is indicated by a prefix of
upwelling, and from above with
downwelling. For the top of the atmosphere, the prefixes
outgoing are used instead.
A medium indicates the local medium or layer within which an intensive quantity applies:
The specification of a physical process by the phrase
due_to_process means that the quantity named is a single term in a sum of terms which together compose the general quantity named by omitting the phrase. Possibilites are:
due_to_thermodynamics (referring to sea ice freezing and melting).
Standard names may be derived from other standard names (represented here by X, Y and Z) by the following rules. Successive transformations may be applied. Transformations may alter the units as shown.
||[X]||change in a quantity X over a time-interval, which should be defined by the bounds of the time coordinate.|
||[horizontal] convergence of a vector X (i.e. the divergence multiplied by -1); if X does not have a vertical component then "horizontal" should be omitted.|
||correlation coefficient for variations (over Z e.g. time, longitude) of X and Y. X and Y are ordered alphabetically.|
||[X]*[Y]||covariance for variations (over Z e.g. time, longitude) of X and Y. X and Y are ordered alphabetically.|
||derivative of X with respect to distance in the component direction, which may be
||[X]/[Y]||dX/dY (keeping any other independent variables constant, i.e. the partial derivative if appropriate).|
||direction of a vector, a bearing.|
||[horizontal] divergence of a vector X; if X does not have a vertical component then "horizontal" should be omitted.|
||histogram (i.e. number of counts for each range of X) of variations (over Z) of X. The data variable should have an axis for X.|
||[X]*[Y]||int Y dX. The data variable should have an axis for X specifying the limits of the integral as bounds.|
||natural logarithm of X. X must be dimensionless.|
||common logarithm (i.e. base 10) of X. X must be dimensionless.|
||[X]||magnitude of a vector X.|
||probability distribution (i.e. a number in the range 0.0-1.0 for each range of X) of variations (over Z) of X. The data variable should have an axis for X.|
||PDF for variations (over Z) of X. The data variable should have an axis for X.|
||[X]*[Y]||X*Y. If X and Y are both scalars or both components of vectors, they are put in alphabetical order. If one of them is the component of a vector, it is put first i.e. the vector component is X, the scalar is Y.|
||derivative of X with respect to time.|
Some words and phrases have meanings which should be noted.
||difference from climatology|
||horizontal area unless otherwise stated|
||used instead of
||liquid and ice|
||liquid water equivalent|
||water in all phases contained in soil|
||used instead of
||per unit mass unless otherwise stated|
||standard temperature (0 degC) and pressure (101325 Pa)|
||top of atmosphere|
||liquid and vapour|
||water in all phases if not otherwise qualified|
||with respect to|
The following names are used to identify chemical species in standard names.
The following names are used with consistent meanings and units as elements in other standard names, although they are themselves too general to be chosen as standard names. They are recorded here for reference only. These are not standard names.
|kg m-2 s-1||mass_flux|
|mol m-2 s-1||mole_flux|