    Short documentation of the RC files
    ===================================

The pycasso script relies on a main-rc file, that should include: a region-, a
meteo-, a machine-, and an expert-rc files.


  ************************ TM5-MP ***********************
  * All files with a name starting with "pycasso-" are  *
  * "as is" from the TM5-zoom repository. They have not *
  * been adapted to the TM5-MP format, and are here for *
  * reference for future developments.                  *
  *******************************************************


These files with a ".tmpl" extension are templates and you must make a copy
into the top TM5 dir for you to adapt to your needs:

  main-base.rc.tmpl               --> template main-rc for base code without any project 
  main-chem.rc.tmpl               --> template main-rc for cb05 project 
  chem-input-default.rc.tmpl      --> template for emissions paths for cbm4 and cb05 projects


The other files are for maintained configurations:

  main-config-ecearth3.rc.tmpl    --> main-rc to be parsed by ec-conf (EC-Earth 3.x)
  main-tm5-produce-glb100x100.rc  --> main-rc to pre-process EI or OD meteo from MARS onto TM5 global 1x1 grid 
  main-tm5-produce-glb100x100-conv.rc --> same as previous, but only for the convec files


  expert-default.rc              --> advanced settings
  expert-no1x1.rc                --> same as expert-default.rc, but disregards the extra global 1x1 grid. Used for hi-res MARS retrievals.

  machine-template.rc       --> (template) |
  machine-cineca-sp6.rc     -->            |   machine specific
  machine-ecmwf-c2a.rc      -->            |   stuff, like compiler (if not included through a file)
  machine-ecmwf-ecgate.rc   -->            |-- name and flag, and 
  machine-jrc-clust7.rc     -->            |   library paths,...
  machine-maunaloa.rc       -->            |   
  machine-noaa-jet.rc       -->            |
  ...etc

  compiler-gfortran-4.1.rc   --> |   
  compiler-ifort-11.1.rc     --> |-- compiler settings: flags, etc
  compiler-xlf-12.1.rc       --> | 
  ...etc

  regions-glb025x025.rc   -->   regions-rc (hi-res)
  regions-glb050x050.rc   -->   regions-rc (hi-res)
  regions-glb100x100.rc   -->   regions-rc 
  regions-glb300x200.rc   -->   regions-rc 
  regions-glb600x400.rc   -->   regions-rc 

  meteo-tm5-default.rc             --> meteo-rc for using TM5-produced fields (default)
  meteo-tm5-ecearth3.rc            --> meteo-rc for using EC-Earth v3 (IFS) fields
  meteo-tmpp.rc                    --> meteo-rc for using TMPP-produced fields

  meteo-tm5-produce-glb100x100.rc              --> meteo-rc to process (EI or OD) meteo from MARS archive at ECMWF.
  meteo-tm5-produce-glb100x100_convec_ei.rc    --> same, but only for EI convective fluxes
  meteo-tm5-produce-glb100x100_kzz_ei.rc       --> same, but only for EI diffusion coeff.
  meteo-tm5-produce-glb100x100_conveckzz_ei.rc --> same, but only for EI convective fluxes and diffusion coeff.
  meteo-tm5-produce-hires.rc                   --> same as meteo-tm5-produce-glb100x100.rc, but with higher resolution for OD retrieval.

  queue-bsub.rc                    --> templates for queue options,
  queue-loadleveler.rc             --> usually content is inserted in machine.rc
  queue-qsub.rc                    --> since available options depends on installation
  ...etc

