CF specs and defaults

This appendix refers to the searching and formatting specifications for data variables and coordinates, and related tools, available in the xoa.cf module. Their usage is introduced in the Naming conventions with xoa.cf section.

The default configuration

Note

You can define you own specifications for each of your datasets. Have a look to the Naming conventions with xoa.cf section and to the Examples.

Data variables (data_vars)

ptemp	Potential temperature
ctemp	Conservative temperature
temp	Sea water in situ temperature
asal	Absolute salinity
pfsal	Preformed salinity
psal	Practical salinity
sal	Salinity
sst	Sea surface temperature
sss	Sea surface salinity
sigmat	Sea water density minus 1000
ndens	Sea water neutral density
sigmatheta	Sea water potential density minus 1000
pdens	Sea water potential density
sigma0	Sea water potential density
sigma1	Sea water potential density with ref at 1000 dbar
sigma2	Sea water potential density with ref at 2000 dbar
sigma3	Sea water potential density with ref at 3000 dbar
sigma4	Sea water potential density with ref at 4000 dbar
dens	Sea water density
pres	Sea water pressure
ssd	Sea surface density
conduct	Sea water electrial conductivity
sndspd	Speed of sound in water
mld	Mixed layer depth
ped	Potential energy deficit
ohc	Ocean heat content
osc	Ocean salt content
cp	Specific heat capacity
ssh	Sea surface height
u	Sea water velocity along X
v	Sea water velocity along Y
w	Sea water velocity along Z at W location
ubt	Sea water barotropic velocity along X
vbt	Sea water barotropic velocity along Y
ubc	Sea water baroclinic velocity along X
vbc	Sea water baroclinic velocity along Y
usurf	Sea surface velocity along X
vsurf	Sea surface velocity along Y
ugbt	Sea water barotropic geostrophic velocity along X
vgbt	Sea water barotropic geostrophic velocity along Y
cspd	Sea water speed
speed	Sea water speed
cdir	Direction of sea water velocity
ke	Kinetic energy
eke	Eddy kinetic energy
tke	Turbulent kinetic energy
mke	Mke
kz	Vertical diffusivity
akt	Vertical heat diffusivity
vaisa	Brunt Vaisala frequency
bathy	Bathymetry
meanlev	Mean Sea Level
dx	Mesh size along x
dy	Mesh size along y
ex	Inverse of mesh size along x
ey	Inverse of mesh size along y
dz	Ocean layer thickness
dlon	Mesh size along x
dlat	Mesh step along y
angle	Angle between x-axis and east
mask	Land binary mask
cvol	Volume of the cell
vol	Volume of the sea water
corio	Coriolis parameter
beta	Meridional derivative of coriolis parameter
oro	Orography for SLEVE vertical coordinates
orosm	Smoothed orography for SLEVE vertical coordinates
nethf	Net radiation
lwnhf	Net longwave radiation (positive when directed downward)
swnhf	Net shortwave radiation (positive when directed downward)
ghf	Ground heat flux (SW + LW - LE - H)
lwuhf	Longwave radiation (positive when directed upward)
swuhf	Shortwave radiation (positive when directed upward)
lwdhf	Longwave radiation (positive when directed downward)
swdhf	Shortwave radiation (positive when directed downward)
lathf	Latent heat flux (positive when directed downward)
hflat	Latent heat flux (positive when directed upward)
senhf	Sensible heat flux (positive when directed downward)
hfsen	Sensible heat flux (positive when directed upward)
evap	evaporation (positive when directed downward)
rain	Precipitation [Downward (positive when it is raining)]
t2m	T2m
q2m	2 m specific humidity
hu2m	2 m specific humidity
z0a	Air roughness length
cda	Averaged drag momentum coefficient
cha	Averaged drag thermal coefficient
cea	Averaged latent heat flux coefficient
wspd	Wind speed
wdir	Wind direction
wfdir	Wind from direction
wtdir	Wind to direction
uair	Zonal wind speed (westerly)
vair	Meridional wind speed (northerly)
wair	Upward wind speed
tair	Temperature
pa	Absolute pressure
ps	Surface air pressure
plev	Air pressure
ptop	Air pressure at top of model
tkea	Turbulent Kinetic Energy
u10m	10-m zonal wind speed (westerly)
v10m	10-m meridional wind speed (northerly)
w10m	10-m meridional wind speed (northerly)
ux10m	10-m wind speed along X
vy10m	10-m wind speed along Y
tauu	Surface eastward wind stress
tauv	Surface northward wind stress
taux	Surface wind stress along X
tauy	Surface wind stress along Y
topheight	Height of the top level
hbl	Depth of planetary boundary layer
hs	Significant wave height
mssx	Eastward mean square slope
mssy	Northward mean square slope
mss	mean square slope
mlw	Mean wave length
t0m1	Mean wave period
dp	Peak direction
tp	Peak period
fp	Peak frequency
th1p	Mean wave direction
char	Charnock coefficient for surface roughness length for momentum in air
ubr	Near bottom rms velocities
uubr	Rms of near bottom zonal velocities
vubr	Rms of near bottom meridional velocities
bhd	Radiation pressure (Bernoulli head)
foc	Wave mixing kinetic turbulent energy due to surface breaking wave
utwo	Zonal component of the surface wave-ocean momentum flux
vtwo	Meridional component of the surface wave-ocean momentum flux
utaw	Eastward wave supported wind stress
vtaw	Northward wave supported wind stress
fbb	Wave dissipation in bottom boundary layer
utbb	Zonal component of the bottom wave-ocean momentum flux
vtbb	Meridional component of the bottom wave-ocean momentum flux
uuss	Eastward surface stokes drift
vuss	Northward surface stokes drift
utus	Eastward stokes transport
vtus	Northward stokes transport
mapsta	Status map
wlv	Wlv
sig	Sigma level
cs	S-coordinate stretching curves
hc	Sigma-coordinate critical depth
thetas	Ocean s coordinate surface control
thetab	Ocean s coordinate bottom control
depth	Depth
altitude	Altitude
station	Station number
calday	Calendar day
echoint	Echo intensity

