Skip to main content
Version: Latest

Benchmarks

Each benchmark runs DES on a problem with a known answer, an analytical solution, a theoretical prediction or an independent calculation, and shows how close DES comes and where the comparison stops. The inputs are in the DynEarthSol repository; each page says how to run them and what to expect.

DynEarthSol is also checked against stored results to catch unintended changes, and by functional tests that run in continuous integration; both are listed below.

Benchmarks in this section​

BenchmarkCompared withInputs
Shear bands with and without rate-and-state frictionBand dips against the Arthur anglebenchmarks/geodynamics/localization/
Checking the friction law in simple shearClosed-form stresses for static friction and steady-state and aging-law RSFbenchmarks/faults-friction/simple_shear_rsf/
Elastoplastic oedometer testClosed-form Mohr–Coulomb stress path under uniaxial strainbenchmarks/mechanics/oedometer/oedometer-2d.cfg
Maxwell stress build-up in pure shearMaxwell response at a constant strain ratebenchmarks/mechanics/maxwell/maxwell.cfg
Elastic circular opening: Kirsch limitKirsch stresses and displacement around an unlined openingbenchmarks/poromechanics/
Plastic tunnel: Salençon solutionSalençon stresses, plastic radius and wall convergence for perfect Mohr–Coulomb plasticitybenchmarks/poromechanics/
Cooling of a half-spaceError-function profile in 2D and 3Dbenchmarks/heat/half-space-cooling/diffusion.cfg
Rate-and-state friction under a velocity stepClosed-form RSF response to a step in slip ratebenchmarks/poromechanics/
Fault-zone heating at fixed normal tractionThermal weakening by shear heating: shear resistance, temperature and pore pressure against a differential referencebenchmarks/poromechanics/
PoromechanicsConsolidation, groundwater and unsaturated flow, openings, injection and heat transport against analytical and independent solutionsbenchmarks/poromechanics/, tests/functional/hydromechanics/

Other comparisons with reference solutions​

These checks compare DES with a reference solution inside a tutorial or a functional test.

CheckWhat it testsWhereDocumented in
Confined elastic loading (PT)Stress and strain of a confined cell against the constrained-modulus solution, for both PT schemesPT tutorial bundleElastic loading and equilibrium
Maxwell creep (PT)Continued creep under a held load against a discrete Maxwell referencePT tutorial bundleMaxwell creep
Plane-strain elastic updateThe 2D plane-strain stress update, including the out-of-plane stresstests/functional/plane_strain_elastic/–
Homogeneous initial stressic.initial_stress_option = 1 produces the prescribed tensortests/functional/initial_stress/Initial stress
RSF controlsSlip-rate options and the state-change time-step limittests/functional/rsf_controls/Rate-and-state friction

Under tests/residual-assembly-test/, component checks call the production routines directly. They cover nodal force assembly (cancellation, traction, gravity, damping), PT constraints and failed constitutive trials, with OpenMP, AddressSanitizer and OpenACC builds.

Regression tests​

tests/regression/ guards against unintended changes in results. A run of a reference case is stored, and later runs are compared field by field:

cd tests/regression
make set # run once with the current executable and store the result
make cmp # rerun and compare with the stored result
make fresh-restart-cmp # run, restart from a checkpoint and compare: restart determinism

CASE selects the input (default test-3d-equ-tiny.cfg), NDIMS the dimension and OMP the thread count. The comparison script compare.py reports the relative difference of every field and fails above or on a non-finite value. A change to the solver that may alter results is checked by make set with the parent revision and make cmp with the change; see Testing.

Continuous integration​

Every pull request to DynEarthSol builds the code with several compilers and options (GCC 8–15, C++20 compatibility, macOS, NVHPC for OpenACC, MMG, ExodusII and GoSPL builds) and runs the functional tests:

  • a 3D elasto-visco-plastic model with remeshing and a temperature dome, and its restart determinism;
  • a 2D elastoplastic model on an irregular mesh with remeshing, and its restart determinism;
  • the plane-strain elastic update and homogeneous initial stress checks;
  • a subset of the RSF simple-shear benchmark;
  • rejection of malformed input files;
  • a 3D run in a debug build to catch memory errors.