ecearth3/sources/tm5mp/rc

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--.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