Quick Start

Quick Start#

This guide lets you install eCLM on the target machine.

Setting up eCLM on your local machine#

Download Podman.

  1. Fetch the eCLM container image. On your terminal, run the ff.:

WORKDIR=$HOME/eclm_container
mkdir $WORKDIR
podman run --name eclm-dev -it -v ${WORKDIR}:/root/$(basename ${WORKDIR}) hpscterrsys/eclm:latest-dev

  1. Build eCLM.

cd /root/eclm_container

# Download eCLM
git clone https://github.com/HPSCTerrSys/eCLM.git

# Build eCLM
cmake -S src -B bld -DCMAKE_INSTALL_PREFIX=$HOME/.local -DCMAKE_BUILD_TYPE="DEBUG"
cmake --build bld --parallel 4
cmake --install bld

  1. Set up a simulation experiment.

cd /root/eclm_container

# Generate namelists files.
git clone https://icg4geo.icg.kfa-juelich.de/ExternalReposPublic/tsmp2-static-files/extpar_eclm_wuestebach_sp.git wtb_data
cd wtb_data/static.resources/generate_wtb_namelists.sh /root/1x1_wuestebach

  1. Run eCLM.

cd /root/1x1_wuestebach
mpirun -np 1 eclm.exe

Setting up eCLM on HPC systems#

The steps are similar to above. The only difference is the build step and running step.

  1. Download TSMP2 build system.

# eCLM can be easily built via the TSMP2 build system. The following step will download TSMP2.
git clone https://github.com/HPSCTerrSys/TSMP2.git

  1. Build eCLM

# Build eCLM
cd TSMP2
./build_tsmp2.sh eCLM

  1. Set up a simulation experiment.

cd /share
git clone https://icg4geo.icg.kfa-juelich.de/ExternalReposPublic/tsmp2-static-files/extpar_eclm_wuestebach_sp.git
cd extpar_eclm_wuestebach_sp/static.resources
generate_wtb_namelists.sh 1x1_wuestebach

  1. Run eCLM.

cd 1x1_wuestebach
mpirun -np 1 eclm.exe