Model and experiment configuration

Introduction

EC-Earth 4 allows for a wide range of use cases and their corresponding model configurations. This includes different components and their respective settings, configuration of experiment details, adaptation to computational platforms, user environments and much more.

All details that make up the complete configuration are generally spread across a number of text files, such as scripts, makefiles or namelists. Binary input files, for example NetCDF or GRIB files, contribute to the configuration as well. Keeping the complete configuration up to date and consistent for a specific use case is usually a complex task.

Since keeping all configuration parameters consistent across many different files of different formats is difficult and prone to errors, are the most commonly used parameters provided in the context of the YAML scripts of the ScriptEngine build and runtime environment. This will simplify to set up common experiment types on shared computational platforms. It does not, however, exclude further configuration by directly changing namelist or other configuration files. For more special use cases this may, in fact, still be required.

Configuration parameters controlled by ScriptEngine

The following complete list of configuration parameters is automatically generated from the ece-4-configuration-parameters project. All parameters defined in that project will appear in the list together with any descriptions, examples, defaults, and comments that have been given. The tables are grouped according to the parameter hierarchy. Thus, the full name of parameter compiler in the build.lang.c++ group is build.lang.c++.compiler.

Groups and configuration parameters are sorted alphabetically.

build.deps.grib

Short name	description	example	default	comment
`base_dir`
`inc_dir`
`lib_dir`
`libs`
`samples_path`

build.deps.hdf5

Short name	description	example	default	comment
`base_dir`
`inc_dir`
`lib_dir`
`libs`

build.deps.lapack

Short name	description	example	default	comment
`base_dir`
`lib_dir`
`libs`

build.deps.netcdf

Short name	description	example	default	comment
`base_dir`
`inc_dir`
`lib_dir`
`libs`
`mod_dir`

build.lang.c

Short name	description	example	default	comment
`compiler`
`flags`

build.lang.c++

Short name	description	example	default	comment
`compiler`
`flags`

build.lang.fortran

Short name	description	example	default	comment
`compiler`
`flags`
`preprocessor`

build.lang.linker

Short name	description	example	default	comment
`command`
`flags`

build.lang.make

Short name	description	example	default	comment
`command`

build.oasis.lang.fortran

Short name	description	example	default	comment
`flags_shared`

build.oasis.lang.linker

Short name	description	example	default	comment
`flags_shared`

build.oifs.lang.c

Short name	description	example	default	comment
`macros`

build.oifs.lang.fortran

Short name	description	example	default	comment
`flags`
`flags_fixed`
`macros`

build.oifs.lang.linker

Short name	description	example	default	comment
`flags`

experiment

Short name	description	example	default	comment
`description`	A short textual description of the experiment			Used in issue title for live monitoring
`id`	Unique experiment identifier	E001		four letter string
`monitoring`	Toggle live monitoring	`true`	`false`
`notes`	More detailed information about the experiment			Displayed on the live monitoring page

experiment.amipfr.forcing

Short name	description	example	default	comment
`dir`
`sic`
`sst`

experiment.cmip6

Short name	description	example	default	comment
`activity_id`
`experiment_id`
`source_id`
`source_type`

experiment.nemo

Short name	description	example	default	comment
`initial_state`

experiment.schedule

Short name	description	example	default	comment
`all`

job

Short name	description	example	default	comment
`ini_dir`
`run_dir`

job.amipfr

Short name	description	example	default	comment
`exe`

job.launch

Short name	description	example	default	comment
`method`

job.launch.shell

Short name	description	example	default	comment
`script`

job.nemo

Short name	description	example	default	comment
`exe`
`ntasks`
`ntasks_per_node`

job.oifs

Short name	description	example	default	comment
`exe`
`ntasks`
`ntasks_per_node`
`omp_num_threads`

job.rnfm

Short name	description	example	default	comment
`exe`

job.slurm.sbatch

Short name	description	example	default	comment
`opts`

job.slurm.srun

Short name	description	example	default	comment
`args`

job.xios

Short name	description	example	default	comment
`exe`
`ntasks`
`ntasks_per_node`

model_config

Short name	description	example	default	comment
`components`

model_config.nemo

Short name	description	example	default	comment
`dt`
`grid`

model_config.oasis.amipfr_oifs

Short name	description	example	default	comment
`dt`

model_config.oasis.nemo_oifs

Short name	description	example	default	comment
`dt`

model_config.oasis.oifs_nemo

Short name	description	example	default	comment
`dt`

model_config.oifs

Short name	description	example	default	comment
`dt`
`grid`
`icmcl_file`

model_config.oifs.all_grids.TCO159L91

Short name	description	example	default	comment
`cpl_grid_ext`
`dt`
`level`
`name`

model_config.oifs.all_grids.TCO199L91

Short name	description	example	default	comment
`cpl_grid_ext`
`dt`
`level`
`name`

model_config.oifs.all_grids.TCO95L137

Short name	description	example	default	comment
`cpl_grid_ext`
`dt`
`level`
`name`

model_config.oifs.all_grids.TCO95L91

Short name	description	example	default	comment
`cpl_grid_ext`
`dt`
`level`
`name`

model_config.oifs.all_grids.TL255L91

Short name	description	example	default	comment
`cpl_grid_ext`
`dt`
`level`
`name`

model_config.oifs.output

Short name	description	example	default	comment
`pressure_levels`
`sample_rate`