Running the examples
Build DES
From the DES source folder:
make ndims=2 # dynearthsol2d
make ndims=3 # dynearthsol3d
Put the executables on your PATH, or call them with their full path.
For the Python reader and ParaView converter, set the source-folder path:
export DES_SOURCE=/path/to/DynEarthSol
export PYTHONPATH="$DES_SOURCE${PYTHONPATH:+:$PYTHONPATH}"
Run an example
Each example's files come in one zip, linked in its At a glance box: input.cfg,
and any mesh (.poly) or restart frames (.save, .chkpt, .info) it starts from.
Unpack it somewhere writable and run the commands given in the
example's "Input and how to run" section, for instance
mkdir -p ~/runs && cd ~/runs
unzip theis.zip
cd theis
export OMP_NUM_THREADS=1
dynearthsol3d input.cfg
dynearthsol2d -h lists every input option with its default and meaning.
Each page lists the settings that define its example.
Look at the output
DES names its output after sim.modelname: <model>.info lists the saved
frames (frame, step, time in seconds), <model>.save.NNNNNN holds the
fields of each frame and <model>.chkpt.NNNNNN the restart checkpoints.
sim.output_step_interval and sim.output_time_interval_in_yr control the
saved-frame cadence. HDF5 builds use the .vtkhdf suffix.
import sys; sys.path.append('/path/to/DynEarthSol')
from Dynearthsol import Dynearthsol
model = Dynearthsol('theis')
p = model.read_field(model.frames[-1], 'pore pressure')
python3 "$DES_SOURCE/2vtk.py" <model> converts the frames for ParaView; add -g for a
run that restarted from another, to include the frames before the restart.
Reproduce a figure
The ZIPs link Python runners and references in the complete DES checkout at the stated revision. They contain inputs and dependencies, without source code copies.
Each page names the script that ran the whole study behind its figure (all
meshes and time steps). The scripts are in benchmarks/poromechanics/ and
tests/functional/hydromechanics/. The Reproduce with row names the public
source to build. Figures reuse recorded runs; their downloadable records
preserve the measured executable and data hashes. The version manifest
records the regression comparisons used to check the integrated source.