DWD Academic ICON Course @DKRZ

Overview

Event site: https://www.nat-esm.de/services/workshops-and-trainings/events/dwd-academic-icon-course-dkrz

Jupyter notebooks for the practical exercises: https://gitlab.dkrz.de/icon-training/icon-training-2025-scripts

ICON Tutorial (2025 DRAFT version): ICON_tutorial_2025_DRAFT.pdf

Practical Exercises

(excl. ICON-ART)

• Exercise 0: Getting familiar with the Jupyter Notebooks
  • Starting the JupyterLab server
  • Copying the course notebooks, Levante file systems
  • Basics of the JupyterLab user interface
  • Slurm batch jobs
  • Batch job monitoring
  • Interactive Linux terminal in JupyterLab
  • Aborting Slurm jobs
  • Further Reading and Resources
• Exercise 1: Running Idealized Test Cases
  • Necessary input data
  • Jablonowski-Williamson (JW) baroclinic wave test case
  • Retrieve the horizontal grids
  • ICON namelists and job script
  • Running the ICON model
  • Grid Nesting
  • Parent-child relationships
  • Further Reading and Resources
• Exercise 2: Global Real Data Run
  • Input Data
  • Setup
  • Prepare the ICON run (namelists etc.)
  • Running the model and inspecting the output
  • Time-stepping
  • Optional: Appending your own output namelist
  • Excursion: The ICON LOG output
  • Further Reading and Resources
• Exercise 3: Pre-Processing for ICON
  • Overview
  • Grids and external parameters
  • Raw input data sets
  • Pre-processing of the data sets
  • Grid & External Parameter Generation with the Zonda Web Interface
  • Further Reading and Resources
• Exercise 4: Running the ICON-LAM Setup
  • Necessary input data for ICON-LAM
  • Preparing the ICON-LAM run (namelists etc.)
  • Model namelists
  • The ICON-LAM batch job
  • Visualizing the model output (the Ahr valley flood)
  • Temporal Resolution of the Boundary Data
  • Further Reading and Resources
• Exercise 5: Programming ICON
  • Step F1: Allocating Additional Fields in the Fortran Code
  • Further Reading and Resources
• Exercise 6.1: ICON ComIn, Part I
  • Preliminary Step: Building the ICON ComIn Python Adapter
  • Step P1: Writing a ComIn Python Plugin
  • Further Reading and Resources
• Exercise 6.2: ICON ComIn, Part II
  • Step P2: MPI Gathering - Explanation of the Algorithm
  • Performing an MPI gathering operation in the ComIn plugin
  • Further Reading and Resources
• Exercise 6.3: ICON ComIn, Part III
  • Step P3: Using YAC in ComIn plugin for interpolation
  • Further Reading and Resources