= 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: [http://cfconventions.org/ 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: 
 a. ''standard_name'': longitude/latitude
 a. ''long_name'': Longitude/Latitude
 a. ''units'': degrees_East/degrees_North
* **time**: These variable must be used to provide information about the temporal dimension. It should have three attributes:
 a. ''standard_name'': time
 a. ''long_name'': description of the temporal axis (''e.g.: multi-year mean monthly values'')
 a. ''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  || -- || -- ||