Conventions
-----------

All data generated by the satmo system follow a strict naming convention and are organized in directories accordingly. Util functions are available in the API (e.g.: ``filename_parser()``) to parse information from these file names, to generate file names from metadata (``filename_builder()``), or to build the path corresponding to a given file (``path_builder()``).

In most functions and command lines, a variable ``data_root=``, corresponding to the root of the directory tree has to be set. The directories are then organized as follows::

        sensor
        ├── L1A
        │   └── year
        │       └── doy
        ├── L2
        │   └── year
        │       └── doy
        ├── L2m
        │   └── year
        │       └── doy
        ├── L3b
        │   └── year
        │       └── doy
        └── L3m
            ├── 8DAY
            │   └── year
            │       └── doy
            ├── DAY
            │   └── year
            │       └── doy
            └── MO
                └── year
                    └── doy   




The table below provides examples of filenames and associated location for different data levels.

+------------------------+-------------------------------------------------+-------------------------------------+
| Product type           | Example filename                                | Directory                           |
+========================+=================================================+=====================================+
| L1A                    | ``A2005004002500.L1A_LAC.bz2``                  | ``aqua/L1A/2005/004``               |
+------------------------+-------------------------------------------------+-------------------------------------+
| L2                     | ``A2008085203500.L2_LAC_OC.nc``                 | ``aqua/L2/2008/085``                |
+------------------------+-------------------------------------------------+-------------------------------------+
| L2m                    | ``A2008085203500.L2m_CHL_chlor_a.tif``          | ``aqua/L2m/2008/085``               |
+------------------------+-------------------------------------------------+-------------------------------------+
| L3b                    | ``A2004005.L3b_DAY_CHL.nc``                     | ``aqua/L3b/2004/005``               |
+------------------------+-------------------------------------------------+-------------------------------------+
| L3m ncdf               | ``A2007009.L3m_DAY_SST4_sst4_1km.nc``           | ``aqua/L3m/DAY/2007/009``           |
+------------------------+-------------------------------------------------+-------------------------------------+
| L3m sensor composite   | ``X2014027.L3m_DAY_SST_sst_1km.tif``            | ``combined/L3m/DAY/2014/027``       |
+------------------------+-------------------------------------------------+-------------------------------------+
| L3m time composite     | ``X2014027.L3m_8DAY_SST_sst_1km.tif``           | ``combined/L3m/8DAY/2014/027``      |
+------------------------+-------------------------------------------------+-------------------------------------+
| L3m climatology        | ``CLIM.027.L3m_8DAY_SST_sst_1km_2000_2015.tif`` | ``combined/L3m/8DAY_clim/027``      |
+------------------------+-------------------------------------------------+-------------------------------------+
| L3m anomalies          | ``ANOM.2014027.L3m_8DAY_SST_sst_1km.tif``       | ``combined/L3m/8DAY_anom/2014/027`` |
+------------------------+-------------------------------------------------+-------------------------------------+
| preview                | ``X2014027.L3m_DAY_SST_sst_1km.png``            |                                     |
+------------------------+-------------------------------------------------+-------------------------------------+