Mohr-Coulomb Strength Reduction Benchmark
This directory implements a Mohr-Coulomb slope strength-reduction benchmark
derived from models.geomech.strength_reduction_method.pdf. The checked-in
input is generated from the reference geometry and uses the 0.75 m mesh size.
V5 acceptance covers the FOS curve, plastic-zone probes, displacement probes
and nonlinear diagnostic schema. The large critical-instability cloud route is
kept as an optional research/diagnostic path, not as a V5 delivery target.
Reference model:
- Geometry:
L1 = 85 m,L2 = 20 m,H1 = 20 m,H2 = 10 m. - Slope angles:
alpha = 15, 25, 35, 45 deg. - Material:
E = 20 MPa,nu = 0.3,c = 20 kPa,phi = 25 deg,rho = 1940 kg/m3. - Material case 1: nonassociative flow with
psi = 0 deg, mapped by Davis procedure B to an equivalent associated material before strength reduction. - Material case 2: associative flow with
psi = phi = 25 deg. - Stop criterion:
max displacement > Lslope / 20. - Boundary conditions: all nodes are constrained in the out-of-plane
ydirection and in unused rotational DOFs 4-6; the base is fixed in translations and the two vertical sides are fixed inx.
Files:
strength_reduction_slope_static.inp: full C3D8 solid embankment model for the PDF defaultalpha = 45 deggeometry, using native*DLOAD, GRAVsolid body force loading and a real*MOHR COULOMBmaterial. The lower rectangular foundation and the upper slope share interface nodes alongz = H1, so the checked mesh is conforming rather than two disconnected soil blocks.strength_reduction_reference_cases.csv: digitized/reference FOS values used for the two material cases and four slope angles.generate_strength_reduction_method.py: regenerates the checked-in input.check_strength_reduction_results.py: CTest checker for the full PDF reference sweep.run_case.bat: double-click runner that executes FemLite and then generates benchmark reports.
Generated benchmark outputs:
strength_reduction_path.csv: trial factor, residual, displacement criterion, plastic-share diagnostic, metric and search status for each alpha/material case.strength_reduction_cases.csv: computed and reference FOS for all 8 PDF cases.strength_reduction_summary.csv: aggregate convergence and maximum FOS error.plastic_zone.csv: Mohr-Coulomb branch activation at representative slope probes for every case.displacement_probe.csv: crest-down and toe-out displacement probes for every case.strength_reduction_nonlinear_chain.csv: optional real FE nonlinear trial records written when the benchmark tool is launched with--nonlinear-chain. Each row contains the selected nonlinear continuation method, strength factor, nonlinear solver error code, convergence status/failure code, cutback count, Newton iteration count, target/actual/next continuation increment, adaptive adjustment reason, trust radius, damping factor, residual merit ratio, trust rejection count, residuals, maximum nodal displacement and plastic integration-point share. Nonlinear chain/progress rows also aggregate Mohr-Coulomb integration-point diagnostics: point count, updated point count, accepted/requested substeps, limited return count, branch mask, maximum yield residual and maximum plastic increment.strength_reduction_nonlinear_summary.csv: optional summary for the same real nonlinear trial chain.strength_reduction_cloud_summary.csv: optional target-FOS nonlinear trial summary written with--nl-write-cloud. It records a0.3 mreference displacement scale and the currentmax_displacement / 0.3 mratio so diagnostic probes use the same scale yardstick without becoming V5 acceptance evidence.result_00001525.vtk: optional target-FOS cloud VTK for the referenceFOS = 1.525case. It contains nodaldisplacementvectors and elementeqpsscalars.
The runner intentionally does not generate result_00000001.vtk. That file was
previously produced by a linear static gravity precheck and can show
nonphysical displacements around 200 m, while the reference displacement
plot for material case 2, alpha = 45 deg, FOS = 1.525, is about 0.3 m. A
result directory that still contains result_00000001.vtk is rejected by the
checker so the old linear-static file cannot be used as nonlinear-cloud
evidence. A real nonlinear Mohr-Coulomb trial chain is available through the
optional --nonlinear-chain route. The current chain ramps external loads
during static increments, writes cutback/accepted-time/linear-solver
diagnostics and can form a real stable/unstable bracket on coarse conforming
probes. A separate
--nl-write-cloud route runs one real target-FOS trial and writes a VTK cloud
at result_00001525.vtk by default. The cloud route now uses adaptive
continuation, optional displacement prediction, and internal BiCGSTAB/ILU0
preconditioning when requested. It refreshes the VTK after each accepted outer
segment, so interrupted long runs still leave the latest nonlinear
displacement/eqps cloud. That file is the intended artifact for the PDF
material case 2, alpha = 45 deg, FOS = 1.525 displacement/eqps comparison.
Passing the file-structure check is not the same as reproducing the critical
instability cloud. That full 0.75 m route is intentionally outside the V5
delivery target because it exercises a large post-instability path whose cost is
inherent to the benchmark, not a simple parameter-tuning issue.
The production INP parser accepts
*NONLINEAR CONTINUATION, METHOD=value; if the keyword is omitted the selected
method is 1 (TWO_STAGE_LOAD_STRENGTH). Method 1 now runs a two-stage
load-strength route in the nonlinear chain and target cloud paths: stage A
converges the full gravity/load state at strength factor F = 1.0, and stage B
holds the external load fixed while the material strength reduction factor is
continued to the requested trial factor. The nonlinear chain, cloud summary and
cloud progress CSV files record this method id so long runs remain auditable.
Method 2 (ADAPTIVE_TARGET_NEWTON) records target/actual/next increment and
adjust reason; method 3 (TRUST_REGION_DAMPED_NEWTON) records trust radius,
damping, residual merit ratio and rejection count. Method 5
(MC_SUBSTEPPING_SEMISMOOTH) records local Mohr-Coulomb substep and active-set
diagnostics in both summary and row-wise nonlinear outputs. The checker rejects
missing or invalid continuation diagnostics.
The full 0.75 m FOS = 1.525 critical-instability cloud is deferred to a later
longrun/research validation track; it is not a blocker for the V5
strength-reduction benchmark acceptance.
Acceptance checks:
- The input must record the PDF geometry, 0.75 m mesh size, default 45 degree
slope, conforming lower/upper interface, native
*DLOAD, GRAVgravity route and*MOHR COULOMBmaterial. - All 8 PDF cases must converge and stay within 0.02 FOS of
strength_reduction_reference_cases.csv. - FOS must decrease monotonically as slope angle increases.
- The associative case must be at least as strong as the Davis-B nonassociative case at each slope angle.
- Each case must contain a real stable/unstable bracket, plastic-zone probe activation and crest-down/toe-out displacement signs.
- The checker deliberately validates the FOS curve and diagnostic CSV files
by default. If
strength_reduction_cloud_summary.csvexists, it also checks that the nonlinear target cloud VTK exists, contains displacement and eqps fields, matches the recorded mesh counts, reports the0.3 mreference displacement target and a self-consistent displacement scale ratio, and carries valid MC substep/branch diagnostic summaries. This optional file validation does not promote the critical-instability cloud to V5 acceptance.
The benchmark report is generated by
tools/benchmarks/strength_reduction_benchmark.f90, which links the production
FemLite core and calls the production Mohr-Coulomb material and
strength-reduction search driver. The helper remains outside src/ because it
is benchmark orchestration, not solver production code. Gravity is now applied
through native *DLOAD label GRAV as magnitude + direction, so the checked
input no longer contains generated equivalent nodal *CLOAD rows. The
benchmark executable creates the requested output directory when it does not
already exist, so direct command-line probes do not require a separate mkdir
step.
Manual nonlinear-chain probe:
build-win-gcc-16\strength_reduction_benchmark.exe ^
examples\strengthReduction\strength_reduction_slope_static.inp ^
build-win-gcc-16\strength_reduction_nl_probe ^
--nonlinear-chain --nl-max-trials 10 --nl-increments 100 --nl-max-newton 80
Manual target-FOS cloud probe:
build-win-gcc-16\strength_reduction_benchmark.exe ^
examples\strengthReduction\strength_reduction_slope_static.inp ^
build-win-gcc-16\strength_reduction_pdf_cloud ^
--nl-write-cloud --nl-cloud-factor 1.525 --nl-cloud-step 1525 ^
--nl-increments 100 --nl-max-newton 20 --nl-linear-iter 300 ^
--nl-tol 1.0e-3 --nl-no-line-search --nl-preconditioner ilu0
This route is intentionally not part of the default CTest acceptance yet. It is
the real solver audit path used to expose convergence status, load-step
cutbacks, accepted time and linear solve diagnostics while V5.4 continues
toward later critical-instability validation. Current 0.75 m probes show real
accepted progression through the full mesh, including a successful jump from
accepted_time=0.003 to 0.053, and later to 0.0905; the displacement
scales from 9.7294e-4 m at t=0.003 to 2.9383e-2 m at t=0.0905. A
completed accepted_time=1.0 critical-instability run is deliberately deferred
outside V5.