Coordinates files and associated information

Coordinates files and associated information#

CHIMERE requires two files with horizontal coordinates, one file with general information [to be removed at some point since contains redundant information] and, if relevant, one file of land-use. They must be named COORDcorner_DOM, COORD_DOM, domainlist.nml and LANDUSE_DOM where DOM is the name of the simulation domain, as listed in domainlist.nml. They must be stored in a directory where domainlist.nml is available with a subdirectory named HCOORD containing COORD_DOM and COORDcorner_DOM, a subdirectory LANDUSE containing LANDUSE_DOM.

The domain directory structure is thus as follows:

domains
├── domainlst.nml: info about available domains
├── HCOORD
│   ├── HCOORD_${domid}: list of longitudes and latitudes for each grid centers
│   └── HCOORDcorner_${domid}: list of longitudes and latitudes for each grid corners
├── VCORRD
│   └── VCOORD_${nlev}_${1st layer}_${last layer}: list of sigma_a/sigma_b coefficients
└── LANDUSE
    └── LANDUSE_${domid}: for each grid cell the proportion of land-use types

See also the domain plugin for CHIMERE for documentation on these files and the information to provide to the CIF to generate them.

COORD_DOM#

Each line contains the longitude and latitude of the center of a cell plus its area in m2. The ordering of the cells is from the east to the west for each latitude and the latitudes vary then from the south to the north.

COORDcorner_DOM#

Each line contains the longitude and latitude of a corner, and the area of the corresponding gridcell (the area is not used any were; rather use areas in the HCOORD file). The ordering of the corners is from the east to the west for each latitude and the latitudes vary then from the south to the north. Therefore, the first batch of lines contains the coordinates of the corners of the cells in the southern most line of the model’s grid.

Note

since the cells are contiguous, they share corners and the list of the corners for one row of cells is only longer by one coordinate than the list of the centers.

VCOORD_DOM#

Each line contains the sigma_b and sigma_a coefficient values at the top of corresponding CHIMERE levels.

domainlist.nml#

After a headline “domain NX NY DX DY XMIN YMIN REG PATH DEC POLAR”, it must give the name of the domain DOM, the number of cells in the zonal direction, the number of cells in the meridian direction and place-holders for the other information (“-99 -99 -999 -999 na na -99 0”).

LANDUSE_DOM#

Each line indicates for each grid cell, in the same order as COORD_DOM, the fraction of each of the 9 CHIMERE land-use categories. The number and types of categories can be changed by experienced users. This file is only used when deposition is activated. To generate the land-use on CHIMERE’s categories, two definition files are used:

  • LAND_AGGREGATION: gives the matrix for matching GLCF categories to each of the 9 CHIMERE LU categories. Must be adapted if the LU data is taken from another data-base.

  • LANDPAR: gives the monthly variations of the mean z0 for the 9 CHIMERE LU categories

CROP GRAS BARR IWAT URBA SHRB CONI DECI OCEA 
0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.00    0 WATER
0.00 0.00 0.00 0.00 0.00 0.00 1.00 0.00 0.00    1 EVERGREEN-NEEDLELEAF-FOREST
0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.00 0.00    2 EVERGREEN-BROADLEAF-FOREST
0.00 0.00 0.00 0.00 0.00 0.00 1.00 0.00 0.00    3 DECIDUOUS-NEEDLELEAF-FOREST
0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.00 0.00    4 DECIDUOUS-BROADLEAF-FOREST
0.00 0.00 0.00 0.00 0.00 0.00 0.50 0.50 0.00    5 MIXED-FOREST
0.00 0.00 0.00 0.00 0.00 0.00 0.50 0.50 0.00    6 WOODLAND
0.00 0.50 0.00 0.00 0.00 0.00 0.25 0.25 0.00    7 WOODED GRASSLAND
0.00 0.00 0.00 0.00 0.00 1.00 0.00 0.00 0.00    8 CLOSED-SHRUBLAND
0.00 0.00 0.00 0.00 0.00 1.00 0.00 0.00 0.00    9 OPEN-SHRUBLAND
0.00 1.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00   10 GRASSLAND
1.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00   11 CROPLAND
0.00 0.00 1.00 0.00 0.00 0.00 0.00 0.00 0.00   12 BARE-GROUND
0.00 0.00 0.00 0.00 1.00 0.00 0.00 0.00 0.00   13 URBAN-AND-BUILT-UP

MONTH LAND#1 LAND#2 LAND#3 LAND#4 LAND#5 LAND#6 LAND#7 LAND#8 LAND#9
01    0.0500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
02    0.0500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
03    0.0500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
04    0.1000 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
05    0.1500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
06    0.1500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
07    0.1500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
08    0.1000 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
09    0.1000 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
10    0.0500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
11    0.0500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001
12    0.0500 0.1000 0.0100 0.0001 1.0000 0.1500 1.0000 1.0000 0.0001