This file includes the main settings for the simulation and is called at the beginning of each script in the job chain.
| Environment Variable | Description |
| SPDIR | Absolut parent path of the SPICE directory. SPDIR only occurs in job_settings. This is not necessary to set if you define the different paths by yourself. |
| EXPID | job identification |
| Main directory settings | |
| PFDIR | Parent directory where the scripts for the experiment are stored. PFDIR should be on a disk partition that is saved frequently as a copy. |
| WORKDIR | NONE of the created files under this directory will be deleted at the end of the simulation. The disk partition should have enough remaining disk space. |
| SCRATCHDIR | ALL created files under this directory will be deleted at the end of the job chain. This disk partition is only for temporary file storage. |
| SRCDIR | directory of supplementary programs |
| DATADIR | directory holding supplementary data (grid descriptions etc.) |
| ARCHIVE_OUTDIR | Directory where the results should be archived. "Results" are the output of the ICON output streams define in the namelist block gribout. |
| RESDIR | Directory where the restart files will be stored |
| Information on the time period of the simulation | |
| YDATE_START | Start date of simulation YYYYMMDDHH[mmss] |
| YDATE_STOP | End date of simulation YYYYMMDDHH[mmss] |
| INC_DATE | Time increment for the CCLM job. Standard is one month 01:00:00 . You may want to use a higher frequency, e.g. if a monthly increment exceeds the batch job limits of your computing system. |
| ITYPE_CALENDAR | Calendar settings. 0 = proleptic gregorian, 1 = 360 day year, 2 = 365 day year |
| Email and account settings | |
| EMAIL_ADDRESS | The scripts send information in case certain job errors and finishing of the job to this email address. |
| PROJECT_ACCOUNT | On the computer systems at DKRZ you need to set you project account ID. If your computings system does not have this feature you can leave it open |
| Directory and binary path settings for utilities | |
| CFU | cfu (climate fortran utilities) program including the absolute path. These are part of the CCLM starter package |
| CDO | cdo program including the absolute path. |
| NCO_BINDIR | Absolute path to the directory of NCO utility binaries (e.g. ncks, ncrcat, ncatted ...) |
| NC_BINDIR | Absolute path to the directory of netCDF standard binaries (e.g. ncdump, nccopy) |
| PIGZ | pigz program including the absolute path in case your computing system supports parallel gzip. |
| Special script settings | |
| ITYPE_INT2LM | Choose whether to run int2lm (=1) or use already existing int2lm output (=0) |
| ITYPE_CCLM_ARCH_PAR | Submit icon.job.sh in arch.job.sh directly after checking the CCLM output (=1, i.e. icon simulation and archiving job are running in parallel after the file checking) or at the end of arch.job.sh (=0, i.e. are running sequentially). |
| ITYPE_COMPRESS_POST | Compression type of output in post-processing 0 = no compression 1 = internal compression (compression in netCDF file, requires netCDF Library with HDF-lib and z-lib) 2 = external compression (compression with gzip, requires gzip version >=1.6 to be installed) 3 = external compression (compression with pigz, requires pigz to be installed), set TASKS_POST below for the -p option accordingly |
| ITYPE_COMPRESS_ARCH | Compression type of output in archiving 0 = no compression 1 = internal compression (compression in netCDF file, requires netCDF Library with HDF-lib and z-lib) 2 = external compression (compression with gzip, requires gzip version >=1.6 to be installed) 3 = external compression (compression with pigz, requires pigz to be installed), set TASKS_ARCH below for the -p option accordingly |
| ITYPE_TS | How timeseries are combined |
| ITYPE_SAMOA | choose SAMOA check (will be ignored, if SAMOA extension is not installed) 0 = no SAMOA check 1 = short SAMOA check (just the output of the last day of the month in each "outNN" directory) 2 = long SAMOA check (all output files will be checked) |
| SAMOA_SH | Name of the SAMOA shell script including the path. Default: ${SPDIR}/src/samoa/samoa.sh |
| SAMOA_LIST | File in csv format including the maximal value ranges of the output quantities. Default: ${SPDIR}/src/samoa/samoa.csv |
| Initial and boundary data input | |
| GCM_DATADIR | Directory of the initial and boundary data |
| GCM_PREFIX | prefix of the data (e.g., caf or cas) |
| HINCBOUND | boundary data temporal increment in hours |
| Climatological and other supplemental data | |
| EXTPAR | External parameters on ICON grid (can be generated with the ICON Grid Generator + ExtPar Web Frontend) |
| ICON specific settings | |
| INT2LM_EXE | Full path and name of INT2LM executable |
| CCLM_EXE | Full path and name of CCLM executable |
| STARTLAT_TOT | transformed latitude of the lower left grid point of the total domain (in degrees, N>0) |
| STARTLON_TOT | transformed longitude of the lower left grid point of the total domain (in degrees, E>0) |
| POLLAT | latitude of the rotated north pole (in degrees, N>0) |
| POLLON | longitude of the rotated north pole (in degrees, E>0) |
| POLGAM | angle between the north poles of the systems |
| DLAT | grid point distance in meridional direction (in degrees) |
| DLON | grid point distance in zonal direction (in degrees) |
| IE_TOT | number of grid points in zonal direction |
| JE_TOT | number of grid points in meridional direction |
| KE_TOT | number of grid points in vertical direction |
| KE_SOIL | number of layers in the multi-layer soil model |
| CZML_SOIL | depth of the main soil layers in meters |
| Global attribute settings in the ICON netCDF output | |
| GA_INSTITUTION | Name of the institution where the simulation has been performed |
| GA_TITLE | Title of the simulation |
| GA_PROJECT_ID | Project ID |
| GA_REALIZATION | Realization number of the simulation |
| GA_CONVENTIONS | The conventions the ICON output uses (e.g. "CF-1.4") |
| GA_CONVENTIONSURL | Website address of the conventions description |
| GA_CONTACT | Contact address in case of questions on the simulation |
| GA_ICON_CLM_VERSION | Stable ICON-CLM version used for the simulation |
| Parallelization settings | |
| TASKS_PREP | Number of parallel tasks in prep.job.sh |
| TASKS_CONV2ICON | Number of parallel tasks in conv2icon.job.sh |
| OMP_THREADS_CONV2ICON | Number of OPENMP threads (used for CDO commands) in conv2icon.job.sh |
| TASKS_ARCH | Number of parallel tasks in arch.job.sh |
| TASKS_POST | Number of parallel tasks in post.job.sh |
| OMP_THREADS_POST | Number of OPENMP threads (used for CDO commands) in post.job.sh |
| NP_ICON | Number of processors for ICON |
| NUM_THREAD_ICON | Number of OpenMP threads: choose one of the following values 1 (without hyperthreading), 2, 3 (without hyperthreading), 4, 6, 8 (compute only), 9 (compute2 only) |
| HT_ICON | hyperthreading: 0 - off, 1 - on |
| PARTITION_ICON | select specific node type/partition: compute or compute2 PARTITION_ICON=(compute compute2): both options - system will select one of both node types |
| TIME_ICON | requested time in batch queue for ICON simulation |
| NUM_IO_PROCS | num_io_procs: 1,2 specified in namelist parallel_nml (icon.job.sh) |
| NUM_RESTART_PROCS | num_restart_procs !number of processors for restart (on DWD NEC) |
| NUM_PREFETCH_PROC | num_prefetch_proc !number of processors for LBC prefetching (on DWD NEC) |