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 simulationLSSO | .TRUE. = forecast with sub-grid scale orography scheme |
| LFOREST | .TRUE. = to run with forest data (evergreen and deciduous) | |
| LLAKE | .TRUE. = forecast with lake model | |
| ITYPE_ALBEDO | albedo type | |
| ITYPE_AEROSOL | aerosol type | |
| LSTOMATA | .TRUE. = external minimum stomata resistance (given by EXTPAR) | |
| LEMISS | .TRUE. = external surface emissivity map (given by EXTPAR) | |
| NESTING_STREAM | If you want to use an output stream to save quantities as input for further downscaling put the number of the output streams here | |
| HOUT_INC | time increment for each GRIBOUT hh:mm:ss should be a multiple of the CCLM time step | |
| HINCMXT | interval for min/max of temperature (to be consistent with HOUT_INC in global settings above) | |
| HINCMXU | interval for min/max of wind speed (to be consistent with HOUT_INC in global settings above) | |
| NBOUNDCUT | set number of boundary lines to be cut off in the time series data and also before evaluating the data with SAMOA | |
| 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 | |
| OMPNPX_THREADS_POSTINT2LM | 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)number of grid partitioning in x-direction in INT2LM | |
| NPY_INT2LM | number of grid partitioning in y-direction in INT2LM | |
| NPX_CCLM | number of grid partitioning in x-direction in CCLM | |
| NPY_CCLM | number of grid partitioning in y-direction in CCLM | |
| NPIO_CCLM | number of processors dedicated for asynchroneous output | |