CFstandarization of the domain characteristics for ORCDHIEE

In this page some recommendations are given in order to standardize the files used to define the domain characteristics of ORCDHIEE. It is attempted to be as close as the CF-conventions standard: ​CF-conventions

Dimensions

Files must have at least two dimensions for the geographical localization, labeled lon and lat Files might have other dimensions:

• time: for files with temporal evolution of the values
• Ntypes: for files where a percentage of a series of types is given at each grid cell
• Lstring : to provide self-explicative information about the content of the file (when applicable)

Dimensional variables

These are the variables which provide information about the records of the dimensions

• lon, lat: These two variables provide the geolocalization of the data. They should have three attributes:
  1. standard_name: longitude/latitude
  2. long_name: Longitude/Latitude?
  3. units: degrees_East/degrees_North
• time: These variable must be used to provide information about the temporal dimension. It should have three attributes:
  1. standard_name: time
  2. long_name: description of the temporal axis (e.g.: multi-year mean monthly values)
  3. units: units of the steps (e.g.: month since beginning of the year)
• typenames(Ntypes,Lstring): These variable should be used to provide consistent information about the types at each grid cell. Each type should have a clear description of the assigned value (e.g.: for `PFTmap.nc' )

value	string
1	1: bare soil
2	2: savanne
3	3: desert
4	4: tropical forest
5	5: decideus forest
6	6: evergreen forest
7	7: urban
8	8: beach
9	9: volcan
10	10: pine
11	11: grass
12	12: conifera
13	13: palm

Variable

The variable which content the data to be interpolated to the desired resolution to run ORCDHIEE. If the range of values is known that the field can take, please make sure that there is not any value outside the range. No data checks will be made by ORCDHIEE previously its interpolation. Currently (12 Arpil 2016) ORCHIDEE make a series of checks previously to the interpolation (see table below, these checks will be remove in the future). At the same time, it should have the following attributes:

• standard_name: provide a clear short name for its identification
• long_name: provide a clear description of the meaning of the variable
• units: provide units of the variable (e.g.: 1, for fractions)
• fill_value: the value of the variable for which there is not value (this is not the same as being missed!!)
• article: reference to the article or articles from which the data is retrieved
• dataset: name of the data-set from which the data was generated/processed (when applicable)

mask

This variable should provide the information about the sea/land points. Currently (12 Arpil 2016) ORCDHIEE computes the mask following different rules. This should be avoided

• 1: land point
• 2: sea point

Current file checks/mask

file name	var name	var dims	check	mask
PFTmap.nc	maxvegetfrac	3D	--	min_sechiba < SUM(maxvegetfrac(i,j)) < 1.-1.e-7 1.-1.e-7 < SUM(maxvegetfrac(i,j)) < 2.
soils_param.nc	soiltext	2D	--	> min_sechiba
soils_param.nc	soilcolor	2D	--	> min_sechiba
alb_bg_jrctip.nc	bg_albedo	4D	--	variable 'mask' in file
cartepente2d_15min.nc	pente	2D	--	> min_sechiba
lai2D.nc	LAI	4D	< 0.,	< 20.
carteveget5km.nc	vegetation_map	2D	--	> min_sechiba
orchidee_fertilizer_1995.nc	N_qt_WRICE_year	2D	--	--
orchidee_fertilizer_1995.nc	N_qt_OTHER_year	2D	--	--
orchidee_bbg_clim.nc	flx_co2_bbg_year	2D	--	--
reftemp.nc	temperature	2D	--	--