seissol/training repository overview

(container repository: https://github.com/SeisSol/Training⁠ )

⁠SeisSol Training Container

Welcome to the SeisSol training Docker container. This container contains an interactive learning environment (Jupyter) which includes meshing tools, SeisSol, and visualization tools.

⁠Installation

Please install Docker⁠, launch the Docker Desktop and then run

docker pull seissol/training

⁠Training

After installation, run

docker run -p 53155:53155 seissol/training

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