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 :doc:`the domain plugin for CHIMERE </documentation/plugins/domains/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

.. literalinclude:: LAND_AGGREGATION

.. literalinclude:: LANDPAR