Skip to content

DWD ICON Tools

The DWD ICON Tools contain a set of routines which may be suitable for reading, remapping and writing of fields from and to predefined grids, e.g., regular (lat-lon, gaussian) or triangular (ICON). It can be used to generate lateral boundary conditions (LBC) and initial conditions (IC) for ICON-LAM simulations.

Support status

The master branch of the DWD ICON Tools is integrated in the spack-c2sm system tests on Balfrin.

Repository

In order to get access to the DWD ICON Tools repository hosted on the C2SM GitHub organisation , please contact your group's technical contact. They will be responsible for adding you to the appropriate user group.

Usage

Option 1: Shipped via uenv

On Säntis, DWD ICON Tools is provided via the climtools uenv:

uenv start climtools/25.2:v1 --view=climtools

Option 2: Compile manually via Spack

Spack takes care of configuring and building DWD ICON Tools. For detailed instructions, please consider the official spack-c2sm documentation . The following Spack installation should be sufficient for most cases.

Clone the C2SM Spack main branch and source it: 

git clone --depth 1 --recurse-submodules --shallow-submodules https://github.com/C2SM/spack-c2sm.git
source ./spack-c2sm/setup-env.sh /user-environment

Install the ICON Tools: 

spack install icontools@c2sm-master%gcc

Note

If all dependencies have to be installed from scratch, this may take a while.

After the installation, you need to load the package with Spack:

spack load icontools

Run

The folder C2SM in the icontools repository contains a bunch of scripts to run iconremap and icongridgen on Säntis. Most likely you will use the DWD ICON tools to generate a new grid or interpolate boundary conditions for limited-area ICON runs.

Below is a recipe to create initial and boundary files for an ICON-LAM run on Säntis.

Clone the repository

git clone git@github.com:C2SM/icontools.git

Generate a new ICON grid

icongridgen --nml icontools/C2SM/gridgen.nml

Interpolate BC from IFS

This manual refers to the workflow MeteoSwiss currently uses to run LAM simulations.

  • Add fields FI and z from IFS analysis to LBC prior to the interpolation using cdo (GRIB only).

    Note

    Ensure that cdo is available through uenv or has been installed.

    cdo -selname,FI analysis_file fi_file
cdo -selname,z analysis_file z_file
cdo settime,'03:00:00' fi_file fi_file_time
cdo settime,'03:00:00' z_file z_file_time
cdo setreftime,2019-09-30,03:00:00  z_file_time z_file_reftime
cat lbc_file zfile_reftime fi_file_time > complete_file

  • Adapt scripts icontools/C2SM/remap_ini and icontools/C2SM/remap_lbc to your needs

  • Remap IFS data for BC:

    sbatch -A <account> icontools/C2SM/remap_lbc

  • Remap IFS data for analysis:

    sbatch -A <account> icontools/C2SM/remap_ini

Documentation