job_settings
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 |
EXPID | job identification |
Main directory settings | |
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. |
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 |
INIDIR | Directory where some initial data are saved (e.g. the external data of the driving model) |
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 | Replace this with your email address or leave the environment variable empty to prevent getting emails from your batch system |
NOTIFICATION_ADDRESS | The run scripts send notifications to this address, in case it is set. In case of |
NOTIFICATION_SCRIPT | The script holding the notification instruction including the whole absolute path to the script. It is called like so ${NOTIFICATION_SCRIPT} ${NOTIFICATION_ADDRESS} subject message-fileThe following scripts are available under You can also define your own notification script holding your favorite notification system. |
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. |
PYTHON | python interpreter including the absolute path |
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) |
GCM_EXTFILE | external data file (e.g. orography, land-sea mask, …) of the driving model |
HINCBOUND | boundary data temporal increment in hours |
Climatological and other supplemental data | |
EXTPAR | External parameters on CCLM grid (can be generated with WebPEP) |
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 and average of temperature (to be consistent with HOUT_INC in global settings above) |
HINCMXU | interval for min/max and average 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 |
PLEVS | List of pressure levels in hPa. Must be the same as or a subset of the plev in CCLM namelist. |
ZLEVS | List of altitude levels (height over NN). lzint_above_ground=.FALSE. Must be the same as or a subset of the zlev in CCLM namelist. |
HLEVS | List of height levels (height over ground). lzint_above_ground=.TRUE. Must be the same as or a subset of the zlev in CCLM namelist. |
Parallelization settings | |
PARTITION_PREP | Select specific node type/partition for prep.job.sh. This can be different from computing system to computing system. At DKRZ is can be compute or shared. |
TASKS_PREP | Number of parallel tasks in prep.job.sh |
TIME_PREP | requested time in batch queue for prep.job.sh |
PARTITION_ARCH | Select specific node type/partition for arch.job.sh. This can be different from computing system to computing system. At DKRZ is can be compute or shared. |
TASKS_ARCH | Number of parallel tasks in arch.job.sh |
TIME_ARCH | requested time in batch queue for arch.job.sh |
PARTITION_POST | Select specific node type/partition for post.job.sh. This can be different from computing system to computing system. At DKRZ is can be compute or shared. |
TASKS_POST | Number of parallel tasks in post.job.sh |
TIME_POST | requested time in batch queue for post.job.sh |
TIME_POST_YEARLY | requested time in batch queue for post.job.sh when yearly time series are computed |
PARTITION_INT2LM | Select specific node type/partition for int2lm.job.sh. This can be different from computing system to computing system. At DKRZ is can be compute or shared. |
NODES_INT2LM | Number of nodes requested for int2lm.job.sh |
NPX_INT2LM | number of grid partitioning in x-direction in INT2LM |
NPY_INT2LM | number of grid partitioning in y-direction in INT2LM |
TIME_INT2LM | requested time in batch queue for int2lm.job.sh |
PARTITION_CCLM | Select specific node type/partition for cclm.job.sh. This can be different from computing system to computing system. At DKRZ is can be compute or shared. |
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 |
TIME_CCLM | requested time in batch queue for cclm.job.sh |