Skip to content

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

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 git@gitlab.dkrz.de:clm-community/evasuite/HZG_Evaluation_Suite.git EvaSuite_v1.0

If you don't have access to the EvaSuite repository, you can download the code from Zenodo:

Todo

Zenodo link.

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

    cd EvaSuite_v1.0
conda activate py310_evasuite

  2. 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