A first example
This tutorial will guide you through the steps of your first SeisSol simulation. We will use the SCEC TPV33 benchmark as an example in this tutorial. We assume that you have successfully compiled SeisSol.
This tutorial is targeted to people who have compiled SeisSol and want to test their installation for the first time. If you are completely new to SeisSol and want to explore its features, we recommend our training material, which bundles a pre-compiled version of SeisSol and some scenarios.
Clone our examples repository: https://github.com/SeisSol/Examples/.
Navigate to the folder
Examples/tpv33. We will refer to this directory as working directory in the following.
Download the mesh files from https://zenodo.org/record/8042664 and store them in the working directory.
You can visualize the mesh file with paraview, using e.g.
paraview tpv33_half_sym.xdmf. The mesh is described by two files:
tpv33_half_sym.xdmf. The first one is a binary file, which contains all the data (e.g. coordinates, connectivity) and the
xdmffile contains information on how to read that data for visualization software such as Paraview. You can read more about this mesh format here: PUML Mesh format.
Create the output directory:
Optional: For performance reasons, we suggest that you store large files (mesh, output) in a scratch file system (if one is available at your cluster) and create symbolic links in your working directory:
ln -s <path/to/tpv33_half_sym> tpv33_half_sym ln -s <path/to/output/directory> output
You may not see a huge difference in this small test case but for larger meshes, this is the recommended strategy.
Link the SeisSol binary to your working directory (
export OMP_NUM_THREADS=<threads>, where
<threads>is the number of threads. If you are on a single node machine, you should compile SeisSol with
-DCOMMTHREAD=OFFand use the maximum number of threads available. If you run SeisSol on a cluster, you should compile it with
-DCOMMTHREAD=ON. Then you should set the number of OMP threads to the number of available threads minus 1.
mpiexec -np <n> ./SeisSol_<configuration> parameters.par, where:
<n>is the number of MPI ranks / the number of compute nodes used.
<configuration>depends on your compilation setting (e.g. SeisSol_Release_dhsw_4_elastic for a Haswell architecture and order 4 accuracy in space and time).
Hint: Depending on the system you are using, the MPI launcher might
be different from
For more infos about how to get optimal performance, have a look at the Optimal environment variables on SuperMUC-NG.
SeisSol produces various output files:
3D wave field output (
2D free surface output (
2D fault output (
Off fault receivers (
Fault receivers (
Energy output (
The outputs of your simulation can be compared with our outputs (using SeisSol) and the outputs of other codes by checking out the uploaded files for this SCEC benchmark on the SCEC Code Verification Project website.