Purpose

This main script calls the job scripts of the directory scripts. subchain sends the following sub-tasks to the compute server. The scripts reads settings from the file job_settings.

Contents

The subchain script contains several sections (called actions ) which are executed dependent on the subchain [action] call. If you just call subchain without any argument you will get a list of valid actions. The actions start and clean are called interactively. The other actions are called internally by the subchain script, only in case of a restart in case of an error they may be called interactively.
The subchain script first checks whether the file date.log exists. During the simulation this file holds the current date of the ICON runs. When calling subchain the first time this file does not exist and will be created as well as the directory structure of the job.
Available actions:

• start
  This is the very first call to start the simulation. The file date.log and the directory structure of the job will be created.

• prep[YYYYMM]
  prepares some environment variables and submits the prep.job.sh for the month taken from the file date.log or optionally by the argument YYYYMM .

• int2lm[YYYYMM]
  prepares some environment variables and submits the INT2LM job int2lm.job.sh for the month taken from the file date.log or optionally by the argument YYYYMM .

• cclm [noprep]
  prepares some environment variables and submits the CCLM job cclm.job.sh for the month taken from the file date.log. It also calls subchain prep ${NEXT DATE} which starts a pre-processing job for the next month, if this is not suppressed by calling this action with the argument noprep.

• arch[YYYYMM]
  prepares some environment variables and submits the archiving job arch.job.sh for the month taken from the file date.log or optionally by the argument YYYYMM.

• post[YYYYMM]
  prepares some environment variables and submits the post-processing job post.job.sh for the month taken from the file date.log or optionally by the argument YYYYMM.

• clean
  deletes all files and directories created during the model simulation for this experiment. You can use this actions if you want to start the simulation from scratch. However, it does noch revert changes that has been made in the scripts.

• create
  this

• action creates just the directory structure for your experiment. It is only needed in rare cases when the directory structure is corrupted.

In case you have installed the add-ons arch-slk and/or eva-suite you have to additional available options

• arch-slk [YYYYMM] [checksum]
  this action copies the archived data from $ARCHDIR to the HSM archive using slk commands for the month taken from the file date.log or optionally by the argument YYYYMM .

• eva-suite [YYYYMM]
  this actions runs the evaluation package eva-suite at the end of the simulation. If the eva-suite crashes you can re-run it using the optional argument YYYYMM (this must be the end simulation).

Purpose

All necessary pre-processing is performed by this script, e.g. copying boundary data from the archive, unpacking the data. The script can be changed to perform copying from tape or via ftp or scp.

Contents

The script includes the job_settings file.
If ITYPE_CONV2ICON INT2LM == 1
Prepares the coarse grid initial or boundary data (e.g. from reanalysis, GCM or a coarser ICONCCLM) for use in the cons2icon int2lm job for a specific month. This script has to be adjusted by the user depending on how and where the coarse grid data are stored. The caf or cas data files must be copied into the directory ${SCRATCHDIR}/${EXPID}/output/prep/YYYY_MM. At the end of this job an conv2icon int2lm job is automatically initiated by subchain conv2icon int2lm ${CURRENT DATE}.

If ITYPE_CONV2ICON INT2LM /= 1
Assumes that the output  files of an conv2icon int2lm run already exist. These data are copied to ${SCRATCHDIR}/${EXPID}/output/conv2iconint2lm/YYYY_MM. At the end of this job an ICON job is automatically initiated by subchain iconcclm.

Purpose

This script prepares input data for the subsequent COSMO-CLM simulation: the external parameters for the surface and the global boundary meteorological fields at the domains boundaries are interpolated/re-projected to the model grid. Those parameters which are not explicitly set here are set to their default values during the simulation.

Contents

The script includes the job_settings file. Itcontains It contains the namelist for INT2LM. After creating the input namelist files the INT2LM executable is called with the system specific MPI call. At the end of this job an CCLM job is automatically initiated by subchain cclm. The user may change the namelist settings and the MPI call.

Purpose

This script contains name list parameters for the model grid, as well as model options for dynamics, physics, I/O, and diagnostics, etc. Those parameters which are not explicitly set here are set to their default values during the simulation.

Contents

The script includes the job_settings file. It contains the namelist for CCLM. After creating the input namelist files the CCLM executable is called with the system specific MPI call. At the end of this job an archive job is automatically initiated by subchain arch if the total current month has been run by the CCLM. If the CCLM is run in shorter time length than a month and the end of the month has not been reached yet, the next CCLM chunk is initiated by subchain cclm. The user may change the namelist settings and the MPI call.

Purpose

Archiving of the results is performed in this script, e.g. compressing and combining output directories into tar files. In the standard script archiving is performed on hard disk. However, the script can be changed to perform archiving on tape or via ftp or scp. 

Contents

The script includes the job_settings file. The results from the ICON simulation for the current month are tarred and copied to the archive. This script submits the CCLM run for the next month. At the end of this job a post-processing job is automatically initiated by subchain post. 

Purpose

Any post-processing needed is performed here. Archiving of postprocessing results is also done here. Post-processing may take a lot of time, depending on its complexity. This may slow down the whole chain. Therefore it is run in parallel to the rest of the chain.

Contents

The script includes the job_settings and functions.shinc files. The following post-processing is performed by default. However, the user can adjust the script to his needs. The following steps are performed:

• time series functions are defined. For p- and z-levels extra functions are defined.

• the time series functions are then called for user selected quantities. The resulting time series are noted under ${WORKDIR}/${EXPID}/post/YYYY_MM.

• depending on the setting of the environment variable ITYPE_COMPRESS_POST (to be set in the file job_settings) a compression is applied.

• if the environment variable ITYPE_TS is set to 2 or 3 yearly time series are performed at the end of each successfully simulated year. These time series are formatted such that they can be used bei the RCM2CMOR tool. In order to keep the script post.job.sh readable the necessary commands are stored in the extra file post_yearly_cmor.inc which is included by the source command into post.job.sh.