Purpose

This main script calls the job scripts of the directory scripts/. subchain sends the following sub-tasks to the compute server. YYYYMM stands for the year and month to be worked on.

Contents

The subchainscript contains several sections (called actions ) which are executed depending 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 (i.e. the chain is started again at the given specific point).
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 subchainthe 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.

• conv2icon [YYYYMM]
  prepares some environment variables and submits the conv2icon job conv2icon.job.sh for the month taken from the filedate.logor optionally by the argument YYYYMM.

• icon [YYYYMM/noprep]
  prepares some environment variables and submits the ICON job icon.job.sh for the month taken from the filedate.logor optionally by the argument YYYYMM. 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 jobarch.job.sh for the month taken from the file date.log or optionally by the argument YYYYMM.

• post [YYYYMM] [ONLY_YEARLY]
  prepares some environment variables and submits the post-processing jobpost.job.sh for the month taken from the file date.logor optionally by the argument YYYYMM.
  If a third argument exists (ONLY_YEARLY), only the yearly concatenating of the previously created monthly files is performed in post.job.sh. This makes only sense for MM=01.

• clean
  deletes all files and directories created during the model simulation for this experiment. You can use this action if you want to start the simulation from scratch. However, it does not revert changes that have 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.

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

If ITYPE_CONV2ICON == 1
Prepares the coarse grid initial or boundary data (e.g. from reanalysis, GCM, or a coarser ICON) for use in the conv2icon 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 have the same format as those that have been used by the INT2LM program that interpolates forcing data to COSMO-CLM input. However, ICON does up to now only accept files as input that have the IFS netCDF format. Therefore the caf or cas data files have to be converted by an extra program ccaf2icaf. The converted files are stored into the directory ${SCRATCHDIR}/${EXPID}/output/prep/YYYY_MM. At the end of this job an conv2icon job is initiated by subchain conv2icon ${CURRENT DATE}.

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

Purpose

This script prepares input data for the subsequent ICON simulation: the course grid boundary meteorological fields are remapped to the model grid.

Contents

It contains several cdo remap calls to remap the course grid data to the ICON grid. At the end of this job an ICON job is initiated by subchain icon. 

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

It contains the namelist for ICON. After creating the input namelist files the ICON executable is called with the system specific MPI call. At the end of this job an archive job is initiated by subchain arch if the total current month has been run by the ICON. If the ICON is run in shorter time length than a month and the end of the month has not been reached yet, the next ICON chunk is initiated by subchain icon. 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 uses the function.sh file. Before archiving the netCDF attributes of the ICON output files are modified to go along with the CF-Conventions. In addition, the variable names and standard_names are adopted as given in the file mapping_to_cosmo.csv.
Optionally a sanity check can be performed by the SAMOVAR script.

The resulting files are optionally compressed then tarred and copied to the archive. At the end of this job a post-processing job is 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 uses the functions.inc file. The following post-processing is performed by default. However, the user can adjust the script to his needs. The following steps are performed:

• the time series functions in functions.inc are called for user-selected quantities. The resulting time series are stored 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 in job_settings is set to 2 the time series are stored in yearly files instead of monthly ones. These files can be used as input for the cmorizing scripts developed in the CLM-Community.

List of possible additional quantities

Single level fields:

Multi level fields (pressure or height)

In this script the monthly time series files for a quantity are combined into yearly files. These files have a format that can be used as input for the CCLM2CMOR tool.