User Guide#
This user guide explains the different parameters available in goSPL input file.
Note
For examples using goSPL, the user is invited to download the goSPL-examples repository which covers some of the basic functionalities of the code:
data structure used in the gospl input file,
how to generate initial conditions like topography, precipitation and tectonic maps to force a simulation,
how to extract some of the output from the your results.
Those examples highlight just a small selection of functions as an illustration of principles.
For a full overview of goSPL capabilities, head to the API reference.
Input file#
The code is primarily a parallel global scale landscape evolution model, built to simulate topography and basins dynamics. The following processes are considered:
river incision and deposition using stream power law,
continental deposition in depressions,
marine deposition at river mouth,
hillslope processes in both marine and inland areas,
sediment compaction as stratigraphic layers geometry and properties change,
spatially and temporally varying tectonics (horizontal and vertical displacements).
spatially and temporally varying precipitation grids as well as orographic rain and sea-level fluctuations,
possibility to account for flexural isostasy driven by changes in surface loading.
Required parameters#
Mesh and temporal definition
Imposing initial nesh conditions and simulation duration.
Running goSPL#
Launching a simulation
The gospl command (mpirun -np 8 gospl -i input.yml) and the
equivalent Python Model API.
Model outputs#
Output variables & visualisation
The fields goSPL writes, what they mean, and how to view them in ParaView.
Performance on HPC#
Strong-scaling benchmarks
Speedup and parallel efficiency on global meshes (10, 8, 5 km).