Coordinates (coords)

x	X-dimension of the grid
y	Y-dimension of the grid
level	Model level number
lon	Longitude
lat	Latitude
depth	Depth
altitude	Altitude
sig	Sigma level
time	Time
forecast	Forecast horizon
freq	Frequency
station	Station number
member	Ensemble member

Dimensions (dims)

x	x, lon, xi, nx, ni, x, imt, ipi, longitude, nav_lon, longitudes, lons
y	y, lat, yi, ny, nj, y, jmt, jpj, latitude, nav_lat, latitudes, lats
z	level, depth, altitude, sig, station, model_level, lev, nz, nk, z, kmt, zi, dep, altitudet, altitudeu, altitudev, s_level, sigma, s, sigma_level, stations
t	time, nt
f	forecast, nf, fcst

Other sections

register	Registration
sglocator	Staggered grid localisation
vertical	Vertical coordinate system
accessors	Accessor configuration

As a .cfg file

[register]
name=generic

[data_vars]

    [[ptemp]]
    cmap = cmo.thermal
        [[[attrs]]]
        standard_name = sea_water_potential_temperature
        long_name = Potential temperature
        units = degrees_celsius

    [[ctemp]]
    cmap = cmo.thermal
        [[[attrs]]]
        standard_name = sea_water_conservative_temperature
        long_name = Conservative temperature
        units = degrees_celsius

    [[temp]]
    alt_names = temperature
    cmap = cmo.thermal
        [[[attrs]]]
        standard_name = sea_water_temperature
        long_name = Sea water in situ temperature
        units = degrees_celsius,kelvin

    [[asal]]
    cmap = cmo.haline
        [[[attrs]]]
        standard_name = sea_water_absolute_salinity
        long_name = Absolute salinity
        units = g kg-1

    [[pfsal]]
    cmap = cmo.haline
        [[[attrs]]]
        standard_name = sea_water_preformed_salinity
        long_name = Preformed salinity
        units = g kg-1

    [[psal]]
    cmap = cmo.haline
        [[[attrs]]]
        standard_name = sea_water_practical_salinity
        long_name = Practical salinity
        units = 1,PSU

    [[sal]]
    alt_names = salinity,salt,saln
    cmap = cmo.haline
        [[[attrs]]]
        standard_name = sea_water_salinity
        long_name = Salinity
        units = 1e-3

    [[sst]]
    cmap = cmo.thermal
        [[[attrs]]]
        standard_name = sea_surface_temperature,surface_sea_water_temperature
        long_name = Sea surface temperature
        units = degrees_celsius

    [[sss]]
    cmap = cmo.haline
        [[[attrs]]]
        standard_name = sea_surface_salinity
        long_name = Sea surface salinity
        units = PSU

    [[sigmat]]
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = sea_water_sigma_t
        long_name = Sea water density minus 1000
        units = kg m-3

    [[ndens]]
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = sea_water_neutral_density
        long_name = Sea water neutral density
        units = kg m-3

    [[sigmatheta]]
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = sea_water_sigma_theta
        long_name = Sea water potential density minus 1000
        units = kg m-3

    [[pdens]]
    alt_names = sigma0
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = sea_water_potential_density
        long_name = Sea water potential density
        units = kg m-3

    [[sigma0]]
    inherit = pdens
    cmap = cmo.dense

    [[sigma1]]
    cmap = cmo.dense
        [[[attrs]]]
        long_name = Sea water potential density with ref at 1000 dbar
        units = kg m-3

    [[sigma2]]
    cmap = cmo.dense
        [[[attrs]]]
        long_name = Sea water potential density with ref at 2000 dbar
        units = kg m-3

    [[sigma3]]
    cmap = cmo.dense
        [[[attrs]]]
        long_name = Sea water potential density with ref at 3000 dbar
        units = kg m-3

    [[sigma4]]
    cmap = cmo.dense
        [[[attrs]]]
        long_name = Sea water potential density with ref at 4000 dbar
        units = kg m-3

    [[dens]]
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = sea_water_density
        long_name = Sea water density
        units = kg m-3

    [[pres]]
        [[[attrs]]]
        standard_name = sea_water_pressure
        long_name = Sea water pressure
        units = dbar

    [[ssd]]
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = sea_surface_density
        long_name = Sea surface density
        units = PSU

    [[conduct]]
        [[[attrs]]]
        standard_name = sea_water_electrical_conductivity
        long_name = Sea water electrial conductivity
        units = S m-1

    [[sndspd]]
        [[[attrs]]]
        standard_name = speed_of_sound_in_sea_water
        long_name = Speed of sound in water
        units = m s-1

    [[mld]]
        [[[attrs]]]
        standard_name = mixed_layer_depth
        long_name = Mixed layer depth
        units = m

    [[ped]]
        [[[attrs]]]
        standard_name = potential_energy_deficit
        long_name = Potential energy deficit
        units = J m-2

    [[ohc]]
    cmap = cmo.thermal
        [[[attrs]]]
        standard_name = ocean_heat_content
        long_name = Ocean heat content
        units = J

    [[osc]]
    cmap = cmo.haline
        [[[attrs]]]
        standard_name = ocean_salt_content
        long_name = Ocean salt content
        units = kg

    [[cp]]
    cmap = cmo.thermal
        [[[attrs]]]
        standard_name = specific_heat_capacity
        long_name = Specific heat capacity
        units = J K-1


    # Dynamics
    [[ssh]]
    alt_names = xe,wlv
    cmap = cmo.balance:piv0
        [[[attrs]]]
        standard_name = sea_surface_height,sea_surface_height_above_sea_level,sea_surface_height_above_geoid
        long_name = Sea surface height
        units = m

    [[u]]
    alt_names = uz,u3d
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = sea_water_x_velocity,eastward_sea_water_velocity
        long_name = Sea water velocity along X,Eastward velocity
        units = m s-1

    [[v]]
    alt_names = vz,v3d
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = sea_water_y_velocity,northward_sea_water_velocity
        long_name = Sea water velocity along Y,Northward velocity
        units = m s-1

    [[w]]
    alt_names = wz,w3d
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = sea_water_z_velocity_at_w_location,sea_water_z_velocity
        long_name = Sea water velocity along Z at W location
        units = m s-1

    [[ubt]]
    alt_names = u2d,u
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = barotropic_sea_water_x_velocity
        long_name = Sea water barotropic velocity along X
        units = m s-1

    [[vbt]]
    alt_names = v2d,v
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = barotropic_sea_water_y_velocity
        long_name = Sea water barotropic velocity along Y
        units = m s-1

    [[ubc]]
    alt_names = u
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = baroclinic_sea_water_x_velocity
        long_name = Sea water baroclinic velocity along X
        units = m s-1

    [[vbc]]
    alt_names = v
        [[[attrs]]]
        standard_name = baroclinic_sea_water_y_velocity
        long_name = Sea water baroclinic velocity along Y
        units = m s-1

    [[usurf]]
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = sea_surface_x_velocity,eastward_sea_water_velocity
        long_name = Sea surface velocity along X,Eastward surface current,Eastward current
        units = m s-1

    [[vsurf]]
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = sea_surface_y_velocity,northward_sea_water_velocity
        long_name = Sea surface velocity along Y,Northward surface current,Northward current
        units = m s-1

    [[ugbt]]
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = barotropic_sea_water_x_geostrophic_velocity,eastward_geostrophic_current_velocity
        long_name = Sea water barotropic geostrophic velocity along X
        units = m s-1

    [[vgbt]]
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = barotropic_sea_water_y_geostrophic_velocity,northward_geostrophic_current_velocity
        long_name = Sea water barotropic geostrophic velocity along Y
        units = m s-1

    [[cspd]]
    cmap = cmo.amp
        [[[attrs]]]
        standard_name = sea_water_speed
        long_name = Sea water speed
        units = m s-1

    [[speed]]
    inherit = cspd

    [[cdir]]
    cmap = cmo.phase:cyc360
        [[[attrs]]]
        standard_name = direction_of_sea_water_velocity
        long_name = Direction of sea water velocity
        units = degrees

    [[ke]]
        [[[attrs]]]
        standard_names  = kinetic_energy
        long_name = Kinetic energy
        units = m2 s-2

    [[eke]]
        [[[attrs]]]
        standard_names  = eddy_kinetic_energy
        long_name = Eddy kinetic energy
        units = m2 s-2

    [[tke]]
        [[[attrs]]]
        standard_names  = turbulent_kinetic_energy
        long_name = Turbulent kinetic energy
        units = m2 s-2

    [[mke]]
        standard_names  = mean_kinetic_energy
        long_name = Mean kinetic energy
        units = m2 s-2

    [[kz]]
    alt_names = kz,kzm
        [[[attrs]]]
        standard_name = average_ocean_vertical_tracer_diffusivity
        long_name = Vertical diffusivity
        units = m2 s-1

    [[akt]]
    alt_names = AKt
        [[[attrs]]]
        standard_name = ocean_vertical_heat_diffusivity
        long_name = Vertical heat diffusivity
        units = m2 s-1

    [[vaisa]]
    alt_names = vaisala
        [[[attrs]]]
        standard_name = brunt_vaisala_frequency_in_sea_water, brunt_vaisala_frequency
        long_name = Brunt Vaisala frequency
        units = s-1



    # Bathymetry
    [[bathy]]
    alt_names = h0,dpt
    cmap = cmo.deep
        [[[attrs]]]
        standard_name = model_sea_floor_depth_below_sea_level,model_sea_floor_depth_below_geoid,sea_floor_depth_below_geoid
        long_name = Bathymetry
        units = m

    [[meanlev]]
    alt_names = niv_moy
        [[[attrs]]]
        standard_name = mean_sea_level_above_sea_floor_depth_at_lowest_astronomical_tide,mean_sea_level
        long_name = Mean Sea Level
        units = m

    # Cell sizes

    [[dx]]
        [[[attrs]]]
        standard_name = cell_x_size
        long_name = Mesh size along x
        units = m

    [[dy]]
        [[[attrs]]]
        standard_name = cell_y_size
        long_name = Mesh size along y
        units = m

    [[ex]]
        [[[attrs]]]
        standard_name = inverse_of_cell_x_size
        long_name = Inverse of mesh size along x
        units = m-1

    [[ey]]
        [[[attrs]]]
        standard_name = inverse_of_cell_y_size
        long_name = Inverse of mesh size along y
        units = m-1

    [[dz]]
        [[[attrs]]]
        standard_name = ocean_layer_thickness
        long_name = Ocean layer thickness
        units = m

    [[dlon]]
        [[[attrs]]]
        standard_name = cell_x_size,cell_x_step
        long_name = Mesh size along x
        units = degrees

    [[dlat]]
        [[[attrs]]]
        standard_name = cell_y_step,cell_y_size
        long_name = Mesh step along y
        units = degrees

    [[angle]]
        [[[attrs]]]
        long_name = Angle between x-axis and east

    [[mask]]
        [[[attrs]]]
        standard_name = land_binary_mask
        long_name = Land binary mask


    # Volumes

    [[cvol]]
        [[[attrs]]]
        standard_name = cell_volume
        long_name = Volume of the cell
        units = m3


    [[vol]]
        [[[attrs]]]
        standard_name = seawater_volume
        long_name = Volume of the sea water
        units = m3


    # Coriolis
    [[corio]]
    alt_names = f0
        [[[attrs]]]
        standard_name = coriolis_parameter
        long_name = Coriolis parameter
        units = s-1

    [[beta]]
        [[[attrs]]]
        standard_name = meridional_derivative_of_coriolis_parameter
        long_name = Meridional derivative of coriolis parameter
        units = m-1 s-1


    # Orography
    [[oro]]
    alt_names = zs
        [[[attrs]]]
        standard_name = orography
        long_name = Orography for SLEVE vertical coordinates
        units = m

    [[orosm]]
        [[[attrs]]]
        standard_name = smoothed_orography
        long_name = Smoothed orography for SLEVE vertical coordinates
        units = m


    # Atmosphere surface

    [[nethf]]
    alt_names = nethf
    cmap = cmo.curl:piv0
        [[[attrs]]]
        standard_name = surface_net_averaged_downward_radiative_flux,surface_net_downward_radiative_flux
        long_name = Net radiation
        units = W m-2

    [[lwnhf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_net_downward_longwave_flux
        long_name = Net longwave radiation (positive when directed downward)
        units = W m-2

    [[swnhf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_net_downward_shortwave_flux
        long_name = Net shortwave radiation (positive when directed downward)
        units = W m-2

    [[ghf]]
    alt_names = ghf
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = averaged_downward_ground_heat_flux
        long_name = Ground heat flux (SW + LW - LE - H)
        units = W m-2

    [[lwuhf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_upward_longwave_flux
        long_name = Longwave radiation (positive when directed upward)
        units = W m-2

    [[swuhf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_upward_shortwave_flux
        long_name = Shortwave radiation (positive when directed upward)
        units = W m-2

    [[lwdhf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_downward_longwave_flux
        long_name = Longwave radiation (positive when directed downward)
        units = W m-2

    [[swdhf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_downward_shortwave_flux
        long_name = Shortwave radiation (positive when directed downward)
        units = W m-2

    [[lathf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_downward_latent_heat_flux
        long_name = Latent heat flux (positive when directed downward)
        units = W.m-2

    [[hflat]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_averaged_upward_latent_heat_flux,upward_latent_heat_flux,surface_upward_latent_heat_flux
        long_name = Latent heat flux (positive when directed upward)
        units = W.m-2

    [[senhf]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_downward_sensible_heat_flux
        long_name = Sensible heat flux (positive when directed downward)
        units = W m-2

    [[hfsen]]
    cmap = cmo.solar
        [[[attrs]]]
        standard_name = surface_averaged_upward_sensible_heat_flux,upward_sensible_heat_flux,surface_upward_sensible_heat_flux,
        long_name = Sensible heat flux (positive when directed upward)
        units = W m-2

    [[evap]]
    cmap = cmo.amp
        [[[attrs]]]
        standard_name = lwe_thickness_of_water_evaporation_amount
        long_name = evaporation (positive when directed downward)
        units = m

    [[rain]]
    cmap = cmo.rain
        [[[attrs]]]
        standard_name = lwe_thickness_of_precipitation_amount,lwe_thickness_of_downward_precipitation_amount
        long_name = Precipitation [Downward (positive when it is raining)]
        units = m,mm

    [[t2m]]
    cmap = cmo.thermal
        standard_name = air_potential_temperature_at_2_meters
        long_name = 2 m temperature
        units = K,degrees_kelvin

    [[q2m]]
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = air_specific_humidity_at_2_meters
        long_name = 2 m specific humidity
        units = kg kg-1

    [[hu2m]]
    alt_names = q2m
    cmap = cmo.dense
        [[[attrs]]]
        standard_name = air_relative_specific_humidity_at_2_meters
        long_name = 2 m specific humidity
        units = kg kg-1

    [[z0a]]
    alt_names = z0
        [[[attrs]]]
        standard_name = air_surface_roughness_length,surface_roughness_length,roughness_length
        long_name = Air roughness length
        units = m

    [[cda]]
    alt_names = cd
        [[[attrs]]]
        standard_name = averaged_drag_momentum_coefficient_in_air,drag_momentum_coefficient_in_air
        long_name = Averaged drag momentum coefficient,Drag momentum coefficient
        units = W s-2

    [[cha]]
    alt_names = ch
        [[[attrs]]]
        standard_name = averaged_drag_thermal_coefficient_in_air,drag_thermal_coefficient_in_air
        long_name = Averaged drag thermal coefficient,Drag thermal coefficient
        units = W s-2

    [[cea]]
    alt_names = ce
        [[[attrs]]]
        standard_name = averaged_latent_heat_coefficient_in_air,latent_heat_coefficient_in_air
        long_name = Averaged latent heat flux coefficient,Latent heat flux coefficient
        units = W s-2



    # Atmosphere
    [[wspd]]
    cmap = cmo.speed
        [[[attrs]]]
        standard_name = wind_speed
        long_name = Wind speed
        units = m s-1

    [[wdir]]
    cmap = cmo.phase:cyc360
        [[[attrs]]]
        standard_name = wind_to_direction,wind_from_direction
        long_name = Wind direction
        units = degrees

    [[wfdir]]
        [[[attrs]]]
        standard_name = wind_from_direction
        long_name = Wind from direction
        units = degrees
    cmap = cmo.phase:cyc360

    [[wtdir]]
    cmap = cmo.phase:cyc360
        [[[attrs]]]
        standard_name = wind_to_direction
        long_name = Wind to direction
        units = degrees

    [[uair]]
    alt_names = uair,ua,uwnd
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = eastward_wind,x_wind
        long_name = Zonal wind speed (westerly)
        units = m s-1

    [[vair]]
    alt_names = vair,va,vwnd
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = northward_wind,y_wind
        long_name = Meridional wind speed (northerly)
        units = m s-1

    [[wair]]
    alt_names = wa,wwnd
    cmap = cmo.curl:piv0
        [[[attrs]]]
        standard_name = upward_wind,z_wind
        long_name = Upward wind speed
        units = m s-1

    [[tair]]
    alt_names = ta,temp,tht
    cmap = cmo.thermal
        [[[attrs]]]
        standard_name = air_potential_temperature,air_temperature
        long_name = Temperature
        units = degrees_kelvin,K

    [[pa]]
    alt_names = psl
        [[[attrs]]]
        standard_name = air_pressure_at_sea_level,air_pressure_at_mean_sea_level
        long_name = Absolute pressure
        units = Pa

    [[ps]]
        [[[attrs]]]
        standard_name = surface_air_pressure
        long_name = Surface air pressure
        units = Pa

    [[plev]]
        [[[attrs]]]
        standard_name = air_pressure
        long_name = Air pressure
        units = Pa

    [[ptop]]
        [[[attrs]]]
        standard_name = air_pressure_at_top_of_atmosphere_model
        long_name = Air pressure at top of model
        units = Pa

    [[tkea]]
    cmap = cmo.amp
        [[[attrs]]]
        standard_name = air_turbulent_kinetic_energy
        long_name = Turbulent Kinetic Energy
        units = m2 s-2


    # Ocean Atmosphere interface
    [[u10m]]
        [[[attrs]]]
        standard_name = x_wind_at_10m,x_wind,x_wind_at_u_location,x_wind_at_10m_at_u_location,eastward_wind
        long_name = 10-m zonal wind speed (westerly)
        units = m s-1
    cmap = cmo.delta:piv0

    [[v10m]]
        [[[attrs]]]
        standard_name = y_wind_at_10m,y_wind,y_wind_at_v_location,y_wind_at_10m_at_v_location,northward_wind
        long_name = 10-m meridional wind speed (northerly)
        units = m s-1
    cmap = cmo.delta:piv0

    [[w10m]]
    cmap = cmo.curl:piv0
        [[[attrs]]]
        standard_name = z_wind_at_10m,upward_wind_at_10m
        long_name = 10-m meridional wind speed (northerly)
        units = m s-1

    [[ux10m]]
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = x_wind_at_10m,x_wind,grid_eastward_wind,x_wind_at_u_location,x_wind_at_10m_at_u_location
        long_name = 10-m wind speed along X
        units = m s-1

    [[vy10m]]
    cmap = cmo.delta:piv0
        [[[attrs]]]
        standard_name = y_wind_at_10m,y_wind,grid_northward_wind,y_wind_at_v_location,y_wind_at_10m_at_v_location
        long_name = 10-m wind speed along Y
        units = m s-1


    [[tauu]]
        [[[attrs]]]
        standard_name = surface_downward_eastward_stress,surface_eastward_stress,surface_downward_x_stress
        long_name = Surface eastward wind stress
        units = N m-2,Pa
    cmap = cmo.diff:piv0

    [[tauv]]
    cmap = cmo.diff:piv0
        [[[attrs]]]
        standard_name = surface_downward_northward_stress,surface_northward_stress,surface_downward_y_stress
        long_name = Surface northward wind stress
        units = N m-2,Pa

    [[taux]]
    alt_names = ustress
    cmap = cmo.diff:piv0
        [[[attrs]]]
        standard_name = surface_downward_x_stress,surface_x_stress,surface_downward_x_stress_at_u_location
        long_name = Surface wind stress along X
        units = N m-2

    [[tauy]]
    alt_names = vstress
    cmap = cmo.diff:piv0
        [[[attrs]]]
        standard_name = surface_downward_y_stress,surface_y_stress,surface_downward_y_stress_at_v_location
        long_name = Surface wind stress along Y
        units = N m-2

    [[topheight]]
        [[[attrs]]]
        standard_name = maximum_height,height_above_geopotential_datum_at_top_of_atmosphere_model
        long_name = Height of the top level
        units = m

    [[hbl]]
        [[[attrs]]]
        standard_name = ocean_mixed_layer_thickness_defined_by_mixing_scheme
        long_name = Depth of planetary boundary layer
        units = m


    # Surfaces waves
    [[hs]]
    alt_names = hm0
    cmap = cmo.amp
        [[[attrs]]]
        standard_name = sea_surface_wave_significant_height,significant_height_of_wind_and_swell_waves
        long_name = Significant wave height,Significant height of wind and swell waves
        units = m

    [[mssx]]
        [[[attrs]]]
        standard_name = eastward_mean_square_slope,x_mean_square_slope
        long_name = Eastward mean square slope
        units = m m-1

    [[mssy]]
        [[[attrs]]]
        standard_name = nortward_mean_square_slope,y_mean_square_slope
        long_name = Northward mean square slope
        units = m m-1

    [[mss]]
    alt_names = mss
        [[[attrs]]]
        standard_name = mean_square_slope
        long_name = mean square slope
        units = m m-1

    [[mlw]]
    cmap = cmo.tempo
        [[[attrs]]]
        standard_name = mean_wave_length
        long_name = Mean wave length
        units = m

    [[t0m1]]
        [[[attrs]]]
        standard_name = sea_surface_wind_wave_mean_period_from_variance_spectral_density_inverse_frequency_moment
        long_name = Mean wave period
        units = s
    cmap = cmo.tempo

    [[dp]]
    alt_names = dp
    cmap = cmo.phase:cyc360
        [[[attrs]]]
        standard_name = sea_surface_wave_peak_direction
        long_name = Peak direction
        units = degrees

    [[tp]]
    cmap = cmo.tempo
        [[[attrs]]]
        standard_name = sea_surface_wave_peak_period
        long_name = Peak period
        units = s

    [[fp]]
    cmap = cmo.tempo
        [[[attrs]]]
        standard_name = peak_frequency_of_wind_and_swell_waves
        long_name = Peak frequency,Frequency of wind and swell waves at spectral peak
        units = s-1

    [[th1p]]
    alt_names = dir
    cmap = cmo.phase:cyc360
        [[[attrs]]]
        standard_name = sea_surface_wave_from_direction
        long_name = Mean wave direction,Mean direction of wind and swell waves at spectral peak
        units = degree

    [[char]]
    alt_names = cha
        [[[attrs]]]
        standard_name = charnock_coefficient_for_surface_roughness_length_for_momentum_in_air
        long_name = Charnock coefficient for surface roughness length for momentum in air

    [[ubr]]
    cmap = cmo.amp
        [[[attrs]]]
        standard_name = rms_amplitude_of_orbital_bottom_velocity_of_wind_and_swell_waves
        long_name = Near bottom rms velocities
        units = m s-1

    [[uubr]]
    cmap = cmo.amp
        [[[attrs]]]
        standard_name = rms_of_bottom_zonal_velocity_amplitude
        long_name = Rms of near bottom zonal velocities
        units = m s-1

    [[vubr]]
    cmap = cmo.amp
        [[[attrs]]]
        standard_name = rms_of_bottom_meridional_velocity_amplitude
        long_name = Rms of near bottom meridional velocities
        units = m s-1

    [[bhd]]
        [[[attrs]]]
        standard_name = bernoulli_head_pressure_of_wind_and_swell_waves
        long_name = Radiation pressure (Bernoulli head)
        units = N s-1

    [[foc]]
    alt_names = phioc
        [[[attrs]]]
        standard_name = turbulent_kinetic_energy_flux_into_sea_water_due_to_surface_dissipation_wave
        long_name = Wave mixing kinetic turbulent energy due to surface breaking wave
        units = W m-2,m3 s-3

    [[utwo]]
    alt_names = tauox
        [[[attrs]]]
        standard_name = x_component_of_surface_wave_ocean_momentum_flux,northward_wave_to_ocean_stress
        long_name = Zonal component of the surface wave-ocean momentum flux
        units = m2 s-2

    [[vtwo]]
    alt_names = tauoy
        [[[attrs]]]
        standard_name = y_component_of_surface_wave_ocean_momentum_flux,northward_wave_to_ocean_stress
        long_name = Meridional component of the surface wave-ocean momentum flux
        units = m2 s-2

    [[utaw]]
        [[[attrs]]]
        standard_name = x_component_of_wave_supported_wind_stress
        long_name = Eastward wave supported wind stress,Zonal component of the atmosphere-wave momentum flux
        units = m2 s-2

    [[vtaw]]
        [[[attrs]]]
        standard_name = y_component_of_wave_supported_wind_stress
        long_name = Northward wave supported wind stress,Meridional component of the atmosphere-wave momentum flux
        units = m2 s-2

    [[fbb]]
        [[[attrs]]]
        standard_name = wave_energy_dissipation_in_bottom_boundary_layer
        long_name = Wave dissipation in bottom boundary layer
        units = W m-2

    [[utbb]]
        [[[attrs]]]
        standard_name = x_component_of_bottom_wave_ocean_momentum_flux,eastward_wave_to_bottom_boundary_layer_stress
        long_name = Zonal component of the bottom wave-ocean momentum flux
        units = m2 s-2

    [[vtbb]]
        [[[attrs]]]
        standard_name = y_component_of_bottom_wave_ocean_momentum_flux,northward_wave_to_bottom_boundary_layer_stress
        long_name = Meridional component of the bottom wave-ocean momentum flux
        units = m2 s-2

    [[uuss]]
        [[[attrs]]]
        standard_name = eastward_surface_stokes_drift
        long_name = Eastward surface stokes drift
        units = m s-1

    [[vuss]]
        [[[attrs]]]
        standard_name = northward_surface_stokes_drift
        long_name = Northward surface stokes drift
        units = m s-1

    [[utus]]
        [[[attrs]]]
        standard_name = eastward_stokes_transport
        long_name = Eastward stokes transport
        units = m2 s-1

    [[vtus]]
        [[[attrs]]]
        standard_name = northward_stokes_transport
        long_name = Northward stokes transport
        units = m2 s-1

    [[mapsta]]
        [[[attrs]]]
        standard_name = status_map
        long_name = Status map
        units = 1

    [[wlv]]
        [[[attrs]]]
#?    standard_name = sea_surface_height_above_sea_level
#?    long_name = Sea surface height above sea level
        units = m

    # Terrain-following coordinates

    [[sig]]
    alt_names = s_level,sigma,s,sigma_level
        [[[attrs]]]
        standard_name = ocean_sigma_coordinate,ocean_s_coordinate,atmosphere_sigma_coordinate,atmosphere_s_coordinate,ocean_s_coordinate_g1,ocean_s_coordinate_g2
        long_name = Sigma level

    [[cs]]
        [[[attrs]]]
        standard_name = ocean_s_coordinate_function
        long_name = S-coordinate stretching curves

    [[hc]]
        [[[attrs]]]
        standard_name=ocean_s_coordinate_thick_of_surface_resolution
        long_name = Sigma-coordinate critical depth

    [[thetas]]
        [[[attrs]]]
        standard_name=ocean_s_coordinate_surface_control

    [[thetab]]
        [[[attrs]]]
        standard_name=ocean_s_coordinate_bottom_control

    # Other vertical coordinates
    [[depth]]
    alt_names = dep
    cmap = cmo.deep
        [[[attrs]]]
        standard_name = ocean_layer_depth
        long_name = Depth
        units = m

    [[altitude]]
    alt_names = altitudet,altitudeu,altitudev
    cmap = cmo.deep
        [[[attrs]]]
        standard_name = atmosphere_layer_altitude
        long_name = Altitude
        units = hPa,m

    # Misc
    [[station]]
    alt_names = stations
        [[[attrs]]]
        long_name = Station number

    [[calday]]
        [[[attrs]]]
        long_name = Calendar day

    [[echoint]]
        [[[attrs]]]
        long_name = Echo intensity
        units = db

[coords]

    # Non physical

    [[x]]
    alt_names = xi,nx,ni,x,imt,ipi
        [[[attrs]]]
        standard_name = x_grid_index
        long_name = X-dimension of the grid
        axis=X

    [[y]]
    alt_names = yi,ny,nj,y,jmt,jpj
        [[[attrs]]]
        standard_name = y_grid_index
        long_name = Y-dimension of the grid
        axis=Y

    [[level]]
    alt_names = model_level,lev,nz,nk,z,kmt,zi
        [[[attrs]]]
        standard_name = model_level_number
        long_name = Model level number
        axis = Z


    # Physical

    [[lon]]
    alt_names = longitude,nav_lon,longitudes,lons
    search_order = snu
        [[[attrs]]]
        standard_name = longitude
        long_name = Longitude
        units = degrees_east,degree_east,degree_e,degrees_e,degreee,degreese
        axis = X

    [[lat]]
    alt_names = latitude,nav_lat,latitudes,lats
    search_order = snu
        [[[attrs]]]
        standard_name = latitude
        long_name = Latitude
        units = degrees_north,degree_north,degree_n,degrees_n,degreen,degreesn
        axis = Y

    [[depth]]
    inherit = data_vars:depth
        [[[attrs]]]
        axis = Z

    [[altitude]]
    inherit = data_vars:altitude
        [[[attrs]]]
        axis = Z

    [[sig]]
    inherit=data_vars:sig
        [[[attrs]]]
        axis=Z

    [[time]]
    alt_names = nt
        [[[attrs]]]
        standard_name = time
        long_name = Time
        axis = T

    [[forecast]]
    alt_names = nf,fcst
        [[[attrs]]]
        standard_name = forecast_period
        long_name = Forecast horizon
        axis = F

    [[freq]]
    alt_names = frequency
        [[[attrs]]]
        long_name = Frequency
        units = s-1

    [[station]]
    inherit = data_vars:station
        [[[attrs]]]
        axis = Z

    [[member]]
    alt_names = members
        [[[attrs]]]
        long_name = Ensemble member

The configuration syntax specifications

The syntax of all configurations are validated with these specifications.

See configobj.

Details

[register]

Registration

name

default:

type: string

[[attrs]]

Search within attributes for matching purpose

__many__

default: None

type: strings

[sglocator]

Staggered grid localisation

name_format

default: {root}_{loc}

type: boolstr

valid_locations

default: None

type: strings

[accessors]

Accessor configuration

[[properties]]

Shortcut accessor properties

coords

default: lon, lat, depth, sig, level, altitude, time, forecast

type: strings

Coord names that are added as shortcut properties

data_vars

default: temp, sal, u, v, bathy, ssh

type: strings

Data_var names that are added as shortcut properties

[vertical]

Vertical coordinate system

positive

default: None

possible choices: up, down, None

type

default: None

possible choices: sigma, z, layer, dz, auto, None

Layer=dz, auto=none

[data_vars]

Data variables

[[__many__]]

name

default: None

type: string

alt_names

default:

type: strings

cmap

default: None

type: string

inherit

default: None

type: string

squeeze

default: None

type: strings

search_order

default: sn

type: string

loc

default: None

type: string

add_loc

default: False

type: boolean

exclude

default: False

type: boolean

[[[add_coords_loc]]]

__many__

default: True

type: boolstr

[[[attrs]]]

long_name

default:

type: strings

standard_name

default:

type: strings

units

default:

type: strings

[[[select]]]

__many__

default: None

type: eval

[coords]

Coordinates

[[__many__]]

name

default: None

type: string

alt_names

default:

type: strings

inherit

default: None

type: string

search_order

default: ns

type: string

loc

default: None

type: string

add_loc

default: None

type: boolean

exclude

default: False

type: boolean

[[[add_coords_loc]]]

__many__

default: True

type: boolstr

[[[attrs]]]

long_name

default:

type: strings

standard_name

default:

type: strings

units

default:

type: strings

axis

default: None

type: string

[dims]

Dimensions

x

default:

type: strings

y

default:

type: strings

z

default:

type: strings

t

default:

type: strings

f

default:

type: strings

File

[register] # Registration
name=string(default="")

    [[attrs]] # Search within attributes for matching purpose
    __many__=strings(default=None)

[sglocator] # Staggered grid localisation
name_format=boolstr(default="{root}_{loc}")
valid_locations=strings(default=None)

[accessors] # Accessor configuration

    [[properties]]  # Shortcut accessor properties
    coords=strings(default=list(lon,lat,depth,sig,level,altitude,time,forecast)) # coord names that are added as shortcut properties
    data_vars=strings(default=list(temp,sal,u,v,bathy,ssh))  # data_var names that are added as shortcut properties


[vertical] # Vertical coordinate system
positive=option('up','down',None,default=None)
type=option('sigma','z','layer','dz','auto',None,default=None) # layer=dz, auto=None


[data_vars] # Data variables

    [[__many__]]

    name=string(default=None)
    alt_names=strings(default=list())
    cmap=string(default=None)
    inherit=string(default=None)
    squeeze=strings(default=None)
    search_order=string(default=sn)
    loc=string(default=None)
    add_loc=boolean(default=False)
    exclude=boolean(default=False)

        [[[add_coords_loc]]]
        __many__=boolstr(default=True)

#        [[[add_loc_sec]]]
#        data_var=boolean(default=False)
#
#            [[[[coords]]]]
#            __many__=boolstr(default=None)

        [[[attrs]]]
        long_name=strings(default=list())
        standard_name=strings(default=list())
        units=strings(default=list())


        [[[select]]]
        __many__=eval(default=None)



[coords] # Coordinates

    [[__many__]]

    name=string(default=None)
    alt_names=strings(default=list())
    inherit=string(default=None)
    search_order=string(default=ns)
    loc=string(default=None)
    add_loc=boolean(default=None)
    exclude=boolean(default=False)

        [[[add_coords_loc]]]
        __many__=boolstr(default=True)

#        [[[add_loc_sec]]]
#        coord=boolean(default=None)
#
#            [[[[coords]]]]
#            __many__=boolean(default=None)

        [[[attrs]]]
        long_name=strings(default=list())
        standard_name=strings(default=list())
        units=strings(default=list())
        axis=string(default=None)


[dims] # Dimensions
    x=strings(default=list())
    y=strings(default=list())
    z=strings(default=list())
    t=strings(default=list())
    f=strings(default=list())