|
|
# ExaHyPE Convergence Studies framework
|
|
|
|
|
|
At [Misc/ConvergenceAnalysis](https://gitlab.lrz.de/exahype/ExaHyPE-Engine/tree/master/Miscellaneous/ConvergenceAnalysis) we do have some Python code to manage convergence studies. This wiki page shall document how to use this.
|
|
|
|
|
|
Currently, we do have the scripts for every convergence test by its own. We currently have two tests installed: The `AlfenWave` (testing MHD PDEs) and the `ShuVortex` (testing EulerFlow PDEs). In each of these directories you find a Python script like `runShuVortex.py`. You should have a look into it and especially into its parameters:
|
|
|
|
|
|
```
|
|
|
sven@nils:~/numrel/exahype/Engine-ExaHyPE/Miscellaneous/ConvergenceAnalysis/ShuVortex$ ./runShuVortex.py --help
|
|
|
usage: runShuVortex.py [-h] [-p POLYORDER] [-m MESHSIZE] [-w] [-a]
|
|
|
|
|
|
Run convergence tests: The EulerFlow ShuVortex.
|
|
|
Will setup environment variables to execute a templated specification file.
|
|
|
If called without arguments, it will run a series of runs in parallel.
|
|
|
|
|
|
Sample usages:
|
|
|
|
|
|
./runShuVortex.py -p 2 -m 0.1
|
|
|
./runShuVortex.py --all --wait
|
|
|
for p in 2 3 4; do ./runShuVortex -p $p -m 0.1 & done
|
|
|
|
|
|
optional arguments:
|
|
|
-h, --help show this help message and exit
|
|
|
-p POLYORDER, --polyorder POLYORDER
|
|
|
Polynomial order
|
|
|
-m MESHSIZE, --meshsize MESHSIZE
|
|
|
Maximum mesh size (dx)
|
|
|
-w, --wait Wait until ExaHyPE processes have finished
|
|
|
-a, --all Start all sensible simulations
|
|
|
```
|
|
|
|
|
|
This allows you to start (or submit, if you use a queing system inbetween) a number of different ExaHyPE simulations in parallel. It will also do the simulation directory setup for you by making use of an intermediate _runner_ script which is [RunScripts/runTemplatedSpecfile.sh](https://gitlab.lrz.de/exahype/ExaHyPE-Engine/blob/master/Miscellaneous/RunScripts/runTemplatedSpecfile.sh). |