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

The pycasso script relies on a main-rc file, that should include: a region
(grid definition), a meteo (driving meteorological fields description), a
machine (platform specifics), and an expert (advanced model settings) rc
files.


  ************************ TM5-MP ***********************
  * All files with a name starting with "pycasso-" are  *
  * from the older TM5-zoom repository. They have not   *
  * been adapted/tested with TM5-MP, and are here for   *
  * reference for future developments.                  *
  * You will find them in the 'rc/not-ported' directory *
  *******************************************************


The following files with a ".tmpl" extension are templates that you must copy
into the top TM5 dir for you to adapt to your needs:

  main-base.rc.tmpl               --> template main-rc for base code only (i.e. without any project) 
  main-chem.rc.tmpl               --> template main-rc for cb05 project 
  chem-input-default.rc.tmpl      --> template for emissions paths for cb05 project

If you are porting the code to a new platform, copy the template:
 
  machine-platform.rc.tmpl

to a file named 'machine-<institute>-<platform>.rc', and fill the keys therein. 


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__ea.rc  --> main-rc to pre-process ERA5 from MARS onto TM5 global 1x1 grid 
  main-tm5-produce-glb100x100.rc      --> main-rc to pre-process ERA-Interim 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.
  expert-theia.rc          --> advanced settings for NOAA theia platform 
  expert-ecearth3-build.rc --> advanced settings to build EC-Earth-3
  expert-ecearth3-run.rc   --> advanced settings to run EC-Earth-3

  machine-platform.rc.tmpl      --> (template) |
  machine-ecmwf-cca-cray.rc     -->            |   machine specific
  machine-ecmwf-cca-gfortran.rc -->            |   things like compiler (if not included through its own file)
  machine-ecmwf-cca-ifort.rc    -->            |-- name and flag, and 
  machine-knmi-neuron.rc        -->            |   library paths,...
  machine-noaa-zeus.rc          -->            |   
  machine-sara-cartesius.rc     -->            |
  machine-theia.rc              -->            |
  machine-tno-hpc.rc            -->            |

  compiler-ifort-12.0.4.rc         --> |   
  compiler-ifort-12.0-noaa-zeus.rc --> |-- compiler settings: flags, etc
  compiler-ifort-14.0.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-tm5-tno-hpc.rc   --> meteo-rc used by TNO (NL)
  meteo-tm5-theia.rc     --> meteo-rc used by NOAA (USA)
  meteo-tm5-ei-noaa.rc   --> meteo-rc used by NOAA (USA)
  meteo-tm5-cartesius.rc --> meteo-rc used at SurfSARA (NL)

  meteo-tm5-produce-glb100x100_ea.rc           --> meteo-rc to process ERA5 meteo from MARS archive at ECMWF.
  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-slurm-theia.rc      --> |  templates for queue options,
  queue-slurm-knmi.rc       --> |- usually content is inserted in machine.rc
  ...etc                    --> |  since available options depends on installation