Training

Welcome to the SeisSol training. Please clone this repository with git (using the command line) or download it directly from the browser. This repository contains a Dockerfile to build a Docker container. The Docker container contains an interactive learning environment (Jupyter) which includes meshing tools, SeisSol, and visualiation tools.

Installation

Please install Docker, launch the Docker Desktop and then run

(i) For Frontera and all Intel/AMD machines:

• use label: latest

(ii) Macs with M1/M2/M3 ARM CPUs:

• use label: hps-2024-remote-arm

docker pull seissol/training:{label}

Training

After installation, run

docker run -p 53155:53155 seissol/training:{label}

or run the start.sh script.

After some time you should see

http://127.0.0.1:53155/lab?token=some5cryptic8hash123

Click on that link or enter the link in the address bar of your favourite web browser.

Then use the navigation bar to open the exercises (e.g., tpv13/tpv13.ipynb).

Tools

You can also use the tools in the Docker container for creating input files or running SeisSol on your local computer. To this end, you need to mount your local drive within the Docker container with the following command:

docker run -v $(pwd):/shared/ -u $(id -u):$(id -g) seissol/training <some command>

As this command is rather long, we provide the wrapper script tool.sh.

The following tools are currently included:

• PUMGen (mesh generation for SeisSol, https://github.com/SeisSol/PUMGen, see also SeisSol's documentation https://seissol.readthedocs.io/en/latest/meshing-with-pumgen.html)
• GMSH (open source 3D finite element mesh generator, client only, https://gmsh.info)
• rconv (tool to describe point and finite source models in SeisSol's NetCDF Rupture Format, https://seissol.readthedocs.io/en/latest/standard-rupture-format.html#how-to-use-rconv)
• SeisSol O4 (pre-compiled SeisSol with 4th order space-time accuracy for elastic and viscoelastic materials, https://seissol.readthedocs.io). We use the SeisSol v1.0.1. See the first lines of the SeisSol output to get the exact commit hash.

I.e.

./tool.sh pumgen <args>
./tool.sh gmsh <args>
./tool.sh rconv <args>
./tool.sh seissol <args>