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 |
ITYPE_COMPRESS_ARCH | Compression type of output in archiving |
ITYPE_TS | How timeseries are combined |
ITYPE_SAMOVAR | choose SAMOVAR check |
SAMOVAR_EXE | Name of SAMOVAR executable including full path |
SAMOVAR_SH | Name of the SAMOVAR shell script including the path. Default: |
SAMOVAR_LIST | File in csv format including the maximal value ranges of the output quantities. Default: |
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 |
LSSO | .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_ARCH | Number of parallel tasks in arch.job.sh |
TASKS_POST | Number of parallel tasks in post.job.sh |
NPX_INT2LM | 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 |