Skip to content

SPICE

SPICE stands for Starter Package for ICON-CLM Experiments. It is a processing chain that handles pre-processing of the input, setting up namelists, running the simulation and archiving/post-processing. It contains the latest setup for ICON-CLM runs by the CLM community.

The code has been adapted for running on Alps and can be downloaded via Zenodo .

To set up your own ICON-CLM simulation, refer to the corresponding ICON page.

For any questions, please contact Michael Jähn .

Code

Documentation

EvaSuite

EvaSuite is an addon for SPICE but also a standalone software for either

  1. Compare your simulation experiment with E-OBS or ERA5.
  2. Compare your simulation experiment and a reference simulation with E-OBS or ERA5.

Instructions to Set Up on Säntis

Instructions partly outdated

Due to the latest updates of EvaSuite, there is no official support on Santis. The instructions below may still be valid, but could also be partly outdated. In any case, please refer to the official EvaSuite Documentation.

Setup Miniforge

EvaSuite needs a conda environment setup to run properly. On a HPC system as Alps/Säntis, Conda's packages and environments should be installed on $SCRATCH in order to not run into the file quota limit. Miniforge itself can be installed in $HOME.

Download Miniforge for aarch64

cd ~
wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-aarch64.sh

Install Miniforge into your home directory

Miniforge3-Linux-aarch64.sh -b -p $HOME/miniforge3

Add Miniforge to your PATH

echo 'export PATH=$HOME/miniforge3/bin:$PATH' >> ~/.bashrc

Configure Conda to store envs/pkgs on $SCRATCH

Create ~/.condarc:

channels:
  - conda-forge
channel_priority: strict

envs_dirs:
  - $SCRATCH/conda_envs
pkgs_dirs:
  - $SCRATCH/conda_pkgs

auto_activate_base: false

uenv and modules:

uenv start --view=modules netcdf-tools/2024:v1
module load gcc/13.2.0 hdf5/1.14.3

Base environment:

conda create -n py310_evasuite python=3.10 -y
conda activate py310_evasuite

Installing packages:

conda install -c conda-forge fiona cartopy rasterio h5py psutil

Installation

Follow DOCS/installation.md:

  1. Clone the repository 

    git clone --recurse-submodules https://gitlab.dkrz.de/clm-community/public/evasuite.git EvaSuite_v1.0

  2. Create and activate a Python virtual environment within the EvaSuite repo 

    cd EvaSuite_v1.0
conda activate py310_evasuite

  3. Tell pip to Use $SCRATCH for Cache & Wheels

export PIP_CACHE_DIR=$SCRATCH/pip_cache
export TMPDIR=$SCRATCH/pip_temp
mkdir -p $PIP_CACHE_DIR $TMPDIR

  1. Upgrade pip and install dependencies 

    pip install --upgrade pip setuptools wheel
pip install -r requirements.txt

  2. Install EvaSuite 

    pip install .

Usage

Load modules and activate environment: 

uenv start --view=modules netcdf-tools/2024:v1
module load cdo/2.4.0 netcdf-c/4.9.2 netcdf-fortran/4.6.1
conda activate py310_evasuite

Reference