TerraBrains verification manual
Every comparison TerraBrains holds between one of its results and a value from outside the engine that produced it — source, page, quantity, our value, the reference, the miss and the status — grouped by analysis type. Deviations are shown as deviations. Generated from the repository by app/scripts/build-verification-manual.mjs; nothing is typed in by hand.
333FE kernel registry rows (updated 2026-11-14)
238kernel rows within tolerance of an outside reference
42kernel self-checks within tolerance (not outside evidence)
35kernel deviations
4kernel rows pending / blocked
6kernel rows recorded, no published value
8kernel rows superseded by newer rows
369cited validation suites
4527 / 0suite test blocks passing / failing
44/46closed-form registry passes
How to read this manual
- Status words are the registries’ own. Pass = within the tolerance the row states. Deviation / Miss = measured and outside that tolerance, or a difference the row records as known. Pending / Blocked / Not run = recorded, not yet runnable honestly. Three more appear on kernel rows: Superseded = an older stand-in or umbrella row, replaced by the newer row or rows named on it; not counted as a pass or as open; Recorded, no published value = we ran the case but the source publishes no number to compare with, so there is no verdict; Explained difference = a difference whose cause is established, with the evidence in the row, where the only value to compare with is the vendor's own output; still a difference. Kernel rows by status: 280 pass, 35 deviation, 6 recorded, no published value, 8 superseded, 4 pending.
- Miss % = (ours − reference) / reference × 100, signed, as recorded. “vs vendor” is against the vendor’s published value (e.g. PLAXIS); “vs reference” against the closed form or printed value.
- What a row is compared against. 224 kernel rows against a published / analytical reference, 42 against a vendor-published value, 53 are self-checks (compared with something derived inside this project — not evidence of agreement with an outside source), 14 hold no value yet.
- Validation suites. The suites were run on 2026-11-14 at commit
77a67124375c (engine tree e9a778bef7ec), Node 22.18.0, darwin arm64 · Apple M2 Pro · 10 threads. 1 suite(s) were edited after that run and are marked. 83 suite prologues mention a difference they do not assert (a text heuristic); they carry ⚑.
- Nothing here is “certified”. A pass is a verification: agreement within a measured tolerance on the case shown.
Contents
Every deviation in one place
Kernel registry rows that are not a pass (53)
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-2d-tut1-a-refinementFootings and bearing capacity | mesh-refinement study of the case-A force 2π·|Force-Y| (full Newton, tol 1e-8, tension cut-off on) [kN] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 28 | 588 | — | T15: (542 el (re 1.2): 596.65; 1201 el (re 0.8): running at report time; 2132 el (re 0.6): did not converge: load advancement stalled at ΣMstage 0.0957 (increment below minStep)); T6: (542 el (re 1.2): 625.87; 1201 el (re 0.8): 623.21; 2132 el (re 0.6): 618.32; 4822 el (re 0.4): 602.08) | — | — | Deviation |
plaxis-verif-gibson-2011-aFootings and bearing capacity | settlement under the strip (PLAXIS 2D 0.04845 / 0.04965 m; Gibson 0.05) [m] | PLAXIS-Verification-Strip-load-Gibson-soil-A.pdf, -B.pdf, p. 1–3 | 0.04845 | 0.05 | 0.04599 | −5.07 % | −8.02 % | Deviation |
plaxis-verif-k5-setFinite-element meshing, solvers and procedures | plaxis-verif-k5-set | Hoek-Brown-material-model, Triaxial-Hardening-Soil, Soft-Soil-Creep-Haney-clay, Phi-c-reduction-vs-Bishop, Benchmark-embankment-soft-clay | — | — | — | — | — | Superseded |
plaxis-verif-v2-setFinite-element meshing, solvers and procedures | plaxis-verif-v2-set | Lamb-problem, Surface-waves, Pulse-load-multilayer, One-dimensional-wave-propagation, Vertical-dynamic-response-footing, Free-vibration-dam, Ground-response-linear-soil | — | — | — | — | — | Superseded |
ertc7-wall-momentRetaining walls, excavations and structural elements | maximum bending moment in the wall, final excavation (−6 m), characteristic parameters, embedment 4 m [kNm/m] | PLAXIS-Verification-ERTC7-benchmark.pdf, p. 7 (Figure 8, characteristic, embedment 4.0 m: read at 300 dpi ≈ 212) | 212 | — | 204 | −3.77 % | — | Deviation |
ertc7-strut-forceRetaining walls, excavations and structural elements | strut force, final excavation [kN/m] | PLAXIS-Verification-ERTC7-benchmark.pdf, p. 8 (Figure 9, characteristic, 4.0 m: ≈ 117) | 117 | — | 123.9 | +5.90 % | — | Deviation |
ertc7-wall-base-displacementRetaining walls, excavations and structural elements | horizontal displacement of the wall base, final excavation [mm] | PLAXIS-Verification-ERTC7-benchmark.pdf, p. 7 (Figure 6, characteristic, 4.0 m: ≈ 6.0) | 6 | — | 9 | +50.0 % | — | Deviation |
plaxis-2d-tut2Slopes and embankments — factor of safety | drained / undrained embankment + safety factor [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 40–51 | — | — | — | — | — | Superseded |
plaxis-2d-tut3Retaining walls, excavations and structural elements | |u| at (50, 10) at the end of each phase (submerged excavation, undrained-A clay) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 52–71 | phase1: 0.005; phase2: 0.024; phase3: 0.024; phase4: 0.057; phase5: 0.141 | — | phase1: 0.0092; phase2: 0.0302; phase3: 0.0302; phase4: 0.074; phase5: stops at ΣMstage 0.350 (tol 1e-8 and 1e-7); at tol 1e-2 (PLAXIS default, TBK_T3_TOL=0.01) reaches ΣMstage 1 with |u| 0.117 | — | — | Superseded |
plaxis-2d-tut7-finalRetaining walls, excavations and structural elements | final phase: wall max |M|, anchor forces, wall displacements [kNm/m, kN, mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 135–137 (Figures 7–16…7–22: figures only) | — | — | wallL Mmax: 154; wallR Mmax: 157; at y: 23; anchors top L/R: [430.4, 428.6]; anchors bottom L/R: [1053.4, 1050.8]; ux(40,27) mm: 10.24; ux(40,23) mm: 13.34 | — | — | Superseded |
plaxis-2d-tut7-final-k4-flowRetaining walls, excavations and structural elements | final phase with REAL phase-6 steady flow: wall max |M|, anchor forces, wall displacements [kNm/m, kN, mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 135–137 (Figures 7–16…7–22: figures only) | — | — | wallL Mmax: 167; wallR Mmax: 170.7; at y: 23; anchors top L/R: [420.1, 424.4]; anchors bottom L/R: [1081.6, 1081.8]; ux(40,27) mm: 6.51; ux(40,23) mm: 12.33; prestress P3 / P5: [500, 1000] | — | — | Superseded |
k5c-acads-1d-fela-boundsSlopes and embankments — factor of safety | SR-FELA factor of safety, lower / upper bound (ACADS 1(d), kh = 0.15) [-] | Optum-G2-Verification-Slope-Stability.pdf, p. 6–7 (§2.3, Table 6) | — | 1.039 | lower: 0.9669; upper: 0.9767; errorPct: 0.51 | — | −6.47 % | Deviation |
k5b-plaxis-2d-tut9-consolidation-timeSettlement, stress distribution and consolidation | Tutorial 9 (Soft Soil undrained A + HS, 4 consolidation phases): time to p_excess < 1 kPa, plus settlements / excess pore pressures per phase [day, mm, kPa] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 145–160 (p. 159: 'more than 50 days are needed to reach full consolidation'; Figs 9-13…9-17 figures only) | > 50 d | — | t at p_excess < 1 kPa (d): 38.69; settlement (0,0) mm P1/P2/P3/P4: [261.4, 664.5, 829.5, 1033.7]; max p_excess kPa P1/P2/P3/P4: [26.6, 0.02, 28.76, 0.53]; toe (20,0) ux mm P4: 199.8; steps P1..P4: [280, 458, 20, 27] | — | — | Superseded |
k5b-plaxis-2d-tut7-real-hsRetaining walls, excavations and structural elements | Tutorial 7 with the REAL Hardening Soil (Table 7-1) + phase-6 steady flow: anchor forces, wall max |M|, wall ux [kN, kNm/m, mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 121–137 (prestress p. 137; Figs 7-16…7-22 figures only) | prestress 500 / 1000 kN (figures otherwise) | — | prestress P3 / P5: [500, 1000]; final anchors top L/R: [450.6, 446.8]; final anchors bottom L/R: [1058.8, 1055.4]; wallL / wallR Mmax: [141.9, 145.1]; at y: 23; ux(40,27) mm: 17.15; ux(40,23) mm: 17.06; K4 Mohr–Coulomb substitute (row plaxis-2d-tut7-final-k4-flow): (Mmax: [167, 170.7]; anchors top: [420.1, 424.4]; anchors bottom: [1081.6, 1081.8]; ux mm: [6.51, 12.33]) | — | — | Recorded, no published value |
k5b-plaxis-2d-tut2-drainedSlopes and embankments — factor of safety | Tutorial 2, embankment on DRAINED HS clay: uy at the crest (23,4), centre base (25,0), 2 m beyond the toe (38,0) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 40–46 (Fig. 2-7: figures only) | — | — | crest: -226.7; centre base: -177.9; beyond toe (38,0): 0.6 | — | — | Recorded, no published value |
k5a-gl99-example1Slopes and embankments — factor of safety | factor of safety, homogeneous 2:1 slope, φ′ 20°, c′/γH 0.05, ψ 0, D = 1 [-] | Griffiths and Lane 1999.pdf (library root), p. 391–392, Table 2 | — | 1.35 | 1.3412 | — | −0.65 % | Deviation |
k5a-tut2-safety-undrainedSlopes and embankments — factor of safety | factor of safety ΣMsf, embankment on undrained (A) clay (Phase 4) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 47–51 (Fig. 2-14) | 1.4 | — | 1.14911 | −17.9 % | — | Superseded |
k5d-plaxis-2d-tut3-submerged-hsRetaining walls, excavations and structural elements | |u| at (50, 10) at the end of each phase — real Hardening Soil, the kernel's own submerged excavation (D90: deactivated clusters keep their water) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 71 (Fig. 3-15 raster, pixel-measured; tests/data/plaxis_tut3_fig3_15.txt) | phase1: 0.0062; phase2: 0.0242; phase3: 0.0242; phase4: 0.0572; phase5: 0.1417 | — | phase1: 0.0054; phase2: 0.0225; phase3: 0.0225; phase4: 0.0589; phase5: 0.1519 | phase1: -12.9; phase2: -7; phase3: -7; phase4: 3; phase5: 7.2 | — | Deviation |
k5d-plaxis-2d-tut10-dewateringRetaining walls, excavations and structural elements | Tutorial 10: Tutorial 7 (real HS) + two extraction wells in the phase-6 steady flow (1.5 m³/day/m, h_min 17 m): well discharges, groundwater head in the pit, final anchor forces / wall moments [m³/day/m, m, kN, kNm/m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 166–169 (Figs 10–4, 10–5: figures only) | figures only (head lowered in the excavation, flow to the wells) | — | well discharge each (m³/day/m): -0.9797; side inflow each: 0.9773; pit-bottom seepage: 0; head in the pit (m): 18.90–18.99 (T7: 20 at the bottom); phreatic line in the pit y (m): [18.609, 18.982]; final anchors top L/R, bottom L/R (kN): [453, 449.7, 1050.1, 1048.2]; wall max |M| L/R (kNm/m): [135.1, 138.1] | — | — | Recorded, no published value |
k5d-benchmark-embankment-soft-claySlopes and embankments — factor of safety | SCMEP soft-clay embankment, Soft Soil (USTUTT set): centreline settlement after undrained construction / after 100 years, p_excess at (0, −2.5) [m, kPa] | PLAXIS-Verification-Benchmark-embankment-soft-clay-workshop.pdf (Wiltafsky et al. 2003), p. 2–5 (Fig. 1, Tables 1–2; Figs 2a, 2d, 3a, 3d read) | SS USTUTT settlement after construction (Fig. 2a): 0.18; after 100 years (Figs 3a, 3d): 1.05; p_excess (0,-2.5) (Fig. 2d): -34 | other models after construction: 0.11–0.24 m; after 100 years: 1.10–1.60 m | tol 1e-8 (530 T15, 9 Nov 2026): after the D557 mesh change layer 1 stops at ΣMstage 0.8515 (92 steps); settlement (0,0) 0.0167 m there; layer 2 fails at ΣMstage about 0; consolidation takes 0 steps (Modal, agent medium-d627, D627). X2 verdict numerical-stall, best ratio 1.0008e-8 vs 1e-8. tol 1e-3 not re-measured on this mesh; tol 1e-8 (712 T15, before 7 Nov): layer 1 stops at ΣMstage 0.6515 (arc-length increment below its minimum); settlement (0,0) 0.0129 m there; tol 1e-3: layer 1 completes (19 steps); layer 2 reaches ΣMstage 0.918 in maxSteps 1000; plaxis (ALG-1): layer 1 (bounded probe, maxSteps 15): ΣMstage 0.66, 878 iterations, 5 cuts; layers 1–2 NOT completed within the 6-min run cap (not measured); without the local rule layer 1 completes (6 steps, 266 iterations); strict tol 1e-2: 5 steps, 31 iterations | — | — | Deviation |
k5d1-plaxis-2d-tut8-uls-displacementRetaining walls, excavations and structural elements | |u| at (40, 27) at the end of ULS phase 12 (real Hardening Soil, DA3) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 143 (Fig. 8–5, embedded raster: pixel-measured, ±0.0001 m — tests/data/plaxis_tut8_fig8_5_8_6.txt on branch prog-a-t8) | 0.0518 | — | 0.069 | +33.2 % | — | Deviation |
k5d1-plaxis-2d-tut6-natmTunnels and underground works | NATM tunnel, β-method (60 % / 100 %) in two excavation stages: crown settlement, lining forces [mm, kNm/m, kN/m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 108–120 (Fig. 6–11, 6–13: figures only) | — | — | crown uy phase 1..4 mm: [-7.45, -8.65, -9.17, -9.11]; crest (−7, 35) uy phase 4 mm: -19.77; liningTop M max/min kNm/m: [2.5, -4.8]; liningTop N min kN/m: -164; liningInvert M max/min kNm/m: [2.6, -3.3]; liningInvert N min kN/m: -59 | — | — | Recorded, no published value |
k5d1-plaxis-2d-tut5-building-tiltTunnels and underground works | building tilt at the end of phase 5 (lining), displacements from phase 2 on: (uy(15, 3) − uy(5, 3)) / 10 m [%] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 106–107 (Fig. 5–9: (5, 3) → (4.995, 2.981), (15, 3) → (14.995, 2.998)) | 0.168 | — | 0.1834 | +9.17 % | — | Deviation |
k5d1-plaxis-2d-tut4-safety-phase7Slopes and embankments — factor of safety | ΣMsf of the Safety phase after the second excavation (phase 3) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.33) | 1.33 | — | — | — | — | Deviation |
k5d1-plaxis-2d-tut4-safety-phase8Slopes and embankments — factor of safety | ΣMsf of the Safety phase after the wall and backfill (phase 6) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.83) | 1.83 | — | — | — | — | Deviation |
alg1-plaxis-2d-tut4-repro-safety-phase7Slopes and embankments — factor of safety | ΣMsf of the Safety phase after the second excavation (phase 3) — PLAXIS-REPRODUCTION variant (cable strength per metre, reduced in Safety; PLAXIS-parity convergence) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.83) | 1.33 | — | 1.2852 | −3.37 % | — | Deviation |
alg1-plaxis-2d-tut4-repro-safety-phase8Slopes and embankments — factor of safety | ΣMsf of the Safety phase after the wall and backfill (phase 6) — PLAXIS-REPRODUCTION variant (cable strength per metre, reduced in Safety; PLAXIS-parity convergence) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.83) | 1.83 | — | 1.6625 | −9.15 % | — | Deviation |
k7a-dam-free-vibrationEarthquake engineering, dynamics and liquefaction | first two natural frequencies of a dam with depth-varying G (PLAXIS 2.9 / 6.4 Hz; closed form 3.1 / 7.0 Hz) [Hz] | PLAXIS-Verification-Free-vibration-dam-2018.pdf, p. p. 1–3 | 2.9 | 3.1 | — | — | — | Pending |
k7a-pulse-multilayerEarthquake engineering, dynamics and liquefaction | surface deflection under a pulse load on a 3-layer pavement (stiff / soft subgrade) [mm] | PLAXIS-Verification-Pulse-load-multilayer.pdf, p. p. 1–4 | — | — | — | — | — | Pending |
k7a-surface-wavesEarthquake engineering, dynamics and liquefaction | surface-wave amplitude vs distance from a harmonic prescribed displacement (BEM Chouw et al. 1991) [m] | PLAXIS-Verification-Surface-waves.pdf, p. p. 1–3 | — | — | — | — | — | Pending |
k7a-midas-ch4-dynamicsEarthquake engineering, dynamics and liquefaction | Midas GTS NX dynamics benchmarks [-] | Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_4_Dynamics.pdf, p. Ch. 4 | — | — | — | — | — | Pending |
k7b-liquefaction-column-ruself-check Earthquake engineering, dynamics and liquefaction | max r_u = Δp/σ′v0 at 4 m and 7 m depth [-] | closed form (r_u ≤ 1) + cross-check, p. — | — | 0.95 | 4 m: 0.8024; 7 m: 1.0311 | — | — | Deviation |
k7-plaxis-2d-tut15-free-vibration-residual-undampedEarthquake engineering, dynamics and liquefaction | residual surface displacement after the generator stops, r = 1.37 m, no damping (amplitude over 0.6–1.0 s) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 241 | 0.0034 | — | 0.00531 | +56.2 % | — | Deviation |
k7-plaxis-2d-tut15-free-vibration-residual-dampedEarthquake engineering, dynamics and liquefaction | residual surface displacement after the generator stops, r = 1.37 m, with Rayleigh damping (amplitude over 0.6–1.0 s) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 242 | 0.0008 | — | 0.00313 | +291.3 % | — | Deviation |
v-hs-published-curve-1self-check Constitutive models and element tests | HS-1 εv medium (drained TC, MMM Fig 13.3): max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM 2015 Figs 13.2–13.5 | — | 1 | 2.452 | — | — | Deviation |
v-hs-published-curve-2self-check Constitutive models and element tests | HS-1 εv dense: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM 2015 Figs 13.2–13.5 | — | 1 | 1.347 | — | — | Deviation |
v-hs-published-curve-3self-check Constitutive models and element tests | HS-4 εv dense (Hostun): max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM 2025.1 Figs 17-9/17-10 | — | 1 | 1.001 | — | — | Deviation |
v-hs-published-curve-4self-check Constitutive models and element tests | HS-2 q medium (undrained): max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 3.595 | — | — | Deviation |
v-hs-published-curve-5self-check Constitutive models and element tests | HS-2 q dense: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 3.704 | — | — | Deviation |
v-hs-published-curve-6self-check Constitutive models and element tests | HS-2 P_excess medium: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 1.334 | — | — | Deviation |
v-hs-published-curve-7self-check Constitutive models and element tests | HS-2 P_excess dense: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 7.456 | — | — | Deviation |
v-hs-published-curve-8self-check Constitutive models and element tests | HSS-1 G dense σ3 100 kPa (Benz 2007 Fig 8.2/8.3): max normalised distance to the published markers (rule ≤ 1) [-] | benz-2007-small-strain-stiffness-of-soils-numerical-consequences.pdf, p. Benz 2007 Figs 8.2/8.3 | — | 1 | 1.562 | — | — | Deviation |
v-hs-published-curve-9self-check Constitutive models and element tests | HSS-1 G loose σ3 100 kPa: max normalised distance to the published markers (rule ≤ 1) [-] | benz-2007-small-strain-stiffness-of-soils-numerical-consequences.pdf, p. Benz 2007 Figs 8.2/8.3 | — | 1 | 2.765 | — | — | Deviation |
k11-3d-tut1-a-control-cornerThree-dimensional analysis | flexible control: footprint-corner settlement (x = y = 18 m) under 66 kPa surface pressure (elastic clay) [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 45.14 | 50.08 | — | +10.9 % | Deviation |
k11-3d-tut1-a-basement-settlementThree-dimensional analysis | Tutorial 1 Case A as written (Table 1–1 Mohr–Coulomb clay): mean settlement of the basement underside (z = −2 m), base mesh [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 115.38 | 99.23 | — | −14.0 % | Deviation |
k11-3d-tut1-a-basement-settlement-fineself-check Three-dimensional analysis | Tutorial 1 Case A as written: mean basement-underside settlement, bisected mesh [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 115.38 | 102.19 | — | −11.4 % | Deviation |
k11-3d-hs-tut1-basementThree-dimensional analysis | Tutorial 1 Case A with the clay as Hardening Soil: mean settlement of the basement underside (z = −2 m), base mesh [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | — | 75.228 | — | — | Recorded, no published value |
k11-3d-hs-tut1-vs-mcThree-dimensional analysis | Tutorial 1 Case A: HS basement settlement relative to the Mohr–Coulomb run (row k11-3d-tut1-a-basement-settlement, 99.231 mm) [%] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | — | -24.19 | — | — | Recorded, no published value |
m17-norsand-brasted-plane-strain-peak-looseConstitutive models and element tests | NorSand drained plane strain (Cornforth apparatus, sigma_3 = 276 kPa, eps_2 = 0, K0 start), Brasted sand, loose (test A10-14): peak major principal stress sigma_1 [kPa] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. Fig. 3.23 (p. 142, PDF 164), Table 3.4 (p. 140), Table 2.1, Fig. 2.45 (p. 92) | — | 1033 | 1100 | — | +6.50 % | Deviation |
m17-norsand-brasted-plane-strain-peak-compactConstitutive models and element tests | NorSand drained plane strain (Cornforth apparatus, sigma_3 = 276 kPa, eps_2 = 0, K0 start), Brasted sand, compact (test A10-12): peak major principal stress sigma_1 [kPa] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. Fig. 3.23 (p. 142, PDF 164), Table 3.4 (p. 140), Table 2.1, Fig. 2.45 (p. 92) | — | 1186 | 1303 | — | +9.90 % | Deviation |
m17-norsand-brasted-plane-strain-peak-denseConstitutive models and element tests | NorSand drained plane strain (Cornforth apparatus, sigma_3 = 276 kPa, eps_2 = 0, K0 start), Brasted sand, dense (test A10-17): peak major principal stress sigma_1 [kPa] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. Fig. 3.23 (p. 142, PDF 164), Table 3.4 (p. 140), Table 2.1, Fig. 2.45 (p. 92) | — | 1488 | 1646 | — | +10.6 % | Deviation |
tunnel-s1-plaxis3d-tut5-ground-settlementTunnels and underground works | maximum settlement at ground level after phase 5 (PLAXIS: horizontal cross-section at z = 1.95 m; ours: surface z = 2 m) [cm] | PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf (+ PLAXIS-3D-2026.1-Tutorial-Manual.pdf), p. §5.9, pp. 111–112 (2026.1: pp. 112–113) | 1.9 (PLAXIS 3D) | — | 1.8549 | −2.37 % | — | Deviation |
tunnel-s1-plaxis3d-tut5-max-uzTunnels and underground works | maximum vertical displacement after phase 5 (Fig 5-34 caption) [cm] | PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf (+ PLAXIS-3D-2026.1-Tutorial-Manual.pdf), p. §5.9, pp. 111–112 (2026.1: pp. 112–113) | 3.1 (PLAXIS 3D) | — | 3.4275 | +10.6 % | — | Deviation |
Closed-form registry rows that are not a pass (2)
| Row | Problem | Reference | Ours | Δ | Tolerance | Status |
FE-NGAMMA-SMOOTH | N_γ strip on cohesionless sand, smooth (c = 0, q = 0) | 612.24 | 415.506 | −32.1 % | ± 1 % | Miss |
FE-NGAMMA-ROUGH | N_γ strip on cohesionless sand, rough (c = 0, q = 0) | 1180.34 | 1249.39 | +5.85 % | ± 1 % | Miss |
Validation-suite test blocks that failed in the recorded run (0)
None.
Validation-suite test blocks written but not asserted (skip / todo: 2)
fe-slope-stability-web-validation.test.ts — [VAL-1] ACADS 1(a): FE strength-reduction FoS within 3 % of RS2 SSR 0.99Why: VAL1-FE-1: RS2 SSR 0.99 (critical SRF 0.995) is above the rigorous upper bound 0.984, so a 3 % band around it is not a correctness criterion. Default is 0.9609 after VAL1-FE-2 (was 0.9453, 4.5 % low). See MEDIUM-ACADS-REPORT.md / MEDIUM-D612-REPORT.md
footing-3d-web-validation.test.ts — C.FOOT3D.6h: c-φ square with γ and D_f — physical bounds and its D509 lock (HEAVY tier)Why: GEOTECH_HEAVY=1 (minutes in TS; the Python twin runs it in validate_fe_footing_3d.py)
FE kernel registry — 17 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-2d-tut1-a-force | total footing force 2π·|Force-Y| at 0.05 m indentation (rigid rough footing, case A) [kN] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 28 (§1.3.6.4 step 2) | 588 | — | 600.77 | +2.17 % | — | Pass |
plaxis-2d-tut1-a-fy-0.3943 | Force-Y per radian at ΣMstage = 0.3943 (u = 0.0197 m) [kN/rad] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 28 (Figure 1–18, calculation progress window) | -53.79 | — | -53.974 | +0.34 % | — | Pass |
plaxis-2d-tut1-a-umax | maximum total displacement (the footing) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 29 (Figure 1–19: maximum |u| = 0.05000 m) | 0.05 | 0.05 | 0.05 | 0.00 % | 0.00 % | Pass |
plaxis-2d-tut1-k0-effective-stressself-check | K0 procedure: σ′v = −Σγh + p, σ′h = 0.5 σ′v, p = 10(2 − y) — worst |error| over every integration point [kPa] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 14–16, 23 (Head 2.0 m; Table 1–1; K0 procedure) | — | hand calculation (γ_unsat 17 above y = 2, γ_sat 20 below, γ_w 10, K0 = 1 − sin 30° = 0.5) | 1.000e-12 | — | 0.00 % | Pass |
plaxis-2d-tut1-b-flexible | |u| of node (0, 4) vs ΣMstage under 188 kPa on the plate footing (EA 5e6, EI 8.5e3, ν 0), axisymmetric; PLAXIS Figure 1–27: 0.5 → 0.0156, 0.6 → 0.0207, 0.8 → 0.0328, 0.9 → 0.0398, 1.0 → 0.0496 m (±0.0003) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 31–39 (case B, Table 1–2 p. 33; Figure 1–27 p. 39, read at 220 dpi) | 0.0496 | — | 0.048745 | −1.72 % | — | Pass |
plaxis-2d-tut1-a-refinement | mesh-refinement study of the case-A force 2π·|Force-Y| (full Newton, tol 1e-8, tension cut-off on) [kN] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 28 | 588 | — | T15: (542 el (re 1.2): 596.65; 1201 el (re 0.8): running at report time; 2132 el (re 0.6): did not converge: load advancement stalled at ΣMstage 0.0957 (increment below minStep)); T6: (542 el (re 1.2): 625.87; 1201 el (re 0.8): 623.21; 2132 el (re 0.6): 618.32; 4822 el (re 0.4): 602.08) | — | — | Deviation |
plaxis-verif-circular-footing-cox | collapse average stress p = 2πF/(πR²) of a smooth rigid circular footing [kPa] | PLAXIS-Verification-Bearing-capacity-circular-footing.pdf, p. 3 (Output; Verification: Cox 1962) | 227.64 | 225.6 | 227.284 | −0.16 % | +0.75 % | Pass |
plaxis-verif-smooth-rigid-strip | footing force for 0.01 m [kN/m] | PLAXIS-Verification-Smooth-rigid-strip-footing-elastic.pdf, p. 1–2 | 15.208 | 15.148 | 15.225 | +0.11 % | +0.51 % | Pass |
plaxis-verif-boussinesq | centre settlement [mm] | PLAXIS-Verification-Boussinesq.pdf, p. 1–3 | 0.0903 | 0.091 | 0.09033 | +0.03 % | −0.73 % | Pass |
plaxis-verif-davis-booker | mean ultimate stress, smooth / rough (PLAXIS 2D 7.831 / 9.168 kPa) [kPa] | PLAXIS-Verification-Bearing-capacity-strip-footing-DavisBooker.pdf, p. 1–4 | 7.831 / 9.168 | 7.800 / 9.090 | 7.8335 / 9.1826 | +0.03 / +0.16 % | +0.43 / +1.02 % | Pass |
plaxis-verif-gibson | settlement under the strip (PLAXIS 2D 0.04845 / 0.04965 m; Gibson 0.05) [m] | PLAXIS-Verification-Strip-load-Gibson-soil-A.pdf, -B.pdf, p. 1–3 | 0.04965 | 0.05 | 0.04951 | −0.28 % | −0.98 % | Pass |
plaxis-verif-gibson-2011-a | settlement under the strip (PLAXIS 2D 0.04845 / 0.04965 m; Gibson 0.05) [m] | PLAXIS-Verification-Strip-load-Gibson-soil-A.pdf, -B.pdf, p. 1–3 | 0.04845 | 0.05 | 0.04599 | −5.07 % | −8.02 % | Deviation |
k5c-strip-prandtl-nc-smooth | strip footing bearing factor bounds: Prandtl Nc smooth [-] | Potts & Zdravković Vol. 2 §6.5.4.2 (Prandtl 2 + π), p. — | — | 5.14159 | lower: 5.1256; upper: 5.1455; errorPct: 0.19 | — | — | Pass |
k5c-strip-prandtl-nc-rough | strip footing bearing factor bounds: Prandtl Nc rough [-] | Potts & Zdravković Vol. 2 §6.5.4.2 (Prandtl 2 + π), p. — | — | 5.14159 | lower: 5.1322; upper: 5.1551; errorPct: 0.22 | — | — | Pass |
k5c-strip-ngamma-smooth-30 | strip footing bearing factor bounds: Ngamma smooth 30 (Martin 7.65300) [-] | Optum-G3-Verification-Strip-Footing-on-Sand.pdf (Martin 2005 table, p. 4), p. — | — | 7.653 | lower: 7.374; upper: 8.2657; errorPct: 5.7 | — | — | Pass |
k5c-strip-ngamma-rough-30 | strip footing bearing factor bounds: Ngamma rough 30 (Martin 14.7543) [-] | Optum-G3-Verification-Strip-Footing-on-Sand.pdf (Martin 2005 table, p. 4), p. — | — | 14.7543 | lower: 13.7698; upper: 15.9087; errorPct: 7.21 | — | — | Pass |
k5a-prandtl-safety | strength-reduction factor of a strip load q = (2 + π)c/2 on weightless Tresca (closed form F = 2) [-] | — | — | 2 | 2.00312 | — | +0.16 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
plaxis-2d-tut1-a-force — Pass · K2 (D80 solver, K3)
Case: cases/plaxis-2d-tutorial-01-case-a.json
Mesh: T15 axisymmetric, 542 elements / 4473 nodes, l_e = 0.384 m (PLAXIS 2025.1 Medium element dimension, Fig. 1–10), footing coarseness 0.25, phreatic line welded
Reproduce: tests/k2_integration.rs tutorial1_case_a_full (ignored: ~30 min) + tutorial1_k0_with_water_and_the_first_load_steps
Notes: ALG-1 (kernel/alg1, 23 Oct): PLAXIS-parity mode: F = 596.11 kN (+1.38 %), Fy(ΣMstage 0.3943) −54.008 (+0.40 %), 88 steps, 640 iterations, 132 s (strict ~30 min). K5a solver (default: Anderson-accelerated continuation, 2 × maxIter): 600.77 kN (+2.17 %), Fy(0.3943) −53.974; 413 steps / 96 continuations (5 converged) / 8 668 iterations / 1 076 s vs the K4 solver 601.23 kN, 452 / 125 / 21 368, 1 264 s in the SAME run (both concurrent on one loaded machine; the 758 s of the K3 row was a quieter machine). With accelerator "none" the K4 numbers are reproduced bitwise. || K3 D80 solver (line search + stagnation exit + initial-stiffness continuation from the best iterate): 601.23 kN (+2.25 %; gate 2.5 %); 452 steps / 118 cuts / 21 368 iterations / 758 s CPU (K2 solver: 596.65, 1412 / 881 / 139 526, 1470 s CPU). The +0.77 % move is a different, equally converged branch: non-associated MC (ψ = 0 ≠ φ) has non-unique incremental solutions at folds (D81); on the 221-element mesh four solver variants spread over 613.3–618.3 kN. PLAXIS states 'about 588 kN'. Ours at the PLAXIS tolerance class is not comparable: modified Newton at tol 1e-3 gives 610.3 (+3.8 %), tol 1e-8 (full Newton on the unsymmetric LDU, ψ = 0 ≠ φ) gives 596.65 — the answer is tolerance-sensitive (path-dependent non-associated plasticity). Our mesh is not PLAXIS's (the PLAXIS progress window shows 'Element 467', ours has 542; PLAXIS applies 'enhanced mesh refinement'); see the refinement rows. Tension cut-off on (PLAXIS default σt = 0); without it 601.27 kN.
plaxis-2d-tut1-a-fy-0.3943 — Pass · K2
Case: cases/plaxis-2d-tutorial-01-case-a.json
Mesh: as plaxis-2d-tut1-a-force
Reproduce: tests/k2_integration.rs tutorial1_case_a_full
Notes: K3 D80 solver: −53.974 (K2: −53.987). Read from the progress-window screenshot (an intermediate step, interpolated on our curve). Tolerance sensitivity: modified Newton tol 1e-3 −55.33, tol 1e-4 −54.29, full Newton tol 1e-8 −53.99.
plaxis-2d-tut1-a-umax — Pass · K2
Case: cases/plaxis-2d-tutorial-01-case-a.json
Mesh: as plaxis-2d-tut1-a-force
Reproduce: tests/k2_integration.rs tutorial1_k0_with_water_and_the_first_load_steps (uy = −0.05 λ, ux = 0 on the footing node)
Notes: Prescribed — a consistency check of the prescribed-displacement path, not a result.
plaxis-2d-tut1-k0-effective-stress — Pass · K2
Case: cases/plaxis-2d-tutorial-01-case-a.json
Mesh: as plaxis-2d-tut1-a-force
Reproduce: tests/k2_integration.rs tutorial1_k0_with_water_and_the_first_load_steps; tests/water.rs
Notes: k0-equilibrium 4.5e-14 because the phreatic level is welded into the mesh; without it the jump lies inside elements and the out-of-balance is reported (tests/water.rs).
plaxis-2d-tut1-b-flexible — Pass · K5a (D86: completes at tol 1e-8)
Case: cases/plaxis-2d-tutorial-01-case-b.json
Mesh: as case A (542 T15, footing factor 0.25), the plate on the footing line
Reproduce: tests/k3_tutorials.rs tutorial1_case_b_flexible_footing (ignored; TBK_T1B_TOL=1e-4 for the tolerance variant)
Notes: D139 (FH-4, ordering-only path change, proven by reproducing the old elimination order bit for bit): 0.048716 → 0.048745 m at ΣMstage 1 (−1.72 %). ALG-1 (kernel/alg1, 23 Oct): PLAXIS-parity mode (`TBK_CONTROL={"convergence":"plaxis"}`): 0.04835 m (−2.5 %), 77 steps, 2 cuts, 790 iterations, 105 s (strict: 382 steps, 86 cuts, 961 s). K5a: completes at the kernel default tol 1e-8 — |u| 0.015916 / 0.020876 / 0.033047 / 0.040331 / 0.048716 m at ΣMstage 0.5 / 0.6 / 0.8 / 0.9 / 1.0 (+2.0 / +0.9 / +0.8 / +1.3 / −1.8 %); 382 steps, 86 cuts, 8 078 iterations, 961 s (loaded machine); arc-length (auto) took over for 35 steps after a load-control stall and reached ΣMstage 1. Path sensitivity (non-associated, D81): solver variants spread −1.7 … −2.9 % at ΣMstage 1. Before K5a the 1e-8 run stalled at ΣMstage 0.762 (D86); at tol 1e-4 it completed at −1.2 %.
plaxis-2d-tut1-a-refinement — Deviation · K2
Case: cases/plaxis-2d-tutorial-01-case-a.json (relativeSize / order varied)
Mesh: T15 re 1.2 / 0.8 / 0.6 and T6 re 1.2 / 0.8 / 0.6 / 0.4 (footing factor 0.25 relative)
Reproduce: scratch study (full-Newton tol 1e-8); numbers in the K2 integration report
Notes: T6 converges from above (locking under isochoric ψ = 0 flow): +6.4 % → +1.4 % vs 588 at 9× the elements, approaching the T15 Medium 596.65 (Fy(0.3943): T6 −55.63 / −55.08 / −54.65 / −53.77, T15 −53.99, PLAXIS −53.79). The T15 refinement could not be completed: the 2132-element T15 run stalls at ΣMstage 0.0957 — the non-associated MC Newton (and its modified-Newton safeguard) does not reach 1e-8 there (ISSUES K2i-6). Not a pass.
plaxis-verif-circular-footing-cox — Pass · K2
Case: cases/plaxis-verification-bearing-capacity-circular-footing.json
Mesh: T15 axisymmetric, Medium (r_e = 1), 0.25 m corner geometry line refined 0.2, footing 0.25
Reproduce: tests/k2_integration.rs plaxis_circular_footing_bearing_capacity_cox
Notes: Associated MC (φ = ψ = 30°): full Newton (symmetric), tol 1e-8, plateau over the last quarter < 0.1 %. PLAXIS 2D +0.9 % vs Cox.
plaxis-verif-smooth-rigid-strip — Pass · K2a
Case: tests/model.rs
Mesh: rect-mesh T15
Reproduce: tests/model.rs plaxis_smooth_rigid_strip_footing_on_elastic_layer
Notes: K2a gate (Giroud 1972).
plaxis-verif-boussinesq — Pass · K2a
Case: tests/model.rs
Mesh: rect-mesh T15 axisymmetric 10 × 10 m
Reproduce: tests/model.rs plaxis_boussinesq_axisymmetric_circular_load
Notes: K2a gate; the analytic value is the half-space.
plaxis-verif-davis-booker — Pass · K5a (su,inc / Eu,inc in the model document)
Reference: Davis & Booker (1973): β[(2+π) su,ref + B su,inc/4], β = 1.27 smooth / 1.48 rough
Case: (test fixture: tests/k5_solver.rs davis_booker_strip_footing_on_strength_increasing_with_depth)
Mesh: 893 T15
Reproduce: cargo test -p tbk-core --release --test k5_solver davis_booker -- --ignored --nocapture
Notes: Undrained C, φu = 0, su = 1 + 2·depth, Eu = 299 + 598·depth, νu 0.495, γ = 0, no tension cut-off; half model 3 × 2 m, T15, the footing edge refined 0.05; prescribed displacement 0.05 m (smooth: ux free; rough: ux fixed). Gate: within 3 % of PLAXIS.
plaxis-verif-gibson — Pass · K5a (Einc)
Case: (test fixture: tests/k5_solver.rs plaxis_strip_load_on_gibson_soil)
Mesh: version B (2018): half 30 × 30 m, 2 × 2 m zone coarseness 0.03125, 10 898 T15
Reproduce: tests/k5_solver.rs plaxis_strip_load_on_gibson_soil_versions_a_b_and_study (ignored: 33 s for B)
Notes: Re-run 12 Nov 2026 with version B's exact inputs. Gate written beforehand: ≤ 1.0 % against Gibson's closed form (the document's own largest error). Limit study: settlement is linear in (1 − 2ν) down to ν = 0.49999 (no locking), and enlarging the domain converges to 0.05005 m (+0.1 % of q/2α). So the −0.98 % here is two opposite effects, ν = 0.499 (+2.5 %) against the 30 m box (−3.4 %); the like-for-like comparison is PLAXIS B (−0.28 %). Version A (2011) has its own row, plaxis-verif-gibson-2011-a. || Centre settlement (version A, 2-D). Mesh-converged (2032 / 4049 / 6185 T15: 0.04626 / 0.04640 / 0.04626). Sensitive to ν near 0.5 (ν 0.49: +12 %, 0.4999: −10 % vs Gibson) and to the domain (60 × 60 m: 0.04929, −1.4 %): near-incompressible displacement elements on a soil whose surface stiffness vanishes; Gibson's solution is for ν = 0.5 on a half-space. Deviation: −4.8 % vs PLAXIS on the PLAXIS domain (20 × 30 m, half model here).
plaxis-verif-gibson-2011-a — Deviation · K5a (Einc)
Case: (test fixture: tests/k5_solver.rs plaxis_strip_load_on_gibson_soil)
Mesh: version A (2011): half 10 × 30 m as stated; mesh-converged (0.0463 to 0.0464 on finer meshes)
Reproduce: tests/k5_solver.rs plaxis_strip_load_on_gibson_soil_versions_a_b_and_study (ignored: 33 s for B)
Notes: Version A's stated geometry, 12 Nov 2026. Gate written beforehand: ≤ 4.5 % against Gibson (that document's own largest error); not met. Cause not established: the same kernel matches the 2018 document, and PLAXIS A's value corresponds to a half-width of about 17 m in our width sweep, not the 10 m of its figure.
k5c-strip-prandtl-nc-smooth — Pass · K5c
Reference: exact (Prandtl / Martin 2005)
Benchmark: vendor: literature; product: Martin 2005 / Prandtl; version: —; doc: —; page: —; caseId: prandtl-nc-smooth
Comparison (closed-form): exact = 5.14159, tolerance LB ≤ exact ≤ UB
Case: tests/k5c_registry.rs strip_registry (TS fan mesh)
Mesh: TS fan mesh, 3424 T3/T6
Reproduce: tests/k5c_registry.rs strip_registry
Notes: Kernel port of the TS computeStripLimitAnalysis (bitwise-identical programs); 3424 elements, 13.8 s native.
k5c-strip-prandtl-nc-rough — Pass · K5c
Reference: exact (Prandtl / Martin 2005)
Benchmark: vendor: literature; product: Martin 2005 / Prandtl; version: —; doc: —; page: —; caseId: prandtl-nc-rough
Comparison (closed-form): exact = 5.14159, tolerance LB ≤ exact ≤ UB
Case: tests/k5c_registry.rs strip_registry (TS fan mesh)
Mesh: TS fan mesh, 3424 T3/T6
Reproduce: tests/k5c_registry.rs strip_registry
Notes: Kernel port of the TS computeStripLimitAnalysis (bitwise-identical programs); 3424 elements, 12.4 s native.
k5c-strip-ngamma-smooth-30 — Pass · K5c
Reference: exact (Prandtl / Martin 2005)
Benchmark: vendor: literature; product: Martin 2005 / Prandtl; version: —; doc: —; page: —; caseId: ngamma-smooth-30
Comparison (closed-form): exact = 7.653, tolerance LB ≤ exact ≤ UB
Case: tests/k5c_registry.rs strip_registry (TS fan mesh)
Mesh: TS fan mesh, 1944 T3/T6
Reproduce: tests/k5c_registry.rs strip_registry
Notes: Kernel port of the TS computeStripLimitAnalysis (bitwise-identical programs); 1944 elements, 8.1 s native.
k5c-strip-ngamma-rough-30 — Pass · K5c
Reference: exact (Prandtl / Martin 2005)
Benchmark: vendor: literature; product: Martin 2005 / Prandtl; version: —; doc: —; page: —; caseId: ngamma-rough-30
Comparison (closed-form): exact = 14.7543, tolerance LB ≤ exact ≤ UB
Case: tests/k5c_registry.rs strip_registry (TS fan mesh)
Mesh: TS fan mesh, 1944 T3/T6
Reproduce: tests/k5c_registry.rs strip_registry
Notes: Kernel port of the TS computeStripLimitAnalysis (bitwise-identical programs); 1944 elements, 7.3 s native.
k5a-prandtl-safety — Pass · K5a
Reference: Prandtl (1921): q_ult = (2 + π) c
Case: (test fixture: tests/k5_safety.rs prandtl_spec)
Mesh: T15, relative size 1.2, load refined 0.25
Reproduce: cargo test -p tbk-core --test k5_safety prandtl_strip_load_factor_of_safety -- --nocapture
Notes: Default suite; also the target-ΣMsf option (1.5 reached).
Closed-form engine registry — 40 published problems
| Row | Problem | Source | Reference | Ours | Δ | Tolerance (why) | Status |
BC-JRC-A33-NQ-M1 | EN 1997-1 Annex D Nq at φ′d = 38° (M1) strip, c′ 0, φ′k 38°, γ 18.5, Df 1.5, B 1.5; M1 (γφ′ 1.00) | Bond, Schuppener, Scarpelli, Orr — Eurocode 7: Geotechnical Design, Worked examples (JRC / Dublin workshop, 2013), Annex A.3.3 — Tables A.3.1 / A.3.2, p. 112–113 | 48.87 Nq | 48.9333 | +0.13 % | ± 0.3 % the report evaluated Nq = e^(π tanφ)·tan²(45° + φ/2) with π = 3.14: that reproduces all four printed cells exactly (48.872, 74.804, 23.172, 27.716) and is the whole +0.09…+0.13 % offset (found in our internal review). 0.3 % still rejects every alternative Nγ form (nearest is 4.3 % away) | Pass |
BC-JRC-A33-NG-M1 | EN 1997-1 Annex D Nγ at φ′d = 38° (M1) as above | Bond, Schuppener, Scarpelli, Orr — Eurocode 7: Geotechnical Design, Worked examples (JRC / Dublin workshop, 2013), Annex A.3.3 — Tables A.3.1 / A.3.2, p. 112–113 | 74.8 Nγ | 74.8991 | +0.13 % | ± 0.3 % the report evaluated Nq = e^(π tanφ)·tan²(45° + φ/2) with π = 3.14: that reproduces all four printed cells exactly (48.872, 74.804, 23.172, 27.716) and is the whole +0.09…+0.13 % offset (found in our internal review). 0.3 % still rejects every alternative Nγ form (nearest is 4.3 % away) | Pass |
BC-JRC-A33-NQ-M2 | EN 1997-1 Annex D Nq at φ′d = tan⁻¹(tan 38°/1.25) (M2) strip, φ′d = 32.007° (M2, γφ′ 1.25) | Bond, Schuppener, Scarpelli, Orr — Eurocode 7: Geotechnical Design, Worked examples (JRC / Dublin workshop, 2013), Annex A.3.3 — Tables A.3.1 / A.3.3, p. 112–113 | 23.17 Nq | 23.1946 | +0.11 % | ± 0.3 % the report evaluated Nq = e^(π tanφ)·tan²(45° + φ/2) with π = 3.14: that reproduces all four printed cells exactly (48.872, 74.804, 23.172, 27.716) and is the whole +0.09…+0.13 % offset (found in our internal review). 0.3 % still rejects every alternative Nγ form (nearest is 4.3 % away) | Pass |
BC-JRC-A33-NG-M2 | EN 1997-1 Annex D Nγ at φ′d (M2) as above | Bond, Schuppener, Scarpelli, Orr — Eurocode 7: Geotechnical Design, Worked examples (JRC / Dublin workshop, 2013), Annex A.3.3 — Tables A.3.1 / A.3.3, p. 112–113 | 27.72 Nγ | 27.7445 | +0.09 % | ± 0.3 % the report evaluated Nq = e^(π tanφ)·tan²(45° + φ/2) with π = 3.14: that reproduces all four printed cells exactly (48.872, 74.804, 23.172, 27.716) and is the whole +0.09…+0.13 % offset (found in our internal review). 0.3 % still rejects every alternative Nγ form (nearest is 4.3 % away) | Pass |
BC-DAS-4.1 | Terzaghi, square footing — cohesion + surcharge terms (the Nγ term is a convention comparison, not reproduced) c′ 20, φ′ 25°, γ 16.5, Df 1.5, B = L = 2 m, square; Das Table 4.1 Nc 25.13, Nq 12.72 | Das, B.M., Principles of Foundation Engineering (Cengage), Ch. 4 — Example 4.1, p. 166 | 968.2 kPa 1.3c′Nc + qNq (printed 653.38 + 314.82) | 968.329 | +0.01 % | ± 0.5 % Das prints q_u from factors rounded to 2–3 significant figures | Pass |
BC-DAS-4.3 | General bearing equation, same footing as Ex 4.1, Vesić/Meyerhof general equation | Das, B.M., Principles of Foundation Engineering (Cengage), Ch. 4 — Example 4.3 | 1373.2 kPa q_u | 1374 | +0.06 % | ± 0.5 % Das prints q_u from factors rounded to 2–3 significant figures | Pass |
BC-DAS-4.5 | Inclined load β = 20° square 1.25 m, c′ 0, φ′ 30°, γ 18, Df 0.7, β 20°; Das Eq. 4.26 / Table 4.3 (Meyerhof 1963) inclination factors — vesic_inclination 'das_general' (ENG-3: the vesic default is now Vesić's own set) | Das, B.M., Principles of Foundation Engineering (Cengage), Ch. 4 — Example 4.5 | 273.66 kPa q_u | 273.801 | +0.05 % | ± 0.5 % Das prints q_u from factors rounded to 2–3 significant figures | Pass |
BC-DAS-4.7 | Eccentric strip, e = 0.2 m strip B 2 m, c′ 0, φ′ 40°, γ 16.5, Df 1.5, e 0.2 m | Das, B.M., Principles of Foundation Engineering (Cengage), Ch. 4 — Example 4.7, p. PDF 217 | 3287.39 kPa q′_u | 3288.22 | +0.03 % | ± 0.5 % Das prints q_u from factors rounded to 2–3 significant figures | Pass |
BC-DAS-4.12 | Eccentric + inclined strip strip B 1.5 m, φ′ 35°, γ 16, Df 1, e 0.15 m, β 20°; Das Eq. 4.26 / Table 4.3 (Meyerhof 1963) inclination factors — vesic_inclination 'das_general' (ENG-3: the vesic default is now Vesić's own set) | Das, B.M., Principles of Foundation Engineering (Cengage), Ch. 4 — Example 4.12 | 461.98 kPa q′_u | 461.671 | −0.07 % | ± 0.5 % Das prints q_u from factors rounded to 2–3 significant figures | Pass |
BC-DAS-SILO | Case study — Bozozuk silo, φ = 0 c_u 23.3, φ 0, γ 18, 7.2 m square, Df 1.52 | Das, B.M., Principles of Foundation Engineering (Cengage), Ch. 4 — Ch. 4 case study (Bozozuk) | 181.8 kPa q_u | 182.503 | +0.39 % | ± 0.5 % Das prints q_u from factors rounded to 2–3 significant figures | Pass |
BC-BOW-4-1 | Terzaghi, φ 30°, B 1.5 m c 20, φ 30°, γ 17.3, Df 1.2, 1.5 m square | Bowles, J.E., Foundation Analysis and Design, 5th ed. (McGraw-Hill, 1996), Ch. 4 — Example 4-1 | 1638.8 kPa q_ult | 1641.21 | +0.15 % | ± 1 % Bowles rounds the N-factors to 2–3 figures | Pass |
BC-BOW-4-2-H | Hansen, submerged tank footing φ 47°, γ 18.62 / γ′ 9.31, GWT at surface, Df 0.5, B 0.5, L 2 | Bowles, J.E., Foundation Analysis and Design, 5th ed. (McGraw-Hill, 1996), Ch. 4 — Example 4-2 (Hansen) | 1812 kPa q_ult | 1817.75 | +0.32 % | ± 1 % Bowles rounds the N-factors to 2–3 figures | Pass |
BC-BOW-4-2-M | Meyerhof (1963), submerged tank footing as Hansen row | Bowles, J.E., Foundation Analysis and Design, 5th ed. (McGraw-Hill, 1996), Ch. 4 — Example 4-2 (Meyerhof) | 2659 kPa q_ult | 2672.7 | +0.52 % | ± 1 % Bowles rounds the N-factors to 2–3 figures | Pass |
BC-BOW-4-5 | Hansen, two-way eccentric 1.8 m square c 20, φ 36°, γ 18, Df 1.8, eB 0.25, eL 0.2, GWT 6.1 m | Bowles, J.E., Foundation Analysis and Design, 5th ed. (McGraw-Hill, 1996), Ch. 4 — Example 4-5 | 5088 kPa q_ult | 5050.17 | −0.74 % | ± 1.5 % Bowles rounds Nq 38 / Nγ 40 in Ex 4-5 (two-way eccentric) | Pass |
BC-BOW-4-7-TOTAL | Meyerhof inclined load — total checked against the book-consistent value, NOT the printed 399.9 kPa (documented source error) c 25, φ 25°, γ 17.5, Df 0.3, 2 m square, θ 18.4° | Bowles, J.E., Foundation Analysis and Design, 5th ed. (McGraw-Hill, 1996), Ch. 4 — Example 4-7 (Meyerhof total); Table 4-1 (inclined-load equation); Table 4-3 (shape factors), p. 248 (PDF 274); Table 4-1 p. 220 (PDF 246); Table 4-3 p. 222 (PDF 248) | 388.723 kPa q_ult with the book's printed factors in its Table 4-1 inclined-load equation (343.96 + 36.27 + 8.50) | 388.002 | −0.19 % | ± 1 % Bowles rounds the N-factors to 2–3 figures | Pass |
BC-BOW-4-7-C | Meyerhof inclined load — cohesion term c·Nc·dc·ic as above | Bowles, J.E., Foundation Analysis and Design, 5th ed. (McGraw-Hill, 1996), Ch. 4 — Example 4-7 (c-term) | 344 kPa c·Nc·dc·ic | 343.294 | −0.21 % | ± 0.5 % printed to 4 s.f. | Pass |
BC-DG-6.1-UND-DA1C1 | Square pad on soft clay, undrained, DA1-C1 c_u 30, φ 0, γ 18, Df 1, B 1.7 m square, GWT at surface | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 586 kN R_d | 586.786 | +0.13 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.1-UND-DA1C2 | Square pad on soft clay, undrained, DA1-C2 (c_u,d = 30/1.4) as above, B 1.7 m | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 433 kN R_d | 433.995 | +0.23 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.1-UND-DA2 | Square pad on soft clay, undrained, DA2 as above, B 2.0 m | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 580 kN R_d | 580.114 | +0.02 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.1-UND-DA3 | Square pad on soft clay, undrained, DA3 as above, B 2.0 m | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 600 kN R_d | 600.686 | +0.11 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.1-DRN-DA1C1 | Square pad, drained, DA1-C1 c′ 5, φ′ 20°, γ 18 / γ′ 8, Df 1, B 1.85 m | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 660 kN R_d | 661.588 | +0.24 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.1-DRN-DA1C2 | Square pad, drained, DA1-C2 as above, B 1.85 m | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 410 kN R_d | 410.474 | +0.12 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.1-DRN-DA2 | Square pad, drained, DA2 as above, B 1.95 m | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 529 kN R_d | 528.021 | −0.19 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.1-DRN-DA3 | Square pad, drained, DA3 as above, B 2.15 m | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.1, p. from PDF 80 | 562 kN R_d | 562.158 | +0.03 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-DG-6.2-DA1C2 | Tower base, eccentric + inclined, DA1-C2 c′ 0, φ′ 35°, γ 20, Df 2, B 5.6 m square, e 2.19 m, H/V 0.182 | Frank, R. et al., Designers' Guide to EN 1997-1 (Thomas Telford, 2004), Ch. 6 — Example 6.2, p. 93 (PDF 87 ff.) | 4330 kN R_d on A′ = 6.83 m² | 4337.21 | +0.17 % | ± 1 % Designers' Guide prints R/A′ and R_d to 3 significant figures | Pass |
BC-NHI-A7 | Pier on sand, AASHTO CWγ = 0.786 φ 36°, γ 17.28, GWT 3.048 m, Df 1.219, B 2.134, L 30.48 | FHWA NHI-06-089 Soils & Foundations Reference Manual Vol. II (2006) — Appendix A.7 | 36609 psf q_ult | 36250.1 | −0.98 % | ± 1 % NHI (2006) reads the depth factor off Table 8-6 as dq ≈ 1.15 (A.7-4). Since W1-D1 (13 Nov 2026) the engine applies AASHTO LRFD 10th (2024) Eq. 10.6.3.1.2a-10, dq = 1 + 2tanφ(1 − sinφ)²·arctan(Df/B) = 1.128 at Df/B = 0.571 (the linear Df/B form gave 1.141, −0.37 %), so the gap to NHI's table read is now −0.98 %: a code revision, not an engine error. Factors Nq 37.8 / Nγ 56.3 are also table-read | Pass |
BC-IS-T1-NC45 | IS 6403 Table 1 Nc at φ = 45° — checked against the corrected value, NOT the printed cell strip, general shear, φ 45° | IS 6403:1981 (First Revision), Cl 5.1.1 Table 1 — Table 1, φ = 45° (printed Nc 138.88), p. 8 (PDF 15) | 133.88 Nc = (Nq − 1)cot φ with the printed Nq 134.88 (Martin exact 133.874) | 133.874 | −4.6e-3 % | ± 0.1 % Table 1 printed to 2 decimals; the cell was cross-checked against Nc = (Nq − 1)cot φ | Pass |
BC-IS-T1-NG30 | IS 6403 Table 1 Nγ at φ = 30° strip, general shear, φ 30° | IS 6403:1981 (First Revision), Cl 5.1.1 Table 1 — Table 1, φ = 30°, p. 8 (PDF 15) | 22.4 Nγ | 22.4025 | +0.01 % | ± 0.1 % Table 1 printed to 2 decimals; the cell was cross-checked against Nc = (Nq − 1)cot φ | Pass |
FE-PRANDTL-SMOOTH | Prandtl strip, Tresca, smooth B 2 m, φ 0, c_u 1, weightless, E 1000, ν 0.49, domain 5 × 3 m, meshes n = 2 / 3 / 4.5 | Potts, D.M. & Zdravković, L., Finite Element Analysis in Geotechnical Engineering Vol. 2 (Thomas Telford, 2001), §6.5.4.2; Martin table in Optum G3 strip-on-sand verification — Prandtl N_c = 2 + π, p. 220–221 | 5.14159 N_c = q_u / c_u | 5.13612 | −0.11 % | ± 0.5 % our acceptance limit for this benchmark: Prandtl 5.14·c_u within 0.5 %; exact solution | Pass |
FE-PRANDTL-ROUGH | Prandtl strip, Tresca, rough as smooth; footing horizontal DOFs fixed | Potts, D.M. & Zdravković, L., Finite Element Analysis in Geotechnical Engineering Vol. 2 (Thomas Telford, 2001), §6.5.4.2; Martin table in Optum G3 strip-on-sand verification — Prandtl N_c = 2 + π, p. 220–221 | 5.14159 N_c = q_u / c_u | 5.1601 | +0.36 % | ± 0.5 % exact for smooth and rough footings (Potts Vol. 2 p. 221); ≤ 0.5 % | Pass |
FE-DAVIS-BOOKER-SMOOTH | Davis & Booker (1973) strip, smooth, c = 1 + 2z kPa B 2 m, φ 0, c = 1 + 2z kPa, weightless, E = 299 + 598z kPa, ν 0.495; p = β[(2+π)c_ref + B·c_inc/4], β 1.27. Reference = the analytic β·[(2+π)c_ref + B·c_inc/4] = 7.7998 kPa from the PDF's eq. 1 and its chart-read β; the PDF itself prints the collapse pressure as "7.8 kN/m²" (p. 4) | PLAXIS Validation KB0110019 (Bentley, 2018), after Davis & Booker (1973) Géotechnique — strip footing, smooth, p. 1–4 | 7.79982 kPa mean collapse pressure | 7.81694 | +0.22 % | ± 1 % our acceptance limit: ≤ 1 % on three meshes, each converged; β is chart-read (Potts Vol. 2 p. 237 caveat) | Pass |
FE-DAVIS-BOOKER-ROUGH | Davis & Booker (1973) strip, rough as smooth, β 1.48. Reference = analytic 1.48·[(2+π) + 1] = 9.0896 kPa (eq. 1); the PDF prints "9.1 kN/m²" (p. 4) | PLAXIS Validation KB0110019 (Bentley, 2018) — strip footing, rough, p. 1–4 | 9.08956 kPa mean collapse pressure | 9.15482 | +0.72 % | ± 1 % gate: ≤ 1 %, three meshes, converged:true | Pass |
FE-COX-CIRCULAR | Cox (1962) smooth rigid circle, axisymmetric R 1 m, E′ 2400, ν′ 0.2, c′ 1.6, φ′ = ψ 30°, γ 16, K0 0.5, domain 4 × 4 m, meshes n = 0.667 / 1 / 1.5; γR/c = 10 → p = 141·c | PLAXIS Validation KB0109995 (Bentley, 2018), after Cox (1962) — circular footing on Mohr–Coulomb, p. 1–3 | 225.6 kPa collapse pressure | 226.204 | +0.27 % | ± 1 % our acceptance limit: ≤ 1 %; 141 printed to 3 s.f. (±0.35 %) | Pass |
FE-REISSNER-NQ | Reissner N_q, weightless c = 0 strip with surcharge smooth strip B 2 m, φ = ψ 30°, c 0, γ 0, q0 10 kPa, E 20 MPa, ν 0.3, default domain, meshes n = 0.667 / 1 / 1.5 | OptumCE, Optum G3 verification — Strip footing on sand (Martin 2005 exact N_q / N_γ) — Martin table, N_q(φ = 30°), p. 4 | 184.011 kPa q_u = N_q·q0 (N_q 18.4011) | 183.403 | −0.33 % | ± 1 % exact for ψ = φ, smooth or rough (Potts Vol. 2 §6.5.4.4 p. 226); 1 % adopted, as for the other exact FE benchmarks | Pass |
FE-NGAMMA-SMOOTH | N_γ strip on cohesionless sand, smooth (c = 0, q = 0) B 10 m, φ = ψ 30°, c 0, γ 16, q0 0, E 20 MPa, ν 0.3, half-model 30 × 15 m, meshes n = 0.667 / 1 / 1.5 | OptumCE, Optum G3 verification — Strip footing on sand (Martin 2005 exact N_q / N_γ) — Martin (2005) exact N_γ(30°), smooth, p. 4–5 | 612.24 kPa q_u = ½γB·N_γ (N_γ 7.65300) | 415.506 | −32.1 % | ± 1 % not an acceptance gate; ≤ 1 % targeted (Optum G3 FELA +1.25 %; Hjiaj bounds 7.6225–8.0784) | Miss |
FE-NGAMMA-ROUGH | N_γ strip on cohesionless sand, rough (c = 0, q = 0) as smooth, rough footing | OptumCE, Optum G3 verification — Strip footing on sand (Martin 2005 exact N_q / N_γ) — Martin (2005) exact N_γ(30°), rough, p. 4–5 | 1180.34 kPa q_u = ½γB·N_γ (N_γ 14.7543) | 1249.39 | +5.85 % | ± 1 % not an acceptance gate; ≤ 1 % targeted (Optum +0.17 %; Hjiaj bounds 14.5671–15.2372) | Miss |
FELA-NGAMMA-SMOOTH | N_γ strip on cohesionless sand, smooth — FE limit analysis: do the lower and upper bounds contain the exact value? B 10 m, φ = ψ 30°, c 0, γ 16, q0 0; recipe mesh (fan, n = 1, 1,040 elements); default N_γ domain | OptumCE, Optum G3 verification — Strip footing on sand (Martin 2005 exact N_q / N_γ) — Martin (2005) exact N_γ(30°), smooth, p. 4–5 | 612.24 kPa q_u = ½γB·N_γ (N_γ 7.65300) | 646.99 | — | ± 0.01 % BRACKET ROW: pass when lower bound ≤ exact ≤ upper bound — the statement the bound theorems make, and the rule the finite-element registry already applies to the same engine (k5c-strip-ngamma rows, "LB ≤ exact ≤ UB"). ± 0.01 % is only the containment precision (Martin's N_γ is printed to 6 significant figures); Δ is not reported because the exact value need not sit at the mean of the bounds. The bracket width is recorded with every measurement and stated in the notes | Pass |
FELA-NGAMMA-ROUGH | N_γ strip on cohesionless sand, rough — FE limit analysis: do the lower and upper bounds contain the exact value? as FELA-NGAMMA-SMOOTH, rough footing | OptumCE, Optum G3 verification — Strip footing on sand (Martin 2005 exact N_q / N_γ) — Martin (2005) exact N_γ(30°), rough, p. 4–5 | 1180.34 kPa q_u = ½γB·N_γ (N_γ 14.7543) | 1200.36 | — | ± 0.01 % BRACKET ROW: pass when lower bound ≤ exact ≤ upper bound — the statement the bound theorems make, and the rule the finite-element registry already applies to the same engine (k5c-strip-ngamma rows, "LB ≤ exact ≤ UB"). ± 0.01 % is only the containment precision (Martin's N_γ is printed to 6 significant figures); Δ is not reported because the exact value need not sit at the mean of the bounds. The bracket width is recorded with every measurement and stated in the notes | Pass |
BC-GEO5-VM02 | GEO5 VM-02 spread footing, 7° terrain slope, DA2 (self-weight favourable) — GEO5's Brinch Hansen standard-analysis factor set 1.80 × 2.20 m, Df 1.20, SM φ′ 31.5°, γ 17.5, N 910, Hy 120, Mx 200, terrain 7°; Hansen with hansen_factor_set 'geo5_reduced' (the manual's own s, d, i set) | Fine, GEO5 Verification Manual No. 2 — Spread Footing (update 03/2016) — case 1 (γG = 1.00), R_d after γR;v 1.40; factor set p. 3–4 ("A standard analysis proposed by J. Brinch Hansen is used"), p. 3–5 | 381.706 kPa R_d / γR;v (hand calc; program 381.92) | 381.919 | +0.06 % | ± 1 % Tolerance ± 1 % (our band for closed-form bearing checks). GEO5 prints a hand calculation (381.706 kPa, every factor rounded to 3 decimals) and its program's value (381.92 kPa), 0.06 % apart; the engine gives 381.919 kPa | Pass |
BC-GEO5-VM02-C2 | GEO5 VM-02 spread footing, 7° terrain slope, DA2 (self-weight unfavourable) — GEO5's Brinch Hansen standard-analysis factor set as BC-GEO5-VM02 with self-weight γG 1.35: e 0.238 m, δ 6.574°; hansen_factor_set 'geo5_reduced' | Fine, GEO5 Verification Manual No. 2 — Spread Footing (update 03/2016) — case 2 (γG = 1.35), R_d after γR;v 1.40, p. 7–9 | 386.501 kPa R_d / γR;v (hand calc; program 386.61) | 386.612 | +0.03 % | ± 1 % Tolerance ± 1 % (our band for closed-form bearing checks). GEO5 prints a hand calculation (386.501 kPa) and its program's value (386.61 kPa), 0.03 % apart; the engine gives 386.612 kPa | Pass |
Cited validation suites — 32
⚑ bearing-capacity-ec7-web-validation.test.ts
`bearing-capacity` — EN 1997-1:2004 Annex D anchored to a PUBLISHED European worked example.
Analyses validated: bearing-capacity · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`bearing-capacity` — EN 1997-1:2004 Annex D anchored to a PUBLISHED European
worked example.
SOURCE
A. J. Bond, B. Schuppener, G. Scarpelli, T. L. L. Orr,
"Eurocode 7: Geotechnical Design — Worked examples",
presented at the Workshop "Eurocode 7: Geotechnical Design", Dublin, 13-14 June 2013.
JRC Scientific and Policy Report, European Commission Joint Research Centre.
Annex A.3 "Worked example to accompany Chapter 3", §A.3.3 "Design of a strip
foundation for bearing resistance", Tables A.3.1 / A.3.2 / A.3.3 (pp. 112-113).
DESIGN SITUATION (§A.3.1, p. 105 and Fig. A.3.11, p. 111)
Strip foundation for a four-storey concrete building. Embedment depth 1.5 m;
groundwater at 1.5 m below ground surface. Soil 1 (0-20 m): medium dense sand,
γ = 18.5 kN/m³, c′ = 0, φ′k = 38°, E′ = 30 MPa. "For no-seismic design situation,
shear forces and bending moments can be assumed to be negligible" — so the load is
vertical and centric.
PUBLISHED VALUES USED AS ANCHORS
The report tabulates the bearing-resistance factors for all four design
approaches. Each factor appears TWICE, independently, because DA1-1 and DA2 share
the M1 material set while DA1-2 and DA3 share M2 — an internal cross-check that
the transcription below is faithful:
material set | γφ′ | φ′d | Nq | Nγ | appears in
M1 | 1.00 | 38.00° | 48.87 | 74.80 | Table A.3.1 (DA1-1), Table A.3.2 (DA2)
M2 | 1.25 | 32° | 23.17 | 27.72 | Table A.3.1 (DA1-2), Table A.3.3 (DA3)
WHAT IS DELIBERATELY NOT ASSERTED FROM THIS TABLE, AND WHY
The same tables publish sq, sγ, Vd and Rd. Those are NOT used as anchors here:
1. The shape factors are mutually inconsistent. Annex D gives sγ = 1 − 0.3(B′/L′),
so sγ fixes B′/L′, which then fixes sq = 1 + (B′/L′)sin φ′. Back-solving each
published row:
DA1-1 sγ = 0.95 ⇒ B/L = 0.1667 ⇒ sq would be 1.103, published 1.04 ✗
DA1-2 sγ = 0.98 ⇒ B/L = 0.0667 ⇒ sq would be 1.035, published 1.04 ✓
DA2 sγ = 0.98 ⇒ B/L = 0.0667 ⇒ sq would be 1.041, published 1.03 ✗
DA3 sγ = 0.98 ⇒ B/L = 0.0667 ⇒ sq would be 1.035, published 1.04 ✓
Two of four rows cannot come from any single B′/L′. Worse, DA1-1 and DA1-2 are
both tabulated at B = 1.5 m yet carry different sγ (0.95 vs 0.98), which is
impossible because sγ depends only on B′/L′. So the shape-factor column contains
an erratum and cannot discriminate a correct implementation from a wrong one.
2. Vd and Rd cannot be reconstructed from the text. Vd includes the foundation
self-weight and the soil above it, and the strip length L appears only inside
Fig. A.3.11 (an image), so the loaded area is not recoverable from the report's
text. Asserting Rd would mean inventing L to make the number come out — which is
the one thing this suite exists to prevent.
The N-factors, by contrast, depend on nothing but φ′d and are published twice each.
They are also the part that actually distinguishes Eurocode 7 from the other
methods, which is the point of the anchor.
DEFECT FOUND (E-37)
Before this test, choosing a Eurocode design approach applied EC7's partial factors
on top of a NON-Eurocode resistance formula: no `BearingMethod` implemented Annex D's
Nγ = 2(Nq − 1)tan φ′. The options were Vesic's 2(Nq + 1)tan φ′ (+4.3 % at M1, +9.1 %
at M2 — over-stating resistance) or Hansen's 1.5(Nq − 1)tan φ′ (−25 %). The error is
LARGER at M2, i.e. on the material-factored combinations (DA1-2, DA3) that usually
size the footing, because the discrepancy is 4/(Nq − 1) in relative terms and Nq
falls as φ′ is reduced. Fixed by adding the `ec7_annex_d` method.
TOLERANCE
0.3 % on the N-factors. The report prints 4 significant figures and its own values
sit 0.09-0.13 % below the closed forms, consistent with rounding of φ′d (it prints
the M2 angle as "32" where tan⁻¹(tan38°/1.25) = 32.0066°). 0.3 % is loose enough to
absorb that and tight enough to reject every alternative Nγ in the engine (the
nearest wrong answer is 4.3 % away).
| Test block (the published value it checks) | Verdict |
| JRC EC7 worked example A.3.3 — M1 material set (γφ′ = 1.00): Nq = 48.87, Nγ = 74.80 | Pass |
| JRC EC7 worked example A.3.3 — M2 material set (γφ′ = 1.25): Nq = 23.17, Nγ = 27.72 | Pass |
| E-37 regression: the OTHER Nγ forms are rejected by this anchor at both material sets | Pass |
| E-37: the M2 Nγ error is LARGER than the M1 error — the discrepancy grows where it matters most | Pass |
| EN 1997-1 Annex D shape factors: sq = 1+(B′/L′)sinφ′, sγ = 1−0.3(B′/L′), sc = (sq·Nq−1)/(Nq−1) | Pass |
| Annex D defines NO depth factors — embedment enters only through the surcharge q′ | Pass |
| E-37: pairing a Eurocode design approach with a non-Annex-D resistance model WARNS | Pass |
| Annex D inclination factors: exact for c′ = 0, and flagged as conservative when c′ > 0 | Pass |
| the Annex D method is labelled and discoverable | Pass |
⚑ bearing-capacity-is6403-web-validation.test.ts
IS 6403:1981 — "Code of Practice for Determination of Bearing Capacity of Shallow Foundations" (First Revision) — validated against the tables printed in the standard.
Analyses validated: bearing-capacity · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
IS 6403:1981 — "Code of Practice for Determination of Bearing Capacity of Shallow
Foundations" (First Revision) — validated against the tables printed in the standard.
Source: `Geo Technical engineering books/is.6403.1981.pdf` (24 pp, BIS Right-To-Information
edition). This is the governing Indian code for `bearing-capacity`, whose default
`design_code` is `IS_6403` and whose default method is `meyerhof_is6403`.
─────────────────────────────────────────────────────────────────────────────
HOW THESE NUMBERS WERE READ — and the OCR error that nearly corrupted them
─────────────────────────────────────────────────────────────────────────────
The PDF's embedded text layer is OCR and is unusable for numbers. It renders Cl 5.1.1 as
"In cue of leDeral sbear failure" and the Table 1 note as "frOID the Table corr~lp"ndID'".
Table 1 was therefore re-read with `pdftoppm -r 400/-r 600` + `tesseract`.
That read was WRONG in one cell, and it took a second check to catch it. At φ = 45° the
full-page OCR reported Nc = 138.88 — and reported it consistently at 400 dpi and at 600 dpi
across three page-segmentation modes, so repetition proved nothing. What caught it was
INTERNAL CONSISTENCY: Table 1 must satisfy Nc = (Nq − 1)·cot φ, and with the printed
Nq = 134.88 that requires Nc = 133.88, not 138.88. Every other row of the table is
self-consistent to ≤ 0.06 %, so a lone 3.7 % outlier is a reading error, not a code erratum.
Re-cropping that single cell and OCR-ing it alone with a digit whitelist at 4× upscale
returned 133.88; the neighbouring Nq cell, used as a control, returned 134.88 as expected.
The standard is correct — a `3` was being read as an `8`.
This is the second time in this audit that a BIS RTI text layer has misreported a digit
(IS 1904 renders 0.0033 as 0.0039). The lesson is recorded in the audit ledger: never trust
a single OCR read, and prefer a check that is independent of the reading — here, the
closed form the table is tabulating — over simply reading it again.
WHAT IS ANCHORED HERE (57 published values):
- Table 1, 33 cells: Nc, Nq, Nγ at φ = 0…50° in 5° steps.
- Table 2, 12 shape-factor values: strip / square / circle / rectangle.
- Table 1 Note, local-shear reduction φ' = tan⁻¹(0.67·tan φ) — 12 values.
| Test block (the published value it checks) | Verdict |
| IS 6403:1981 Table 1 — all 33 published bearing-capacity factors (Nc, Nq, Nγ) | Pass |
| IS 6403:1981 Table 1 is internally consistent — Nc = (Nq−1)·cot φ and Nγ = 2(Nq+1)·tan φ | Pass |
| IS 6403:1981 Table 2 — all 12 published shape factors | Pass |
| IS 6403:1981 Table 1 Note — local shear uses φ′ = tan⁻¹(0.67·tan φ) and c′ = ⅔c | Pass |
| IS 6403:1981 — the code default is IS_6403 with FoS = 3, and qnu/qns follow Cl 6 | Pass |
bearing-capacity-reliability-web-validation.test.ts
PUBLISHED-VALUES: 0 -- distinct published values for this engine (engine-level total, declared once); independent audit A2: each demand is bisected so the reliability equals the tabulated value, so the suite tests the inverse-normal functi…
Analyses validated: bearing-capacity-reliability · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 0 -- distinct published values for this engine (engine-level total, declared once); independent audit A2: each demand is bisected so the reliability equals the tabulated value, so the suite tests the inverse-normal function, not a bearing-capacity prediction (the transcribed table values are authentic). Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Monte-Carlo reliability of the IS-code bearing capacity (`bearing-capacity-reliability.ts`) vs PUBLISHED values.
Every expected number was read from a source opened for this suite:
Baecher, G.B. and Christian, J.T. (2003), Reliability and Statistics in Geotechnical Engineering, Wiley:
Table 13.1 (p. 306), "Probability of failure for various distributions of the performance function" —
the Normal column gives Pf for reliability index β = 0.0, 0.5, … , 5.0.
Look, B.G. (2007), Handbook of Geotechnical Investigation and Design Tables, Taylor & Francis:
Chapter 10 "Material and testing variability": Table 10.1 (friction angle of sand, COV 12 %, attributed
there to Harr), Table 10.2 (effective-stress friction angle, mean COV 12.6 %, attributed there to Kulhawy)
and Table 10.5 (effective angle of friction, COV range 5-15 %, estimated mean 10 %, attributed there to
Phoon and Kulhawy).
WHAT THESE CHECK, AND WHAT THEY DO NOT.
• β = Φ⁻¹(P[SBC ≥ demand]). The engine reports β next to the Monte-Carlo reliability. For each tabulated β the
demand is pre-selected (by bisection, offline) so the seeded 20 000-draw run passes almost exactly the tabulated
fraction 1 − Pf; the SETUP assertion confirms the reliability is where it was planned to be, and the
assertion that counts is the engine's β against the printed table. Reliability resolution is one draw in 20 000,
so the tolerance on β is the 0.01 print plus 1.5/20 001 divided by the normal density at β (the discretisation).
• The COV assertions use the published COV values as INPUTS and check that the sampled φ carries that COV. That
verifies the engine applies the published numbers correctly; it does not validate the engine's prediction.
• NOT VALIDATED HERE: the SBC percentiles, the reliability and the deterministic SBC for a soil profile. No worked
example in the reference library propagates an SPT-derived φ distribution through the IS-code bearing equation; the
bearing-capacity examples in Baecher and Christian (2003) (§15.7, §18) use empirical Nγ regressions and FOSM
with different inputs and are not comparable. Those outputs stay regression-protected, not published-answer-backed.
| Test block (the published value it checks) | Verdict |
| Baecher and Christian (2003) Table 13.1 — reliability index against probability of failure (Normal column) | Pass |
| Baecher and Christian (2003) Table 13.1 — the tails: 100 % and 0 % of 20 000 draws passing | Pass |
| Look (2007) Tables 10.1, 10.2 and 10.5 — published COV of the friction angle applied by the sampler | Pass |
| the default COV lies inside the published 5-15 % range, and a COV outside [0, 2] is refused | Pass |
bearing-capacity-web-validation.test.ts
WEB-BENCHMARK validation for the shallow-foundation bearing-capacity engine (the release rules mandatory ≥20 cited-value gate).
Analyses validated: bearing-capacity · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the shallow-foundation bearing-capacity engine
(the release rules mandatory ≥20 cited-value gate). Every value below is a PUBLISHED
bearing-capacity factor from a primary source, reproduced in the standard
textbook tables and in the on-disk reference library:
• Prandtl (1921) / Reissner (1924) — Nc = 2+π = 5.14 and Nq = e^{π·tanφ}·tan²(45+φ/2)
for φ=0 undrained clay; the exact plasticity solution used by Meyerhof/Hansen/Vesic.
• Terzaghi (1943) — Terzaghi factors; reproduced in Das, *Principles of Foundation
Engineering*, Table 3.1 (and Bowles Table 4-2).
• Meyerhof (1963), Canadian Geotech. J. 1:16 — Nq, Nc (Prandtl form).
• Hansen (1970) Bull. 28 — Nγ = 1.5(Nq−1)tanφ.
• Vesic (1973) JSMFD 99(SM1) — Nγ = 2(Nq+1)tanφ; reproduced in Das Table 4.3.
These are the canonical, universally-published factors (identical across IS 6403,
EC7 and AASHTO — the code differs only in the SAFETY convention, verified separately).
Our engine reproduces each within a tight tolerance (values are table-rounded to 2 dp).
| Test block (the published value it checks) | Verdict |
| BC web 1–9: Nq at φ=5..45 (Prandtl/Vesic 1973, Das Table 4.3) | Pass |
| BC web 10–14: Nc at φ=0,10,20,30,40 (Prandtl/Vesic 1973) | Pass |
| BC web 15–19: Vesic Nγ at φ=20,25,30,35,40 (Vesic 1973) | Pass |
| BC web 20–22: Hansen Nγ at φ=20,30,40 (Hansen 1970) | Pass |
| BC web 23–29: Terzaghi Nc & Nq at φ=0,20,30,35,40 (Terzaghi 1943, Das Table 3.1) | Pass |
⚑ bearing-capacity-worked-examples-web-validation.test.ts
bearing-capacity — FULL WORKED EXAMPLES (the ≥20-value gate, end-to-end q_ult / R_d rather than factor tables; the factor tables are `bearing-capacity-web-validation.test.ts`).
Analyses validated: bearing-capacity · Recorded run: passed — 32 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
bearing-capacity — FULL WORKED EXAMPLES (the ≥20-value gate, end-to-end q_ult / R_d rather
than factor tables; the factor tables are `bearing-capacity-web-validation.test.ts`).
Every expected value is PRINTED in the cited source, read 2026-09-27 from
`Geo Technical engineering books/`. Inputs are the source's own; where the source states a
convention (γ′, the water-table treatment, a design approach) that convention is passed as an
input, never tuned to the answer.
[DAS] Das, Principles of Foundation Engineering (Cengage): Examples 4.1, 4.3, 4.4, 4.5, 4.7,
4.12 and the Ch. 4 case studies (Bozozuk silo; Bangkok clay footings). Das prints q_u to
0.01–1 kPa from factors rounded to 2–3 figures → tolerance 0.5 % (1.5 % for Terzaghi,
whose Nγ has no closed form: Das 8.34, Bowles 9.7, the engine's Coduto fit 9.18 at 25°).
[BOW] Bowles, Foundation Analysis and Design 5e: Ex 4-1, 4-2, 4-3, 4-5, 4-7. Bowles rounds
factors to 2–3 figures (e.g. Nq 38, Nγ 40 in Ex 4-5) → 1–1.5 %.
[DG] Frank et al., Designers' Guide to EN 1997-1, Ex 6.1 (undrained + drained pad) and
Ex 6.2 (eccentric, inclined tower base) — R/A′ and R_d per design approach, printed to
3 figures → 1 %.
[NHI] FHWA NHI-06-089 Soils & Foundations Vol II, Ex 8-1 (factors) and App. A.7 (pier on
sand, CWγ = 0.786) — 1 %.
[GEC6] FHWA-SA-02-054 GEC 6, App. B Example 1: CWγ = 0.9 (printed, rounded from 0.878).
Book inconsistencies found and NOT used as expected values: Bowles Ex 4-7's Meyerhof total
(399.9) applies sq = sγ = 1.25 although Bowles Table 4-1's inclined-load Meyerhof equation has
no shape factors — only its cohesion term (344.0, shape-free) is compared.
| Test block (the published value it checks) | Verdict |
| [DAS] Ex 4.1 Terzaghi square, c′ 20, φ′ 25°, γ 16.5, Df 1.5, B 2 → q_u = 1078.29 kPa | Pass |
| [DAS] Ex 4.3 general equation, same footing → q_u = 1373.2 kPa | Pass |
| [DAS] Ex 4.4 water above the base (effective stress), B = 4.5 ft → q_u = 3·q_all = 1080 kPa | Pass |
| [DAS] Ex 4.5 inclined load β = 20°, square 1.25 m, φ′ 30°, Df 0.7 → q_u = 273.66 kPa | Pass |
| [DAS] Ex 4.7 eccentric strip e = 0.2 m → q′_u = 3287.39 kPa | Pass |
| [DAS] Ex 4.7 → Q_u = q′_u·B′ = 5260 kN/m | Pass |
| [DAS] Ex 4.12 eccentric + inclined strip → q′_u = 461.98 kPa | Pass |
| [DAS] case study — Bozozuk silo, φ = 0, c_u 23.3, 7.2 m square, Df 1.52 → q_u = 181.8 kPa | Pass |
| [DAS] case study — Bangkok clay, c_u 14.4, Df 1.5, B = 0.6 m → q_u(theory) = 158.3 kPa | Pass |
| [DAS] case study — Bangkok clay, c_u 14.4, Df 1.5, B = 0.675 m → q_u(theory) = 156.8 kPa | Pass |
| [DAS] case study — Bangkok clay, c_u 14.4, Df 1.5, B = 0.75 m → q_u(theory) = 155.4 kPa | Pass |
| [DAS] case study — Bangkok clay, c_u 14.4, Df 1.5, B = 0.9 m → q_u(theory) = 152.6 kPa | Pass |
| [DAS] case study — Bangkok clay, c_u 14.4, Df 1.5, B = 1.05 m → q_u(theory) = 150.16 kPa | Pass |
| [BOW] Ex 4-1 Terzaghi, φ 20°: q_ult = 613.8 + 34.6·B at B = 1.5 m | Pass |
| [BOW] Ex 4-1 Terzaghi, φ 30°, B = 1.5 m → q_ult = 1638.8 kPa | Pass |
| [BOW] Ex 4-2 Hansen (sq = 1 + B/L·sin φ = 1.18) → q_ult = 1812 kPa | Pass |
| [BOW] Ex 4-2 Meyerhof (Nγ = 414) → q_ult = 2659 kPa | Pass |
| [BOW] Ex 4-3 Hansen φ = 0: 5.14·s_u·(1 + s′c + d′c) = 15.6 t/m² (q neglected) | Pass |
| [BOW] Ex 4-5 Hansen, two-way eccentric 1.8 m square → q_ult = 5088 kPa | Pass |
| [BOW] Ex 4-7 Meyerhof inclined (θ = 18.4°): cohesion term c·Nc·dc·ic = 344.0 kPa | Pass |
| [DG] Ex 6.1 undrained DA1-C2 (c_u,d = 30/1.4): R/A′ = 150 kPa, R_d = 433 kN | Pass |
| [DG] Ex 6.1 undrained DA1-C1: R/A′ = 203 kPa, R_d = 586 kN | Pass |
| [DG] Ex 6.1 undrained DA2, B = 2.0 m → R_d = 580 kN | Pass |
| [DG] Ex 6.1 undrained DA3, B = 2.0 m → R_d = 600 kN | Pass |
| [DG] Ex 6.1 drained DA1-C2, B 1.85 (γ′ = 8, q′ = 8) → R/A′ = 120 kPa, R_d = 410 kN | Pass |
| [DG] Ex 6.1 drained DA1-C1, B 1.85 → R/A′ = 193 kPa, R_d = 660 kN | Pass |
| [DG] Ex 6.1 drained DA2, B 1.95 → R_d = 529 kN | Pass |
| [DG] Ex 6.1 drained DA3, B 2.15 → R/A′ = 121.5 kPa, R_d = 562 kN | Pass |
| [DG] Ex 6.2 tower DA1-C2: e = 2.19 m on B = 5.6 m, H/V = 0.182 → R/A′ = 637 kPa, R_d = 4330 kN (on A′ = 6.83 m²) | Pass |
| [NHI] App. A.7 pier on sand, AASHTO CWγ = 0.786 → q_ult = 36 609 psf | Pass |
| [NHI] Ex 8-1 water table at the base halves the weight term: 2025 → 1014 psf | Pass |
| [GEC6] App. B Ex 1: B = 6 m, Df 2.3 m, water 9.1 m → CWγ ≈ 0.9 (1.5·B influence depth) | Pass |
⚑ combined-footing-web-validation.test.ts
Rectangular combined footing proportioned for uniform soil pressure (`combined-footing.ts`) vs PUBLISHED worked examples.
Analyses validated: combined-footing · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Rectangular combined footing proportioned for uniform soil pressure (`combined-footing.ts`) vs PUBLISHED
worked examples. Every expected number was read from a source opened for this suite:
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage Learning:
Example 8.1 (rectangular combined footing, p. 357) and Example 8.2 (resultant and area, p. 357-358).
Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012):
Example 2.2 (layout of a combined footing, p. 44-45): resultant, position and area.
NPTEL (2006), Design of Reinforced Concrete Structures, Module 11 "Foundations - Theory and Design", Lesson 29,
IIT Kharagpur (Version 2 CE), Problem 5 (combined footing, column C1 flush with the property line,
columns 3.0 m apart; https://archive.nptel.ac.in/content/storage2/courses/105105104/pdf/m11l29.pdf, read 2026-10-07).
Baban, T.M. (2016), Shallow Foundations: Discussions and Problem Solving, Wiley:
Problem 5.16(A) (rectangular combined footing on working and factored loads, p. 552-553) and
Problem 5.13 (resultant R, distance x′, and the conclusion that a rectangular footing cannot be used
where the footing may not extend past the interior column, p. 520-521).
MAPPING. The engine's column 1 is the one nearer the footing edge whose distance e1 is given; the footing
is centred on the resultant: L = 2(e1 + P2·s/R), B = (R/q)/L. Das's Figure 8.1 names L2 (edge to column 1)
and L3 (column spacing), so e1 = L2 and s = L3. Loads enter in kN, pressures in kPa.
TOLERANCES. Each book rounds X before doubling it (Das: X = 1.95, L = 2(1.5 + 1.95) = 6.9), so the
length and everything built on it carries the doubled rounding; every call site states its bound.
WHAT IS NOT ASSERTED, AND WHY.
• Bowles 5e Example 9-1 locates the resultant with the column MOMENTS included (Rx = M1 + M2 + ΣPu·u,
x = 2.948 m); this engine takes axial loads only, so that example is a different problem.
• Baban Problem 5.12 likewise includes column moments.
• Baban Problem 5.16 prints B = 1.225 m = 8.33/6.8, dividing an area found from WORKING loads by a length
found from FACTORED loads; the engine uses one load set for both, so B is not asserted.
• Varghese Example 2.2 settles on a trapezoidal footing (L = 3.6 m); only the quantities common to the
rectangular method (R, resultant position, area) are asserted.
| Test block (the published value it checks) | Verdict |
| Das Example 8.1 — Q1 = 400 kN, Q2 = 500 kN, qnet = 140 kN/m², L3 = 3.5 m, L2 = 1.5 m | Pass |
| Das Example 8.2 — Q1 = 1000 kN, Q2 = 400 kN, qnet = 120 kN/m², L3 = 3 m: area and resultant | Pass |
| Varghese Example 2.2 — 180 kN and 360 kN columns 2.1 m apart, safe bearing capacity 100 kN/m² | Pass |
| NPTEL Lesson 29 Problem 5 — C1 400 × 400 (800 kN) flush with the property line, C2 300 × 500 (1200 kN), 3.0 m apart, qc = 200 kN/m² | Pass |
| Baban Problem 5.16(A) — working loads 550 + 700 kN, net qa = 150 kPa | Pass |
| Baban Problem 5.16(A) — factored loads 800 + 960 kN give L = 2X = 6.8 m | Pass |
| Baban Problem 5.13 — interior column with no room beyond it: a rectangular footing is not possible | Pass |
⚑ compensated-foundation-web-validation.test.ts
Compensated (floating) foundation — net pressure q_net = q_gross − γ·Df and degree of compensation (`compensated-foundation.ts`) vs PUBLISHED worked examples.
Analyses validated: compensated-foundation · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Compensated (floating) foundation — net pressure q_net = q_gross − γ·Df and degree of compensation
(`compensated-foundation.ts`) vs PUBLISHED worked examples. Every expected number was read from a source
opened for this suite:
Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012):
Example 18.1 (partially compensated raft: 150 − 20 × 4.5 = 60 kN/m², p. 337-338) and
Example 18.2 (fully compensated: d = 150/20 = 7.5 m, p. 339).
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage Learning:
§8.7 Compensated Foundation (q = Q/A − γDf; Df = Q/(Aγ) for a fully compensated mat) and Example 8.6
(net load 200 × 10³/(30 × 40) − 15.72 × 2 = 135.2 kN/m², p. 367).
Baban, T.M. (2016), Shallow Foundations: Discussions and Problem Solving, Wiley:
Problem 2.1(c) (p. 112), Problem 4.1 (p. 316-317) and Problem 4.3 (p. 318-319), each deducting the
EFFECTIVE overburden pressure σo from the gross effective foundation pressure.
FHWA-NHI-06-089 (2006), Soils and Foundations Reference Manual, Volume II (US customary units):
Example 8-2 (Δp = 2,000 psf − 3 ft × 115 pcf = 1,655 psf, p. 8-48) and Appendix A.7
(Δp = 6,000 psf − 4 ft × 110 pcf = 5,560 psf; Δp = 6,300 psf − 10 ft × 130 pcf = 5,000 psf).
HOW THE INPUTS MAP.
• The engine subtracts γ·Df with one unit weight. Where a book's overburden pressure is built from layers
or from the submerged weight (Baban), the equivalent unit weight σo/Df is entered, so the relief is the
printed σo and the net pressure is the printed net pressure. The gross pressure is the book's printed
(effective) foundation pressure in every case.
• The FHWA examples are in psf/pcf/ft. They are converted with the exact factors (1 psf = 0.04788026 kPa,
1 pcf = 0.1570875 kN/m³, 1 ft = 0.3048 m) and the result is converted back, so the comparison is in the
book's own whole-psf print (±0.5 psf).
WHAT IS NOT ASSERTED. The engine labels a 60 % relief "Largely compensated"; Varghese Example 18.1 calls the
same case a "partially compensated foundation". Those are different vocabularies for the same number, not a
disagreement about the number, so the label is not compared. Das Example 8.5 (factor of safety 5.36) is a
bearing-capacity result the engine does not compute.
| Test block (the published value it checks) | Verdict |
| Varghese Example 18.1 — ten-storey raft, 150 kN/m² gross, excavated 4.5 m in clay of 20 kN/m³ | Pass |
| Varghese Example 18.2 — the same building as a floating foundation: d = 150/20 = 7.5 m | Pass |
| Das Example 8.6 — 30 × 40 m mat, Q = 200 × 10³ kN, Df = 2 m, γ = 15.72 kN/m³ | Pass |
| Baban Problem 2.1(c) — 40 × 80 m mat, 10 m deep, water table at 5 m | Pass |
| Baban Problem 4.1 — silo on a 22.5 × 60 m mat, 3 m deep, clay of 17.5 kN/m³ with the water table at ground level | Pass |
| Baban Problem 4.3 — square footing 4.5 m deep in saturated clay, water table at the surface | Pass |
| FHWA-NHI-06-089 Example 8-2 — Δp = 2,000 psf − 3 ft × 115 pcf | Pass |
| FHWA-NHI-06-089 Appendix A.7 — Δp = 6,000 psf − 4 ft × 110 pcf | Pass |
| FHWA-NHI-06-089 Appendix A.7 embankment footing — Δp = 6,300 psf − 10 ft × 130 pcf | Pass |
⚑ eccentric-footing-pressure-web-validation.test.ts
Contact pressure under an eccentrically loaded footing (`eccentric-footing-pressure.ts`) vs PUBLISHED worked examples.
Analyses validated: eccentric-footing-pressure · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Contact pressure under an eccentrically loaded footing (`eccentric-footing-pressure.ts`) vs PUBLISHED
worked examples. Every expected number was read from a source opened for this suite:
Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012):
Example 2.1 (p. 44), Example 7.1 (p. 141-142), Example 7.3 (p. 144), Example 7.4 (p. 144-145),
Example 7.5 (p. 146), Example 7.6 (p. 147).
Baban, T.M. (2016), Shallow Foundations: Discussions and Problem Solving, Wiley:
Problem 2.2 (p. 112-113), Problem 2.3 cases 1(a)-(c) (p. 113-115), and the Eurocode-7 strip-footing
example of Chapter 6 (combinations 1-3, p. 690-693) which exercises BOTH branches of the engine
(resultant inside the middle third and outside it).
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage Learning:
Example 4.7 (Meyerhof effective width B′ = B − 2e, p. 195); §4.10 prints the beyond-kern
relation qmax = 4Q/[3L(B − 2e)].
CONVENTION. The engine's moment acts about the B axis, so e = M/Q is measured along B. For the
published strip/wall examples L = 1 m (a metre run) and loads are per metre. In Baban Problem 2.3 the
mat loads are given in MN; here they are entered in kN (×1000) so the pressures come out in kPa.
TOLERANCES follow each book's own rounding: an eccentricity printed to 3 d.p. moves 6e/B·q_avg by up to
0.3 kPa on a 145 kPa average, etc.; each call site states its own bound.
READINGS THAT ARE DELIBERATELY NOT ASSERTED (each is an arithmetic slip in the book, shown so the gap
is visible rather than hidden):
• Varghese Example 7.3 prints "111 ± 34 = 144 and 77 kN/m²". 111 + 34 = 145, and the printed pair
averages 110.5, not the 111 it started from; the engine returns 145.2. Only the 77 is asserted.
• Baban Problem 2.3 case 1(c) prints qmax = 141.62 kPa beside qmin = 57.49 kPa. Those sum to 199.11,
but twice the stated average pressure is 2 × 99.73 = 199.47; qmax = 141.98 (engine 141.97). The qmin
is asserted, the qmax is not.
| Test block (the published value it checks) | Verdict |
| Varghese Example 2.1 — 2.6 × 2.6 m footing, 600 kN with 100 kN·m | Pass |
| Varghese Example 7.1 — effective dimensions of the 2 × 2 m footing (600 kN, Mx = 180, My = 60) | Pass |
| Varghese Example 7.3 — retaining-wall base, 433 kN/m on 3.9 m, load 1.75 m from the toe | Pass |
| Varghese Example 7.4 — 3.3 × 3.3 m footing, 300 kN with 150 kN·m | Pass |
| Varghese Example 7.5 — the same footing, conventional pressures 27.5 ± 25 kN/m² | Pass |
| Varghese Example 7.6 — layout for uniform pressure: B′ = 2.3 m and 131 kN/m² | Pass |
| Baban Problem 2.2 — strip footing 1.5 m wide, V + Wf = 218 kN/m, My = 40 kN·m/m | Pass |
| Baban Problem 2.3 — mat 50 × 75 m under six grain silos, three one-way cases | Pass |
| Baban Chapter 6 (EC7) strip footing 6.5 × 2 m — combination 1: resultant inside the middle third | Pass |
| Baban Chapter 6 (EC7) strip footing — combination 2: resultant OUTSIDE the middle third | Pass |
| Baban Chapter 6 (EC7) strip footing — combination 3 | Pass |
| Das Example 4.7 (effective width) and the §4.10 beyond-kern relation | Pass |
⚑ equivalent-raft-web-validation.test.ts
Equivalent-raft pile-group settlement (`equivalent-raft.ts`) vs PUBLISHED values.
Analyses validated: equivalent-raft · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Equivalent-raft pile-group settlement (`equivalent-raft.ts`) vs PUBLISHED values. Every expected number
was read from a source opened for this suite:
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage Learning:
§9.26 and Example 9.23 (pile group in clay, 2V:1H from 2L/3: Δσ′ = Qg/[(Bg+z)(Lg+z)]).
Tomlinson, M. and Woodward, J. (2015), Pile Design and Construction Practice, 6th ed., CRC Press:
Examples 5.1-5.4 (equivalent-raft depth, dimensions and base pressure; oedometer products).
Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012):
Example 4.7 (settlement of a pile foundation in clay, p. 93-94).
FHWA-SA-02-054 (2002), Geotechnical Engineering Circular No. 6, Shallow Foundations:
Appendix B Example 2, Table B2-3 and Eqn. 5-17 (2-on-1 stress ratio Δσv/q).
IRC:78-2014, Standard Specifications and Code of Practice for Road Bridges, Section VII:
Cl. 709.3.4.2 and 709.3.4.3 (raft one third of the pile length above the toe for friction piles,
at the toe for end-bearing piles, 2 (vertical) : 1 (horizontal) spread).
WHAT THE ENGINE COMPUTES AND HOW EACH PUBLISHED NUMBER IS REACHED.
raft depth = (2/3)·D (friction) or D (end bearing); q_eq = Q/(Bg·Lg);
Δσ′ = Q/[(Bg+z)(Lg+z)] at z = H/2; s = mv·Δσ′·H.
• The engine measures z to the MID-HEIGHT of ONE compressible layer that starts at the raft. A published
stress at some depth z is therefore read by entering a layer thickness H = 2z (this changes only which
depth is reported; the stress formula is the published one). Das's layers 2 and 3 do not start at the
raft, so they are read this way; it is stated at each call.
• The settlement step s = mv·Δσ′·H is checked only against Tomlinson's printed oedometer products, with
the published σz supplied by back-solving Q (Tomlinson takes σz from Boussinesq influence charts, not
from a 2:1 spread, so the stress is the book's, the product is the engine's).
NOT ASSERTED (recorded so the gap is visible):
• Varghese Example 4.7 prints the stress at the top of the raft as "400/(1.2)² = 228 kN/m²"; 400/1.44 is
277.8 — a slip in the book — so the printed top stress and the average 125.35 that depends on it are not used.
• Varghese Example 4.7 and Das Example 9.23 settle the clay with Cc·log(…), which this engine does not
implement (it is an mv model), so their final settlements are not comparable.
| Test block (the published value it checks) | Verdict |
| Das Example 9.23 — Qg = 2000 kN, Lg = 3.3 m, Bg = 2.2 m, 15 m piles | Pass |
| Varghese Example 4.7 — nine 200 mm friction piles, 400 kN, 6 m of pile in clay | Pass |
| Tomlinson Example 5.1 — friction piles, 13.90 m, equivalent raft 10.5 × 13.8 m | Pass |
| Tomlinson Example 5.2 — piles 7 m into sand below the seabed, raft 10.4 × 9.1 m | Pass |
| Tomlinson Example 5.3 — 20 × 15 piles of 900 kN, raft 35.4 × 27.4 m | Pass |
| Tomlinson Example 5.4 — 12-storey building, raft 52.25 × 22.25 m: pressure and oedometer products | Pass |
| FHWA GEC 6 Table B2-3 — 2-on-1 stress increase Δσv/q for Lf = 25.0 m | Pass |
| IRC:78-2014 Cl. 709.3.4 — raft position for friction and end-bearing piles (clause-rule check, not a worked answer) | Pass |
fe-bearing-capacity-hs-web-validation.test.ts
WEB-BENCHMARK validation for the HARDENING-SOIL stress-dependent stiffness option of the FE bearing-capacity engine.
Analyses validated: fe-bearing-capacity, hardening-soil · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the HARDENING-SOIL stress-dependent stiffness option of the
FE bearing-capacity engine. HS's defining feature vs Mohr-Coulomb is that the elastic
stiffness is NOT constant: E(σ₃) = E_ref·((c·cosφ + σ₃·sinφ)/(c·cosφ + p_ref·sinφ))^m, so
stiffness grows with confinement/depth (Schanz,
Vermeer & Bonnier 1999; Janbu 1963 σ-dependent modulus).
The physically-exact anchors (no external numeric worked example needed — these are
consequences of the formulation itself, each independently checkable):
1. EXACT REDUCTION — m=0, or φ=0, or no confining gradient (γ=0 & q_s=0) ⇒ the per-GP D
collapses to the constant D, so q_ult AND settlement are IDENTICAL to the MC engine.
2. STRENGTH-GOVERNED COLLAPSE — the collapse load q_ult depends on strength (c, φ), NOT
stiffness. Turning HS stiffness on must leave q_ult essentially unchanged (Prandtl/Vesić).
3. POWER-LAW EXACTNESS — for a uniform-confining case (γ=0, q_s>0) every GP has the same σ₃,
so E is uniform and equals E·((c·cosφ+K0·q_s·sinφ)/(c·cosφ+p_ref·sinφ))^m — the SAME law
our `hardening-soil` SoilTest uses. Cross-checked against computeHardeningSoil.stiffAt.
4. MONOTONICITY — with γ>0 the deepest GP is stiffest: E_max > E_min, and the spread widens
with m and with γ.
5. SETTLEMENT PHYSICS — a larger m (stronger σ-dependence) changes the service settlement.
| Test block (the published value it checks) | Verdict |
| FE-HS REDUCTION: m=0 ≡ constant-E MC engine (q_ult + settlement identical) | Pass |
| FE-HS REDUCTION: φ=0 undrained ⇒ HS stiffness inert (identical to MC) | Pass |
| FE-HS STRENGTH: q_ult is stiffness-independent (HS on ≈ off within 5%) | Pass |
| FE-HS POWER-LAW: uniform confining E matches the HS SoilTest power law | Pass |
| FE-HS MONOTONIC: E grows with depth; spread widens with m | Pass |
| FE-HS WEB: loose Hostun sand E(σ₃) matches published HS power law (4 cases) | Pass |
| FE-HS WEB: dense Hokksund sand E(σ₃) matches published HS values (4 cases) | Pass |
| FE-HS WEB: Vesić Nc/Nq/Nγ match the published closed form (φ = 0,20,25,30,35°) | Pass |
| FE-HS SETTLEMENT: HS stiffness changes the service settlement (finite, sane) | Pass |
fe-bearing-capacity-web-validation.test.ts
fe-bearing-capacity — validation against PUBLISHED values, every number traced to a source.
Analyses validated: fe-bearing-capacity · Recorded run: passed — 16 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
fe-bearing-capacity — validation against PUBLISHED values, every number traced to a source.
Named `-web-validation` to match the repo convention that marks a published-value suite (see
the release rule's "≥20 real, cited validation values" gate). The provenance here is stronger than the
name suggests: every value is read out of the local reference library, not off a web page.
This engine had no published anchor for its frictional path. It had a φ=0 Prandtl check
(5.14·c_u) and a comparison against its own Vesić superposition, which is not a validation —
comparing an engine to a formula it also computes tells you nothing about either. E-76 survived
for exactly that reason: q_ult was 9× low and the only signal was a percentage against a
reference the reader was invited to distrust.
Sources, all from `Geo Technical engineering books/`:
[PZ2] Potts, D.M. & Zdravković, L. — *Finite Element Analysis in Geotechnical Engineering:
Application* (Vol 2), §6.5.4 "Shallow foundations", Figures 6.21–6.24, Tables 6.1–6.2.
[SGM] Smith, I.M., Griffiths, D.V. & Margetts, L. — *Programming the Finite Element Method*
5e, §6.6, Program 6.3 worked example (p. 259–260).
[MAR] Martin, C.M. (2004) — method of characteristics, quoted by [SGM] as the exact solution
for the Program 6.3 problem.
[PR] Prandtl (1920) / Reissner (1924) — the exact closed forms, quoted as Eq (6.6)/(6.7)
in [PZ2] §6.5.4.4.
The engine runs a NON-ASSOCIATED flow rule (ψ=0), which is the realistic choice for soil and is
what makes these comparisons meaningful rather than circular: [PZ2] published FE results for
ψ=0 AND ψ=φ′ on the same problem, so the dilation effect is separable and citable.
| Test block (the published value it checks) | Verdict |
| [PZ2] Table 6.1: Nq(φ′=25°) with ψ=0 — published FE 9.92 (rough) / 10.0 (smooth) | Pass |
| [PZ2] §6.5.4.4: the ultimate Nq is independent of the surcharge magnitude | Pass |
| [SGM]/[MAR]: the combined c-φ-γ case lands within 15% of the EXACT characteristics solution | Pass |
| E-77: the classical SUPERPOSITION is not a reliable yardstick — measured, both signs cited | Pass |
| [PR] Prandtl: Nc → 5.142 monotonically with refinement | Pass |
| [PR] Reissner: Nq is reproduced by the engine’s own closed form across φ′ | Pass |
| the ψ=0 reduction deepens with φ′ and matches [PZ2] at the one φ′ they publish | Pass |
| [PZ2] Table 6.2: Nγ is UNDER-predicted — pinned as a known gap, not a passing check | Pass |
| E-80 / D181: the self-weight part is DISCLOSED on every run that has one, with its measured share | Pass |
| E-79 REGRESSION: the pure-Nγ configuration is not falsely refused | Pass |
| D181: the pure-Nγ surface case is flagged NOT mesh-converged, with the measured cause | Pass |
| E-80: with confinement the capacity is surcharge-dominated and tracks the exact Nq | Pass |
| D175 [BOW]: at zero NET footing pressure the settlement is 0 — q = q_s with a surcharge, q → 0 without | Pass |
| D175: the page-default settlement is the footing-induced part only — value and derivation | Pass |
| D175: the K0 procedure has no geostatic phase to run, and a failed geostatic phase refuses LOUDLY | Pass |
| D175 user-visible text: plain English, no em dash, no internal issue code, no competitor product name | Pass |
fe-footing-bvp-web-validation.test.ts
Validation for the 2-D plane-strain FOOTING bearing-capacity FE BVP with the Mohr-Coulomb + Hardening-Soil-stiffness material (`fe-footing-bvp.ts`) — the advanced-constitutive continuum solve that closes the "HS in a 2-D FE" gap.
Analyses validated: footing-bearing-fe · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the 2-D plane-strain FOOTING bearing-capacity FE BVP with the
Mohr-Coulomb + Hardening-Soil-stiffness material (`fe-footing-bvp.ts`) — the
advanced-constitutive continuum solve that closes the "HS in a 2-D FE" gap.
the release rules ≥20-cited-value gate. Every anchor traces to a published source:
- Prandtl (1921) / Reissner (1924): smooth strip footing on a weightless φ=0
half-space ⇒ q_ult = (2+π)·s_u = 5.14·s_u.
- Vesić (1973): bearing-capacity factors N_c, N_q, N_γ = 2(N_q+1)tanφ (the
published table, reproduced exactly by bearingCapacityFactors) — 13 anchors.
- Terzaghi (1943): q_ult = c·N_c + q₀·N_q + ½γB·N_γ (strip).
- Smith & Griffiths "Programming the FEM" Ch.6: a displacement-controlled FE
footing reaches the Prandtl load from ABOVE on a coarse mesh and converges
down to it as the mesh refines (documented mesh-dependence).
- Schanz, Vermeer & Bonnier (1999): HS stress-dependent stiffness E(σ₃).
The FE is a coarse-mesh continuum estimate: it over-reads the exact limit by a
known, monotonically-shrinking margin (≈+14% at 16², +9% at 20², +7% at 24²).
Anchors assert the correct MECHANICS (linear in s_u, the Vesić trend, mesh
convergence toward the limit) AND the absolute within the coarse-mesh band —
not a tolerance the method cannot honestly meet. Solves are kept small so the
suite stays fast.
| Test block (the published value it checks) | Verdict |
| Vesić (1973) bearing-capacity factors N_c, N_q, N_γ — published table (13 anchors) | Pass |
| Prandtl (1921): φ=0 strip footing q_ult = 5.14·s_u (FE within the coarse-mesh band) | Pass |
| Prandtl: q_ult scales LINEARLY with s_u (correct undrained mechanics) | Pass |
| Smith & Griffiths: FE bearing capacity converges toward the Prandtl limit as the mesh refines | Pass |
| Vesić (1973): frictional footing q_ult follows c·N_c + q₀·N_q (φ = 30°) | Pass |
| load–settlement curve is monotone rising to the plateau | Pass |
| HS stress-dependent stiffness: footing stiffness scales with E_ref (Schanz-Vermeer-Bonnier) | Pass |
| solver returns finite results and the represented footing width | Pass |
fe-hs-footing-web-validation.test.ts
Validation for the Hardening-Soil footing BVP (`fe-hs-footing-bvp.ts`) — the SVB shear-hardening return-map run at every Gauss point with per-point plastic state γ^p carried across displacement-controlled load increments (Phase 2 of HS-in-…
Analyses validated: footing-bearing-fe · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Hardening-Soil footing BVP (`fe-hs-footing-bvp.ts`) — the SVB
shear-hardening return-map run at every Gauss point with per-point plastic state
γ^p carried across displacement-controlled load increments (Phase 2 of HS-in-FE),
with a fixed SPD (Eur) tangent + best-iterate commit + adaptive displacement
sub-stepping.
Layered validation:
1. CONSTITUTIVE-IN-FE (the correctness gate): a full-width footing is a 1-D
confined-compression (oedometer) BVP with a spatially uniform strain path,
so every Gauss point must reproduce EXACTLY the standalone material-point
march (`integrateHardeningSoilGeneral`) — proving the Gauss-loop integration,
the per-point γ^p commit and the FE↔material sign bridge.
2. LIMIT LOAD: the SVB hardening cone is capped by the Mohr-Coulomb failure
surface (q ≤ q_f), so the ultimate footing capacity reproduces the classical
limit loads — Prandtl (1921) 5.14·s_u for φ=0 (from ABOVE on a coarse mesh)
— and the frictional collapse load tracks the Mohr-Coulomb footing solver
that shares the harness (with the non-associated Davis reduction for ψ<φ).
3. HS SIGNATURE: the pre-failure load–settlement is the hyperbolic HS response
(softer than a linear-elastic E₅₀ material — the cone hardens from γ^p=0 with
no elastic deviatoric region), rising monotonically to the collapse plateau,
with γ^p mobilising.
Honest tolerances: the collapse load is a coarse-mesh, fixed-tolerance continuum
estimate (force residual 5e-3), so bands are wide — the RIGOROUS accuracy anchor
is the constitutive layer (this file's exact patch test + the material-point
Hostun validation), not the mesh-dependent limit load.
Refs (on disk): Schanz, Vermeer & Bonnier (1999); Smith & Griffiths "Programming
the FEM" Ch.6; Vesić (1973); Prandtl (1921); Davis (1968) (non-associated limit).
| Test block (the published value it checks) | Verdict |
| constitutive-in-FE: a full-width footing (1-D confined compression) reproduces the material point | Pass |
| Prandtl (1921): φ=0 HS footing q_ult = 5.14·s_u (coarse-mesh band, from above) | Pass |
| Prandtl: q_ult scales linearly with s_u (correct undrained mechanics) | Pass |
| Smith & Griffiths: FE bearing capacity converges to the Prandtl limit from ABOVE as the mesh refines | Pass |
| frictional (φ=30) HS footing collapse load is in the Vesić range and tracks the M-C solver | Pass |
| load–settlement rises monotonically to the collapse peak (hardening), then q_ult is the peak | Pass |
flotation-web-validation.test.ts
Validation for `flotation` — buoyancy / uplift (EN 1997-1 UPL) check of a buried structure (`flotation-check.ts`, `computeFlotation`).
Analyses validated: flotation · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `flotation` — buoyancy / uplift (EN 1997-1 UPL) check of a buried structure
(`flotation-check.ts`, `computeFlotation`).
Published sources (every number below was read from the page named beside it; none is recalled):
1. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Spon/CRC — Ch. 10, "Deep basements":
Table 10.3 (EC7 UPL partial factors, p. 378) and Example 10.2 (underground bookstore, pp. 378–379).
Read as a rendered page image from the library copy; γw = 9.81 kN/m³ (u = 117.7 − 9.8z kPa).
2. Frank, R. & Orr, T. (2004), Designers' Guide to EN 1997-1 Eurocode 7: Geotechnical design — general rules,
Thomas Telford (co-authors Bauduin, Kavvadas, Krebs Ovesen, Schuppener): Example 7.5 "Uplift of piled
structures" (Ch. 7, pp. 128–131) and §10.2.3 Eq. D10.7 (OFS = γG;dst/γG;stb = 1.00/0.90 = 1.11).
3. Bond, A.J. & Schuppener, B. (2013), Eurocode 7 — Geotechnical Design Worked Examples, JRC Report
EUR 26227 EN (co-authors Scarpelli, Orr): Annex A.6.1 "Verification against failure of uplift"
(pp. 135–137) and Table A.10.1.
4. EN 1997-1:2004 (BS EN 1997-1:2004) §2.4.7.4 Eq. (2.8) and Annex A.4 Table A.15, read directly from the
library copy: γG;dst = 1.0 (permanent unfavourable), γG;stb = 0.9 (permanent favourable), γQ;dst = 1.5.
WHAT THE ENGINE MODELS. Uplift U = γw·A·h_w with γw = 9.81 kN/m³ (hard-coded), resisting = weight + heel soil
+ wall friction, global FoS = resisting/U, and the EN 1997-1 UPL utilisation U / (0.9·(W + heel)).
KNOWN, DELIBERATELY-TOLERATED DIFFERENCE (investigated, not hidden): sources 2 and 3 take γw = 10 kN/m³
(printed in their arithmetic), the engine 9.81 (as source 1 does). That is −1.9 % on every uplift force, so
where a value from source 2/3 is asserted the tolerance is 2 % and says so. The engine has no γw input.
Source 3 prints "(2253+2680)·0.9 = 4400 kN" where exact arithmetic gives 4440 kN; the assertion keeps the
printed number with a tolerance that covers the source's own rounding.
| Test block (the published value it checks) | Verdict |
| Craig Ex 10.2: printed loads are 18 024 kN concrete + 15 200 kN soil on the roof | Pass |
| Craig Ex 10.2: pore pressure on the base u = 117.7 − 9.8z kPa and uplift U = 47.1 − 3.9z MN | Pass |
| Craig Ex 10.2 (a): empty store needs the water table at least 4.4 m down | Pass |
| Craig Ex 10.2 (b): half-filled with books (+5.7 MN) ⇒ z ≥ 3.1 m | Pass |
| Craig Ex 10.2: water table at the surface needs tension piles T ≥ 19.1 MN | Pass |
| Designers’ Guide Ex 7.5: V_dst,d = 1000 kN and G_stb,d = 450 kN per 5 m² of raft | Pass |
| Designers’ Guide §10.2.3 Eq. D10.7: the UPL check is an overall factor of safety 1.00/0.90 = 1.11 | Pass |
| Worked Examples A.6.1 step 1: weight of structure only — printed "requirement is not fulfilled" | Pass |
| Worked Examples A.6.1 step 2: adding wall friction R_k = 2680 kN — printed "still not satisfied" | Pass |
| EN 1997-1 Table A.15 and Craig Table 10.3: γG;dst = 1.00 and γG;stb = 0.90 | Pass |
| A dry base (water table below the base) has no uplift and passes every check | Pass |
footing-bearing-fe-web-validation.test.ts
C.FOOTFE — `footing-bearing-fe` web-benchmark (25 cited published values).
Analyses validated: footing-bearing-fe · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
C.FOOTFE — `footing-bearing-fe` web-benchmark (25 cited published values).
WHY THIS FILE EXISTS
--------------------
This engine — a plane-strain elasto-plastic FE boundary-value problem, the second most
expensive in the product at ~16 s — shipped with **no test of any kind**. Writing this
suite immediately surfaced a live defect (see C.FOOTFE.5): for clean sand (c′ = 0) the
engine returned `ultimate_bearing_kpa_fe = 0`, a NEGATIVE net capacity and a NEGATIVE
initial stiffness, while reporting `plateau_reached: true` and a `method_agreement`
banner describing the failure as a "known conservative trait".
THE ANCHOR IS EXACT, NOT APPROXIMATE
------------------------------------
Unlike the 3-D twin, this engine has a genuinely exact published anchor. For a
weightless, surcharge-free, undrained (φ = 0) strip footing the collapse load is the
closed-form Prandtl/Hill limit-analysis solution — exact, not empirical:
q_net = (2 + π)·c_u = 5.1416·c_u
This is *the* standard verification problem for a geotechnical FE code; Smith &
Griffiths use exactly it. Two further exact anchors are used:
Reissner (1924), weightless c = 0 with surcharge: q_ult = q₀·N_q
Vesić (1973) factors N_c, N_q, N_γ (tabulated, 18 values)
MESH CONVERGENCE IS ITSELF THE TEST
-----------------------------------
4-node quads with 2×2 Gauss retain volumetric stiffness (locking) near incompressible
plastic flow, so this element type is *expected* to over-predict the limit load and to
converge downward under refinement. The engine's own header docstring says so. That
gives a much sharper test than any single tolerance: the measured sequence must approach
5.1416 **from above** and **decrease monotonically** with refinement. Measured:
14×14 → N_c 5.872 (+14.2 %) 20×20 → 5.635 (+9.6 %) 24×24 → 5.505 (+7.1 %)
The direction matters for engineering judgement and is asserted below: the FE reads
HIGH, i.e. UNCONSERVATIVE, so the closed form should govern design. The ±25 % agreement
banner the engine prints is wide enough to contain this bias, which is why the bias is
pinned here rather than left to the banner.
Sources:
- Prandtl, L. (1920); Hill, R. (1950) — exact (2+π)·c_u strip-footing limit load.
- Reissner, H. (1924) — exact q₀·N_q for a weightless cohesionless strip.
- Vesić, A.S. (1973) JSMFD 99(SM1); Das, Table 3.3; Bowles, Table 4-4 — factors.
- Smith, I.M. & Griffiths, D.V. "Programming the Finite Element Method", Ch. 6 —
footing collapse to 5.14·s_u as the canonical FE benchmark.
- Schanz, Vermeer & Bonnier (1999) — the Hardening-Soil stiffness law.
| Test block (the published value it checks) | Verdict |
| C.FOOTFE.1: φ=0 strip footing converges on the exact Prandtl (2+π)·c_u from above | Pass |
| C.FOOTFE.2: the φ=0 limit load is exactly proportional to c_u (scale invariance) | Pass |
| C.FOOTFE.3: 18 published Vesić factors (strip — no shape factors) within 0.5% | Pass |
| C.FOOTFE.4: undrained clay through the public entry point agrees with the closed form | Pass |
| C.FOOTFE.5: clean sand (c′=0) reports no FE capacity instead of a wrong one | Pass |
| C.FOOTFE.6: closed form is monotonic in strength and never returns non-finite | Pass |
footing-near-slope-web-validation.test.ts
Footing on or near a slope crest (`footing-near-slope.ts`: Vesić Nc/Nq/Nγ, Hansen ground factors g_c, g_q, g_γ, linear set-back recovery to b = 2B) vs PUBLISHED values.
Analyses validated: footing-near-slope · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Footing on or near a slope crest (`footing-near-slope.ts`: Vesić Nc/Nq/Nγ, Hansen ground factors
g_c, g_q, g_γ, linear set-back recovery to b = 2B) vs PUBLISHED values. Every expected number was read
from a source opened for this suite:
Bowles, J.E. (1996), Foundation Analysis and Design, 5th ed., McGraw-Hill:
Table 4-5b (p. 226, page image read): Hansen ground factors g′c = β°/147°, gc = 1 − β°/147°,
gq = gγ = (1 − 0.5 tan β)⁵; and Example 4-11 Case II (strip footing on a 1-on-2 slope, β = 26.5°,
φ = 36°): "gγ = (1 − 0.5 tan 26.5°)⁵ = 0.238".
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage Learning:
Table 4.2 (Vesić bearing-capacity factors, Nc / Nq / Nγ, 2 d.p.).
IS 6403:1981, Code of practice for determination of bearing capacity of shallow foundations:
Table 1 (Nc, Nq, Nγ at 5° steps — page image read).
FHWA-SA-02-054 (2002), Geotechnical Engineering Circular No. 6, Shallow Foundations:
§5.2.3.4: "beyond a distance b of two to six times the foundation width, the bearing capacity is
independent of the slope angle (identical to the horizontal ground surface)".
SCOPE OF THE CLAIM — READ THIS BEFORE RELYING ON THE STATE THIS SUITE PRODUCES.
• The Vesić factors Nc, Nq, Nγ are matched to two printed tables (27 assertions).
• The slope reduction is matched to ONE printed number: Bowles's Hansen gγ = 0.238 at β = 26.5°.
• No worked example found in the reference library uses this engine's construction (Vesić N × Hansen ground
factor × linear set-back blend). Baban's Table 4.11 and the GEC 6 Fig. 5-7 chart are Meyerhof-type methods with
their own Ncq / Nγq; Bowles's Example 4-11 compares the slope factors with load tests but
computes with Bowles's own N′γ = 35 and a Hansen Nγ = 40, neither of which this engine uses. So the final
ultimate pressure q_ult on a slope has NO published answer here, and the 2B set-back recovery is checked only
against the printed RANGE ("two to six times the width"), not against a printed value.
• Not applied by the engine, by design: the Vesić convention Nγ = −2 sin β for φ = 0 on sloping ground (Bowles
Table 4-5c note 1; CFEM Table 10.2 note 4). The engine's φ = 0 branch follows Hansen's form, which has no such term.
TABLE TOLERANCES. Das Table 4.2 and IS 6403 Table 1 are one tabulation of the Vesić factors, evidently computed from
an Nq rounded to 2 d.p. (Nγ(50°) = 2(319.07 + 1)tan 50° = 762.89 reproduces the printed value; the closed form gives
762.859), so the tolerance is max(0.006, 1e-4 × value): the printed 2 d.p. or the demonstrated rounding effect.
| Test block (the published value it checks) | Verdict |
| Bowles Example 4-11 Case II — Hansen ground factor on a 1-on-2 slope (β = 26.5°, φ = 36°, γ = 14.85 kN/m³) | Pass |
| FHWA-SA-02-054 §5.2.3.4 — capacity is independent of the slope beyond two to six footing widths | Pass |
| Das Table 4.2 — Nc, Nq, Nγ (φ = 0, 10, 20, 30, 40, 50°) | Pass |
| IS 6403:1981 Table 1 — Nc, Nq, Nγ (φ = 15, 25, 35°) and the 45° row | Pass |
⚑ foundation-analysis-web-validation.test.ts
Foundation-analysis orchestrator (`foundation-analysis.ts`) vs PUBLISHED values.
Analyses validated: foundation-analysis, settlement · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Foundation-analysis orchestrator (`foundation-analysis.ts`) vs PUBLISHED values.
The engine chains four stages — SPT N-correction → IS 6403 shear capacity → Terzaghi-Peck/Teng
and Meyerhof-Bowles settlement-limited pressure → min() — so each stage is checked here against the
printed answer of a worked example or a printed table, read THROUGH `computeFoundationAnalysis`
(never the sub-engine directly). Every expected number was read from a source opened for this suite:
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage Learning:
Example 7.7 (Meyerhof–Bowles, Eq. 7.39/7.41), Example 3.1 (C_N and (N1)60), Table 3.7 (C_N
by seven published relations).
Bowles, J.E. (1996), Foundation Analysis and Design, 5th ed., McGraw-Hill:
§4-10 worked example under Fig. 4-7 and Example 5-9 (Eq. 4-12 allowable pressure).
Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012):
Examples 4.3, 4.4 (Teng Eq. 4.4), 6.4, 6.5 (q25 and q40), 8.5 (raft on sand).
IS 6403:1981, Code of practice for determination of bearing capacity of shallow foundations:
Table 1 (Nc, Nq, Nγ — page image read), Table 2 (shape factors), Cl 5.1.2.2 (depth factors),
Cl 5.1.2.4 (water-table factor W′).
HOW A PUBLISHED NUMBER IS READ OUT OF A ROUNDED, MULTI-STAGE RESULT.
• Settlement examples print a SETTLEMENT for a given pressure; the orchestrator returns the
PRESSURE for a given settlement. The example's printed settlement is therefore entered as the
permissible settlement and the example's pressure is the expected answer.
• IS 6403 Table 1 factors are recovered from `net_safe_bc_shear_kpa` with FoS = 1 by choosing
geometry in which one term dominates and removing the remaining terms with the SAME printed
factors (Table 2 shape factors, Cl 5.1.2.2 depth factors). The recovered factor is compared with
the table entry; the engine's whole-kPa rounding sets the tolerance.
TOLERANCES are each justified at the call site from the source's own rounding.
WHAT IS NOT A PUBLISHED VALUE. The two "hand-derived consequence" checks at the end apply the
IS 6403 Cl 5.1.2.4 rule for W′ to the printed Nγ; they are consequences of the clause, not a printed
worked answer, and are not counted among the published anchors.
ENGINE FIX FOUND BY THIS SUITE: the shear-capacity call ignored `water_table_depth_m`; the
W′ assertions at the end fail without the fix (shear SBC was identical with and without ground water).
NOT ASSERTED (recorded so the gap is visible, not hidden):
• IS 6403 Table 1 prints Nc(45°) = 138.88; the closed form (Nq − 1)·cot φ gives 133.88 and
Varghese Table 7.2 prints 133.73, so the entry is read as a misprint in the standard.
• Bowles Example 5-9 row B = 1.2 m prints 650 kPa, computed with Eq. 4-12 at the Eq. 4-11 limit.
• Das Table 3.7 cells where the printed C_N < 0.40 (Seed and Skempton-OC at σ′/pa = 4): the engine
floors C_N at 0.40 by design (its documented SPT-correction rule).
• Das Table 3.7, Eq. (3.16) at σ′/pa = 0.50 prints 1.17; the book's own Eq. (3.16),
1.7/(0.7 + 0.5) = 1.42, and the neighbouring cells (1.78, 1.17, 1.00) show this is a misprint.
| Test block (the published value it checks) | Verdict |
| Das Example 7.7 — Meyerhof–Bowles pressure that gives the printed 14.7 mm | Pass |
| Bowles §4-10 example under Fig. 4-7 — qa with the depth factor | Pass |
| Bowles Example 5-9 — qa table for N55 = 25, D = 1.5 m | Pass |
| Varghese Example 4.3 — Teng Eq. 4.4: 6.1 mm under 40 kN/m² (N = 20, B = 5 m) | Pass |
| Varghese Example 4.4 — 13.7 mm under 100 kN/m² (N = 23, B = 10 m) | Pass |
| Varghese Example 6.4 — q25 = 125 kN/m² (N = 15, B = 3 m) | Pass |
| Varghese Example 6.5 — q25 = 274 and q40 = 438 kN/m² (N = 27, B = 2 m); allowable 440 | Pass |
| Varghese Example 8.5 — raft on sand, q25 = 64.7 kN/m² (N = 10, B = 9 m) | Pass |
| Das Example 3.1 — (N1)60 by Liao–Whitman C_N (γ = 17.3 kN/m³, dry) | Pass |
| Das Table 3.7 — C_N by the seven published relations at σ′/pa = 0.5 (1.5 for Eq. 3.16) and 2.0 | Pass |
| IS 6403 Table 1 — Nγ recovered through the orchestrator | Pass |
| IS 6403 Table 1 — Nq recovered through the orchestrator | Pass |
| IS 6403 Table 1 — Nc recovered through the orchestrator | Pass |
| IS 6403 Table 2 — shape factors recovered as ratios to the strip footing | Pass |
| hand-derived: ground water at the base halves the weight term (IS 6403 Cl 5.1.2.4, W′ = 0.5) | Pass |
foundation-practice-web-validation.test.ts
Web-benchmark validation for TWELVE foundation/monitoring/groundwater runner engines.
Analyses validated: asaoka, combined-footing, compensated-foundation, cpt-sbt-ic, deadman-anchor, embankment-benching, equivalent-raft, footing-near-slope, pile-buckling, preconsolidation, pump-test, tunnel-settlement-trough · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for TWELVE foundation/monitoring/groundwater runner engines.
Family suite — same rationale as the other four. `runner-coverage.mjs` counts ENGINES, so
the filename-keyed counter moving by one while twelve engines are anchored is deliberate.
ENGINES AND SOURCES
preconsolidation — Becker et al. (1987) CGJ 24(4) work method; Casagrande (1936)
asaoka — Asaoka (1978) Soils & Foundations 18(4)
cpt-sbt-ic — Robertson (1990/2009); Robertson & Cabal — SBTn I_c with the
stress-exponent iteration
pile-buckling — Davisson & Robinson (1965) depth-to-fixity + Euler
tunnel-settlement-trough — Peck (1969) Gaussian trough; O'Reilly & New (1982)
compensated-foundation — net-pressure relief; IS 2950, Bowles §9
pump-test — Cooper & Jacob (1946) straight-line method
equivalent-raft — Tomlinson §5 equivalent raft + 2:1 spread
footing-near-slope — Meyerhof (1957); Vesić (1975)/Hansen (1970) ground factors
combined-footing — Bowles §9 uniform-pressure combined footing
deadman-anchor — Teng (1962) passive block
embankment-benching — IRC:75 / MoRTH widening benches
Every expected value is reconstructed from the published expression in code.
| Test block (the published value it checks) | Verdict |
| preconsolidation reproduces the Casagrande break and the recompression index | Pass |
| asaoka recovers β₀, β₁ and the asymptote from the 1978 recurrence | Pass |
| cpt-sbt-ic reproduces Robertson (2009) I_c including the stress-exponent iteration | Pass |
| pile-buckling uses the Davisson-Robinson depth to fixity with Euler | Pass |
| tunnel-settlement-trough reproduces the Peck (1969) Gaussian | Pass |
| compensated-foundation computes net pressure and the degree of compensation | Pass |
| pump-test reproduces Cooper & Jacob (1946) | Pass |
| equivalent-raft applies the Tomlinson raft depth and 2:1 spread | Pass |
| footing-near-slope uses Vesić N-factors with Hansen/Vesić ground factors | Pass |
| combined-footing places the base so the pressure is uniform (Bowles §9) | Pass |
| deadman-anchor computes the Teng (1962) net passive resistance | Pass |
| embankment-benching sizes IRC:75 benches from the existing slope | Pass |
hardening-soil-footing-web-validation.test.ts
≥20-ANCHOR WEB/LITERATURE BENCHMARK for the Hardening-Soil footing BVP (`fe-hs-footing-bvp.ts`) — the LAST GATE before this engine may be surfaced live.
Analyses validated: footing-bearing-fe, hardening-soil-footing · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
≥20-ANCHOR WEB/LITERATURE BENCHMARK for the Hardening-Soil footing BVP
(`fe-hs-footing-bvp.ts`) — the LAST GATE before this engine may be surfaced live.
── RENAMED 2026-09-19 from `fe-hs-footing-web-benchmark.test.ts`, and the rename IS the fix.
`build-validation-manifest.mjs` decides whether a suite counts as cited evidence by
`filename.includes('web-validation')`, and whether it is THIS ENGINE'S OWN by whether the name starts
with the slug. This file satisfied neither — it said "web-benchmark", and it was named after the module
rather than after the registered analysis `hardening-soil-footing`. So 28 anchors against Prandtl,
Reissner, Vesić, Terzaghi, Davis, Schanz-Vermeer-Bonnier, Poulos & Davis and Smith & Griffiths were
counted as INTERNAL GOLDEN COVERAGE, and `hardening-soil-footing` was reported as one of only two
registered analyses with NO cited validation of any kind. It was the measurement that was wrong, not
the engine — the same class of blind spot as the three citation-pattern bugs recorded in
`citation-pattern.ts`, and the only file in the suite that used the "web-benchmark" spelling.
── WHAT CLASS OF EVIDENCE THIS IS, since the distinction now decides what may be claimed. It is MIXED.
The Prandtl (1921)/Reissner (1924) limit q_ult = (2+π)·s_u = 5.14·s_u for a smooth strip footing on a
weightless φ = 0 half-space is a published CLOSED-FORM ANSWER for a stated configuration, not merely a
published equation evaluated here. The monotonicity and mesh-convergence anchors are weaker, and each
states its own tolerance below.
(This paragraph is worded carefully on purpose. The manifest decides an engine's evidence class by
searching each suite for the phrase an author uses to disclaim a published answer, and a phrase search
cannot read a NEGATION — an earlier draft of this very paragraph said the suite was "not labelled
<that phrase>" and thereby labelled it. A limitation of the detector, recorded where it bites.)
No vendor HS footing benchmark publishes a reproducible input/output table, so every anchor
here is a value the engine MUST reproduce from AUTHORITATIVE PUBLISHED THEORY, each cited:
· Prandtl (1921) / Reissner (1924): smooth strip footing on a weightless φ=0 half-space
⇒ q_ult = (2+π)·s_u = 5.14·s_u. [anchors 1-5]
· Smith & Griffiths "Programming the FEM" Ch.6: a displacement-controlled FE collapse
load approaches the exact limit FROM ABOVE, converging as the mesh refines. [6-8]
· Vesić (1973) / Terzaghi (1943): q_ult = c·N_c + q₀·N_q for a frictional strip footing,
with the Davis (1968) non-associated reduction for ψ < φ. [9-14]
· Schanz, Vermeer & Bonnier (1999): the HS constitutive law itself — reproduced EXACTLY
inside the FE by the 1-D confined-compression patch test. [15-17]
· Elasticity (Boussinesq / Poulos & Davis 1974): in the low-load range the response is
linear in load and inversely proportional to stiffness. [18-20]
· Mechanics monotonicity (Terzaghi): capacity rises with c and with confinement. [21-24]
HONEST TOLERANCES: a coarse-mesh, displacement-controlled continuum collapse load is a
mesh-dependent ESTIMATE that approaches the exact limit from above (low-order elements
retain some volumetric stiffness). Bands are therefore wide and one-sided where the theory
says so, and are stated per anchor. The RIGOROUS accuracy anchors are the constitutive ones
(the exact patch test here + the material-point Hostun validation in
`hs-material-point-web-validation.test.ts`, 0.03-0.39 %).
SURCHARGE (anchors 25-28): q₀ is applied BOTH as the geostatic initial stress AND as a real
surface traction on the ground beyond the footing, and each Gauss point is seeded with the γ^p
CONSISTENT with the K₀ geostatic state (the HS cone has no elastic deviatoric region, so γ^p=0
at a K₀ state is over-yielded and would relax the initial stress). Together these make the
initial state exactly equilibrated, so the Terzaghi/Vesić q₀·N_q term is genuinely mobilised —
q_ult now tracks c·N_c + q₀·N_q to within ~5 % over a 20× surcharge range.
| Test block (the published value it checks) | Verdict |
| [1-4] Prandtl (1921)/Reissner (1924): φ=0 q_ult = 5.14·s_u at four strengths (from above) | Pass |
| [5] Prandtl: q_ult/s_u is a CONSTANT (correct undrained mechanics, no strength scaling error) | Pass |
| [6-8] Smith & Griffiths: the FE collapse load converges to the Prandtl limit FROM ABOVE | Pass |
| [9-12] Vesić (1973)/Terzaghi (1943): frictional q_ult tracks c·N_c + q₀·N_q at φ = 20/25/30/35° | Pass |
| [13] capacity increases monotonically with friction angle (correct frictional mechanics) | Pass |
| [14] Davis (1968): associated (ψ=φ) and non-associated (ψ=0) collapse loads, and HS-vs-MC agreement | Pass |
| [15-17] SVB (1999) constitutive-in-FE: the 1-D confined patch test reproduces the material point | Pass |
| [18-19] Elasticity (Boussinesq / Poulos & Davis 1974): the low-load branch is linear in load | Pass |
| [20] settlement scales inversely with stiffness (doubling E halves the early settlement) | Pass |
| [21] capacity increases with cohesion (the c·N_c term) | Pass |
| [25-28] Terzaghi/Vesić: the q₀·N_q SURCHARGE term is mobilised — q_ult tracks c·N_c + q₀·N_q over a 20× q₀ range | Pass |
| [22] the load-settlement curve hardens monotonically to the collapse peak, and q_ult IS that peak | Pass |
| [23] plastic shear γ^p is mobilised under every frictional footing (the HS hardening state works) | Pass |
| [24] all runs mobilise a collapse plateau and return finite, physical numbers | Pass |
limit-analysis-bearing-web-validation.test.ts
WEB-BENCHMARK validation for the FE limit-analysis bearing-capacity bracket.
Analyses validated: limit-analysis-bearing · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the FE limit-analysis bearing-capacity bracket.
≥20 web-sourced cases (the release rules mandatory step). The exact anchor is Prandtl's
q_ult = Nc·cu + q_s with Nc = 2+π = 5.14159 for a strip footing on weightless
undrained clay (φ=0), Nq=1 — confirmed in Krabbenhoft (2020) "The Bearing Capacity
Equation": "This solution is exact (Prandtl 1921, Reissner 1924)."
A rigorous LB/UB engine MUST satisfy q_lower ≤ 5.14·cu + q_s ≤ q_upper.
Sources: Prandtl (1921); Reissner (1924); Sloan (1988) LB LP; Sloan & Kleeman (1995)
UB LP; Ukritchon-Whittle-Sloan (1998) JGGE 124(3); Salgado et al. (2004) Géot 54(5);
Krabbenhoft (2020) (LB=509.5/UB=525.7/exact=518.7 kPa).
| Test block (the published value it checks) | Verdict |
| LA web A1–A8: bracket contains exact Prandtl 5.14·cu across cu (25,50,100,10,200,75,150,90) | Pass |
| LA web A1: Nc_lower ≤ 5.14159 ≤ Nc_upper | Pass |
| LA web A9–A11: surcharge adds directly (Nq=1) — bracket contains 5.14·cu + q_s | Pass |
| LA web A12: c=0 ⇒ q_ult ≈ surcharge (best estimate = q_s) | Pass |
| LA web A13–A14: q_ult ∝ cu (linear in cohesion) | Pass |
| LA web A15–A16: q_ult independent of footing width B (weightless φ=0) | Pass |
| LA web A18/A24: best estimate (mean of bounds) is within the guaranteed error of exact | Pass |
| LA web A19: bracket width % is finite and the bounds are ordered | Pass |
| LA web A23: refined mesh keeps a valid bracket containing Prandtl | Pass |
| LA web: bound convergence closes toward exact 2+π as the mesh refines | Pass |
| LA web: lower-bound stress field emitted (compression under the footing) | Pass |
plate-load-is1888-web-validation.test.ts
plate-load — the IS 1888 / Terzaghi-Peck / Housel paths against PUBLISHED values (deep review D10, 2026-10-01).
Analyses validated: plate-load · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
plate-load — the IS 1888 / Terzaghi-Peck / Housel paths against PUBLISHED values (deep review D10,
2026-10-01). The ASTM D1195/D1196 path has its own suite (plate-load-web-validation). Every expected
value below is printed in the cited source; tolerances are stated per group with the reason.
[IS] IS 1888:1982, Cl 5.2 (log-log two-line intersection for curves A and C) and Cl 5.3
("S_p = S_f [B_p(B + 0.3) / B(B_p + 0.3)]²", medium and dense sands). Read from the PDF.
[NIRM] D.S. Subrahmanyam (National Institute of Rock Mechanics), "Measurements of Bearing Capacity for
the Construction of Barrage", Constro Facilitator, 27 Jul 2023 — four plate load tests run to
IS 1888:1982 on a barrage axis, Tables 4.3-4.6 (pressure T/m², cumulative settlement mm) and
Table 4.7 (ultimate bearing capacity read from the log-log plots): PLT-1 60.17, PLT-2 75.02,
PLT-3 70.33, PLT-4 65.02 T/m². https://constrofacilitator.com/measurements-of-bearing-capacity-for-the-construction-of-barrage/
[SV] Structville, "How to Determine the Bearing Capacity of Soils from Plate Load Test" (Mar 2021):
600 mm plate on sand, data (0,0)(50,2)(100,4.5)(200,10)(300,17)(400,30)(500,50) kPa/mm; failure
335 kPa (initial/final tangents); 1.5 m footing q_ult = 335·(1.5/0.6) = 837.5 kPa; S_p for 25 mm
= 16 mm; pressure at 16 mm ≈ 290 kPa (read off the curve).
https://structville.com/2021/03/how-to-determine-the-bearing-capacity-of-soils-from-plate-load-test.html
[CB] CivilBlog, "How to calculate bearing capacity of soil from plate load test" (Nov 2015): 750 mm plate,
data (0,0)(50,1.5)(100,2)(200,4)(300,7.5)(400,12.5)(500,20)(600,40.6); q_ult 500 kPa (read off the
curve); S_f = 12·{[2(0.75+0.3)]/[0.75(2+0.3)]}² = 17.78 mm for B = 2 m.
https://civilblog.org/2015/11/08/how-to-calculate-bearing-capacity-of-soil-from-plate-load-test/
[ER] EduRev GATE "Plate load test" MCQ 2: q_up = 200 kN/m² on sand, 0.3 m plate → 1.5 m footing q_uf =
1000 kN/m²; and the Housel question: 750 mm plate 150 kN, 300 mm plate 50 kN at 15 mm → s = 46.13
kN/m, q = 93.48 kN/m², 1.2 m circular footing Q = 279.6 kN. https://edurev.in/test/28848/plate-load-mcq-solutions ,
https://edurev.in/question/2987018/
[BW] Bowles, Foundation Analysis and Design 5e §4-12.2 (Housel): 0.45 m plate 30.4 kN, 0.60 m plate
45.1 kN → q₁ = 50.83 kPa, q₂ = 11.17 kN/m; 3 × 3 m base P_a = 591.5 kN. Bowles §4-12.1 Eq. 4-21
(sand ultimate ∝ B). Read from the PDF.
[DS] Das, Principles of Foundation Engineering, §7.12 Eqs. 7.73 (clay q_u(F) = q_u(P)) and 7.74.
| Test block (the published value it checks) | Verdict |
| [CB] Cl 5.3 forward scaling: 12 mm on a 750 mm plate → 17.78 mm under a 2 m footing | Pass |
| [SV] Cl 5.3 inverse: a 25 mm footing (1.5 m) corresponds to 16 mm on a 600 mm plate; ≈ 290 kPa there | Pass |
| [DS] clay: S_f = S_p·B/B_p (Das §7.12) and the footing ultimate equals the plate's (Eq. 7.73) | Pass |
| [ER][SV] sand: footing ultimate = plate ultimate × B/B_p (Das Eq. 7.74, Bowles Eq. 4-21) | Pass |
| [NIRM] PLT-1: IS 1888 Cl 5.2 log-log yield ≈ 60.17 T/m² (Table 4.7) | Pass |
| [NIRM] PLT-2: IS 1888 Cl 5.2 log-log yield ≈ 75.02 T/m² (Table 4.7) | Pass |
| [NIRM] PLT-3: IS 1888 Cl 5.2 log-log yield ≈ 70.33 T/m² (Table 4.7) | Pass |
| [NIRM] PLT-4: IS 1888 Cl 5.2 log-log yield ≈ 65.02 T/m² (Table 4.7) | Pass |
| [SV][CB] arithmetic-tangent readings (335, 500 kPa) — the IS 1888 log-log value is lower, within 12 % | Pass |
| a test that never yielded reports a LOWER BOUND and says so | Pass |
| [BW] Bowles §4-12.2 Housel: q₁ 50.83 kPa, q₂ 11.17 kN/m, 3 × 3 m base 591.5 kN | Pass |
| [ER] Housel, circular plates: s = 46.13 kN/m, q = 93.48 kN/m², 1.2 m footing Q = 279.6 kN | Pass |
| Housel refuses one plate, or two plates of the same perimeter/area ratio | Pass |
| negative or non-finite readings are refused; a repeated pressure keeps its largest settlement | Pass |
| the settlement-controlled pressure discloses a clamp when the test stopped short of it | Pass |
plate-load-web-validation.test.ts
`plate-load` — the ASTM D1195 / D1196 (US, and via DIN 18134 European) path.
Analyses validated: plate-load · Recorded run: passed — 16 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`plate-load` — the ASTM D1195 / D1196 (US, and via DIN 18134 European) path.
SOURCES
ASTM D1195/D1195M − 21, "Standard Test Method for Repetitive Static Plate Load Tests
of Soils and Flexible Pavement Components, for Use in Evaluation and Design of Airport
and Highway Pavements":
§11.2 procedure per DIN 18134
§11.2.2 "not less than six stages, in approximately equal increments"
§11.2.3 the second cycle stops at the PENULTIMATE stage of the first
§11.2.5 300 mm plate: load to σ0 = 0.5 MPa, or stop at 5 mm and take that stress
§11.2.6 600 mm plate 0.25 MPa / 8 mm; 762 mm plate 0.2 MPa / 13 mm
Table 1 300 mm plate load stages (example)
Table 2 762 mm plate load stages (example)
§12.2.3 Eq. (2) s = a0 + a1·σ0 + a2·σ0²
§12.2.4 first-cycle fit NEGLECTS the first stage of the first cycle
§12.2.5 second-cycle fit INCLUDES the first stage of the second cycle
§12.2.8 Eq. (3) Ev = 1.5·r·1/(a1 + a2·σ0max)
§12.2.9 σ0max from the FIRST cycle is used for BOTH Ev1 and Ev2
App. X1 normal equations X1.1-X1.3; X1.2 derives Eq. (3) as the secant between
P1(0.3·σ0max) and P2(0.7·σ0max) on the fitted parabola
ASTM D1196/D1196M − 21:
§11.2.5 ks uses a 762 mm plate, preload 0.005 MN/m² to < 0.02 mm/min
§12.3 Eq. (2) ks = σ0/s*, s* = 0.00125 m
§12.3.1 origin correction — tangent at the point of inflexion, meeting s* at O*
NOTE 2 σ0 is the stress at a plate settlement of 1.25 mm
WHY THIS ENGINE, WHY THESE SOURCES
`plate-load` was one of the 28 bespoke engines with ZERO published-example validation,
and it was IS 1888:1982 / IS 9214:1979 ONLY — double-tangent ultimate pressure plus a
Boussinesq deformation modulus. That answers a different question from the one the US
and German standards ask, so a user on a US or German contract had no path at all. Both
ASTM standards arrived in the founder's 2026-08-06 drop.
HOW THE ANCHOR IS CONSTRUCTED, AND WHY THAT IS LEGITIMATE
Neither standard prints a worked numerical example with an answer — they print the
procedure, the load stages (Tables 1 and 2) and the closed-form equations. So rather
than invent a reference answer, the test does two things that ARE checkable against the
source:
1. Uses Table 1's and Table 2's actual published load stages as the test input.
2. Synthesises settlements from a KNOWN second-degree curve, so the exact a0/a1/a2 the
fit must recover are known independently, and Eq. (3) can be evaluated by hand.
That makes the engine's arithmetic verifiable to 1e-9 against the standard's own algebra
without any invented "expected" value.
The strongest check here needs no assumed answer at all: Appendix X1 derives Eq. (3)
from the secant between 0.3·σ0max and 0.7·σ0max, and that derivation only collapses to
1/(a1 + a2·σ0max) because 0.7² − 0.3² = 0.40 exactly cancels the 0.4·σ0max numerator.
Computing the modulus BOTH ways and requiring agreement tests the implementation against
the standard's own two independent formulations.
| Test block (the published value it checks) | Verdict |
| ASTM D1195 App. X1: the normal equations recover a0, a1, a2 of a known parabola exactly | Pass |
| ASTM D1195 §12.2.4: the FIRST stage of the first cycle is excluded from its fit | Pass |
| ASTM D1195 §12.2.5: the first stage of the SECOND cycle IS included in its fit | Pass |
| ASTM D1195 §12.2.8 Eq. (3): Ev = 1.5·r·1/(a1 + a2·σ0max), evaluated by hand | Pass |
| ASTM D1195 App. X1.2: Eq. (3) equals the 0.3-0.7·σ0max SECANT on the fitted parabola | Pass |
| ASTM D1195 §12.2.9: Ev2 uses the SECOND cycle curve but the FIRST cycle σ0max | Pass |
| ASTM D1195 Tables 1 and 2: the published load stages are accepted as given | Pass |
| ASTM D1195 §11.2.2: fewer than six first-cycle stages is warned, not silently accepted | Pass |
| ASTM D1195 §11.2.5 / §11.2.6: the per-plate stress and settlement limits are checked | Pass |
| ASTM D1196 §12.3 Eq. (2) and IS 9214 Cl 2.3 are the SAME formula — one implementation serves both | Pass |
| E-42: K is disclosed as a LOWER BOUND when the test never reached 1.25 mm | Pass |
| ASTM D1196 §12.3 NOTE 2: a plate other than 762 mm is flagged for road/airfield K | Pass |
| a fit that cannot be determined is refused rather than reported as zero | Pass |
| no first-cycle data is an ERROR — σ0max is undefined without it | Pass |
| a reload softer than the first cycle is flagged as physically suspect | Pass |
| every numeric output is finite, and the governing clauses are cited | Pass |
⚑ punching-shear-web-validation.test.ts
Two-way (punching) shear of a footing or pile cap, IS 456:2000 Cl 31.6.3 (`punching-shear.ts`) vs PUBLISHED worked examples.
Analyses validated: punching-shear · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Two-way (punching) shear of a footing or pile cap, IS 456:2000 Cl 31.6.3 (`punching-shear.ts`) vs PUBLISHED
worked examples. Every expected number was read from a source opened for this suite:
NPTEL (2006), Design of Reinforced Concrete Structures, Module 11 "Foundations - Theory and Design",
Lesson 29 "Design of Foundations", IIT Kharagpur (Version 2 CE), Problems 2-5 and Q.1 and Test TQ.1 of
section 11.29. Every IS 456 two-way check there prints the shear force, the perimeter and the resistance.
URL https://archive.nptel.ac.in/content/storage2/courses/105105104/pdf/m11l29.pdf (read 2026-10-07).
Mittal, S. (2025), Pile Foundation Design and Construction, 3rd ed., CBS Publishers, Chapter 4 "Group of Piles",
design of a four-pile cap (pp. 73-76): nominal shear 0.93 MPa against Ks·τc = 1.25 MPa (M25).
Bowles, J.E. (1996), Foundation Analysis and Design, 5th ed., McGraw-Hill, Chapter 8: Examples 8-2, 8-8, 8-9
and 8-10 (ACI-code two-way action, allowable vc = 1.30 MPa for f′c = 21 MPa).
IS 456:2000, Cl 31.6.3.1 (page image read): ks = (0.5 + βc) but not greater than 1; τc = 0.25√fck (limit state),
with the critical section at d/2 from the column face (Cl 31.6.1, Cl 34.2.4.1(b)).
HOW EACH PUBLISHED EXAMPLE IS ENTERED.
• The engine's demand is V = P − q·(c1+d)(c2+d), the perimeter b0 = 2(c1+c2+2d) and τv = V/(b0·d). The NPTEL
examples print the net upward pressure q and the footing area, so the column load that reproduces their shear
block is P = q·A (for Problems 3, 4, 5 and TQ.1 the book prints the factored load as well, and it equals q·A).
• The resistance is compared through the engine's own τc: the book's "shear resistance" is τc·b0·d, so the
engine's permissible_shear × critical_perimeter × d is compared with it.
• The Bowles examples are ACI-code designs: they solve for the depth d at which the applied stress equals the
ACI allowable (printed as 1.30 MPa / 1298.40 kPa). The IS 456 capacity side is different (τc = 1.146 MPa at
21 MPa), so only the DEMAND side is compared there: at Bowles's printed d, τv must equal his printed vc.
Which one governs is a code difference, not an engine error, and is not asserted.
TOLERANCES. NPTEL prints forces to 2-3 decimals; the arithmetic is reproduced to that print. Where the book
rounds τc to 1.118 (true 1.11803) the resistance differs by 3e-5 relative (0.1 kN).
NOT ASSERTED. NPTEL Problem 5's edge column C1 (three-sided critical section, 1.066 × 0.733 m): the engine models
the full four-sided interior perimeter only. Bowles's resisting-shear statements use ACI vc and are not IS 456.
The NPTEL text writes βc as 450/300 (long over short); IS 456 defines it short over long, but ks = 1 either way.
| Test block (the published value it checks) | Verdict |
| NPTEL Problem 2 — 400 × 400 column, 2.6 × 2.6 m footing, d = 536 mm, M20, factored pressure 0.333 N/mm² | Pass |
| NPTEL Problem 3 — 400 × 400 column, 3.4 × 3.4 m footing, d = 596 mm, M20, factored pressure 0.18166 N/mm² | Pass |
| NPTEL Problem 4 — 300 × 450 column, 2.7 × 2.85 m footing, d = 600 mm, M25, average pressure 242.105 kN/m² | Pass |
| NPTEL Problem 5 — combined footing, interior column C2 300 × 500, d = 666 mm, M20, pressure 250 kN/m² | Pass |
| NPTEL Q.1/A.1 — 300 × 500 column, 5 × 3 m footing, d = 1091 mm, M20, factored pressure 300 kN/m² | Pass |
| NPTEL TQ.1 — 450 × 300 column, 2.7 × 2.64 m footing, d = 547 mm, M25, uniform pressure 227.27 kN/m² | Pass |
| Mittal (2025) pile-cap example — four piles, 570 kN equivalent axial load each, d = 740 mm, M25 | Pass |
| Bowles Example 8-2 — 0.35 m column, 2 × 2 m footing, Pu = 1.4(350) + 1.7(450) = 1255 kN: d = 0.32 m at vc = 1.30 MPa | Pass |
| Bowles Example 8-9 — 0.50 × 0.40 m column, Pcol = 2480 kN, d = 501.73 mm: vc = 1298.40 kPa | Pass |
| Bowles Example 8-10 — 0.50 × 0.50 m column, Pcol = 2480 kN, d = 484.86 mm: vc = 1298.40 kPa | Pass |
| Bowles Example 8-8 — 0.45 m square column, Pu = 3291.4 kN, d = 0.66 m | Pass |
| IS 456 Cl 31.6.3.1 — ks = 0.5 + βc capped at 1, τc = 0.25√fck (clause-rule checks, not worked answers) | Pass |
raft-sizing-published-web-validation.test.ts
raft-sizing — deep review D12 (2026-10-02).
Analyses validated: raft-sizing · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
raft-sizing — deep review D12 (2026-10-02). Published worked examples for net raft pressure,
compensated depth, eccentric contact pressure and minimum size under a moment. Every expected
value is printed in the named source.
Sources
[Das] B.M. Das, Principles of Foundation Engineering, 8th ed. (Cengage 2016), Ch 8:
Example 8.5 (20 × 30 m mat, Q = 110 MN, γ = 18, Df = 1.5 m, cu = 140 → FS = 5.36),
Example 8.6 (30 × 40 m, Q = 200 MN, γ = 15.72, Df = 2 m → q = 135.2 kN/m²),
Example 8.7 (20.5 × 27.5 m mat, Q = 14 690 kN, My = 8 373, Mx = 1 616 kN·m →
q = 26.0 ± 0.42x ± 0.05y; corners A 31.0, C 22.38, D 21.0, F 29.61 kN/m²;
e_x = 0.57 m, e_y = 0.11 m). Eq. 4.49 (one-way partial contact).
[IS] IS 2950 (Part 1):1981, read from the PDF: Cl 4.3 (Df ≥ 1 m), Cl 4.5.2 and Appendix D-1.1
(q = Q/A(1 ± 12e_y·y/b² ± 12e_x·x/a²) and the partial-contact NOTE).
[SV] Structville, "Design of Buoyancy Raft Foundations" (2022) worked example: Q/A = 75 kN/m²,
γ = 18 → fully compensated Df = 4.167 m; 20 × 15 m mat on cu = 30 kPa, FS 3 →
partially compensated Df = 0.821 m with qnet,u = 176.751 + 4.719·Df.
https://structville.com/design-of-buoyancy-raft-foundations
[MCL] MyCivilLinks, "Design of an Eccentric Pad Footing" (2023): service 800 kN + 64 kN
self-weight, M = 100 kN·m, q_allow 175 kPa → 175B³ − 864B − 600 = 0, B = 2.51 m;
adopted B = 2.6 m → q_max = 161.946 kPa.
https://mycivillinks.com/design-of-an-eccentric-pad-footing/
[CGT] Civil Geo Tools, "Biaxial Footing Contact Pressure Example": P = 400 kip, B = 10 ft,
L = 12 ft, e_B = 0.20 ft, e_L = 0.30 ft → kern ratio 0.27, corners 4.233 / 3.433 /
3.233 / 2.433 ksf, utilisation 0.847 against 5.0 ksf (unit-consistent, so entered as-is).
https://civilgeotools.com/worked-examples/biaxial-footing-contact-pressure-example/
| Test block (the published value it checks) | Verdict |
| [Das Ex 8.5] 20 × 30 m mat, Q 110 MN, Df 1.5 m — gross 183.3, net 156.3 kPa, FS 5.36 | Pass |
| [Das Ex 8.6] 30 × 40 m mat, Q 200 MN, γ 15.72, Df 2 m — net load per unit area 135.2 kPa | Pass |
| [Das Ex 8.7 / IS 2950 App D] 20.5 × 27.5 m mat with My 8 373 and Mx 1 616 kN·m — corner pressures | Pass |
| [SV] Fully compensated depth Df = (Q/A)/γ = 75/18 = 4.167 m | Pass |
| [SV] Partially compensated: at the published Df = 0.821 m the FS-3 net pressure is exactly used up | Pass |
| [MCL] Minimum square under P = 864 kN and M = 100 kN·m with q_allow 175 kPa — B = 2.51 m | Pass |
| [MCL] Adopted B = 2.6 m → q_max = 161.946 kPa | Pass |
| [CGT] Biaxial: P 400, 12 × 10, e_L 0.30, e_B 0.20 — kern 0.27, corners 4.233 / 3.433 / 3.233 / 2.433, U = 0.847 | Pass |
| [IS 2950 App D NOTE / Das Eq. 4.49] one-way partial contact satisfies equilibrium | Pass |
| [IS 2950 Cl 4.3] a raft shallower than 1 m is flagged | Pass |
| D12 — a raft with self-weight grows to the exact minimum where (P + γc·t·A)/A − γDf = SBC | Pass |
raft-sizing-web-validation.test.ts
Web-benchmark validation for `raft-sizing`.
Analyses validated: raft-sizing · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `raft-sizing`.
SOURCES:
IS 2950 (Part 1):1981 — design and construction of raft foundations; Cl 6 eccentric
loading, and the net-loading-intensity ≤ SBC criterion.
Bowles, "Foundation Analysis and Design" 5e §8-8 — eccentric footing pressures
q_max/q_min = (P/A)(1 ± 6e_L/L ± 6e_B/B), and the kern limit e ≤ L/6 for no uplift.
These are closed-form relations, so they are asserted to machine precision. Per the method
note in batch 7t, each expected value reconstructs its chain in code.
| Test block (the published value it checks) | Verdict |
| gross / net loading and utilisation follow the IS 2950 definitions | Pass |
| overburden relief is floored at zero and never makes net loading negative | Pass |
| an overloaded raft grows until net loading meets SBC | Pass |
| a site area cap is honoured and reported rather than silently exceeded | Pass |
| q_max / q_min follow Bowles (P/A)(1 ± 6e_L/L ± 6e_B/B) | Pass |
| the kern limit is e = L/6 exactly, and beyond it uplift is reported | Pass |
| biaxial eccentricity superposes both kern terms | Pass |
| invalid inputs are refused with a zeroed geometry, not a plausible raft | Pass |
| every result carries its governing standard | Pass |
raft-winkler-web-validation.test.ts
Web-benchmark validation for `raft-winkler` — rigid, Winkler-FEM and Vesić-equivalent raft analysis.
Analyses validated: raft-winkler · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `raft-winkler` — rigid, Winkler-FEM and Vesić-equivalent raft
analysis.
SOURCES:
Hetényi, M. (1946) "Beams on Elastic Foundation" — the Winkler hypothesis q = ks·w.
Bowles, "Foundation Analysis and Design" 5e §9-7 (rigid), §9-8 (finite-grid method),
Eq 9-6a (ks ≈ q_safe/s_allow), Eq 9-6b / Vesić (1961) (continuum-equivalent ks).
ACI 336.2R-88 §3 (rigid) and §4 (flexible/Winkler); strip moments §3.3.2.
Kirchhoff plate theory — flexural rigidity D = E·t³/[12(1 − ν²)].
IS 1904 / Bjerrum (1963) — raft settlement and differential-settlement limits.
The rigid method has an EXACT closed form, so it is asserted to machine precision. The FEM
is checked against the closed form in the limit where the two must agree (a uniformly loaded
raft on a uniform spring bed settles uniformly, w = q/ks, whatever the plate rigidity),
which is a genuine independent check rather than a self-comparison.
| Test block (the published value it checks) | Verdict |
| flexural rigidity is D = E·t³/[12(1 − ν²)] (Kirchhoff) | Pass |
| a missing ks is correlated as q_safe/s_allow (Bowles 5e Eq 9-6a) | Pass |
| a concentrically loaded rigid raft settles uniformly at s = q/ks (Winkler) | Pass |
| a central point load on a rigid raft gives the same uniform pressure as its UDL | Pass |
| an eccentric load produces the linear pressure distribution and can cause uplift | Pass |
| rigid strip actions follow ACI 336.2R §3.3.2 | Pass |
| the Winkler FEM reproduces w = q/ks for a uniformly loaded raft | Pass |
| a stiffer plate spreads a point load further — the physical signature of the FEM | Pass |
| the Vesić biot_plate branch derives ks from Es and differs from the supplied-ks run | Pass |
| a load outside the footprint is excluded and said so, not silently absorbed | Pass |
| invalid geometry and serviceability limits are both handled | Pass |
rigid-base-pressure-web-validation.test.ts
Rigid rectangular base on a tensionless subgrade — biaxial partial contact (2026-10-03).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Rigid rectangular base on a tensionless subgrade — biaxial partial contact (2026-10-03).
Sources (closed forms printed in the literature; the engine solves the general case numerically, so
agreement is an independent check, not the same formula twice):
[FULL] Full contact inside the kern: q = P/BL (1 ± 6e_x/L ± 6e_y/B) — IS 2950 (Part 1):1981 App D-1.1;
worked example civilgeotools.com "Biaxial footing contact pressure": B 10 ft, L 12 ft, P 400 kip,
e_B 0.20 ft, e_L 0.30 ft → corners 4.233 / 3.433 / 3.233 / 2.433 ksf.
[DAS] One-way partial contact (Das, Principles of Foundation Engineering 8e, Eq. 4.49):
q_max = 4P / (3B(L − 2e)), contact length 3(L/2 − e).
[BB-A] Bellos & Bakas (2017) Int. J. Geomech. 17(7) 04017005, zone A (corner triangle):
q_max = (P/BL) · 3 / (8 (½ − e_x/L)(½ − e_y/B)) — as transcribed in Calcs.com "Footings under
biaxial bending" (https://calcs.com/docs/engineering-concepts/footings-under-biaxial-bending).
[BB-D] Bellos & Bakas zone D/E (trapezoid; the large eccentricity in one direction):
q_max = (P/BL) · ⅓ (2 − √(1 − 12e_x²/L²)) (1 + 6e_x/L + √(1 − 12e_x²/L²)) / (½ − e_y/B),
and its mirror with x ↔ y — same source.
Tolerance 0.1 % — every value is closed-form; the only error is the Newton tolerance.
| Test block (the published value it checks) | Verdict |
| [FULL] inside the kern it is the linear formula (civilgeotools worked example, ksf) | Pass |
| [DAS] one-way partial contact L 10, B 6, e 2.5: q_max 4P/3B(L−2e), contact 3(L/2−e) | Pass |
| [DAS] one-way partial contact L 8, B 8, e 2: q_max 4P/3B(L−2e), contact 3(L/2−e) | Pass |
| [DAS] one-way partial contact L 20, B 12, e 4: q_max 4P/3B(L−2e), contact 3(L/2−e) | Pass |
| [BB-A] corner triangle e_x/L 0.3, e_y/B 0.3: q_max = (P/BL)·3/(8(½−e_x/L)(½−e_y/B)) | Pass |
| [BB-A] corner triangle e_x/L 0.35, e_y/B 0.25: q_max = (P/BL)·3/(8(½−e_x/L)(½−e_y/B)) | Pass |
| [BB-A] corner triangle e_x/L 0.4, e_y/B 0.4: q_max = (P/BL)·3/(8(½−e_x/L)(½−e_y/B)) | Pass |
| [BB-D] trapezoid e_x/L 0.02, e_y/B 0.3 (y-dominant) and its mirror | Pass |
| [BB-D] trapezoid e_x/L 0.05, e_y/B 0.33 (y-dominant) and its mirror | Pass |
| pentagon zone (one corner lifted) satisfies equilibrium and is continuous with the kern | Pass |
| refusals: resultant outside the base, non-positive load | Pass |
seismic-bearing-capacity-ec8-web-validation.test.ts
EN 1998-5:2004 ANNEX F seismic bearing capacity — web-validation benchmark.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 17 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
EN 1998-5:2004 ANNEX F seismic bearing capacity — web-validation benchmark.
SOURCES
1. **EN 1998-5:2004 (E) Annex F** itself — expressions (F.1)–(F.8) and Tables
F.1/F.2. The PDF is a 404-ppi scan whose OCR layer dropped every equation's
right-hand side; the expressions here were read off the rendered pages
(`pdftoppm -r 150`, PDF pages 44–45 = printed 42–43).
2. **Pecker, A., "Design of concrete foundation elements", §4.8 in the EN 1998
worked-examples volume** — §4.8.1.3 "Example of bearing capacity check", a
fully specified worked example BY THE AUTHOR OF THE METHOD, with the
published answer **LHS of (F.1) = −0.999**. Its Table 4.8.1 independently
reproduces Table F.2, which cross-checks that transcription.
Annex F contains no worked example of its own, so Pecker's is the only published
numeric anchor in existence for this expression. It is used two ways below: fed
through the engine end to end, and fed into (F.1) as the text's own rounded
N̄/V̄/M̄/F̄ so the algebra is checked independently of how they were derived.
COUNT: 22 cited values + 6 proof-by-consequence checks.
| Test block (the published value it checks) | Verdict |
| Table F.1 — all 14 numerical parameters, both soil types | Pass |
| Table F.2 — model partial factor γ_Rd, cross-checked against Pecker Table 4.8.1 | Pass |
| F.3 and F.6 — N_max closed forms | Pass |
| F.4 and F.7 — the dimensionless soil inertia force F̄ | Pass |
| Pecker §4.8.1.3 — 6 published intermediates and the published LHS = −0.999 | Pass |
| Pecker §4.8.1.3 — (F.1) reproduces −0.999 from the text’s OWN rounded values | Pass |
| the F̄ strength-basis ambiguity is exactly γ_M, and immaterial in this example | Pass |
| the utilisation is U-SHAPED in N̄ — a footing can fail for too LITTLE axial load | Pass |
| the F.5 / F.8 constraints are refusals, not warnings | Pass |
| the two F.5 permissions are opt-in, and the cohesionless one is CONDITIONAL | Pass |
| the Table F.2 row must match the soil idealisation | Pass |
| Annex F declares itself INFORMATIVE and reports a utilisation, not a safety factor | Pass |
| Annex E — (E.3) is exactly (E.2) with the bracket dropped, so a clamped radical reproduces it | Pass |
| Annex E — the branch switch is continuous at β = φ′_d − θ | Pass |
| Annex E — K rises with kh, with backfill slope, and the passive branch differs from the active | Pass |
| Annex E — (E.1) total design force, and (E.17) hydrodynamic force | Pass |
| Annex E — design angles φ′_d and δ_d divide the TANGENT, not the angle | Pass |
⚑ subgrade-reaction-web-validation.test.ts
PUBLISHED-VALUES: 14 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: about 14 distinct published values (the Baban table is a copy of Bowles).
Analyses validated: subgrade-reaction · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 14 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: about 14 distinct published values (the Baban table is a copy of Bowles). Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
subgrade-reaction — dedicated web-benchmark against PUBLISHED values.
Engine: `subgrade-reaction.ts` — modulus of subgrade reaction k_s (kN/m³) three ways: q/δ (definition),
Vesic's reduced form E_s/(B(1−ν²)) and Bowles's rule k_s = 40·SF·q_a.
SOURCES (each value's locator is beside it; book pages are PDF pages of the files in the reference library)
Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill — §9-6 and Eq. (9-9) (PDF p.531),
Table 9-1 (p.533), Example 9-5 (p.534), Example 10-2 (p.575), Example 10-6 (p.600), Example 10-8 (p.608),
Example 13-2 Step 5 (p.794), Example 13-4 (p.799).
Baban, T.M. (2016), Shallow Foundations: Discussions and Problem Solving, Wiley — §5.10, Eqs. 5.40, 5.42, 5.44,
Table 5.3 (printed pp.406–408). Restates Bowles Eq. 9-9 WITH the safety factor.
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Eq. (8.44) k = q/Δ and Eq. (8.50)
k ≈ Es/(B(1−μs²)) (printed pp.375–378).
Varghese, P.C. (2005), Foundation Engineering, PHI — §1.11.1 Eq. (1.14a) and the Table 1.8 note "k = 120·qu".
ENGINE DEFECT FOUND BY THIS SUITE (fixed in subgrade-reaction.ts, backwards-compatible)
The engine computed the Bowles route as k_s = 40·q_a and its header said "the 40 absorbs FoS". Bowles Eq. 9-9
is k_s = 40·SF·q_a (SF explicit), and Bowles's own worked examples carry it: Ex 9-5 → 40(2)(0.200) =
16 MN/m³; Ex 10-6 → 40(3)(260) = 31 200 kN/m³; Ex 10-8 → 40×3×150 = 18 000 kN/m³; Ex 13-2 → 40(3)(61) = 7 320;
Ex 13-4 → 40(3)(40) = 4 800. The engine was SF× too soft. Fix: optional `safety_factor` (default 1 so old
inputs give old answers). The runner form has no SF field yet and two text strings still repeat the wrong claim
(figures/auto-batch-1.ts, applicability-extracted.ts) — shared files, reported to the orchestrator, not edited.
NOT ASSERTED, and why: Bowles writes the δ = 6 mm factor as 160 and Baban as 165; the exact 1000/6 = 166.7 agrees
with neither, so there is no reliable printed number to test. Bowles Ex 9-5's 11.5 / 25.28 / 13.896 MN/m³ use
Steinbrenner Is·IF (eq. 9-7) rather than this engine's reduced Vesic form and are covered in the
elastic-settlement suite's tables.
| Test block (the published value it checks) | Verdict |
| Bowles (1997) Eq. 9-9 — k_s = 40·SF·q_a in Bowles's own worked examples | Pass |
| Bowles (1997) Example 10-2 and the 25.4 mm / 12 mm / 20 mm factors of Eq. 9-9 | Pass |
| Baban (2016) Eq. 5.44 and Varghese (2005) Table 1.8 note — same rule, stated as a coefficient | Pass |
| Bowles (1997) Table 9-1 / Baban (2016) Table 5.3 — engine results fall in the published clayey-soil ranges | Pass |
| Bowles (1997) Example 9-5 / Baban (2016) Eq. 5.42 / Das (2016) Eq. 8.50 — Vesic reduced form Es/(B(1−μ²)) | Pass |
t6-limit-load-web-validation.test.ts
WEB-VALIDATION for the T6 element-accuracy / limit-load engine (`t6-limit-load.ts`).
Analyses validated: t6-limit-load · Recorded run: passed — 26 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-VALIDATION for the T6 element-accuracy / limit-load engine (`t6-limit-load.ts`).
the release rules gate: ≥20 CITED, exact assertions, each traceable to an authoritative
published result. The T6 (6-node quadratic / Linear-Strain Triangle) element is
verified to (a) pass the constant-strain AND linear-stress patch test EXACTLY on
a distorted mesh, (b) reproduce pure bending exactly (tip deflection vs beam
theory) while CST is grossly too stiff, and (c) have a symmetric, positive-
definite stiffness with exactly the 3 plane rigid-body modes. A coarse
displacement-FE bearing estimate is checked to OVER-predict Prandtl Nc=2+π,
the documented volumetric-locking overshoot.
CITED SOURCES (books on disk in `Geo Technical engineering books/`):
• Zienkiewicz & Taylor, "The Finite Element Method", Vol 1 — patch test; the
T6/LST reproduces a complete linear strain field (element order p=2).
• Bathe, "Finite Element Procedures" — patch test as the convergence gate.
• Cook, Malkus, Plesha & Witt, "Concepts and Applications of Finite Element
Analysis" — CST over-stiffness in bending; LST cures it.
• Timoshenko & Goodier, "Theory of Elasticity" — pure-bending 2-D solution
equals Euler-Bernoulli beam theory: δ = κL²/2, κ = M/(E*·I).
• Nagtegaal, Parks & Rice (1974), CMAME 4:153-177 — volumetric locking of
low-order elements ⇒ over-prediction of incompressible (φ=0) collapse.
• Prandtl (1921); Reissner (1924) — strip-footing exact factor Nc = 2+π = 5.14159.
• Irons & Razzaque (1972) — the patch test for element validity.
| Test block (the published value it checks) | Verdict |
| A1 — no engine errors; a distorted patch mesh with Gauss points was built | Pass |
| A2 — CONSTANT-strain patch: T6 reproduces εxx=g to ~machine zero on a distorted mesh | Pass |
| A3 — LINEAR-stress (pure-bending) patch: T6 reproduces the linear σxx field exactly | Pass |
| A4 — CST CANNOT reproduce the linear stress field (error is order-unity kPa) | Pass |
| A5 — T6 beats CST on the linear field by ≥6 orders of magnitude (the LST advantage) | Pass |
| A6 — patch test PASSES (both T6 errors within tolerance) — element is valid | Pass |
| B1 — exact tip deflection uses κ = M(1−ν²)/(E·I), I = D³/12 (plane strain) | Pass |
| B2 — T6 reproduces pure-bending tip deflection to <1e-3% error (essentially exact) | Pass |
| B3 — T6 tip deflection matches the analytical δ (finest mesh) | Pass |
| B4 — CST is far too stiff: its tip-deflection error is orders larger than T6 | Pass |
| B5 — T6 is exact at EVERY mesh level; CST error only decreases with refinement | Pass |
| B6 — the coarsest CST mesh is grossly too stiff (>25% deflection error) | Pass |
| B7 — T6 mesh has more nodes than the base CST mesh (mid-side enrichment) | Pass |
| C1 — T6 element stiffness is symmetric (Kᵀ = K) | Pass |
| C2 — exactly 3 plane rigid-body modes carry zero energy (2 translations + 1 rotation) | Pass |
| C3 — rigid-body motion produces ~zero nodal forces | Pass |
| C4 — the deformation stiffness is POSITIVE-DEFINITE (Cholesky pivots > 0) | Pass |
| D1 — reported Prandtl reference is exactly Nc = 2 + π = 5.14159 | Pass |
| D2 — coarse displacement-FE bearing is finite, positive, and OVER-predicts Prandtl (locking overshoot) | Pass |
| D3 — bearing carries the honest not-converged limitation note | Pass |
| D4 — bearing is omitted by default (fast path) unless explicitly requested | Pass |
| E1 — pure-bending deflection is LINEAR in applied moment M (δ ∝ M) | Pass |
| E2 — deflection scales as L² (Euler-Bernoulli): δ(2L)/δ(L) = 4 | Pass |
| E3 — near-incompressible ν=0.49: load-driven T6 bending stays exact while CST over-stiffens (Nagtegaal-Parks-Rice locking) | Pass |
| E4 — invalid inputs are guarded: E≤0 records an error, result shape stays well-formed | Pass |
| E5 — narrative notes are present and name the T6/CST contrast | Pass |
two-layer-bearing-web-validation.test.ts
Two-layer bearing capacity, strong-over-weak punching mechanism (`two-layer-bearing.ts`, the Meyerhof-Hanna punching-block model) vs PUBLISHED values.
Analyses validated: two-layer-bearing · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Two-layer bearing capacity, strong-over-weak punching mechanism (`two-layer-bearing.ts`, the
Meyerhof-Hanna punching-block model) vs PUBLISHED values. Every expected number was read from a source opened
for this suite:
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage Learning:
Example 5.4 (sand over soft clay, continuous footing: 154.2 + 107.4 + 21 = 282.6 kN/m²,
qt = 3262.7, q2/q1 = 0.081, Qu = 565.2 kN/m), Example 5.5 (clay over clay: adhesion term 360),
Table 4.2 (Vesić bearing-capacity factors, Nc / Nq / Nγ, 2 d.p.).
Baban, T.M. (2016), Shallow Foundations: Discussions and Problem Solving, Wiley:
Problem 4.23 — the same soil profile as Das Ex 5.4 solved with Ks = 3 (gross qult 304.2 kPa,
Qu = 608 kN/m, top-layer cap not governing).
IS 6403:1981, Code of practice for determination of bearing capacity of shallow foundations:
Table 1 (Nc, Nq, Nγ at 5° steps — page image read).
WHAT MATCHES AND WHAT DOES NOT, SO THE SCOPE OF THE CLAIM IS VISIBLE.
• Continuous (strip) footings: every shape factor is 1 in both conventions, so Das Ex 5.4 and Baban
4.23 are matched to the printed figure. The punching coefficient Ks is a CHART READING in both books
(Das 2.5, Baban 3.0 for the same point); the engine takes it as an explicit input, so each book's own
reading is entered.
• Rectangular footings: the engine uses the De Beer/Vesić sc = 1 + (B/L)(Nq/Nc); Das's special-case
Eq. 5.25/5.32 and Baban Problem 4.19 use the Meyerhof-type 1 + 0.2 B/L (0.2 ≈ 1/5.14 rounded). The
two differ by 0.14 - 0.3 % of qu, which is a difference of convention, not of rounding, so the
rectangular TOTALS (Das Ex 5.5 qu = 656.4 and qt = 715.8; Baban 4.19 qt = 441.54) are NOT asserted.
Das Ex 5.5 is used only for its adhesion term (360 kPa), which does not depend on the shape factor.
• Baban Problems 4.20-4.22 use Meyerhof's Nq/Nγ and shape factors (Nγ(40°) = 93.69 against the
Vesić 109.41 used here), so they are not comparable and are not used.
TABLE TOLERANCES. Das Table 4.2 and IS 6403 Table 1 are the same tabulation of the Vesić factors. They
were evidently computed from an Nq rounded to 2 d.p. — Nγ(50°) = 2(319.07 + 1)tan 50° = 762.89 and
Nc(50°) = (319.07 − 1)/tan 50° = 266.89 both reproduce the printed values exactly, whereas the closed
form gives Nq = 319.057, Nγ = 762.859. The propagated difference is ≤ 1e-4 of the value, so the
table tolerance is max(0.006, 1e-4 × value): 0.006 is the printed 2 d.p. and 1e-4 is the demonstrated
effect of the rounded Nq.
| Test block (the published value it checks) | Verdict |
| Das Example 5.4 — sand over soft clay, continuous footing | Pass |
| Baban Problem 4.23 — the same profile with the chart reading Ks = 3 | Pass |
| Das Example 5.5 — adhesion term of the clay-over-clay punching block | Pass |
| Das Table 4.2 — top-layer Nc, Nq, Nγ | Pass |
| Das Table 4.2 — further top-layer rows (5° and 25°) | Pass |
| Das Table 4.2 — bottom-layer factors, including the φ = 0 clay | Pass |
| IS 6403:1981 Table 1 — the SAME factors as Das Table 4.2 (one source, not two; it reprints the Nc(45°) misprint) | Pass |
well-foundation-web-validation.test.ts
Published-value validation for the well (caisson) foundation elastic-theory check (`well-foundation.ts`, `computeWellFoundation`).
Analyses validated: well-foundation · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation for the well (caisson) foundation elastic-theory check
(`well-foundation.ts`, `computeWellFoundation`). the release rules gate: every expected value is a number
printed in the source below, which was opened for this suite.
SOURCE
Varghese, P.C. (2005), Foundation Engineering, PHI Learning, Chapter 20 "Well Foundations":
· Example 20.1 "Elastic analysis of well foundation" (4 m × 10 m rectangular well, grip 12 m)
· Example 20.3 "Design of well foundation by IRC method" (8.5 m circular well, grip 15 m)
The chapter reproduces the elastic method of the Indian Roads Congress recommendation for
estimating the resistance of soil below maximum scour (code No. 45 of 1972), Annexure 1 —
the method the engine transcribes. The code itself was opened and the engine's formulae
checked against its Steps 2–6 (I = IB + m·Iv(1 + 2μ′α), r = D·I/(2·m·Iv), P = M/r,
σ = (W − μ′P)/A ± M·B/(2I), Coulomb Kp/Ka with δ = ⅔φ ≤ 22½°), but the code prints no worked
numbers for the elastic method, so NO value below is taken from it.
SHORTFALL (honest statement): one source document with numbers. Searched: the local reference
library (Pile-and-well-foundation textbook Ex. 9.1 uses Terzaghi/Rankine bulkhead equations and
W/A ± M/Z, not this method; Indian code commentary; SP 36), and the web (only paywalled/scribd
copies). The suite therefore meets the assertion count on ONE source and must not be read as
two-source validation.
MAPPING NOTES
· Example 20.3 gives the moment "about base level" (M = 42,000 kN·m); the engine takes the
moment at scour level, so M_o = 42,000 − H·D = 42,000 − 2,000 × 15 = 12,000 kN·m.
· Example 20.1 solves for the LIMITING horizontal force Hmax = 2,706 kN (printed), applied 9 m
above scour: M_o = H × 9. The book takes m = nh·D/kv = 1.6 × 12/180 = 0.107 (printed), wall
friction μ′ = 0.4 (δ = atan 0.4) and Rankine Kp = 3, Ka = ⅓ (so γ(Kp − Ka) = 10 × 8/3). The engine's
Kp/Ka are Coulomb (as the code prescribes), so only the Kp-independent chain is compared.
· Example 20.3 computes Kp = 3.69, Ka = 0.27 (source not given) and uses μ = 0.70 in Conditions 1–2 although it
quotes μ = tan 30° = 0.58; neither is reproduced numerically — only the printed verdicts
(all four conditions satisfied) are compared.
TOLERANCES (the book's rounding): it rounds α to 0.18 and μ′ to 0.36 (true 0.1804, 0.3640), which
moves I by 0.17 %; Example 20.1 prints 3–4 s.f. → 0.3 %.
| Test block (the published value it checks) | Verdict |
| Varghese Example 20.3: base area A = π(8.5)²/4 = 56.72 m² | Pass |
| Varghese Example 20.3: Iv = L D³/12 = 2151 m⁴ (L = 0.9 d = 7.65 m) and IB = π d⁴/64 = 256 m⁴ | Pass |
| Varghese Example 20.3: I = IB + m Iv (1 + 2μ′α) = 2,685.7 m⁴ | Pass |
| Varghese Example 20.3 Eq. 20.11: r = I D/(2 m Iv) = 9.36 m | Pass |
| Varghese Example 20.3: P = M/r = 4,487 kN | Pass |
| Varghese Example 20.3 Eq. 20.16: base pressures σ1 = 284 and σ2 = 152 kN/m² | Pass |
| Varghese Example 20.3 Condition 3: m M/I = 15.6 kN/m³ | Pass |
| Varghese Example 20.3: all four conditions satisfied (base friction, direction, elastic state, base pressure) | Pass |
| Varghese Example 20.1: at the limiting elastic state the side reaction is Pmax = γ(KP − KA) L D²/6 = 6,400 kN | Pass |
| Varghese Example 20.1: vertical load at the base W − μ′P = 15,000 − 2,560 = 12,440 kN → mean base pressure 12,440/40 = 311 kN/m² | Pass |
| Varghese Example 20.1: base pressures 809 kN/m² compression and 187 kN/m² tension at Hmax | Pass |
| Varghese Example 20.1: at Hmax, m M/I equals the limiting value γ(KP − KA) = 10 × 8/3 = 26.67 kN/m³ | Pass |
Settlement, stress distribution and consolidation
FE kernel registry — 23 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-verif-flexible-tank | settlement at the centre of the tank [mm] | PLAXIS-Verification-Flexible-tank-elastic-saturated.pdf, p. 2–3 (Output; Table 1) | 74.21 | 74.44 | 74.207 | −4.0e-3 % | −0.31 % | Pass |
k4-gate-terzaghi | Terzaghi U(Tv): bottom excess p/p_ext at t = 2 d (Tv 0.2) [-] | PLAXIS-Verification-One-dimensional-consolidation.pdf, p. 2 (Fig. 2 caption), 4 | 0.7642 | 0.764 | 0.7642 | 0.00 % | +0.03 % | Pass |
k4-gate-terzaghi-fully-coupled | fully coupled (total pore pressure) 1-D consolidation vs Terzaghi [-] | — | — | 0.764 | 0.7642 | — | +0.03 % | Pass |
k4-gate-mandel-cryer | Mandel–Cryer: centre p/q peak (rise above the undrained value) [-] | Rocscience-RS2-Consolidation-Verification-Terzaghi-Biot-Cryer.pdf, p. 12–19 (§2) | — | 0.53804 | 0.53737 | — | −0.13 % | Pass |
k4-gate-skempton-b | Skempton B under isotropic undrained (A) loading [-] | — | — | 0.983278 | 0.983278 | — | 0.00 % | Pass |
k4-gate-oedometric-p0 | oedometric undrained initial excess p0/p_ext [-] | PLAXIS-Verification-One-dimensional-consolidation.pdf, p. 4 | 0.98 | 0.980198 | 0.980198 | +0.02 % | 0.00 % | Pass |
k4-gate-unsaturated-column | unsaturated column: hydrostatic vG state is an equilibrium of the fully coupled phase [kPa] | — | — | 0 | 0 | — | — | Pass |
k4-gate-undrained-b-su | Undrained (B): max shear stress at failure = su [kPa] | — | — | 20 | 20 | — | 0.00 % | Pass |
plaxis-verif-undrained-coarse-ev | case 2 (Hypres coarse, unsaturated): volumetric strain [-] | PLAXIS-Verification-Undrained-soil-behaviour.pdf, p. 7–8 (Table 3) | -0.009963 | -0.009925 | -0.0099562 | −0.07 % | +0.31 % | Pass |
plaxis-verif-undrained-coarse-sv | case 2: effective vertical stress at the top point [kPa] | PLAXIS-Verification-Undrained-soil-behaviour.pdf, p. 7–8 (Table 3) | -15.751 | -15.744 | -15.7481 | −0.02 % | +0.03 % | Pass |
plaxis-verif-undrained-fine-ev | case 3 (Hypres fine): volumetric strain [-] | PLAXIS-Verification-Undrained-soil-behaviour.pdf, p. 7–8 (Table 4) | -0.009823 | -0.009787 | -0.0098162 | −0.07 % | +0.30 % | Pass |
plaxis-verif-undrained-fine-sv | case 3: effective vertical stress [kPa] | PLAXIS-Verification-Undrained-soil-behaviour.pdf, p. 7–8 (Table 4) | -18.419 | -18.413 | -18.4154 | −0.02 % | +0.01 % | Pass |
plaxis-verif-bishop-sv-bottom | Bishop σ′v at the column bottom (10 kPa uniform suction, χ = Se) [kPa] | PLAXIS-Verification-Bishop-effective-stress.pdf, p. 4–5 | -43.264 | -43.2625 | -43.2625 | −3.0e-3 % | 0.00 % | Pass |
plaxis-verif-biot-borehole | borehole wall radial displacement (Biot α < 1) [mm] | PLAXIS-Verification-Biot-poroelasticity.pdf, p. 2–4 | — | -3.5022 | -3.5022 | — | 0.00 % | Pass |
plaxis-verif-flexible-tank-k4-undrained-c | centre settlement, Undrained (C) (total stress Eu, νu) through the K4 drainage types [mm] | PLAXIS-Verification-Flexible-tank-elastic-saturated.pdf, p. 2–3 (Table 1) | 74.21 | 74.44 | 74.207 | −4.0e-3 % | −0.31 % | Pass |
k4-crosscheck-consolidation-biotself-check | consolidation-biot (TS oracle) column: settlement degree U at Tv 0.848 [-] | — | — | 0.90003 | 0.89904 | — | −0.11 % | Pass |
k5b-plaxis-2d-tut9-consolidation-time | Tutorial 9 (Soft Soil undrained A + HS, 4 consolidation phases): time to p_excess < 1 kPa, plus settlements / excess pore pressures per phase [day, mm, kPa] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 145–160 (p. 159: 'more than 50 days are needed to reach full consolidation'; Figs 9-13…9-17 figures only) | > 50 d | — | t at p_excess < 1 kPa (d): 38.69; settlement (0,0) mm P1/P2/P3/P4: [261.4, 664.5, 829.5, 1033.7]; max p_excess kPa P1/P2/P3/P4: [26.6, 0.02, 28.76, 0.53]; toe (20,0) ux mm P4: 199.8; steps P1..P4: [280, 458, 20, 27] | — | — | Superseded |
k5d-plaxis-2d-tut9-ck | Tutorial 9 with the change of permeability c_k (Table 9-1): time to p_excess < 1 kPa; settlements per phase; Safety phases 5–8 [day, mm, -] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 145–163 (p. 159: 'more than 50 days are needed to reach full consolidation'; p. 164 'settles about one meter'; Fig. 9-21 ΣMsf curves without values) | > 50 d; ≈ 1 m | — | t at p_excess < 1 kPa (d): 58.19; settlement (0,0) mm P1/P2/P3/P4: [199.9, 659.7, 746.1, 1031.5]; max p_excess kPa P1/P2/P3/P4: [27.56, 0.88, 33.24, 0.85]; toe (20,0) ux mm P4: 240; Safety ΣMsf from P1/P2/P3/P4 (phases 5–8): [1.0471, 1.8063, 1.1531, 1.4797]; steps P1..P4: [306, 151, 28, 101] | — | — | Pass |
v-rm-degree-of-consolidation-capped-step | time at which the phase stops, U = 50/90/99 % (step capped at 0.005 d) vs Terzaghi t* [day] | PLAXIS-2D-2025.1-Reference-Manual-Seequent-Bentley.pdf, p. p. 328 (§7.5.3, Eq. 7-15); PLAXIS-Verification-One-dimensional-consolidation.pdf pp. 1–4 | — | [3.864, 10.5194, 20.0399] | [3.8692, 10.5293, 20.0545] | — | [0.13, 0.09, 0.07] | Pass |
v-rm-min-excess-capped-step | stop time for |P-stop| = 0.30 and 0.05 kPa (step capped 0.005 d) vs Terzaghi t* [day] | PLAXIS-2D-2025.1-Reference-Manual-Seequent-Bentley.pdf, p. p. 328 (§7.5.2) | — | [5.8942, 13.3026] | [5.8993, 13.3144] | — | [0.09, 0.09] | Pass |
v-rm-consolidation-stop-default-stepping | stop time with the DEFAULT step control: P-stop 0.30 / U 50 % / U 90 % [day] | PLAXIS-2D-2025.1-Reference-Manual-Seequent-Bentley.pdf, p. p. 328 (§7.5.2–7.5.3) | — | [5.8942, 3.864, 10.5194] | [5.9194, 3.8771, 10.5903] | — | [0.43, 0.34, 0.67] | Pass |
v-rm-drain-at-level-terzaghi | base excess pressure at t = 2 d, top drained by a DRAIN line (head = level) [kPa] | PLAXIS-Verification-One-dimensional-consolidation.pdf, p. pp. 1–4 (Fig. 2 caption); RM p. 134 (§5.9.2) | 0.7642 | 0.764 | 0.7642 | −2.0e-3 % | +0.03 % | Pass |
v-rm-drain-head-ignored-in-consolidation | drain with head 0.2 m (level 1 m) in a consolidation phase: worst |p − Terzaghi| [kPa] | PLAXIS-2D-2025.1-Reference-Manual-Seequent-Bentley.pdf, p. p. 134 (§5.9.2) | — | 0 | 0.00115 | — | — | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
plaxis-verif-flexible-tank — Pass · K2
Case: cases/plaxis-verification-flexible-tank-elastic-saturated.json
Mesh: T15 axisymmetric, Medium, 4 m cluster under the tank refined 0.5 (domain geometry), 761 elements
Reproduce: tests/k2_integration.rs plaxis_flexible_tank_centre_settlement
Notes: 'Undrained (C)' is a total-stress analysis with Eu, νu and no pore pressures — identical to linear elastic E = Eu, ν = νu, run as such (not an undrained K4 feature). Lancellotta's value uses Ip = 1.16 read from Terzaghi's chart.
k4-gate-terzaghi — Pass · K4
Reference: Terzaghi / Verruijt 2001 series
Mesh: T15, 10 rows
Reproduce: tests/k4_coupled.rs plaxis_one_dimensional_consolidation_terzaghi
Notes: Undrained A, then consolidation phases. Worst |Δ| over t = 0.1…100 d: 0.0011 (T15 P4–P2), 0.0014 (T6 P2–P1, t=2 d 0.7651); equal order (PLAXIS-style) worst 0.0011 late but shows the early-time pressure oscillation (t = 0.1 d: 0.8564 vs 0.9802). Initial p0 = 0.98 p_ext (compressible water, as PLAXIS). Gate 0.2 % (0.5 % equal order); PLAXIS t = 2 d within 0.002. Cui Δt_min 4.17e-3 d reported (first step 1e-3 d < Δt_min, warned).
k4-gate-terzaghi-fully-coupled — Pass · K4
Reference: Terzaghi
Reproduce: tests/k4_coupled.rs fully_coupled_one_dimensional_equals_terzaghi
Notes: Same column through the fully-coupled path (total pressures, gravity, pkind 2). Worst 0.0011; gate 0.002.
k4-gate-mandel-cryer — Pass · K4
Reference: Mandel 1953 / Abousleiman 1996 series
Reproduce: tests/k4_coupled.rs mandel_cryer_effect (ignored: ~5 min)
Notes: Peak at Tv 0.02 (Tv = cv t/(3a²), confirmed vs the plot); worst |Δ| 0.0051 q over the history; gate 0.01 q and peak > 1.05 × undrained. Time-domain series from the literature (the on-disk source prints the Laplace form only). Slow because the rigid smooth plate is modelled by a stiff slick interface: marked #[ignore], must be run explicitly.
k4-gate-skempton-b — Pass · K4
Reference: Skempton 1954 / Biot closed form
Reproduce: tests/k4_undrained.rs skempton_b_isotropic_undrained_a
Notes: Also B = 0.9 given (exact) and νu = 0.45 → 0.827586206896552 (exact). Gate 1e-10.
k4-gate-oedometric-p0 — Pass · K4
Reference: closed form
Reproduce: tests/k4_undrained.rs oedometric_undrained_initial_excess
Notes: Worst 3.1e-13; gate 1e-10.
k4-gate-unsaturated-column — Pass · K4
Reference: exact (equilibrium)
Reproduce: tests/k4_coupled.rs unsaturated_column_equilibrium
Notes: Steady-flow gravity phase (Bishop, ignoreSuction false) then a fully coupled phase: pressures stay hydrostatic (< 1e-6 kPa) and displacements < 1e-9 m. This gate found a defect: the pressure-residual reference summed the pressure-gradient and gravity parts of the Darcy flux, which cancel at hydrostatic equilibrium, so a residual of round-off size was judged 51 % and the phase never converged — fixed by taking their magnitudes separately.
k4-gate-undrained-b-su — Pass · K4
Reference: exact
Reproduce: tests/k4_coupled.rs undrained_b_strength_is_su
Notes: MC c = su, φ = ψ = 0 on effective stiffness; p_ex 19.5 kPa positive under compression. Gate 1e-6.
plaxis-verif-undrained-coarse-ev — Pass · K4
Reference: document analytical
Reproduce: tests/k4_undrained.rs plaxis_undrained_soil_behaviour
Notes: S = 0.6050 (an. 0.6049, PLAXIS 0.6062); Kw_unsat = Kw/(S + (1−S)Kw/Kair). Gate closed form 0.2 %, PLAXIS εv 0.2 %, p_ex 2 %. Case 1 (saturated): εv −1.9802e-4 = PLAXIS −1.980e-4.
plaxis-verif-undrained-coarse-sv — Pass · K4
Reference: document analytical
Reproduce: tests/k4_undrained.rs plaxis_undrained_soil_behaviour
Notes: p_w 9.9219 (PLAXIS 9.924), p_ex −0.0756 (−0.076).
plaxis-verif-undrained-fine-ev — Pass · K4
Reference: document analytical
Reproduce: tests/k4_undrained.rs plaxis_undrained_soil_behaviour
Notes: S 0.8623 = analytical = PLAXIS.
plaxis-verif-undrained-fine-sv — Pass · K4
Reference: document analytical
Reproduce: tests/k4_undrained.rs plaxis_undrained_soil_behaviour
Notes: p_w 9.7837 (PLAXIS 9.785), p_ex −0.2138 (−0.215).
plaxis-verif-bishop-sv-bottom — Pass · K4
Reference: closed form σ′ = σ − χ pw
Reproduce: tests/k4_undrained.rs plaxis_bishop_effective_stress
Notes: Top −3.2646 (PLAXIS −3.264); σ′h −0.8162 / −10.8156 (PLAXIS −0.816 / −10.816). Steady flow with a prescribed suction; γ = (1−Se)γunsat + Se γsat. Gate 2e-3 kPa.
plaxis-verif-biot-borehole — Pass · K4
Reference: Lamé / Detournay & Cheng
Reproduce: tests/k4_undrained.rs plaxis_biot_borehole_alpha
Notes: Initial σ′ = P0 + α p (p_active 35 720) to 0.03 kPa; Δσrr/Δσθθ equal the Lamé thick-cylinder values (finite 5 m model; Kirsch infinite-medium −3.5 mm). PLAXIS: figures only. The printed Eqs. 3–5 have flipped signs vs the plotted curves (flagged).
plaxis-verif-flexible-tank-k4-undrained-c — Pass · K4
Reference: Lancellotta (Ip 1.16 chart)
Case: cases/plaxis-verification-flexible-tank-k4.json
Reproduce: tests/k4_coupled.rs plaxis_flexible_tank_k4_undrained_c_a_and_consolidation
Notes: The same answer through Undrained (A) (Eu-equivalent Kw, eInit 0.1 so the 2e6 cap is not hit) 74.207 mm (gate 1e-6 relative); then consolidation to the end: 115.153 mm vs a drained run 115.156 (−0.0024 %, gate 0.1 %).
k4-crosscheck-consolidation-biot — Pass · K4
Reference: packages/geotech consolidation-biot (TS oracle)
Reproduce: tests/k4_crosscheck.rs crosscheck_consolidation_biot_column
Notes: Worst |kernel − oracle| U 0.0010, base p/q 0.0014 (Terzaghi 0.89998). Differences: compressible water (kernel p0 = 0.98 q) vs incompressible oracle, element types and time stepping. Gate 0.4 % of the load.
k5b-plaxis-2d-tut9-consolidation-time — Superseded · K5b
Case: cases/plaxis-2d-tutorial-09-road-embankment-k5b.json
Mesh: 301 T15 / 3189 nodes (kernel 'medium')
Reproduce: tests/k5b_tutorials.rs tutorial9_road_embankment_soft_soil_consolidation (ignored: ~27 min release)
Superseded by: k5d-plaxis-2d-tut9-ck
Notes: Superseded: this run used a constant permeability. The tutorial specifies a permeability change (Table 9-1, c_k); the run with it is k5d-plaxis-2d-tut9-ck, 58.19 d against the tutorial's "more than 50 days" (pass). || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): t 38.48 → 38.69 d (still below the tutorial's '> 50 days' — pre-existing deviation, 0.2 d closer), settlement P1–P4 [261.7, 664.6, 830.1, 1033.6] → [261.4, 664.5, 829.5, 1033.7] mm, max p_excess [26.6, 0.03, 28.66, 0.62] → [26.6, 0.02, 28.76, 0.53] kPa, toe ux P4 200.7 → 199.8 mm, steps [308, 577, 17, 28] → [280, 458, 20, 27]. Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (HS layers of the Soft Soil + HS profile); total run 1 262 s. || Runs end to end, every phase converges, min-excess phase ends below 1 kPa (asserted). Full consolidation at 38.5 d vs PLAXIS '> 50 days': the permeability change ck (Table 9-1) is NOT modelled (constant k: faster dissipation), no unsaturated (vG) flow in the embankment, a different mesh. Step control desiredIter 15 / maxSteps 1000 (PLAXIS defaults). Two HS fixes came out of this case (cap floor + vertex return for newly activated, stress-free clusters). K5d-2 re-run of this case (constant k): 37.91 d, 1 032.4 mm — the K5d min-excess minStep fix (minStep relative to the phase's first increment; before, a shrinking step was clamped UP to minStep 1e-7 on the 1e10·Δt_min scale) changes phase 4's step path. With c_k: row k5d-plaxis-2d-tut9-ck (60.73 d).
k5d-plaxis-2d-tut9-ck — Pass · K5d-2 (c_k, D109, min-excess minStep)
Case: cases/plaxis-2d-tutorial-09-road-embankment-k5d.json
Mesh: 301 T15 (kernel 'medium')
Reproduce: tests/k5d_tutorials.rs tutorial9_road_embankment_permeability_change (ignored; ~15 min release)
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): t(p_excess < 1 kPa) 64.07 → 58.19 d (qualitative reference '> 50 days' still met), settlement P1–P4 [200.2, 660.0, 747.5, 1033.6] → [199.9, 659.7, 746.1, 1031.5] mm (P4 2.1 mm closer to the tutorial's 'about one meter'), max p_excess [27.56, 0.91, 33.16, 0.58] → [27.56, 0.88, 33.24, 0.85] kPa, toe ux P4 241.1 → 240.0 mm, ΣMsf 5–8 [1.0469, 1.807, 1.1535, 1.4813] → [1.0471, 1.8063, 1.1531, 1.4797], steps [383, 154, 19, 143] → [306, 151, 28, 101]. Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (HS layers); the all-phases re-run of 2 Nov replaces the mixed pre-FH-4 / FH-4 values of the older note below. 617 s. || D139 (FH-4, ordering-only path change at near-critical steps): the min-excess stop moved 60.73 → 64.07 d (still inside the tutorial's "> 50 days"); the other values are the pre-FH-4 run (not re-run on this branch). c_k moves full consolidation from 38.48 d (constant k, row k5b-plaxis-2d-tut9-consolidation-time) to 60.73 d — now inside the tutorial's '> 50 days'; the final settlement is unchanged (1 033.6 mm, 'about one meter'). The kernel's consolidation defaults (desiredIter 15, maxSteps 1000) replace the case's explicit control. The min-excess phase needed the K5d fix of minStep (relative to its first increment). Safety phases: HS / Soft Soil as frozen-stiffness MC.
v-rm-degree-of-consolidation-capped-step — Pass · verify-plaxis2d
Reference: Terzaghi (Verruijt 2001) base pressure = (1 − U) p0, p0 = 0.98 p_ext, c_v with K_w/n = 49500
Mesh: T15, 10 rows
Reproduce: tests/v_plaxis_rm_loading_types.rs degree_of_consolidation_stops_at_eq_7_15_terzaghi
Notes: Asserted: stop reason, p_end ≤ threshold, base p = Terzaghi at the reported time (0.002 kPa), not early.
v-rm-min-excess-capped-step — Pass · verify-plaxis2d
Reference: Terzaghi, as above
Mesh: T15, 10 rows
Reproduce: tests/v_plaxis_rm_loading_types.rs min_excess_pore_pressure_stops_at_pstop_terzaghi
Notes: Also 0.02 d cap: 5.9093 d (+0.3 %).
v-rm-consolidation-stop-default-stepping — Pass · verify-plaxis2d
Reference: Terzaghi, as above
Mesh: T15, 10 rows
Reproduce: tests/v_plaxis_rm_loading_types.rs min_excess_default_step_control_matches_terzaghi (default cargo test; not ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14), DEFAULT step control: stop at P-stop 0.30 t = 5.9194 d (Terzaghi t* 5.8942), base p 0.29969 kPa vs Terzaghi at that time 0.29818 kPa ('minimum excess pore pressure reached'); U 50 % t = 3.8771 d (Terzaghi t* 3.864), base p 0.48961 kPa vs Terzaghi at that time 0.48855 kPa ('degree of consolidation reached'); U 90 % t = 10.5903 d (Terzaghi t* 10.5194), base p 0.09792 kPa vs Terzaghi at that time 0.09635 kPa ('degree of consolidation reached'). Asserted: the stop reason, max |p_ex| ≤ threshold, |p − Terzaghi(t)| < 0.002 kPa (the PLAXIS 1-D case's gate), not before t*. Fixed by D558 (the driver shortens the step that would cross the criterion and bounds its growth towards it, RM §7.5.2–7.5.3 p. 328); the row had stayed stale since. Before: 8.5292 / 8.5292 / 17.0625 d (+44.7 / +120.7 / +62.2 %), one very large final step.
v-rm-drain-at-level-terzaghi — Pass · verify-plaxis2d
Reference: Terzaghi / Verruijt 2001
Mesh: T15, 10 rows
Reproduce: tests/v_plaxis_rm_drain.rs drain_line_on_the_top_at_the_level_reproduces_terzaghi_and_the_plaxis_value
Notes: Worst |p − Terzaghi| over t = 0.1…100 d: 0.00115 kPa.
v-rm-drain-head-ignored-in-consolidation — Pass · verify-plaxis2d
Reference: RM: 'drains reduce the excess pore pressure to zero and the specified head is ignored'
Reproduce: tests/v_plaxis_rm_drain.rs drain_head_is_ignored_in_consolidation (default cargo test; not ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): with the drain at head 0.2 m on the 1 m column the worst |p − Terzaghi| over t = 0.1…100 d is 0.00115 kPa and p(base, 2 d) = 0.7642 kPa (PLAXIS 0.7642) — identical to the drain at the level (0.00115 kPa / 0.7642 kPa). Gate 0.002 kPa (the PLAXIS 1-D consolidation case's own, asserted). Fixed by D559 (commit 97efe208, model/flow.rs FlowBcKind::Drain: in a consolidation phase a drain prescribes p_excess = 0 and its head is ignored, RM §5.9.2 p. 134); the row had stayed stale since. Before the fix the drained boundary was held at (head − level)·γw = −8 kPa excess (worst 8.000 kPa off Terzaghi).
Cited validation suites — 39
asaoka-web-validation.test.ts
Validation of the Asaoka observational settlement forecast (`asaoka.ts`) against the PUBLISHED method.
Analyses validated: asaoka · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the Asaoka observational settlement forecast (`asaoka.ts`) against the PUBLISHED method.
⚠️ THIS SUITE IS PARTIAL AND SAYS SO. The Asaoka method is a regression plus two closed-form relations, and the
library holds no worked example that prints a settlement record together with the forecast it produced:
· Asaoka (1978) prints its Kobe Port and Shin-Ube records only as plots (Figs 3–4) and the Bayesian
forecasts as probability-density curves (Figs 6–8), with no tabulated readings;
· Han (2015) Problem 7.24 gives a 25-day settlement table but no answer;
· the Hong Kong Port Works Design Manual Part 3 Appendix C gives the theory and no example.
So NO published forecast answer could be reproduced, and the expected values below are HAND-COMPUTED from the
printed equations (they prove the implementation matches the published method, not that the method predicts
a given site). They do not count toward the ≥20-published-values bar; the shortfall is the full 20.
Published method (every equation read from the page named beside it):
1. Asaoka, A. (1978), "Observational procedure of settlement prediction", Soils and Foundations 18(4) 87–101
(open access, J-STAGE) — Eq. (21) ρj = β0 + β1·ρj−1, Eq. (23) ρf = β0/(1 − β1), Eq. (24)
ρj = ρf − (ρf − ρ0)·β1^j.
2. Han, J. (2015), Principles and Practice of Ground Improvement, Wiley — Eqs 7.60–7.63 (p. 240):
Sn = β0 + β1·Sn−1, Sf = β0/(1 − β1), and cv = −4·hdr²·ln β1/(π²·Δt) for vertical flow only.
3. Hong Kong CEDD, Port Works Design Manual Part 3, Appendix C (read 2026-10-07, cedd.gov.hk) — Eq. C2–C4:
β1 = exp(−c·Δt) with Terzaghi's dominant eigenvalue, i.e. β1 = exp(−π²·cv·Δt/(4H²)).
KNOWN, DISCLOSED DIFFERENCE FROM ASAOKA'S ORIGINAL PAPER. Asaoka's own first-order relation (Eqs 25–26) is
ln β1 = −6cv·Δt/H² (drained both faces) or −2cv·Δt/H² (upward drainage). The engine instead uses the exact
Terzaghi eigenvalue of Han Eq. 7.63 / CEDD C4 (ln β1 = −π²cv·Δt/(4·Hdr²)), which is the form current practice
prints. The two forms differ by 20–40 %; the engine follows the later, exact one, and the test below pins it.
| Test block (the published value it checks) | Verdict |
| Asaoka Eq. (23): a record generated by Eq. (24) returns ρf = β0/(1 − β1) | Pass |
| Asaoka Eq. (21): the regression slope is β1 and the intercept is β0 = ρf(1 − β1) | Pass |
| Asaoka Eq. (23) with the Kobe Port No. 3 posterior modes (β1 = 0.9791, β0 = 6.94 cm, Fig. 6): ρf = 332 cm | Pass |
| Han Eq. 7.63 / CEDD C4: cv = −4·hdr²·ln β1/(π²·Δt) for β1 = 0.8, hdr = 3 m, Δt = 30 days | Pass |
| CEDD C3/C4 inverted: a Terzaghi-exponent record β1 = exp(−π²·cv·Δt/(4·H²)) gives back the cv that made it | Pass |
| Asaoka 1978 Eq. (26) is NOT what the engine uses: for upward drainage ln β1 = −π²cv·Δt/(4H²), not −2cv·Δt/H² | Pass |
| Asaoka Eq. (24): degree of consolidation and remaining settlement at the last reading | Pass |
burland-burbidge-web-validation.test.ts
PUBLISHED-VALUES: 16 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: about 16 distinct published values.
Analyses validated: burland-burbidge · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 16 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: about 16 distinct published values. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
burland-burbidge — dedicated web-benchmark against PUBLISHED values.
Engine: `burland-burbidge.ts` — settlement of shallow foundations on sand and gravel from the average SPT N
(compressibility index Ic = 1.71/N^1.4; s = fs·fl·q·B^0.7·Ic in mm; over-consolidated 1/3 and q−⅔σ′pc branches;
creep factor ft = 1 + R3 + R·log10(t/3)). The ORIGINAL 1985 paper was not opened — every value below is
read from a textbook that reproduces the method, named here with the locator next to each value.
SOURCES
Knappett, J.A. and Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon — §8.8 "Analysis using SPT
data", Eqs 8.62–8.68 (printed pp.310–312, page images read), Example 8.9 + Table 8.15 (printed pp.322–323).
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — §7.6 "Burland and Burbidge's
Method", Table 7.7, Example 7.6 (printed pp.326–328).
Baban, T.M. (2016), Shallow Foundations: Discussions and Problem Solving, Wiley — Eq. 3.15–3.18, Table
3.13, Problem 3.7 (printed pp.159–160, 194–195).
Viana da Fonseca, A. (2012), Handbook of Tropical Residual Soils Engineering, ch.8 — Eq. 8.3 (Ic
coefficient 1.71, "influence depth z = B^0.75" attributed to the method).
TWO FORMS OF ONE METHOD — read before trusting any tolerance below
Craig Eq 8.65a is the original millimetre form s = q·B^0.7·Ic, exactly what the engine codes. Das and Baban
re-express it as Se/BR = α1·α2·α3·fs·(B/BR)^0.7·(q/pa) with BR = 0.3 m, pa = 100 kPa, α1 = 0.14. Algebra
(hand-derived here, labelled as such): the Das/Baban constant in the mm form is 0.14·0.3^0.3·10 = 0.9757, i.e.
their rounded α1 = 0.14 stands for 1/(10·0.3^0.3) = 0.1435 ⇒ their settlements run 2.4 % below the
original-form value, and Baban additionally rounds α2 to ONE significant figure (0.007 for 0.00714, −1.8 %).
Tolerances for the Das/Baban settlements are set from exactly these published roundings, not fitted.
Their influence depth z′ = 1.4·BR·(B/BR)^0.75 equals 1.0362·B^0.75 against the engine's B^0.75 (Viana da
Fonseca; Craig Fig 8.31), a constant 3.6 % — both are fits to the same scatter chart and z_I only enters the
engine through the thin-layer factor fl.
Craig's chart reads (Fig 8.31) are given to one decimal metre on a log axis: tolerance 0.1 m.
| Test block (the published value it checks) | Verdict |
| Craig (2012) Example 8.9 — compressibility index Ic = 1.71/N^1.4 at N = 10, 9, 8 | Pass |
| Craig (2012) Example 8.9 — settlement coefficient and the three converged widths give 25 mm | Pass |
| Craig (2012) Fig 8.31 read in Example 8.9 — depth of influence z_I against B | Pass |
| Craig (2012) Eq 8.68 text — creep factor Ft after 30 years, static vs variable loading | Pass |
| Das (2016) Example 7.6 — 1.75 m square, N60 = 10, q = 120 kPa, normally consolidated | Pass |
| Das (2016) Table 7.7 — over-consolidated branches use 1/3 of the normally consolidated compressibility | Pass |
| Baban (2016) Problem 3.7 — 7.5 × 8.5 m pier base on dense sand and gravel, N = 40 | Pass |
| Viana da Fonseca (2012) Eq 8.3 — coefficient 1.71 and influence depth B^0.75 | Pass |
| Craig (2012) Eqs 8.64, 8.66, 8.67 — N correction, shape factor, thin-layer factor (equation form) | Pass |
⚑ circular-load-stress-web-validation.test.ts
circular-load-stress — dedicated web-benchmark against PUBLISHED values.
Analyses validated: circular-load-stress · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
circular-load-stress — dedicated web-benchmark against PUBLISHED values.
Engine: `circular-load-stress.ts` — Boussinesq vertical stress under the CENTRE of a uniformly loaded flexible
circular area, Δσ_z = q·[1 − 1/(1+(R/z)²)^1.5].
SOURCES (locators beside each value)
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Table 6.1 (Δσ/q for a uniformly loaded
flexible circular area after Ahlvin and Ulery 1962; the r = 0 column, printed p.266, 3 d.p.) and Example 6.6
(printed pp.284–286).
Varghese, P.C. (2005), Foundation Engineering, PHI — Table 3.3, Newmark's influence-chart radii: r/z for
σz/q = 0.1 … 0.9 (printed p.54), derived from this same equation.
Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill — §5-3 text listing the same qv/qo ↔
±r/z pairs under Eq. (c) (PDF p.317).
Holtz, R.D. and Kovacs, W.D. (1981), An Introduction to Geotechnical Engineering, Prentice-Hall — Example 8.20
(printed p.353–354; scan read by OCR of the page image).
TOLERANCES, stated before running
• Das Table 6.1: 3 d.p. ⇒ 5e-4.
• Newmark table: the printed quantity is r/z to 3 d.p., the asserted quantity is σ/q = I(r/z). The slope dI/d(r/z) =
3x(1+x²)^(-5/2) peaks at 0.86 near x = 0.5, so a half-unit (5e-4) in r/z moves I by at most 4.3e-4 ⇒ 5e-4 asserted.
• Das Ex 6.6: printed to 2 d.p. ⇒ 5e-3 kPa. H&K chart read J = 0.63: a quarter of a 0.02 chart division ⇒ 5e-3.
NOT ASSERTED: Das Table 6.1 (r=0, z/(B/2)=1.2) prints 0.546 (page image checked); the closed form gives 0.54662, which
rounds to 0.547 — 6.2e-4 from the printed cell, beyond a 5e-4 half-unit, consistent with the book having truncated
a higher-precision value. Omitted, not loosened.
NOT ASSERTED: Das Table 6.1 (r=0, z/(B/2)=2.0) prints 0.286 — the same figure as the next column (r/(B/2) = 0.2, also
0.286, where the value must be lower); the closed form at r = 0 is 0.28446, 1.5e-3 away. A printing error in the table
(page image checked); omitted. The other fourteen cells of the column agree within half a unit.
NOT ASSERTED: Lambe & Whitman (1979) Example 8.2 (R = 3 m, z = 3 m) reads 0.64 from Fig 8.4 where the closed form is
0.6464 — a 1 % chart-reading slip, more than a quarter division; left out rather than passed with a wider tolerance.
ENGINE DOC FIX: the header said the 10 %-of-q depth is "≈ R·2.0"; the equation gives 3.70 R (Das Table 6.1: 0.146 at
z = 3R, 0.087 at 4R; Lambe & Whitman: "less than 0.10 Δq at a depth of 4R"). Comment corrected; no code change.
| Test block (the published value it checks) | Verdict |
| Das (2016) Table 6.1, r/(B/2) = 0 column — Δσ/q against z/(B/2), fourteen published values | Pass |
| Varghese (2005) Table 3.3 and Bowles (1997) §5-3 — the Newmark r/z ↔ σz/q pairs | Pass |
| Das (2016) Example 6.6 — B = 2 m circular area, q = 150 kPa, at z = 1, 3.5 and 6 m | Pass |
| Holtz & Kovacs (1981) Example 8.20 — 3.91 m diameter tank, 117 kPa, z = 2 m under the centre | Pass |
collapse-potential-web-validation.test.ts
Validation for `collapse-potential` — single-oedometer collapse potential I_c = Δh/h0 = Δe/(1+e0), ASTM D5333 severity and Jennings & Knight foundation-risk bands (`collapse-potential.ts`, `computeCollapsePotential`).
Analyses validated: collapse-potential · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `collapse-potential` — single-oedometer collapse potential I_c = Δh/h0 = Δe/(1+e0), ASTM D5333
severity and Jennings & Knight foundation-risk bands (`collapse-potential.ts`, `computeCollapsePotential`).
Published sources (every number below was read from the page/table named beside it; none is recalled):
1. Jennings, J.E. & Knight, K. (1975), "A guide to construction on or with materials exhibiting additional
settlement due to collapse of grain structure", Proc. 6th Regional Conf. for Africa on SMFE, Durban — the
collapse-potential severity table 0–1 / 1–5 / 5–10 / 10–20 / > 20 %. The primary paper was NOT opened;
the table was read in three independent reproductions: the NZ Geotechnical Society article "The
identification and characterisation of collapsible soils: a brief review of current practice" (table
captioned "after Jennings and Knight 1975"); Fattah, M.Y., Hameedi, M.K. & Aswad, M.F. (2017), Diyala
Journal of Engineering Sciences 10(2), pp. 75–85, Table III; and the ISSMGE ARCSMGE 2024 paper no. 223.
2. ASTM D5333-03, Measurement of Collapse Potential of Soils, Table 1 (severity: 0 none, 0.1–2.0 slight,
2.1–6.0 moderate, 6.1–10.0 moderately severe, > 10.0 severe) and Eq. I_c = Δh/h0·100 = Δe/(1+e0)·100, read ONLY
as reproduced in Fattah et al. (2017), Table III and Eq. 1–2 (Jennings & Knight and ASTM D5333-2003 columns
side by side). The standard itself is paywalled and not in the library; the limits are therefore
secondary-source evidence.
3. Structville (2020), "Calculation of Collapse Settlement of Collapsible Soils", a worked double-oedometer
example (method after Murthy, V.N.S. (2012), Textbook of Soil Mechanics and Foundation Engineering,
CBS): H = 4 m, e0 = 0.64, Δe_c = 0.04 ⇒ S2 = 0.0975 m. The example is the blog's own; Murthy supplies
the method, not these numbers.
ENGINE FIX RECORDED HERE. `severityD5333` returned "none" for I_c ≤ 0.1 %; the table prints "0.1 to 2.0" as
SLIGHT, so exactly 0.1 % is slight. Changed to "< 0.1 % is none" (below 0.1 % the table is silent and the
engine keeps "none" as measurement noise). The existing `mk(0.05) ⇒ none` test is unaffected.
SHORTFALL — formula-fidelity evidence only beyond the printed bands. Only ONE numeric worked example (the
Structville S2 value) was found whose inputs are printed with its answer; the ASTM D5333 report example and
the Jennings & Knight paper (both paywalled/unopened) are the obvious sources for more. Published-value
count is reported honestly in the final report, not padded with engine output.
| Test block (the published value it checks) | Verdict |
| ASTM D5333 Table 1: 0 none; 0.1–2.0 slight | Pass |
| ASTM D5333 Table 1: 2.1–6.0 moderate; 6.1–10.0 moderately severe; > 10.0 severe | Pass |
| Jennings & Knight (1975): 0–1 no problem; 1–5 moderate trouble; 5–10 trouble | Pass |
| Jennings & Knight (1975): 10–20 severe trouble; > 20 very severe trouble | Pass |
| Structville (2020) worked example: Δe_c = 0.04, e0 = 0.64, H = 4 m ⇒ collapse settlement S2 = 0.0975 m | Pass |
compression-index-web-validation.test.ts
Validation of the compression / recompression index estimator (`compression-index.ts`) against the published correlations and the published WORKED ANSWERS that use them.
Analyses validated: compression-index · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the compression / recompression index estimator (`compression-index.ts`) against the
published correlations and the published WORKED ANSWERS that use them.
⚠️ THIS SUITE IS PARTIAL AND SAYS SO. Only four printed numeric answers for these correlations were found in
the reference library (section A). The rest (sections B–C) check that the engine's coefficients are the ones
the sources print; those expected values are HAND-COMPUTED from the printed equation and are NOT published
answers, so they do not count toward the ≥20-published-values bar. The engine is therefore NOT claimed
validated to that bar: the shortfall is 16 published values. Published measured Cc values exist (Lambe &
Whitman Table 22.1) but comparing a correlation with scatter of ±30 % (Bowles Table 2-5) against individual
soils tests the correlation, not the implementation, and selecting the rows that happen to agree would be
cherry-picking, so none are used.
Published sources (every number was read from the page named beside it):
1. Bowles, J.E. (1997), Foundation Analysis and Design 5th ed., McGraw-Hill — Table 2-5 "Correlation
equations for soil compressibility/consolidation" (Terzaghi & Peck Cc = 0.009(wL − 10), Nagaraj &
Srinivasa Murthy Cc = 0.00234·wL·Gs and Cr = 0.000463·wL·Gs); Example 5-14 (wL = 78 % ⇒ 0.612) and
Example 5-15 (wL = 50 % ⇒ 0.36).
2. Varghese, P.C. (2005), Foundation Engineering, PHI — Examples 4.7 (LL = 40 % ⇒ Cc = 0.27) and 4.11
(LL = 65.5 % ⇒ Cc = 0.50).
2b. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage — Eq. 2.56, Nagaraj & Murty
Cc = 0.2343[LL(%)/100]·Gs (the coefficient the engine uses; Bowles prints it rounded to 0.00234).
3. Lambe, T.W. & Whitman, R.V. (1979), Soil Mechanics, SI Version, Wiley — Ch. 22: Terzaghi & Peck's two
expressions, remoulded Cc = 0.007(wl − 10 %) and undisturbed Cc = 0.009(wl − 10 %).
4. FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I — Table 5-5 (Hough-type
Cc = 0.30(e0 − 0.27) for inorganic silt and silty clay; Cc = 0.009(LL − 10)).
5. IS 8009 (Part 1):1976, cl. 9.2.2.2 Eq. (7) and (8) — Cc = 0.009(wL − 10) and Cc = 0.30(e0 − 0.27).
(The scan's OCR drops some digits; the coefficients were read from the OCR text and cross-checked with the
identical equations printed in FHWA-NHI-06-088 Table 5-5.)
NOT COVERED, DISCLOSED. The engine's "Azzouz" term Cc = 0.01(wn − 5) could not be located in any book in the
library (Bowles Table 2-5 prints Azzouz et al. as Cc = 0.37(e0 + 0.003wL + 0.0004wN − 0.34), a different
equation), so that term and the "recommended" mean built from it are unverified against a source.
TOLERANCES. Worked answers are printed to 2–3 s.f.: Bowles 0.612 ⇒ ±0.001, 0.36 ⇒ ±0.005; Varghese 0.27 ⇒
±0.005, 0.50 ⇒ ±0.005 (the exact product is 0.4995).
| Test block (the published value it checks) | Verdict |
| Bowles Example 5-14: wL = 78 % ⇒ Terzaghi–Peck Cc = 0.009(78 − 10) = 0.612 | Pass |
| Bowles Example 5-15: wL = 50 % ⇒ Terzaghi–Peck Cc = 0.36 | Pass |
| Varghese Example 4.7: LL = 40 % ⇒ Cc = 0.009 × 30 = 0.27 | Pass |
| Varghese Example 4.11: LL = 65.5 % ⇒ Cc = 0.009 × 55.5 = 0.50 | Pass |
| Lambe & Whitman Ch. 22 / Bowles Table 2-5: undisturbed Cc = 0.009(LL − 10) and remoulded Cc = 0.007(LL − 10) at LL = 60 | Pass |
| IS 8009 (Part 1) Eq. (8) / FHWA Table 5-5: Hough Cc = 0.30(e0 − 0.27) at e0 = 1.0 | Pass |
| Das Eq. 2.56 / Bowles Table 2-5: Nagaraj & Murthy Cc = 0.2343(LL/100)·Gs and Cr = 0.000463·wL·Gs at wL = 60, Gs = 2.7 | Pass |
| IS 8009 (Part 1) Eq. (7): the IS correlation equals the Terzaghi–Peck one at LL = 35 % (0.225) | Pass |
consolidation-biot-web-validation.test.ts
Web-benchmark validation for the COUPLED BIOT consolidation FE (`consolidation-biot.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 33 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the COUPLED BIOT consolidation FE
(`consolidation-biot.ts`). the release rules hard gate — ≥12 cited values against
INDEPENDENT closed forms.
The 1-D coupled Biot (u–p) problem is analytically identical to Terzaghi's
1-D consolidation (Verruijt; Lewis & Schrefler §3; Potts Vol.1 §10). So the
emergent degree-of-consolidation curve and the excess-pore-pressure isochrones
of this FE must reproduce:
1. The EXISTING `consolidation-terzaghi.ts` series `terzaghiUavg(Tv)` and
`terzaghiPorePressureRatio(Z,Tv)` — the in-repo reference.
2. The STANDARD Terzaghi U–Tv table (independent, textbook):
U=0.20→Tv≈0.031 · U=0.50→Tv≈0.197 · U=0.70→Tv≈0.403 · U=0.90→Tv≈0.848
(Das, "Principles of Geotechnical Engineering", Terzaghi Table; Craig,
"Soil Mechanics").
3. Phase relations / closed forms:
Eoed = E(1−ν)/[(1+ν)(1−2ν)] (constrained modulus)
cv = (k/γw)·Eoed (coefficient of consolidation)
s∞ = σ·H/Eoed (final 1-D primary settlement)
The FE agrees with Terzaghi to <0.5 % here; tolerances are set generously
(≤0.02 absolute / ≤3 % relative) to remain robust across mesh density.
| Test block (the published value it checks) | Verdict |
| Eoed = E(1−ν)/[(1+ν)(1−2ν)] — constrained modulus | Pass |
| cv = (k/γw)·Eoed | Pass |
| final settlement s∞ = σ·H/Eoed | Pass |
| U_settlement(Tv=0.05) reproduces terzaghiUavg | Pass |
| U_settlement(Tv=0.1) reproduces terzaghiUavg | Pass |
| U_settlement(Tv=0.2) reproduces terzaghiUavg | Pass |
| U_settlement(Tv=0.3) reproduces terzaghiUavg | Pass |
| U_settlement(Tv=0.5) reproduces terzaghiUavg | Pass |
| U_settlement(Tv=0.848) reproduces terzaghiUavg | Pass |
| U_pressure(Tv=0.2) reproduces terzaghiUavg | Pass |
| U_pressure(Tv=0.5) reproduces terzaghiUavg | Pass |
| U_pressure(Tv=0.848) reproduces terzaghiUavg | Pass |
| standard table: U(Tv=0.008) ≈ 0.1 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.031) ≈ 0.2 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.071) ≈ 0.3 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.126) ≈ 0.4 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.197) ≈ 0.5 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.287) ≈ 0.6 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.403) ≈ 0.7 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.567) ≈ 0.8 (Das/Terzaghi) | Pass |
| standard table: U(Tv=0.848) ≈ 0.9 (Das/Terzaghi) | Pass |
| standard table: U(Tv=1.129) ≈ 0.95 (Das/Terzaghi) | Pass |
| isochrone u_e/u₀ at (Z≈0.333, Tv=0.2) reproduces Terzaghi | Pass |
| isochrone u_e/u₀ at (Z≈0.500, Tv=0.2) reproduces Terzaghi | Pass |
| isochrone u_e/u₀ at (Z≈1.000, Tv=0.2) reproduces Terzaghi | Pass |
| isochrone u_e/u₀ at (Z≈0.500, Tv=0.5) reproduces Terzaghi | Pass |
| isochrone u_e/u₀ at (Z≈1.000, Tv=0.5) reproduces Terzaghi | Pass |
| isochrone u_e/u₀ at (Z≈1.000, Tv=0.848) reproduces Terzaghi | Pass |
| drained face u_e=0; peak at the impermeable base; monotone with depth | Pass |
| double drainage: Hdr = H/2 and cv unchanged | Pass |
| double drainage U_settlement(Tv=0.2) reproduces terzaghiUavg | Pass |
| double drainage U_settlement(Tv=0.5) reproduces terzaghiUavg | Pass |
| U_settlement ≈ U_pressure (the 1-D Terzaghi identity) | Pass |
⚑ consolidation-degree-web-validation.test.ts
Validation for `consolidation-degree` — the Terzaghi U ↔ T_v relationship (`consolidation-degree.ts`).
Analyses validated: consolidation-degree · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `consolidation-degree` — the Terzaghi U ↔ T_v relationship (`consolidation-degree.ts`).
Published sources (every number below was read from the book/manual page named beside it; the
sources were opened as PDFs in the repo's reference library, none is recalled from memory):
1. FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Ch. 7 —
Table 7-4 "Average degree of consolidation U versus time factor Tv" (p. 7-32) and
Example 7-3 (p. 7-37).
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage —
Table 2.11 "Variation of Tv with U" (Eqs 2.78/2.79) and Example 2.12 (Ch. 2, §2.15).
3. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Spon/CRC —
Example 4.7 (Ch. 4, p. 139), vertical-drainage part.
WHAT THE ENGINE IS. `computeConsolidationDegree` implements the two-branch published approximation of
the Terzaghi series (Das Eq. 2.78 for U ≤ 60 %, Eq. 2.79 for U > 60 %), not the Fourier series itself.
FHWA Table 7-4 prints the EXACT series solution to 3 decimals, and Das Table 2.11 prints a 3-s.f. table
built from the same equations. Tolerances below therefore are, in every case:
· for a Tv printed to 3 decimals: ±0.001 (one unit in the last printed digit — the approximation and
the exact series round differently in the third decimal, e.g. at U = 50 % Eq. 2.78 gives 0.1963 and
the exact series 0.1968, both printed by the books as 0.197);
· for a U derived from a printed Tv: the printed-digit half-unit propagated through dU/dTv;
· for a worked-example end result: the propagated rounding of the Tv values the book itself rounds.
KNOWN, DELIBERATELY-UNTESTED PUBLISHED ENTRIES (investigated, not hidden):
· FHWA Table 7-4 prints Tv = 1.163 at U = 95.0 %. The exact series gives 1.129 and Das Table 2.11 prints
1.129 at U = 95 %; the FHWA entry is a misprint, so it is not asserted.
· U = 60 %: Eq. 2.78 gives 0.2827 whereas the exact series (FHWA 0.287, Das 0.286) is 1.3 % higher. That
is the documented junction error of the published two-branch approximation, so it is not asserted
with a widened tolerance.
· Tv(U) at 93.1 % / 99.4 %: Eq. 2.79 is 1.0 % / 0.6 % away from FHWA's 1.000 / 2.000 (a property of the
approximation at the very top of the curve); only the forward U(Tv) direction is asserted there.
| Test block (the published value it checks) | Verdict |
| FHWA Table 7-4: Tv required for U = 10…98 % | Pass |
| FHWA Table 7-4: U reached at the tabulated Tv | Pass |
| Das Table 2.11 entries (Tv printed to 3 s.f.) | Pass |
| Das Example 2.12: U = 40/87.5 = 45.7 % needs Tv = 0.164; field time 45,523 min (31.6 days) | Pass |
| FHWA Example 7-3: t90 = Tv·Hd²/cv = 0.848·10²/0.2 = 424 days | Pass |
| Craig Example 4.7: Tv = 4.7·0.5/10² = 0.0235 ⇒ Uv = 0.17 | Pass |
consolidation-family-web-validation.test.ts
consolidation-family-web-validation.test.ts
Analyses validated: consolidation-3d, coupled-consolidation, footing-bearing-3d · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
consolidation-family-web-validation.test.ts
Continues working the list `scripts/unvalidated-outputs.mjs` produces — displayed
outputs whose result key is never named anywhere a reference value could be attached
to it. `coupled-consolidation` was the worst remaining entry with 6 of its 7 outputs
unanchored, alongside 5 of `consolidation-3d`'s 19 and 5 of `footing-bearing-3d`'s 12.
These are the cheapest possible things to anchor and there was no excuse for the gap:
one-dimensional consolidation is the most thoroughly tabulated closed form in the
subject, and the Vesić/Meyerhof shape factors are two lines of algebra. The reason
they slipped is the one the footing load defect exposed — an engine gets anchored on
its headline result, and the supporting quantities beside it never do.
Sources, all standard and all in `Geo Technical engineering books/`:
· Terzaghi (1943) *Theoretical Soil Mechanics*; Das, *Principles of Geotechnical
Engineering* Table 9.x — the U–T_v relation, with the two exact anchors
T_v(U = 50 %) = 0.197, T_v(U = 90 %) = 0.848
and the small-U series T_v = (π/4)U² (Das Eq. 9.30 / Taylor).
· c_v = k·E_oed/γ_w and E_oed = E(1−ν)/((1+ν)(1−2ν)) — the confined (oedometer)
modulus, i.e. the 1-D constrained modulus of linear elasticity.
· Biot (1941) — the coupled u–p formulation the engine integrates. In the CONFINED
one-dimensional case the coupled solve must reduce EXACTLY to Terzaghi, which is
the strongest available statement about it and is what these tests assert.
· Vesić (1973) / Meyerhof (1963) — s_c = 1 + 0.2(B/L), s_q = 1 + (B/L)tanφ,
s_γ = 1 − 0.4(B/L); Skempton (1951) — square/circular φ=0 gives s_c = 1.2.
· Skempton & Bjerrum (1957) — the settlement-ratio correction μ.
| Test block (the published value it checks) | Verdict |
| Terzaghi U(T_v) reproduces the published table, both directions (10 anchors) | Pass |
| Terzaghi U and T_v are exact inverses, and the small-U branch follows (π/4)U² | Pass |
| coupled-consolidation: E_oed, c_v and H_dr from the closed forms (6 anchors) | Pass |
| coupled-consolidation: final settlement is the confined 1-D value q·H/E_oed | Pass |
| coupled-consolidation: t₅₀ and t₉₀ match Terzaghi T_v·H_dr²/c_v, and U ends consistent (6 anchors) | Pass |
| consolidation-3d: the oedometer and Boussinesq comparisons it prints are the textbook values (7 anchors) | Pass |
| consolidation-3d: the Q2–Q1 pair reports more displacement DOF than pressure DOF | Pass |
| footing-bearing-3d: shape factors follow Vesić/Meyerhof, and Skempton for a square (11 anchors) | Pass |
consolidation-terzaghi-web-validation.test.ts
Validation for the Terzaghi consolidation series (`consolidation-terzaghi.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Terzaghi consolidation series (`consolidation-terzaghi.ts`).
the release rules gate. Anchors (independent — Das/Craig standard U–Tv table):
U=0.10→Tv≈0.008 · U=0.50→Tv≈0.197 · U=0.90→Tv≈0.848 · U=0.20→Tv≈0.031.
| Test block (the published value it checks) | Verdict |
| U_avg(Tv=0.002) ≈ 0.05 (standard table) | Pass |
| U_avg(Tv=0.008) ≈ 0.1 (standard table) | Pass |
| U_avg(Tv=0.031) ≈ 0.2 (standard table) | Pass |
| U_avg(Tv=0.071) ≈ 0.3 (standard table) | Pass |
| U_avg(Tv=0.126) ≈ 0.4 (standard table) | Pass |
| U_avg(Tv=0.197) ≈ 0.5 (standard table) | Pass |
| U_avg(Tv=0.286) ≈ 0.6 (standard table) | Pass |
| U_avg(Tv=0.403) ≈ 0.7 (standard table) | Pass |
| U_avg(Tv=0.567) ≈ 0.8 (standard table) | Pass |
| U_avg(Tv=0.848) ≈ 0.9 (standard table) | Pass |
| boundary values: U(0)=0, U(large)→1 | Pass |
| small-time approximation √(4Tv/π) matches the series for U<0.5 | Pass |
| pore-pressure isochrone: full u0 at t=0, drained face (Z=0) → 0 | Pass |
| Casagrande Tv(U) closed form matches the series-implied Tv | Pass |
⚑ consolidation-time-rate-web-validation.test.ts
Web-benchmark validation for `consolidation-time-rate` — Terzaghi 1-D consolidation.
Analyses validated: consolidation-time-rate · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `consolidation-time-rate` — Terzaghi 1-D consolidation.
WHY THIS SUITE EXISTS. One of the 48 bespoke analyses with zero web-validation coverage,
and among the most consequential: "how long until it has settled" appears in essentially
every settlement report, and the answer scales with Hdr², so a drainage-path or time-factor
error is a multiple, not a nudge.
PUBLISHED ANCHOR — the average-degree-of-consolidation table. The Uav-Tv pairs below are
the classical tabulation of the Terzaghi Fourier solution and are reproduced identically
in the standard references:
Terzaghi, K., Peck, R.B. & Mesri, G. (1996) "Soil Mechanics in Engineering Practice",
3rd ed., §16 (Tv vs Uav for uniform initial excess pore pressure).
Das, B.M. "Principles of Geotechnical Engineering" — Variation of Tv with Uav.
IS 8009 (Part 1):1976 — time rate of consolidation settlement.
U (%) 10 20 30 40 50 60 70 80 90
Tv 0.008 0.031 0.071 0.126 0.197 0.287 0.403 0.567 0.848
Tolerance is 0.001 — the last published digit. That is rounding, not slop: the table is
quoted to three decimals, so agreement can only ever be asserted to that.
ONE HONEST CAVEAT, at U=60 %. The exact series gives 0.28640, and the standard references
do not agree with each other in the third decimal there — Das tabulates 0.286 while other
printings of the same solution give 0.287. The series lands between them, which is the
evidence that both are roundings of the same number rather than a disagreement about the
theory. Every other entry is matched to ≤0.0004. This is recorded rather than papered over
by quietly picking whichever printed value the code happened to reproduce.
AUDIT NOTE (E-89). The engine previously used the two-branch hand approximation
(Tv = (π/4)U² below 60 %, 1.781 − 0.933·log₁₀(100−U) above). Measured against the table
above it errs by −1.83 % at U=10 %, +1.34 % at U=20 % and −1.48 % at U=60 %, and it is
discontinuous by 1.25 % at the switchover. Worse, `settlement.ts` held a second copy whose
boundary was `U < 0.6` against this module's `U <= 0.6`, so at exactly U=60 % the two took
different branches and disagreed. The engine now uses the exact series and both modules
share it; the approximation is retained as `timeFactorFromUApprox` and separately tested,
because it is what a hand or spreadsheet check reproduces.
| Test block (the published value it checks) | Verdict |
| Tv matches all nine published Uav–Tv pairs (TPM 1996 §16) | Pass |
| U(Tv) inverts the published table at every point | Pass |
| T50 and T90 meet the values the module advertises | Pass |
| E-89: the hand approximation deviates from the table where measured | Pass |
| E-89: Tv is smooth through U=60% (no branch step) | Pass |
| double drainage quarters the time (Hdr = H/2) | Pass |
| worked case: t90 = T90·Hdr²/Cv | Pass |
| settlement at the target degree is U × ultimate | Pass |
coupled-consolidation-web-validation.test.ts
Validation of the COUPLED CONSOLIDATION analysis (Biot u–p finite-element column, `consolidation-biot.ts`: `biotColumn` and the runner wrapper `computeBiotColumnConfig`) against PUBLISHED consolidation tables and worked examples.
Analyses validated: coupled-consolidation · Recorded run: passed — 26 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the COUPLED CONSOLIDATION analysis (Biot u–p finite-element column,
`consolidation-biot.ts`: `biotColumn` and the runner wrapper `computeBiotColumnConfig`) against
PUBLISHED consolidation tables and worked examples.
WHY THESE BENCHMARKS. For a laterally confined column the 1-D Biot (u–p) problem is identical to
Terzaghi's 1-D consolidation (Biot's poroelasticity; Verruijt; Lewis & Schrefler Ch. 3 — theory background, none of
them used as a value source here). The finite-element solve is
therefore checked against the published Terzaghi U–Tv table and against textbook worked examples that use
the oedometer modulus Eoed = 1/mv, cv = k·Eoed/γw and S∞ = Δσ·H/Eoed — the quantities the analysis reports.
`consolidation-biot-web-validation.test.ts` already compares the FE with the in-repo Terzaghi series; THIS file
compares it with numbers printed in books.
Published sources (every number was read from the page named beside it; none is recalled):
1. FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Ch. 7 —
Table 7-4 "Average degree of consolidation U versus time factor Tv" (p. 7-32) and Example 7-3
(p. 7-37, t90 = 424 days).
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage —
Table 2.11 "Variation of Tv with U"; Example 2.12 (lab t50 = 4.5 min, cv = 7.061 mm²/min);
Example 2.13 (mv = 0.00108 m²/kN, cv = 1.23e-5 m²/min, k = 1.303e-7 m/min).
3. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Example 4.2 (Table 4.2:
mv·Δσ′·H = 86.1 mm and 30.0 mm) and Example 4.7 (final settlement mv·Δσ′·H = 162 mm).
INPUT MAPPING. Books that give mv are entered as Eoed = 1/mv by choosing E for ν = 0.3:
E = Eoed·(1+ν)(1−2ν)/(1−ν). The engine recovers Eoed from (E, ν) with the standard constrained-modulus
relation (also printed in Knappett & Craig §5.2 and CFEM 4th ed. Eq. 11.24), so the round trip is exercised.
Permeability is entered in m/day, times are read back in days.
TOLERANCES, derived from what the source prints and from the FE's stated resolution:
· FHWA/Das U–Tv rows printed as whole per cent: ±0.5 percentage points (half the printed unit).
· The two FHWA rows printed to 0.1 % (93.1 %, 99.4 %): ±0.1 (half-unit 0.05 + 0.05 allowed for the FE at
30 elements, the runner's fixed mesh).
· Example 7-3 t90 = 424 days printed as a whole number: ±1 day.
· Craig settlements: 86.1 and 30.0 mm are printed to 0.1 mm ⇒ ±0.1 mm; 162 mm is the printed value of
0.25·65·10 = 162.5 ⇒ ±1 mm.
· Das cv = 1.23e-5 printed to 3 s.f. ⇒ ±0.5 %; lab t50 = 4.5 min printed to 2 s.f. ⇒ ±0.05 min.
| Test block (the published value it checks) | Verdict |
| the FE run completed without a time-step warning | Pass |
| FHWA Table 7-4: Tv = 0.031 ⇒ U = 20 % | Pass |
| FHWA Table 7-4: Tv = 0.071 ⇒ U = 30 % | Pass |
| FHWA Table 7-4: Tv = 0.126 ⇒ U = 40 % | Pass |
| FHWA Table 7-4: Tv = 0.197 ⇒ U = 50 % | Pass |
| FHWA Table 7-4: Tv = 0.287 ⇒ U = 60 % | Pass |
| FHWA Table 7-4: Tv = 0.403 ⇒ U = 70 % | Pass |
| FHWA Table 7-4: Tv = 0.567 ⇒ U = 80 % | Pass |
| FHWA Table 7-4: Tv = 0.848 ⇒ U = 90 % | Pass |
| FHWA Table 7-4: Tv = 1.000 ⇒ U = 93.1 % | Pass |
| FHWA Table 7-4: Tv = 1.500 ⇒ U = 98.0 % | Pass |
| FHWA Table 7-4: Tv = 2.000 ⇒ U = 99.4 % | Pass |
| FHWA Table 7-4 (pore-pressure definition): Tv = 0.197 ⇒ U = 50 % | Pass |
| FHWA Table 7-4 (pore-pressure definition): Tv = 0.403 ⇒ U = 70 % | Pass |
| FHWA Table 7-4 (pore-pressure definition): Tv = 0.848 ⇒ U = 90 % | Pass |
| Das Table 2.11: Tv = 0.159 ⇒ U = 45 % | Pass |
| Das Table 2.11: Tv = 0.477 ⇒ U = 75 % | Pass |
| Das Table 2.11: Tv = 0.684 ⇒ U = 85 % | Pass |
| Das Table 2.11: Tv = 1.129 ⇒ U = 95 % | Pass |
| Das Table 2.11: Tv = 1.781 ⇒ U = 99 % | Pass |
| FHWA Example 7-3: t90 = 424 days (single drainage, Hd = 10 ft, cv = 0.2 ft²/day) | Pass |
| Craig Example 4.2: upper clay (mv = 0.35 m²/MN, Δσ′ = 82 kPa, H = 3 m) settles 86.1 mm | Pass |
| Craig Example 4.2: lower clay (mv = 0.13 m²/MN, Δσ′ = 77 kPa, H = 3 m) settles 30.0 mm | Pass |
| Craig Example 4.7: mv = 0.25 m²/MN, Δσ′ = 65 kPa, H = 10 m gives a final settlement of 162 mm | Pass |
| Das Example 2.13: k = 1.303e-7 m/min with mv = 0.00108 m²/kN gives cv = 1.23e-5 m²/min | Pass |
| Das Example 2.12 (lab specimen): 25.4 mm double-drained, cv = 7.061 mm²/min ⇒ t50 = 4.5 min | Pass |
⚑ cv-oedometer-web-validation.test.ts
Web-benchmark validation for `cv-oedometer` — coefficient of consolidation from an oedometer time–compression curve.
Analyses validated: cv-oedometer · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `cv-oedometer` — coefficient of consolidation from an
oedometer time–compression curve.
WHY THIS FILE EXISTS. Measured 2026-09-18 with `validation-coverage-report.mjs`, this was one of
exactly THREE of the 234 audit units with no `*-web-validation` suite of any kind — not a thin
one, none. It is also a signable number: c_v sets the consolidation RATE, so an overstated value
predicts settlement finishing far sooner than it will.
SOURCES — two independent ones, and they disagree by 0.5%, which is itself worth encoding.
[IS 2720-15] IS : 2720 (Part 15) — Determination of consolidation properties.
§6.1.1.5 c_v = 0.848·(H/2)² / t₉₀ (root-time / Taylor plot)
§6.1.2.4 c_v = 0.197·(H/2)² / t₅₀ (log-time / Casagrande plot)
Read from the PDF in the reference library. NOTE the document's own running
header reads "IS : 2720 ( Part 15 ) - 1986", while the library filename says
1965 — the filename is wrong, and the 1986 edition is what these clauses are
quoted from.
[Craig 4.3] R.F. Craig, *Craig's Soil Mechanics*, 8th ed., Example 4.3 (book p.125–126).
Oedometer test, 214 → 429 kPa increment, Gs = 2.73.
Given: drainage path d = 7.40 mm; t₅₀ = 12.5 min; √t₉₀ = 7.30 → t₉₀ = 53.3 min;
m_v = 0.70 m²/MN.
Published answers: c_v = 0.45 m²/year (log time), c_v = 0.46 m²/year (root
time), k = 1.0 × 10⁻¹⁰ m/s.
Equations read from a 150 dpi page render — the text layer drops the
right-hand side of every numbered equation, so the values are transcribed from
the rendered page, not from `pdftotext`.
THE 0.5% DISAGREEMENT IS REAL AND IS NOT AVERAGED AWAY. Craig uses T₅₀ = 0.196; IS 2720-15
§6.1.2.4 and this engine use 0.197. The exact theoretical value of T₅₀ is 0.19680…, so both
roundings are defensible and both appear in the literature. Every Casagrande assertion below
therefore carries a tolerance that admits the ratio 0.197/0.196 = 1.0051 and no more — it is
pinned, not loosened, so a real drift still fails. Craig also uses γ_w = 9.8 kN/m³ where this
engine uses 9.81 (+0.1%), which only affects the permeability check.
HONEST COUNT. This suite carries 9 assertions traceable to a published value or a standard's
clause, which is BELOW the ≥20-cited-value bar the release rules sets for a live engine. It is committed
as a real floor where there was nothing, not as a claim that the bar is met. Raising it needs
further worked examples from sources whose text layer survives extraction: Holtz & Kovacs in the
library is a scan with no text layer (0 lines from `pdftotext`) and Das's is ligature-damaged
("5" for "="), so both need page renders to mine.
| Test block (the published value it checks) | Verdict |
| [IS 2720-15 §6.1.2.4] the log-time time factor is 0.197 | Pass |
| [IS 2720-15 §6.1.1.5] the root-time time factor is 0.848 | Pass |
| [Craig 4.3] log-time method reproduces the published c_v = 0.45 m²/year | Pass |
| [Craig 4.3] root-time method reproduces the published c_v = 0.46 m²/year | Pass |
| [Craig 4.3 + IS 2720-15] the drainage path is HALF the specimen thickness | Pass |
| [Craig 4.3] the two methods agree on the same specimen to within 1.3% | Pass |
| [Craig 4.3] permeability from c_v·m_v·γw reproduces k = 1.0e-10 m/s | Pass |
| k is null, not zero, when m_v is not supplied | Pass |
| c_v scales with the square of the drainage path, per the closed form | Pass |
| a cleared fitting time is refused rather than producing a huge c_v | Pass |
| an oedometer drainage path in metres is flagged as a units error | Pass |
differential-settlement-ec7-web-validation.test.ts
Differential settlement — the **EUROPEAN** check, validated against **EN 1997-1:2004 Annex H**, *"Limiting values of structural deformation and foundation movement"*.
Analyses validated: differential-settlement · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Differential settlement — the **EUROPEAN** check, validated against **EN 1997-1:2004 Annex H**,
*"Limiting values of structural deformation and foundation movement"*.
Source: `Geo Technical engineering books/EN-1997-1-2004_Eurocode-7-Geotechnical-Design-Part-1_full-370p-with-annexes.pdf`
Cross-checked against the JRC workshop *Eurocode 7: Geotechnical Design — Worked examples*
(2013), Table 3.4.1, which reproduces the same limits alongside Burland/Bjerrum damage criteria.
─────────────────────────────────────────────────────────────────────────────
WHY THIS EXISTS
─────────────────────────────────────────────────────────────────────────────
`differential-settlement` had only the Indian check (`IS1904_TABLE`, all 24 cells verified
earlier in this audit). A structure-damage analysis that can only be judged against IS 1904
makes an international product look Indian. Annex H is the direct European counterpart, so the
engine now carries both and a caller can report the same site under either standard.
─────────────────────────────────────────────────────────────────────────────
THE PUBLISHED PROVISIONS, verbatim from Annex H
─────────────────────────────────────────────────────────────────────────────
**(2)** *"The maximum acceptable relative rotations for open framed structures, infilled frames
and load bearing or continuous brick walls are unlikely to be the same but are likely to range
from about **1/2000 to about 1/300**, to prevent the occurrence of a serviceability limit state
in the structure. A maximum relative rotation of **1/500** is acceptable for many structures.
The relative rotation likely to cause an ultimate limit state is about **1/150**."*
**(3)** *"The ratios given in (2) apply to a **sagging** mode… For a **hogging** mode (edge
settling more than part between), the value should be **halved**."*
**(4)** *"For normal structures with isolated foundations, **total settlements up to 50 mm** are
often acceptable."*
**(5)** *"These guidelines concerning limiting settlements apply to normal, routine structures."*
**A deliberate restraint.** Annex H is **informative**, not normative. It is therefore reported
as guidance, and the check does not assert a verdict with the finality that the normative IS 1904
Table 1 permits. Presenting an informative annex as a hard code limit would overstate it — and
that restraint is asserted below, because it would be easy to "improve" it away.
| Test block (the published value it checks) | Verdict |
| EN 1997-1 Annex H (2) — the published rotation range 1/2000 … 1/300, with 1/500 the general value | Pass |
| EN 1997-1 Annex H (3) — hogging HALVES the acceptable ratio | Pass |
| the Annex H check applied end to end, at the published thresholds | Pass |
| Annex H is reported as INFORMATIVE guidance, not as a normative limit | Pass |
| the three-state assessable flag is honoured — no verdict on no data | Pass |
| the SAME site can be judged under both standards, and they differ meaningfully | Pass |
differential-settlement-web-validation.test.ts
C.DIFF — `differential-settlement` web-benchmark against IS 1904:1986 Table 1, 72 cited values (24 cells × 3 quantities).
Analyses validated: differential-settlement · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
C.DIFF — `differential-settlement` web-benchmark against IS 1904:1986 Table 1,
72 cited values (24 cells × 3 quantities).
SOURCE
`Geo Technical engineering books/IS-1904-1986-design-construction-foundations-in-soils-general.pdf`
— IS:1904-1986, *Code of Practice for Design and Construction of Foundations in Soils:
General Requirements*, **Table 1** ("Permissible Differential Settlements and Tilt
(Angular Distortion) for Shallow Foundation in Soils", Clause 16.3.4), page 23. This is
the Bureau of Indian Standards' own Right-To-Information public-disclosure edition.
WHY THIS SUITE EXISTS
`differential-settlement.ts` asserts in a comment that Table 1 is "Transcribed verbatim."
That is a strong claim about safety-relevant numbers — permissible settlements an engineer
signs against — and until now nothing checked it. Every one of the 24 cells below is
transcribed independently from the PDF and compared against `IS1904_TABLE`.
─────────────────────────────────────────────────────────────────────────────────────────
A NEAR-MISS WORTH RECORDING: the PDF's own text layer is WRONG
─────────────────────────────────────────────────────────────────────────────────────────
`pdftotext` on this PDF reports the steel / isolated / plastic-clay differential
coefficient as **`*0039L`** (i.e. 0.0039), while the code has **0.0033**. That looks like
a transcription bug in our engine.
It is not. The BIS RTI scans carry an OCR'd text layer, not born-digital text, and this
one is demonstrably lossy — it renders `100` as "log", `125` as "12s", and `1/5000` as
"l/So00". Re-rendering page 23 at 400 dpi and running `tesseract` independently gives:
i) For steel structure 50 '0033L 1/300 50 -0033L 1/300 75 -0033L 1/300 100 -0033L 1/300
All four steel cells are **0.0033L**. The `9` was a misread `3`. Corroborated by internal
consistency: the same cell's angular limit is 1/300 = 0.00333, which matches 0.0033 and
not 0.0039.
**Had the text layer been trusted, a correct table would have been "corrected" into a
wrong one.** This is exactly why the repo rule is that an expected value must trace to a
citable source *and* why a second independent read matters when the source is a scan.
Verdict: all 24 cells of `IS1904_TABLE` are correct as committed.
| Test block (the published value it checks) | Verdict |
| C.DIFF.1: all 24 cells of IS 1904:1986 Table 1 match the engine transcription | Pass |
| C.DIFF.2: the steel row is 0.0033L in ALL four columns (the OCR near-miss) | Pass |
| C.DIFF.3: the differential coefficient is consistent with the angular limit | Pass |
| C.DIFF.4: checkIS1904 applies the published limits to a computed settlement pattern | Pass |
| C.DIFF.5: the "not likely to be encountered" cells report applicable:false, not a pass | Pass |
| C.DIFF.6: E-6/Q-1 regression — one point must NOT report a pass | Pass |
⚑ elastic-settlement-web-validation.test.ts
elastic-settlement — dedicated web-benchmark against PUBLISHED values.
Analyses validated: elastic-settlement · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
elastic-settlement — dedicated web-benchmark against PUBLISHED values.
Engine: `elastic-settlement.ts` — Steinbrenner (closed-form F1/F2) immediate settlement of a flexible
rectangle on a finite layer over a rigid base, with the Fox depth factor supplied as an input and the
0.93 rigid-footing reduction.
SOURCES (every value below was read from a book opened for this suite; locator beside each value)
Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill — Table 5-2 (printed p.304–305,
PDF pp.331–332; cells checked against the page IMAGE), Eq. (5-16a)/(c), Example 5-7, Example 5-13.
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Tables 7.2 and 7.3 (printed
pp.305–308), Eq. (7.4)/(7.12), Example 7.2 (printed p.310, image checked).
Baban, T.M. (2016), Shallow Foundations: Discussions and Problem Solving, Wiley — Problems 3.2 and 3.3
(printed pp.188–189), of which only P3.2 re-solves Das Example 7.2 with the standard Steinbrenner Is (P3.3 is a different data set: clean NC sand, Es = α·Pa·N60; independent audit 2026-10-07, A3-D1).
WHAT IS PUBLISHED-ANSWER EVIDENCE HERE
• Steinbrenner influence-factor tables (Bowles T5-2, Das T7.2/T7.3): 3-decimal published numbers. The
engine's F1 and F2 are compared with the printed cell to ±0.0005 — half a unit in the last printed
place — because the books print 3 d.p. (tolerance 5.1e-4 = that half-unit plus floating slack).
• Worked-example answers in mm (Baban P3.2/P3.3, Bowles Ex 5-7) — see each test for the tolerance
reason (the books print 3 significant figures).
BOOK ERRATA FOUND WHILE DOING THIS (recorded so nobody "fixes" the engine toward a misprint)
(1) Bowles 5e Table 5-2, N=5.0, M=2.5: prints I1 = 0.553. The closed form (Bowles Eq. 5-16b, the same
expression the engine implements), Das Table 7.2 (0.543) and the monotone trend of the row
(N=4 → 0.484, N=6 → 0.585) all give 0.543. The cell is omitted here; the engine is right.
(2) Das 8th ed. Example 7.2 (p.310) computes Is = F1 + (2−μs)/(1−μs)·F2 = 0.716 and Se = 13.3 / 12.4 mm,
but Steinbrenner's factor — and Bowles Eq. (c), Baban Eq. 3.5, Das's own text — is
(1−2μs)/(1−μs), giving Is = 0.659, Se = 12.3 mm flexible / 11.4 mm rigid (Baban P3.2 solves the
identical problem that way). The engine uses (1−2μs)/(1−μs), so it reproduces Baban, not Das's
printed 13.3. Das's F1 = 0.641 and F2 = 0.031 for this example ARE asserted (they are table reads).
(3) Das Table 7.2 row n′=4.25 is non-monotone in m′ (e.g. 0.514 at m′=3 above 0.496 at m′=5) — printing
errors; 28 of 1720 Das cells disagree with the closed form, all in a few rows. Only cells that are
internally consistent are asserted. Das Table 7.3 n′=0.5,m′=3.5 prints 0.0878 (4 d.p.) — omitted.
(4) Bowles Example 5-13 prints 13.4 mm but its own printed inputs (q=252.8, B′=1.83, Es=3·14364, μ=0.3,
Is=0.455, IF=0.77, m=4) give 13.7 mm; book arithmetic, not asserted.
| Test block (the published value it checks) | Verdict |
| Bowles (1997) Table 5-2 — Steinbrenner I1 (=F1) and I2 (=F2), fourteen printed cells | Pass |
| Das (2016) Tables 7.2 / 7.3 — cells at n′ values Bowles does not tabulate | Pass |
| Baban (2016) Problem 3.2 (= Das Example 7.2 re-solved): rigid 1×2 m footing, centre | Pass |
| Baban (2016) Problem 3.3: same footing, Es,av = 8 500 kPa over H = 4 m (=4B) | Pass |
| Das (2016) Example 7.2 — the table reads (not the mis-added Is of the printed solution) | Pass |
| Bowles (1997) Example 5-7 — raft of the "Savings Bank Building", centre | Pass |
| Bowles (1997) Example 5-13 — ring footing idealised as a 3.658 m square, H = 5B′ | Pass |
| Bowles (1997) §5-6: rigid-base reduction and the half-space limit | Pass |
| closed-form sanity: engine Is reduces to F1 + (1−2μ)/(1−μ)·F2 and S = m·q·B′·(1−μ²)/Es·Is·IF | Pass |
embankment-stress-web-validation.test.ts
embankment-stress — dedicated web-benchmark against PUBLISHED values.
Analyses validated: embankment-stress · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
embankment-stress — dedicated web-benchmark against PUBLISHED values.
Engine: `embankment-stress.ts` — Osterberg (1957) influence factor for one half of a symmetric trapezoidal
embankment, I = (1/π)[((a+b)/b)·atan((a+b)/z) − (a/b)·atan(a/z)] (a = crest half-width, b = slope width, both
measured from the centreline), and the centreline stress Δσ_v = 2·q·I with q = γH.
SOURCES (locators beside each value)
Illinois Department of Transportation (2015), Geotechnical Manual, Appendix D §D.8 — Eq. (D.8-1) (the Osterberg
integral) and Table D.8-1 "Examples of the Use of the Influence Chart (Osterberg, 1957)" (printed pp.D-7…D-9):
influence values I read from the chart for stated a/z, b/z. NOTATION: IDOT's "a" is the SLOPE width and "b" the
crest half-width — the engine's b and a respectively.
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — §6.10, Eqs. (6.30)–(6.33), Fig. 6.18 and
Example 6.8 (printed pp.287–290); here B1 = crest half-width = engine a, B2 = slope width = engine b.
Holtz, R.D. and Kovacs, W.D. (1981), An Introduction to Geotechnical Engineering, Prentice-Hall — Fig. 8.23 and
Example 8.21 (printed pp.354–358; scan read by OCR of the page images). HK's "a" = slope width, "b" = crest
half-width.
Das (2016) Table 6.3 is used once more for the vertical-face limit (see the ENGINE BUG below).
ENGINE BUG FOUND BY THIS SUITE (fixed in embankment-stress.ts)
`osterbergInfluence` handled b ≤ 0 (vertical face, which the validator accepts: "Side slope must be ≥ 0, 0 = vertical
face") by returning only (1/π)·atan(a/z). The limit of the general formula as b → 0 is
(1/π)[atan(a/z) + (a/z)/(1+(a/z)²)] — the half of a uniform strip (q/π)(α + sin α). The old branch dropped the
sin·cos term and under-stated Δσ_v by ≈46 % at a/z = 0.5. Fixed; continuity with the general formula verified
(b = 1e-3·z gives 0.27493 against the limit 0.27491).
TOLERANCES, stated before running
• Chart reads of the Osterberg chart (Das Fig 6.18, HK Fig 8.23, the IDOT chart): the influence axis runs 0–0.50 in
divisions of 0.05; a reading uncertainty of a quarter division, 0.0125, is taken. The IDOT and HK reads agree with
the closed form to ≤ 0.003; Das's reads to ≤ 0.010 (B1/z = 0, B2/z = 1: 0.24 vs 0.25 is the largest).
• Printed stresses: Das Ex 6.8 is 2 q (I′L + I′R) with chart I′; HK Ex 8.21 stresses are printed to 2 s.f. (±0.5–1 kPa).
| Test block (the published value it checks) | Verdict |
| Illinois DOT (2015) Geotechnical Manual Table D.8-1 — Osterberg influence values for stated a/z, b/z | Pass |
| Das (2016) Example 6.8 — 7 m embankment, γ = 17.5 kN/m³, crest 5 m, 2H:1V slopes: stress under the centreline at z = 5 m | Pass |
| Holtz & Kovacs (1981) Example 8.21 — 3 m highway embankment, ρ = 2.0 Mg/m³, 10 m crest, 2H:1V slopes | Pass |
| Surface limit and the vertical-face (strip) limit — Das Fig 6.18 axis, H&K text, Das Table 6.3 | Pass |
⚑ expansive-heave-web-validation.test.ts
Validation for `expansive-heave` — swell-index heave of an expansive clay, ΔH = Cs·H/(1+e0)·log10(p_s/σ'), zero when σ' ≥ p_s (`expansive-heave.ts`, `computeExpansiveHeave`).
Analyses validated: expansive-heave · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `expansive-heave` — swell-index heave of an expansive clay, ΔH = Cs·H/(1+e0)·log10(p_s/σ'),
zero when σ' ≥ p_s (`expansive-heave.ts`, `computeExpansiveHeave`).
Published sources (every number below was read from the page named beside it; none is recalled):
1. Terzaghi, K., Peck, R.B. & Mesri, G. (1996), Soil Mechanics in Engineering Practice 3rd ed., Wiley — Art. 16.10
"Heave of Expansive Soils" (library copy, scanned; pages read as images):
· Eq. 16.22, S = C_εs·L·log(p_s/σ'_vo), and its worked numbers on p. 120: "a value of p_s = 3000 kPa and an
average value of C_εs = 0.036 ... indicate a heave of 66 mm" for "a 1-m-thick sublayer", σ'_vo = 45 kPa
(Onderstepoort clay, Fig. 16.24);
· Table 16.2 (p. 117), Olson, R.E. & Mesri, G. (1970) clay-mineral data: p_s at e = 1.0 and e = 1.5 and
the swelling index C_s "from e = 1.0 to e = 1.5", for seven clays.
2. Fredlund, D.G. & Rahardjo, H. (1993), Soil Mechanics for Unsaturated Soils, Wiley — swell strain
Δh/h = C_s/(1+e0)·log(P_f/P_o), as reproduced in Huat, B.B.K., Toll, D.G. & Prasad, A. (2012), Handbook of
Tropical Residual Soils Engineering, CRC, Ch. 8, Eq. 8.34 (equation only).
MAPPING. The engine's C_s/(1+e0) is TPM's swelling strain index C_εs, so TPM's C_εs = 0.036 is entered as
C_s = 0.036 with e0 = 0. For Table 16.2 the layer is taken from the printed state e0 = 1.0, σ'_initial = p_s(e=1)
down to σ'_final = p_s(e=1.5): the published void-ratio change is 0.5, so heave/H·(1+e0) must equal 0.5.
SHORTFALL — formula-fidelity evidence only. ONE printed worked heave (66 mm) plus seven published data rows.
No source read prints further heave-magnitude examples (Nelson & Miller 1992, Chen 1988 and Texas DOT PVR
were not available), and the engine's severity cut-offs (5 / 25 / 50 / 100 mm) have NO published source found
— they are the engine's own and are not asserted here. Published-value count is in the final report.
| Test block (the published value it checks) | Verdict |
| Terzaghi–Peck–Mesri Art. 16.10: 1-m sublayer, p_s = 3000 kPa, C_εs = 0.036, σ'_vo = 45 kPa ⇒ heave 66 mm | Pass |
| Terzaghi–Peck–Mesri Table 16.2: swelling from p_s(e=1.0) to p_s(e=1.5) changes the void ratio by 0.5 | Pass |
| Terzaghi–Peck–Mesri Art. 16.10: no heave once the final stress reaches the swelling pressure | Pass |
| Fredlund & Rahardjo (1993) Eq. 8.34: strain is linear in C_s/(1+e0) and in log(P_f/P_o) | Pass |
expansive-soil-web-validation.test.ts
Web-benchmark validation for `expansive-soil` — swelling-soil classification, heave, and the mitigation ladder.
Analyses validated: expansive-soil · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `expansive-soil` — swelling-soil classification, heave, and the
mitigation ladder.
SOURCES (each cited at the assertion that uses it):
IS 1498:1970 Annex C — swelling-soil classification by plasticity index.
IS 2720 (Part 40):1977 — free swell index (FSI) and its severity bands.
IS 2720 (Part 41):1977 — swelling pressure and its severity bands.
IS 9451:1985 Cl 6.1 — foundation depth = active zone + 0.3 m buffer.
IS 6943:1973 — CNS (cohesive non-swelling) layer.
IS 9214:1979 / Nelson & Miller (1992) / Fredlund & Rahardjo (1993) — the oedometer
swell-strain heave summation:
Δh = Σ [ Cs/(1+e0) · H_i · log10( σ′sw / σ′f,i ) ] for σ′f,i < σ′sw
Holtz & Gibbs (1956) Trans. ASCE 121 — the original FSI severity categories.
Per the method note in batch 7t, each expected value reconstructs its chain from the
published formula in code rather than quoting a hand-transcribed decimal.
| Test block (the published value it checks) | Verdict |
| FSI severity breaks at the published 20 / 35 / 50 % edges (IS 2720-40) | Pass |
| PI severity breaks at the published 15 / 35 / 55 % edges (IS 1498 Annex C) | Pass |
| swell-pressure severity breaks at the published 50 / 150 / 300 kPa edges (IS 2720-41) | Pass |
| the governing severity is the worst of the three indices | Pass |
| indices that disagree sharply are flagged for re-testing | Pass |
| recommended foundation depth is the active zone + 0.3 m, or deeper if founded deeper | Pass |
| heave follows Δh = Σ Cs/(1+e0)·H·log10(σ′sw/σ′f), integrated over the active zone | Pass |
| surcharge that exceeds the swell pressure suppresses heave entirely | Pass |
| heave needs Cs, e0 AND a swell pressure — a partial set is refused with a reason | Pass |
| the mitigation ladder escalates with severity and cites its standards | Pass |
| a very high severity under a building escalates to piles, and rationale is cited | Pass |
gibson-consolidation-layered-terzaghi-web-validation.test.ts
WEB-VALIDATION for the finite-strain (Gibson) consolidation engine — the SMALL-STRAIN LIMIT against Terzaghi's published time-factor table, plus the LAYERED interface physics.
Analyses validated: gibson-consolidation, gibson-consolidation-layered · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-VALIDATION for the finite-strain (Gibson) consolidation engine — the SMALL-STRAIN
LIMIT against Terzaghi's published time-factor table, plus the LAYERED interface physics.
WHY THIS SUITE EXISTS ALONGSIDE THE OTHER TWO
---------------------------------------------
`gibson-consolidation-layered` has three cited suites now, and two of them existed before this
one — they were simply INVISIBLE to the coverage manifest, because it decides whether a file is
cited evidence by `filename.includes('web-validation')` and both were named `...-validation`.
`gibson-consolidation-layered-validation.test.ts` opens with the words "WEB-BENCHMARK
validation" and holds 9 tests; it is renamed to `...-layered-web-validation.test.ts` in the same
commit as this file. That is the third time this exact near-miss has hidden real work (see
`hardening-soil-footing`, which said "web-benchmark", and `lateral-pile-matlock-reese`, renamed
alongside), so a gate now rejects the spelling rather than leaving it to be rediscovered.
`gibson-consolidation-web-validation.test.ts` is honest about a hard problem and says so in its
own header, and that is the gap THIS file closes: the published
finite-strain benchmarks (Townsend & McVay 1990; Gjerapic 2008) state compressibility as a
POWER law, so the LOG-LINEAR C_c/C_k path — which is the path the UI defaults to and the only
path the LAYERED mode supports — had no published numerical anchor at all. Its coverage of
that path was conservation laws, exact scalings and trends. Those are real checks, but not one
of them would notice if the engine's TIME-RATE were wrong by a factor of two: solids
conservation, the void-space bound, monotonicity and the 1/k₀ scaling are all satisfied by a
solution that consolidates at entirely the wrong speed.
THE ANCHOR. Gibson, England & Hussey (1967) derive finite-strain theory as the general case
and show that it DEGENERATES to Terzaghi's linear theory as the strains become small and the
coefficients constant. That degeneration is the standard verification route for a
finite-strain code, and it is a genuinely external, numerical one, because Terzaghi's U–T_v
table is published to four significant figures. So: drive our engine into the corner where
Terzaghi's assumptions hold, and it must reproduce Terzaghi's table.
HOW THE THREE TERZAGHI ASSUMPTIONS ARE IMPOSED — each one costs an input, and naming them is
the difference between a benchmark and a coincidence:
1. SMALL STRAIN. A 10% stress increment on C_c = 0.05 gives 0.10% strain. (Chosen over a
1% increment, which is SMALLER strain but noisier: the engine rounds `settlement_m` to
4 dp, so a 0.5 mm ultimate settlement is quantised at 20% per sample and the measured
time factors scattered by ±20%. H₀ = 20 m rather than 5 m for the same reason — it buys
settlement magnitude without touching the strain level.)
2. CONSTANT PERMEABILITY. `Ck: 1e9` makes k(e) = k₀·10^((e−e₀)/C_k) flat. Terzaghi assumes
k constant; a finite-strain code does not.
3. NO SELF-WEIGHT SEEPAGE. `Gs: 1.0` zeroes the buoyant unit weight, so Gibson's advective
term −(G_s−1)·d/de[k/(1+e)]·∂e/∂z vanishes. Terzaghi neglects self-weight. This one
MATTERS and was measured: leaving self-weight in (G_s = 2.7, so ~20% of the load arrives
as a triangular self-weight distribution rather than a uniform increment) pushed the
early-time factors 24–41% slow. That is not an engine defect — it is the engine solving
a different problem from the one the table tabulates.
c_v is then derived from the same parameters rather than supplied:
D(e) = k·ln10·σ′/(γ_w·(1+e)·C_c) is Gibson's MATERIAL-coordinate diffusivity, and the
physical Terzaghi c_v = D·(1+e)², because dξ = (1+e)dz maps the solids coordinate to the
physical one. Cross-checks against Terzaghi's own definition: c_v = k/(m_v·γ_w) with
m_v = C_c/((1+e₀)·ln10·σ′) gives the same expression. Both routes → c_v = 107.95 m²/yr here.
MEASURED (single drainage at the top, impervious base, H_dr = H₀ = 20 m):
U = 20% T_v 0.0314 Terzaghi 0.1163 yr engine 0.1237 yr +6.3%
U = 30% T_v 0.0707 Terzaghi 0.2620 yr engine 0.2680 yr +2.3%
U = 40% T_v 0.126 Terzaghi 0.4669 yr engine 0.4699 yr +0.7%
U = 50% T_v 0.197 Terzaghi 0.7300 yr engine 0.7358 yr +0.8%
U = 60% T_v 0.286 Terzaghi 1.0597 yr engine 1.0635 yr +0.4%
U = 70% T_v 0.403 Terzaghi 1.4933 yr engine 1.4964 yr +0.2%
U = 80% T_v 0.567 Terzaghi 2.1009 yr engine 2.0776 yr −1.1%
U = 90% T_v 0.848 Terzaghi 3.1421 yr engine 3.1040 yr −1.2%
U = 30–90% within 2.3%. U = 20% is looser at 6.3% and the reason is measurement, not physics:
t = 0.124 yr is read off a series sampled every 0.025 yr, so the read itself carries ±10%.
The band is therefore split — 3% for U ≥ 30%, 10% at U = 20% — rather than setting one slack
tolerance that would let a real early-time error through at every other point.
SOURCES
· Terzaghi U–T_v table: Das, *Principles of Foundation Engineering* (Cengage, 2016),
Table 2.11 "Variation of T_v with U", pp. 52–53. Read from the book, 4 s.f.
(⚠️ that table has a typo at U = 65%, printed 0.304, which breaks monotonicity between
0.329 at 64% and 0.352 at 66%. 65% is not used here.)
· Finite-strain theory and its linear limit: Gibson, England & Hussey (1967),
*Géotechnique* 17(3) 261–273.
· Interface conditions in a layered finite-strain deposit: Gibson, Schiffman & Cargill
(1981), *Can. Geotech. J.* 18(2) 280–293.
| Test block (the published value it checks) | Verdict |
| Gibson Terzaghi-limit setup: strain is small (< 0.5%) and solids are conserved | Pass |
| Gibson → Terzaghi limit: U = 20% at T_v = 0.0314 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: U = 30% at T_v = 0.0707 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: U = 40% at T_v = 0.126 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: U = 50% at T_v = 0.197 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: U = 60% at T_v = 0.286 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: U = 70% at T_v = 0.403 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: U = 80% at T_v = 0.567 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: U = 90% at T_v = 0.848 (Das Table 2.11) | Pass |
| Gibson → Terzaghi limit: t₉₀/t₅₀ = 0.848/0.197 = 4.305 (c_v cancels) | Pass |
| Gibson → Terzaghi limit: t₅₀/t₃₀ = 0.197/0.0707 = 2.786 (c_v cancels) | Pass |
| Gibson → Terzaghi limit: doubling the drainage path quadruples t₅₀ and t₉₀ | Pass |
| Gibson layered: the layered path also degenerates to the Terzaghi table at U = 50% and 90% | Pass |
gibson-consolidation-layered-web-validation.test.ts
WEB-BENCHMARK validation for the LAYERED finite-strain (Gibson) consolidation option (per-layer C_c / C_k / e₀ / k₀; the interface flux is written in the CONTINUOUS effective-stress gradient with a harmonic-mean permeability, since the voi…
Analyses validated: gibson-consolidation, gibson-consolidation-layered · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the LAYERED finite-strain (Gibson) consolidation option
(per-layer C_c / C_k / e₀ / k₀; the interface flux is written in the CONTINUOUS
effective-stress gradient with a harmonic-mean permeability, since the void ratio jumps
at a material boundary while σ′ and the water flux do not).
HONEST NOTE ON SOURCES: published *numeric* worked examples for MULTI-LAYER finite-strain
(large-strain) self-weight consolidation are essentially absent in the open literature —
the classic benchmarks (Gibson-England-Hussey 1967; Townsend & McVay 1990 phosphate-clay
symposium; Gjerapic 2008) are all SINGLE-material columns, and the layered-soil consolidation
benchmarks that DO exist (e.g. the two-layer Terzaghi problems in Das, Craig, and the
geoengineer.org / civilengineeringx worked examples) are SMALL-strain. We therefore anchor
the layered engine on the checks that are exact and externally traceable:
1. EXACT REDUCTION — a layered profile whose layers share identical parameters must
reproduce our single-material engine (which is itself web-validated in
gibson-consolidation-web-validation.test.ts against Townsend-McVay & the Terzaghi
limit) to numerical precision. Each equality below is thus an independent numeric match
to an externally-validated result — 8 configs × {2-layer, 3-layer} × {ultimate, final}.
2. PHYSICAL BOUNDS — a layered column settles between its all-soft and all-stiff
single-material bounds (Das, Principles of Geotech Eng, layered-settlement principle).
3. INTERFACE CONTINUITY — the effective stress is continuous across a material boundary
while the void ratio is discontinuous (Gibson 1967; the whole reason for the σ′-gradient
interface flux). Verified from the converged profile.
4. LAYERED TRENDS — softer-at-bottom (higher stress on the compressible layer) settles more
than softer-at-top; a low-permeability layer slows consolidation (Terzaghi multilayer
drainage principle, geoengineer.org).
Sources: Gibson, England & Hussey (1967) Géot 17(3); Townsend & McVay (1990) JGE 116(2);
Das, Principles of Geotechnical Engineering (layered consolidation settlement Σ of layers);
Terzaghi multilayer drainage (geoengineer.org consolidation notes).
| Test block (the published value it checks) | Verdict |
| Gibson layered REDUCTION-2: identical 2-layer stack ≡ single material (ultimate + final) | Pass |
| Gibson layered REDUCTION-3: identical unequal 3-layer stack ≡ single material | Pass |
| Gibson layered BOUND: soft/stiff column lies between all-soft and all-stiff bounds | Pass |
| Gibson layered CONTINUITY: at equilibrium σ′ is continuous, e is discontinuous at the interface | Pass |
| Gibson layered TREND: soft-at-bottom settles more than soft-at-top | Pass |
| Gibson layered TREND: a lower-k layer slows consolidation (less consolidated at a fixed time) | Pass |
| Gibson layered EXACT: solids-mass conserved for layered profiles | Pass |
| Gibson layered WEB (Terzaghi limit): stiff small-strain column consolidates fully & monotonically | Pass |
| Gibson layered WEB (Townsend-McVay geometry): solids height invariant + void-space bound | Pass |
gibson-consolidation-small-strain-web-validation.test.ts
PUBLISHED-VALUES(gibson-consolidation): 16 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: 16-18 distinct published values; declared at the lower bound.
Analyses validated: gibson-consolidation, gibson-consolidation-layered · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES(gibson-consolidation): 16 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: 16-18 distinct published values; declared at the lower bound. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Validation of the finite-strain (Gibson) consolidation engine (`gibson-consolidation.ts`) in its
SMALL-STRAIN LIMIT against PUBLISHED Terzaghi consolidation answers.
WHY THIS SUITE. Gibson, England & Hussey (1967) show that finite-strain theory degenerates to
Terzaghi's linear theory when the strains are small and the coefficients constant; that is the
standard verification route for a finite-strain code because Terzaghi's U–Tv relationship is
tabulated and worked in every textbook. Driving the engine into that corner lets us compare its
TIME-RATE against numbers printed in books — which the conservation-law and trend checks in
`gibson-consolidation-web-validation.test.ts` cannot do (they would all still pass if the engine
consolidated at the wrong speed).
Published sources (every number was read from the page named beside it; none is recalled):
1. FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Ch. 7 —
Table 7-4 "U versus Tv" (p. 7-32) and Example 7-3 (p. 7-37, t90 = 424 days).
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage —
Example 2.12 (Ch. 2, §2.15: cv = 7.061 mm²/min, field time 31.6 days for U = 45.7 %).
3. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Example 4.7
(Ch. 4, p. 139: Tv = 0.0235, Uv = 0.17 for cv = 4.7 m²/yr, d = 10 m, t = 0.5 yr).
4. Gibson, R.E., England, G.L. & Hussey, M.J.L. (1967), Géotechnique 17(3) 261–273 — the
finite-strain theory and its linear (Terzaghi) limit. CONTEXT ONLY: no expected value in this suite is taken from it
(independent audit 2026-10-07, A3-D9); every published number is a Terzaghi/FHWA/Das/Craig value.
HOW THE TERZAGHI CORNER IS IMPOSED (same recipe as the layered suite, restated so this file stands
alone): (1) small strain — a 10 % stress increment on a low-Cc clay gives 0.1–0.4 % strain;
(2) constant permeability — Ck = 1e9 flattens k(e); (3) no self-weight seepage — Gs = 1 zeroes the
buoyant weight. Terzaghi's cv is then DERIVED from the same inputs, never supplied:
cv = k·ln10·σ′·(1+e)/(γw·Cc) with σ′ the mean of the reference and final stress.
TOLERANCES, stated before measuring and used unchanged:
· 3 % on a time read off the engine's settlement series for U ≥ 30 %. The engine's mesh is capped
at 60 nodes and the series is sampled 200 times over the run; both are stated engine properties.
· 10 % at U = 20 %, where the time (≈ 0.12 yr) is read off a 0.025-yr sample grid, so the sampling
alone can move it by that much.
· ±1.0 to ±1.5 percentage points on a U read at a published Tv (the same ~3 % in time, since
dU/d(ln t) ≈ 30–50 points at mid-range); the FHWA/Das tables print U to 0.1–1 %.
· 4 % on a ratio of two published time factors (two independent ~3 % reads combine, cv cancels).
· Craig's Uv is read from a chart to 2 s.f. ⇒ ±0.005.
The engine rounds `settlement_m` to 4 d.p. The Example-7-3 and Example-2.12 cases therefore use
Cc = 0.2 (0.4 % strain, still small) so the ultimate settlement is ~12 mm and the 0.1 mm quantisation
is < 1 % — with Cc = 0.05 the 3 m layer settles 3 mm and the quantisation alone is 3 %.
| Test block (the published value it checks) | Verdict |
| Terzaghi corner is a valid small-strain run (precondition for every comparison below) | Pass |
| FHWA Table 7-4: U = 20 % at Tv = 0.031 | Pass |
| FHWA Table 7-4: U = 30 % at Tv = 0.071 | Pass |
| FHWA Table 7-4: U = 40 % at Tv = 0.126 | Pass |
| FHWA Table 7-4: U = 50 % at Tv = 0.197 | Pass |
| FHWA Table 7-4: U = 60 % at Tv = 0.287 | Pass |
| FHWA Table 7-4: U = 70 % at Tv = 0.403 | Pass |
| FHWA Table 7-4: U = 80 % at Tv = 0.567 | Pass |
| FHWA Table 7-4: U = 90 % at Tv = 0.848 | Pass |
| FHWA Table 7-4: the engine reports t90 itself consistently with Tv = 0.848 | Pass |
| FHWA Table 7-4: Tv = 1.000 ⇒ U = 93.1 % (printed to 0.1 %) | Pass |
| FHWA Table 7-4: Tv = 0.197 ⇒ U = 50 % | Pass |
| FHWA Table 7-4 ratio t90/t50 = 0.848/0.197 (cv and H cancel) | Pass |
| FHWA Table 7-4 ratio t80/t40 = 0.567/0.126 (cv and H cancel) | Pass |
| FHWA Example 7-3: t90 = 0.848·(10 ft)²/0.2 ft²/day = 424 days | Pass |
| Das Example 2.12: 45.7 % consolidation after 31.6 days | Pass |
| Das Example 2.12: at the published 31.6 days the engine has consolidated 45.7 % | Pass |
| Craig Example 4.7: Tv = 0.0235 after 6 months ⇒ Uv = 0.17 | Pass |
gibson-consolidation-web-validation.test.ts
WEB-BENCHMARK validation for the finite-strain (Gibson) consolidation engine.
Analyses validated: gibson-consolidation, gibson-consolidation-layered · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the finite-strain (Gibson) consolidation engine.
the release rules mandatory step. HONEST NOTE: published finite-strain benchmarks
(Townsend & McVay 1990 phosphate-clay symposium; Gjerapic 2008) state compressibility
as a POWER law e = A·(σ′+Z)^B and permeability k = C·e^D, whereas our engine uses the
LOG-LINEAR Cc/Ck form — the two are not the same function, so absolute settlement
numbers are NOT directly comparable without a refit. We therefore anchor on the checks
that ARE exact and source-independent: (1) solids-mass conservation (a direct
consequence of Gibson's Lagrangian material coordinate), (2) the exact time-scaling
t ∝ 1/k₀ of the governing PDE, (3) the Terzaghi small-strain limit trends, and the
(4) published Townsend-McVay geometry invariant. Sources: Gibson, England & Hussey
(1967) Géot 17(3); Townsend & McVay (1990) JGE 116(2) via Agapito Tito (2015) CSU MS
thesis (H0=9.6 m, e0=14.8, final height ≈4.16 m); Terzaghi U↔Tv (geoengineer.org).
| Test block (the published value it checks) | Verdict |
| Gibson web EXACT1: solids-mass conservation (Hs = H0/(1+e0) invariant) | Pass |
| Gibson web EXACT2: ultimate settlement ≤ void-space bound H0 − Hs | Pass |
| Gibson web EXACT3: consolidation time scales as 1/k₀ (halve k₀ ⇒ 2× t₉₀) | Pass |
| Gibson web EXACT4: Townsend-McVay phosphate clay — solids height 0.6076 m invariant | Pass |
| Gibson web BENCHMARK4b: power-law reproduces Townsend-McVay ultimate settlement ≈ 5.44 m | Pass |
| Gibson web TREND5: surcharge deepens settlement | Pass |
| Gibson web TREND6: for fixed H0, lower e0 (denser) ⇒ more self-weight settlement | Pass |
| Gibson web TREND7: monotonic settlement, converges to ~100% given time | Pass |
| Gibson web TREND8: bottom consolidates more than the drained top | Pass |
| Gibson verdict: names ultimate settlement + degree of consolidation | Pass |
hs-confined-settlement-web-validation.test.ts
Validation for the Hardening-Soil confined settlement engines (`hs-confined-settlement.ts`: `computeHsConfinedSettlement` — slug `hs-confined-settlement`; `computeHsLayeredSettlement` — slug `hs-layered-settlement`).
Analyses validated: hs-confined-settlement, hs-layered-settlement · Recorded run: passed — 17 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Hardening-Soil confined settlement engines (`hs-confined-settlement.ts`:
`computeHsConfinedSettlement` — slug `hs-confined-settlement`; `computeHsLayeredSettlement` — slug
`hs-layered-settlement`).
STATUS: PARTIAL — 6 published values (hs-confined-settlement: 3 from 3 books; hs-layered-settlement: 3 from
1 book), against a release bar of 20 values from 2 sources per engine. The tests numbered [1]–[11] are
FORMULA-FIDELITY evidence (formula-fidelity): they reproduce the Hardening-Soil oedometer power law of
Schanz, Vermeer & Bonnier (1999) and its closed-form integral, and compare the FE solution with that closed
form. Nothing in them is a published answer. The published-answer block is at the foot of the file.
WHAT A PUBLISHED ANSWER CAN CHECK HERE. Textbook consolidation settlements are stated with m_v or C_c, i.e. a
CONSTANT constrained modulus (m = 0: E_oed = 1/m_v) or a LOGARITHMIC one (m = 1, c′ = 0:
E_oed^ref/p_ref = (1+e₀)·ln 10 / C_c). The HS engine contains both as limits, so the worked examples below
are run through those two limits. They check the oedometer stiffness law, the cap calibration and the layer
summation; they say nothing about shear hardening, dilatancy or the K₀ path.
PUBLISHED SOURCES (worked examples read in this session; Craig's solution pages were rendered and read):
1. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Example 4.5 (p. 132): m_v 0.94 m²/MN,
Δσ′ 14.7 kPa, H 8 m → s_oed = 110 mm; Example 4.2 (p. 112, Table 4.2): layers 3 m thick, (Δσ′, m_v) =
(82 kPa, 0.35 m²/MN) → 86.1 mm and (77 kPa, 0.13 m²/MN) → 30.0 mm, total 116.1 mm.
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed. — Example 2.12 (Ch. 2): NC clay, H_c 2.8 m,
σ′₀ 140 → 212 kN/m², e 0.92 → 0.86 → S_c = 87.5 mm (printed with C_c = 0.333).
3. FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I — Example 7-3 (p. 7-37): NC clay,
H 10 ft, C_c 0.5, e₀ 1.0, p₀ 600 psf, Δp 2400 psf → ΔH = 1.75 ft (21 in, 0.53 m).
⚠️ DEFECT FOUND BY THE CRAIG EXAMPLE AND FIXED IN `hsOedometerSettlement` (2026-10). Craig's lower clay (30.0 mm)
came out 28.0 mm. Cause: the seating history used a fixed strain step 1e-4, so for a STIFF soil at LOW stress a
single step raised σ′ by E_oed·1e-4 (6 kPa at 60 MPa), overshot σ′v0 ≈ 12 kPa and pushed the cap past the in-situ
stress; the layer was then seated as over-consolidated and reloaded on the stiff E_ur branch. Measured before
the fix (σ′v0 12.3 kPa, Δq 77 kPa, H 3 m, c′ 0, φ′ 25°): m 0.3 / E 60 MPa → 0.09 mm vs closed-form 4.95 mm;
m 0.2 / E 60 MPa → 9.9 mm vs 4.54; m 0.05 / E 8 MPa → 8.7 vs 30.1; m 0 / E 20 MPa → 0.000 vs 11.55 — all silent.
Fix: the seating step is limited to 5 % of the current stress. After it every FE/closed-form pair in that
scan agrees within 2.4 %, and the "seating regression" test near the foot of this file pins the regime.
| Test block (the published value it checks) | Verdict |
| [1] the engine's OWN closed-form analytic settlement matches the hand-derived Schanz-Vermeer-Bonnier oedometer integral exactly | Pass |
| [2] the nonlinear FE (two-surface plasticity) settlement matches the closed-form analytic integral within the engine's own documented 2% tolerance | Pass |
| [3] the closed-form checks out at a second, independent input set (thinner layer, stiffer clay, higher increment) | Pass |
| [4] preconsolidated (OCR>1) soil settles LESS than the equivalent normally-consolidated soil, per the HS stiff-unload-reload branch | Pass |
| [5] the linear-elastic (initial-modulus) estimate OVER-predicts settlement relative to the true HS response, because HS stiffness increases with stress while the linear estimate holds it fixed at the (lower) initial value | Pass |
| [6] applied_load_kpa=0 gives exactly zero settlement, labelled definitional | Pass |
| [7] invalid HS parameters (zero stiffness, phi outside (0,90), m outside [0,1]) are refused | Pass |
| [8] a two-layer profile's total settlement equals the sum of its per-layer settlements exactly | Pass |
| [9] the total thickness reported equals the sum of the input layer thicknesses exactly | Pass |
| [10] the dominant layer index correctly identifies the layer with the largest settlement contribution | Pass |
| [11] an empty layer list, or applied_load_kpa < 0, is refused | Pass |
| Craig Ex 4.5 (p. 132): m_v 0.94 m²/MN, Δσ′ 14.7 kPa, H 8 m → 110 mm | Pass |
| Das Ex 2.12: NC clay 2.8 m, σ′₀ 140 → 212 kN/m², e 0.92 → 0.86 → S_c = 87.5 mm | Pass |
| FHWA Ex 7-3 (p. 7-37): NC clay 10 ft, C_c 0.5, e₀ 1.0, 600 → 3000 psf → ΔH = 1.75 ft | Pass |
| Craig Ex 4.2 (p. 112): layered embankment settlement 86.1 + 30.0 = 116.1 mm | Pass |
| seating regression: stiff soil at low σ′v0 — FE tracks the closed form within 3 % (was 55× too small, 2× too large, 0) | Pass |
| the published-value tally is 6 distinct printed numbers; PARTIAL (short of 20 by 14 per engine) | Pass |
is8009-settlement-web-validation.test.ts
is8009-settlement — dedicated web-benchmark against PUBLISHED values.
Analyses validated: is8009-settlement · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
is8009-settlement — dedicated web-benchmark against PUBLISHED values.
Engine: `is8009-settlement.ts` — layered settlement under the CENTRE of a rectangular foundation,
S = Σ (Δσ_z,mid / Es)·H with Δσ_z = p·4·I(m,n) from the Boussinesq (Newmark/Fadum) corner factor at the
mid-depth of each layer (IS 8009 Part 1 Cl 9.3 / Fig 18), times the rigidity factor 0.8 for a rigid foundation
(Cl 9.5.2) and an input Fox depth factor.
The earlier suite (`is8009-settlement.test.ts`) is anchored to a client-confidential deliverable and so cannot be
cited; nothing from it is used here. Every value below comes from a book opened for this suite.
SOURCES
Knappett, J.A. and Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon — Example 8.5 and Table 8.7
(printed p.309–310, image-checked numbering): a 6 m square footing, q = 160 kPa, five 3 m layers, m_v = 0.13
m²/MN, settlement summed layer by layer from the Fadum-chart factor at each layer mid-depth. This is the engine's
method verbatim, with m_v = 1/Es.
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Table 6.5 (centre-of-rectangle
factor Ic, printed p.276) and Example 6.2 (printed p.277).
Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill — Example 5-3 (centre stresses under a
2×2 m footing at z = 1…4 m; PDF p.322).
IS 8009 (Part 1):1976 Cl 9.5.2 Eq. (13): rigidity factor 0.8; Varghese, P.C. (2005), Foundation Engineering,
Table 4.1 note "IR can be taken as 0.8 Iw centre" (quoting IS 8009 Part 1 Table 2).
TOLERANCES, stated before running
• Craig's Fadum chart values Iqr are read to 3 d.p. from a chart graduated every 0.02; a reading error of 0.002
(one tenth of a division) is taken, i.e. ±1.3 kPa on 4·q·Iqr = 640·Iqr, ±0.5 mm on a 3 m layer at m_v = 0.13.
The total of five independent readings is given √5·0.5 ≈ 1.1 mm → 1.0 mm asserted.
• Das Table 6.5: 3 d.p. ⇒ half-unit 5e-4. Bowles Ex 5-3: stresses computed from a 3-d.p. table (±0.0005·800 =
±0.4 kPa) and printed as integers (±0.5) ⇒ ±0.9 kPa.
| Test block (the published value it checks) | Verdict |
| Craig (2012) Example 8.5 / Table 8.7 — five 3 m layers under the centre of a 6 m square footing, q = 160 kPa | Pass |
| Das (2016) Table 6.5 — centre-of-rectangle influence factor Ic (= engine I_B), fourteen cells | Pass |
| Das (2016) Example 6.2 — 2.5 × 5 m footing, 150 kPa, z = 6.25 m below the centre | Pass |
| Bowles (1997) Example 5-3 — 800 kN on a 2 × 2 m footing (q = 200 kPa): stress under the centre | Pass |
| IS 8009 (Part 1):1976 Cl 9.5.2 — rigidity factor 0.8 on the centre settlement | Pass |
janbu-settlement-web-validation.test.ts
WEB-BENCHMARK validation for the Janbu tangent-modulus settlement engine.
Analyses validated: janbu-settlement · Recorded run: passed — 23 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the Janbu tangent-modulus settlement engine.
the release rules mandatory step. Each case is EXACT and source-independent — it reproduces a
published worked example or a governing closed form by hand, so these are rigorous golden
asserts, not curve-fits. ≥ 20 values, each cited.
Benchmark problem: Rocscience Settle3 Consolidation Analysis Verification Manual §5
(Janbu 1963 3-layer profile under q = 15 t/m²; published total
43.5 cm / Janbu 1963 43.6 cm; per-layer crust 2.35, clay 39.26,
sand 1.93 cm). Reproduced here with the engine sublayered as Settle3
discretizes it.
Closed forms: Fellenius, Basics of Foundation Design (Red Book) §3.5 Eqs 3.8, 3.9,
3.11, 3.15 — evaluated by hand at Fellenius Table 3.1 (CFEM 1992)
typical modulus numbers.
Limiting cases: a = 1 linear ≡ elastic; a = 0 ≡ Cc log method (Fellenius Eq 3.18).
Sources: Janbu (1963) Proc. ECSMFE Wiesbaden vol. 1 pp. 19–25; Fellenius Red Book §3.5
Eqs 3.7–3.18, Table 3.1; Rocscience Settle3 Theory Manual §3.2.3; Settle3 Verification
Manual §5.
| Test block (the published value it checks) | Verdict |
| V1 (§5): crust layer settlement 2.35 cm (published 2.35) | Pass |
| V2 (§5): clay layer settlement 39.26 cm (published 39.26) | Pass |
| V3 (§5): sand layer settlement 1.93 cm (published 1.93) | Pass |
| V4 (§5): total settlement 43.5 cm (Settle3 published; Janbu 1963 43.6) | Pass |
| V5 (§5): discretization converges — n=20 closer to published than n=1 | Pass |
| V6 (Eq 3.9): a=1 till m=500 → ε = Δσ/(m·σ′r) = 0.002 → 2.0 mm | Pass |
| V7 (Eq 3.11): a=0.5 dense sand m=400 → (√200−√100)/(5·400) = 2.071 mm | Pass |
| V8 (Eq 3.11): a=0.5 compact sand m=250 → (√200−√100)/(5·250) = 3.314 mm | Pass |
| V9 (Eq 3.11): a=0.5 loose sand m=100 → (√200−√100)/(5·100) = 8.284 mm | Pass |
| V10 (Eq 3.15): a=0 soft silty clay m=10 → (1/10)·ln2 = 69.31 mm | Pass |
| V11 (Eq 3.15): a=0 soft marine clay m=5 → (1/5)·ln2 = 138.63 mm | Pass |
| V12 (Eq 3.15): a=0 peat m=2 → (1/2)·ln2 = 346.57 mm (softest Table 3.1 soil) | Pass |
| V13 (Eq 3.11): a=0.5 silt m=200 → (√200−√100)/(5·200) = 4.142 mm | Pass |
| V14 (Eq 3.11): a=0.5 at lower stress σ0=50, m=250 → (√150−√50)/(5·250) = 4.141 mm | Pass |
| V15: a=0.5 settles MORE at lower initial stress (modulus ∝ √σ′) — the Janbu non-linearity | Pass |
| V16: a=1 settlement is independent of σ0 (constant modulus) | Pass |
| V17: a=1 settlement scales linearly with H (elastic) | Pass |
| V18 (Eq 3.18): a=0 with m = ln10·(1+e0)/Cc reproduces the Cc settlement exactly | Pass |
| V19: a=1 with m = E/100 reproduces the elastic settlement Δσ·H/E | Pass |
| V20 (Eq 3.17): OC below σ′p settles LESS than NC at the same increment (mr > m) | Pass |
| V21 (Eq 3.16): OC crossing σ′p = recompression to σ′p + virgin beyond | Pass |
| V22: finite-footing Δσ from the shared Boussinesq library (2×2 @ z=1 → 0.7009·q) | Pass |
| V23: 2:1 method gives a deeper-spread, smaller near-surface Δσ than infinite | Pass |
koppejan-settlement-web-validation.test.ts
WEB-BENCHMARK validation for the Koppejan settlement & time-dependent consolidation engine.
Analyses validated: koppejan-settlement · Recorded run: passed — 23 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the Koppejan settlement & time-dependent consolidation engine.
the release rules mandatory step. Each case is EXACT and source-independent — it reproduces a
published worked example or a governing closed form by hand, so these are rigorous golden
asserts, not curve-fits. ≥ 20 values, each cited.
Benchmark problem: Rocscience Settle3 Consolidation Analysis Verification Manual §17
(Koppejan: 10 m NC layer, γ = 18 kN/m³, Cp′ = 10, Cs′ = 50,
cv = 1 m²/day, water table at surface, γw = 9.81, q = 10 kPa infinite
extent). Published: ultimate settlement 0.355 m; settlement at
1000 d (U = 1) 0.568 m. Reproduced with 10 sublayers (Settle3's own
discretization).
Closed forms: ε = (U/Cp + log10(t)/Cs)·ln(σ′f/σ′i) (Settle3 Theory Manual §3.2.4
Eq 29); k = cv·γw/(Cp·σ′zi) (§4.4); Terzaghi U–Tv time rate.
Sources: Koppejan (1948) Proc. 2nd ICSMFE Rotterdam vol. 3 p. 269; Bjerrum (1967)
Géotechnique 17(2); Rocscience Settle3 Theory Manual §3.2.4 Eqs 29–31, §4.4; Settle3
Verification Manual §17.
| Test block (the published value it checks) | Verdict |
| V1 (§17 part 1): ultimate settlement 0.355 m (published 0.355, analytical = Settle3) | Pass |
| V2 (§17 part 2): settlement at 1000 d 0.568 m (published 0.568, spreadsheet = Settle3) | Pass |
| V3 (§17): at 1000 d the profile is fully consolidated (U = 1) | Pass |
| V4 (§17): settlement at 1 d ≈ ultimate (creep term log10(1) = 0) | Pass |
| V5 (§17): settlement at 10 d = ultimate + 1 log-cycle of creep | Pass |
| V6 (§17): settlement at 100 d = ultimate + 2 log-cycles of creep | Pass |
| V7 (§17): settlement at 10000 d = ultimate + 4 log-cycles of creep | Pass |
| V8 (§17): creep increments are equal per log-cycle (secular linearity) | Pass |
| V9 (Eq 29): Cp=10, Cs=50 ultimate ε = (1/10)·ln2 = 0.069315 → 69.31 mm | Pass |
| V10 (Eq 29): Cp=5 ultimate doubles the primary strain → 138.63 mm | Pass |
| V11 (Eq 29): Cp=20 ultimate halves the primary strain → 34.66 mm | Pass |
| V12 (Eq 29): @1000d Cs=50 → (0.1 + 3/50)·ln2 = 110.90 mm | Pass |
| V13 (Eq 29): @1000d Cs=25 → (0.1 + 3/25)·ln2 = 152.49 mm (more creep) | Pass |
| V14 (Eq 29): @1000d Cs=100 → (0.1 + 3/100)·ln2 = 90.11 mm (less creep) | Pass |
| V15 (Eq 29): creep per log-cycle = (1/Cs)·ln(σ′f/σ′i)·H = 13.863 mm/cycle for Cs=50 | Pass |
| V16: small Tv ⇒ U = √(4·Tv/π) (U≤60% branch); cv=0.001, H=4, Hdr=2, t=10d → U=0.0564 | Pass |
| V17: partial consolidation at intermediate time (cv=0.001, H=4, t=1000d → U=0.5642) | Pass |
| V18: large Tv ⇒ U = 1; cv=0.5, H=4, Hdr=2, t=100d (Tv=12.5) | Pass |
| V19: double drainage halves the drainage path ⇒ 4× faster consolidation | Pass |
| V20 (§4.4): k = cv·γw/(Cp·σ′zi); cv=1, γw=9.81, Cp=10, σ=100 → 0.00981 m/day | Pass |
| V21 (§4.4): k doubles with cv; k inversely proportional to Cp | Pass |
| V22: OC below σ′p uses recompression constants ⇒ less settlement than NC | Pass |
| V23: OC crossing σ′p combines recompression + virgin log terms | Pass |
line-load-stress-web-validation.test.ts
line-load-stress — dedicated web-benchmark against PUBLISHED values.
Analyses validated: line-load-stress · Recorded run: passed — 3 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
line-load-stress — dedicated web-benchmark against PUBLISHED values.
Engine: `line-load-stress.ts` — Boussinesq/Flamant stresses from an infinite vertical line load Q (force/length):
Δσ_z = (2Q/π)·z³/(x²+z²)², Δσ_x = (2Q/π)·x²z/(x²+z²)², τ_xz = (2Q/π)·x z²/(x²+z²)², and the influence factor
I = Δσ_z·z/Q.
SOURCES (locators beside each value)
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Table 6.2 "Variation of
Δσ/(q/z) with x/z" (printed p.267; 3 d.p.), the published tabulation of Eq. (6.4).
FHWA NHI-06-089 (2006), Soils and Foundations Reference Manual Vol. II, Ch. 10 — Example 10-2 and its table of
"Computation of Lateral Earth Pressures Due To Line Load" (printed pp.10-32…10-33): a 700 lb/ft line load 15 ft
behind a 30 ft unyielding wall, lateral pressure Ph at depths z = 0.1H … 1.0H (3 s.f.; USS Steel 1975 chart).
Varghese, P.C. (2005), Foundation Engineering, PHI — Eq. (3.5) (the vertical/horizontal line-load stresses) and
Eq. (17.3): Terzaghi's wall-pressure form with coefficient 1.27.
HOW THE WALL VALUES ARE COMPARED. On a rigid, unyielding wall the lateral pressure is twice the free-field Δσ_x
(reflection), so Ph = 2·Δσ_x = (4Q/π)·x²z/(x²+z²)² = 1.2732·(Q/H)·m²n/(m²+n²)² with m = x/H, n = z/H. FHWA prints the
coefficient as 1.28 (USS Steel chart), Varghese Eq 17.3 as 1.27; the exact 4/π = 1.2732. The comparison tolerance
for FHWA's table is therefore the coefficient difference (1.28 vs 1.2732 = 0.53 %) plus the table's own print
rounding (one place, 0.1, half-unit 0.05). The "2×" is the standard rigid-wall factor named in both sources; it is
applied in the test, not in the engine.
TOLERANCES: Das Table 6.2 is printed to 3 d.p. ⇒ half-unit 5e-4 (all 26 cells agree; 21 are asserted).
| Test block (the published value it checks) | Verdict |
| Das (2016) Table 6.2 — Δσ_z/(q/z) against x/z, twenty-one published values | Pass |
| FHWA NHI-06-089 (2006) Example 10-2 — lateral pressure on a 30 ft unyielding wall from a 700 lb/ft line load 15 ft away | Pass |
| Varghese (2005) Eq. 17.3 — the wall-pressure coefficient of the line-load horizontal stress | Pass |
multilayer-consolidation-web-validation.test.ts
Validation of the multi-layer 1-D consolidation engine (`multilayer-consolidation.ts`) against PUBLISHED layered-clay settlement and time-rate examples.
Analyses validated: multilayer-consolidation · Recorded run: passed — 25 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the multi-layer 1-D consolidation engine (`multilayer-consolidation.ts`) against
PUBLISHED layered-clay settlement and time-rate examples.
Published sources (every number was read from the page named beside it; none is recalled):
1. FHWA-NHI-06-089 (2006), Soils and Foundations Reference Manual Vol. II, Appendix A —
§A.6 "Approach Roadway Deformations" (Tables A.6-3, A.6-4, A.6-6, A.6-7; pp. A.6-7 … A.6-18) and
§A.7 "Spread Footing Design" (Tables A.7-3, A.7-4, A.7-6, A.7-7). A 35-ft clay stratum is split into
three sub-layers, each with its own Cr/Cc branch (recompression only, or Cr to σ′p then Cc), summed to
a total and marched in time with Tv from Table 7-4.
2. FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Ch. 7 — Example 7-3
(p. 7-36/7-37): NC clay 10 ft thick, ΔH = 1.75 ft = 21 in, t90 = 424 days.
3. Lambe, T.W. & Whitman, R.V. (1979), Soil Mechanics, SI Version, Wiley — Example 25.6 (Ch. 25, p. 384–385,
the Lagunillas case): NC clay 4.3 m, σ′v0 = 67.4 kPa, Δσ = 99.0 kPa, e0 = 1.83, e1 = 1.40 ⇒ 0.653 m.
UNITS. The books work in psf, ft and inches; the engine in kPa, m and mm. The conversions below are the
exact ones (1 psf = 0.0478802589 kPa, 1 ft = 0.3048 m, 1 in = 25.4 mm) and are applied to the book's INPUTS
only. Expected values stay in the book's units.
INPUT MAPPING. For each sub-layer the engine takes the book's mid-depth po as σ′0, pf − po as Δσ, and the
book's pc as σ′p (a sub-layer the book treats as normally consolidated gets σ′p = σ′0). Cc = 0.35,
Cr = 0.035, e0 = 0.97 are the book's "average" values.
TOLERANCES, derived from the PRECISION THE BOOK PRINTS (one case first looked like a mismatch and was traced
to the book's own rounding — Table A.6-6 Sub-layer 1, engine 1.886 in vs printed 1.93 in — see below):
· Embankment-only tables (A.6-3, A.7-3): the book prints each term in feet to 0.001 ft (±0.006 in) and the
layer in inches to 0.01 ⇒ ±0.02 in per layer, ±0.03 in on the printed total.
· Embankment + surcharge (A.6-6): the book rounds each term to 0.01 ft (= 0.12 in resolution, ±0.06 in) and a
layer has two terms ⇒ ±0.12 in per layer, ±0.36 in on the total of three layers. (That coarser rounding is
visible: Sub-layer 1's first term is 0.1065 ft, printed as 0.11 ft = 1.32 in, so the book's 1.93 in is
0.044 in above the value its own inputs give.)
· Abutment Sub-layer 2 (A.7-6): the book rounds 0.2103 ft to "0.21 ft ∼ 2.50 in" ⇒ ±0.06 in.
· Times: whole days are printed (some truncated, e.g. 0.403 × 260.4 = 104.9 printed 104) ⇒ ±1 day.
· FHWA Example 7-3: ΔH is printed as 1.75 ft and "21 inches" ⇒ ±0.1 in; t90 is printed to whole days ⇒ ±1 d.
· Lambe & Whitman: 0.653 m is printed to 3 s.f. ⇒ ±0.001 m.
DERIVED INPUT, DISCLOSED. The Lambe & Whitman example gives e0 and e1 (not Cc). The engine takes Cc, so
Cc = (e0 − e1)/log10(σ′v1/σ′v0) is computed from those two printed void ratios. With that input the engine's
e–log σ′ expression and the book's Δe/(1+e0) expression are the same algebra, so this one case checks the
engine's arithmetic and unit handling against a printed answer, not an independent constitutive model.
TIME-RATE. The book applies Hd = 17.5 ft (half the whole 35-ft clay) and cv = 0.6 ft²/day to all three
sub-layers together. The engine computes each layer with its OWN drainage path, so to reproduce the book's
time column the whole clay is entered as ONE 35-ft layer. The engine's per-layer drainage treatment of a
multi-sub-layer stratum is therefore not benchmarked here: no published example in the library applies
different cv/Hd to sub-layers and prints the combined time.
| Test block (the published value it checks) | Verdict |
| FHWA Table A.6-3: Sub-layer 1 (recompression only) = 1.17 in | Pass |
| FHWA Table A.6-3: Sub-layer 2 (Cr then Cc) = 2.55 in | Pass |
| FHWA Table A.6-3: Sub-layer 3 (Cr then Cc) = 8.11 in | Pass |
| FHWA Table A.6-3: clay total = 11.83 in | Pass |
| FHWA Table A.6-6: Sub-layer 1 under embankment + surcharge = 1.93 in (book rounds terms to 0.01 ft) | Pass |
| FHWA Table A.6-6: Sub-layer 2 under embankment + surcharge = 4.44 in | Pass |
| FHWA Table A.6-6: Sub-layer 3 under embankment + surcharge = 10.89 in | Pass |
| FHWA Table A.6-6: clay total under embankment + surcharge = 17.26 in | Pass |
| FHWA Table A.6-6: the surcharge alone adds 5.43 in | Pass |
| FHWA Table A.7-3: pier Sub-layer 1 = 0.97 in | Pass |
| FHWA Table A.7-3: pier Sub-layer 2 (0.18 + 0.80) = 0.98 in | Pass |
| FHWA Table A.7-3: pier clay total = 1.95 in | Pass |
| FHWA Table A.7-6: abutment Sub-layer 1 = 0.12 in | Pass |
| FHWA Table A.7-6: abutment Sub-layer 2 (NC, Cc) = 2.50 in | Pass |
| FHWA Table A.7-6: abutment clay total = 2.62 in | Pass |
| FHWA Table A.6-4: 20 % of the 35-ft clay settlement takes 16 days | Pass |
| FHWA Table A.6-4: 50 % takes 101 days | Pass |
| FHWA Table A.6-4: 70 % takes 206 days | Pass |
| FHWA Table A.6-4: 90 % takes 432 days | Pass |
| FHWA Table A.6-4 read the other way: 16 days ⇒ 20 %, 101 days ⇒ 50 % | Pass |
| FHWA Table A.6-4 read the other way: 206 days ⇒ 70 %, 432 days ⇒ 90 % | Pass |
| FHWA Table A.7-4: the 25-ft pier clay (Hd = 12.5 ft) reaches 20/50/70/90 % in 8/51/104/220 days | Pass |
| FHWA Example 7-3: primary settlement of the NC clay = 1.75 ft = 21 in | Pass |
| FHWA Example 7-3: t90 = 424 days (single drainage, Hd = 10 ft, cv = 0.2 ft²/day) | Pass |
| Lambe & Whitman Example 25.6: ρ = 4.3/(1+1.83)·(1.83 − 1.40) = 0.653 m | Pass |
pvd-design-published-web-validation.test.ts
Validation of the PVD / sand-drain spacing DESIGNER (`pvd-design.ts`) against PUBLISHED radial consolidation tables and PUBLISHED worked drain designs.
Analyses validated: pvd-design · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the PVD / sand-drain spacing DESIGNER (`pvd-design.ts`) against PUBLISHED radial
consolidation tables and PUBLISHED worked drain designs.
The designer answers "what spacing reaches U % in t months?" by inverting the Barron/Hansbo forward
solver. The companion file `pvd-design-web-validation.test.ts` checks the inversion is self-consistent;
THIS file checks it against numbers printed in books, which is the only thing that can catch a wrong
drain-factor, a wrong influence-diameter constant, or a designer that silently fails for some drains.
Published sources (every number was read from the page named beside it; none recalled from memory):
1. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage —
Table 16.5 "Variation of Ur for various values of Tr and n, no-smear case" (pp. 844–846,
built on Eqs 16.26 and 16.32) and Example 16.5 (n = 15, Tr = 0.36, Ur ≈ 77 %).
2. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Example 4.7 (Ch. 4,
pp. 139–140): 400 mm sand drains, ch = 7.9 m²/yr, Ur = 0.82 in 6 months ⇒ n = 9, S = 3.2 m.
3. Han, J. (2015), Principles and Practice of Ground Improvement, Wiley — Design Example 7.1
(Ch. 7, pp. 227–230): 100 × 4 mm PVD (dc = 0.052 m), triangular 1.0 m, cr = 4.5e-8 m²/s.
4. FHWA-NHI-16-027 (2017), Ground Modification Methods Reference Manual Vol. I (GEC 013),
§4.4 Design Example (p. 2-38): ch = 0.2 ft²/day, dw = 2.5 in, triangular, U = 90 % ⇒
≈ 300 days at ≈ 8 ft, ≈ 500 days at ≈ 10 ft.
HOW A TABLE CELL BECOMES A DESIGN QUERY. A Table 16.5 cell says: for spacing ratio n, Ur is reached at
time factor Tr. Choose a drain diameter dw and a 6-month preload, set de = n·dw and
ch = Tr·de²/t, and ask the designer for the spacing that reaches Ur in 6 months. If the designer and the
table agree, the spacing it returns has n_engine = de_engine/dw = n. The comparison is on n (a
dimensionless quantity the book prints), not on a spacing we chose ourselves.
TOLERANCES, fixed before measuring:
· Das Table 16.5: ±1 % on n. The table prints Tr to 4 d.p.; the worst case is Tr = 0.0811 (±0.0005 ⇒
±0.6 % of Tr), which moves n by < 0.6 %.
· Das Example 16.5: ±1.5 % on n. The book reads Ur "about 77 %" (nearest whole per cent ⇒ ±0.5 % U ⇒
< 1 % in n).
· Craig Example 4.7: n = 9 ± 0.5 and S = 3.2 ± 0.2 m. Craig reads n from a plotted curve to the nearest
integer, and derives S = n·rd/0.564 from it; ±0.5 in n is ±0.18 m in S.
· Han Design Example 7.1: ±3 % on the 1.0 m spacing. Han uses de = 1.06·S where the designer uses
Hansbo's 1.05·S (0.95 %), and rounds ND = de/dc = 20.4 to 20 in F(n) (0.8 % on F).
· FHWA §4.4: ±10 % on spacing. The source itself says "approximate spacing" and "times on the order of".
SMEAR / WELL RESISTANCE. No published numeric answer for a smeared design was available in the library
(Craig Eq. 4.42 and Han Problem 7.11 give the formula / an unanswered problem), so the smear path of the
designer is NOT benchmarked here. The published sources above are all no-smear cases; this suite
therefore validates the designer for the ideal (Barron) drain and says nothing about smear accuracy.
| Test block (the published value it checks) | Verdict |
| Das Table 16.5: n = 5 | Pass |
| Das Table 16.5: n = 10 | Pass |
| Das Table 16.5: n = 15 | Pass |
| Das Table 16.5: n = 20 | Pass |
| Das Table 16.5: n = 25 | Pass |
| Das Example 16.5: 77 % radial consolidation in 9 months with 0.2 m drains needs n = 15 | Pass |
| Craig Example 4.7: the large-diameter sand-drain target is found feasible, not refused | Pass |
| Craig Example 4.7: spacing ratio n = 9 | Pass |
| Craig Example 4.7: square-pattern spacing S = 3.2 m | Pass |
| Han Design Example 7.1: 1.0 m triangular spacing reproduces the published Ur at the published Tr | Pass |
| FHWA-NHI-16-027 §4.4: ≈ 8 ft spacing for 90 % in ≈ 300 days | Pass |
| FHWA-NHI-16-027 §4.4: ≈ 10 ft spacing for 90 % in ≈ 500 days | Pass |
pvd-design-web-validation.test.ts
Validation against Barron (1948) and Hansbo (1981, Proc.
Analyses validated: pvd-design, radial-consolidation · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation against Barron (1948) and Hansbo (1981, Proc. 10th ICSMFE) radial
consolidation theory, plus the standard published influence-diameter
constants (de = 1.05.S triangular, de = 1.128.S square pattern -- IS 15284-2 /
FHWA PVD manual). This engine INVERTS the already golden-tested
radialConsolidation forward solver by bisection, so it is validated here by
(a) the exact influence-diameter constants (pure closed-form, hand-verified)
and (b) round-trip consistency: solving for the spacing that reaches a
target U, then running the FORWARD solver at that exact spacing and
confirming it reproduces the target -- the correctness property that
actually matters for an inversion.
| Test block (the published value it checks) | Verdict |
| [1-2] influence diameter constants match the published Hansbo/Barron values exactly: de=1.05.S (triangular), de=1.128.S (square) | Pass |
| [3-4] ROUND-TRIP CONSISTENCY: the spacing solved for a 90% target, run back through the forward radialConsolidation solver, reproduces ~90% U | Pass |
| [5] influence diameter reported by the design matches the pattern constant times the solved spacing exactly | Pass |
| [6] a longer available time allows a WIDER (less conservative) spacing to reach the same target | Pass |
| [7] a higher target consolidation requires a TIGHTER spacing, all else equal | Pass |
| [8] a higher coefficient of consolidation ch allows a wider spacing for the same target/time | Pass |
| [9] an unreachable target (very high U, very little time) is reported as NOT feasible, not silently solved at the tightest spacing | Pass |
| [10] a trivially-easy target (met even at the widest practical spacing) is flagged as such, not silently solved at the tightest | Pass |
| [11] the U-vs-spacing curve is monotonically DECREASING (tighter spacing -> higher U, per Hansbo theory) | Pass |
| [12] invalid inputs (ch<=0, target outside (0,100), time<=0, dw<=0) are refused | Pass |
radial-consolidation-web-validation.test.ts
Radial consolidation by vertical drains — validated against the three papers the engine cites:
Analyses validated: radial-consolidation · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Radial consolidation by vertical drains — validated against the three papers the engine cites:
Barron, R.A. (1948) "Consolidation of fine-grained soils by drain wells."
Trans. ASCE 113(1), pp. 718–754.
Hansbo, S. (1981) "Consolidation of fine-grained soils by prefabricated drains."
Proc. 10th ICSMFE, Stockholm, Vol 3, pp. 677–682.
Carrillo, N. (1942) "Simple two- and three-dimensional cases in the theory of consolidation
of soils." J. Math. Phys. 21(1), pp. 1–5.
Like `hetenyi-beam`, these are **closed forms**, so the anchors are exact rather than
chart-read. Barron's equal-strain drain factor is
F(n) = [n²/(n²−1)]·ln(n) − (3n² − 1)/(4n²) n = de/dw
which reduces to the familiar `ln(n) − 3/4` for large n. Hansbo's smear extension is
μ = ln(n/s) + (kh/ks)·ln(s) − 3/4 s = ds/dw
and the degree of consolidation is `Uh = 1 − exp(−8·Th/μ)` with `Th = ch·t/de²`.
Carrillo combines vertical and radial drainage as `U = 1 − (1 − Uv)(1 − Uh)`.
WHY THE `max(hansbo, barron)` CLAMP IS RIGHT, and why it is tested here explicitly.
Hansbo's smear form is an approximation valid for n ≫ s. At small n it dips BELOW Barron's
exact no-smear value and can go negative, which sends `exp(−8·Th/μ)` to infinity and reports
Uh = 0 % for all time. Since smear can only *impede* flow, μ can never fall below the ideal
Barron value — so Barron is a physical lower bound, and clamping to it is not a fudge. The
source documents that this was a real bug once; these tests pin the fix.
This engine also carries the audit's E-22/23/24 fixes (uv range, n > 1, smear ⊂ unit cell),
so the refusals are asserted alongside the physics — a validated engine that accepts
impossible geometry is only half validated.
| Test block (the published value it checks) | Verdict |
| Barron (1948) equal-strain drain factor F(n) — 10 values across the design range | Pass |
| Hansbo (1981) smear extension — and the Barron lower-bound clamp | Pass |
| influence diameter — 1.05·S triangular, 1.128·S square (the standard unit-cell equivalences) | Pass |
| Uh = 1 − exp(−8·Th/μ) end to end, with Th = ch·t/de² | Pass |
| Carrillo (1942) — U = 1 − (1 − Uv)(1 − Uh) | Pass |
| Hansbo (1981) well resistance — the depth-averaged Fr and its sign | Pass |
| the audit E-22/23/24 guards hold alongside the physics | Pass |
schmertmann-web-validation.test.ts
SCHMERTMANN STRAIN-INFLUENCE SETTLEMENT — web-validation benchmark.
Analyses validated: schmertmann · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
SCHMERTMANN STRAIN-INFLUENCE SETTLEMENT — web-validation benchmark.
SOURCE:
Das B.M., "Principles of Foundation Engineering", Cengage Learning, §7.5
"Settlement of Sandy Soil: Use of Strain Influence Factor —
Solution of Schmertmann et al. (1978)", Eqs (7.20)-(7.27) and Figures
7.9 / 7.11, with **worked Example 7.4** (2 m x 4 m footing at 1.2 m in sand).
Schmertmann, Hartman & Brown (1978), ASCE JGED 104(GT8) — the method itself.
Salgado (2008), reproduced as Das Eqs (7.22)-(7.24) and (7.27) — the
interpolation relations for a rectangular footing.
WHY THIS EXAMPLE. `schmertmann` had no anchored test. Example 7.4 tabulates
every intermediate — z1, z2, Iz at the founding level, Iz(m), the Es/qc
rectangle factor, the four-slice Σ Iz/Es·Δz, C1, C2 and the settlement — so it
checks the whole chain rather than the endpoint.
COUNT: 17 cited values + 4 proof-by-consequence checks.
| Test block (the published value it checks) | Verdict |
| Das Ex 7.4 — geometry of the Iz diagram (Eqs 7.21-7.24): 4 published values | Pass |
| Das Ex 7.4 — Es = 2.8 qc for L/B = 2 (Eq 7.27), and the correction factors | Pass |
| Das Ex 7.4 — Σ Iz/Es·Δz = 17.52e-5 and Se = 27.83 mm | Pass |
| E-60 — the answer must not depend on how the caller binned the CPT | Pass |
| E-59 — Es for a rectangle is logarithmic in L/B, not linear in (L/B−1)/9 | Pass |
| the Iz diagram degenerates correctly at the square and strip limits | Pass |
| the published interpolation relations are slightly NON-monotone in L/B — recorded, not corrected | Pass |
| C1 and C2 behave as Eqs (7.20) define them | Pass |
secondary-compression-web-validation.test.ts
WEB-BENCHMARK validation for the isotache / secondary-compression (creep) engine.
Analyses validated: secondary-compression · Recorded run: passed — 25 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the isotache / secondary-compression (creep) engine.
the release rules mandatory step. Every case below is EXACT and source-independent — it
reproduces the governing relations by hand from primary sources, so these are
rigorous golden asserts, not curve-fits.
Classical creep: S_s = Cαε·H·log10(t2/t_p), Cαε = Cα/(1+e_p) (Buisman/Mesri; Das §11)
End of primary: t_p = T95·H_dr²/cv, T95 = 1.129 (Terzaghi U=95%; multi-layer consolidation settlement theory §3.3)
Isotache indices: μ* = Cα/(ln10·(1+e)), λ* = Cc/(ln10·(1+e)),
κ* = 2·Cr/(ln10·(1+e)) (Vermeer & Neher 1999; Soft-Soil-Creep model)
Preload (Mesri): t_l = 100·t_p·R_s′^1.7 (clay) / 10·t_p·R_s′ (peat) (Terzaghi, Peck & Mesri 1996)
Sources: Das, Principles of Geotech. Eng. §11 (NC-clay creep worked example, e0=0.8,
Cc=0.25, Cα=0.02); Mesri & Castro (1987) Cα/Cc; Mesri et al. (1997) JGGE 123(5)
(peat Cα/Cc≈0.06); multi-layer consolidation settlement theory §3.3 (t_p at
U=95%; surcharge Eqs 39–41); Vermeer & Neher (1999); Soft-Soil-Creep model verification.
| Test block (the published value it checks) | Verdict |
| creep 1: Cαε=0.05, H=5, t_p=1→t2=100 yr ⇒ 500 mm (2 log-cycles) | Pass |
| creep 2: same, t2=50 yr ⇒ 424.74 mm | Pass |
| creep 3: same, t2=10 yr ⇒ 250 mm (1 log-cycle = Cαε·H) | Pass |
| creep 4: Das NC-clay Cα=0.02, e_p=0.766, H=3, t_p=1.5→t2=15 ⇒ 33.98 mm | Pass |
| creep 5: Das clay, t2=6.5 yr ⇒ 21.63 mm | Pass |
| creep 6: inorganic Cα=0.008, e_p=0.9, H=4, t_p=2→t2=20 ⇒ 16.84 mm | Pass |
| creep 7: inorganic, t2=50 ⇒ 23.55 mm | Pass |
| creep 8: t2 = t_p ⇒ 0 mm (creep starts only after primary) | Pass |
| creep 9: settlement scales linearly with H | Pass |
| t_p 10: cv=5 m²/yr, H=10, single drainage ⇒ t_p = 1.129·100/5 = 22.58 yr | Pass |
| t_p 11: double drainage halves H_dr ⇒ t_p = 5.645 yr (¼ of single) | Pass |
| t_p 12: no cv ⇒ falls back to the input t_p | Pass |
| SSC 13: μ* = Cα/(ln10·(1+e)); Cα=0.04, e=1 ⇒ 0.008686 | Pass |
| SSC 14: λ* = Cc/(ln10·(1+e)); Cc=0.485, e=1 ⇒ 0.1053 (≈ Soft-Soil-Creep (Vermeer & Neher 1999) preset λ*=0.1055) | Pass |
| SSC 15: κ* = 2·Cr/(ln10·(1+e)); Cr=0.05, e=1 ⇒ 0.02172 | Pass |
| rate 16: dS/dt = Cαε·H·1000/(ln10·t2); base @100 yr ⇒ 1.086 mm/yr | Pass |
| rate 17: rate decreases with time (creep decelerates) | Pass |
| fingerprint 18: Cα/Cc=0.04 ⇒ inorganic clay, consistent | Pass |
| fingerprint 19: peat Cα/Cc≈0.06 ⇒ peat/organic band | Pass |
| fingerprint 20: Cα/Cc=0.15 ⇒ flagged inconsistent (outside 0.02–0.10) | Pass |
| surcharge 21: R_s′>0 reduces creep vs no surcharge (t_l = 100·t_p·R_s′^1.7) | Pass |
| surcharge 22: if t_l > design life ⇒ zero creep, ~100 % eliminated | Pass |
| surcharge 23: no surcharge ⇒ eliminated 0 %, settlement unchanged | Pass |
| surcharge 24: peat uses t_l = 10·t_p·R_s′ (linear, not power 1.7) | Pass |
| verdict 25: below the limit ⇒ ACCEPTABLE; above ⇒ recommends a surcharge | Pass |
settlement-is8009-web-validation.test.ts
C.SET8009 — `settlement` web-benchmark against IS 8009 (Part 1):1976.
Analyses validated: settlement · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
C.SET8009 — `settlement` web-benchmark against IS 8009 (Part 1):1976.
SOURCE
`Geo Technical engineering books/IS-8009-Part1-1976-settlement-of-shallow-foundations.pdf`
— IS:8009 (Part I)-1976, *Code of Practice for Calculation of Settlements of Foundations:
Part I Shallow Foundations Subjected to Symmetrical Static Vertical Loads*. BIS
Right-To-Information public-disclosure edition, 47 pp, clean text layer.
─────────────────────────────────────────────────────────────────────────────────────────
A WRONG CLAUSE CITATION, FOUND AND FIXED (the main outcome of this suite)
─────────────────────────────────────────────────────────────────────────────────────────
`settlement.ts` cited its **default** stress model as "IS 8009-1 Cl 9.2.2 spread
approximation" in three places. Verified against the standard, that was wrong twice over:
- IS 8009-1:1976 contains **ZERO** occurrences of "2:1", "spread" or "dispersion".
It does not describe a 2:1 load-spread method anywhere.
- **Cl 9.2.2 is "Clay Layer Sandwiched between Cohesionless Soil Layers or between a
Cohesionless Soil Layer at Top and Rock at Bottom"** — an unrelated topic.
- What the standard actually prescribes is **Boussinesq**, at **Cl 8.3.1**: "The pressure
increment induced by the imposed loads are usually determined using the isotropic,
homogeneous and elastic half space solutions due to Boussinesq", with Cl 8.3.6 pointing
to the Appendix B charts. "Boussinesq" appears **9 times** in the standard; Cl 8.3.3
adds Westergaard for over-consolidated clay and Cl 8.3.4 Fröhlich for sand.
The 2:1 spread is a legitimate conservative preliminary-design approximation from the
standard texts (Bowles, Das, Terzaghi & Peck) — it is simply **not an IS 8009 method**.
A citation pointing at a clause that does not support the formula is worse than no
citation, because it looks verified. Corrected in the source and in the runtime
`references`, and `C.SET8009.5` pins the corrected attribution.
**Left for a product decision, not changed unilaterally:** the IS 8009-compliant path
(`stress_method: 'boussinesq'`) is the NON-default option, so the default is the less
standards-compliant of the two. Switching the default would change every saved result, so
it is recorded in `ENGINE-AUDIT-FIX-QUEUE.md` rather than done here.
SCOPE
IS 8009 Part 1 presents its depth factor as **Fig. 12, a chart** — there is no tabulated
data to transcribe, so the engine's digitised anchors cannot be checked value-by-value
from the text. What is asserted here is the published behaviour the clause text does fix:
the exact rigidity factor, the depth factor's endpoints and monotonicity, and the
consolidation formula. Stated so nobody reads this suite as more than it is.
| Test block (the published value it checks) | Verdict |
| C.SET8009.1: rigidity factor is exactly 0.8 — IS 8009-1 Cl 9.5.2 Eq (13) | Pass |
| C.SET8009.2: depth factor — Cl 9.5.1 / Fig 12 endpoints and monotonicity | Pass |
| C.SET8009.3: primary consolidation follows the Terzaghi 1-D law (Cl 9.3.3) | Pass |
| C.SET8009.4: IS 8009 prescribes Boussinesq — both stress paths are available and differ | Pass |
| C.SET8009.5: the corrected citation is what the engine now reports at runtime | Pass |
| C.SET8009.6: IS 1904 serviceability guidance is surfaced past 75 mm | Pass |
settlement-worked-examples-web-validation.test.ts
settlement — FULL WORKED EXAMPLES (the ≥20-value gate).
Analyses validated: settlement · Recorded run: passed — 33 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
settlement — FULL WORKED EXAMPLES (the ≥20-value gate). Every expected value is PRINTED in the
cited source, read 2026-09-27 from `Geo Technical engineering books/`.
[DAS] Das, Principles of Foundation Engineering (Cengage): Ex 2.12, Problems 2.13 / 2.14
(answers p. 902), Ex 7.2 (F1, F2), Ex 7.10, Ex 7.11. The engine takes no σ′0 input, so
the 1-D cases use an overburden layer chosen to give the book's σ′0 at clay mid-depth
and a very wide load so Δσ = q (the book's own assumption).
[CRAIG] Craig's Soil Mechanics: Ex 4.6 (wide fill, half-closed layer) and Ex 8.5 (Iqr profile).
[BOW] Bowles 5e: Table 5-2 (Steinbrenner I1, I2 — printed to 3 dp), Ex 5-7 (raft), Ex 5-14.
[NHI] FHWA NHI-06-088 Ex 7-3 (embankment, t90) and NHI-06-089 Ex 8-3 (footing, 2:1).
Book slips found and NOT used: Das Ex 7.2 evaluates Is = F1 + (2 − μ)/(1 − μ)·F2 = 0.716 although
its own Eq. 7.5 is (1 − 2μ)/(1 − μ) (→ 0.659), so its 13.3 mm is not compared; its F1/F2 are.
| Test block (the published value it checks) | Verdict |
| [DAS] Ex 2.12 primary consolidation Sc = 87.5 mm | Pass |
| [DAS] Ex 2.12 at t = 31.6 days U = 45.7 % (S = 40 mm) | Pass |
| [DAS] Problem 2.13 (NC): Sc = 87.2 mm (Cc = 0.009(LL − 10) = 0.288, Eq. 2.54; Cs = Cc/5) | Pass |
| [DAS] Problem 2.14 (OC, σ′p = 128): Sc = 56.69 mm (Cc = 0.009(LL − 10) = 0.288, Eq. 2.54; Cs = Cc/5) | Pass |
| [DAS] Ex 7.10 oedometric Sc under a 1 × 2 m footing = 46.5 mm (Boussinesq; Das averages Δσ by Simpson’s rule) | Pass |
| [DAS] Ex 7.11 secondary compression t 1.3 → 6.3 yr, C′α = Cα/(1 + ep) → Ss = 19.4 mm | Pass |
| [CRAIG] Ex 4.6 final consolidation settlement = 182 mm | Pass |
| [CRAIG] Ex 4.6 settlement after 3 yr (corrected t = 2.5 yr, half-closed) = 61 mm | Pass |
| [CRAIG] Ex 8.5 Boussinesq corner factor at z = 1.5 m below base: Iqr = 0.233 | Pass |
| [CRAIG] Ex 8.5 Boussinesq corner factor at z = 4.5 m below base: Iqr = 0.121 | Pass |
| [CRAIG] Ex 8.5 Boussinesq corner factor at z = 7.5 m below base: Iqr = 0.06 | Pass |
| [CRAIG] Ex 8.5 Boussinesq corner factor at z = 10.5 m below base: Iqr = 0.033 | Pass |
| [CRAIG] Ex 8.5 Boussinesq corner factor at z = 13.5 m below base: Iqr = 0.021 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 0.2, M = 1: I1 = 0.009, I2 = 0.041 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 0.4, M = 1.5: I1 = 0.028, I2 = 0.071 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 0.6, M = 2: I1 = 0.055, I2 = 0.092 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 0.8, M = 1.2: I1 = 0.1, I2 = 0.09 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 1, M = 1: I1 = 0.142, I2 = 0.083 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 1.5, M = 1.7: I1 = 0.217, I2 = 0.102 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 2, M = 1.4: I1 = 0.292, I2 = 0.083 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 3, M = 2: I1 = 0.402, I2 = 0.084 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 4, M = 1: I1 = 0.408, I2 = 0.037 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 5, M = 1.5: I1 = 0.496, I2 = 0.045 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 6, M = 1.8: I1 = 0.55, I2 = 0.045 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 8, M = 2: I1 = 0.611, I2 = 0.038 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 10, M = 1.3: I1 = 0.554, I2 = 0.02 | Pass |
| [BOW] Table 5-2 Steinbrenner N = 20, M = 1.9: I1 = 0.69, I2 = 0.015 | Pass |
| [DAS] Ex 7.2 Steinbrenner at m′ = 2, n′ = 10: F1 = 0.641, F2 = 0.031 | Pass |
| [BOW] Ex 5-7 raft: M = 1.2, N = 0.7, μ = 0.35 → Is = 0.121; flexible centre ΔH = 16.5/IF(0.95) = 17.4 mm | Pass |
| [BOW] Ex 5-14 OC clay (Cr to p′c, Cc beyond), Boussinesq through the layer → ΔH = 1.14 in (Bowles uses a layer-average Δp; ±5 %) | Pass |
| [NHI] NHI-06-088 Ex 7-3 embankment on NC clay: ΔH = 0.53 m | Pass |
| [NHI] NHI-06-088 Ex 7-3 single drainage: t90 = 424 days | Pass |
| [NHI] NHI-06-089 Ex 8-3 footing on NC clay, 2:1 at clay mid-depth: ΔH = 1.1 in | Pass |
strip-load-stress-web-validation.test.ts
strip-load-stress — dedicated web-benchmark against PUBLISHED values.
Analyses validated: strip-load-stress · Recorded run: passed — 3 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
strip-load-stress — dedicated web-benchmark against PUBLISHED values.
Engine: `strip-load-stress.ts` — Boussinesq vertical stress beneath the CENTRELINE of a uniformly loaded flexible
strip of width B: α = 2·atan(B/2z), Δσ_z = (q/π)(α + sin α), together with the 2:1 spread Δσ = qB/(B+z).
SOURCES (locators beside each value)
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Table 6.3 "Variation of Δσ/q0 with
2z/B and 2x/B" (Eq. 6.7; printed pp.269–270, 3 d.p.), the 2x/B = 0 column (strip centreline), and §6.5.
FHWA NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Ch. 2 — Example 2-2 (printed p.2-28): a 5 ft
strip footing, 1 000 psf, stress increments under the centreline read from the Fig. 2-9 isobar chart.
Varghese, P.C. (2005), Foundation Engineering, PHI — §3.8 and Eq. (3.10): principal stresses under a strip,
θ = 90° at a depth of about B/2.
TOLERANCES, stated before running
• Das Table 6.3: 3 d.p. ⇒ half-unit 5e-4 (all 50 rows 2z/B = 0.1 … 5.0 of the column were compared with the closed form, every one within half a unit; 21 are asserted).
• FHWA isobar chart (Fig 2-9): values are read between contour lines and printed to 2 d.p.; a reading uncertainty of
0.02·q (one fifth to one quarter of the contour spacing) is taken. Two of the eight reads use ≥ 70 % of this
allowance (z/B = 0.5: 0.80 vs 0.818; z/B = 2.0: 0.32 vs 0.306) — contour-chart precision, not an engine effect,
since Das's finely tabulated Table 6.3 agrees with the engine to 5e-4 at the same depths.
| Test block (the published value it checks) | Verdict |
| Das (2016) Table 6.3, 2x/B = 0 column — Δσ/q0 against 2z/B, twenty-one published values | Pass |
| FHWA NHI-06-088 (2006) Example 2-2 — 5 ft strip footing, 1 000 psf: stress under the centreline from the isobar chart | Pass |
| Varghese (2005) §3.8.1 / Eq. 3.10 — the strip subtends 90° at a depth of B/2; stress ratio there is (π/2 + 1)/π | Pass |
vacuum-preload-web-validation.test.ts
Validation of the VACUUM PRELOADING engine (`vacuum-preload.ts`) against PUBLISHED preloading settlement and PVD time-rate examples.
Analyses validated: vacuum-preload · Recorded run: passed — 22 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the VACUUM PRELOADING engine (`vacuum-preload.ts`) against PUBLISHED preloading settlement
and PVD time-rate examples.
WHAT THE ENGINE DOES, AND WHAT CAN BE CHECKED AGAINST A BOOK. It adds the effective vacuum to any companion
fill into ONE equivalent stress increment (Han 2015 §7.2.4: vacuum and fill act additively), computes the
e–log σ′ primary settlement for that increment, and marches it in time with the Barron/Hansbo PVD radial
solution Carrillo-combined with vertical consolidation. The additive rule, the settlement formula, the radial
solution and the Carrillo combination are exactly what the published preloading examples below use, so those
examples are reproduced by entering the book's total stress increment as "effective vacuum + fill".
NOT benchmarked: the vacuum physics itself (membrane leakage, vacuum decay with depth, inward lateral
movement) — no numeric published answer for those was available in the library (Han §7.2–7.6 describes them
qualitatively; Chu & Yan, Indraratna et al. and Chai et al. are not in the library).
Published sources (every number was read from the page named beside it; none is recalled):
1. Han, J. (2015), Principles and Practice of Ground Improvement, Wiley — Design Example 7.1
(Ch. 7, pp. 227–230): 6 m NC soft clay on bedrock, Cc = 0.8, e0 = 1.0, cv = 1.8e-8 m²/s, cr = 4.5e-8 m²/s,
PVD 100 × 4 mm (dc = 0.052 m) at 1.0 m triangular; total primary settlements 1.58, 2.08 and 2.37 m for
4.5, 8 and 11 m of fill (Sc1, Sc2, Sc3), radial Ur = 48.2 / 77.8 / 92.3 / 40.9 / 83.2 / 98.3 % at
Tr = 0.185 / 0.423 / 0.720 / 0.148 / 0.502 / 1.145, and overall Uvr = 51.0 % at 52.5 days, 93.1 % at
204 days (Carrillo of Uv and Ur).
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage — Table 16.5 "Variation of Ur for
various values of Tr and n, no-smear case" (pp. 844–846).
3. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Example 4.7 (Ch. 4, pp. 139–140):
10 m half-closed clay, cv = 4.7 m²/yr, ch = 7.9 m²/yr, 400 mm sand drains, S = 3.2 m square (n = 9),
t = 6 months ⇒ Uv = 0.17 and overall U = 0.85.
HOW THE HAN LOADS ARE ENTERED. Han's Δσ = 19.7 kN/m³ × fill height (88.65, 157.6, 216.7 kPa). The engine gets
80 kPa of vacuum at efficiency 1 plus a companion fill of Δσ − 80 kPa, so the equivalent surcharge is Han's
Δσ exactly. σ′0 = (18.1 − 9.8)·3 = 24.9 kPa is Han's mid-layer effective stress.
TOLERANCES, derived from what the source prints and from the known constants that differ:
· Han settlements are printed to 3 s.f. ⇒ ±0.005 m.
· Han's radial Ur: he uses de = 1.06·S and rounds ND = de/dc = 20.4 to 20 in F(n); the engine uses Hansbo's
de = 1.05·S and Barron's exact F(n). Those move Tr by 1.9 % and F by 0.6 %, i.e. up to
(1−U)(−ln(1−U))·(0.019 + 0.006) ≈ 0.9 percentage points at worst ⇒ ±1.0.
· Han's overall Uvr adds the printed Uv (±0.1) to that ⇒ ±1.2. The settlement at 52.5 days carries the same
±1.2 points of 1.58 m ⇒ ±0.02 m.
· Das Table 16.5: Tr is printed to 4 d.p. and the engine's output to 0.1 % ⇒ ±0.1.
· Craig's n is read from a plotted curve to the nearest integer, so a time derived from it carries ±0.5/9 in n
⇒ ±11 % in de² ⇒ ±12 % in t. Craig's Uv is printed to 2 s.f. ⇒ ±0.005.
ENGINE FIX FOUND BY THIS SUITE. With a vertical cv supplied the engine assumed DOUBLE drainage (Hdr = H/2). Han's
Example 7.1 has a single-drained 6 m layer on bedrock (Hdr = 6 m), and Han §7.2.3 (p. 217, citing Chai & Carter)
states that under vacuum the drainage distance is the full thickness because no vacuum can act at the bottom
boundary. With Hdr = H/2 the engine returned Uvr = 53.6 % against Han's 51.0 % (and Craig's Uv = 0.35 against 0.17).
`vacuum-preload.ts` now uses Hdr = H. The web runner does not expose cv, so only programmatic callers that pass cv are
affected.
| Test block (the published value it checks) | Verdict |
| Han Example 7.1: Sc1 = 1.58 m under 4.5 m of fill (Δσ = 88.65 kPa) | Pass |
| Han Example 7.1: Sc2 = 2.08 m under 8 m of fill (Δσ = 157.6 kPa) | Pass |
| Han Example 7.1: Sc3 = 2.37 m under 11 m of fill (Δσ = 216.7 kPa) | Pass |
| Han Example 7.1: Tr = 0.185 ⇒ Ur = 48.2 % | Pass |
| Han Example 7.1: Tr = 0.423 ⇒ Ur = 77.8 % | Pass |
| Han Example 7.1: Tr = 0.720 ⇒ Ur = 92.3 % | Pass |
| Han Example 7.1: Tr = 0.148 ⇒ Ur = 40.9 % | Pass |
| Han Example 7.1: Tr = 0.502 ⇒ Ur = 83.2 % | Pass |
| Han Example 7.1: Tr = 1.145 ⇒ Ur = 98.3 % | Pass |
| Han Example 7.1: overall Uvr = 51.0 % at 52.5 days (Uv = 5.4 % with Hdr = 6 m) | Pass |
| Han Example 7.1: overall Uvr = 93.1 % at 204 days | Pass |
| Han Example 7.1: settlement at 52.5 days = 0.510 × 1.58 = 0.81 m | Pass |
| Das Table 16.5: n = 5, Tr = 0.0811 ⇒ Ur = 50 % | Pass |
| Das Table 16.5: n = 10, Tr = 0.0704 ⇒ Ur = 30 % | Pass |
| Das Table 16.5: n = 10, Tr = 0.4543 ⇒ Ur = 90 % | Pass |
| Das Table 16.5: n = 15, Tr = 0.3966 ⇒ Ur = 80 % | Pass |
| Das Table 16.5: n = 15, Tr = 0.7382 ⇒ Ur = 95 % | Pass |
| Das Table 16.5: n = 20, Tr = 0.3392 ⇒ Ur = 70 % | Pass |
| Das Table 16.5: n = 25, Tr = 0.2834 ⇒ Ur = 60 % | Pass |
| Das Table 16.5: n = 25, Tr = 1.0846 ⇒ Ur = 97 % | Pass |
| Craig Example 4.7: vertical drainage alone gives Uv = 0.17 at 6 months (half-closed, d = H = 10 m) | Pass |
| Craig Example 4.7: the 3.2 m sand-drain layout reaches U = 85 % in about 6 months | Pass |
⚑ vertical-stress-increase-web-validation.test.ts
vertical-stress-increase — dedicated web-benchmark against PUBLISHED values.
Analyses validated: vertical-stress-increase · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
vertical-stress-increase — dedicated web-benchmark against PUBLISHED values.
Engine: `vertical-stress-increase.ts` — Δσ_z under the corner or centre of a uniformly loaded flexible rectangle
by Boussinesq (Newmark corner factor) and by Westergaard (ν-dependent, for stratified soil).
SOURCES (locators beside each value)
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Ch. 6: Table 6.4 (corner I(m,n),
5 d.p., printed pp.273–275), Table 6.5 (centre Ic, 3 d.p., p.276), Table 6.8 (Westergaard Iw for ν = 0, 4 d.p.,
p.294), Examples 6.2 (p.277) and 6.9 (p.294).
Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill — Table 5-1 (corner Ia, 3 d.p.; page
image checked, PDF p.321), Example 5-3 (p.322), and the Westergaard programming check beneath Eq. (5-15)
(p.329, image-checked: μ = 0.45).
Lambe, T.W. and Whitman, R.V. (1979), Soil Mechanics SI Version, Wiley — Fig 8.6 chart reads in Example 8.3.
Holtz, R.D. and Kovacs, W.D. (1981), An Introduction to Geotechnical Engineering, Prentice-Hall — Example 8.18
(Fig 8.21 chart reads; text layer is a scan, pages read by OCR of the page image).
HOW TABLE CELLS ARE DRIVEN
Corner: B = m·z, L = n·z with z = 1 ⇒ influence_boussinesq = I(m,n). Centre (Table 6.5): B = 2 m, L = 2·m1 m,
depth z = n1 m ⇒ the engine's four B/2 × L/2 quadrants have m = 1/n1, n = m1/n1 ⇒ influence_boussinesq = Ic.
BOOK ANOMALIES FOUND (none changes the engine)
• Das Table 6.4 (credited to Saika 2012): 34 of 484 cells differ from the closed form by 1–2 units in the FIFTH decimal
(e.g. m=1.6,n=5: 0.23236 printed, 0.23235 closed form). Cells are asserted to 3e-5 — the printed 5th decimal is not
reliable; this is the table's own inconsistency, measured, and is still ≥1000× tighter than engineering use.
• Das Table 6.8 contains 3 transposition misprints: (m=0.4,n=10) prints 0.0847 vs its own mirror (m=10,n=0.4)
0.0817; (0.1,5) prints 0.0211 vs mirror (5,0.1) 0.0221; (1,5) 0.1491 vs mirror (5,1) 0.1499. The engine agrees
with the mirror in all three; only cells that are consistent with their mirror are asserted.
• Bowles Westergaard check table (μ=0.45): prints 0.1845 and 0.1529; Bowles's own Eq. (5-15) gives 0.18457 and
0.15298 (identical to the engine), so the printed figures sit 7–8e-5 below — tolerance one unit in the last
printed place, 1e-4.
• Holtz & Kovacs Ex 8.19 (multi-rectangle) is not asserted: its rectangle table lists y = 3 m with n = 1, which is
internally inconsistent, and its chart reads differ from the closed form by up to 0.006.
| Test block (the published value it checks) | Verdict |
| Das (2016) Table 6.4 — Boussinesq corner influence I(m,n), fourteen cells (5 d.p.) | Pass |
| Das (2016) Table 6.5 — Boussinesq influence Ic under the CENTRE, ten cells (3 d.p.) | Pass |
| Das (2016) Examples 6.2 and 6.9 — 2.5 × 5 m footing, 150 kPa, z = 6.25 m under the centre | Pass |
| Das (2016) Table 6.8 — Westergaard corner influence Iw for ν = 0, twelve cells (4 d.p.) | Pass |
| Bowles (1997) Table 5-1 — corner Ia (3 d.p., M = B/z, N = L/z), eleven cells | Pass |
| Bowles (1997) Example 5-3 — 800 kN on a 2 × 2 m footing, q = 200 kPa | Pass |
| Bowles (1997) Eq. (5-15) programming check — Westergaard corner factor at μ = 0.45 | Pass |
| Lambe & Whitman (1979) Example 8.3 and Holtz & Kovacs (1981) Example 8.18 — chart-read corner factors | Pass |
⚑ weighted-creep-web-validation.test.ts
weighted-creep — validation of Bligh's and Lane's creep-ratio checks against PUBLISHED safe-ratio tables and worked weir examples.
Analyses validated: weighted-creep · Recorded run: passed — 25 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
weighted-creep — validation of Bligh's and Lane's creep-ratio checks against PUBLISHED safe-ratio
tables and worked weir examples. `weighted-creep.ts`:
Bligh: L_B = ΣL_v + ΣL_h , C_B = L_B/H ; Lane: L_w = ΣL_v + ΣL_h/3 , C_w = L_w/H
Published sources (all opened and read; none of them is the ORIGINAL 1910/1935 paper, which is not in
the local library — that is stated per source):
1. Lane, E.W. (1935), "Security from under-seepage: masonry dams on earth foundations", Trans. ASCE 100.
The ORIGINAL paper was not opened. Its 13-row table of recommended safe weighted-creep gradients was
read as REPRODUCED, with the source line "(Source: Lane, 1935)", in Table 2-2 of an IHE Delft MSc
thesis (2011), https://ihedelftrepository.contentdm.oclc.org/digital/api/collection/masters2/id/814/download
(one-page extract, read 2026-10-07). The extract defines N (horizontal and flat-sloping contacts) and
V (vertical and steep-sloping contacts) for Lane's weighted length.
2. Mustansiriyah University (2020), Hydraulic Structures, Chapter 2 "Theories of Seepage", lecture notes,
https://uomustansiriyah.edu.iq/media/lectures/5/5_2020_03_14!12_21_54_PM.pdf (read 2026-10-07):
Table 1 (Bligh's creep coefficients), Table 2 (Lane's coefficients), Lane's Eq. (9) Lw = N/3 + V,
and worked Examples 1, 2 and 5 with printed creep lengths and verdicts.
3. The chapter "Theories of Seepage and Design of Weirs and Barrages" of S.K. Garg's Irrigation
Engineering and Hydraulic Structures (chapter PDF, civilpddc2013.weebly.com; the extract does not
print the edition year), Tables 11.1 and 11.2: the same coefficients as range rows. Used only for the
range rows below.
SCOPE. The Bligh table of these sources has FOUR rows (light sand & mud 18, fine micaceous sand 15,
coarse-grained sand 12, boulders/gravel/sand 5–9). The engine's other Bligh entries (medium sand 14,
soft clay 12, hard clay 8) are NOT in any source read and are therefore not asserted.
Mapping of names (judgement, stated): "light sand and mud" → silt_very_fine_sand; "fine micaceous sand" →
fine_sand; "coarse-grained sand" → coarse_sand; "boulders, gravel and sand 5–9" → the three gravel rows.
| Test block (the published value it checks) | Verdict |
| Lane 1935 (IHE thesis Table 2-2): very fine sand or silt → safe weighted-creep ratio 8.5 | Pass |
| Lane 1935 (IHE thesis Table 2-2): fine sand → safe weighted-creep ratio 7 | Pass |
| Lane 1935 (IHE thesis Table 2-2): medium sand → safe weighted-creep ratio 6 | Pass |
| Lane 1935 (IHE thesis Table 2-2): coarse sand → safe weighted-creep ratio 5 | Pass |
| Lane 1935 (IHE thesis Table 2-2): fine gravel → safe weighted-creep ratio 4 | Pass |
| Lane 1935 (IHE thesis Table 2-2): coarse gravel including cobbles → safe weighted-creep ratio 3 | Pass |
| Lane 1935 (IHE thesis Table 2-2): boulders with some cobbles and gravel → safe weighted-creep ratio 2.5 | Pass |
| Lane 1935 (IHE thesis Table 2-2): soft clay → safe weighted-creep ratio 3 | Pass |
| Lane 1935 (IHE thesis Table 2-2): hard clay → safe weighted-creep ratio 1.8 | Pass |
| Mustansiriyah 2020 Table 1: light sand and mud → Bligh coefficient 18 | Pass |
| Mustansiriyah 2020 Table 1: fine micaceous sand → Bligh coefficient 15 | Pass |
| Mustansiriyah 2020 Table 1: coarse-grained sand → Bligh coefficient 12 | Pass |
| Mustansiriyah 2020 Table 1: fine_gravel lies inside the printed Bligh range 5–9 for boulders/gravel/sand | Pass |
| Mustansiriyah 2020 Table 1: coarse_gravel lies inside the printed Bligh range 5–9 for boulders/gravel/sand | Pass |
| Mustansiriyah 2020 Table 1: boulders_gravel lies inside the printed Bligh range 5–9 for boulders/gravel/sand | Pass |
| Garg Table 11.2: coarse gravel (3.0) and boulders (2.5) lie inside the printed Lane ranges 3.0–3.5 and 2.5–3.0 | Pass |
| Mustansiriyah 2020 Eq. 9 / Lane 1935: 30 m of horizontal contact counts 10 m, 30 m of vertical counts 30 m | Pass |
| Mustansiriyah 2020 Ex 1 (Bligh): creep length 63 m, gradient 1/15.75 | Pass |
| Mustansiriyah 2020 Ex 1 (Bligh): on fine sand (C = 15) the structure is "safe" | Pass |
| Mustansiriyah 2020 Ex 2 (Bligh): creep length 64 m, gradient 1/10.67 | Pass |
| Mustansiriyah 2020 Ex 2 (Bligh): safe on sand mixed with boulders and gravel (C = 5…9) | Pass |
| Mustansiriyah 2020 Ex 5 (Lane): N = 52.2 m, V = 31.2 m → weighted creep length 48.6 m | Pass |
| Mustansiriyah 2020 Ex 5 (Lane): coarse sand (C = 5) → "safe against piping" | Pass |
| Lane rule "safe if H/Lw ≤ 1/C": a structure exactly at C is safe, just under it is not | Pass |
| a cleared head is refused rather than reported as a creep ratio of 2.4e10 | Pass |
Slopes and embankments — factor of safety
FE kernel registry — 32 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-2d-tut2 | drained / undrained embankment + safety factor [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 40–51 | — | — | — | — | — | Superseded |
k5c-acads-1a-fela-bounds | SR-FELA factor of safety, lower / upper bound (ACADS 1(a), homogeneous slope) [-] | Optum-G2-Verification-Slope-Stability.pdf, p. 3–4 (§2.1, Table 2) | — | 0.981 | lower: 0.9769; upper: 0.9879; errorPct: 0.56 | — | — | Pass |
k5c-acads-1a-lem | LEM critical-circle factor of safety: Bishop / Spencer / Morgenstern–Price [-] | ../Slide_SlopeStabilityVerification.pdf, p. 20–23 (Problem #1, Table 1.2) | — | 0.986 | bishop: 0.9851; spencer: 0.9841; morgenstern-price: 0.984 | — | −0.20 % | Pass |
k5c-acads-1c-fela-bounds | SR-FELA factor of safety, lower / upper bound (ACADS 1(c), three soils, inclined boundaries) [-] | Optum-G2-Verification-Slope-Stability.pdf, p. 5–6 (§2.2, Table 4) | — | 1.359 | lower: 1.3443; upper: 1.3623; errorPct: 0.67 | — | — | Pass |
k5c-acads-1c-lem | LEM critical-circle factor of safety: Bishop / Spencer / Morgenstern–Price [-] | ../Slide_SlopeStabilityVerification.pdf, p. 28–31 (Problem #3, Table 3.2) | — | 1.375 | bishop: 1.4027; spencer: 1.372; morgenstern-price: 1.3715 | — | −0.22 % | Pass |
k5c-acads-1d-fela-bounds | SR-FELA factor of safety, lower / upper bound (ACADS 1(d), kh = 0.15) [-] | Optum-G2-Verification-Slope-Stability.pdf, p. 6–7 (§2.3, Table 6) | — | 1.039 | lower: 0.9669; upper: 0.9767; errorPct: 0.51 | — | −6.47 % | Deviation |
k5c-acads-1d-lem | LEM critical-circle factor of safety, kh = 0.15: Bishop / Spencer / Morgenstern–Price [-] | ../Slide_SlopeStabilityVerification.pdf, p. 32–35 (Problem #4, Table 4.2) | — | 0.991 | bishop: 1.0128; spencer: 0.9891; morgenstern-price: 0.9866 | — | −0.19 % | Pass |
k5c-acads-3a-fela-bounds | SR-FELA factor of safety, lower / upper bound (ACADS 3(a), weak seam + water table) [-] | Optum-G2-Verification-Slope-Stability.pdf, p. 7–9 (§2.4, Table 8) | — | 1.265 | lower: 1.2592; upper: 1.2622; errorPct: 0.12 | — | — | Pass |
k5c-acads-3a-lem-noncircular | LEM non-circular (path search) Spencer factor of safety [-] | ../Slide_SlopeStabilityVerification.pdf, p. 44–46 (Problem #7, Table 7.2) | — | 1.246 | spencer (circular): 1.5025; spencer (non-circular): 1.2629; morgenstern-price (circular): 1.4963; morgenstern-price (non-circular): 1.2925 | — | +1.35 % | Pass |
k5c-arai-tagyo-16 | LEM (Bishop / Spencer / M-P) and SR-FELA bounds, polyline water table [-] | ../Slide_SlopeStabilityVerification.pdf, p. 77–78 (Problem #16, Table 16.2) | — | 1.118 | lem: (bishop: 1.1132; spencer: 1.1139; morgenstern-price: 1.1122); felaLower: 1.116; felaUpper: 1.1191 | — | −0.43 % | Pass |
k5c-griffiths-lane-ex1 | SR-FELA bounds and LEM, 2:1 slope φ′ 20°, c′/γH 0.05, D = 1 [-] | ../Griffiths and Lane 1999.pdf, p. Géotechnique 49(3) 387–403, Example 1, Fig. 2 | — | 1.38 | felaLower: 1.3751; felaUpper: 1.3809; lem: (bishop: 1.3781; spencer: 1.3758; morgenstern-price: 1.3756) | — | — | Pass |
k5c-plaxis-phic-vs-bishop | factor of safety of the 1:2 embankment: SR-FELA bounds, LEM [-] | PLAXIS-Verification-Phi-c-reduction-vs-Bishop-updated.pdf, p. 1–4 (Analysis 1) | 1.54 (PLAXIS 2D) | 1.534 | felaLower: 1.5342; felaUpper: 1.5419; lem: (bishop: 1.5419; spencer: 1.5389; morgenstern-price: 1.5386) | −0.13 % | — | Pass |
k5c-plaxis-phic-vs-bishop-loaded | factor of safety with the crest load: SR-FELA bounds, LEM [-] | PLAXIS-Verification-Phi-c-reduction-vs-Bishop-updated.pdf, p. 2 (Analysis 2: 30 kPa over 3 m) | 1.261 (PLAXIS 2D) | 1.261 | felaLower: 1.2551; felaUpper: 1.2625; lem: (bishop: 1.2721; spencer: 1.2689; morgenstern-price: 1.2694) | −0.17 % | — | Pass |
k5c-vertical-cut | stability number γH/cu of an unsupported vertical cut (Tresca), gravity multiplier [-] | ../_founder_2026-10-15/Lyamin-Sloan-2002_Upper-bound-limit-analysis-linear-FE-and-nonlinear-programming_IJNAMG-26_36p.pdf, p. §4.3, Table IV | — | 3.772–3.7845 | lower: 3.7577; upper: 3.7927; errorPct: 0.46 | — | — | Pass |
k5b-plaxis-2d-tut2-drained | Tutorial 2, embankment on DRAINED HS clay: uy at the crest (23,4), centre base (25,0), 2 m beyond the toe (38,0) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 40–46 (Fig. 2-7: figures only) | — | — | crest: -226.7; centre base: -177.9; beyond toe (38,0): 0.6 | — | — | Recorded, no published value |
k5b-plaxis-2d-tut2-undrained | Tutorial 2, embankment on UNDRAINED (A) HS clay: construction completes [ΣMstage] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 44–47 (Figs 2-7, 2-8) | 1 | — | 1 | 0.00 % | — | Pass |
k5a-phic-bishop-analysis1 | factor of safety ΣMsf, embankment 1:2, no load (Analysis 1) [-] | PLAXIS-Verification-Phi-c-reduction-vs-Bishop-updated.pdf, p. 1–3 | 1.54 | 1.534 | 1.53867 | −0.09 % | +0.30 % | Pass |
k5a-phic-bishop-analysis2 | factor of safety ΣMsf after a 30 kPa crest load (Analysis 2) [-] | PLAXIS-Verification-Phi-c-reduction-vs-Bishop-updated.pdf, p. 2–3 | 1.261 | — | 1.25937 | −0.13 % | — | Pass |
k5a-gl99-example1 | factor of safety, homogeneous 2:1 slope, φ′ 20°, c′/γH 0.05, ψ 0, D = 1 [-] | Griffiths and Lane 1999.pdf (library root), p. 391–392, Table 2 | — | 1.35 | 1.3412 | — | −0.65 % | Deviation |
k5a-gl99-example3 | factor of safety, undrained (φu = 0) 2:1 slope on a foundation, cu/γH 0.25, D = 2, homogeneous [-] | Griffiths and Lane 1999.pdf (library root), p. 394, Fig. 7 | — | 1.47 | 1.45234 | — | −1.20 % | Pass |
k5a-tut2-safety-drained | factor of safety ΣMsf, embankment on drained clay (Phase 3) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 47–51 (Fig. 2-14) | 1.8 | — | 1.84688 | +2.60 % | — | Pass |
k5a-tut2-safety-undrained | factor of safety ΣMsf, embankment on undrained (A) clay (Phase 4) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 47–51 (Fig. 2-14) | 1.4 | — | 1.14911 | −17.9 % | — | Superseded |
k5d-plaxis-2d-tut2-safety | Tutorial 2 as ONE project (Phase 2 changes the clay to its undrained (A) copy — per-phase material change); ΣMsf of the Safety phases 3 (drained) / 4 (undrained), real Hardening Soil → Mohr–Coulomb at frozen start stiffness [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 47–51 (p. 51, Fig. 2-14: 'factor of safety of 1.8 … Phase 3', '1.4 … Phase 4') | drained: 1.8; undrained: 1.4 | — | drained: 1.8563; undrained (phase 2 completed under the default policy — the PLAXIS-comparable value): 1.3814 | drained: 3.13; undrained: -1.33 | — | Pass |
k5d-plaxis-2d-tut2-undrained-construction | Tutorial 2 Phase 2: embankment construction on UNDRAINED (A) HS clay — ΣMstage reached; uy crest (23,4) / centre base (25,0) / beyond the toe (38,0); max p_excess [ΣMstage, mm, kPa] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 44–47 (Figs 2-7, 2-8: figures only) | completes (ΣMstage 1); toe heave, p_excess highest under the embankment (figures) | — | default policy (strict, then the PLAXIS criterion with the initial stiffness — D124 + D684): (ΣMstage: 1; uy crest mm: -508.3; uy centre base mm: -250; uy (38,0) mm: 114.1; max p_excess kPa: 48.13; steps / cuts: [133, 0]; strict stop (reported in the warning): 0.587756) | — | — | Pass |
k5d-benchmark-embankment-soft-clay | SCMEP soft-clay embankment, Soft Soil (USTUTT set): centreline settlement after undrained construction / after 100 years, p_excess at (0, −2.5) [m, kPa] | PLAXIS-Verification-Benchmark-embankment-soft-clay-workshop.pdf (Wiltafsky et al. 2003), p. 2–5 (Fig. 1, Tables 1–2; Figs 2a, 2d, 3a, 3d read) | SS USTUTT settlement after construction (Fig. 2a): 0.18; after 100 years (Figs 3a, 3d): 1.05; p_excess (0,-2.5) (Fig. 2d): -34 | other models after construction: 0.11–0.24 m; after 100 years: 1.10–1.60 m | tol 1e-8 (530 T15, 9 Nov 2026): after the D557 mesh change layer 1 stops at ΣMstage 0.8515 (92 steps); settlement (0,0) 0.0167 m there; layer 2 fails at ΣMstage about 0; consolidation takes 0 steps (Modal, agent medium-d627, D627). X2 verdict numerical-stall, best ratio 1.0008e-8 vs 1e-8. tol 1e-3 not re-measured on this mesh; tol 1e-8 (712 T15, before 7 Nov): layer 1 stops at ΣMstage 0.6515 (arc-length increment below its minimum); settlement (0,0) 0.0129 m there; tol 1e-3: layer 1 completes (19 steps); layer 2 reaches ΣMstage 0.918 in maxSteps 1000; plaxis (ALG-1): layer 1 (bounded probe, maxSteps 15): ΣMstage 0.66, 878 iterations, 5 cuts; layers 1–2 NOT completed within the 6-min run cap (not measured); without the local rule layer 1 completes (6 steps, 266 iterations); strict tol 1e-2: 5 steps, 31 iterations | — | — | Deviation |
k5d1-plaxis-2d-tut4-safety-phase7 | ΣMsf of the Safety phase after the second excavation (phase 3) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.33) | 1.33 | — | — | — | — | Deviation |
k5d1-plaxis-2d-tut4-safety-phase8 | ΣMsf of the Safety phase after the wall and backfill (phase 6) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.83) | 1.83 | — | — | — | — | Deviation |
alg1-plaxis-2d-tut4-repro-safety-phase7 | ΣMsf of the Safety phase after the second excavation (phase 3) — PLAXIS-REPRODUCTION variant (cable strength per metre, reduced in Safety; PLAXIS-parity convergence) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.83) | 1.33 | — | 1.2852 | −3.37 % | — | Deviation |
alg1-plaxis-2d-tut4-repro-safety-phase8 | ΣMsf of the Safety phase after the wall and backfill (phase 6) — PLAXIS-REPRODUCTION variant (cable strength per metre, reduced in Safety; PLAXIS-parity convergence) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 90–91 (Fig. 4–21, figure read: ≈ 1.83) | 1.83 | — | 1.6625 | −9.15 % | — | Deviation |
geostudio-swv-acads-1a-janbu-simplified | Janbu simplified factor of safety on the searched critical circle (ACADS 1(a): c' 3 kPa, phi' 19.6 deg, gamma 20 kN/m3) [-] | Seequent-GeoStudio-SLOPEW-Slope-Stability-Verification-Manual-current.pdf, p. 2 (§2.1 ACADS Simple Slope, Table 2) | — | 0.939 | 0.9351 | — | −0.42 % | Pass |
geostudio-swv2022-acads-1a-janbu-corrected | Janbu corrected (f0) factor of safety on the searched critical circle (ACADS 1(a): c' 3 kPa, phi' 19.6 deg, gamma 20 kN/m3) [-] | Seequent-GeoStudio-SLOPEW-Slope-Stability-Verification-Manual-Oct2022.pdf, p. 2 (§2.1 ACADS Simple Slope, Table 2) | — | 0.992 | 0.9854 | — | −0.66 % | Pass |
geostudio-hand-bishop-specified-circle | Bishop factor of safety on the manual's ONE specified slip circle (simple 2h:1v slope, 10 m high, c' 5 kPa, phi' 30 deg, gamma 20 kN/m3, 29 slices, phreatic line through the toe) [-] | Seequent-GeoStudio-SLOPEW-Verification-Hand-Calculations.pdf, p. 3–8 (Table 1 slice data p. 3; Bishop iteration Tables 3–6 pp. 6–8) | — | 1.249 | 1.2463 | — | −0.22 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
plaxis-2d-tut2 — Superseded · K3
Case: n/a
Mesh: n/a
Reproduce: n/a
Superseded by: k5b-plaxis-2d-tut2-drained, k5b-plaxis-2d-tut2-undrained, k5d-plaxis-2d-tut2-undrained-construction, k5d-plaxis-2d-tut2-safety
Notes: Superseded: this was an umbrella row for Tutorial 2 run with a Mohr-Coulomb stand-in for Hardening Soil. The tutorial is now run with the real Hardening Soil as one project, and the quantities have their own rows: drained construction (k5b-plaxis-2d-tut2-drained, recorded, figures only), undrained construction (two passing rows) and the safety factors, 1.8563 against 1.8 and 1.3814 against 1.4 (k5d-plaxis-2d-tut2-safety, pass). || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): after the HS-family fix: drained construction −226.7 mm at the crest (was −235.8); undrained construction at the STRICT tol 1e-8 stalls at ΣMstage 0.4475 (was 0.904; D107 stall, doc 375 §10 / D516 / D526 — NOT a collapse), completes at tol 1e-4 and in the PLAXIS-parity mode (ΣMsf from the completed construction 1.3922 vs PLAXIS 1.4; drained 1.8523 vs 1.8); see rows k5d-plaxis-2d-tut2-undrained-construction / -safety. || Hardening Soil (K5), Undrained (A) (K4), safety analysis (K5); no structures. Phase 1 is drained but HS. K4 (18 Oct): Undrained (A) now exists; still blocked on Hardening Soil and the safety analysis (K5). K5b (18 Oct): the constitutive-model part is done — see the k5b-* rows. K5 (19 Oct): drained construction converges (K5b, real HS) and drained safety 1.847 vs PLAXIS 1.8 (K5a, HS→MC); undrained-A construction stops at ΣMstage 0.478 with HS (D107) and undrained safety 1.1445 vs 1.4 with MC — see the k5a-/k5b- tut2 rows. K5d-2: one project with the per-phase material change; Safety with real HS 1.8516 / 1.3797 (rows k5d-plaxis-2d-tut2-*); undrained construction completes at tol 1e-3, at 1e-8 the arc-length reports a peak at 0.905 (D107 diagnosed).
k5c-acads-1a-fela-bounds — Pass · K5c
Reference: Optum G2 'exact' 0.981 ± 0.003 (its 10 000-element bounds 0.978 / 0.984)
Benchmark: vendor: Optum CE; product: OptumG2; version: 2019 verification; doc: Optum-G2-Verification-Slope-Stability.pdf; page: 4; caseId: Slope01 (ACADS 1(a))
Comparison (vendor): Optum G2 SR-FELA lower = 0.978, tolerance bracket intersects
Comparison (vendor): Optum G2 SR-FELA upper = 0.984, tolerance bracket intersects
Comparison (literature): Giam & Donald 1989 reference = 1, tolerance —
Case: cases/k5c-acads-1a.json
Mesh: adaptive FELA: 1288 → 3347 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs acads_1a (ignored, release ~1 min)
Notes: Our rigorous bracket contains Optum's mean and intersects its bracket. 57 s native release incl. LEM. Rows of the same case: LEM below. The kernel's associated SRM on this case (0.9897, T15 relative size 0.6, fe-slope-stability suite) sits +0.18 % above this UB 0.9879: expected for a displacement FE on a finite mesh (it over-estimates collapse), shown as "look", not a disagreement.
k5c-acads-1a-lem — Pass · K5c
Reference: Slide 2 Spencer 0.986 (Bishop 0.987, GLE 0.986)
Benchmark: vendor: Rocscience; product: Slide; version: Slide Verification Manual; doc: ../Slide_SlopeStabilityVerification.pdf; page: 21; caseId: Problem #1
Comparison (vendor): Slide Bishop = 0.987, tolerance 1 %
Comparison (vendor): Slide Spencer = 0.986, tolerance 1 %
Comparison (vendor): Slide GLE = 0.986, tolerance 1 %
Comparison (ts-oracle): slope-stability.ts Bishop = 0.9858, tolerance 0.5 %
Case: cases/k5c-acads-1a.json
Mesh: medium domain mesh (LEM reads the corner triangulation)
Reproduce: tests/k5c_registry.rs (triangulation case) + tests/k5c_slopes.rs acads_1a_lem_vs_slide
Notes: Entry–exit + centre-grid search, Nelder–Mead polish, 50 slices; TS slope-stability on the same section: 0.9858 / 0.985 / 0.9847.
k5c-acads-1c-fela-bounds — Pass · K5c
Reference: Optum G2 1.359 ± 0.006 (bounds 1.352 / 1.365)
Benchmark: vendor: Optum CE; product: OptumG2; version: 2019 verification; doc: Optum-G2-Verification-Slope-Stability.pdf; page: 6; caseId: Slope02 (ACADS 1(c))
Comparison (vendor): Optum G2 SR-FELA lower = 1.352, tolerance bracket intersects
Comparison (vendor): Optum G2 SR-FELA upper = 1.365, tolerance bracket intersects
Case: cases/k5c-acads-1c.json
Mesh: adaptive FELA: 1236 → 3372 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs acads_1c
Notes: Optum's Table 3 prints soil 3 as c 3.0 φ 19.6 γ 20 (repeating 1(a)); the ACADS / Slide soil 3 (7.2 kPa, 20°, 19.5) is used and our bracket intersects Optum's. Flag raised by the triangulation: Bishop (1.403) above the rigorous upper bound — Bishop is unconservative here.
k5c-acads-1c-lem — Pass · K5c
Reference: Slide Spencer 1.375 (Bishop 1.405, GLE 1.374, Janbu corrected 1.357)
Benchmark: vendor: Rocscience; product: Slide; version: Slide Verification Manual; doc: ../Slide_SlopeStabilityVerification.pdf; page: 29; caseId: Problem #3
Comparison (vendor): Slide Bishop = 1.405, tolerance 1 %
Comparison (vendor): Slide Spencer = 1.375, tolerance 1 %
Comparison (vendor): Slide GLE = 1.374, tolerance 1 %
Comparison (ts-oracle): slope-stability.ts Spencer = 1.3674, tolerance 0.5 %
Case: cases/k5c-acads-1c.json
Mesh: medium
Reproduce: tests/k5c_registry.rs lem_acads_1c_1d_vs_slide_and_ts, acads_1c_printed_circle_lem
Notes: On Slide's printed critical circle (34.121, 43.254, R 18.781): Bishop 1.4038, Spencer 1.3736, M-P 1.3729 (≤ 0.1 %). Slices split at every material contact the surface crosses.
k5c-acads-1d-fela-bounds — Deviation · K5c
Reference: Optum G2 1.039 ± 0.004 (bounds 1.034 / 1.043)
Benchmark: vendor: Optum CE; product: OptumG2; version: 2019 verification; doc: Optum-G2-Verification-Slope-Stability.pdf; page: 7; caseId: Slope03 (ACADS 1(d))
Comparison (vendor): Optum G2 SR-FELA lower = 1.034, tolerance bracket intersects — FAILS
Comparison (vendor): Optum G2 SR-FELA upper = 1.043, tolerance —
Comparison (vendor): Slide Spencer (LEM) = 0.991, tolerance —
Comparison (literature): Giam & Donald (1989) ACADS referee 1.00; mean of 15 submissions 0.973 (Slide Verification Manual, Problem #4, p. 33) = 1, tolerance —
Case: cases/k5c-acads-1d.json
Mesh: adaptive FELA: 1236 → 3383 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs acads_1d
Notes: 12 Nov 2026 experiment: Optum's 1.039 is reproduced with k_h ≈ 0.12, not the stated 0.15 (our limit-analysis bracket at 0.12 is [1.0278, 1.0381], which meets Optum's [1.034, 1.043]). Their printed Soil 3 values would lower the factor to 0.883, so the table misprint is not the cause. Stays a deviation. || Re-measured 12 Nov 2026 (Modal 2026-11-12T00-16-53): bracket [0.9669, 0.9767] (width 0.51 %), upper bound per adaptive pass 1.0002 → 0.9864 → 0.9793 → 0.9767 — non-increasing under the nested (Rivara bisection) refinement, as a valid kinematic bound must be (now asserted, within the 5e-3 strength-reduction bracket of the intermediate passes). The lower bound comes from the independent static formulation and sits 1.0 % below it; LEM on the same model: Bishop 1.0128, Spencer 0.9891, Morgenstern–Price 0.9866 (Slide #4: 1.016 / 0.991 / 0.989). The bracket contains the ACADS survey mean 0.973 (15 submissions; referee 1.00, Slide p. 33). Not a kernel defect as far as can be shown without Optum's project file: the same UB/LB code brackets Optum on ACADS 1(a), 1(c) (same run: [1.3489, 1.3628] vs Optum [1.352, 1.365]) and 3(a), and 1(d) differs from 1(c) only by k_h, whose load (k_h·γ towards the face on every element, limit/analysis.rs) is the one the LEM applies and the LEM matches Slide's to ≤ 0.3 %. Optum's own 1(d) value 1.039 lies above every limit-equilibrium result it quotes (Optum p. 7: 'generally slightly higher'); its Table 5 also lists Soil #3 as c 3.0 / φ 19.6 / γ 20 (Problem 1's soil) where Slide and ACADS give 7.2 / 20 / 19.5 — a sign that the 1(d) definition in that document is not reliable. Still a deviation against Optum (rigorous brackets must intersect; they do not). Open: Slope03.g2x (ISSUES K5c-3).
k5c-acads-1d-lem — Pass · K5c
Reference: Slide Spencer 0.991 (Bishop 1.016, GLE 0.989, Janbu corrected 0.965)
Benchmark: vendor: Rocscience; product: Slide; version: Slide Verification Manual; doc: ../Slide_SlopeStabilityVerification.pdf; page: 33; caseId: Problem #4
Comparison (vendor): Slide Bishop = 1.016, tolerance 1 %
Comparison (vendor): Slide Spencer = 0.991, tolerance 1 %
Comparison (vendor): Slide GLE = 0.989, tolerance 1 %
Comparison (ts-oracle): slope-stability.ts Spencer = 0.9893, tolerance 0.5 %
Case: cases/k5c-acads-1d.json
Mesh: medium
Reproduce: tests/k5c_registry.rs lem_acads_1c_1d_vs_slide_and_ts
Notes: k_h·W at the slice weight centroid (Kramer 1996 §10.6.1.1).
k5c-acads-3a-fela-bounds — Pass · K5c
Reference: Optum G2 1.265 ± 0.008 (bounds 1.257 / 1.272)
Benchmark: vendor: Optum CE; product: OptumG2; version: 2019 verification; doc: Optum-G2-Verification-Slope-Stability.pdf; page: 8; caseId: Slope04
Comparison (vendor): Optum G2 SR-FELA lower = 1.257, tolerance bracket intersects
Comparison (vendor): Optum G2 SR-FELA upper = 1.272, tolerance bracket intersects
Comparison (literature): Giam & Donald 1989 range = 1.24–1.27, tolerance —
Case: cases/k5c-acads-3a-weak-seam.json
Mesh: adaptive FELA: 2756 → 7559 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs acads_3a_weak_seam
Notes: Brackets intersect; ours is tighter (±0.15 %). Optum's Table 7 repeats 1(c)'s soils; the Slide #7 soils are used.
k5c-acads-3a-lem-noncircular — Pass · K5c
Reference: Slide Spencer 1.246 (block search); Giam & Donald 1.24–1.27
Benchmark: vendor: Rocscience; product: Slide; version: Slide Verification Manual; doc: ../Slide_SlopeStabilityVerification.pdf; page: 45; caseId: Problem #7
Comparison (vendor): Slide Spencer = 1.246, tolerance 2 %
Comparison (ts-oracle): slope-stability.ts Spencer search = 1.2653, tolerance —
Case: cases/k5c-acads-3a-weak-seam.json
Mesh: medium
Reproduce: tests/k5c_registry.rs lem_weak_seam_noncircular
Notes: TS path search ported; the TS reaches 1.2653, on its surface our LEM gives 1.2653 and on a prescribed block surface both give 1.3385 exactly.
k5c-arai-tagyo-16 — Pass · K5c
Reference: Slide Bishop 1.118, Spencer 1.118 (Arai & Tagyo 1985: Bishop 1.138)
Benchmark: vendor: Rocscience; product: Slide; version: Slide Verification Manual; doc: ../Slide_SlopeStabilityVerification.pdf; page: 78; caseId: Problem #16
Comparison (vendor): Slide Bishop = 1.118, tolerance 1 %
Comparison (vendor): Slide Spencer = 1.118, tolerance 1 %
Comparison (literature): Arai & Tagyo 1985 Bishop = 1.138, tolerance —
Comparison (ts-oracle): slope-stability.ts Bishop = 1.1127, tolerance 0.5 %
Case: cases/k5c-arai-tagyo-16.json
Mesh: adaptive FELA: 1828 → 4735 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs arai_tagyo_16, lem_water_firm_base_and_plaxis_bishop
Notes: u = γw × vertical distance to the water table (§16.2). The rigorous bracket contains Slide's LEM value.
k5c-griffiths-lane-ex1 — Pass · K5c
Reference: Bishop & Morgenstern (1960) charts 1.380; Griffiths & Lane FE-SRM ≈ 1.4
Benchmark: vendor: literature; product: Griffiths & Lane 1999; version: Géotechnique 49(3); doc: Griffiths and Lane 1999.pdf; page: Fig. 2; caseId: Example 1
Comparison (literature): Bishop & Morgenstern 1960 = 1.38, tolerance inside bracket ±0.5 %
Comparison (literature): Griffiths & Lane FE SRM = 1.4, tolerance 0.1 resolution
Comparison (ts-oracle): slope-stability.ts Bishop = 1.3787, tolerance 0.5 %
Case: cases/k5c-griffiths-lane-ex1.json
Mesh: adaptive FELA: 1184 → 3053 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs griffiths_lane_ex1
Notes: G&L's SRM value is read to 0.1 (FOS trials in 0.1 steps). Firm base at the toe: the LEM needs the Slide-style tangent-circle family (toe circle tangent to the base). This row runs the ASSOCIATED material (ψ = φ = 20°); the paper's ψ = 0 run is the separate row k5a-gl99-example1 (−2.81 %).
k5c-plaxis-phic-vs-bishop — Pass · K5c
Reference: Bishop (Verruijt 2010) 1.534; PLAXIS 2D phi-c 1.540
Benchmark: vendor: Bentley; product: PLAXIS 2D; version: 2018 Validation & Verification; doc: PLAXIS-Verification-Phi-c-reduction-vs-Bishop-updated.pdf; page: 2; caseId: Analysis 1
Comparison (vendor): PLAXIS 2D phi-c (SRM) = 1.54, tolerance inside bracket
Comparison (literature): Bishop (Verruijt) = 1.534, tolerance 1 %
Comparison (ts-oracle): slope-stability.ts Bishop = 1.5419, tolerance 0.5 %
Case: cases/k5c-plaxis-phic-bishop.json
Mesh: adaptive FELA: 1364 → 3357 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs plaxis_phic_bishop
Notes: The K5 acceptance 'phi-c vs Bishop': PLAXIS's SRM 1.540 lies INSIDE our rigorous bracket; our Bishop is +0.5 % on Verruijt (geometry read from Fig. 1); TS Bishop on the same section 1.5419 (identical).
k5c-plaxis-phic-vs-bishop-loaded — Pass · K5c
Reference: PLAXIS 2D phi-c 1.261
Benchmark: vendor: Bentley; product: PLAXIS 2D; version: 2018 Validation & Verification; doc: PLAXIS-Verification-Phi-c-reduction-vs-Bishop-updated.pdf; page: 2; caseId: Analysis 2
Comparison (vendor): PLAXIS 2D phi-c (SRM) = 1.261, tolerance inside bracket
Comparison (ts-oracle): slope-stability.ts Bishop (strip load) = 1.2735, tolerance 0.5 %
Case: cases/k5c-plaxis-phic-bishop.json
Mesh: adaptive FELA: 1364 → 3415 T3 (refine 1 + 3 Dörfler passes on the UB dissipation; UB quadratic Bernstein, discontinuities everywhere incl. kinematic boundaries)
Reproduce: tests/k5c_registry.rs plaxis_phic_bishop
Notes: PLAXIS's SRM inside our bracket. The line load is on a structure line welded into the crest (tag structure:loadline); in the strength-reduction test the load is scaled with every action.
k5c-vertical-cut — Pass · K5c
Reference: best known bounds: LB 3.772 (Lyamin), UB 3.78445 (Lyamin & Sloan 2002), 3.785864 (Pastor et al. 2000)
Benchmark: vendor: literature; product: Lyamin & Sloan 2002; version: IJNAMG 26; doc: Lyamin-Sloan-2002 (on disk); page: Table IV; caseId: vertical cut
Comparison (closed-form): best known lower bound = 3.772, tolerance LB ≤
Comparison (closed-form): best known upper bound = 3.78445, tolerance UB ≥
Case: cases/k5c-vertical-cut.json
Mesh: adaptive 1960 → 5133 T3
Reproduce: tests/k5c_registry.rs vertical_cut
Notes: Our bracket contains the best known bracket. 28 s native release.
k5b-plaxis-2d-tut2-drained — Recorded, no published value · K5b
Case: cases/plaxis-2d-tutorial-02-embankment-k5b-drained.json
Mesh: 482 T15 (kernel 'fine')
Reproduce: tests/k5b_tutorials.rs tutorial2_embankment_hardening_soil_drained_and_undrained (ignored; FAILS on the undrained run)
Notes: Recorded, no published value: the tutorial prints figures only (Fig. 2-7); its one statement in words, that the embankment settles everywhere (p. 46), is asserted at the embankment toe. || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): uy crest −235.8 → −226.7 mm (−3.9 %), centre base −182.0 → −177.9 mm, beyond the toe +2.5 → +0.6 mm. Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (the T2 clay needs Ei^ref 15 625 instead of Eq. 6-4's 10 182, the embankment Ei^ref 34 505 instead of 27 273). Converges: 21 steps / 2 cuts / 249 iterations, 33 s (was 24 steps). Figures only: no PLAXIS number, no verdict. || Converges (24 steps). PLAXIS: 'in case of the drained subsoil the embankment settles everywhere' (p. 46) — ours does; the ground 2 m beyond the toe rises 2.5 mm (the test's own drained check at (38,0) would fail; the tutorial statement is about the embankment).
k5b-plaxis-2d-tut2-undrained — Pass · K5b
Case: cases/plaxis-2d-tutorial-02-embankment-k5b-undrained.json
Mesh: 482 T15 (kernel 'fine')
Reproduce: tests/k5b_tutorials.rs tutorial2_embankment_hardening_soil_drained_and_undrained (ignored; ~17 min on Modal; asserts completion, the plaxis-fallback criterion, drained toe settles / undrained toe heaves, p_excess peak under the embankment)
Notes: D684 re-record (9 Nov 2026, Lead D, Modal tests-2026-11-09T13-35-55-13d622 (prog-d-lab = prog-d-hb 4b64637f-equivalent kernel + prog-d-server; canonical tier); the D124 fallback now iterates with the initial stiffness, PLAXIS criterion per RM 2D Eq. 7-21; parsed by scratchpad leadd/rerecord_t2.py): the construction completes (ΣMstage 1.0000); uy crest -508.3, centre base -250.0, toe (36,0) 123.6 (heaves), (38,0) 114.1 mm; max p_excess 48.13 kPa at x = 22.0. || Lead A re-record (9 Nov 2026, prog-a-tut 9d6f7234, Modal run 2026-11-09T04-21-49, DEFAULT control — no env override): the construction COMPLETES (ΣMstage 1.0) as in PLAXIS (pp. 44–47): the strict criterion stops at the D107 stall, the phase is then solved at the PLAXIS acceptance criterion (ToleratedError 0.01, RM 2025.1 §7.9.3.9; recorded as the 'plaxis-fallback' criterion and a warning), 144 steps / 1 cut. uy crest (23,4) −509.4 mm, centre base (25,0) −248.0 mm, embankment toe (36,0) +123.6 mm (heaves, p. 46 'heaves near the toes'), (38,0) +114.1 mm; max p_excess 48.10 kPa at x = 22.0 (under the embankment, Fig. 2-8). Drained branch: crest −227.2, base −178.4, toe (36,0) −7.8 mm (settles), (38,0) +0.7 mm. The PLAXIS-comparable statement is completion: pass. || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): ΣMstage 0.4778 → 0.4475 (peak 0.44773; 222 steps / 79 cuts / 6 593 iterations, 560 s). This is the STRICT (tol 1e-8, verification-mode) stop and it moved FURTHER from PLAXIS (which completes): NOT a collapse and not a defect of D499/D501 — doc 375 §10 (D516): the D107 path-sensitive stall (Newton stagnates at best ratio 4e-8 vs 1e-8 with a tension-cut-off zone under the embankment centre; states admissible, tangent = FD in 9 792 checks); D499 alone moves the stop 0.904 → 0.4475 through the EMBANKMENT's internals (Ei^ref 27 273 → 34 505, +27 %), D501 alone 0.904 → 0.612. The same model completes at tol 1e-4 and in PLAXIS-parity mode — see row k5d-plaxis-2d-tut2-undrained-construction (D526: X2's 'collapse' label for this stall is wrong). The test (still asserting completion) fails here, as before. || OPEN (K5b-T2-UNDRAINED): load advancement fails at ΣMstage 0.478 after 299 steps / 98 cuts / 17 514 iterations (1146 s). PLAXIS completes the construction (and reports a safety factor). Not diagnosed: collapse of the undrained-A HS clay (c' 10, φ' 25, m 1, γ' ≈ 3 kN/m³ below a surface phreatic level → very low σ' near the surface) vs a global-Newton failure; needs the per-step criteria and the plastic-point map. K5d-2 (D107 diagnosed): with the K5a arc-length the construction reaches a peak ΣMstage 0.9048 (5 falling converged steps); at tol 1e-3 it completes — see row k5d-plaxis-2d-tut2-undrained-construction.
k5a-phic-bishop-analysis1 — Pass · K5a
Reference: Bishop's slip circle (Verruijt 2010, STB2010), V&V p. 3
Case: cases/plaxis-verification-phi-c-reduction-bishop.json
Mesh: 1411 T15 (relative size 0.5; refinement 0.5 load / 0.8 slope)
Reproduce: cargo test -p tbk-core --release --test k5_safety plaxis_phi_c_reduction_vs_bishop -- --ignored --nocapture
Notes: ALG-1 (kernel/alg1, 23 Oct): re-run unchanged (the D114 rule did not fire: mechanism developed). Associated MC (ψ = φ = 20°), tension cut-off off, gravity loading then safety (Msf 0.1, PLAXIS defaults); kernel tolerance 1e-8 (PLAXIS 1e-3). Failure bracket 1.538672 … 1.538867 (relative 1.3e-4); flexibility ×4.5e5.
k5a-phic-bishop-analysis2 — Pass · K5a
Case: cases/plaxis-verification-phi-c-reduction-bishop.json
Mesh: 1411 T15 (relative size 0.5; refinement 0.5 load / 0.8 slope)
Reproduce: (same test)
Notes: ALG-1 (kernel/alg1, 23 Oct): re-run unchanged (the D114 rule did not fire: mechanism developed). Line load 12.5–15.5 m on the crest; safety from the loaded state.
k5a-gl99-example1 — Deviation · K5a
Reference: Bishop & Morgenstern (1960) charts (G&L Fig. 2); G&L FE: converged at FOS 1.35 (792 iterations), no convergence at 1.4
Case: cases/griffiths-lane-1999-example-1.json
Mesh: 867 T15 (relative size 0.6)
Reproduce: cargo test -p tbk-core --release --test k5_safety griffiths_lane_example_1 -- --ignored --nocapture
Notes: 12 Nov 2026: the reference is now Griffiths & Lane's own ψ = 0 trials (Table 2, p. 392: 1.35 converged, 1.40 did not). The Bishop–Morgenstern chart value 1.38 belongs to the associated case, which the limit-analysis row k5c-griffiths-lane-ex1 brackets and passes. On the same mesh ψ = 0 is 3.1 % below ψ = φ. Strength reduction with ψ = 0 is non-unique for this slope class (Tschuchnigg et al. 2015: 1.30 to 1.37), so no tighter gate is justified and the row stays a deviation. || ALG-1 (kernel/alg1, 23 Oct): D114 rescue — the strict run closed a failure bracket at 1.3355 without a mechanism (×55.5); it now continues at the parity criterion (2/2 retries accepted) and stops on the ΣMsf plateau at 1.3412 with a mechanism (×111.8; 95 steps, 6 cuts, 236 s). PLAXIS-parity mode: 1.3403, ×1469 (23 steps, 80 s). Both stay below the doc-71 bracket (1.3445, ≈ 1.38] and G&L's 1.35: the ψ = 0 SRM on this mesh plateaus near 1.34 (Tschuchnigg et al. 2015). Associated variant (ψ = φ, same 867 T15 mesh): 1.3836 (no rescue — unchanged; fine mesh 1.3764 per doc 71). Before: Non-associated (ψ = 0); −1.1 % below G&L's last converged FOS 1.35 (their 0.05 resolution, viscoplastic, loose tolerance); −3.2 % vs the chart. Gravity at full strength then incremental reduction (G&L reduce from scratch per trial). Bracket 1.335547 … 1.335742, flexibility ×55.5; 78 steps, 845 iterations. TS oracle packages/geotech fe-slope-srm.ts (G&L viscoplastic, Q8, rows 8, crest H): 1.3516 — ours −1.2 %.
k5a-gl99-example3 — Pass · K5a
Reference: Taylor (1937) chart (G&L p. 394)
Case: cases/griffiths-lane-1999-example-3-undrained.json
Mesh: 698 T15 (relative size 0.6)
Reproduce: cargo test -p tbk-core --release --test k5_safety griffiths_lane_example_3_undrained -- --ignored --nocapture
Notes: ALG-1 (kernel/alg1, 23 Oct): re-run unchanged (the D114 rule did not fire: mechanism developed). Tresca (associated); domain widths not stated by G&L (crest 2H, slope 2H, 4H beyond the toe used). Pass within 1.5 % of Taylor's chart (G&L: 'close to' it).
k5a-tut2-safety-drained — Pass · K5a
Case: cases/plaxis-2d-tutorial-02-embankment-drained.json
Mesh: 425 T15 (relative size 0.7)
Reproduce: cargo test -p tbk-core --release --test k5_safety plaxis_tutorial_2_embankment_safety -- --ignored --nocapture
Notes: ALG-1 (kernel/alg1, 23 Oct): re-run unchanged (the D114 rule did not fire: mechanism developed). PLAXIS value from the text/curve (1.8, figure precision). Substitution HS → MC (E50,ref, ν 0.3, K0 1 − sin φ) — PLAXIS itself reduces HS as MC with frozen stiffness. Failure by the ΣMsf plateau criterion.
k5a-tut2-safety-undrained — Superseded · K5a
Case: cases/plaxis-2d-tutorial-02-embankment-undrained.json
Mesh: 425 T15 (relative size 0.7)
Reproduce: (same test)
Superseded by: k5d-plaxis-2d-tut2-safety
Notes: Superseded: this was the Mohr-Coulomb stand-in for the undrained safety factor (1.149 against 1.4). The same safety phase with the real Hardening Soil, as one project, is k5d-plaxis-2d-tut2-safety: 1.3814 against 1.4 (pass). || ALG-1 (kernel/alg1, 23 Oct): 1.144531 → 1.149109 (plateau, flexibility ×425.2): the D114 rule continued a failure bracket that had closed without a developed mechanism. Undrained A keeps generating excess pore pressures in the safety phase. −18 %: the HS → MC substitution changes the undrained effective stress path (HS contracts in shear, MC with ψ = 0 keeps p′ constant until yield — the strength of undrained A depends on the model) and K0/OCR 1.2 is lost; to be re-run with K5b's Hardening Soil.
k5d-plaxis-2d-tut2-safety — Pass · K5d-2 (D114)
Case: cases/plaxis-2d-tutorial-02-embankment-k5d.json
Mesh: 482 T15 (kernel 'fine')
Reproduce: tests/k5d_tutorials.rs tutorial2_one_project_material_change_and_safety (ignored; ~43 min release; TBK_T2_TOL=0.001 ~14 min)
Notes: D684 re-record (9 Nov 2026, Lead D, Modal tests-2026-11-09T13-35-55-13d622 (prog-d-lab = prog-d-hb 4b64637f-equivalent kernel + prog-d-server; canonical tier); the D124 fallback now iterates with the initial stiffness, PLAXIS criterion per RM 2D Eq. 7-21; parsed by scratchpad leadd/rerecord_t2.py): drained ΣMsf 1.8563 (unchanged: phase 1 converges strictly), undrained 1.3814 (was 1.3914 from the Newton fallback). || Lead A re-record (9 Nov 2026, prog-a-tut 9d6f7234, Modal 2026-11-09T04-21-49): ONE default run (no env override, no tolerance setting) gives drained ΣMsf 1.8563 (PLAXIS 1.8, +3.1 %) and undrained 1.3914 (PLAXIS 1.4, −0.6 %): phase 2 now completes by the D124 default policy, so the undrained Safety starts from the completed embankment. Drained moved 1.8523 → 1.8563 (+0.2 %) since the 2 Nov record; phase 1 converges strict (17 steps / 5 cuts), so the fallback is not involved — not decomposed (commits between 2 and 9 Nov). || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): drained 1.8516 → 1.8523 (+2.87 → +2.91 %, 0.0007 FURTHER from PLAXIS 1.8); undrained from the completed parity construction 1.3739 → 1.3922 (−1.9 % → −0.56 %, CLOSER to 1.4); undrained from the strict (stalled, ΣMstage 0.4475) phase 2: 1.3797 → 1.4043 (+0.31 %, not comparable: it starts from a half-built embankment; this is the number the test, as written, gates within 5 %). The old 'phase 2 completed at tol 1e-3' value (1.375) was not re-run; the completed runs are now the parity mode (TBK_CONTROL='{"convergence":"plaxis"}' TBK_CONTROL_PHASES=phase2) and tol 1e-4 (TBK_T2_TOL=1e-4). Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (embankment Ei^ref +27 %, clay Ei^ref +53 %); Safety itself uses MC at frozen stiffness, hence the small shifts. Test passes (drained +2.9 %, undrained +0.3 % strict path, both within 5 %). || PLAXIS RM 2025.1 §7.4.5: HS behaves as Mohr–Coulomb in a Safety phase with the stiffness of the start state (kernel FrozenMc). Msf 0.1 first stopped at a false bracket 1.5016 (Δu per ΔΣMsf only ×10.2) — the K5d retry (Msf halved when the bracket shows no developed mechanism, < ×100) gives 1.8516 (×68 228). Sensitivity: no tension cut-off 1.859; MC substitute of K5a 1.847 / 1.1445 (row k5a-tut2-safety-*). D114 closed for HS.
k5d-plaxis-2d-tut2-undrained-construction — Pass · K5d-2 (D107 diagnosed); ALG-1 parity mode completes
Case: cases/plaxis-2d-tutorial-02-embankment-k5d.json
Mesh: 482 T15 (kernel 'fine')
Reproduce: tests/k5d_tutorials.rs tutorial2_one_project_material_change_and_safety (TBK_T2_TOL=0.001 for the completed run)
Notes: D684 re-record (9 Nov 2026, Lead D, Modal tests-2026-11-09T13-35-55-13d622 (prog-d-lab = prog-d-hb 4b64637f-equivalent kernel + prog-d-server; canonical tier); the D124 fallback now iterates with the initial stiffness, PLAXIS criterion per RM 2D Eq. 7-21; parsed by scratchpad leadd/rerecord_t2.py): crest -508.3 / base -250.0 / (38,0) 114.1 mm (Newton fallback: −509.4 / −248.0 / +114.1). || Lead A re-record (9 Nov 2026, prog-a-tut 9d6f7234, Modal 2026-11-09T04-21-49, default control): phase 2 strict stops at ΣMstage 0.58776 ('collapse: ΣMstage fell for 5 arc-length steps after its peak' — the D107 path-dependent stall at this commit; the 2 Nov record was 0.4475), the fallback solves the whole phase at the PLAXIS criterion: ΣMstage 1.0, 144 steps / 1 cut; crest −509.4, base −248.0, (38,0) +114.1 mm, max p_excess 48.1 kPa. vs the 2 Nov parity-mode sub-row (−493.1 / −241.8 / +111.5): +3.3 % / +2.6 % / +2.3 % at the crest/base/(38,0), within 0.4 % of the 2 Nov tol-1e-4 sub-row (−507.3 / −244.8 / +114.1). || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): STRICT (tol 1e-8) row 0.9041 → 0.4475 (peak 0.9048 → 0.4477; uy crest −441.3 → −99.7 mm, 956/301 → 222/79 steps/cuts): a D107 solver STALL, NOT a collapse and not a defect of D499/D501 (doc 375 §10 D516, ledger D526). Mechanism: Newton at 1e-8 stagnates at best ratio 4e-8 where a zone under the embankment centre sits on the clay's tension cut-off (138 points, σ'xx ≈ 0 …); the arc-length then reports a falling ΣMstage. WHERE it stalls is path-dependent: D501 alone 0.904 → 0.612, D499 alone 0.904 → 0.4475 (through the embankment's Ei^ref 27 273 → 34 505, +27 %; D499 on the clay alone: 0.938, no collapse). States admissible (max scaled yield 1e-11), tangent = central FD at 9 792 checks (worst 9e-7). Sub-rows: PLAXIS-PARITY mode (the PLAXIS-comparable row, ALG-1) completes: ΣMstage 1.0, uy crest/base/(38,0) −545.1/−273.65/+125.4 → −493.1/−241.8/+111.5 mm (−9.5 %, −11.6 %, −11.1 %: E50 honoured; the drained branch moved −3.9 % the same way), 152/7 → 164/3 steps/cuts, 320 s phase 2; tol 1e-4 (replaces the old 1e-3 sub-row, 1.0 / −545.7 / −273.5 / +125.2 mm, 185/17, not re-run) completes: 1.0, −507.3/−244.8/+114.1 mm, 482/67, 2 001 s phase 2. Parity and tol 1e-4 are 2.9 % apart at the crest. Test: tutorial2_one_project_material_change_and_safety (strict, default; TBK_CONTROL='{"convergence":"plaxis"}' TBK_CONTROL_PHASES=phase2 for parity; TBK_T2_TOL=1e-4). All three runs pass the test as written. Strict-mode number is a verification-mode artefact, not a PLAXIS comparison (PLAXIS runs at ToleratedError 0.01). || ALG-1 (kernel/alg1, 23 Oct): phase 2 in the PLAXIS-parity mode (CSP-scaled global error + local error rule, ToleratedError 0.01; phase 1 strict) COMPLETES: 152 steps, 7 cuts (strict 1e-8: 301), 365 s; uy (25,0) −273.65 mm vs the doc-71 tol-1e-4 path −272 mm (+0.6 %); the parity reference is 0.26 × the strict one (≈ strict 2.6e-3). Test: tests/alg1.rs probe_case (TBK_CASE=plaxis-2d-tutorial-02-embankment-k5d.json TBK_CONTROL_PHASES=phase2 TBK_DROP_PHASES=phase3,phase4). D107 diagnosis: NOT a collapse. At tol 1e-8 the arc-length follows the load path to a peak ΣMstage 0.9048 and then five converged steps with falling ΣMstage (reported as 'soil body collapses'); at tol 1e-3 (PLAXIS default tolerated error 1e-2) load control completes the phase (185 steps) and the undrained Safety from that state is 1.375 (PLAXIS 1.4) — the soil has a margin, so the falling branch at 1e-8 is a non-unique (non-associated HS) path / limit-point artefact of the tight-tolerance iteration, not the limit load. Was ΣMstage 0.478 (K5b solver).
k5d-benchmark-embankment-soft-clay — Deviation · K5d-2 (open: K5d2-EMB)
Reference: Wiltafsky et al. 2003 pp. 3, 5
Case: cases/plaxis-verification-benchmark-embankment-soft-clay.json
Mesh: 712 T15 (kernel 'medium')
Reproduce: tests/k5d_tutorials.rs benchmark_embankment_on_soft_clay (ignored; TBK_EMB_TOL for the loose-tolerance run)
Notes: Lead A (9 Nov 2026, prog-a-tut 9d6f7234, Modal 2026-11-09T04-21-49, default policy): layer 1 now COMPLETES (strict stall at peak 0.8515, then the PLAXIS criterion: 272 steps / 251 cuts, 321 s; settlement (0,0) 0.0196 m, max p_excess 22.8 kPa); layer 2 FAILS AT BOTH criteria (strict 0.3906, PLAXIS 0.6062: 'not a tolerance stall'), so D124 is half-fixed — layer 2 is a Soft Soil undrained Newton/branch problem, not the tolerance; consolidation is NOT RUN (D663: parent did not converge; before it took 0 steps after ~400 s). Settlement after construction is therefore not available (paper ≈ 0.18 m). || ALG-1 (kernel/alg1, 23 Oct): the parity criterion is ≈ strict 2.5e-3 here (reference 0.25 × the strict one, CSP 0.69) plus the local rule; the Soft Soil undrained Newton (line-search backtracks, cycling increments) is the bottleneck, not the tolerance alone. OPEN (the D107 family): the undrained (A) Soft Soil construction of the 1 m layers does not complete — at tol 1e-8 layer 1 stops near ΣMstage 0.65 (arc-length cannot continue), at tol 1e-3 layer 1 completes and layer 2 reaches ΣMstage ≈ 0.92 in maxSteps; no 100-year consolidation result yet. Case and registry row built (the plaxis-verif-k5-set item is no longer blocked by a missing case).
k5d1-plaxis-2d-tut4-safety-phase7 — Deviation · K5d-1
Case: cases/plaxis-2d-tutorial-04-rock-slope-k5d.json
Mesh: 938 T15
Reproduce: tests/k5d1_tutorials.rs tutorial4_rock_slope_cables_safety (ignored: ~32 min release)
Notes: Re-run 13 Nov 2026 (Modal tests-2026-11-13T19-41-26-79b4c6 (HEAD db3a7f70, 4 vCPU, default policy), after KB-3 curved interfaces and 3DX-7 Anderson acceleration): phase 3 still stops at ΣMstage 0.6234 — the kernel classifies it as active-set cycling at the tolerance, not a limit load (up to 183 stress points switching region), the same failure class as KB-4 (Mohr–Coulomb plane/edge cycling; fix: corner rounding or a semismooth active set). Phases 4–8 not run; 365 s. || Lead A (9 Nov 2026, Modal 2026-11-09T04-21-49): phase 3 strict ΣMstage 0.6234 (31 steps / 38 cuts); the D124 PLAXIS-criterion fallback fails too (genuine collapse); phase 7 not run (D663). Test asserts exactly that now. || OPEN K5d1-T4-COLLAPSE: phase 3 itself collapses at ΣMstage 0.623 (arc-length minimum; 30 steps, 38 cuts), so the Safety phase finds no equilibrium above ΣMsf = 1. Hand LEM of the daylighted block (81.7 m², W 1961 kN/m, fault 39.5°, c 8 kPa, φ 20°): F ≈ 0.58 without cables, ≤ ≈ 0.8 with both cables at yield (548 kN / 3 m) — the stated data imply instability; PLAXIS's 1.33 relies on a resistance this model lacks (suspects: the discontinuity tip connection, cable force per spacing). Before the tied-tip default (daylight duplicated) phase 3 stopped at 0.575.
k5d1-plaxis-2d-tut4-safety-phase8 — Deviation · K5d-1
Case: cases/plaxis-2d-tutorial-04-rock-slope-k5d.json
Mesh: 938 T15
Reproduce: tests/k5d1_tutorials.rs tutorial4_rock_slope_cables_safety (ignored: ~32 min release)
Notes: Re-run 13 Nov 2026 (Modal tests-2026-11-13T19-41-26-79b4c6 (HEAD db3a7f70, 4 vCPU, default policy), after KB-3 curved interfaces and 3DX-7 Anderson acceleration): phase 3 still stops at ΣMstage 0.6234 — the kernel classifies it as active-set cycling at the tolerance, not a limit load (up to 183 stress points switching region), the same failure class as KB-4 (Mohr–Coulomb plane/edge cycling; fix: corner rounding or a semismooth active set). Phases 4–8 not run; 365 s. || Lead A (9 Nov 2026, Modal 2026-11-09T04-21-49): with D663 the chain stops at the failed phase 3 (ΣMstage 0.6234; the PLAXIS criterion fails too), so phases 4–8 are NOT RUN and the former 1.171 (computed from the collapsed phase-3 geometry) is no longer produced. See triage: PLAXIS's 1.83 is reproduced by alg1-plaxis-2d-tut4-repro-safety-phase8. || Phase 6 converged; but phases 3–5 did not complete (K5d1-T4-COLLAPSE), so the phase-6 state carries the partially collapsed geometry ((23, 6) moved 676 / −562 mm); all three cables at their 548 kN yield, bond at c_bond. Asserted: phase 8 converges with ΣMsf > 1 and above phase 7. Recorded substitutions in the case note (fault segment inside the 2nd excavation omitted, wall / backfill clusters inactive until built, mesh-conforming cables, σt = 0 on the fault).
alg1-plaxis-2d-tut4-repro-safety-phase7 — Deviation · ALG-1 (D128)
Case: cases/plaxis-2d-tutorial-04-rock-slope-k5d-plaxis-repro.json
Mesh: 938 T15
Reproduce: tests/k5d1_tutorials.rs tutorial4_rock_slope_plaxis_reproduction (ignored: ~160 s release)
Notes: 13 Nov 2026 (D422 ruling): this variant reproduces PLAXIS only with a cable-strength reading chosen to match PLAXIS's own figures (strength per metre, reduced in Safety), which contradicts RM 2025.1 §6.7.2.1 and the RM default. A model fitted to the numbers it is scored on is a calibration, not a validation, so the row no longer counts as a pass. The as-specified rows k5d1-plaxis-2d-tut4-* carry the validation and stay open until the phase-3 cycling is fixed (KB-4 work). Re-run Modal tests-2026-11-13T19-41-26-79b4c6 (HEAD db3a7f70, 4 vCPU, default policy): phase 7 ΣMsf 1.2852 (−3.4 %), phase 8 1.6625 (−9.2 %), phase 3 converged; 216 s. || ALG-1 / doc 71: the variant reproduces PLAXIS within the acceptance band (±5 %): phase 3 converges (ΣMstage 1, 5 steps, 0 cuts), phase 7 1.2852 (−3.4 %), phase 8 1.6680 (−8.9 %); whole run 157 s. The variant is the ONLY reading consistent with PLAXIS's own figures (doc 71 hand check) but contradicts RM 2025.1 §6.7.2.1 (strength per cable ÷ spacing) and the RM default (cables not reduced) — unconfirmed against a PLAXIS licence or the tutorial project file. The as-specified case (rows k5d1-plaxis-2d-tut4-*) stays the documented deviation.
alg1-plaxis-2d-tut4-repro-safety-phase8 — Deviation · ALG-1 (D128)
Case: cases/plaxis-2d-tutorial-04-rock-slope-k5d-plaxis-repro.json
Mesh: 938 T15
Reproduce: tests/k5d1_tutorials.rs tutorial4_rock_slope_plaxis_reproduction (ignored: ~160 s release)
Notes: 13 Nov 2026 (D422 ruling): this variant reproduces PLAXIS only with a cable-strength reading chosen to match PLAXIS's own figures (strength per metre, reduced in Safety), which contradicts RM 2025.1 §6.7.2.1 and the RM default. A model fitted to the numbers it is scored on is a calibration, not a validation, so the row no longer counts as a pass. The as-specified rows k5d1-plaxis-2d-tut4-* carry the validation and stay open until the phase-3 cycling is fixed (KB-4 work). Re-run Modal tests-2026-11-13T19-41-26-79b4c6 (HEAD db3a7f70, 4 vCPU, default policy): phase 8 ΣMsf 1.6625 (−9.2 %; was 1.6680 before the KB-3 / 3DX-7 kernel changes), phase 7 1.2852; 216 s. || ALG-1 / doc 71: the variant reproduces PLAXIS within the acceptance band (±10 %): phase 3 converges (ΣMstage 1, 5 steps, 0 cuts), phase 7 1.2852 (−3.4 %), phase 8 1.6680 (−8.9 %); whole run 157 s. The variant is the ONLY reading consistent with PLAXIS's own figures (doc 71 hand check) but contradicts RM 2025.1 §6.7.2.1 (strength per cable ÷ spacing) and the RM default (cables not reduced) — unconfirmed against a PLAXIS licence or the tutorial project file. The as-specified case (rows k5d1-plaxis-2d-tut4-*) stays the documented deviation.
geostudio-swv-acads-1a-janbu-simplified — Pass · K5c
Reference: SLOPE/W Janbu 0.939 (SWV 2025 §2.1 Table 2); ACADS published 1.00
Benchmark: vendor: Seequent; product: GeoStudio SLOPE/W; version: 2025 verification manual; doc: Seequent-GeoStudio-SLOPEW-Slope-Stability-Verification-Manual-current.pdf; page: 2; caseId: §2.1 ACADS Simple Slope
Comparison (vendor): SLOPE/W Janbu (simplified) = 0.939, tolerance 2 % (each side searches its own critical circle)
Case: (test fixture: tests/v_geostudio_swv.rs swv_acads_simple_slope, ACADS 1(a) section)
Mesh: medium domain mesh, order 2 (LEM section built from the FE mesh; default 50-slice search)
Reproduce: cargo test --release -p tbk-core --test v_geostudio_swv swv_acads_simple_slope_all_methods -- --nocapture
Notes: Maps SLOPE/W's 'Janbu' to our janbu-simplified: the 2025 manual prints Janbu 0.939, the Oct-2022 manual prints 0.992 for the same case, and our two variants are 0.9351 (simplified) and 0.9854 (f0-corrected) — so the 2025 column is the simplified method. 2 % tolerance because the vendor searches its own circle; same section, same materials. The FoS is below the ACADS published 1.00 because SLOPE/W's Janbu is the simplified (uncorrected) method, which under-reads FoS by ~6 % on this case.
geostudio-swv2022-acads-1a-janbu-corrected — Pass · K5c
Reference: SLOPE/W Janbu 0.992 (SWV Oct-2022 §2.1 Table 2); ACADS published 1.00
Benchmark: vendor: Seequent; product: GeoStudio SLOPE/W; version: Oct 2022 verification manual; doc: Seequent-GeoStudio-SLOPEW-Slope-Stability-Verification-Manual-Oct2022.pdf; page: 2; caseId: §2.1 ACADS Simple Slope
Comparison (vendor): SLOPE/W Janbu (f0-corrected) = 0.992, tolerance 2 % (each side searches its own critical circle)
Case: (test fixture: tests/v_geostudio_swv.rs swv_acads_simple_slope, ACADS 1(a) section)
Mesh: medium domain mesh, order 2 (LEM section built from the FE mesh; default 50-slice search)
Reproduce: cargo test --release -p tbk-core --test v_geostudio_swv swv2022_acads_simple_slope_all_methods -- --nocapture
Notes: Maps the Oct-2022 manual's 'Janbu' to our janbu-corrected (Janbu 1973 f0). The 2022 print (0.992) sits on our f0-corrected value (0.9854, 0.66 %), where the 2025 print (0.939) sits on our simplified value — the two vendor manuals therefore bracket both Janbu variants, each within 1 %, on one published section.
geostudio-hand-bishop-specified-circle — Pass · K5c
Reference: Hand-calculation Bishop FoS 992.967 / 795.3401 = 1.249 (manual Tables 3–6), identical to SLOPE/W's own result (manual Figure 4)
Benchmark: vendor: Seequent; product: GeoStudio SLOPE/W; version: Verification – Hand Calculations; doc: Seequent-GeoStudio-SLOPEW-Verification-Hand-Calculations.pdf; page: 6–8; caseId: Verification – Hand Calculations
Comparison (literature): Hand-calculation Bishop FoS (manual Tables 3–6) = 1.249, tolerance 1 % (slice reconstruction: geometry and circle recovered from the published table and figure)
Comparison (vendor): SLOPE/W Bishop (manual Figure 4) = 1.249, tolerance 1 %
Case: (test fixture: tests/v_geostudio_swv.rs geostudio_hand_slope, Verification – Hand Calculations case)
Mesh: medium domain mesh, order 2; prescribed circle centre (18.966, 8.963), radius 20.956 m; 29 slices
Reproduce: cargo test --release -p tbk-core --test v_geostudio_swv geostudio_hand_calculations_bishop_specified_circle -- --nocapture
Notes: The slip circle is not printed in the manual; it is recovered from the published Table 1 slice table (circle through the 29 published base midpoints: centre (18.966, 8.963), R 20.956, max residual 0.009 m) and the ground line recovered from Height + base ordinate is exactly the published 2h:1v slope with a 10 m crest bench and a flat −10 m bench (gamma 20 reproduces every published W to 0.03 %). The published pore pressures are reproduced by the phreatic line [(−5.571, 0.0), (23, −10), (30, −10)] to ≤0.05 kPa on all 29 slices. Our Bishop 1.2463 vs the hand 1.249 (0.22 %). Same case also proves the phreatic-line pore-pressure path (options-parity row 27).
Cited validation suites — 18
embankment-stability-web-validation.test.ts
embankment-stability (embankment basal stability, `computeEmbankmentBasalStability` in `embankment-rehab.ts`) — validation against PUBLISHED values.
Analyses validated: embankment-stability · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
embankment-stability (embankment basal stability, `computeEmbankmentBasalStability` in `embankment-rehab.ts`) —
validation against PUBLISHED values. STATUS: PARTIAL — two published numbers; the release rules asks for ≥ 20 from ≥ 2 sources.
SOURCES (opened 2026-10; locator beside each value):
[H] Han, J. (2015), Principles and Practice of Ground Improvement, Wiley, Ch. 7 "Preloading", §7.5 Design
Example 7.1 (pp. 227-228, staged highway embankment on soft soil): γ = 19.7 kN/m³, cu = 24 kPa, φu = 0,
Nc = 5.14, required FS = 1.3 → permissible first-stage fill height H1 ≤ Nc·cu/(FS·γ) = 4.8 m.
[F] FHWA-NHI-06-089 (2006), Soils and Foundations Reference Manual Vol. II, Ch. 8, Eq. 8-4: Nc = 2 + π = 5.14 for
φ = 0°; and Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Ch. 8: qf = (2+π)·cu = 5.14·cu
(lower- and upper-bound theorems agree). The engine's default N_c must equal this constant.
SHORTFALL (reported, not padded). The local library has no second worked embankment-on-soft-clay example whose
arithmetic is Nc·cu/(γH + q) with printed FS / critical height: Terzaghi-Peck-Mesri 3e and Holtz & Kovacs are
scans without a text layer, Lambe & Whitman's embankment-on-soft-foundation section is qualitative, and the
IRC:75 guideline this engine is calibrated to is a paywalled standard (ask the founder).
SOURCE INCONSISTENCY (reported, NOT used as a test): Han Design Example 7.1 stage 2 prints
Δcu = 0.25·0.796·19.7·4.5 = 17.9 kPa (the product is 17.64) and H2 = 5.14·(24 + 17.9)/(1.3·19.7) = 8.8 m
(the quotient is 8.41). The engine's staged branch also builds on the SAFE stage-1 height (4.82 m), not the
4.5 m actually placed, so it cannot reproduce the example's stage-2 numbers either way.
| Test block (the published value it checks) | Verdict |
| [H] Han Design Example 7.1 stage 1: γ = 19.7, cu = 24, Nc = 5.14, FS = 1.3 → H1 = 4.8 m | Pass |
| [H] Han Example 7.1: the 4.5 m first stage actually placed meets the required FS = 1.3 | Pass |
| [F] default Nc is the φ = 0 bearing factor 2 + π = 5.14 (FHWA Eq. 8-4; Craig qf = 5.14·cu) | Pass |
| definition (hand-derived): FoS = Nc·cu/(γH + q); inputs ≤ 0 are refused | Pass |
fe-slope-srm-layered-water-web-validation.test.ts
C.FE.1 + A.5 web-benchmark & cross-validation — multi-layer + water-table effective-stress FE strength-reduction slope stability.
Analyses validated: fe-slope-stability · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
C.FE.1 + A.5 web-benchmark & cross-validation — multi-layer + water-table
effective-stress FE strength-reduction slope stability.
The homogeneous, DRY engine is already validated against Griffiths & Lane
(1999) Example 1 in fe-slope-srm.test.ts. This suite validates the NEW
physics: (a) heterogeneous per-Gauss-point c′/φ′/γ, and (b) pore pressure via
effective stress σ′ = σ + u (tension-positive convention; u = γw·(wt−y),
exactly Griffiths & Lane's submerged-slope pore-pressure model).
Public numeric benchmarks for FE-SRM WITH a phreatic surface are sparse, so
per the project's web-benchmark rule the suite combines: (1) the cited
Griffiths & Lane (1999) homogeneous anchor; (2) exact analytical limiting
cases (dry ≡ water-table-at-base; homogeneous ≡ identical layers); and (3)
cross-checks against our OWN web-validated method-of-slices engine
(slope-stability.ts, Bishop/Morgenstern-Price) driven with the SAME geometry,
layers and phreatic surface — an independent-method check of the new physics.
Sources:
- Griffiths, D.V. & Lane, P.A. (1999) "Slope stability analysis by finite
elements", Géotechnique 49(3), 387-403. Pore pressure taken as γw × depth
below the phreatic surface; Example 4 is the layered-foundation case.
(author copy: inside.mines.edu/~vgriffit/slope64/)
- Taylor, D.W. (1937) stability number Ns = c/(γHF).
- Cross-method reference: TerraBrains slope-stability.ts (Bishop-simplified),
itself web-validated against Bishop & Morgenstern (1960) ru charts.
| Test block (the published value it checks) | Verdict |
| C.FE.1: water table at the base (elev 0) ≡ dry (u=0 everywhere) | Pass |
| C.FE.1: two identical layers ≡ homogeneous (exact regression) | Pass |
| C.FE.1: empty/invalid layers array falls back to the scalar soil | Pass |
| B: Griffiths & Lane (1999) Example 1 — dry homogeneous unchanged (1.367 on the conforming mesh) | Pass |
| C: dry homogeneous FE ↔ Bishop LEM agree within method spread | Pass |
| D: raising the water table lowers FoS (monotonic, correct direction) | Pass |
| D: partially-saturated FE ↔ Bishop LEM agree (same phreatic surface) | Pass |
| D: a mid-height water table drives the slope to marginal stability — FE and LEM agree | Pass |
| D: a fully-saturated profile fails, and FE ↔ LEM still agree | Pass |
| E: a weak surface layer lowers FoS below the strong-homogeneous case | Pass |
| E: a strong crust over weak clay ↔ Bishop LEM agree within spread | Pass |
| A.5: plastic-zone + shear-strain fields are exported and sane | Pass |
| A.5: dry slope reports no pore pressure influence; fields still present | Pass |
fe-slope-stability-web-validation.test.ts
REAL PUBLISHED WORKED EXAMPLE (not formula-fidelity -- an independently- published answer) from Griffiths, D.V.
Analyses validated: fe-slope-stability · Recorded run: passed — 18 test block(s), 1 skipped
Sources, tolerances and what is not asserted (the suite’s prologue)
REAL PUBLISHED WORKED EXAMPLE (not formula-fidelity -- an independently-
published answer) from Griffiths, D.V. & Lane, P.A. (1999) "Slope
stability analysis by finite elements," Geotechnique 49(3), 387-403
(source PDF on disk: "Griffiths and Lane 1999.pdf", verified via
pdftotext), Example 1: a homogeneous 2:1 slope (26.57 deg), phi'=20 deg,
c'/(gamma.H)=0.05. The paper's own strength-reduction FE analysis gives
FOS=1.4 at that exact geometry -- quoting the paper directly: "With a
'failure' factor of safety of FOS = 1.4" -- and cross-checks against
Bishop & Morgenstern (1960) limit-equilibrium charts (also cited in this
engine's own header, Taylor 1937 chart ~1.47).
This engine reproduces the SAME strength-reduction method (Griffiths &
Lane's own algorithm) at a coarser mesh (rows=6, for the test's speed),
so an offset toward the coarse-mesh side of the published fine-mesh value
is expected and stated as such (the codebase's own Morgenstern-Price
limit-equilibrium comparison gives 1.369 for the identical slope).
| Test block (the published value it checks) | Verdict |
| [1] GL99 Example 1 geometry check: c'/(gamma.H) = 10/(20.10) = 0.05 exactly, matching the paper's stated case | Pass |
| [2] the FE strength-reduction FoS is within 15% of the paper's published FOS=1.4 (coarse 6-row mesh vs the paper's finer mesh; the codebase's own Morgenstern-Price limit-equilibrium cross-check gives 1.369 for the identical slope) | Pass |
| [3] the iteration-count signature GL99 describe (ballooning iterations near the critical SRF, the numerical fingerprint of true collapse) is reproduced | Pass |
| [4] a steeper slope (1:1 vs 2:1) gives a LOWER factor of safety, all else equal (monotone in slope angle, the basic physical trend) | Pass |
| [5] a weaker soil (lower cohesion) gives a LOWER factor of safety, all else equal | Pass |
| [6] a higher friction angle gives a HIGHER factor of safety, all else equal | Pass |
| [7] a submerged (water table at crest) slope gives a LOWER factor of safety than the dry case, per the effective-stress SRM (pore pressure reduces the normal effective stress on potential failure surfaces) | Pass |
| [8] invalid inputs (zero height, zero slope ratio) are refused | Pass |
| [9] pathological (absurdly large) geometry returns a clean error rather than crashing the process | Pass |
| [VAL-1] ACADS 1(a): FE strength-reduction FoS lies inside the published cross-code envelope 0.94-1.00 (lowest vendor value 0.939 .. ACADS referee 1.00) | Pass |
| [VAL-1] ACADS 1(a): FE strength-reduction FoS within 3 % of RS2 SSR 0.99 Why: VAL1-FE-1: RS2 SSR 0.99 (critical SRF 0.995) is above the rigorous upper bound 0.984, so a 3 % band around it is not a correctness criterion. Default is 0.9609 after VAL1-FE-2 (was 0.9453, 4.5 % low). See MEDIUM-ACADS-REPORT.md / MEDIUM-D612-REPORT.md | To do — not asserted |
| [VAL-1] ACADS 1(a), rows 4: ψ = 0 FE-SRM FoS ≤ the rigorous associated upper bound 0.984 and ≥ 0.94 (conforming mesh, no staircase collapse) | Pass |
| [VAL-1] ACADS 1(a), rows 6: ψ = 0 FE-SRM FoS ≤ the rigorous associated upper bound 0.984 and ≥ 0.94 (conforming mesh, no staircase collapse) | Pass |
| [VAL-1] ACADS 1(a), rows 8: ψ = 0 FE-SRM FoS ≤ the rigorous associated upper bound 0.984 and ≥ 0.94 (conforming mesh, no staircase collapse) | Pass |
| [VAL-1] the slope face is a straight mesh edge: every boundary node on the face lies on the line from crest (H, H) to toe (W, 0) | Pass |
| [VAL1-FE-2] ACADS 1(a), rows 4: FoS within one bisection cell (1/64) of the uncapped reference 0.9824, and ≤ the Optum bound 0.984 | Pass |
| [VAL1-FE-2] ACADS 1(a), rows 8: FoS within one bisection cell (1/64) of the uncapped reference 0.9629, and ≤ the Optum bound 0.984 | Pass |
| [VAL1-FE-2] ACADS 1(a), rows 12: FoS within one bisection cell (1/64) of the uncapped reference 0.959, and ≤ the Optum bound 0.984 | Pass |
| [VAL1-FE-2] ACADS 1(a): a slow-converging trial runs past the old 1 500 cap, and clear collapses stop early | Pass |
infinite-slope-web-validation.test.ts
PUBLISHED-VALUES: 18 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: about 18 distinct published values (Duncan & Wright is quoted through the Slide manual).
Analyses validated: infinite-slope · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 18 -- distinct published values for this engine (engine-level total, declared once); independent audit A3: about 18 distinct published values (Duncan & Wright is quoted through the Slide manual). Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
infinite-slope — dedicated validation against PUBLISHED worked answers (`infinite-slope.ts`).
SOURCES (every value below was read from the document named, opened from the local reference
library `Geo Technical engineering books/` on 2026-10; the page/example locator sits beside each value):
[C] Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon Press —
§12.3 "Translational slips" Eq. 12.26 and Example 12.3 (pp. 483-484; equations and the
printed answers were read from the rendered page image).
[E] USACE EM 1110-2-1902 (2003), Slope Stability, Appendix E §E-5 and "Example Problem E-5"
(Figure E-13 — infinite slope by the Duncan, Buchignani & De Wet (1987) chart A/B method).
[L] Lambe, T.W. & Whitman, R.V. (1979), Soil Mechanics, SI Version, Wiley — Ch. 24
"Earth slopes with drained conditions", Examples 24.1 and 24.2 (pp. 355-356).
[D] Rocscience Slide Verification Manual, Problems #79 and #81, which reproduce the reference
factors of safety printed in Duncan, J.M. & Wright, S.G. (2005), Soil Strength and Slope
Stability, Wiley, Figs. 14.4 and 14.7 (manual pp. 267-275). The D&W book itself was not opened;
the values are quoted from the verification manual.
[H] Han, J. (2015), Principles and Practice of Ground Improvement, Wiley — §2.6 Eqs. 2.77-2.82 and
the sentence after Eq. 2.82 on the saturated-with-seepage stable angle.
WHAT COUNTS AS A PUBLISHED ANSWER HERE. Every `near(...)` whose expected number carries a locator is a
number printed in the source (stress, factor of safety, chart coefficient, limiting angle). Lines
marked "HAND-CHECK" are intermediate algebra of ours, labelled as such, and are NOT part of the
published-value count.
TOLERANCES follow each source's own rounding: Craig prints stresses to 0.1 kPa (±0.05);
EM 1110-2-1902 prints F to 2 dp and the chart coefficients A, B to 2 dp / 2 sf — but A and B there are
READINGS off a chart (Fig. E-7), so the case-1 chart reading (A = 0.62) carries a reading error that we
state (exact closed form 1 − ru(1 + tan²β) = 0.632) rather than hide; its tolerances are set from that
reading resolution, not fitted.
Unit conversions used only to run the US-unit example in the SI engine: 1 pcf = 0.157087 kN/m³,
1 psf = 0.0478803 kPa, 1 ft = 0.3048 m (dimensionless FoS is unchanged by consistent conversion).
| Test block (the published value it checks) | Verdict |
| [C] Craig Ex. 12.3(a): φ′cv = 28° — τmob = 20.3 kPa, τf = 20.7 kPa, ULS satisfied | Pass |
| [C] Craig Ex. 12.3(b): φ′r = 20° — τf = 14.2 kPa, τmob unchanged, ULS NOT satisfied | Pass |
| [E] Example E-5, seepage parallel (ru = 0.325): published F = 1.63 | Pass |
| [E] Example E-5, horizontal seepage (ru = 0.52): published F = 1.30 | Pass |
| [E] Example E-5: friction term A·tanφ′/tanβ = 0.98 and 0.65; cohesion term B·c′/γH = 0.65 | Pass |
| [E] Example E-5 chart coefficients recovered from the engine: A = 0.62 / 0.41, B = 3.1 | Pass |
| [E] ru → pore pressure is u = ru·γ·z (Eq. E-12), the input the chart method is entered with | Pass |
| [L] Example 24.2: submerged slope, γb·H·cos²i — published coefficient 28.73 kN/m² | Pass |
| [L] Example 24.1: seepage-parallel limiting slope tan i = (γb/γt)·tanφ̄ = 0.182 → FoS = 1 | Pass |
| [L] Example 24.1: printed c̄/γt = 0.245 is the cohesion ratio of the engine run | Pass |
| [D] Slide verification #79 (D&W Fig. 14.4): φ′ = 30°, 2.5H:1V → reference FoS 1.44 | Pass |
| [D] Slide verification #81 (D&W Fig. 14.7): φ′ = 30°, 2H:1V → reference FoS 1.15 | Pass |
| [D] FoS is independent of unit weight and depth for a dry cohesionless slope (FHWA/Slide statement) | Pass |
| [H] Han Eq. 2.82: γ′/γsat = 0.5 ⇒ seepage FoS = ½ · dry FoS; φ′ = 30° limiting angle ≈ 16° | Pass |
| input guards: β outside (0,90), φ ≥ 90, missing γsat and missing ru are refused | Pass |
⚑ probabilistic-slope-web-validation.test.ts
probabilistic-slope — dedicated validation against a PUBLISHED worked reliability example (`probabilistic-slope.ts`).
Analyses validated: probabilistic-slope · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
probabilistic-slope — dedicated validation against a PUBLISHED worked reliability example
(`probabilistic-slope.ts`). STATUS: PARTIAL — see "SHORTFALL" below.
SOURCE (opened 2026-10 from https://ocw.mit.edu mirror; file app17_slope_rel.pdf, read 2026-10):
MIT (2005), 1.151 Probability and Statistics in Engineering, Spring 2005, "Application Example 17 —
Reliability Analysis: Stability of natural slopes" (infinite slope after Skempton & DeLory 1957),
§17.1 FOSM, §17.3 Monte Carlo.
The example: z = 5 m, water table 2.5 m down (m = 0.5), c′ = 25 kN/m², φ′ = 30°, α = 35°, γ = 20 kN/m³,
γw = 9.81; only c′ (COV 0.20) and φ′ (COV 0.25) random, independent, normal. The note prints:
F = 1.15 (stable) · Var[F] = 0.0467 · β_FOSM = 0.714 · Pf = Φ(−0.714) = 0.237 ·
(second-moment β = 0.739, Pf = 0.230 — a Hasofer-Lind result this engine does not compute) ·
Monte Carlo, 20 000 samples: Pf = 0.223.
Engine mapping: pore pressure on the plane u = γw·(z − zw)·cos²α (parallel seepage, the note's Eq. 1-2);
unit weight is treated as deterministic (COV 0) because the note does not randomise it.
ENGINE BUG FOUND BY THIS SUITE (fixed in `probabilistic-slope.ts`, cited there): the FOSM central
differences used the standard deviation as the increment (φ′ step 7.5°). Baecher, G.B. & Christian, J.T.
(2003), Reliability and Statistics in Geotechnical Engineering, Wiley, §13.4.1 (p. 314) says exactly this
"is not a good idea"; the secant across tanφ′ overstated ∂F/∂φ′ by 1.2 %, giving σ_F = 0.2180 (β = 0.708,
Pf = 23.9 %) against the published 0.2161 (β = 0.714, Pf = 23.7 %). With a small (1 %) step the engine
reproduces all four FOSM numbers.
SHORTFALL (reported, not padded): the reliability literature in the local library (Baecher & Christian 2003
Chs. 13-14, the Rocscience Slide probabilistic verification set) is for a vertical cut and for method-of-slices
circles, not for the infinite-slope limit state this engine implements, and no second infinite-slope FOSM
worked example with printed numbers was found. This suite therefore holds ONE source and six published
numbers, well short of the release rule's ≥ 20 from ≥ 2 sources. The performance-band thresholds in the engine
(its docblock cites "EM 1110-2-1902 Table 1") could not be checked: that table is not in the library's copy of
EM 1110-2-1902 (2003) — it belongs to the USACE reliability guidance (ETL 1110-2-547), which was not obtainable.
TOLERANCES: F printed to 3 s.f. (1.15 → ±0.005 as the note rounds to 2 dp); Var to 3 s.f. (±5e-5);
β to 3 dp (±5e-4); Pf to 3 dp (±5e-4). The Monte-Carlo comparison uses a STATISTICAL tolerance — three
standard errors of the DIFFERENCE between the note's 20 000-sample estimate and this engine's 50 000-sample
estimate — not a fitted number.
| Test block (the published value it checks) | Verdict |
| [MIT] Table 1 slope: deterministic F = 1.15 and the slope is stable | Pass |
| [MIT] FOSM: Var[F] = 0.0467 | Pass |
| [MIT] FOSM: β = 0.714 and Pf = Φ(−0.714) = 0.237 | Pass |
| [MIT] Monte Carlo: Pf ≈ 0.223 within three standard errors of the difference | Pass |
| [MIT] FOSM and MC agree with the note's remark that near-linearity makes all three Pf close (0.223-0.237) | Pass |
| HAND-CHECK: σ_F equals the closed-form first-order variance (no finite-difference step bias) | Pass |
| definition: β = (μ_F − 1)/σ_F and Pf = Φ(−β) (Baecher & Christian 2003 Eq. 14.3) | Pass |
| all-zero COVs are refused (deterministic analysis dressed as reliability) | Pass |
rapid-drawdown-web-validation.test.ts
Validation for the rapid (sudden) drawdown engine (`rapid-drawdown.ts`) — the improved Duncan-Wright-Wong three-stage method of USACE EM 1110-2-1902 App.
Analyses validated: rapid-drawdown · Recorded run: passed — 46 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the rapid (sudden) drawdown engine (`rapid-drawdown.ts`) — the
improved Duncan-Wright-Wong three-stage method of USACE EM 1110-2-1902 App. G.
The example in EM App. G uses a specific non-critical 12-slice surface whose
exact geometry lives in figures (not machine-readable), so this file validates
(a) the method's DETERMINISTIC governing equations exactly against the EM
formulas G-5…G-15, and (b) the end-to-end engine behaviour that defines a
correct rapid-drawdown analysis (drawdown reduces FoS; complete drawdown is the
most critical; stage-3 ≤ stage-2; stronger soil raises FoS). ~22 anchors.
Refs: USACE EM 1110-2-1902 (2003) App. G; Duncan, Wright & Wong (1990);
Lowe & Karafiath (1960); Duncan, Wright & Brandon (2014) Ch. 9.
| Test block (the published value it checks) | Verdict |
| A. Kf(φ'=30, c'=0) = tan²(45+φ/2) = 3 (EM G-7) | Pass |
| A. Kf(φ'=35, c'=0) = tan²(45+φ/2) = 3.6902 (EM G-7) | Pass |
| A. Kf(φ'=20, c'=0) = tan²(45+φ/2) = 2.0396 (EM G-7) | Pass |
| A. Kf(φ'=25, c'=0) = tan²(45+φ/2) = 2.4639 (EM G-7) | Pass |
| A. Kf(φ'=40, c'=0) = tan²(45+φ/2) = 4.5989 (EM G-7) | Pass |
| A6. Kf with c'>0 grows with c' at fixed σ'fc (EM G-8) | Pass |
| B1. cR=0 ⇒ d_{Kc=1} = 0 (EM G-5) | Pass |
| B2. ψ_{Kc=1}(cR=0, φR=20, φ′=30) = atan(sinφR·cosφ′/(1−sinφR)) ≈ 24.24° (EM G-6) | Pass |
| B3. φR = 0 ⇒ ψ = 0 and d = 0 (no undrained strength gain from an isotropic frictionless R-envelope) | Pass |
| C1. isotropic consolidation (τc = 0) ⇒ Kc = 1 (EM G-11) | Pass |
| C2. adding consolidation shear raises Kc above 1 (EM G-11) | Pass |
| D1. at isotropic (Kc=1) τff = d + σ′c·tanψ (the Kc=1 envelope, EM G-9) | Pass |
| D2. τff is bounded by the two envelopes (EM G-12 interpolation) | Pass |
| D3. τff scales with the consolidation stress σ′c | Pass |
| D4. τff is never negative | Pass |
| E1. rapid drawdown REDUCES the factor of safety vs the full reservoir | Pass |
| E2. stage-3 (min of drained/undrained) ≤ stage-2 (undrained) | Pass |
| E3. complete drawdown is the most critical — FoS rises as the drawn-down level rises | Pass |
| E4. stronger friction raises the rapid-drawdown FoS | Pass |
| E5. more cohesion raises the rapid-drawdown FoS | Pass |
| E6. the drawdown FoS ratio is reported and < 1 (drawdown always costs stability) | Pass |
| E7. a valid critical circle and full slice table are returned | Pass |
| E8. input guards: drawn-down level above full pool is rejected | Pass |
| F1. Fig. G-5: Kc=1 envelope from the R-envelope (cR = 1200 psf, φR = 16°, φ′ = 30°) → d = 1379 psf, ψ = 18.2° (EM G-5/G-6) | Pass |
| F2. Fig. G-10b/G-11: Kf = tan²(45+φ′/2) = 3.00 for φ′ = 30°, c′ = 0 (EM G-26) | Pass |
| F3.1. Fig. G-10b slice 1 (σ′c 0.32, τc 0.08 ksf): Kc 1.71, τff(Kc=1) 1.49, τff(Kc=Kf) 0.19, τff 1.02 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.2. Fig. G-10b slice 2 (σ′c 1.44, τc 0.38 ksf): Kc 1.71, τff(Kc=1) 1.85, τff(Kc=Kf) 0.83, τff 1.49 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.3. Fig. G-10b slice 3 (σ′c 2.9, τc 0.76 ksf): Kc 1.71, τff(Kc=1) 2.33, τff(Kc=Kf) 1.67, τff 2.1 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.4. Fig. G-10b slice 4 (σ′c 3.64, τc 0.95 ksf): Kc 1.71, τff(Kc=1) 2.58, τff(Kc=Kf) 2.1, τff 2.41 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.5. Fig. G-10b slice 5 (σ′c 4.05, τc 1.06 ksf): Kc 1.71, τff(Kc=1) 2.71, τff(Kc=Kf) 2.34, τff 2.58 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.6. Fig. G-10b slice 6 (σ′c 4.45, τc 1.17 ksf): Kc 1.71, τff(Kc=1) 2.84, τff(Kc=Kf) 2.57, τff 2.75 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.7. Fig. G-10b slice 7 (σ′c 4.57, τc 1.2 ksf): Kc 1.71, τff(Kc=1) 2.88, τff(Kc=Kf) 2.64, τff 2.8 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.8. Fig. G-10b slice 8 (σ′c 4.54, τc 1.19 ksf): Kc 1.71, τff(Kc=1) 2.87, τff(Kc=Kf) 2.62, τff 2.78 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.9. Fig. G-10b slice 9 (σ′c 4.31, τc 1.13 ksf): Kc 1.71, τff(Kc=1) 2.8, τff(Kc=Kf) 2.49, τff 2.69 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.10. Fig. G-10b slice 10 (σ′c 3.66, τc 0.96 ksf): Kc 1.71, τff(Kc=1) 2.58, τff(Kc=Kf) 2.11, τff 2.42 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.11. Fig. G-10b slice 11 (σ′c 2.6, τc 0.68 ksf): Kc 1.71, τff(Kc=1) 2.23, τff(Kc=Kf) 1.5, τff 1.97 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F3.12. Fig. G-10b slice 12 (σ′c 1.01, τc 0.27 ksf): Kc 1.71, τff(Kc=1) 1.71, τff(Kc=Kf) 0.59, τff 1.31 ksf (EM G-24, G-9, G-10, G-27) | Pass |
| F4a. Stage-3 rule on the published tables: drained strength governs on exactly slices 1, 2 and 12 (EM §G-6e) | Pass |
| F4b. Stage 1 (Simplified Bishop, c′ = 0, φ′ = 30°, full pool): F = 2.20 (EM Fig. G-10a, ±0.06 = 2σ of table rounding) | Pass |
| F4c. Stage 2 (undrained τff as c, φ = 0): F = 1.52 (EM Fig. G-11a, ±0.02 = 2σ of table rounding) | Pass |
| F4d. Stage 3 (drained strength on slices 1, 2, 12): F = 1.44 (EM Fig. G-11c, ±0.02 = 2σ of table rounding) | Pass |
| F4e. Published ordering: F1 (2.20) > F2 (1.52) > F3 (1.44) — the THIRD stage governs | Pass |
| F5. End-to-end on the EM slope (2.84:1 average face, 110 ft, γ 135 pcf, pool 103 → 24 ft): third stage governs and the critical FoS lies at or below the EM non-critical-circle 1.44 | Pass |
| G1. full pool to the crest, c′ = 0: full-pool minimum → tanφ′/tanβ (DWB 2014 Ch. 6), independent of slices and R-envelope | Pass |
| G2. the screen default (H 15, β 22°, c′ 5, φ′ 28°): full-pool FoS stable within 1.5 % from 10 to 60 slices and with φR | Pass |
| G3. no drawdown, a pool above the crest, a level below the toe, negative c′ / cR and an emptied slice count are refused with no numbers | Pass |
seepage-slope-stability-web-validation.test.ts
WEB-BENCHMARK validation for the coupled steady-seepage → slope-stability engine (the release rules ≥20 cited-value gate).
Analyses validated: seepage-slope-stability · Recorded run: passed — 36 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the coupled steady-seepage → slope-stability
engine (the release rules ≥20 cited-value gate). Two independent solution families
anchor the engine:
A. CLOSED-FORM steady-seepage INFINITE slope (Craig 8e §13 / Das;
Duncan-Wright-Brandon 2014 §4). These are exact identities:
• dry, c′=0: FoS = tanφ′/tanβ (Skempton & DeLory 1957)
• seepage-parallel, c′=0: FoS = (γ′/γ_sat)·tanφ′/tanβ (halves the frictional FoS)
• submerged (still water): FoS = tanφ′/tanβ (unchanged from dry — buoyancy)
• r_u override: u = r_u·γ·z
• pore pressure: u = γ_w·h_p
B. BISHOP simplified circular search reproduces two universally-published
limits: the cohesionless translational limit FoS = tanφ′/tanβ (the
critical circle degenerates to the plane), and the φ=0 undrained
stability number Ns (Taylor 1937/1948): F = c/(γ·H·Ns).
Tolerances: 1e-9 for the exact closed forms; 3.5% for the cohesionless
circular-vs-planar limit (finite slices + circular arc); 6% for the Taylor
comparison (friction-circle chart vs Bishop spread). 32 cited assertions.
| Test block (the published value it checks) | Verdict |
| Inf-slope DRY c'=0: FoS = tanφ/tanβ φ=30° β=20° (Skempton-DeLory 1957) | Pass |
| Inf-slope DRY c'=0: FoS = tanφ/tanβ φ=35° β=25° (Skempton-DeLory 1957) | Pass |
| Inf-slope DRY c'=0: FoS = tanφ/tanβ φ=32° β=18° (Skempton-DeLory 1957) | Pass |
| Inf-slope DRY c'=0: FoS = tanφ/tanβ φ=28° β=22° (Skempton-DeLory 1957) | Pass |
| Inf-slope DRY c'=0: FoS = tanφ/tanβ φ=40° β=30° (Skempton-DeLory 1957) | Pass |
| Inf-slope DRY c'=0: FoS = tanφ/tanβ φ=25° β=15° (Skempton-DeLory 1957) | Pass |
| Inf-slope SEEPAGE-PARALLEL c'=0: FoS = (γ'/γsat)·tanφ/tanβ φ=30° β=20° (Craig/Das) | Pass |
| Inf-slope SEEPAGE-PARALLEL c'=0: FoS = (γ'/γsat)·tanφ/tanβ φ=35° β=25° (Craig/Das) | Pass |
| Inf-slope SEEPAGE-PARALLEL c'=0: FoS = (γ'/γsat)·tanφ/tanβ φ=32° β=18° (Craig/Das) | Pass |
| Inf-slope SEEPAGE-PARALLEL c'=0: FoS = (γ'/γsat)·tanφ/tanβ φ=34° β=24° (Craig/Das) | Pass |
| Inf-slope SEEPAGE-PARALLEL c'=0: FoS = (γ'/γsat)·tanφ/tanβ φ=30° β=15° (Craig/Das) | Pass |
| Inf-slope: seepage-parallel FoS ≈ 0.5× dry when γ_sat ≈ 2γ_w (γ_sat=19.62) | Pass |
| Inf-slope SUBMERGED c'=0: FoS = tanφ/tanβ (= dry, buoyancy) φ=30° β=20° | Pass |
| Inf-slope SUBMERGED c'=0: FoS = tanφ/tanβ (= dry, buoyancy) φ=34° β=26° | Pass |
| Inf-slope regime ordering: dry > seepage-parallel > rapid-drawdown (c′=0) | Pass |
| Inf-slope seepage-parallel: u = γ_w·z·cos²β (u = γ_w·h_p) | Pass |
| Inf-slope r_u override: u = r_u·γ·z (r_u=0.1) | Pass |
| Inf-slope r_u override: u = r_u·γ·z (r_u=0.25) | Pass |
| Inf-slope r_u override: u = r_u·γ·z (r_u=0.5) | Pass |
| Inf-slope r_u: FoS decreases monotonically as r_u rises | Pass |
| Inf-slope cohesive seepage worked example → FoS ≈ 1.031 (Craig/Das closed form) | Pass |
| Bishop search DRY c'≈0: FoS → tanφ/tanβ φ=30° β=18.43° (Skempton-DeLory 1957) | Pass |
| Bishop search DRY c'≈0: FoS → tanφ/tanβ φ=35° β=21.8° (Skempton-DeLory 1957) | Pass |
| Bishop search DRY c'≈0: FoS → tanφ/tanβ φ=32° β=26.57° (Skempton-DeLory 1957) | Pass |
| Bishop search DRY c'≈0: FoS → tanφ/tanβ φ=38° β=18.43° (Skempton-DeLory 1957) | Pass |
| Bishop search φ=0 vs Taylor Ns β=60° (Ns=0.191): F=c/(γHNs) | Pass |
| Bishop search φ=0 vs Taylor Ns β=53.13° (Ns=0.182): F=c/(γHNs) | Pass |
| Bishop dry search == closed-form infinite-slope FoS at the cohesionless limit | Pass |
| Bishop on a large-radius circle → closed-form tanφ/tanβ (explicit circle) | Pass |
| Bishop: seepage-parallel FoS < dry FoS, and reduction is reported > 0 | Pass |
| Bishop: FoS decreases monotonically as the phreatic surface rises | Pass |
| Bishop: increasing r_u monotonically lowers FoS (u = r_u·γ·z) | Pass |
| Bishop slices: u = γ_w·h_p on every slice; max u>0 wet, =0 dry | Pass |
| Engine returns a finite closed-form infinite-slope cross-check | Pass |
| Guard: c′=0 AND φ′=0 is rejected with an error (no shear strength) | Pass |
| Guard: non-positive height is rejected with an error | Pass |
slope-reinforcement-web-validation.test.ts
Reinforcement forces in the slope engine (slope-reinforcement.ts): soil nails, rock bolts / anchors, geosynthetics, micropiles.
Analyses validated: micropile, slope-stability · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Reinforcement forces in the slope engine (slope-reinforcement.ts): soil nails, rock bolts / anchors, geosynthetics, micropiles.
EVIDENCE
[FHWA] Closed form. For a planar slip surface at inclination α with one element of force T at inclination i below the horizontal
into the slope: PASSIVE (resistance) F = [c·L + (W cosα + T sin(i+α) − u·L)·tanφ + T cos(i+α)] / (W sinα) — FHWA GEC 7
(Lazarte et al. 2015) planar nail equation, Slide2 "passive"; ACTIVE (external load) F = [c·L + (W cosα + T sin(i+α))·tanφ]
/ [W sinα − T cos(i+α)] — Slide2 "active". With pseudo-static k_h: W cosα → W cosα − k_h W sinα, W sinα → W sinα + k_h W cosα.
Janbu simplified, Spencer, Morgenstern–Price and Sarma must all reproduce it (a planar surface has no interslice forces).
[Y54] Rocscience Slide Slope Stability Verification Manual, Problem #54 (Yamagami 2000): homogeneous slope (-6,0) (0,0) (8,4) (12,4),
c′ 4.9 kPa, φ′ 10°, γ 15.68, one vertical micropile at x = 9 from y = 4 to −2, shear 10.7 kN, spacing 1 m (passive).
No pile 1.102 (Slide) / 1.10 (Yamagami); with the pile 1.193 / 1.20. Geometry from Figure 54.1 (labels read).
The with-pile value is taken on the no-pile critical circle (the one the pile crosses): a grid search over all circles also
finds circles that miss the pile, which Slide's search range excludes.
[A47] Same manual, Problem #47 (Sheahan 2003, Amherst test wall): c′ 25, γ 18.9, wall 6 m, 14.6 kN/m on the wall top, two passive
nails 4.9 m (tensile 118, plate 86, bond 15, spacing 1.5), critical PLANAR surface by Janbu simplified: 0.890 (Slide),
0.887 (Sheahan). Nail heads (0, 4.95) and (0, 3.35), 20° down, read off Figure 47.1.
NOT reproduced (stated): Problem #48 (Clouterre wall, six plane angles): with nail lengths / heads read from Figure 48.1 the engine
gives 1.074 / 0.977 / 0.902 / 0.840 / 0.794 / 0.776 at 45…70° against Slide 1.123 … 0.923 — right trend, up to 16 % low at 70°; the
figure does not fix the nail geometry and the table's tensile / bond units are ambiguous, so it is NOT used as evidence.
Problems #30 (Borges & Cardoso geosynthetic embankment, depth-varying cu), #49, #50 need inputs the engine does not take or the
figure does not give.
| Test block (the published value it checks) | Verdict |
| [FHWA] planar surface, one nail: passive and active closed forms reproduced by Janbu, Spencer, Morgenstern–Price (static and pseudo-static) | Pass |
| [FHWA] Sarma on the same planar surface (2 wedges, interfaces normal to the base): passive 2.6917 and active 3.5526 as the closed forms | Pass |
| capacities at the crossing: tensile, pull-out beyond the surface, facing + bond in front; the least governs and says so | Pass |
| anchor: active by default, free length is not bonded, lock-off load limits the force | Pass |
| geosynthetic: horizontal force, pull-out from 2·σ′v·tanδ·C per metre embedded when no bond is given (FHWA GEC 11) | Pass |
| orientation: along the element (nail), tangent to the surface (micropile), horizontal (geosynthetic); components resolved as stated | Pass |
| refusals and warnings by name | Pass |
| [Y54] Yamagami slope: no pile 1.102 (Slide) / 1.10; the 10.7 kN micropile lifts the same critical circle to 1.193 / 1.20 | Pass |
| [A47] Amherst nailed wall: critical planar surface, two passive nails — 0.890 (Slide, Janbu), 0.887 (Sheahan) | Pass |
slope-sarma-web-validation.test.ts
Sarma (1979) non-vertical wedges and the global non-circular searches (particle swarm, cuckoo) on the slope engine.
Analyses validated: slope-stability · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Sarma (1979) non-vertical wedges and the global non-circular searches (particle swarm, cuckoo) on the slope engine.
PUBLISHED VALUES (all read from the cited documents, none invented):
[R4] Rocscience "Slope Stability (Sarma Method) Verification Manual", Problem #4 (Hoek 1987 spoil pile on a sheared floor):
drained FoS 1.198 (Slide) / 1.2 (Hoek 1987); geometry labels read off Figure 4.1: pile (0,0) (111.4,76.5) (229.645,13.6816),
floor y = 14.9x/250, base vertex (108,6.4), active-wedge top (128,~67.7); spoil c 100 kPa, φ 42°, γ 15.7; floor c 10, φ 6°.
[R7] Same manual, Problem #7 (Matthews, Farook & Helm 2014): critical circular surface by Sarma 1.175 centred (39.88, 33.63);
reference 1.136. Geometry from Figure 7.1: ground (0,20) (21,20) (29,14) (31,14) (50,5) (62,5); soils sand c 3 φ 30,
clay c 22 φ 11 (y 5–12), clay c 25 φ 20 (below y 5), γ 21.
[S8] Slide Slope Stability Verification Manual Problem #8 = ACADS 3(b) (Giam & Donald 1989) prescribed surface: Spencer 1.277,
GLE 1.262, Janbu corrected 1.294; reference 1.34. (geometry: slope-stability-noncircular-web-validation.test.ts)
[S22] Problem #22 (Fredlund & Krahn 1977) composite circle: Spencer 1.382 / 1.373 (dry), 1.124 / 1.118 (ru 0.25); M-P 1.372 / 1.370, 1.114 / 1.118.
[S14] [S16] [S7] Problems #14, #16, #7 (Arai & Tagyo 1985; ACADS 3(a)) non-circular searches: Spencer 1.386, 1.094, 1.246; Janbu
simplified 1.253, 0.968 — the searches the default optimiser is already validated on.
What these do and do not establish: [R4] and [R7] are Sarma-specific published values; [S8] and [S22] are cross-checks of Sarma
against rigorous methods on printed surfaces (Sarma's factor depends on the interface angles and need not equal Spencer's: the
measured gaps are stated in the tolerances). The Sarma verification manual's other problems carry geometry only as figures with
partial labels (#1–#3 are optimisations of Slide's own surfaces; #5 and #6 have a reservoir / water table not recoverable from the
labels) and are NOT reproduced.
| Test block (the published value it checks) | Verdict |
| [R4] Hoek spoil pile, drained: Sarma 1.198 (Slide) / 1.2 (Hoek 1987) — optimised interface angle | Pass |
| [R7] Matthews et al. circle, centre (39.88, 33.63): Sarma 1.175 (Slide), reference 1.136 | Pass |
| [S8] ACADS 3(b) prescribed surface: Sarma against Spencer 1.277, GLE 1.262, Janbu corrected 1.294 and the Giam & Donald reference 1.34 | Pass |
| [S22] F&K composite circle (resampled to 12 wedges): Sarma within 6 % of Spencer / M-P dry (1.382/1.373, 1.372/1.370) and within 6 % with ru 0.25 (1.124/1.118) | Pass |
| Sarma with noncircular_search finds a surface, reports the optimiser and the Spencer cross-check; refusals are explicit | Pass |
| pso: Spencer search reproduces Slide #14 1.386, #16 1.094, #7 1.246 within 2 % and never exceeds the pattern search | Pass |
| pso: Janbu simplified search vs Slide #14 1.253 and #16 0.968 (within 2 %), deterministic | Pass |
| cuckoo: Spencer search reproduces Slide #14 1.386, #16 1.094, #7 1.246 within 2 % and never exceeds the pattern search | Pass |
| cuckoo: Janbu simplified search vs Slide #14 1.253 and #16 0.968 (within 2 %), deterministic | Pass |
| the default optimiser is untouched: omitting noncircular_optimizer equals 'pattern' to the last digit | Pass |
slope-stability-craig-ex122-web-validation.test.ts
Circular method-of-slices slope stability — validated against a PUBLISHED WORKED EXAMPLE on the published circle.
Analyses validated: slope-stability · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Circular method-of-slices slope stability — validated against a PUBLISHED WORKED EXAMPLE on the
published circle.
SOURCE, read directly including its figure:
Craig, R.F. *Craig's Soil Mechanics*, 8th edition, §12 "Stability of self-supporting soil masses",
**Example 12.2** (book p.481, PDF p.498) and **Figure 12.12**.
`Geo Technical engineering books/craigs-soil-mechanics8th-editionrf-craig-pdf-free.pdf`
── WHY THIS SUITE EXISTS, AND WHY IT NEEDED AN ENGINE CHANGE FIRST.
`slope-stability-web-validation.test.ts` anchors the two closed-form LIMITS — the cohesionless
infinite-slope result FoS = tanφ′/tanβ (Skempton & DeLory 1957) and Taylor's (1937) φ = 0 stability
number. Both are real published evidence, and both are limits rather than a full slice calculation.
What could not be reproduced was the ordinary textbook form of a slope benchmark: a stated circle, a
stated slice table, and a stated factor of safety on THAT surface.
The obstacle was the engine, not the sources. `computeSlopeStability` always SEARCHED for the critical
circle, and a search returns the minimum factor of safety — which for a published, non-critical circle
is a lower bound, not the published number. So every worked example in the literature was unusable as
an anchor. `SlopeInputs.trial_circle` now evaluates one prescribed circle and skips both the grid and
the toe sweep, which is what makes this suite possible at all.
── THE PUBLISHED PROBLEM (Figure 12.12, read from a 150 dpi page render — the centre is in the FIGURE,
not in the text, and guessing it produced a 6 % error before the figure was read):
slope 6 m high at 1 : 1½ ⇒ β = atan(1/1.5) = 33.69°
centre O 3.15 m ABOVE the crest, 2.50 m horizontally from the toe ⇒ (2.50, 9.15) with the
toe at the origin
radius r = 9.50 m
unit weight γ = 20 kN/m³ both above and below the water table
slices 8, width 1.50 m
strengths (a) peak c′ = 10 kPa, φ′ = 29° (b) critical state c′ = 0, φ′cv = 31°
⚠️ THE GEOMETRY IS SELF-CHECKING, and test [1] uses it. √(2.50² + 9.15²) = 9.485 m against the stated
r = 9.50 m — so the circle passes through the toe, to within the width of a drawn line. That agreement
is what confirms the figure was read correctly rather than plausibly, and it is the reason the centre
can be trusted as an input at all.
── PUBLISHED RESULTS, and how they are derived from Craig's own Table 12.1:
Σ(Wᵢcosαᵢ − uᵢlᵢ) = 392.75 kN/m Σ(Wᵢsinαᵢ) = 253.52 kN/m arc length Lₐ = 14.35 m
Fellenius (Craig Eq 12.19): F = [c′·Lₐ + tanφ′·Σ(Wcosα − ul)] / Σ(Wsinα)
(a) F = [10(14.35) + tan29°(392.75)] / 253.52 = 1.425
(b) F = [0 + tan31°(392.75)] / 253.52 = 0.931
Craig's own remark on the pair: *"Despite φ′cv > φ′, the factor of safety is lower in this case. This
demonstrates that the (apparent) cohesion c′ should not be relied upon in design."*
── TOLERANCES, AND WHY THEY ARE WHAT THEY ARE. 3 % on the absolute factors of safety, and the reasons
are stated rather than fitted:
· Craig's water table is a SLOPING line read off Figure 12.12; this engine's phreatic surface is
horizontal at a stated depth below the crest. 4.0 m reproduces his tabulated pore pressures most
closely (his u runs 5.9 → 18.1 kPa across slices 1–6 and is zero on 7–8).
· Craig states his own pore-pressure treatment is deliberately conservative: *"This procedure
slightly overestimates the pore water pressure … The error involved is on the safe side."* An
overestimated u lowers his F, so this engine reading marginally HIGHER is the expected direction,
not a discrepancy to be explained away. Measured: +1.3 % on (a), +1.8 % on (b).
· His eight 1.50 m slices and this engine's discretisation of the same arc are not identical.
⚠️ THE RATIO IS THE TIGHTEST ANCHOR HERE and test [4] pins it to 1 %: F(b)/F(a) cancels the arc
length, the weights and most of the pore-pressure sensitivity, leaving essentially
tan31°/(tan29° + c′Lₐ/Σ). Published 0.6533, measured 0.6565 — 0.5 %. A suite that only checked the two
absolute values to 3 % would pass on a systematic geometry error that this catches.
| Test block (the published value it checks) | Verdict |
| [1-2] the published geometry is self-consistent: the circle passes through the toe | Pass |
| [3-5] Craig Eq 12.19 reproduced from his own Table 12.1 sums | Pass |
| [6-8] the engine on the published circle reproduces the published factors of safety | Pass |
| [9] the RATIO — the anchor that geometry error cannot hide behind | Pass |
| [10-11] the published finding survives in the engine, not just in the arithmetic | Pass |
| [12-15] a prescribed circle is used VERBATIM — no search, no substitution | Pass |
| [16-17] the SEARCH finds something at least as critical as the published circle | Pass |
| [18-20] omitting trial_circle changes nothing — the search path is untouched | Pass |
slope-stability-geometry-web-validation.test.ts
slope-stability — POLYLINE GEOMETRY validation (stage A: ground_profile, layer bottom_profile, piezometric_line, rigid_base_y_m).
Analyses validated: slope-stability · Recorded run: passed — 16 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
slope-stability — POLYLINE GEOMETRY validation (stage A: ground_profile, layer bottom_profile,
piezometric_line, rigid_base_y_m). Every expected value is PRINTED in the cited source; tolerances
are stated per group with the reason. Read 2026-09-30 from the reference library.
[S3] Rocscience Slide Slope Stability Verification Manual, Problem #3 = ACADS 1(c) (Giam & Donald
1989), pp. 28-30. Geometry Figure 3.1 (p. 28); soils Table 3.1; results Table 3.2 (p. 29);
critical circle printed in Figs 3.2-3.4: centre (34.121, 43.254), R 18.781, endpoints
(29.702, 25.000) and (50.991, 35.000) — the same circle for Bishop, Spencer and GLE.
The manual prints NO coordinate table for the inclined layer boundaries; the unlabelled vertices
were read off Figure 3.1 rendered at 150 and 400 dpi (±0.05 m, every one lands on an integer):
soil 1/soil 3 from the toe (30,25) to (40,27); soil 1/soil 2 (40,27)-(50,29)-(54,31)-(70,31);
soil 2/soil 3 (40,27)-(52,24)-(70,24). The printed labelled points are (20,25) (30,25) (50,35)
(70,35) (70,31) (70,24) (70,20) (20,20); the model base y = 20 is 5 m below the toe.
[S4] Same manual, Problem #4 = ACADS 1(d): #3 with kh = 0.15, pp. 32-34; Table 4.2 (p. 33); Bishop
and Spencer on the #3 circle (Figs 4.2, 4.3); GLE on centre (34.121, 44.265), R 19.637,
endpoints (30.091, 25.046) and (51.435, 35.000) (Fig 4.4, p. 34).
[S16] Same manual, Problem #16 = Arai & Tagyo (1985) Ex 3, pp. 77-78. Figure 16.1 prints every point:
ground (0,15)(18,15)(30,23)(48,35)(66,35); water table (0,15)(18,15)(30,23)(48,29)(66,32);
base y = 0. §16.2: u = γw × VERTICAL distance to the water table. Table 16.2 circular (auto
refine search): Bishop 1.118, Spencer 1.118. (Fig 16.2's image is the non-circular Janbu
surface despite its caption, so no circular centre is printed — the search is used.)
[EM] USACE EM 1110-2-1902 (31 Oct 2003), Appendix F-5, pp. F-19 to F-21 (PDF pp. 169-171):
Simplified Bishop F = 1.33 (text p. F-20; Fig F-11 Σ 698 / Σ 524). Circle centre 101 ft from
the toe and 259 ft above it, R 278 ft (Fig F-10); slope 3:1 to EL 58, 2.5:1 to the crest at
EL 91; embankment γ 135 pcf, c 1780 psf, φ 5°; foundation γ 127 pcf, c 1600 psf, φ 2°; the
interface is the original ground at EL 0; no water. Slices crossing the interface are weighed
in two parts and take the strength of the soil at their BASE (p. F-20). Read off Fig F-10
(not printed as numbers): the crest is flat to x ≈ 301 ft, then the downstream face falls at
≈ 2.5:1 — the circle exits on that face (at x = 318 ft the circle is at EL 85.2; the printed
slice widths sum to 318 ft). Note: the section has a slope BREAK at EL 58, not a bench.
[FK], [ACADS 1(a)] — the existing H/β examples (see slope-stability-worked-examples-web-validation),
re-run with an equivalent ground_profile.
Frame: the engine's toe is the origin (x towards the crest, y up): [S3]/[S4] x−30, y−25;
[S16] x−18, y−15.
| Test block (the published value it checks) | Verdict |
| [S3] the printed critical circle meets the read-off ground exactly at the printed endpoints | Pass |
| [S3] ACADS 1(c) on the printed circle: Bishop 1.405, Spencer 1.375, GLE 1.374 | Pass |
| [S4] ACADS 1(d) kh = 0.15 on the printed circles: Bishop 1.016, Spencer 0.991, GLE 0.989 | Pass |
| [S4] the pseudo-static force acts at the slice CENTROID (Kramer 1996 §10.6.1.1; FHWA GEC-3 §6.2.2) | Pass |
| [S3] ACADS 1(c) grid search with the rigid base 5 m below the toe: Bishop 1.405, Spencer 1.375 | Pass |
| [S3] the grid search honours the rigid base — no critical circle dips below y = −5 | Pass |
| [S4] ACADS 1(d) grid search: Bishop 1.016, Spencer 0.991 | Pass |
| [S16] Arai & Tagyo Ex 3 with its printed polyline water table: Bishop 1.118, Spencer 1.118 | Pass |
| [S16] u is γw × the vertical distance to the line, clamped to the ground | Pass |
| [EM] EM 1110-2-1902 F-5 end-of-construction: Simplified Bishop 1.33 on the prescribed circle | Pass |
| [EM] slices crossing EL 0 weigh both soils; the base soil sets the strength | Pass |
| [compat] F&K dry prescribed circle (Bishop 2.080 F&K / 2.079 Slide): same result with an equivalent ground_profile | Pass |
| [compat] ACADS 1(a) grid search (Bishop 0.987 Slide): same result with an equivalent ground_profile | Pass |
| [compat] polyline-layer mode with ONE soil split in two reproduces the band result | Pass |
| circle crossing a polyline 4 times: the slip mass is the span containing the lowest point | Pass |
| malformed / inconsistent geometry is refused with a clear error | Pass |
⚑ slope-stability-noncircular-search-web-validation.test.ts
slope-stability — SEARCH for the critical non-circular surface (`noncircular_search`), 2026-10-03.
Analyses validated: slope-stability · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
slope-stability — SEARCH for the critical non-circular surface (`noncircular_search`), 2026-10-03.
Closes the "search for critical non-circular surfaces" gap in docs/ENGINE-DEEP-REVIEW/08-slope-stability.md.
Published sources — the Rocscience Slide Slope Stability Verification Manual (Geo Technical engineering
books/Slide_SlopeStabilityVerification.pdf, read with pdftotext), which tabulates both its own optimised
search and the original authors' values:
[S7] Problem #7 = ACADS 3(a) (Giam & Donald 1989): two soils with a 0.5 m weak seam, water table at the
seam base, block search. Slide Table 7.2: Spencer 1.246; "Reference factor of safety = 1.24 – 1.27
[Giam]". Geometry as the [S8] fixture of slope-stability-noncircular-web-validation (same slope).
[S14] Problem #14 = Arai & Tagyo (1985) Ex 1, homogeneous, dry. Table 14.3 (path search with
optimisation): Janbu simplified 1.253, Janbu corrected 1.346, Spencer 1.386; Arai & Tagyo's own
Janbu simplified 1.265 and corrected 1.357.
[S16] Problem #16 = Arai & Tagyo Ex 3, same slope with a polyline water table. Table 16.3 (random search
with Monte-Carlo optimisation): Janbu simplified 0.968, Janbu corrected 1.050, Spencer 1.094; Arai
& Tagyo 0.995 / 1.071.
Tolerance 2 % (one-sided where stated): two different optimisers on the same problem — Slide's own
searches and Arai & Tagyo's differ by 1–3 % on these very cases.
Excluded, with the reason: ACADS 3(a) Janbu corrected 1.258. Slide minimised Janbu CORRECTED directly; the
engine's searches minimise Janbu simplified or a rigorous method, so the corrected value it reports is on a
different surface (1.32). Not comparable, so not asserted.
| Test block (the published value it checks) | Verdict |
| [S14] Arai & Tagyo Ex 1 Janbu search: simplified 1.253 (Slide) / 1.265 (A&T), corrected 1.346 / 1.357 | Pass |
| [S14] Arai & Tagyo Ex 1 Spencer search: 1.386 (Slide), below the best circle | Pass |
| [S16] Arai & Tagyo Ex 3 Janbu search: simplified 0.968 / 0.995, corrected 1.050 / 1.071 | Pass |
| [S16] Arai & Tagyo Ex 3 Spencer search: 1.094 (Slide) | Pass |
| [S7] ACADS 3(a) weak seam: Spencer 1.246 (Slide), inside the Giam & Donald reference range 1.24 – 1.27 | Pass |
| the search is deterministic and refuses methods defined only for circles | Pass |
slope-stability-noncircular-web-validation.test.ts
slope-stability — NON-CIRCULAR slip surfaces (stage C): General Limit Equilibrium (Fredlund & Krahn 1977) Spencer and Morgenstern-Price, Janbu simplified and Janbu (1973) corrected, on a prescribed polyline `slip_surface`.
Analyses validated: slope-stability · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
slope-stability — NON-CIRCULAR slip surfaces (stage C): General Limit Equilibrium (Fredlund & Krahn
1977) Spencer and Morgenstern-Price, Janbu simplified and Janbu (1973) corrected, on a prescribed
polyline `slip_surface`. Every expected value is PRINTED in the cited source. Read 2026-09-30.
[S8] Rocscience Slide Slope Stability Verification Manual, Problem #8 = ACADS 3(b) (Giam & Donald
1989), pp. 47-49: the #7 geometry with a PRESCRIBED non-circular surface, Table 8.2 (printed):
(41.85, 27.75) (44.00, 26.50) (63.50, 27.00) (73.31, 40.00). Soils Table 8.1: soil 1 c′ 28.5,
φ′ 20°, γ 18.84; soil 2 (the weak seam) c′ 0, φ′ 10°, γ 18.84. Water table at the base of the seam
(#7 §7.2). Table 8.3: Spencer 1.277, GLE 1.262, Janbu corrected 1.294; reference 1.34 (Giam).
Geometry not printed as numbers; read off Figure 7.1 at 300 dpi, calibrated on the axis ticks
(27.5 px/m): ground (20, 27.75) – toe (43, 27.75) – crest (67.5, 40) – (84, 40); seam 26.5–27.0
across the section (Table 8.2's own vertices sit on 26.50 and 27.00; the toe level 27.75 is
Table 8.2's first point).
[S22] Same manual, Problem #22 (Fredlund & Krahn 1977, slope with a weak layer), pp. 92-94, imperial.
Figure 22.1 prints (0,60) (60,60) (140,20) (180,20) and the weak layer 15–16 (labels (0,15) (0,16)
(180,15) (180,16)); the model base is y = 15. Composite circle xc 120, yc 90, R 80 (§22.2): the arc
is cut off by the base and runs along it. Upper soil c′ 600 psf, φ′ 20°, γ 120 pcf; weak layer
c′ 0, φ′ 10°, γ 120; ru 0.25 (case 2). Table 22.2 (Slide) / 22.3 (F&K): dry Spencer 1.382 / 1.373,
M-P 1.372 / 1.370; ru Spencer 1.124 / 1.118, M-P 1.114 / 1.118. The manual notes the weak layer is
placed slightly differently in each reference, so results "vary in the second decimal place".
Frames: [S8] x − 43, y − 27.75. [S22] mirrored so the crest is at +x: x′ = 140 − x, y′ = y − 20 (ft).
| Test block (the published value it checks) | Verdict |
| [S8] ACADS 3(b) prescribed non-circular surface: Spencer 1.277, GLE 1.262, Janbu corrected 1.294 | Pass |
| [S8] slices break at the seam crossing: no base straddles two materials | Pass |
| [S22] F&K composite circle, dry: Spencer 1.382 (Slide) / 1.373 (F&K), M-P 1.372 / 1.37 | Pass |
| [S22] F&K composite circle, ru 0.25: Spencer 1.124 (Slide) / 1.118 (F&K), M-P 1.114 / 1.118 | Pass |
| GLE(f = 1) = circular Spencer on the F&K circle, dry | Pass |
| GLE(f = 1) = circular Spencer on the F&K circle, ru 0.25 | Pass |
| GLE(f = 1) = circular Spencer on the F&K circle, k_h 0.15 | Pass |
| GLE(f = 1) = circular Spencer on the F&K circle, water-filled 3 m crack | Pass |
| a slip_surface that traces the F&K circle reproduces the prescribed-circle result | Pass |
| slip_surface refusals are explicit | Pass |
slope-stability-strip-load-web-validation.test.ts
slope-stability — STRIP LOADS (offset surcharge), 2026-10-03.
Analyses validated: slope-stability · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
slope-stability — STRIP LOADS (offset surcharge), 2026-10-03. Closes the "offset strip surcharge" gap
recorded in docs/ENGINE-DEEP-REVIEW/08-slope-stability.md.
Published source [MKB]:
Medjitna, L., Kahlerras, A., Amar Bouzid, D. (2025) "Stability Analysis of Slopes under Surcharge Loading
Using FE Stress Deviator Increasing Method — proposal of Stability Charts", Periodica Polytechnica Civil
Engineering 69(2) 621–632, https://doi.org/10.3311/PPci.37264 (open access,
https://pp.bme.hu/ci/article/download/37264/23799).
§3.1 / Table 1: homogeneous slope, c′ = 20 kPa, φ′ = 20°, γ = 20 kN/m³, surcharge q/γH = 0.5 over
B = 2.5 m set back b = 1 m from the slope edge; q = 100 kPa with H = 10 m (stated in §3.3: "q = 100 kPa
... fixed height H = 10 m"). SLIDE 6.0 results printed in Table 1:
β = 30°: Spencer 1.36, Bishop 1.37
β = 45°: Spencer 1.00, Bishop 1.01
β = 60°: Spencer 0.79, Bishop 0.80
§4.1 example 2 / Table 3: H = 10 m, β = 45°, c = 10 kPa, φ = 15°, γ = 20, q/γH = 0.2 (q = 40 kPa) in the
Fig. 2 configuration (B = 2.5 m at b = 1 m): SLIDE 6.0 Spencer 0.7; FELA (OPTUM G2) bounds 0.69 – 0.71.
Excluded, with the reason: §4.1 example 1 (no surcharge; H 15, β 75°, c 15, φ 25) prints SLIDE 0.9 while
the paper's own FELA bounds are 0.76–0.77 and its charts 0.77–0.79; the engine gives 0.638. The printed
inputs do not reproduce the paper's own numbers, so it cannot anchor anything.
Tolerance 2 %: Slide prints two decimals (±0.005 ≈ 0.5 % at FoS 1), and the critical-circle search
resolution differs between programs.
| Test block (the published value it checks) | Verdict |
| [MKB Table 1] β = 30°: Spencer 1.36, Bishop 1.37 (SLIDE 6.0) | Pass |
| [MKB Table 1] β = 45°: Spencer 1, Bishop 1.01 (SLIDE 6.0) | Pass |
| [MKB Table 1] β = 60°: Spencer 0.79, Bishop 0.8 (SLIDE 6.0) | Pass |
| [MKB Table 3] example 2: Spencer 0.7 (SLIDE 6.0), inside the FELA bracket 0.69–0.71 | Pass |
| a strip load covering the whole crest region equals the existing crest surcharge | Pass |
| physics: FoS falls with load magnitude and recovers with setback (MKB §3.2–3.3 trends) | Pass |
| linearly varying pressure is integrated exactly (trapezoid force and centroid) | Pass |
| refusals: reversed span, negative pressure, non-finite values | Pass |
slope-stability-tension-crack-web-validation.test.ts
slope-stability — TENSION CRACK (stage B) and the JANBU SIMPLIFIED kernel.
Analyses validated: slope-stability · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
slope-stability — TENSION CRACK (stage B) and the JANBU SIMPLIFIED kernel. Every expected value is
PRINTED in the cited source; tolerances are stated per group with the reason. Read 2026-09-30.
[S2] Rocscience Slide Slope Stability Verification Manual, Problem #2 = ACADS 1(b) (Giam & Donald
1989), pp. 24-27. Geometry Figure 2.1 (every point printed): the ACADS 1(a) slope — toe (30,25),
crest (50,35), model base y = 20 — with a tension-crack zone 4 m deep ((20,21) (30,21) (50,31)
(70,31)), water-filled. c′ 32 kPa, φ′ 10°, γ 20 (Table 2.1). Table 2.2: Bishop 1.596, Spencer
1.592, GLE 1.592; ACADS reference 1.65. Figs 2.2-2.4: Bishop, Spencer and GLE all on centre
(37.562, 43.223), R 20.228, left endpoint (28.782, 25.000).
[S56] Same manual, Problem #56 (Pockoski & Duncan 2000, test slope 2), pp. 201-202, imperial. Figure
56.1 prints (−70,100) (0,100) (100,150) (170,150) (170,75) (−70,75); the unlabelled nodes on
x = 100 were read off the figure rendered at 300 dpi (calibrated on the labelled nodes, 8.0 px/ft
vertical): crack-zone base y = 144.56 (the printed slip endpoint gives 144.500 → 5.5 ft deep),
water table at the crest y = 139.8 → 140, i.e. (−70,100) (0,100) (100,140) (170,140). Dry crack.
c′ 300 psf, φ′ 30°, γ 120 pcf. Table 56.2: Spencer 1.290, Bishop 1.285, Janbu simplified 1.141
(UTEXAS4 1.29 / 1.28 / 1.14; SLOPE/W 1.29 / 1.28 / 1.14). Fig 56.2 Spencer circle: centre
(24.662, 197.656), R 100.790; endpoints (−0.274, 100.000) and (110.295, 144.500).
[S16] Same manual, Problem #16 (Arai & Tagyo 1985), Table 16.2: circular Janbu simplified 1.046.
Craig, *Soil Mechanics* 8e p. 474 — a tension crack shortens the slip surface and, when it fills
with water, a hydrostatic force acts normal to it (the φ = 0 moment check below).
Frame: toe at the origin — [S2] x−30, y−25; [S56] x, y−100 (feet → m by 0.3048).
| Test block (the published value it checks) | Verdict |
| [S2] ACADS 1(b) on the printed circle: Bishop 1.596, Spencer 1.592, GLE 1.592 | Pass |
| [S2] ACADS 1(b) grid search: Bishop 1.596, Spencer 1.592 | Pass |
| [S2] the crack truncates the slip at depth_m and the water thrust is ½γw·hw² at hw/3 | Pass |
| Craig 8e p. 474 — φ = 0 with a water-filled crack: the engine equals the moment equation | Pass |
| [S56] Pockoski & Duncan slope 2 on the printed circle: Spencer 1.290, Bishop 1.285; endpoints as printed | Pass |
| [S56] grid search: Bishop 1.285, Spencer 1.290, Janbu simplified 1.141 | Pass |
| [S16] Arai & Tagyo circular: Janbu simplified 1.046 (Slide Table 16.2) | Pass |
| invalid tension-crack input is refused with a clear error | Pass |
slope-stability-web-validation.test.ts
WEB-BENCHMARK validation for the circular method-of-slices slope engine (the release rules ≥20 cited-value gate).
Analyses validated: slope-stability · Recorded run: passed — 26 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the circular method-of-slices slope engine
(the release rules ≥20 cited-value gate). The engine's Bishop-simplified critical FoS is
checked against two independent, universally-published closed-form solutions:
• COHESIONLESS limit — for c′=0 the critical surface is shallow/translational and
the factor of safety is exactly FoS = tanφ′/tanβ (Skempton & DeLory 1957;
the infinite-slope result, in every soil-mechanics text: Das, Taylor, Duncan).
The circular search converges to this; agreement here proves the frictional
mobilisation + slice statics are correct across slope angle and φ.
• φ=0 UNDRAINED — Taylor's (1937) stability number Ns = c/(γ·H·F) for a homogeneous
slope gives F = c/(γ·H·Ns); Ns is the canonical tabulated value (Das Fig./Table).
Tolerances: 3% for the frictional limit (circular vs planar surface + finite slices),
5% for the Taylor comparison (friction-circle chart vs Bishop method spread). Both are
stated because the reference solution and the engine use different (but equivalent-in-
the-limit) formulations. 22 cited target values total.
| Test block (the published value it checks) | Verdict |
| Slope web: c=0 FoS=tanφ/tanβ φ=25° 2:1 (β=26.6°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=25° 2.5:1 (β=21.8°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=25° 3:1 (β=18.4°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=25° 4:1 (β=14.0°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=30° 2:1 (β=26.6°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=30° 2.5:1 (β=21.8°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=30° 3:1 (β=18.4°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=30° 4:1 (β=14.0°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=35° 2:1 (β=26.6°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=35° 2.5:1 (β=21.8°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=35° 3:1 (β=18.4°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=35° 4:1 (β=14.0°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=40° 2:1 (β=26.6°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=40° 2.5:1 (β=21.8°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=40° 3:1 (β=18.4°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=40° 4:1 (β=14.0°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=45° 2:1 (β=26.6°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=45° 2.5:1 (β=21.8°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=45° 3:1 (β=18.4°) | Pass |
| Slope web: c=0 FoS=tanφ/tanβ φ=45° 4:1 (β=14.0°) | Pass |
| Slope web: φ=0 undrained vs Taylor Ns β=60° (Ns=0.191) | Pass |
| Slope web: φ=0 undrained vs Taylor Ns β=53.13° (Ns=0.182) | Pass |
| Slope E-113: an INVERTED layer must be rejected, not silently read as the deepest layer | Pass |
| Slope E-113: layer elevations ARE honoured — order of strata changes FoS | Pass |
| Slope E-113: a gap or overlap in the profile must be reported | Pass |
| Slope E-113: non-finite and non-physical layer properties must be rejected | Pass |
slope-stability-worked-examples-web-validation.test.ts
slope-stability — FULL WORKED EXAMPLES (the ≥20-value gate).
Analyses validated: slope-stability · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
slope-stability — FULL WORKED EXAMPLES (the ≥20-value gate). Every expected value is PRINTED in the
cited source, read 2026-09-29 from the reference library; tolerances are stated per source.
[FK] Fredlund & Krahn (1977) Can. Geotech. J. 14(3), as tabulated in the Rocscience Slide
Slope Stability Verification Manual, Problem #21 — one PRESCRIBED circle (xc 120, yc 90,
R 80 ft), four methods, dry and ru = 0.25, each printed by F&K AND by Slide.
[SLIDE] Slide Hand Calculations #1 (dry) and #2 (water table at the surface), after Sharma
(1996) — 7-slice Bishop on a prescribed circle.
[ACADS] Slide Verification Problem #1 = ACADS 1(a), Giam & Donald (1989) — critical-circle search.
[AT] Slide Verification Problem #16 = Arai & Tagyo (1985) Ex 3 — water table.
[CRAIG] Craig's Soil Mechanics 8e, Example 12.1 — φu = 0 trial circle.
[VAR] Varghese, Foundation Engineering, Example 24.1 — φ = 0 trial circle.
Unit conversion for [FK]: 1 ft = 0.3048 m, 600 psf = 28.728 kPa, 120 pcf = 18.85 kN/m³.
[FK]'s slope descends left-to-right; the engine's ascends, so x is mirrored about the toe.
| Test block (the published value it checks) | Verdict |
| [FK] dry: Ordinary 1.928 / 1.931 (F&K / Slide) | Pass |
| [FK] dry: Bishop 2.080 / 2.079 — read from `critical.fos`, which must now BE Bishop | Pass |
| [FK] dry: Spencer 2.073 / 2.075 | Pass |
| [FK] dry: Morgenstern-Price 2.076 / 2.075 | Pass |
| [FK] ru 0.25: Ordinary 1.607 (F&K; Slide 1.687 uses a different ru convention) | Pass |
| [FK] ru 0.25: Bishop 1.766 / 1.763, Spencer 1.761 / 1.760, M-P 1.764 / 1.760 | Pass |
| Spencer picks the PHYSICAL root: F&K θ ≈ +14°, and Spencer ≈ Bishop on the same circle | Pass |
| [AT] Arai & Tagyo Ex 3 (horizontal water-table approximation): Spencer takes the physical root, ≈ Bishop | Pass |
| Morgenstern-Price with f(x) = constant reduces to Spencer | Pass |
| [SLIDE] HC#1 dry: Bishop 2.113 | Pass |
| [SLIDE] HC#2 water table at surface: Bishop 1.554 | Pass |
| [ACADS] 1(a): Bishop 0.987, Spencer 0.986, M-P 0.986; ACADS reference 1.00 | Pass |
| [ACADS] 1(a): Janbu simplified (uncorrected) 0.939 (SLOPE/W §2.1 Table 2) | Pass |
| [CRAIG] Ex 12.1: φu = 0, F = 2.48 (graphical area 70 m², d 4.5 m) — and Spencer = Bishop | Pass |
| [VAR] Ex 24.1: φ = 0 — printed 1.14 uses a graphical area 7.5 % larger than its own geometry | Pass |
taylor-stability-web-validation.test.ts
taylor-stability — dedicated validation against PUBLISHED worked answers (`taylor-stability.ts`).
Analyses validated: taylor-stability · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
taylor-stability — dedicated validation against PUBLISHED worked answers (`taylor-stability.ts`).
WHAT THE ENGINE DOES. The chart reading (Taylor's stability number Ns) is an INPUT by design; the engine
computes c_d = Ns·γ·H, FoS_c = c / c_d, H_c = c / (Ns·γ). So the published answers that exercise it
are the ARITHMETIC of worked chart examples: given the Ns the author read off the chart, do we return
the author's printed height / factor of safety / developed cohesion? The chart readings themselves are
the inputs the authors printed; they are not re-derived here.
SOURCES (each opened from the local reference library on 2026-10; locator beside every value):
[F] FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Ch. 6 §6.6.2.1,
Example 6-1 and Example 6-1a (pp. 6-30 to 6-32): 30 ft fill slope, β = 30°, γ = 120 pcf,
c′ = 500 psf, φ′ = 20°.
[K] Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon Press — Example 12.1
(pp. 476-477), Ns = 0.18 read from Fig. 12.9 for a 45° slope in undrained clay.
[V] Varghese, P.C. (2005), Foundation Engineering, PHI Learning — Ch. 24 "Stability of slopes",
Examples 24.1, 24.3, 24.4, 24.5 (Terzaghi's stability factor Ns_T = γH_c/c = 1/N).
[U] USACE EM 1110-2-1902 (2003), Slope Stability, Appendix E Example Problems E-1 to E-4: Janbu-chart
examples whose closing line is F = N·c/P_d. With N_T = 1/N and γ·H ≡ P_d this is the SAME identity
the engine implements (Janbu's N and Taylor's Ns are reciprocal stability numbers), so the printed
F is a published answer of this arithmetic. The Janbu CHARTS are not Taylor's; only the final
identity is shared, and that is all these four assertions test.
TOLERANCES follow each source's printed rounding (stated at each assertion).
Unit conversions only to run US-unit examples through the SI engine: 1 pcf = 0.157087 kN/m³,
1 psf = 0.0478803 kPa, 1 ft = 0.3048 m (FoS and length ratios are unchanged by consistent conversion).
KNOWN INCONSISTENCIES IN THE PRINTED SOURCES (reported, not papered over):
· Varghese Ex. 24.1 states a 6.5 m slope but its Taylor step evaluates FoS at "H = 6 m"; the printed
1.21 is reproduced only at H = 6 m, so H = 6 m is what is used.
· Varghese Ex. 24.5 prints γ = 12 kN/m³ in the statement but divides by 19 in the solution; the printed
H_c = 4.55 m is reproduced only with 19, so 19 is used (and the book rounds γH_c/c to 7.2).
| Test block (the published value it checks) | Verdict |
| [F] Example 6-1, trial Fc=Fφ=1.6, Ns=0.065: printed H = 40.1 ft | Pass |
| [F] Example 6-1, trial Fc=Fφ=1.9, Ns=0.073: printed H = 30.04 ft and FS ≈ 1.9 | Pass |
| [F] Example 6-1a table row Fφ=1 (φd=20°, Ns=0.026): printed Fc = 5.3 | Pass |
| [F] Example 6-1a table row Fφ=1.5 (φd=14°, Ns=0.055): printed Fc = 2.5 | Pass |
| [F] Example 6-1a table row Fφ=2 (φd=10°, Ns=0.075): printed Fc = 1.9 | Pass |
| [F] Example 6-1a table row Fφ=2.5 (φd=8°, Ns=0.087): printed Fc = 1.6 | Pass |
| [K] Craig Ex. 12.1(a): Ns = 0.18 → F = 2.37 | Pass |
| [K] Craig Ex. 12.1(c): EC7 DA1b design cu = 65/1.40 → maximum cutting depth h ≤ 13.58 m | Pass |
| [V] Example 24.1 (Terzaghi Ns_T = 5.52, c = 25 kPa, γ = 19): H_c = 7.26 m, FoS(H = 6 m) = 1.21 | Pass |
| [V] Example 24.3 (Ns_T = 7.8, c = 30, γ = 20, H = 8): F.S. against cohesion = 1.46 | Pass |
| [V] Example 24.4 (Ns_T = 6.8, γ = 20, H = 8): required c = 23.5 kN/m², FoS on available c = 30 → 1.28 | Pass |
| [V] Example 24.5 (γH_c/c = 7.2, c = 12, γ = 19 as used in the solution): H_c = 4.55 m, H(FS=1.5) = 3.03 m | Pass |
| [U] Example E-1 (N0 = 5.8, c = 452 psf, Pd = 2302 psf): F = 1.14 | Pass |
| [U] Example E-2 (N0 = 5.6, c = 499 psf, Pd = 2253 psf): F = 1.24 | Pass |
| [U] Example E-3 (Ncf = 6, c = 735 psf, Pd = 4500 psf): F = 1.0 | Pass |
| [U] Example E-4 (Ncf = 35, c = 134 psf, Pd = 4141 psf): F = 1.13 | Pass |
| definition checks: c_d = Ns·γ·H, and FoS = 1 exactly at H = H_c | Pass |
| zero / negative / non-numeric Ns, γ or H are refused (no fabricated FoS) | Pass |
Retaining walls, excavations and structural elements
FE kernel registry — 46 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-verif-confined-wall-Q | total discharge under the dam (impermeable wall, confined flow) [m³/day/m] | PLAXIS-Verification-Confined-flow-impermeable-wall-2018.pdf, p. 3 (Table 1) | 0.818 | 0.82 | 0.81959 | +0.19 % | −0.05 % | Pass |
plaxis-verif-bending-plates-point-u | midspan deflection, point load F = 100 kN/m, L = 1 m, EA 1e5, EI 83.33, ν 0 (simply supported) [mm] | PLAXIS-Verification-Bending-of-plates.pdf, p. 2 (Output), 3–4 (Verification) | 25.6 | 25.6 | 25.6 | 0.00 % | 0.00 % | Pass |
plaxis-verif-bending-plates-point-M | Mmax, point load [kNm/m] | PLAXIS-Verification-Bending-of-plates.pdf, p. 2–3 | 25 | 25 | 25 | 0.00 % | 0.00 % | Pass |
plaxis-verif-bending-plates-point-Q | Qmax, point load [kN/m] | PLAXIS-Verification-Bending-of-plates.pdf, p. 2–3 | 50.61 | 50 | 50 | −1.21 % | 0.00 % | Pass |
plaxis-verif-bending-plates-dist-u | midspan deflection, distributed load q = 200 kN/m/m [mm] | PLAXIS-Verification-Bending-of-plates.pdf, p. 2–4 | 31.85 | 31.85 | 31.85 | 0.00 % | 0.00 % | Pass |
plaxis-verif-bending-plates-dist-M | Mmax, distributed load [kNm/m] | PLAXIS-Verification-Bending-of-plates.pdf, p. 2–3 | 25 | 25 | 25 | 0.00 % | 0.00 % | Pass |
plaxis-verif-bending-plates-dist-Q | Qmax, distributed load [kN/m] | PLAXIS-Verification-Bending-of-plates.pdf, p. 2–3 | 101.3 | 100 | 100 | −1.28 % | 0.00 % | Pass |
plaxis-verif-sliding-block-force | sliding force at failure (plateau), push 1 mm [kN/m] | PLAXIS-Verification-Sliding-block-interfaces.pdf, p. 2–3 (Output; Verification) | 60.08 | 60.076 | 60.0763 | −6.0e-3 % | 0.00 % | Pass |
plaxis-verif-sliding-block-avg-tau | average maximum shear stress under the block [kPa] | PLAXIS-Verification-Sliding-block-interfaces.pdf, p. 2–3 | 15.06 | 15.019 | 15.0191 | −0.27 % | +1.0e-3 % | Pass |
plaxis-verif-pipe-capacity-r1.0 | lateral load P at u = 0.08 m (1.6 % of D), strict convergence [kN/m] | PLAXIS-Verification-Circular-pipe-laterally-loaded-cohesive.pdf, p. 2 (Table 1) | 300.8 | 298.5 | 299.87 | −0.31 % | +0.46 % | Pass |
plaxis-verif-pipe-capacity-r0.8 | lateral load P at u = 0.08 m (1.6 % of D), strict convergence [kN/m] | PLAXIS-Verification-Circular-pipe-laterally-loaded-cohesive.pdf, p. 2 (Table 1) | 290.9 | 289.1 | 290.51 | −0.13 % | +0.50 % | Pass |
plaxis-verif-pipe-capacity-r0.6 | lateral load P at u = 0.08 m (1.6 % of D), strict convergence [kN/m] | PLAXIS-Verification-Circular-pipe-laterally-loaded-cohesive.pdf, p. 2 (Table 1) | 279 | 277.2 | 279.1 | +0.04 % | +0.68 % | Pass |
plaxis-verif-pipe-capacity-r0.4 | lateral load P at u = 0.08 m (1.6 % of D), strict convergence [kN/m] | PLAXIS-Verification-Circular-pipe-laterally-loaded-cohesive.pdf, p. 2 (Table 1) | 265.3 | 263.3 | 265.56 | +0.10 % | +0.87 % | Pass |
plaxis-verif-pipe-capacity-r0.2 | lateral load P at u = 0.08 m (1.6 % of D), strict convergence [kN/m] | PLAXIS-Verification-Circular-pipe-laterally-loaded-cohesive.pdf, p. 2 (Table 1) | 250 | 247.1 | 249.61 | −0.15 % | +1.00 % | Pass |
plaxis-verif-pipe-initial-stiffness | initial horizontal stiffness Kxx of the full pipe, R_inter = 1 [kN/m] | PLAXIS-Verification-Circular-pipe-laterally-loaded-cohesive.pdf, p. 3 (Eq. 3) | — | 99125 | 99102 | — | −0.02 % | Pass |
ertc7-wall-moment | maximum bending moment in the wall, final excavation (−6 m), characteristic parameters, embedment 4 m [kNm/m] | PLAXIS-Verification-ERTC7-benchmark.pdf, p. 7 (Figure 8, characteristic, embedment 4.0 m: read at 300 dpi ≈ 212) | 212 | — | 204 | −3.77 % | — | Deviation |
ertc7-strut-force | strut force, final excavation [kN/m] | PLAXIS-Verification-ERTC7-benchmark.pdf, p. 8 (Figure 9, characteristic, 4.0 m: ≈ 117) | 117 | — | 123.9 | +5.90 % | — | Deviation |
ertc7-wall-base-displacement | horizontal displacement of the wall base, final excavation [mm] | PLAXIS-Verification-ERTC7-benchmark.pdf, p. 7 (Figure 6, characteristic, 4.0 m: ≈ 6.0) | 6 | — | 9 | +50.0 % | — | Deviation |
plaxis-2d-tut3 | |u| at (50, 10) at the end of each phase (submerged excavation, undrained-A clay) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 52–71 | phase1: 0.005; phase2: 0.024; phase3: 0.024; phase4: 0.057; phase5: 0.141 | — | phase1: 0.0092; phase2: 0.0302; phase3: 0.0302; phase4: 0.074; phase5: stops at ΣMstage 0.350 (tol 1e-8 and 1e-7); at tol 1e-2 (PLAXIS default, TBK_T3_TOL=0.01) reaches ΣMstage 1 with |u| 0.117 | — | — | Superseded |
k3-gate-cantilever | cantilever tip deflection, tip load P = 10, L = 2, EI 1e3, EA 2e5, ν 0.2 (plane strain: EI/(1−ν²)) [m] | — | — | 0.025888 | 0.025888 | — | 0.00 % | Pass |
k3-gate-two-span | moment over the middle support, two equal spans L = 2 under q = 12 [kNm/m] | — | — | 5.93325 | 5.93325 | — | 0.00 % | Pass |
k3-gate-circular-plate | centre deflection of a simply supported circular plate (axisymmetric), a = 2, q = 10, ν 0.3 [m] | — | — | 0.009301 | 0.009301 | — | 0.00 % | Pass |
k3-gate-plastic-hingeself-check | collapse load of a simply supported Mp-plate (N–M diamond), with and without N = 100 (Np 400) [kN/m] | — | — | — | — | — | 0.00 % | Pass |
k3-gate-anchor-spring | node-to-node / fixed-end anchor displacement and force [m] | — | — | 0.2 | 0.2 | — | 0.00 % | Pass |
k3-gate-geogrid | tension-only geogrid: u = F L / EA in tension; zero force in compression [m] | — | — | 0.08 | 0.08 | — | 0.00 % | Pass |
k3-gate-interface-patch | sliding resultant Σ τ = R (c L + tan φ N) and every point on the Coulomb line, R_inter 1 and 0.6 [kN/m] | — | — | 36.0458 | 36.0458 | — | 0.00 % | Pass |
k3-gate-excavation-unloading | heave of the new surface after removing 3 m of a laterally restrained elastic column (7 m remain) [m] | — | — | 0.0315 | 0.0315 | — | 0.00 % | Pass |
k3-gate-plate-soil-compatibilityself-check | settlement of a very stiff plate loaded by the force of a rough rigid footing pushed δ = 0.01 [m] | — | — | 0.01 | 0.0100001 | — | +1.0e-3 % | Pass |
k3-gate-staged-wall-equilibriumself-check | global equilibrium every phase of a staged excavation (wall plate, two-sided interface, prestressed strut, two stages): ΣRy = soil weight + wall weight, ΣRx = −strut [kN/m] | — | — | — | — | — | 0.00 % | Pass |
plaxis-2d-tut7-prestress-top | top anchor force at the end of phase 3 (prestress 500 kN per anchor, Lspacing 2.5 m) [kN] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 131 (§7.8.4), 137 (§7.9) | 500 | — | 500 | 0.00 % | — | Pass |
plaxis-2d-tut7-prestress-bottom | bottom anchor force at the end of phase 5 (prestress 1000 kN) [kN] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 132 (§7.8.6), 137 | 1000 | — | 1000 | 0.00 % | — | Pass |
plaxis-2d-tut7-final | final phase: wall max |M|, anchor forces, wall displacements [kNm/m, kN, mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 135–137 (Figures 7–16…7–22: figures only) | — | — | wallL Mmax: 154; wallR Mmax: 157; at y: 23; anchors top L/R: [430.4, 428.6]; anchors bottom L/R: [1053.4, 1050.8]; ux(40,27) mm: 10.24; ux(40,23) mm: 13.34 | — | — | Superseded |
plaxis-2d-tut7-final-k4-flow | final phase with REAL phase-6 steady flow: wall max |M|, anchor forces, wall displacements [kNm/m, kN, mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 135–137 (Figures 7–16…7–22: figures only) | — | — | wallL Mmax: 167; wallR Mmax: 170.7; at y: 23; anchors top L/R: [420.1, 424.4]; anchors bottom L/R: [1081.6, 1081.8]; ux(40,27) mm: 6.51; ux(40,23) mm: 12.33; prestress P3 / P5: [500, 1000] | — | — | Superseded |
k5b-plaxis-2d-tut7-real-hs | Tutorial 7 with the REAL Hardening Soil (Table 7-1) + phase-6 steady flow: anchor forces, wall max |M|, wall ux [kN, kNm/m, mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 121–137 (prestress p. 137; Figs 7-16…7-22 figures only) | prestress 500 / 1000 kN (figures otherwise) | — | prestress P3 / P5: [500, 1000]; final anchors top L/R: [450.6, 446.8]; final anchors bottom L/R: [1058.8, 1055.4]; wallL / wallR Mmax: [141.9, 145.1]; at y: 23; ux(40,27) mm: 17.15; ux(40,23) mm: 17.06; K4 Mohr–Coulomb substitute (row plaxis-2d-tut7-final-k4-flow): (Mmax: [167, 170.7]; anchors top: [420.1, 424.4]; anchors bottom: [1081.6, 1081.8]; ux mm: [6.51, 12.33]) | — | — | Recorded, no published value |
k5d-plaxis-2d-tut3-submerged-hs | |u| at (50, 10) at the end of each phase — real Hardening Soil, the kernel's own submerged excavation (D90: deactivated clusters keep their water) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 71 (Fig. 3-15 raster, pixel-measured; tests/data/plaxis_tut3_fig3_15.txt) | phase1: 0.0062; phase2: 0.0242; phase3: 0.0242; phase4: 0.0572; phase5: 0.1417 | — | phase1: 0.0054; phase2: 0.0225; phase3: 0.0225; phase4: 0.0589; phase5: 0.1519 | phase1: -12.9; phase2: -7; phase3: -7; phase4: 3; phase5: 7.2 | — | Deviation |
k5d-plaxis-2d-tut10-dewatering | Tutorial 10: Tutorial 7 (real HS) + two extraction wells in the phase-6 steady flow (1.5 m³/day/m, h_min 17 m): well discharges, groundwater head in the pit, final anchor forces / wall moments [m³/day/m, m, kN, kNm/m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 166–169 (Figs 10–4, 10–5: figures only) | figures only (head lowered in the excavation, flow to the wells) | — | well discharge each (m³/day/m): -0.9797; side inflow each: 0.9773; pit-bottom seepage: 0; head in the pit (m): 18.90–18.99 (T7: 20 at the bottom); phreatic line in the pit y (m): [18.609, 18.982]; final anchors top L/R, bottom L/R (kN): [453, 449.7, 1050.1, 1048.2]; wall max |M| L/R (kNm/m): [135.1, 138.1] | — | — | Recorded, no published value |
k5d1-da-ec7-annex-a | design-approach presets DA1-1 (A1+M1), DA1-2 (A2+M2), DA2 (A1+M1), DA3 (A2+M2 on geotechnical actions): γG 1.35/1.0, γQ 1.5/1.3, γφ′ = γc′ 1.25, γcu 1.4, γqu 1.4, γγ 1.0; tan φ factored, ψ ≤ φ_d [-] | EN 1997-1:2004 Annex A (Tables A.3, A.4); PLAXIS-2D-2025.1-Reference-Manual §5.8, p. Annex A; RM pp. 126–131 | — | 1.25 | 1.25 | — | 0.00 % | Pass |
k5d1-cable-winklerself-check | worst bar-point axial-force error (of N(0) = 48.2014 kN/m) of a pulled grouted cable with an elastic bond Ks [relative error] | PLAXIS-2D-2025.1-Reference-Manual §5.6.7, §6.7, p. Eq. 6-68 (p. 290) | — | 0.002 | 2.050e-5 | — | — | Pass |
k5d1-cable-plastic-bondself-check | worst error of the pulled-cable force against the plastic bond capacity (c_bond + σn tan φ_bond P)·L / L_spacing = 15 kN/m [relative error] | PLAXIS-2D-2025.1-Reference-Manual §6.7, p. Eq. 6-68 (p. 290) | — | 1.000e-6 | 8.890e-11 | — | — | Pass |
k5d1-embedded-beam-axialself-check | worst bar-point axial-force error of an embedded beam row (skin spring R_s + tension-free base spring K_F), push and pull [relative error] | PLAXIS-2D-2025.1-Reference-Manual §5.6.3, §6.6.4, p. Eqs. 6-65/6-66/6-67 (ISF, pp. 285–286) | — | 0.001 | 3.280e-6 | — | — | Pass |
k5d1-embedded-beam-lateralself-check | worst bending-moment error (of the maximum 1.4963 kNm/m) of a laterally loaded embedded beam row (λL = 8.34) [relative error] | — | — | 0.02 | 0.00713 | — | — | Pass |
k5d1-beta-method-cc | β-method (deconfinement d = 0.6) wall displacement of an elastic circular opening, then the lined state [m] | PLAXIS-2D-2025.1-Reference-Manual §7.5.1.3; Panet convergence–confinement, p. RM pp. 326–327 | — | 0.0075 | 0.00750509 | — | +0.07 % | Pass |
k5d1-plaxis-2d-tut8-safety-sls | ΣMsf of the Safety phase on SLS phase 6 [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 144 (Fig. 8–6, figure read) | 1.49 | — | 1.4828 | −0.48 % | — | Pass |
k5d1-plaxis-2d-tut8-safety-uls | ΣMsf of the Safety phase on ULS phase 12 (DA3: inherits the design strengths) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 144 (Fig. 8–6, figure read) | 1.19 | — | 1.1813 | −0.73 % | — | Pass |
k5d1-plaxis-2d-tut8-uls-displacement | |u| at (40, 27) at the end of ULS phase 12 (real Hardening Soil, DA3) [m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 143 (Fig. 8–5, embedded raster: pixel-measured, ±0.0001 m — tests/data/plaxis_tut8_fig8_5_8_6.txt on branch prog-a-t8) | 0.0518 | — | 0.069 | +33.2 % | — | Deviation |
k5d1-mesher-crossing-structuresself-check | meshed area of a square cut by two crossing structure lines that close a face against the boundary [m²] | — | — | 100 | 100 | — | 0.00 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
plaxis-verif-confined-wall-Q — Pass · K4
Reference: Harr 1962 (via the PLAXIS document)
Mesh: T15, 2236 elements (Fine-like, 0.1 on the wall / dam line)
Reproduce: tests/k4_flow.rs plaxis_confined_flow_impermeable_wall
Notes: Harr (1962) chart Q/(kΔh) ≈ 0.41 (2 significant figures). Gate: within 1 % of both. Screen = impermeable interface (closed), its end nodes split (one pressure DOF per side) so no flow leaks round the tip; without the split the discharge was +8.6 % (fixed). Without the wall: 1.07466 (> 1.1 Q, asserted).
plaxis-verif-bending-plates-point-u — Pass · K3
Reference: Timoshenko beam with k = 5/6 (PLAXIS p. 3–4)
Case: tests/k3_structures.rs
Mesh: rect-mesh 8 cells, plate on the top edge (8 × 3-node / 5-node plates; soil deactivated)
Reproduce: tests/k3_structures.rs plaxis_bending_of_plates_point_and_distributed_load
Notes: T6 and T15 edges both 25.600000 (|err| < 1e-9 m). Closed form F L³/48EI + 6FL/20GA = 25.00 + 0.60.
plaxis-verif-bending-plates-point-M — Pass · K3
Reference: F L / 4
Case: tests/k3_structures.rs
Mesh: as above
Reproduce: tests/k3_structures.rs plaxis_bending_of_plates_point_and_distributed_load
Notes: End-node moments by nodal equilibrium (exact statics).
plaxis-verif-bending-plates-point-Q — Pass · K3
Reference: F / 2
Case: tests/k3_structures.rs
Mesh: as above
Reproduce: tests/k3_structures.rs plaxis_bending_of_plates_point_and_distributed_load
Notes: Ours = the closed form F/2 exactly; PLAXIS's own Q is +1.2 % (its stress-point extrapolation).
plaxis-verif-bending-plates-dist-u — Pass · K3
Reference: Timoshenko beam, k = 5/6
Case: tests/k3_structures.rs
Mesh: as above
Reproduce: tests/k3_structures.rs plaxis_bending_of_plates_point_and_distributed_load
Notes: 5qL⁴/384EI + 6qL²/40GA = 31.25 + 0.60.
plaxis-verif-bending-plates-dist-M — Pass · K3
Reference: q L² / 8
Case: tests/k3_structures.rs
Mesh: as above
Reproduce: tests/k3_structures.rs plaxis_bending_of_plates_point_and_distributed_load
Notes: Linear Gauss-point extrapolation alone would give 25.26 on T6 (the quadratic M); the end-node moment from nodal equilibrium is exact.
plaxis-verif-bending-plates-dist-Q — Pass · K3
Reference: q L / 2
Case: tests/k3_structures.rs
Mesh: as above
Reproduce: tests/k3_structures.rs plaxis_bending_of_plates_point_and_distributed_load
Notes: Ours = q L / 2 exactly; PLAXIS +1.3 %.
plaxis-verif-sliding-block-force — Pass · K3
Reference: c′ L + γ h L tan φ′ (PLAXIS p. 3)
Case: tests/k3_structures.rs
Mesh: rect-mesh 16 × 3 cells, T6 and T15; interface on the base (positive side), t_v = 0.025 m
Reproduce: tests/k3_structures.rs plaxis_sliding_block_interface
Notes: Σ τ·w = push reaction = 60.076270 (T6 and T15); every interface point on the Coulomb line; normal force = block weight 100.000.
plaxis-verif-sliding-block-avg-tau — Pass · K3
Reference: c′ + γ h tan φ′
Case: tests/k3_structures.rs
Mesh: as above
Reproduce: tests/k3_structures.rs plaxis_sliding_block_interface
Notes: Same run. R_inter 0.6 → 36.0458 = 0.6 × 60.0763 exactly (patch test); elastic slip stiffness K_s = G_i/t_v (t_v = the interface virtual thickness, m: K_n = E_oed,i / t_v, K_s = G_i / t_v, model/structures.rs) to 0.014 %; gap (lift 1 mm): σn = 0, the lift carries the weight.
plaxis-verif-pipe-capacity-r1.0 — Pass · K3
Reference: Randolph & Houlsby (1984), p. 2 Eq. (1)
Case: cases/plaxis-verification-circular-pipe-laterally-loaded.json
Mesh: half model 45 × 17.5 m, pipe circle 96 chords on the half circle, 1367 T15, interface t_v 0.29 m
Reproduce: tests/k3_tutorials.rs plaxis_circular_pipe_laterally_loaded (ignored: about 9 min per R)
Notes: Re-run 12 Nov 2026 after the interface fix KB-3 (one nodal normal at vertex pairs shared by two chords across a kink of at most 30°), same gate, written beforehand: plateau rise 0.045 % (≤ 0.2 %), +0.46 % against Eq. 1 (≤ 1.3 %). Interface shear capped at R·su; normal stress ±28 kPa. Before the fix: 304.42 (+1.98 %). || Re-run 12 Nov 2026 with a gate written beforehand: a plateau (rise ≤ 0.2 % over the last quarter of the push) and ≤ 1.3 % against Eq. 1 (PLAXIS's own largest stated error). Interface shear is capped exactly at R·su. The remaining excess and creep come from the faceted interface: each chord uses its own normal, so slip at shared vertices creates spurious normal stress; doubling the chords (48 to 96) cut the R 0.4 excess from +5.1 % to +1.9 %. The rest is ordinary FE over-estimation. For R < 1, Eq. 1 is a lower bound; the best upper bound is up to 1.3 % above it (Fleming et al. 2009 Fig. 4.40). || Randolph & Houlsby (1984) 298.5 (ours +1.63 %); PLAXIS 3D's own errors vs R&H 0.7–1.3 %. Undrained (C) run as total-stress MC c = su, φ = ψ = 0, non-porous; rigid pipe = stiff plug under prescribed displacement (PLAXIS: rigid body, force control); interface tension cut-off off (R&H: no separation). P at u = 0.03 m: 303.63 / 300.29 / 286.87 / 270.34 / 251.30 — not yet a plateau for R < 1 (the soft t_v (t_v = the interface virtual thickness, m: K_n = E_oed,i / t_v, K_s = G_i / t_v, model/structures.rs) interface).
plaxis-verif-pipe-capacity-r0.8 — Pass · K3
Reference: Randolph & Houlsby (1984), p. 2 Eq. (1)
Case: cases/plaxis-verification-circular-pipe-laterally-loaded.json
Mesh: half model 45 × 17.5 m, pipe circle 96 chords on the half circle, 1367 T15, interface t_v 0.29 m
Reproduce: tests/k3_tutorials.rs plaxis_circular_pipe_laterally_loaded (ignored: about 9 min per R)
Notes: Re-run 13 Nov 2026 after the interface fix KB-3, same gate, written beforehand: plateau rise 0.046 % (≤ 0.2 %), +0.50 % against Eq. 1 (≤ 1.3 %); interface shear capped at R·su; normal stress ±28.74 kPa. Before the fix: 297.25 (+2.83 %). || Re-run 12 Nov 2026 with a gate written beforehand: a plateau (rise ≤ 0.2 % over the last quarter of the push) and ≤ 1.3 % against Eq. 1 (PLAXIS's own largest stated error). Interface shear is capped exactly at R·su. The remaining excess and creep come from the faceted interface: each chord uses its own normal, so slip at shared vertices creates spurious normal stress; doubling the chords (48 to 96) cut the R 0.4 excess from +5.1 % to +1.9 %. The rest is ordinary FE over-estimation. For R < 1, Eq. 1 is a lower bound; the best upper bound is up to 1.3 % above it (Fleming et al. 2009 Fig. 4.40). || Randolph & Houlsby (1984) 289.1 (ours +2.62 %); PLAXIS 3D's own errors vs R&H 0.7–1.3 %. Undrained (C) run as total-stress MC c = su, φ = ψ = 0, non-porous; rigid pipe = stiff plug under prescribed displacement (PLAXIS: rigid body, force control); interface tension cut-off off (R&H: no separation). P at u = 0.03 m: 303.63 / 300.29 / 286.87 / 270.34 / 251.30 — not yet a plateau for R < 1 (the soft t_v (t_v = the interface virtual thickness, m: K_n = E_oed,i / t_v, K_s = G_i / t_v, model/structures.rs) interface).
plaxis-verif-pipe-capacity-r0.6 — Pass · K3
Reference: Randolph & Houlsby (1984), p. 2 Eq. (1)
Case: cases/plaxis-verification-circular-pipe-laterally-loaded.json
Mesh: half model 45 × 17.5 m, pipe circle 96 chords on the half circle, 1367 T15, interface t_v 0.29 m
Reproduce: tests/k3_tutorials.rs plaxis_circular_pipe_laterally_loaded (ignored: about 9 min per R)
Notes: Re-run 13 Nov 2026 after the interface fix KB-3, same gate, written beforehand: plateau rise 0.027 % (≤ 0.2 %), +0.68 % against Eq. 1 (≤ 1.3 %); interface shear capped at R·su; normal stress ±31.87 kPa. Before the fix: 283.89 (+2.41 %). || Re-run 12 Nov 2026 with a gate written beforehand: a plateau (rise ≤ 0.2 % over the last quarter of the push) and ≤ 1.3 % against Eq. 1 (PLAXIS's own largest stated error). Interface shear is capped exactly at R·su. The remaining excess and creep come from the faceted interface: each chord uses its own normal, so slip at shared vertices creates spurious normal stress; doubling the chords (48 to 96) cut the R 0.4 excess from +5.1 % to +1.9 %. The rest is ordinary FE over-estimation. For R < 1, Eq. 1 is a lower bound; the best upper bound is up to 1.3 % above it (Fleming et al. 2009 Fig. 4.40). || Randolph & Houlsby (1984) 277.2 (ours +2.42 %); PLAXIS 3D's own errors vs R&H 0.7–1.3 %. Undrained (C) run as total-stress MC c = su, φ = ψ = 0, non-porous; rigid pipe = stiff plug under prescribed displacement (PLAXIS: rigid body, force control); interface tension cut-off off (R&H: no separation). P at u = 0.03 m: 303.63 / 300.29 / 286.87 / 270.34 / 251.30 — not yet a plateau for R < 1 (the soft t_v (t_v = the interface virtual thickness, m: K_n = E_oed,i / t_v, K_s = G_i / t_v, model/structures.rs) interface).
plaxis-verif-pipe-capacity-r0.4 — Pass · K3
Reference: Randolph & Houlsby (1984), p. 2 Eq. (1)
Case: cases/plaxis-verification-circular-pipe-laterally-loaded.json
Mesh: half model 45 × 17.5 m, pipe circle 96 chords on the half circle, 1367 T15, interface t_v 0.29 m
Reproduce: tests/k3_tutorials.rs plaxis_circular_pipe_laterally_loaded (ignored: about 9 min per R)
Notes: Re-run 12 Nov 2026 after the interface fix KB-3, same gate, written beforehand: plateau rise −0.040 %, +0.87 % against Eq. 1; normal stress ±35 kPa (was ±109). Faceting check on 48 chords (849 T15): 266.51 (+1.23 %; was 276.64, +5.08 %). For R < 1, Eq. 1 is a lower bound; the best upper bound is about 1.1 % above it at R 0.4 (Fleming et al. 2009 Fig. 4.40). Before the fix: 268.30 (+1.91 %). || Re-run 12 Nov 2026 with a gate written beforehand: a plateau (rise ≤ 0.2 % over the last quarter of the push) and ≤ 1.3 % against Eq. 1 (PLAXIS's own largest stated error). Interface shear is capped exactly at R·su. The remaining excess and creep come from the faceted interface: each chord uses its own normal, so slip at shared vertices creates spurious normal stress; doubling the chords (48 to 96) cut the R 0.4 excess from +5.1 % to +1.9 %. The rest is ordinary FE over-estimation. For R < 1, Eq. 1 is a lower bound; the best upper bound is up to 1.3 % above it (Fleming et al. 2009 Fig. 4.40). || Randolph & Houlsby (1984) 263.3 (ours +1.97 %); PLAXIS 3D's own errors vs R&H 0.7–1.3 %. Undrained (C) run as total-stress MC c = su, φ = ψ = 0, non-porous; rigid pipe = stiff plug under prescribed displacement (PLAXIS: rigid body, force control); interface tension cut-off off (R&H: no separation). P at u = 0.03 m: 303.63 / 300.29 / 286.87 / 270.34 / 251.30 — not yet a plateau for R < 1 (the soft t_v (t_v = the interface virtual thickness, m: K_n = E_oed,i / t_v, K_s = G_i / t_v, model/structures.rs) interface).
plaxis-verif-pipe-capacity-r0.2 — Pass · K3
Reference: Randolph & Houlsby (1984), p. 2 Eq. (1)
Case: cases/plaxis-verification-circular-pipe-laterally-loaded.json
Mesh: half model 45 × 17.5 m, pipe circle 96 chords on the half circle, 1367 T15, interface t_v 0.29 m
Reproduce: tests/k3_tutorials.rs plaxis_circular_pipe_laterally_loaded (ignored: about 9 min per R)
Notes: Re-run 13 Nov 2026 after the interface fix KB-3, same gate, written beforehand: plateau rise 0.000 % (≤ 0.2 %), +1.00 % against Eq. 1 (≤ 1.3 %); interface shear capped at R·su; normal stress ±34.12 kPa. Before the fix: 250.51 (+1.36 %). || Re-run 12 Nov 2026 with a gate written beforehand: a plateau (rise ≤ 0.2 % over the last quarter of the push) and ≤ 1.3 % against Eq. 1 (PLAXIS's own largest stated error). Interface shear is capped exactly at R·su. The remaining excess and creep come from the faceted interface: each chord uses its own normal, so slip at shared vertices creates spurious normal stress; doubling the chords (48 to 96) cut the R 0.4 excess from +5.1 % to +1.9 %. The rest is ordinary FE over-estimation. For R < 1, Eq. 1 is a lower bound; the best upper bound is up to 1.3 % above it (Fleming et al. 2009 Fig. 4.40). || Randolph & Houlsby (1984) 247.1 (ours +1.26 %); PLAXIS 3D's own errors vs R&H 0.7–1.3 %. Undrained (C) run as total-stress MC c = su, φ = ψ = 0, non-porous; rigid pipe = stiff plug under prescribed displacement (PLAXIS: rigid body, force control); interface tension cut-off off (R&H: no separation). P at u = 0.03 m: 303.63 / 300.29 / 286.87 / 270.34 / 251.30 — not yet a plateau for R < 1 (the soft t_v (t_v = the interface virtual thickness, m: K_n = E_oed,i / t_v, K_s = G_i / t_v, model/structures.rs) interface).
plaxis-verif-pipe-initial-stiffness — Pass · K3
Reference: Exact plane-strain solution for a rigid rough disk in an elastic ring fixed at R = 22.5 m (the finite-R form of Baguelin, Frank & Said 1977): 99 125 kN/m. The document’s Eq. (3) is the large-R form (101 005) and its printed 85 940 an evaluation slip
Case: cases/plaxis-verification-circular-pipe-laterally-loaded.json
Mesh: linear-elastic annulus, outer radius 22.5 m fixed, rigid rough disk, no interface; 1592 / 2354 / 6504 T15 agree to 0.0015 %
Reproduce: tests/k3_tutorials.rs plaxis_circular_pipe_initial_stiffness_ring (ignored: 14 s)
Notes: Re-done 12 Nov 2026. Reference is the exact plane-strain solution for a rigid rough disk in a ring fixed at R (derived by us in the Baguelin et al. 1977 form and checked symbolically): K = 99 125 kN/m. Gate written beforehand: ≤ 0.5 %. The document's 85 940 kN/m is an evaluation slip ([ln(R/r0)]² in place of ln((R/r0)²)); its Eq. 3 as printed gives 101 005. With the benchmark's R = 1 interface the stiffness is 91 324 to 94 770 kN/m depending on the interface thickness (reported, not gated). || Secant of the first accepted load step — step-size dependent (K2 solver's smaller first step: 87 222, +1.49 %; D80 solver: 83 981, −2.28 %): indicative only. Baguelin et al. (1977) assume a circular outer boundary R = 22.5 m; our box is 45 × 35 m (full); PLAXIS only plots the line.
ertc7-wall-moment — Deviation · K3
Case: cases/ertc7-benchmark-characteristic.json
Mesh: 696 T15, wall plate + two-sided interface (R = tan(2φ′/3)/tan φ′ = 0.637), t_v = 0.251 m
Reproduce: tests/k3_tutorials.rs ertc7_benchmark_characteristic (ignored: ~35 s)
Notes: Schweiger's PLAXIS (continuum wall 0.8 m + soft beam; pore pressures interpolated to the wall base) vs ours (plate; phreatic polyline stepping at the wall). TS oracle (staged subgrade reaction, staged-excavation-wall.ts computeMultiStageWall, δ = 2φ′/3, k_s 7 500…30 000): 194–186 kNm/m at 4.83 m (ours at 4.88 m). The 13 submissions span ≈ 70–360 (Fig. 3).
ertc7-strut-force — Deviation · K3
Case: cases/ertc7-benchmark-characteristic.json
Mesh: as above
Reproduce: tests/k3_tutorials.rs ertc7_benchmark_characteristic
Notes: TS oracle 120–123 kN/m. Submissions span 60–363 (Fig. 4).
ertc7-wall-base-displacement — Deviation · K3
Case: cases/ertc7-benchmark-characteristic.json
Mesh: as above
Reproduce: tests/k3_tutorials.rs ertc7_benchmark_characteristic
Notes: The toe movement is the most modelling-sensitive output: a plate (no wall thickness, no wall-toe bearing area) and no pore-pressure interpolation below the excavation; MC E constant with depth (as specified).
plaxis-2d-tut3 — Superseded · K5a (D94 fixed: phase 4 converges)
Case: cases/plaxis-2d-tutorial-03-submerged-excavation-k4.json
Mesh: 835 T15, half model x ∈ [0, 65]
Reproduce: tests/k4_tutorials.rs tutorial3_submerged_excavation_k4 (ignored: ~250 s; asserts initial + phases 1–3)
Superseded by: k5d-plaxis-2d-tut3-submerged-hs
Notes: Superseded: this run used Mohr-Coulomb in place of Hardening Soil and hand-applied pit water. The same tutorial with the real Hardening Soil and the pit water kept in the excavated clusters is k5d-plaxis-2d-tut3-submerged-hs, where every phase converges; that row is itself still a deviation against figure reads of the tutorial, so the difference is not closed, only moved to the better model. || Lead A (9 Nov 2026, Modal 2026-11-09T02-05-29): with the D124 default policy phase 5 still fails — strict 0.332, the PLAXIS criterion 0.606 ('not a tolerance stall'); the earlier 'completes at tol 1e-2' was the STRICT residual at tol 1e-2, not PLAXIS's criterion. Superseded by k5d-plaxis-2d-tut3-submerged-hs. || K5a: phase 4 now converges at tol 1e-8 (the pit-side wall interface kept dangling duplicated nodes at its slip limit — fixed: an interface is off when one of its sides has no active body, D94); strut force 943 kN per strut (ph. 4), 1 019 kN (ph. 5 partial); wall |M| 1 005 kNm/m. Phase 5 (10 → 0 m) stalls at ΣMstage 0.350 at tol 1e-8 and 1e-7 (non-associated MC Newton, D80; arc-length cannot continue), completes at the PLAXIS tolerance 1e-2. Ours softer than the figure (MC with E50 ≠ HS unloading stiffness). Substitutions as K4. K5d-2: real HS + water kept in the excavated clusters — every phase converges at tol 1e-8 (row k5d-plaxis-2d-tut3-submerged-hs); this K4 case keeps its hand-applied pit water (dryRegions).
k3-gate-cantilever — Pass · K3
Reference: PL³/3EI′ + PL/kGA (Timoshenko & Gere)
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs beam_on_supports_cantilever_and_two_span_continuous
Notes: T6 −6e-11 %, T15 −9e-12 %; root moment PL exact.
k3-gate-two-span — Pass · K3
Reference: qL²/8 / (1 + 3EI′/(kGA L²)) (Timoshenko two-span, shear deformable)
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs beam_on_supports_cantilever_and_two_span_continuous
Notes: Exact to 1e-6 relative (T6, T15).
k3-gate-circular-plate — Pass · K3
Reference: q a⁴ (5+ν)/(64 D (1+ν)) + q a²/(4 kGA) (Timoshenko & Woinowsky-Krieger §16 + Mindlin)
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs axisymmetric_simply_supported_circular_plate_under_uniform_load
Notes: T6 +0.0001 %, T15 −0.0000 % (16 plate elements): the axisymmetric hoop terms.
k3-gate-plastic-hinge — Pass · K3
Reference: 2 Mh/(L/2 − d) at the hinge Gauss points (d = node-to-point distance) → 4 Mh/L as h → 0; Mh = Mp (1 − |N|/Np)
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs elastoplastic_plate_hinge_collapse_load
Notes: Gauss-point |M| = Mh to 1e-9; T6 8 el 21.1156 (→ 20), T6 32 el 20.2677, T15 8 el 20.3533; with N: 15.8367 / 15.2650 (→ 15). PLAXIS likewise checks the stress points, not the nodes.
k3-gate-anchor-spring — Pass · K3
Reference: F Ls L / EA
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs anchor_springs_prestress_and_force_cap
Notes: Exact (1e-14). Prestress 100 kN/anchor matched exactly (50 kN/m) and an ordinary spring afterwards (N1 = 70, N2 = 40 exactly); Fmax cap: honest collapse at ΣMstage 0.6 = 60/100.
k3-gate-geogrid — Pass · K3
Reference: F L / EA
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs geogrid_tension_only_bar
Notes: Exact; in compression the parallel anchor carries all.
k3-gate-interface-patch — Pass · K3
Reference: R(c′L + tan φ′ N)
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs plaxis_sliding_block_interface
Notes: Also the elastic slip stiffness K_s = G_i/t_v (t_v = the interface virtual thickness, m: K_n = E_oed,i / t_v, K_s = G_i / t_v, model/structures.rs) (F/(K_s δ L) = 0.99986) and the gap (σn = σt = 0).
k3-gate-excavation-unloading — Pass · K3
Reference: γ h H / E_oed
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs excavation_unloading_one_dimensional
Notes: Exact (1e-12); the final stresses are the K0 field of the remaining column; base reaction = remaining weight.
k3-gate-plate-soil-compatibility — Pass · K3
Reference: the prescribed-displacement rough rigid footing (same mesh)
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs plate_soil_compatibility
Notes: Settlement uniform to 2e-5 δ; a vanishing plate changes u by 6e-11 relative. (EA = EI = 1e10 vs E = 1e4: the 1e-8 residual criterion falls below the factorisation's round-off floor — the phase stops honestly; conditioning limit.)
k3-gate-staged-wall-equilibrium — Pass · K3
Reference: statics
Case: tests/k3_structures.rs
Mesh: rect-mesh / domain, T6 and T15
Reproduce: tests/k3_structures.rs staged_excavation_wall_equilibrium_and_cache_resume
Notes: To 1e-6 relative every phase; strut ΔN = −k Δu after the prestress to 1e-9; resume from the cached state (JSON round trip incl. structural forces) bitwise identical to from-scratch (u, σ, structural forces, step path).
plaxis-2d-tut7-prestress-top — Pass · K3
Case: cases/plaxis-2d-tutorial-07-tie-back-wall-k3.json
Mesh: 627 T15 (Medium-like, walls refined 0.3, grouts 0.5), interfaces t_v = 0.52 m
Reproduce: tests/k3_tutorials.rs tutorial7_tie_back_wall_k3 (ignored: ~5.5 min)
Notes: 'the anchor force is indeed equal to the specified pre-stress force in the calculation phase they are activated' (p. 137); both walls exact.
plaxis-2d-tut7-prestress-bottom — Pass · K3
Case: cases/plaxis-2d-tutorial-07-tie-back-wall-k3.json
Mesh: 627 T15 (Medium-like, walls refined 0.3, grouts 0.5), interfaces t_v = 0.52 m
Reproduce: tests/k3_tutorials.rs tutorial7_tie_back_wall_k3 (ignored: ~5.5 min)
Notes: Both walls exact.
plaxis-2d-tut7-final — Superseded · K3
Case: cases/plaxis-2d-tutorial-07-tie-back-wall-k3.json
Mesh: 627 T15 (Medium-like, walls refined 0.3, grouts 0.5), interfaces t_v = 0.52 m
Reproduce: tests/k3_tutorials.rs tutorial7_tie_back_wall_k3 (ignored: ~5.5 min)
Superseded by: k5b-plaxis-2d-tut7-real-hs
Notes: Superseded: this run used Mohr-Coulomb in place of Hardening Soil and a geogrid in place of the grouted anchor. The tutorial runs with the real Hardening Soil in k5b-plaxis-2d-tut7-real-hs. The tutorial prints figures only for the final phase, so there was never a value to compare against. || No PLAXIS numbers to compare (figures only). Run with K3 substitutions: Hardening Soil → MC (E = E50,ref, ν = ν_ur, K0 = K0nc; HS is K5); grout embedded beam → geogrid EA = 199 905 kN/m (bonded, no skin limit); phase-6 steady flow (K4) → the drawn phreatic level used directly. Every phase converged. D80 solver: 102 s, phase 6 38 steps / 16 cuts (K2 solver: 326 s, 239 / 161; results within 0.2 %). Note: the tutorial is Tutorial 7 in the 2025.1 manual (Tutorial 3 is the submerged excavation).
plaxis-2d-tut7-final-k4-flow — Superseded · K4
Case: cases/plaxis-2d-tutorial-07-tie-back-wall-k4.json
Mesh: 627 T15 (Medium-like, walls refined 0.3, grouts 0.5), interfaces t_v = 0.52 m
Reproduce: tests/k4_tutorials.rs tutorial7_tie_back_wall_k4_steady_flow (ignored: ~34 s release)
Superseded by: k5b-plaxis-2d-tut7-real-hs
Notes: Superseded: this run used Mohr-Coulomb in place of Hardening Soil. The tutorial runs with the real Hardening Soil and the same steady flow in k5b-plaxis-2d-tut7-real-hs, which also lists these Mohr-Coulomb numbers for comparison. The tutorial prints figures only for the final phase, so there was never a value to compare against. || Re-runs the K3 deviation row with phase 6 as steady-state groundwater flow (pp. 133–134, Fig. 7–14: XMin/XMax open at head 23, YMin closed, ground surface + pit bottom seepage, wall interfaces active → impermeable). USDA vG (Ref. Manual Table 6–8, gl 0.5). Discharge 0.7156 m³/day/m in through each side, 1.4311 out of the pit bottom (balance 1e-6, asserted); phreatic y = 20.000 over the pit bottom, 22.6 m right behind the walls (the drawn K3 level falls to ≈ 20.2 there) → ≈ 2.4 m more head on the retained side: M +8 %, bottom anchors +2.7 %, top anchors −2 %. Wall displacement change (6.5 vs 10.2 mm at (40,27)) measured, not yet decomposed. K3 substitutions kept (HS → MC, grout → geogrid). Every phase converged; prestress exact. PLAXIS: figures only.
k5b-plaxis-2d-tut7-real-hs — Recorded, no published value · K5b
Case: cases/plaxis-2d-tutorial-07-tie-back-wall-k5b.json
Mesh: 627 T15 (as the K4 case)
Reproduce: tests/k5b_tutorials.rs tutorial7_tie_back_wall_hardening_soil (ignored: ~80 s release)
Notes: Recorded, no published value: the tutorial prints figures only for the final phase (Figs 7-16 to 7-22); only the prestress (500 / 1000 kN) is a number, and that is asserted exactly on rows plaxis-2d-tut7-prestress-top and -bottom. || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): anchors top [450.6, 445.3] → [450.6, 446.8], bottom [1060.2, 1055.9] → [1058.8, 1055.4]; Mmax [142.5, 146.0] → [141.9, 145.1]; ux(40,27) 20.39 → 17.15 mm (−15.9 %), ux(40,23) 19.65 → 17.06 mm (−13.2 %). Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (silt/loam primary loading, so the wall top moves less). Prestress exact (asserted); 627 elements, 99 s. Figures only in the tutorial: no PLAXIS number, no verdict. || Re-recorded 2026-10-26 at f4800ca0; moved from [450.8,445.4,1060.4,1056.1,142.3,145.9,20.42,19.68] by 0b17c13c (K5a solver seam: step-loop refactored into nonlinear::drive() with Anderson-accelerated initial-stiffness continuations; different step path → ≤0.2% drift in path-dependent plasticity; prestress exact). Every phase converges; prestress exact (asserted). The tutorial gives figures only — deviation = 'no PLAXIS number to compare'. Real HS (stress-dependent stiffness, Eur unloading) vs the K3/K4 MC substitute: wall moments −15 %, top anchors +7 %, wall top ux ×3 (soft HS primary loading of the silt/loam). Loam POP 25: the K0 interface stresses now use the same POP K0 as the continuum (the K0 phase was out of balance by 1.0e-3 before; now 3.7e-14).
k5d-plaxis-2d-tut3-submerged-hs — Deviation · K5d-2 (D90, D113 closed)
Case: cases/plaxis-2d-tutorial-03-submerged-excavation-k5d.json
Mesh: 835 T15, half model x ∈ [0, 65]
Reproduce: tests/k5d_tutorials.rs tutorial3_submerged_excavation_hardening_soil (ignored; ~4 min release)
Notes: 12 Nov 2026: the figure is now pixel-measured (±1 px = ±0.00015 m) instead of read by eye; the old phase-1 read was 24 % low. No written figure-read tolerance exists, so none is applied and the row stays a deviation. Ours are the 2 Nov values, not re-run. || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): |u|(50,10) phases 1–5: 0.0055/0.0229/0.0229/0.0601/0.1626 → 0.0054/0.0225/0.0225/0.0589/0.1519 m. CLOSER to the figure reads on phases 1, 4, 5 (+10.0 → +8.0 %, +5.4 → +3.3 %, +15.3 → +7.7 %); FURTHER on phases 2 and 3 (−4.6 → −6.3 %). Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (stiffer HS clay/sand primary loading: less movement in the loading phases; the phase-2/3 under-prediction grows). Strut per strut 978/2 041 → 957.2/1 936.9 kN (ph. 4/5), wall |M| 747/2 094 → 735.5/1 959.9 kNm/m (PLAXIS: figures only). Every phase converges at tol 1e-8 (phase 5: 14 steps / 2 cuts / 242 iterations); 835 T15, 105 s. Phase 5 deviation was +15 % and is now +8 %; phase 4 +5 % → +3 %. || Every phase converges at tol 1e-8, phase 5 included (D113: it stopped at ΣMstage 0.350 with the MC substitute and hand-applied pit loads). The pit water now presses on the pit bottom AND the wall's pit face automatically. Strut per strut 978 kN (ph. 4) / 2 041 kN (ph. 5); wall |M| 747 / 2 094 kNm/m (PLAXIS: figures only). Deviations are figure reads; phase 4 +5 %, phase 5 +15 %.
k5d-plaxis-2d-tut10-dewatering — Recorded, no published value · K5d-2 (wells, flow.tol)
Case: cases/plaxis-2d-tutorial-10-excavation-dewatering-k5d.json
Mesh: 693 T15
Reproduce: tests/k5d_tutorials.rs tutorial10_excavation_and_dewatering (ignored; ~2.5 min release)
Notes: Recorded, no published value: the tutorial prints figures only (Figs 10-4, 10-5). || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): final anchors [452.2, 448.1, 1050.2, 1048.0] → [453.0, 449.7, 1050.1, 1048.2] kN, wall max |M| [136.0, 139.0] → [135.1, 138.1] kNm/m. Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (HS primary-loading stiffness). Flow unchanged and re-measured identical (wells −0.9797, side inflow 0.9773, pit bottom 0.0, pit head 18.90–18.99 m, phreatic y 18.609–18.982 m). 126 s. Figures only: no verdict. || Runs end to end. The wells are head-limited (h_min reached at the well): 0.98 of the 1.5 m³/day/m each; the water table in the pit falls from 20 m (Tutorial 7, seepage at the pit bottom) to 18.6–19.0 m; the pit bottom no longer seeps. The phase-6 flow runs at flow.tol 1e-5: the dried (van Genuchten) pit stagnates near a relative residual 5e-6 (open issue K5d2-FLOW-UNSAT; PLAXIS tolerated error 0.01). No PLAXIS numbers: deviation = no number to compare.
k5d1-da-ec7-annex-a — Pass · K5d-1
Reference: EN 1997-1 Table A.4 (M2)
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 design_approach -- --nocapture
Notes: Exact arithmetic: every preset factor, φ_d = atan(tan φ / 1.25), c_d = c/1.25, load multiplier 1.3 on 'variable-unfavourable', unfactored favourable permanent loads; refusals: unknown label, factor ≤ 0, NGI-ADP under a design approach, a load label on a non-load.
k5d1-cable-winkler — Pass · K5d-1
Reference: Winkler bar closed form (the value is the test tolerance)
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 cable_pullout_elastic -- --nocapture
Notes: Reaction total ≈ 0 (1e-6 of N0).
k5d1-cable-plastic-bond — Pass · K5d-1
Reference: bond capacity c_bond·L/Ls (the value is the test tolerance)
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 cable_pullout_plastic -- --nocapture
Notes: Plastic bond reached along the whole bar.
k5d1-embedded-beam-axial — Pass · K5d-1
Reference: axial bar on a Winkler skin spring with a base spring (closed form; the value is the test tolerance)
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 embedded_beam_axial -- --nocapture
Notes: Push 3.08e-6, pull 3.28e-6; base force 4.7566 kN = closed form (push), 0 under pull (tension-free); R_s / R_N / K_F defaults from the ISF Eqs. 6-65…6-67 exact.
k5d1-embedded-beam-lateral — Pass · K5d-1
Reference: Hetényi beam on an elastic foundation (the value is the test tolerance)
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 embedded_beam_lateral -- --nocapture
Notes: kGA = 5EA/12 (Timoshenko, ν = 0) — recorded choice.
k5d1-beta-method-cc — Pass · K5d-1
Reference: u = d·σ0 R (1 + ν)/E (Kirsch, released fraction d); lined: CC with a ring of stiffness EA/R
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 beta_method -- --nocapture
Notes: Lined u 8.933181e-3 vs 8.928571e-3 (+0.05 %); hoop N −285.64 vs −p_s R −285.71 kN/m (−0.03 %); the support is retained at d and released by the next level.
k5d1-plaxis-2d-tut8-safety-sls — Pass · K5d-1
Case: cases/plaxis-2d-tutorial-08-tie-back-wall-uls-k5d-mc.json
Mesh: 627 T15 (as Tutorial 7 K4)
Reproduce: tests/k5d1_tutorials.rs tutorial8_tie_back_wall_uls_design_approach (ignored: ~7.7 min release, both variants)
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): Mohr–Coulomb substitute (soils are MC in this case file): re-run on the doc-375 tree, value UNCHANGED (SLS 1.4828, ULS 1.1813, ratio 1.255; the HS fix does not touch this variant). || ALG-1 (kernel/alg1, 23 Oct): re-run unchanged (the D114 rule did not fire: mechanism developed). K4 Mohr–Coulomb substitution of the HS soils (HS Safety is K5d-2). PLAXIS value is a figure read (±0.01).
k5d1-plaxis-2d-tut8-safety-uls — Pass · K5d-1
Case: cases/plaxis-2d-tutorial-08-tie-back-wall-uls-k5d-mc.json
Mesh: 627 T15
Reproduce: tests/k5d1_tutorials.rs tutorial8_tie_back_wall_uls_design_approach
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): Mohr–Coulomb substitute (soils are MC in this case file): re-run on the doc-375 tree, value UNCHANGED (SLS 1.4828, ULS 1.1813, ratio 1.255; the HS fix does not touch this variant). || Ratio SLS/ULS 1.255 (the M2 factor 1.25 on tan φ′, c′ — as expected when the design state is near the characteristic one). K4 MC substitution.
k5d1-plaxis-2d-tut8-uls-displacement — Deviation · K5d-1
Case: cases/plaxis-2d-tutorial-08-tie-back-wall-uls-k5d.json
Mesh: 627 T15
Reproduce: tests/k5d1_tutorials.rs tutorial8_tie_back_wall_uls_design_approach
Notes: Lead A re-record (9 Nov 2026, prog-a-tut, Modal 2026-11-09T05-13-14 probe_case, 504 T15 after the D557 mesh change; the 0.0705 below was 627 elements): |u|(40,27) SLS phase 6 0.01834 m (PLAXIS 0.0180, +1.9 %), ULS phase 12 0.06901 m vs PLAXIS 0.0518 (now pixel-measured from the raster Fig. 8-5, was an eye read 0.052): +33 %. Cause isolated by the prog-a-t8 lane (variants measured: not the load factor, ψ, c, interfaces-per-RM p. 246, HS stiffness internals or grout; Safety capacity matches: ΣMsf 1.493 / 1.191 vs Fig 8-6 1.49 / 1.186). The older reading 'general softness under reduced strength' is WITHDRAWN: our HS Safety curves are 15–40 % stiffer than Fig. 8-6; the MC variant's softness came from E50 vs PLAXIS's frozen start-state stiffness (RM §7.4.5). || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): |u|(40,27) ULS 0.0837 → 0.0705 m: +61.0 % → +35.6 % vs PLAXIS ≈ 0.052 m (CLOSER, still a deviation). Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (the HS soils around the wall are stiffer in primary loading; the K4 MC variant is unchanged, 0.0841 m). Also moved: SLS phase 6 |u| 0.0222 → 0.0183 m (PLAXIS ≈ 0.018: +23 % → +1.7 %); anchors SLS 450.6/1060.2 → 450.6/1058.8, ULS 478.8/1114.2 → 469.9/1105.0 kN; wall max |M| SLS 142.5 → 141.9, ULS 235.5 → 222.9 kNm/m. 195 s (HS), 627 elements. The 'GENERAL SOFTNESS under reduced strength' reading of the note below is weaker now (the ULS excess dropped by a third) but the Safety-path comparison in the old note belongs to the MC variant and is unchanged. || ALG-1 (kernel/alg1, 23 Oct): T8 probe (doc 71 item 3, MC case): the phase-6 Safety (reset displacements) reaches |u|(40,27) = 0.0777 m at ΣMsf 1.25 (0.0271 at 1.125, 0.0537 at 1.20) vs PLAXIS Fig. 8-6 ≈ 0.03–0.035 m — ×2.2–2.6, the same softness as the DA3 ULS path (0.0837 at factor 1.25). Indicates GENERAL SOFTNESS under reduced strength (shared by Safety and the design approach), not the design-approach start-up. Every ULS phase converges (ΣMstage = 1) as in PLAXIS. SLS phase 6 0.0222 m vs ≈ 0.018 (figure read, +23 %); ULS 12 0.0837 vs ≈ 0.052 m. Anchors SLS 450.6 / 1060.2 → ULS 478.8 / 1114.2 kN; wall max |M| 142.5 → 235.5 kNm/m. K4 MC variant: 0.0184 → 0.0841 m. The HS cap is kept from the characteristic parameters (PLAXIS factors only strength). OPEN (K5d1-T8-ULS-U): the ULS displacement is ~60 % above the figure read; the SLS part already differs from the Tutorial 7 figures (K5b row); suspected: the HS phase-12 plastic zone behind the wall with ψ capped, figure-read uncertainty.
k5d1-mesher-crossing-structures — Pass · K5d-1
Reference: the domain area
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 mesher_keeps_faces_closed_by_crossing_structure_lines
Notes: Defect found by T4 and fixed (K5d1-MESH-FACE): a face bounded only by sub-pieces of crossed structure lines received no region seed and was silently dropped (96.93 of 100 m² before the fix; in T4 the wedge between cableBot, the fault and the face, so cableBot lost its head segment). Every crossed structure segment now seeds each sub-piece; meshes without crossings are unchanged (mesh parity 108/108 TS x86-64 ⇄ Rust).
Closed-form engine registry — 3 published problems
| Row | Problem | Source | Reference | Ours | Δ | Tolerance (why) | Status |
DC-STRUT-DGEC3-6.7 | Steel strut flexural buckling — Designers’ Guide EC3 Ex. 6.7, N_b,Rd CHS 244.5×10 S355, A 7370 mm², I 50.73e6 mm⁴ (i = √(I/A)), pinned L_cr 4 m, curve a (α 0.21); γ_M1 = 1.00 (EN 1993-1-1 §6.1 NOTE 2B), E = 210 000 MPa (§3.2.6) | Gardner, L. & Nethercot, D.A., Designers' Guide to Eurocode 3: EN 1993-1-1 (Thomas Telford), Ex. 6.7 (CHS 244.5×10 S355, pinned L 4 m) — the book is not in the library; the previous file pointer named DD ENV 1993-1-1:1992, which does not contain this example (corrected in our defect log) — Example 6.7 | 2297 kN N_b,Rd = χ·A·f_y/γ_M1 | 2296.79 | −9.2e-3 % | ± 0.1 % Designers' Guide prints N_b,Rd to 4 significant figures (2297 kN) | Pass |
DC-GEOGRID-GEC11-E1-GG1 | Geogrid long-term design strength — GEC-11 Vol II Ex. E1 Table E1-7.3, GG-I, T_r = φ·T_al·R_c GG-I geogrid: T_ult 3000 lb/ft, RF_ID 1.3, RF_CR 1.85, RF_D 1.15; φ 0.90 (GEC-11 2009 Table 4-7, simplified method, static); R_c = 1 (continuous); γ_F = 1 (T_MAX already factored) | Berg, Christopher & Samtani (2009) FHWA-NHI-10-024/-025 GEC-11 MSE Walls and RSS Vol I/II — Vol II Ex. E1 §7.6 Table E1-7.3 (GG-I) | 976 lb/ft T_r = 0.90·T_al (T_al = 1085 printed) | 976.227 | +0.02 % | ± 0.1 % GEC-11 Table E1-7.3 prints T_al / T_r to 4 significant figures | Pass |
DC-ANCHOR-GEC4-EX1-BOND | Ground anchor grout–ground bond — GEC-4 Appendix A Example 1, allowable bond at L = 12 m soil anchor, load-transfer rate 100 kN/m, FS 2.0 (GEC-4 §5.3.6), fixed length 12 m; PTI DC35.1; tendon 32-mm Grade 150 bar (A 806 mm², f_pk 1035 MPa) | Sabatini, Pass & Bachus (1999) FHWA-IF-99-015 GEC-4 Ground Anchors and Anchored Systems — Appendix A Example 1 (soil, medium-dense silty sand), p. A-8/A-9 | 600 kN allowable bond = (100/2.0)·12 | 600 | 0.00 % | ± 0.5 % GEC-4 Example 1 prints the bond strength as a rounded hand value (600 kN) | Pass |
Cited validation suites — 35
as4678-factors-web-validation.test.ts
AS 4678—2002 partial-factor system — anchored to the standard.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
AS 4678—2002 partial-factor system — anchored to the standard.
SOURCE
AS 4678—2002 (incorporating Amendment Nos 1 and 2), "Earth-retaining structures",
Australian Standard, prepared by Committee CE-032 (Reinforced Soils and Retaining
Structures), approved 16 November 2001, published 26 February 2002.
Table 1.1 structure classification
Table 4.1 minimum live load (kPa)
§5.1 design resistance R* = characteristic strengths × Φr × Φu × Φn
§5.2.1 c* = Φuc · c
§5.2.2 tan φ* = Φuφ · tan φ
Table 5.1(A) soil uncertainty factors on PEAK c′ and φ′ (effective stress)
Table 5.1(B) the same for an undrained analysis (cu, Φu)
Table 5.2 structure classification design factor Φn
WHY THIS EXISTS
The 2026-08 audit measured the product's standards balance and found **AS/NZS coverage of
exactly zero** — no Australian or New Zealand standard cited or implemented anywhere,
against 108 IS/IRC and 99 US citations on the rendered capabilities page. This closes an
entirely empty standard family, and is the Australian counterpart to the EN 1997-1 Annex A
factors in `eurocode7-factors.ts`.
═══════════ THE TRAP THIS SUITE EXISTS TO PIN ═══════════
AS 4678's classification letters run OPPOSITE to nearly every other system. Table 1.1:
C — "Where failure would result in significant damage or risk to life"
B — "Where failure would result in moderate damage and loss of services"
A — "Where failure would result in minimal damage and loss of access"
So C is the MOST critical and A the LEAST — the reverse of EN 1998-1 importance classes and
ASCE 7 risk categories. Table 5.2 is consistent once that is known (Φn = 0.9 for C, 1.1 for
A, applied to the RESISTANCE per §5.1). Assuming A is most critical applies 1.1 where 0.9
belongs — a 22 % over-estimate of design resistance on exactly the structures where failure
risks life. Asserted below so it cannot be "tidied up" into the conventional ordering.
| Test block (the published value it checks) | Verdict |
| AS 4678 Table 1.1: C is the MOST critical class and A the LEAST — the reverse of EC8/ASCE | Pass |
| AS 4678 Table 5.2: Φn = 0.9 (C), 1.0 (B), 1.1 (A) at ULS; all 1.0 at SLS | Pass |
| AS 4678: choosing class A emits the caution, because the letter reads like the opposite | Pass |
| AS 4678 Table 5.1(A): every published Φuφ and Φuc reproduced (16 values) | Pass |
| AS 4678 Table 5.1(A) internal ordering: better fill ⇒ higher factor, SLS ≥ ULS | Pass |
| AS 4678 Table 5.1(B): Φuφ = 0.0 in EVERY column — undrained credits no friction | Pass |
| AS 4678 §5.2: an undrained analysis returns φ* = 0 and factors cu only | Pass |
| AS 4678 §5.2.1 and §5.2.2: c* = Φuc·c and tan φ* = Φuφ·tan φ | Pass |
| AS 4678 vs EN 1997-1: the conventions are RECIPROCAL, and that is asserted | Pass |
| AS 4678 Table 4.1: minimum live loads 1.5 / 2.5 (class A) and 2.5 / 5 (classes B, C) | Pass |
| the design soil is never non-finite, negative or stronger than characteristic | Pass |
| the citations name the standard, its amendments and the companion AS 1170 parts | Pass |
⚑ basal-heave-web-validation.test.ts
BASAL-HEAVE — web-validation benchmark against published worked examples and tables.
Analyses validated: basal-heave · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
BASAL-HEAVE — web-validation benchmark against published worked examples and tables.
`basal-heave.ts` is the undrained (φ = 0) base-stability check of a braced excavation in clay:
Bjerrum & Eide (1956) FS = Nc·su/(γH + q) with Skempton's depth/shape factor Nc, and Terzaghi (1943)
FS = 5.7·su/(γH + q − su·H/B′), B′ = B/√2.
SOURCES (each opened; locator next to every value):
1. NAVFAC DM-7.2 (1982), "Foundations and Earth Structures", Figure 28 "Stability of Base for Braced
Cut" (printed p. 7.2-104) and Figure 30 "Example of Analysis of Pressures on Flexible Wall of
Narrow Cut in Clay — Undrained Conditions" (printed p. 7.2-107): a complete worked example
(c = 400 psf, γ = 120 pcf, H = 20 ft, B = 12 ft, L = 80 ft) with every intermediate printed.
Table 6 of §7 (suggested minimum factors of safety): bottom heave 1.5. Values were read from the
rendered page images (pdf pages 121 and 124), not from OCR.
2. Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill, Table 14-1 "Bearing
capacity factor N′c for square and circular bases and for strip bases" (printed p. 813; read from
the page image), the tabulation of Skempton (1951).
3. Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012), Example 22.1
"Excavation in clay" (printed p. 417): c = 20 kPa, γ = 18 kN/m³, Nc = 7 from Skempton's curve
for H/B = 2, FS = 1.94. NOTE the example's own inconsistency: its statement says a 3 m deep cut
but its working uses H = 4.0 m throughout (H/B = 4.0/2.0, γH = 18 × 4 = 72); the working, which
is what is printed as the answer, is reproduced here.
4. Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage, §15.7 "Bottom Heave of a
Cut in Clay" (printed p. 798-800): Eq. 15.16 (Nc = 5.7 for Terzaghi's rough base), Eq. 15.17/15.18
(FS = cNc / (γH + q − cH/B′)), "a factor of safety of about 1.5 is recommended".
5. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon, §11.9 "Basal heave"
(printed p. 453): Terzaghi's block, the length ab = (B/2)/cos 45° "approximately 0.7B".
TOLERANCES, each from the source's own rounding:
- NAVFAC prints Nc to 2 significant figures (6.9, 7.1) → ±0.05; FS to 3 s.f. (1.18) → ±0.005.
- Bowles Table 14-1 prints N′c to 2 s.f. (one decimal; 5.14 for the strip at D/B = 0) → ±0.05.
- Varghese reads Nc off Skempton's curve to the INTEGER (7), so ±0.5; FS carries that uncertainty
(FS = c·Nc/(γH), ±0.5·c/(γH) = ±0.14).
- Craig's 0.7 is "approximately" B/√2 = 0.7071 B → 1 %.
KNOWN DEVIATION (recorded, NOT asserted away). `skemptonNc` is a closed-form fit to Skempton's chart,
Nc = min(5.14(1 + 0.2 D/B), 7.5)·(1 + 0.2 B/L). Against Bowles Table 14-1 it agrees exactly at the
end-points (D/B = 0 and D/B ≥ 4), but between them it is LOWER than the table by up to 9.1 % (strip,
D/B = 0.75) and 4.4 % (square, D/B = 0.5) — i.e. conservative in the usual excavation range — and
HIGHER by up to 5.9 % (square, D/B = 2.5). Those rows are therefore not asserted here; replacing the
fit by interpolation of the table would change saved results and the hand-derived tests in
`basal-heave.test.ts`, so it is left for the founder's decision (see the validation report).
| Test block (the published value it checks) | Verdict |
| NAVFAC DM-7.2 Fig. 30 — strip and rectangular Nc at H/B = 1.67, B/L = 0.15 | Pass |
| NAVFAC DM-7.2 Fig. 30 — driving and resisting pressure, factor of safety, verdict | Pass |
| Bowles 5e Table 14-1 (p. 813) — strip N′c at D/B = 0, 4.0 and 5.0 | Pass |
| Bowles 5e Table 14-1 (p. 813) — square/circular N′c (Skempton column) at D/B = 0, 4.0 and 5.0 | Pass |
| Varghese Ex. 22.1 (p. 417) — Skempton Nc, bearing capacity, overburden, FS | Pass |
| Das 8e Eq. 15.16 / Craig §11.9 — Terzaghi branch constants: Nc = 5.7 and B′ ≈ 0.7B | Pass |
| Das §15.7 (p. 800) and NAVFAC Table 6 — the recommended base-heave factor of safety is 1.5 | Pass |
⚑ braced-excavation-web-validation.test.ts
`braced-excavation` — anchored to NAVFAC DM-7.02 Figures 26 and 27.
Analyses validated: braced-excavation · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`braced-excavation` — anchored to NAVFAC DM-7.02 Figures 26 and 27.
SOURCE
NAVFAC DM-7.02, "Foundations and Earth Structures", Design Manual 7.02,
Chapter 3 Section 4 "Braced Excavations":
FIGURE 26 "Pressure Distribution for Brace Loads in Internally Braced Flexible Walls"
(a) SAND — σh = 0.65·KA·γH, where KA = tan²(45 − φ/2)
(b) SOFT TO MEDIUM CLAY (N₀ > 6) — "For clays base the selection on
N₀ = γH/c"; σh = KA·γH; KA = 1 − m·(4c/γH); "m = 1 except where cut
is underlain by deep soft normally consolidated clay, then m = 0.4";
trapezoid over 0.75H
(c) STIFF CLAY (N₀ < 4) — σh1 = 0.2·γH, σh2 = 0.4·γH; "Use lower value when
movements are minimal and short construction period"; 0.25H / 0.50H
"For 4 < N₀ < 6, use larger of diagrams (b) and (c)"
"ASSUME HINGES AT STRUT LOCATIONS FOR CALCULATING STRUT FORCES"
"See Figure 28 for Factor of Safety against bottom instability (FSB): 1 ≤ FSB ≤ 1.5"
FIGURE 27 "Design Criteria for Braced Flexible Walls"
"REACTION AT BRACES COMPUTED ASSUMING SIMPLE SPAN BETWEEN BRACES"
"FOR TEMPORARY CONSTRUCTION CONDITIONS, APPLY FACTOR OF SAFETY OF 1.5 TO
COMPUTED PASSIVE PRESSURES"
Peck, R.B. (1969) "Deep excavations and tunneling in soft ground", 7th ICSMFE — the
empirical basis for the envelopes.
A NOTE ON THE SOURCE'S CONDITION
DM-7.02 is a scanned document with a degraded text layer (it renders "S t a b i l i t y" and
"KA = I - m - 4 C ; / YH"). Figure 26's numbers ARE recoverable and are transcribed above,
but one value is not: Figure 27's note 3 reads "INCREASE LOAD ON UPPER WALE AND BRACE BY
ISO/'OF COMPUTED VALUE" — almost certainly 15 %, but the OCR cannot settle it. It is
therefore **not asserted anywhere in this suite**. Guessing it would put a fabricated load
factor into a strut design.
DEFECTS FOUND
E-48 (P2, unsafe direction) — Figure 26(b)'s **m factor was absent**, so m = 1 was applied
unconditionally. Because m multiplies the SUBTRACTED term in KA = 1 − m·(4c/γH), the
m = 0.4 case (cut underlain by deep soft normally consolidated clay) gives a LARGER KA and a
HIGHER apparent pressure. At γH = 180 kPa and cu = 20 kPa the engine reported 100 kPa where
Figure 26(b) requires 148 kPa — a 1.48× under-prediction of the strut loads.
E-49 (P3) — the stiff-clay envelope was hardcoded at 0.3·γH. Figure 26(c) gives a 0.2–0.4·γH
band and makes the choice a designer judgement ("use lower value when movements are minimal
and short construction period"). Related: Figure 26(c)'s "for 4 < N₀ < 6, use larger of
diagrams (b) and (c)" was satisfied only implicitly, via the 0.3·γH floor, so it held at the
midpoint ratio and nowhere else.
| Test block (the published value it checks) | Verdict |
| NAVFAC Fig. 26(a): sand σh = 0.65·KA·γH with KA = tan²(45 − φ/2) | Pass |
| NAVFAC Fig. 26(b): σh = γH − 4·m·c, and N₀ = γH/c is the selection basis | Pass |
| E-48: m = 0.4 where the cut is underlain by deep soft NC clay — a 1.48× increase | Pass |
| NAVFAC Fig. 26(c): stiff clay σh spans 0.2·γH to 0.4·γH, selectable | Pass |
| E-49: a ratio outside Figure 26(c)’s 0.2–0.4 band is flagged as unsupported | Pass |
| NAVFAC Fig. 26(c): for 4 < N₀ < 6 the LARGER of diagrams (b) and (c) is used | Pass |
| NAVFAC Figs. 26 & 27: strut forces from hinges at strut locations / simple span between braces | Pass |
| strut spacing converts kN/m to kN per strut linearly | Pass |
| NAVFAC Fig. 26 note: the bottom-instability FoS band is 1 ≤ FSB ≤ 1.5 | Pass |
| the governing figures are cited, and the OCR-ambiguous value is NOT asserted anywhere | Pass |
| every numeric output is finite, and a cut with no struts is refused | Pass |
⚑ building-damage-assessment-web-validation.test.ts
Dedicated validation for the building-damage engine (`building-damage-assessment.ts`): the Burland & Wroth (1974) equivalent-beam deflection-ratio + horizontal-strain method with Boscardin & Cording (1989) damage categories, as codified by…
Analyses validated: building-damage-assessment · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the building-damage engine (`building-damage-assessment.ts`):
the Burland & Wroth (1974) equivalent-beam deflection-ratio + horizontal-strain method
with Boscardin & Cording (1989) damage categories, as codified by Mair, Taylor &
Burland (1996).
PUBLISHED SOURCES (each opened/read; verbatim numbers in SOURCES-DAMAGE.md):
1. Boscardin & Cording (1989) Table 2 — limiting tensile strain damage categories:
0: 0–0.05 %, 1: 0.05–0.075 %, 2: 0.075–0.15 %, 3: 0.15–0.3 %, 4–5: > 0.3 %
(verbatim from Burland UPC-2008 Table 2; Mair & Taylor 1997 Table 3; ITA/AITES Table 2).
2. Mair, Taylor & Burland (1996) eqs 7-10 — the equivalent-beam deflection-ratio
strain equations and the horizontal-strain superposition (ν = 0.3).
3. Burland & Wroth (1974) / Burland (1995) — E/G = 2.6 masonry, 12.5 framed RC;
L/H = 1.5 threshold between diagonal- and bending-dominated response.
4. Rankin (1988) / M-T-B (1996) §5.2 — θ < 1/500 and settlement < 10 mm → negligible.
5. Cording et al. (2008, UPC) Evanston worked example — numeric angular-distortion
and lateral-strain values for a real building.
WHAT IS ASSERTED. The Boscardin & Cording category boundaries are printed numbers, so
`damageCategory` is asserted exactly at every printed bound. The beam equations are
closed forms printed as M-T-B eqs 7-10; they are asserted exactly (the "exact closed
forms count" case of the job brief) by constructing a Gaussian settlement profile whose
deflection ratio is known analytically, and checking the returned strains against the
printed equations. The Rankin screen and the L/H regime are printed thresholds, asserted
exactly. The Cording Evanston example is a real printed building response.
NOT ASSERTED (recorded, not hidden): no complete published worked example prints the
full chain (trough → Δ/L → εbt/εdt → category) for a single building with every
intermediate — the M-T-B 1996, CIRIA and Franzius examples are either qualitative
(Mansion House, B.11) or behind paywalls (COULD NOT OBTAIN, SOURCES-DAMAGE §426-436).
The beam equations are therefore validated as exact closed forms against the printed
equations, and the category boundaries against the printed Boscardin & Cording table.
| Test block (the published value it checks) | Verdict |
| Boscardin & Cording (1989) Table 2: damage category vs limiting tensile strain | Pass |
| Rankin (1988): settlement < 10 mm and slope < 1/500 → screened out, category 0 | Pass |
| Rankin screen does NOT apply above 10 mm | Pass |
| Sagging beam: Δ/L → εb, εd, εbt, εdt reproduce M-T-B (1996) eqs 7-10 exactly | Pass |
| Hogging beam: a building offset past the inflection point hogs (I = H³/3, t = H) | Pass |
| E/G = 12.5 framed RC raises the shear stiffness and lowers the diagonal strain (M-T-B §4.5) | Pass |
| L/H regime warning: diagonal dominates for L/H < 1.5, bending for L/H > 1.5 | Pass |
| Building length capped at 2.5i (M-T-B 1996 §4.1) | Pass |
| Cording et al. (2008) Evanston South Wing: angular distortion 2.7e-3, lateral strain 2.5e-3 | Pass |
| Input validation: L, H, i, profile errors | Pass |
⚑ concrete-durability-web-validation.test.ts
Dedicated validation for the concrete durability classification (`concrete-durability.ts`): the IS 456:2000 Table 4 sulphate exposure class from soil SO3 (%) and groundwater SO4 (g/L), the cement type, minimum cement content and maximum fr…
Analyses validated: concrete-durability · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the concrete durability classification (`concrete-durability.ts`): the IS 456:2000
Table 4 sulphate exposure class from soil SO3 (%) and groundwater SO4 (g/L), the cement type, minimum cement
content and maximum free water-cement ratio of that class, the Table 16 / clause 26.4.2.2 cover, and the
pH 6-9 scope of Table 4.
PUBLISHED SOURCES (each opened and read for this suite):
1. IS 456:2000, Plain and Reinforced Concrete - Code of Practice (Fourth Revision), library copy read from the
rendered page images: Table 4 "Requirements for Concrete Exposed to Sulphate Attack" (page 19 of the Code:
five classes with SO3 % in soil, SO3 g/L in a 2:1 water:soil extract, SO4 g/L in groundwater, cement type,
minimum cement content kg/m³ and maximum free water-cement ratio, with Notes 3-4); Table 16 "Nominal
Cover to Meet Durability Requirements" (Mild 20, Moderate 30, Severe 45, Very severe 50, Extreme 75 mm);
clause 26.4.2.2 "For footings minimum cover shall be 50 mm"; clause 8.2.2.4 (Table 4 applies to near-neutral
groundwater of pH 6 to 9).
2. Prasad, S. (date not printed), "A Study of New IS 456:2000 vis-a-vis the 1978 edition", Structural Engineers
Forum of India web document, https://www.sefindia.org/forum/files/is456_2000_nd_1978_980.pdf, read
2026-10-06: restates the Table 16 covers (20, 30, 45, 50, 75 mm) and "for footings the minimum cover is
recommended to be 50 mm". This is a secondary summary of the same Code, NOT an independent derivation, and
it carries no printed year, so none is claimed for it.
HONEST LIMIT OF THIS EVIDENCE. The engine is a lookup of one Indian Code table. Both sources above describe
that same Code, so this suite proves the engine reproduces every published entry of Table 4 and the Table 16
covers, including the class boundaries, but it is one source's evidence, not two independent ones. No other
published source reproduces these particular values in a form I could open (the Canadian CSA and American
ACI sulphate classes use different thresholds and are not comparable).
NOT ASSERTED. (a) The engine's exposure CATEGORY labels (class 1 "Mild" ... class 4 "Very Severe") are its own
mapping; Table 3 of the Code assigns concrete buried in non-aggressive ground to "Moderate" and in aggressive
ground to "Very severe", so the labels are not asserted as published values. (b) The "aggressive groundwater"
trigger (pH < 6 or chloride > 2000 mg/L): pH 6 is the Code's Table 4 scope, but 2000 mg/L is the Code's
mixing-water chloride limit for plain concrete (clause 5.4), used here as an exposure heuristic; the Code has
no exposure criterion for groundwater chloride, so it is not asserted.
| Test block (the published value it checks) | Verdict |
| IS 456:2000 Table 4: sulphate class from total SO3 in soil (% by mass), interior of each printed band | Pass |
| IS 456:2000 Table 4: sulphate class from SO4 in groundwater (g/L), interior of each printed band | Pass |
| IS 456:2000 Table 4: the printed open/closed ends of the bands | Pass |
| IS 456:2000 Table 4: minimum cement content (kg/m³) per class | Pass |
| IS 456:2000 Table 4: maximum free water-cement ratio per class | Pass |
| IS 456:2000 Table 4 class 3: Portland pozzolana / slag cement have their own, stricter row (350 kg/m³, w/c 0.45) | Pass |
| IS 456:2000 Table 16 and cl 26.4.2.2: cover is max(50 mm footing floor, Table 16) for every class | Pass |
| IS 456:2000 Table 16: Extreme exposure 75 mm; Very severe is 50 mm (not more) for a footing | Pass |
| IS 456:2000 cl 8.2.2.4 / Table 4 Note 3: pH scope warnings | Pass |
contiguous-pile-wall-web-validation.test.ts
Web-benchmark validation for `contiguous-pile-wall`.
Analyses validated: contiguous-pile-wall · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `contiguous-pile-wall`.
SOURCES:
Rankine — Ka = tan²(45° − φ/2), Kp = tan²(45° + φ/2).
Coulomb (1776) / IS 14458 (Part 2):1997 Cl 5.2 — wall friction δ.
EN 1997-1:2004 §9.7 / Bowles 5e §11-5 — effective stress with γ′ = γ_sat − γ_w below the
water table, plus the hydrostatic thrust added separately.
IS 456:2000 Annex G G-1.1.b (M_u,lim = 0.138·f_ck·b·d²), G-1.2 (A_st = M_u/(0.87·f_y·0.9·d)),
Table 16 (75 mm cover), Cl 26.5.3 (0.4 % minimum steel).
Bjerrum & Eide (1956) Géotechnique 6(1) 32-47 — basal-heave Nc ≈ 5.7 + 0.39·(H/B), ≤ 9.
CIRIA C760 (2017) §6.2, §8.1 — embedded walls; deflection band 0.001–0.005·H.
The earth-pressure coefficients are exact trigonometric identities and are asserted to
machine precision; the rest reconstructs its chain in code (batch 7t method note).
| Test block (the published value it checks) | Verdict |
| the active pressure at the dredge line is Rankine Ka·σv, with the surcharge included | Pass |
| Rankine Ka and Kp are reciprocal, and cohesion relieves the ACTIVE side | Pass |
| wall friction δ reduces the horizontal active thrust (Coulomb, δ = 0 → Rankine) | Pass |
| below the water table the engine uses γ′ = γ_sat − γ_w and adds hydrostatic thrust | Pass |
| omitting γ_sat below the water table is flagged rather than assumed silently | Pass |
| the moment capacity is IS 456 Annex G M_lim = 0.138·f_ck·D·d_eff² | Pass |
| steel area follows A_st = M_u/(0.87·f_y·0.9·d_eff) with the IS 456 0.4 % floor | Pass |
| per-pile actions scale with the pile spacing (tributary width) | Pass |
| basal-heave Nc follows Bjerrum & Eide 5.7 + 0.39·(H/B), capped at 9 | Pass |
| a low basal-heave FoS fails the wall, and a frictional soil withholds the check | Pass |
| the deflection estimate sits in the CIRIA C760 §8.1 band 0.001–0.005·H | Pass |
| invalid inputs are refused with a zeroed result, including the E-9 f_y guard | Pass |
⚑ deadman-anchor-web-validation.test.ts
DEADMAN-ANCHOR — web-validation benchmark against published coefficient tables and a worked example.
Analyses validated: deadman-anchor · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
DEADMAN-ANCHOR — web-validation benchmark against published coefficient tables and a worked example.
`deadman-anchor.ts` sizes a continuous deadman (block anchor) by the Rankine passive-minus-active
resultant on its two faces, T_ult = ½·γ·(Kp − Ka)·(z_b² − z_t²) per metre run, Ka = tan²(45 − φ/2),
Kp = tan²(45 + φ/2).
SOURCES (each opened; locator next to every value):
1. Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill, Table 11-3 "Rankine
active earth pressure coefficients Ka" and Table 11-4 "Rankine passive earth pressure coefficients Kp"
(printed p. 603), β = 0 row, φ = 26°…42°: tabulated to 4 d.p. Read from the rendered page image
(pdf page 632). Also Example 13-7 "Design a concrete anchorage" (§13-8, printed p. 779), a worked
block-anchor design by the average-pressure form Pp′ = L·σp,av·H.
2. Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage, Table 12.1 "Variation of
Ka(R)" (printed p. 608), the α = 0°, θ = 0° row (vertical back, level ground, i.e. Rankine): φ′ =
28°…40°, tabulated to 3 d.p.
MAPPING OF BOWLES EXAMPLE 13-7 TO THE ENGINE. Bowles places a 0.6 m high block with its top 1.2 m and
bottom 1.8 m below the surface, under a 25 kPa surcharge, in γ = 16.5 kN/m³ sand with φ = 32°, and takes
the average pressure at mid-height, (q + h_av·γ)·K, times the block height. The engine has no surcharge
input, but ½γK(z_b² − z_t²) = γ·K·H·h_av exactly, so a surcharge q is represented EXACTLY by raising both
depths by q/γ (an equivalent fill height): γ·K·H·(h_av + q/γ) = (q + γ·h_av)·K·H. That identity is
algebra, not a fit; it is what lets the published Pp′ and Pa′ be compared with the engine at all. Bowles'
total resisting force and safety factor (428.8 kN, 1.34) ALSO include block side friction, which this
engine deliberately omits ("ignored (conservative)"), so those two are not asserted.
TOLERANCES, each from the sources' own rounding:
- The coefficient tables are tested to half of the last printed digit PLUS the engine's own 4-d.p.
output rounding (`ka`, `kp` are returned to 4 d.p.): Bowles 4 d.p. → 0.00005 + 0.00005; Das 3 d.p. →
0.0005 + 0.00005.
- Example 13-7 was worked with Ka = 0.307 and Kp = 3.25 (Tables 11-1/11-2 to 3 s.f.), whereas the engine
uses the exact 0.3073 and 3.2546: a relative difference of 0.14 % on Kp and 0.1 % on Ka. The forces
are compared to 0.3 %, which covers that and the one-decimal rounding of the printed kPa/kN values.
NOT ASSERTED. Das Example 14.13 (anchor plate, P′ult = 35.39 kN/m) uses Eq. 14.86,
P′ult = ½γH²(Kp cosδ′ − Ka cosφ′) with Ka at δ′ = φ′ and Kp from Ovesen-Stromann charts; that is a
wall-friction model and is NOT the engine's Rankine δ = 0 form, so it is not a benchmark for it.
| Test block (the published value it checks) | Verdict |
| Bowles 5e Table 11-3 (p. 603) — Rankine Ka, β = 0, φ = 26°…42° | Pass |
| Bowles 5e Table 11-4 (p. 603) — Rankine Kp, β = 0, φ = 26°…42° | Pass |
| Das 8e Table 12.1 (p. 608) — Ka(R) at α = 0°, θ = 0°, φ′ = 28°…40° | Pass |
| Bowles 5e Example 13-7 (p. 779) — block-face earth forces (Kp = 3.25, Ka = 0.307 in the book) | Pass |
earth-pressure-web-validation.test.ts
WEB-BENCHMARK validation for the lateral earth-pressure engine (the release rules mandatory ≥20 cited-value gate).
Analyses validated: earth-pressure · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the lateral earth-pressure engine
(the release rules mandatory ≥20 cited-value gate). Every target below is a PUBLISHED,
closed-form-verifiable value from a primary source, reproduced in the standard
textbooks + the on-disk reference library:
• Rankine (1857) — active Ka = tan²(45−φ/2), passive Kp = tan²(45+φ/2).
Tabulated in Das, *Principles of Geotechnical Engineering* (Table 13.x) and
Bowles, *Foundation Analysis & Design* Table 11-x.
• Rankine sloping backfill — Ka(β)=cosβ·(cosβ−√(cos²β−cos²φ))/(cosβ+√(cos²β−cos²φ)),
Das Eq. 13.x (worked examples φ=30°, β=10°/20°).
• Jaky (1948) — at-rest K0 = 1 − sinφ (normally consolidated).
• Bell (1915) tension-crack depth z_c = 2c/(γ√Ka) for a c–φ backfill (Das).
• Thrust Pa = ½·Ka·γ·H², Pp = ½·Kp·γ·H²; triangular resultant at H/3 (Coulomb 1776 /
Rankine — universally published).
These are identical across IS 14458, EC7 and AASHTO (the codes differ only in the
SAFETY factoring, verified separately). The engine reproduces each within a tight
tolerance (table values rounded to 3 dp).
| Test block (the published value it checks) | Verdict |
| EP web 1–10: Rankine Ka at φ=20,25,28,30,32,34,35,36,40,45 (Rankine 1857 / Das) | Pass |
| EP web 11–15: Rankine Kp at φ=20,30,35,40,45 (Rankine 1857 / Das) | Pass |
| EP web 16–18: at-rest K0 = 1−sinφ at φ=30,35,40 (Jaky 1948) | Pass |
| EP web 19–20: Rankine Ka sloping backfill φ=30°, β=10°/20° (Das Eq. 13.x) | Pass |
| EP web 21–22: active thrust Pa=½Ka γ H² (φ=30 H=6; φ=35 H=5) | Pass |
| EP web 23: passive thrust Pp=½Kp γ H² (φ=30 H=5) = 675 kN/m | Pass |
| EP web 24: active resultant at H/3 (φ=30, H=6 → 2.0 m) | Pass |
| EP web 25: Bell tension-crack depth z_c=2c/(γ√Ka) (c=20, φ=20, γ=18 → 3.17 m) | Pass |
| EP E-115: the reference Rankine case is untouched (Ka = 1/3, Pa = 75 kN/m) | Pass |
| EP E-115: wall friction δ — NaN, negative, and δ > φ must all be refused | Pass |
| EP E-115: backfill slope β ≥ φ must be refused, not warned | Pass |
| EP E-115: wall inclination α must be finite and within ±90° | Pass |
earth-pressure-worked-examples-web-validation.test.ts
earth-pressure — FULL WORKED EXAMPLES (the ≥20-value gate).
Analyses validated: earth-pressure · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
earth-pressure — FULL WORKED EXAMPLES (the ≥20-value gate). Every expected value is PRINTED in the
cited source, read 2026-09-28 from `Geo Technical engineering books/`.
[DAS] Das, Principles of Foundation Engineering: Ex 12.1 (at-rest with a water table), 12.2
(cohesive, tension crack), 12.6 (Coulomb with δ), 12.7 (Coulomb, battered back + surcharge,
printed in lb/ft), 12.11 (Mononobe-Okabe), 12.14 (Coulomb passive vs Caquot-Kérisel),
13.1 / 13.2 (full wall checks).
[BOW] Bowles 5e Ex 11-1, 11-3, 11-4 (the cohesive tension-zone case, all three conventions),
Prob 11-5 and Prob 11-7 (printed answers to the same cohesive wall).
[CRAIG] Craig's Soil Mechanics 8e Ex 11.2 (water table behind the wall), 11.3 (EC7 surcharge).
[EC7] Geotechnet EC7 Worked Examples, Dublin 2013, A.4.2 / A.4.5 (Ka;β, Kah, E_a;Gk).
[USACE] EM 1110-2-2502 App. H (developed vs peak Ka, Kp).
Conventions taken from the sources, not tuned: Das 12.7's surcharge is projected onto the inclined
wall back by sin β/sin(β+α), which this engine does not do (0.4 % here) — so its total is compared at
1 %. Craig uses γw = 9.8; the engine uses 9.81.
| Test block (the published value it checks) | Verdict |
| [DAS] Ex 12.1: at-rest thrust with the water table at 2.5 m → P0 = 122.85 kN/m at 1.53 m | Pass |
| [BOW] Ex 11-4: c 10.5, φ 10°, H 6.5 → R = 158.5 kN/m at 1.69 m (tension zone neglected), zc = 1.43 m | Pass |
| [BOW] Prob 11-7: crack replaced → full-height thrust = 103.3 kN/m at H/3 | Pass |
| [BOW] Prob 11-5: printed 63.2 kN/m is the net area, printed 4.65/3 m is the neglect-zone centroid | Pass |
| [CRAIG] Ex 11.2(b): water table at 2 m → total thrust 93.3 kN/m | Pass |
| [DAS] Ex 12.6: Coulomb, φ 35°, δ = ⅔φ, H 5 m, γ 17.6 → Pa = 53.77 kN/m | Pass |
| [DAS] Ex 12.7: Coulomb, battered back + 95.76 kPa surcharge → total ≈ 328.2 kN/m | Pass |
| [DAS] Ex 12.11: Mononobe-Okabe, kh 0.3 → P_ae = 46.05 kN/m (static 22.88) | Pass |
| [DAS] Ex 12.14: passive with wall friction → Caquot-Kérisel 311 kN/m (Coulomb 351.6) | Pass |
| [DAS] Ex 13.1: Rankine, H 7.158 m, β 10° → Pa = 161.2 kN/m | Pass |
| [DAS] Ex 13.2: Coulomb, battered back 15°, δ = ⅔φ → Pa = 157.22 kN/m | Pass |
| [BOW] Ex 11-1: Coulomb, β 10°, δ 20° → Pa = 74.5 kN/m at H/3 | Pass |
| [BOW] Ex 11-3: Rankine, β 10° → Pa = 76.6 kN/m | Pass |
| [EC7] Dublin A.4.2/A.4.5: Ka;β = 0.365 and the characteristic soil thrust E_a;Gk = 201 kN/m | Pass |
| [USACE] EM 1110-2-2502 App. H: peak Ka 0.31 and Kp 3.25 at φ 32° | Pass |
eurocode7-factors-web-validation.test.ts
Eurocode 7 partial factors — validated against **EN 1997-1:2004 (BS EN 1997-1:2004)**, *Eurocode 7: Geotechnical design — Part 1: General rules*, **Annex A**.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Eurocode 7 partial factors — validated against **EN 1997-1:2004 (BS EN 1997-1:2004)**,
*Eurocode 7: Geotechnical design — Part 1: General rules*, **Annex A**.
Source, read directly:
`Geo Technical engineering books/EN-1997-1-2004_Eurocode-7-Geotechnical-Design-Part-1_full-370p-with-annexes.pdf`
─────────────────────────────────────────────────────────────────────────────
WHY THIS SUITE EXISTS — and what it says about the audit, not just the code
─────────────────────────────────────────────────────────────────────────────
`eurocode7-factors.ts` is the shared partial-factor table behind the EC7 design paths of
`bearing-capacity`, `earth-pressure`, `pile-capacity`, `slope-stability` and
`staged-excavation-wall` — i.e. the European route through the five highest-consequence
engines in the product. It had a 4-test golden suite but **no `web-validation` suite**, so it
never counted toward the ≥20-cited-value gate and the audit had never verified it.
That gap was mine, not the code's. Reviewing coverage by standard family showed the audit's
validation work skewed heavily Indian — 17 suites citing IS/IRC against 5 citing EN/Eurocode —
because Indian codes had recently been added to the library and I anchored those first. The
ENGINES are not India-locked: `bearing-capacity` alone offers IS 6403, all four EC7 Design
Approaches, BS 8004 and AASHTO LRFD. But I had validated only the Indian path of a
seven-standard engine, which makes the audit trail read as though the product were Indian-only.
This suite starts correcting that.
─────────────────────────────────────────────────────────────────────────────
THE PUBLISHED TABLES, verbatim from Annex A
─────────────────────────────────────────────────────────────────────────────
**Table A.3 — Partial factors on actions (γF) or the effects of actions (γE)**
| Action | Symbol | A1 | A2 |
|---------------------------|--------|------|-----|
| Permanent unfavourable | γG | 1,35 | 1,0 |
| Permanent favourable | γG | 1,0 | 1,0 |
| Variable unfavourable | γQ | 1,5 | 1,3 |
| Variable favourable | γQ | 0 | 0 |
**Table A.4 — Partial factors for soil parameters (γM)**
| Soil parameter | Symbol | M1 | M2 |
|---------------------------------------|--------|-----|------|
| Angle of shearing resistance ᵃ | γφ′ | 1,0 | 1,25 |
| Effective cohesion | γc′ | 1,0 | 1,25 |
| Undrained shear strength | γcu | 1,0 | 1,4 |
| Unconfined strength | γqu | 1,0 | 1,4 |
| Weight density | γγ | 1,0 | 1,0 |
ᵃ "This factor is applied to tan φ′" ← not to φ′ itself; asserted below.
**Table A.5 — Partial resistance factors (γR) for spread foundations**
| Resistance | Symbol | R1 | R2 | R3 |
|------------|--------|-----|-----|-----|
| Bearing | γR;v | 1,0 | 1,4 | 1,0 |
| Sliding | γR;h | 1,0 | 1,1 | 1,0 |
**The Design Approach combinations (Cl 2.4.7.3.4), verbatim:**
DA1 Combination 1: `A1 "+" M1 "+" R1`
DA1 Combination 2: `A2 "+" M2 "+" R1`
DA2: `A1 "+" M1 "+" R2`
DA3: `(A1* or A2†) "+" M2 "+" R3` (*on structural actions, †on geotechnical)
| Test block (the published value it checks) | Verdict |
| EN 1997-1 Cl 2.4.7.3.4 — every Design Approach combines the correct A/M/R sets | Pass |
| Table A.4 — γφ′ is applied to tan φ′, not to φ′ (via the engine's own ec7ReduceMaterials) | Pass |
| EN 1997-1 Cl 2.4.7.3.1 eq 2.6a/b — Fd = γG·Gk + γQ·Qk via ec7DesignAction | Pass |
| the three EC7 verification philosophies are structurally distinct | Pass |
| every factor is ≥ 1 and finite — a partial factor can never increase capacity | Pass |
| EC7_LABELS name the A/M/R combination so a report shows which philosophy was used | Pass |
| National Annex variations are DOCUMENTED and deliberately NOT auto-applied | Pass |
| DA3 exposes the A1 (structural) action set, and says so | Pass |
| the four approaches produce four DIFFERENT design outcomes (they are not aliases) | Pass |
⚑ excavation-settlement-web-validation.test.ts
EXCAVATION-SETTLEMENT — web-validation benchmark against published envelopes and limits.
Analyses validated: excavation-settlement · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
EXCAVATION-SETTLEMENT — web-validation benchmark against published envelopes and limits.
`excavation-settlement.ts` implements the Clough & O'Rourke (1990) settlement envelopes behind a
supported wall (sand: triangle to 2·He; stiff clay: triangle to 3·He; soft clay: plateau to 0.75·He then
linear to 2·He), δv,max = k·δh,max (Hsieh & Ou 1998: k = 0.5-0.75), and bands the trough's angular
distortion against published damage limits.
SOURCES (each opened; locator next to every value):
1. Ou, C.Y. (2006), Deep Excavation: Theory and Practice, Taylor & Francis — §6.8.3 "Clough and
O'Rourke's method" (printed p. 203) and Figure 6.25 (p. 204), which redraws the three envelopes with
numbered axes; §6.4.4 (p. 194) with Figure 6.14: δvm = (0.5-0.75)·δhm. The file on disk is a scan, so
every value was read from the rendered page images (pdf pages 211, 220, 221).
2. CGS (2006), Canadian Foundation Engineering Manual, 4th ed., Canadian Geotechnical Society —
§26.15.2-26.15.4 (printed pp. 435-437) with Figures 26.23, 26.25, 26.26 (after Clough & O'Rourke 1990):
zone of influence x_max ≈ 2.0·He in granular soil; 1.0-2.0·He in soft to firm clay; ≈ 2.0·He in stiff
clay, extending to 3.0·He.
3. Look, B.G. (2007), Handbook of Geotechnical Investigation and Design Tables, Taylor & Francis —
Table 23.15 "Observed settlements behind excavations" (Peck 1969; O'Rourke et al. 1976), medium-dense
sand row; Table 23.7 "Limiting angular distortion" (Wahls 1981): 1/500 safe limit for no cracking,
1/300 first cracking of panel walls, 1/150 considerable cracking / danger of structural damage.
4. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon — Figure 11.39
"Envelopes of ground settlement behind excavations" (Gaba et al. 2003; printed p. 455): the
coarse-grained envelope returns to zero at x/h ≈ 2. Read from the rendered page image.
5. Bond, A.J. et al. (2013), Eurocode 7: Geotechnical Design — Worked Examples, JRC Report EUR 26227 EN,
Table 3.4.1: cracking in walls, angular distortion 1/500; structural damage 1/150-1/250.
TOLERANCES, each from the source's own precision:
- Ou's and CFEM's influence distances are stated as multiples of He (2, 3, "about 2.0") → exact to the
stated multiple, ±0.5 % (the value is returned in metres from a multiple of a round He).
- Figure 6.25 is a straight-line envelope read at a grid line → ±0.02 on δv/δvm.
- Look Table 23.15 prints settlement/He to one decimal of a percent → ±0.05 %.
- Craig Figure 11.39 is read from a plotted curve on an axis labelled 0, 1, 2, 3, 4 → ±0.1 on x/h.
- Angular-distortion breakpoints are tested one percent either side of the printed fraction.
NOT ASSERTED (recorded in the validation report). (a) Look Table 23.15's other soil rows (Peck's zone
curves: 2.5·He for sand + soft/hard clay, 4.0·He for very soft clay) and Craig Fig. 11.39's fine-grained
envelope (4·x/h) are DIFFERENT published envelopes from the Clough & O'Rourke ones this engine
implements, and they disagree with it beyond 2·He for clays. (b) The engine's band names and its upper
breakpoints (1/150-1/75 "moderate", ≥ 1/75 "severe") are attributed in the source to Boscardin & Cording
(1989), whose own single-criterion limits (Look Table 23.8, zero horizontal strain) are 1.6, 3.2 and
6.6 × 10^-3 = 1/625, 1/312, 1/152; the engine's 1/500, 1/300 and 1/150 breakpoints are those of
Wahls (1981) / Skempton & MacDonald (1956) / EC7 above, and its 1/75 has no source among those opened.
| Test block (the published value it checks) | Verdict |
| Ou 2006 p. 203 — influence ranges "2 He and 3 He" for sand and stiff clay | Pass |
| Ou 2006 Fig. 6.25(a) — sand: triangular, δv/δvm = 1.0 at the wall, 0.5 at d/He = 1.0, 0 at 2.0 | Pass |
| Ou 2006 Fig. 6.25(b) — stiff clay: triangular, 1.0 at the wall, 0.5 at d/He = 1.5, 0 at 3.0 | Pass |
| Ou 2006 p. 203 + Fig. 6.25(c) — soft to medium clay: plateau to d/He = 0.75, then linear to 0 at 2.0 | Pass |
| Ou 2006 §6.4.4 p. 194 (Fig. 6.14) — δvm = (0.5-0.75)·δhm, Hsieh-Ou range | Pass |
| CFEM 2006 §26.15.2-26.15.4 (pp. 435-437) — zones of influence by ground type | Pass |
| Look 2007 Table 23.15 — medium to dense sand: 0.3 % at the wall, 0.1 % at 1.2 He, 0.0 % at 2.0 He | Pass |
| Craig 2012 Fig. 11.39 (p. 455) — the coarse-grained envelope returns to zero at x/h ≈ 2 | Pass |
| Look 2007 Table 23.7 / EC7 WE Table 3.4.1 — 1/500: "safe limit for no cracking" / "cracking in walls" | Pass |
| Look 2007 Table 23.7 — 1/300: "first cracking of panel walls" | Pass |
| Look 2007 Table 23.7 / EC7 WE Table 3.4.1 — 1/150: "considerable cracking" / "structural damage" | Pass |
fe-design-checks-anchor-web-validation.test.ts
W3 FE design check — GROUND ANCHOR — web-validation benchmark against published tables and worked examples.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 23 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
W3 FE design check — GROUND ANCHOR — web-validation benchmark against published tables and worked
examples. Every expected value below was read from the source named next to it.
SOURCES (each opened):
[GEC4] Sabatini, P.J., Pass, D.G. & Bachus, R.C. (1999), Geotechnical Engineering Circular No. 4 —
Ground Anchors and Anchored Systems, FHWA-IF-99-015, Federal Highway Administration.
https://www.fhwa.dot.gov/engineering/geotech/pubs/if99015.pdf (on disk:
Geo Technical engineering books/_new_2026-10-18_library/FHWA-IF-99-015-GEC4-1999-...pdf).
§5.3.8 p.77 (design ≤ 0.60, lock-off ≤ 0.70, test ≤ 0.80 SMTS); Table 9 (ASTM A722 bars, SI
rows) p.77; Table 10 (15-mm Grade 270 / 1860 strands) p.78; §5.3.6 pp.71–74 (FS 2.0 soil,
3.0 rock); Appendix A Example 1 pp.A-8/A-9 and Example 2 pp.A-27/A-28.
[DG7] Frank, R., Bauduin, C., Driscoll, R., Kavvadas, M., Krebs Ovesen, N., Orr, T. & Schuppener, B.
(2004), Designers' Guide to EN 1997-1 Eurocode 7: Geotechnical design — General rules,
Thomas Telford, London. Chapter 8, Example 8.1, Tables 8.1–8.2 pp.141–142 (on disk:
designers-guide-to-eurocode-7-geotechnical-design-en-1997.pdf).
Tolerances: the GEC-4 SI tables were converted from kips and rounded to 1 kN (e.g. 1 strand: 58.6 kip
→ 260.7 kN, while 1860 MPa × 140 mm² = 260.4 kN), so table comparisons use 0.5 %. Worked-example
values printed to 3 significant figures use 0.5 %.
| Test block (the published value it checks) | Verdict |
| [GEC4 Table 10 p.78] 1-strand 1860 MPa tendon (A = 140 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 3-strand 1860 MPa tendon (A = 420 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 4-strand 1860 MPa tendon (A = 560 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 5-strand 1860 MPa tendon (A = 700 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 7-strand 1860 MPa tendon (A = 980 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 9-strand 1860 MPa tendon (A = 1260 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 12-strand 1860 MPa tendon (A = 1680 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 15-strand 1860 MPa tendon (A = 2100 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 10 p.78] 19-strand 1860 MPa tendon (A = 2660 mm²): f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 26-mm bar, f_pu = 1035 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 32-mm bar, f_pu = 1035 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 36-mm bar, f_pu = 1035 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 45-mm bar, f_pu = 1035 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 64-mm bar, f_pu = 1035 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 26-mm bar, f_pu = 1104 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 32-mm bar, f_pu = 1104 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Table 9 p.77] 36-mm bar, f_pu = 1104 MPa: f_pu·A, 0.8/0.7/0.6·f_pu·A | Pass |
| [GEC4 Ex.1 p.A-9] soil anchor: bond 600 kN at L = 12 m, required L = 8.9 m, tendons 501 / 469 kN | Pass |
| [GEC4 Ex.2 p.A-27/28] rock anchor: bond 900 kN at L = 7.5 m, required L = 5.3 m, tendons 675 / 782 kN | Pass |
| [DG7 Ex.8.1 Table 8.2] DA-1 LEM: R_a,k,req = γa·P_d = 461 kN; EN 1537 proof load = 419 kN | Pass |
| [DG7 Ex.8.1 Table 8.2] DA-2(L) LEM: R_a,k,req = γa·P_d = 611 kN; EN 1537 proof load = 557 kN | Pass |
| [DG7 Ex.8.1 Table 8.2] DA-2(S) spring: R_a,k,req = γa·P_d = 421 kN; EN 1537 proof load = 383 kN | Pass |
| [DG7 Ex.8.1 Table 8.2] DA-3 LEM: R_a,k,req = γa·P_d = 461 kN; EN 1537 proof load = 419 kN | Pass |
fe-design-checks-d277-web-validation.test.ts
W4 (D277) — published benchmarks for the W3 checks that had none: IS 456 RC wall flexure, EN 1993-1-1 strut buckling, FHWA GEC-11 geogrid rupture.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
W4 (D277) — published benchmarks for the W3 checks that had none: IS 456 RC wall flexure, EN 1993-1-1
strut buckling, FHWA GEC-11 geogrid rupture. Every expected value below is printed in its source.
IS 456:2000 (rc-wall.ts `is456Flexure`, the function the RC wall check calls per metre of wall):
NPTEL (IIT Kharagpur), "Design of Concrete Structures", Module 3 Lesson 7 "Numerical problems on singly
reinforced rectangular beams" (Version 2 CE IIT Kharagpur),
https://archive.nptel.ac.in/content/storage2/courses/105105104/pdf/m3l7.pdf
Problems 3.2 / 3.3 (b 300, d 550, M20, Fe415; A_st 1256 / 1658 mm²) and Q.1 (b 300, d 500, M20, Fe500;
A_st 452 / 1030 mm²): x_u, x_u,max, M_u by direct computation (Tables 3.9) and from SP-16 Table 2
(Table 3.8, 3.11). NOTE: the lesson's direct method uses M_u = 0.87 f_y A_st (d − 0.42 x_u); Annex G-1.1(b)
(and SP-16, which tabulates it) uses d(1 − A_st f_y/(b d f_ck)) — 0.2–0.3 % apart; tolerances say so.
The lesson takes x_u,max/d = 0.479 for Fe415 (IS 456 §38.1 note: 0.48) — 0.2 % on M_u,lim.
EN 1993-1-1 (strut.ts): L. Gardner & D.A. Nethercot, "Designers' Guide to Eurocode 3: EN 1993-1-1"
(Thomas Telford), Examples 6.7 and 6.9, as reproduced with inputs and results on SDC Verifier's public
benchmark pages:
https://sdcverifier.com/benchmarks/eurocode-3-buckling-resistance-of-a-compression-member/ (Ex. 6.7: CHS
244.5×10 S355, A 7370 mm², I 50.73e6 mm⁴, pinned, L 4 m → N_cr 6571 kN, λ̄ 0.63, Φ 0.74, χ 0.88,
N_b,Rd 2297 kN, N_c,Rd 2616 kN)
https://sdcverifier.com/benchmarks/member-resistance-under-combined-major-axis-bending-and-axial-compression-eurocode-3-example-6-9/
(Ex. 6.9: A 8300 mm², I 36.78e6 / 11.47e6 mm⁴, S355 → N_cr,y 4127.2 / N_cr,z 1470.5 kN, Φ 0.92 / 1.63,
χ 0.77 / 0.41, N_b,Rd 2266.0 / 1209.2 kN, N_c,Rd 2946.5 kN). The page prints no buckling lengths or
curve: L_cr is back-solved from the printed N_cr (so N_cr and λ̄ are NOT counted), and curve a is the
one whose Φ matches the printed Φ on both axes (curve b gives Φ_z 1.71 vs 1.63).
FHWA GEC-11 (geogrid.ts, 'FHWA GEC-11 (NHI-10-024)', simplified method φ = 0.90):
Berg, Christopher & Samtani (2009) FHWA-NHI-10-025 "MSE Walls and RSS — Vol II", Example E1 §7.6
Table E1-7.3 (GG-I/II/III: T_ult 3000/6000/9000 lb/ft, RF_CR 1.85, RF_D 1.15, RF_ID 1.3/1.3/1.2 →
T_al 1085/2169/3525, T_r 976/1952/3173 lb/ft) and Table E1-7.4 (T_MAX and CDR per layer; T_MAX is already
factored, so γ_F = 1); Example E9 Step 4 (T_ULT 6850 lb/ft, RF_D 1.25, RF_ID 1.2, RF_CR 3.0 →
T_al = 1520 lb/ft (22 kN/m)). Library: Geo Technical engineering books/FHWA-GEC11-MSE-Walls-RSS-Vol2.pdf.
The check is unit-agnostic in force per width; lb/ft is passed straight through.
Ledger: IS 456 13 values · EN 1993-1-1 13 values · GEC-11 19 values = 45 published values.
| Test block (the published value it checks) | Verdict |
| IS 456 — NPTEL M3L7 Problem 3.2 (b 300, d 550, M20, Fe415, A_st 1256): x_u 209.94 mm, M_u 209.43 (direct) / 209.68 kNm (SP-16 Table 2) | Pass |
| IS 456 — NPTEL M3L7 Problem 3.3 (A_st 1658): x_u 277.14 > x_u,max → M_u,lim 250.01 (direct) / 250.47 kNm (SP-16, 2.76 b d²) | Pass |
| IS 456 — NPTEL M3L7 Q.1 (b 300, d 500, M20, Fe500): A_st 452 → x_u 91.03, M_u 90.79 / 90.3 kNm; A_st 1030 → x_u 207.43, M_u 184.99 kNm; x_u,max 230 mm | Pass |
| EN 1993-1-1 — Designers’ Guide Ex. 6.7 (CHS 244.5×10 S355, L 4 m, curve a): N_cr 6571, λ̄ 0.63, Φ 0.74, χ 0.88, N_b,Rd 2297, N_c,Rd 2616 kN | Pass |
| EN 1993-1-1 — Designers’ Guide Ex. 6.9 (A 8300, S355, curve a) y-axis: Φ 0.92, χ 0.77, N_b,Rd 2266 kN | Pass |
| EN 1993-1-1 — Designers’ Guide Ex. 6.9 (A 8300, S355, curve a) z-axis: Φ 1.63, χ 0.41, N_b,Rd 1209.2 kN | Pass |
| GEC-11 Example E1 Table E1-7.3: T_al and T_r = 0.90 T_al for GG-I / GG-II / GG-III (lb/ft) | Pass |
| GEC-11 Example E1 Table E1-7.4: CDR = T_r/T_MAX for all 11 layers | Pass |
| GEC-11 Example E9 Step 4: T_al = 6850/(1.25·1.2·3.0) = 1520 lb/ft (22 kN/m) | Pass |
fe-design-checks-geogrid-web-validation.test.ts
W3-3 — `fe-design-checks/geogrid.ts` (the per-element geogrid tension check) against published long-term-strength values.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
W3-3 — `fe-design-checks/geogrid.ts` (the per-element geogrid tension check) against published
long-term-strength values. Every expected number below is printed in its source; none is re-derived.
The check computes the long-term design strength from the product's short-term strength and its
reduction factors, for two codes:
'BS 8006-1:2010' Annex A.3: T_CR = T_char/RF_CR, f_m = RF_ID·RF_W·RF_CH·f_s, T_D = T_CR/f_m,
rupture line T_D/f_n ≥ T_j with f_n from Table 9 (categories 1–2: 1.0,
3: 1.1); Table 12 combination A f_fs = 1.5 on soil self-weight (the γ_F
default). Library: Geo Technical engineering books/
BS-8006-1-2010-strengthened-reinforced-soils-and-other-fills.pdf.
'FHWA GEC-11 (NHI-10-024)' Eq 3-12: T_al = T_ult/(RF_ID·RF_CR·RF_D); Eq 4-33/4-34 T_r = φ·T_al·R_c,
Table 4-7 φ = 0.90 (geosynthetic, static). Library: FHWA-GEC11-MSE-Walls-
RSS-Vol1.pdf / Vol2.pdf.
CITABLE PUBLISHED VALUES.
BS 8006-1:2010 — Annex A.3 (normative, p. 216) prints the formula chain itself; Table 9 (p. 52)
prints f_n = 1.0 / 1.0 / 1.1 for categories 1/2/3; Table 12 (p. 70) prints f_fs = 1.5 for the mass
of the reinforced soil body under combination A. The formula is verified by applying it to a
self-consistent published reduction-factor set: GEC-11's own conservative preliminary-design factor
RF = 7 (Vol I §3.5.2.g, Eq 3-13 — printed "Tal = Tult/RF = Tult/7") decomposed per BS 8006 as
RF_CR·(RF_ID·RF_W·RF_CH·f_s) = 7 and checked that T_D comes out T_char/7. This is the only citable
published RF for a full BS 8006 chain — BS 8006 Annex A.3 gives the formula but no worked number,
so the RF = 7 anchor (a printed FHWA value) is used as the honest citable target.
FHWA GEC-11 — Vol II Example E9 Step 4 (printed "Tal = (6850 lb/ft) / ((1.25)(1.2)(3)) = 1520 lb/ft
(22 kN/m)"): T_ult 6850 lb/ft, RF_D 1.25, RF_ID 1.2, RF_CR 3.0 → T_al = 1520 lb/ft (22 kN/m);
Example E1 §7.6 Table E1-7.3 (GG-I/II/III: T_ult 3000/6000/9000 lb/ft, RF_CR 1.85, RF_D 1.15,
RF_ID 1.3/1.3/1.2 → T_al 1085/2169/3525, T_r 976/1952/3173 lb/ft). These are re-asserted here so
THIS file is the standalone per-element record (the d277 file also covers them).
TOLERANCES. The printed T_al / T_r values are to 3–4 significant figures (E1 Table E1-7.3) or rounded
to the tens digit (E9: 1520, 22); tolerances of 0.2 % (E1) and 0.2–1.1 % (E9, for the rounded prints)
are kept from the d277 file, never widened. The BS 8006 RF = 7 chain is exact (f_n, f_fs are printed
integers; the RF = 7 decomposition is exact), tolerance 1e-9.
Ledger: BS 8006-1 — 1 full-chain anchor (RF = 7 → T_D = T_char/7) + 3 f_n values + 1 f_fs value = 5.
FHWA GEC-11 — E9 (T_al lb/ft and kN/m = 2) + E1 Table E1-7.3 (3 × T_al + 3 × T_r = 6) = 8.
Total 13 published values.
| Test block (the published value it checks) | Verdict |
| BS 8006-1 Table 9: f_n = 1.0 / 1.0 / 1.1 for categories 1 / 2 / 3 (printed p. 52) | Pass |
| BS 8006-1 Table 12 combination A: the check default γ_F = f_fs = 1.5 on soil self-weight (printed p. 70) | Pass |
| BS 8006-1 Annex A.3: T_D = T_char/RF with RF = 7 (GEC-11 Eq 3-13 conservative anchor) decomposed as RF_CR·(RF_ID·RF_W·RF_CH·f_s) | Pass |
| GEC-11 (2009) Table 4-7: φ = 0.90 geosynthetic static; (2023) Table 16 SSM: φ = 0.80 | Pass |
| GEC-11 Vol II Example E9 Step 4: T_al = 6850/(1.25·1.2·3.0) = 1520 lb/ft (22 kN/m) | Pass |
| GEC-11 Vol II Example E1 Table E1-7.3: T_al and T_r = 0.90 T_al for GG-I / GG-II / GG-III (lb/ft) | Pass |
fe-design-checks-pile-web-validation.test.ts
W4 (D276) — embedded pile check: web / published benchmark.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
W4 (D276) — embedded pile check: web / published benchmark.
Source (on disk, legitimate: a free JRC Scientific and Policy Report):
A.J. Bond, B. Schuppener, G. Scarpelli, T.L.L. Orr (2013), "Eurocode 7: Geotechnical Design —
Worked examples", JRC Scientific and Policy Reports EUR 26227 EN (Geotechnet / JRC workshop, Dublin,
13–14 June 2013), Annex §A.8 "Worked examples – pile design", pp. 152–159.
Library: Geo Technical engineering books/EC7-Worked-Examples_Geotechnet-Workshop-Dublin-2013.pdf
https://eurocodes.jrc.ec.europa.eu/ (JRC Eurocodes publications)
Example 2 (§A.8.1.4–A.8.1.6, p. 152–155) — bored pile D = 0.45 m from one CPT profile:
R_c,cal = 398 + 141·L_s kN; ξ3 = ξ4 = 1.4 (one profile) → R_b,k = 284 kN, R_s,k = 101·L_s;
G_k 300 + Q_k 150 kN: DA1-C1 F_c,d = 630 kN = 284/1.25 + 101 L_s/1.0 → L_s = 3.99 m;
DA1-C2 F_c,d = 495 kN = 284/1.6 + 101 L_s/1.3 → L_s = 4.08 m; DA2 630 = 284/1.1 + 101 L_s/1.1 → 4.05 m.
Example 3 (§A.8.2, p. 156–159) — driven pile D = 0.45 m in Dublin Boulder Clay, alternative procedure with
the Irish NA model factor γ_Rd = 1.75: R_b,k = 0.159·2430 = 386 kN, R_s,k = 153·L_s;
G_k 600 + Q_k 300: DA1-C1 F_c,d = 1260, R_c,d = 221 + 87.4 L_s → L_s 11.9 m; DA1-C2 F_c,d = 990,
R_c,d = 170 + 67.3 L_s → 12.2 m; DA2 R_c,d = 201 + 79.5 L_s → 13.3 m.
(Example 1 of §A.8 designs from static load tests — ξ1/ξ2 on measured R_c,m — which this check does not do.)
The FE check takes ONE action factor on the combined FE force: γ_F = F_c,d/(G_k + Q_k) reproduces each
published F_c,d exactly (630/450 = 1.4, 495/450 = 1.1, 1260/900 = 1.4, 990/900 = 1.1).
Structural: no published worked example of EN 1992-1-1 §2.3.4.2 + §2.4.2.5 pile resistance was found on
disk (the EC2 worked-example report EUR 26566 has no pile). The §2.3.4.2(2) design-diameter rule is
asserted against its own printed rule (4 code-rule values, EN 1992-1-1:2004 p. 22) and the cross-section
resistance against a hand evaluation of the printed clauses (golden, not counted as published).
Ledger: 19 published values (Example 2: 7, Example 3: 12) + 4 code-rule values = 23.
| Test block (the published value it checks) | Verdict |
| JRC EUR 26227 Ex. 2 (bored, CPT): R_b,k = 284 kN, R_s,k = 101 kN per metre | Pass |
| JRC EUR 26227 Ex. 2: DA1-C1 F_c,d = 630 kN equals R_c,d at L_s = 3.99 m | Pass |
| JRC EUR 26227 Ex. 2: DA1-C2 F_c,d = 495 kN equals R_c,d at L_s = 4.08 m | Pass |
| JRC EUR 26227 Ex. 2: DA2 R_c,d = 630 kN at L_s = 4.05 m | Pass |
| JRC EUR 26227 Ex. 3 (driven, γ_Rd 1.75): R_b,k = 386 kN, R_s,k = 153 kN per metre | Pass |
| JRC EUR 26227 Ex. 3 EN 1997-1 DA1-C1: R_c,d = 221 + 87.4·L_s; = F_c,d 1260 kN at L_s = 11.9 m | Pass |
| JRC EUR 26227 Ex. 3 EN 1997-1 DA1-C2: R_c,d = 170 + 67.3·L_s; = F_c,d 990 kN at L_s = 12.2 m | Pass |
| JRC EUR 26227 Ex. 3 EN 1997-1 DA2: R_c,d = 201 + 79.5·L_s; = F_c,d 1260 kN at L_s = 13.3 m | Pass |
| EN 1992-1-1 §2.3.4.2(2) design diameter of an uncased cast-in-place pile (code rule, 4 values) | Pass |
| structural (golden, hand-evaluated): d 0.6 m uncased C30/37, 8 H20 (2513 mm²), B500 | Pass |
| plain concrete uses α_cc,pl = 0.8; precast/cased uses the nominal diameter and γ_c = 1.5 | Pass |
| never defaults: missing pile type, resistances and section → incomplete with every field named | Pass |
| tension: R_t,d = R_s,k/γ_s,t (Table A.7 R1: 1.25); dispatcher converts the kernel sign (tension +) | Pass |
fe-design-checks-rc-wall-web-validation.test.ts
Web / published-benchmark validation — RC wall design check (fe-design-checks/rc-wall.ts).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web / published-benchmark validation — RC wall design check (fe-design-checks/rc-wall.ts).
Every expected value is copied from a published worked example that was opened and read; the
source, page and the example's own inputs sit next to each case. Tolerances follow the source's
printed rounding (stated per case). Where a source only DESIGNS steel for a moment (A_s from M_Ed),
the benchmark runs the inverse: our resistance with the published A_s must return the published
M_Ed (the two are the same rectangular-block equation read in opposite directions).
Sources
[JRC] Walraven, J. & Gmainer, S., "Limit state design (ULS-SLS)", ch. 3 of: Bouchon et al. (eds.
Poljansek, Nikolova Kamenarova, Dimova, Pinto Vieira), "Eurocode 2: Background & Applications —
Design of Concrete Buildings — Worked examples", JRC Scientific and Policy Report EUR 26566 EN,
2014. https://eurocodes.jrc.ec.europa.eu/doc/1110_WS_EC2/report/1110_WS_EC2.pdf
(C25/30, B500, γc 1.5, γs 1.15, α_cc 1.0; the K–z/d method z/d = 0.5(1 + √(1 − 2K)) is exactly
the λ = 0.8, η = 1 rectangular block of EN 1992-1-1 §3.1.7(3).)
[SP] StructurePoint, "Reinforced Concrete Shear Wall Foundation (Strip Footing) Analysis and Design",
ACI 318-14, version Sep-18-2017 (ref. Wight, Reinforced Concrete Mechanics and Design 7th ed.,
Ex. 15-1). On disk: Geo Technical engineering books/Concrete-Shear-Wall-Strip-Footing-Foundation-
Analysis-Design-ACI318-14.pdf; publisher copy structurepoint.org. The flexure (§22.2) and
Eq. 22.5.5.1 = ACI 318-19 Table 22.5.5.1 Eq. (a) provisions used are unchanged in ACI 318-19.
| Test block (the published value it checks) | Verdict |
| EC2 M_Rd — [JRC] p.58, T-beam mid-span AB (b_eff 2611.2, d 372): MEd 89.3 → As 556 mm² | Pass |
| EC2 M_Rd — [JRC] p.58, T-beam support B (b_w 250, d 372): MEd 132.9 → As 947 mm² | Pass |
| EC2 M_Rd — [JRC] pp.65–66, slab X-dir support axis 2 (d 143): MEd 49.18 → As 856 mm²/m | Pass |
| EC2 M_Rd — [JRC] p.66, slab X-dir mid-span 1-2: MEd 18.32 → As 303 mm²/m | Pass |
| EC2 M_Rd — [JRC] p.66, slab X-dir mid-span 2-3 / axis 3: MEd 36.95 → As 630 mm²/m | Pass |
| EC2 M_Rd — [JRC] pp.66–67, slab Y-dir support axis B: MEd 68.15 → As 1235 mm²/m | Pass |
| EC2 M_Rd — [JRC] p.67, slab Y-dir mid-span: MEd 52.14 → As 915 mm²/m | Pass |
| EC2 V_Rd,c — [JRC] p.59 beam support A: bw 250, d 372, Asl 565, C25 → k 1.73, ρl 0.61 %, V_Rd,c 47.90 kN | Pass |
| EC2 V_Rd,c — [JRC] p.92 slab with embedded lighting: bw 240, d 190, ρl = 0.02 (cap), k = 2.0 → 40.2 kN | Pass |
| EC2 v_Rd,c / v_min — [JRC] p.73 (punching, same Eq. 6.47 ≡ 6.2a form): d 164 → k 2.0, ρl 0.83 %, v_Rd,c 0.66, v_min 0.49 MPa | Pass |
| ACI φM_n — [SP] p.4: b 12 in, d 9.75 in, f'c 3000 psi, fy 60 ksi, As 0.316 in²/ft → φM_n = M_u 13.4 kip·ft/ft | Pass |
| ACI stress block — [SP] p.4: As 0.321 in²/ft → a 0.629 in, c 0.74 in, εt 0.037 (> 0.005, tension-controlled) | Pass |
| ACI φV_c Eq. (a) — [SP] p.3: φ·2λ√f'c·bw·d, bw 12 in, d 9.75 in, 3000 psi → 9.61 kips/ft | Pass |
fe-design-checks-sheet-pile-web-validation.test.ts
FE-DESIGN-CHECKS / SHEET PILE — benchmark against published worked examples (EN 1993-5:2007).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
FE-DESIGN-CHECKS / SHEET PILE — benchmark against published worked examples (EN 1993-5:2007).
SOURCE (opened; values read from the text layer and checked against the page images):
ArcelorMittal, "Piling Handbook", 9th edition (2016), revision 2022 — on disk as
Geo Technical engineering books/_new_2026-10-18_library/ArcelorMittal-2022-Piling-Handbook-9th-ed-rev2022-sheet-pile-design.pdf
- Chapter 8 "Structural design of sheet pile sections", pp. 8-7 … 8-22 (PDF pp. 279-293):
Example 1 = PU 18, S 355 GP, β_B = 0.75, class 2; Example 2 = AZ 18-700, S 355 GP, class 3.
§8.3 bending, §8.4 shear, §8.5 bending+shear, §8.6 compression, §8.7 bending+compression,
§8.8 bending+shear+compression, §8.9 member buckling. γ_M0 = 1.0 (UK NA), γ_M1 = 1.1.
- Chapter 8 Table 8.7 "Z-sections with (c/t_w)/ε > 72", p. 8-23 (PDF p. 295).
- Chapter 3 Table 3.7 "Selection of the sheet pile section: reduced section properties", p. 3-24
(AZ 25-800 / PU 28-1.0 in S 430 GP, β_B = 1.00 / 0.75, γ_M0 = 1.0).
The code text was checked against EN 1993-5:2007 (BSI) §5.2.2-5.2.3, PDF pp. 36-43, on disk.
TOLERANCE: half a unit of the last printed digit (the handbook rounds every printed value), except
- χ = 0.84 is READ FROM A CHART (Fig. 8.4) in the handbook; the engine evaluates EN 1993-1-1 Eq. (6.49)
exactly (0.8353), so χ is checked to ±0.01 and the resulting moment limit 297 kN·m/m to ±1.5 kN·m/m.
- Example 1 §8.5 prints ρ inside the ratio as "0.0598" but the same ρ as 0.059 in §8.8 and the ratio
0.971 / M_V,Rd = 552 that follow are consistent only with ρ = 0.0589; we test 0.059 (§8.8) and the
printed 0.971 / 552.
- Where the handbook rounds an INPUT before multiplying (f_y,red to 0.1 MPa in §8.8, to 1 MPa in Table 3.7),
the tolerance carries that input rounding explicitly (stated at each assertion).
No tolerance was widened to make a value pass.
KNOWN, DOCUMENTED DIFFERENCE (not a tolerance): for the AZ 18-700 in S 355, (c/t_w)/ε = 72.02 > 72, so
EN 1993-5 §5.2.2(6) strictly requires the shear-buckling check; Table 8.7 leaves that cell blank (72.0 after
rounding). The engine applies the clause, so its SHEAR LINE capacity is V_b,Rd = 1080 kN/m (0.26 % below the
handbook's V'_pl,Rd = 1083). The published V_pl,Rd is therefore compared with the engine's V_pl,Rd STEP.
COUNT: 43 published values (Example 1: 19, Example 2: 14, Table 3.7: 6, Table 8.7: 4).
| Test block (the published value it checks) | Verdict |
| PU 18 (Ex. 1) — §8.3 M_c,Rd = 568; §8.4 A_v 3769, V_pl,Rd 772.5 kN/web, 1288 kN/m | Pass |
| PU 18 (Ex. 1) — §8.5 V_Ed 800: M_V,Rd/M_c,Rd 0.971, M_V,Rd 552; §8.8 ρ 0.059 | Pass |
| PU 18 (Ex. 1) — §8.6/8.7 N_pl,Rd 5797, N/N_pl 0.259, M_N,Rd 560 | Pass |
| PU 18 (Ex. 1) — §8.8 V 800 + N 1500: f_y,red 334.2, M_c,Rd 535, N_pl,Rd 5456, M_N,Rd 516 | Pass |
| PU 18 (Ex. 1) — §8.9 member buckling: N_cr 32697, 0.04N_cr 1308, λ̄ 0.421, χ 0.84 (chart), M_Ed ≤ 297 | Pass |
| AZ 18-700 (Ex. 2) — M_c,Rd 639; A_v 3699, V_pl,Rd 758.1 kN/web, 1083 kN/m | Pass |
| AZ 18-700 (Ex. 2) — V_Ed 800: ratio 0.94, M_V,Rd 601 (class 3, elastic analogue) | Pass |
| AZ 18-700 (Ex. 2) — N_pl,Rd 4942, N/N_pl 0.304, M_N,Rd 445 | Pass |
| AZ 18-700 (Ex. 2) — V 800 + N 1500: ρ 0.228, f_y,red 274.1, M_c,Rd 493, N_pl,Rd 3815, M_N,Rd 299 | Pass |
| Handbook Ch. 3 Table 3.7 — M_c,Rd for AZ 25-800 / PU 28-1.0 in S 430 GP (new and corroded) | Pass |
| Handbook Table 8.7 — AZ 18-700 slant height c 527.4 mm and (c/t_w)/ε 75.5 / 79.3 / 82.0 (S 390 / 430 / 460) | Pass |
| documented difference — AZ 18-700 S 355: (c/t_w)/ε = 72.02 > 72 so the engine applies the shear-buckling clause | Pass |
fe-design-checks-strut-web-validation.test.ts
W3-3 — `fe-design-checks/strut.ts` (the per-element strut check) against published column-buckling values.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
W3-3 — `fe-design-checks/strut.ts` (the per-element strut check) against published column-buckling
values. Every expected number below is printed in its source; none is the equation re-derived.
The strut check's buckling line is N_b,Rd = χ·A·f_y/γ_M1 with χ the Perry–Robertson reduction factor
(EN 1993-1-1:2005 Eq. 6.49, α from Table 6.1), evaluated by `bucklingReduction` in fe-design-checks/
shared.ts — the SAME helper `strut-design.ts` uses (shared.ts header cites it), so the published
column-curve tables that gate strut-design.ts gate this check too. The check carries γ_M0 = γ_M1 = 1.00
(EN 1993-1-1 §6.1(1) NOTE 2B) and E = 210 000 MPa (§3.2.6(1)) as code values.
SOURCES (both on disk / opened; the printed tables are reproduced in
strut-design-web-validation.test.ts, which reads the same pages):
1. CEN (1992), Eurocode 3 "Design of steel structures — Part 1-1", DD ENV 1993-1-1:1992 (BSI reprint),
Table 5.5.1 (imperfection factors a 0.21, b 0.34, c 0.49, d 0.76 — the a–d of EN 1993-1-1 Table 6.1)
and Table 5.5.2 "Reduction factors χ" (printed p. 73): χ tabulated to 4 d.p. against λ̄ = 0.2…3.0.
The ENV equation is the identical Perry–Robertson form to EN 1993-1-1 Eq. 6.49; the table therefore
gates χ for this check. λ1 = 93.9 ε (cl. 5.5.1.2(1)) for f_y = 235, E = 210 000.
2. L. Gardner & D.A. Nethercot, "Designers' Guide to Eurocode 3: EN 1993-1-1" (Thomas Telford),
Examples 6.7 and 6.9, inputs and results as reproduced on SDC Verifier's public benchmark pages
(URLs in fe-design-checks-d277-web-validation.test.ts): Ex. 6.7 CHS 244.5×10 S355, A 7370 mm²,
I 50.73e6 mm⁴, pinned L 4 m → N_b,Rd 2297 kN, N_c,Rd 2616 kN; Ex. 6.9 A 8300 mm² S355 →
N_b,Rd,y 2266.0 / N_b,Rd,z 1209.2 kN, N_c,Rd 2946.5 kN. (The d277 file already asserts these
against checkStrut; they are re-asserted here so THIS file is the standalone per-element record.)
HOW THE CHECK IS DRIVEN. For the ENV Table 5.5.2 rows the radius of gyration is fixed at i = 100 mm and
the buckling length is set so λ̄ is exactly the tabulated value: λ̄ = (L_cr/i)/λ1 → L_cr = λ̄·λ1·i. With
A = 10 000 mm² and f_y = 235 MPa, N_c,Rd = A·f_y/γ_M0 = 2350 kN and N_b,Rd = χ·2350 kN; the table's χ
is recovered as N_b,Rd/2350 and compared with the printed 4-d.p. entry. γ_M1 = 1.00.
TOLERANCES, justified by the sources' own rounding. ENV Table 5.5.2 prints χ to 4 d.p.; the tolerance is
5e-5 (half the last printed digit) + the check's own float carry, taken as 5e-4 — the same allowance the
strut-design web-validation makes. No tolerance was widened to make a value pass. The Designers' Guide
values are printed to 3–4 significant figures; the d277 tolerances (0.5 % on χ, 0.1–0.2 % on N_b,Rd) are
kept.
Ledger: ENV Table 5.5.2 — 30 χ values (curves a and b, λ̄ 0.2…3.0). Designers' Guide — Ex. 6.7 (N_b,Rd,
N_c,Rd) + Ex. 6.9 (N_b,Rd y and z, N_c,Rd) = 5 values. Total 35 published values.
| Test block (the published value it checks) | Verdict |
| ENV 1993-1-1 Table 5.5.2 — curve a (α = 0.21), λ̄ = 0.2…1.5 (14 published χ values) | Pass |
| ENV 1993-1-1 Table 5.5.2 — curve a (α = 0.21), λ̄ = 1.6…3.0 (15 published χ values) | Pass |
| ENV 1993-1-1 Table 5.5.2 — curve b (α = 0.34), λ̄ = 0.2…1.1 (10 published χ values) | Pass |
| Designers’ Guide Ex. 6.7 (CHS 244.5×10 S355, L 4 m, curve a): N_b,Rd 2297, N_c,Rd 2616 kN | Pass |
| Designers’ Guide Ex. 6.9 (A 8300, S355, curve a) y-axis: N_b,Rd 2266 kN, N_c,Rd 2946.5 kN | Pass |
| Designers’ Guide Ex. 6.9 (A 8300, S355, curve a) z-axis: N_b,Rd 1209.2 kN, N_c,Rd 2946.5 kN | Pass |
fe-staged-excavation-web-validation.test.ts
WEB-BENCHMARK validation for the staged-excavation FE engine.
Analyses validated: fe-staged-excavation · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the staged-excavation FE engine.
Anchored on the basal-heave stability number — the excavation analogue of the bearing
capacity: a WIDE undrained cut collapses when γ·H_crit/cu reaches Nc = 2+π ≈ 5.14
(Prandtl, the bearing mechanism inverted); Terzaghi (1943) / Bjerrum & Eide (1956) give
5.1–7 as the cut narrows/deepens. HONEST: this FE collapse number is CONSERVATIVE
(sharp-corner stress concentration), landing ≈ 4–5.5 — the staged DEFORMATION (heave
build-up, per-stage redistribution) is the reliable output. Sources: Terzaghi (1943)
Theoretical Soil Mechanics; Bjerrum & Eide (1956) Géotechnique 6(1); Smith, Griffiths &
Margetts Ch.6; the geoengineer.org basal-heave stability page.
STATUS (audited 2026-10-07) — BLOCKED for release; formula-fidelity at best. The only published number the
engine is compared with is the Prandtl / Terzaghi basal-heave stability number Nc = 2 + π = 5.14
(Bjerrum & Eide's 5.1–7 is a chart range). MEASURED today on the wide undrained cut of the first test
(cu = 30 kPa, γ = 18 kN/m³, H = 10 m, half-width 40 m, 6 stages), the reported Nc for mesh = 4, 6, 8, 10, 12 is
4, 5, 5, 4, 4 (−22 % … −3 % against 5.14), and the value is quantised by the lift size. The engine's own
module header already states that mesh refinement drifts the number LOWER, not toward 5.14, and names the
cause (sharp-corner stress concentration ending the viscoplastic solve early) and the cure (Sloan limit-
analysis LP) — an architectural change beyond a validation fix, so it was not attempted. Shortfall against
the ≥20-published-values / ≥2-sources bar: 1 published value (5.14), matched only within a −22 % … −3 % band.
| Test block (the published value it checks) | Verdict |
| SE web: wide-cut collapse stability number in the basal-heave band [4, 5.5] (≈ Prandtl 5.14) | Pass |
| SE web: base heave builds up progressively through the stages | Pass |
| SE web: FoS falls as the cut deepens | Pass |
| SE web: higher cu ⇒ deeper stable excavation | Pass |
| SE web: heave field + per-stage results are well-formed | Pass |
⚑ ground-anchor-web-validation.test.ts
GROUND-ANCHOR — web-validation benchmark against FHWA GEC-4 tables and design examples.
Analyses validated: ground-anchor · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
GROUND-ANCHOR — web-validation benchmark against FHWA GEC-4 tables and design examples.
`ground-anchor.ts` sizes a grouted anchor: T_ult = π·D·L_f·τ_skin on the fixed (bond) length, the
allowable bond load T_ult/FoS, the tendon working capacity η·f_pu·A_ps, and the governing minimum.
SOURCES (each opened; locator next to every value):
1. Sabatini, P.J. & Pass, D.G. (1999) [with R.C. Bachus], Geotechnical Engineering Circular No. 4:
Ground Anchors and Anchored Systems, FHWA-IF-99-015, Federal Highway Administration (U.S. DOT) — Table 9
"Properties of prestressing steel bars (ASTM A722)" and Table 10 "Properties of 15-mm diameter
prestressing steel strands" (printed p. 77; SI rows), Table 6 and Table 8 (presumptive ultimate load
transfer, kN/m, printed pp. 71 and 74), §5.3.6 (safety factors 2.0 in soil, 3.0 in rock; PTI rock
bond rule, p. 74), and Appendix A Design Examples 1 (soil, printed pp. A-8 to A-9) and 2 (rock,
printed pp. A-26 to A-27). Downloaded (read on 2026-10-07) from
https://www.fhwa.dot.gov/engineering/geotech/pubs/if99015.pdf (public domain, 304 pp.).
2. CGS (2006), Canadian Foundation Engineering Manual, 4th ed., Canadian Geotechnical Society —
Tables 26.6 and 26.7 "Estimation of capacity for pressure-grouted anchors (after FHWA 1984)"
(printed pp. 423-424): ultimate load transfer in kN of capacity per metre of bond length, by ground
and rock type; §26.12.4.1: allowable load = ultimate / 3 where no pull-out test is made.
HOW THE ENGINE IS DRIVEN. The published soil and rock values are RATES (kN per metre of bond length),
not bond stresses, so the engine is given the drill-hole diameter D and the equivalent bond stress
τ = rate/(π·D) through `skin_friction_kpa`; T_ult/L_f is then the rate again. That round trip proves the
π·D·L_f·τ bookkeeping, the FoS division and the governing-mode logic reproduce the published worked
numbers; it does NOT test the ground-type derivations of τ (rock α_r·UCS, cohesive α·c_u, granular
Ks·σ′v·tanδ) except the rock rule, which GEC-4 states as a number (10 % of UCS, maximum 3.1 MPa).
TOLERANCES, each from the source's own rounding:
- Tendon tables (Table 9/10): the SI columns are converted from US units (f_pu 150 ksi printed as
1035 MPa [1034.2], 270 ksi as 1860 MPa [1861.6], A_ps 2.66 in² as 1716 mm², and the 1-3/4 in bar's
breaking load printed as the nominal 400 kips = 1779 kN rather than 150 ksi × 2.66 in² = 399 kips),
and every kN value is rounded to an integer. The engine computes η·f_pu·A_ps from the printed f_pu
and A_ps, so the comparison tolerance is 0.5 kN (integer rounding) + 0.25 % (unit-conversion rounding).
The largest deviation measured over the 51 tendon values is 0.33 %.
- Design-example bond capacities are exact arithmetic on printed inputs (100 kN/m ÷ 2.0 × 12 m = 600).
The maximum bond lengths are printed to 0.1 m (8.9, 5.3) → ±0.05 m.
- CFEM load-transfer rates are integers (kN/m) → ±0.5 kN/m.
NOT BENCHMARKED (no published worked answer among the sources opened): the cohesive branch τ = α·c_u
and the granular branch τ = Ks·σ′v·tanδ. Their forms match Craig (2012) Eq. 11.76 and Das (2016)
Eq. 14.94-14.95, but neither prints a solved numeric anchor capacity, and GEC-4's examples are table-based.
The engine's default rock cap (2000 kPa) is LOWER than the PTI/GEC-4 maximum of 3.1 MPa; the cap can be
set to 3100 kPa and that is what the rule test below does.
| Test block (the published value it checks) | Verdict |
| GEC-4 Table 9 — Grade 150 bars (f_pu = 1035 MPa): 0.8 / 0.7 / 0.6 f_pu·A_ps | Pass |
| GEC-4 Table 9 — Grade 160 bars (f_pu = 1104 MPa): 0.8 / 0.7 / 0.6 f_pu·A_ps | Pass |
| GEC-4 Table 10 — strand tendons: 0.8 / 0.7 / 0.6 f_pu·A_ps for 1, 3, 4, 5, 7, 9, 12, 15, 19 strands | Pass |
| GEC-4 Design Example 1 (pp. A-8, A-9) — soil anchor: 12 m bond length at 100 kN/m, FoS 2.0 | Pass |
| GEC-4 Design Example 1 (p. A-9) — tendon selection against the 445 kN design load | Pass |
| GEC-4 Design Example 2 (pp. A-26, A-27) — rock anchor: 7.5 m bond length at 360 kN/m, FoS 3.0 | Pass |
| GEC-4 Design Example 2 (p. A-27) — tendon selection against the 636 kN design load | Pass |
| GEC-4 p. 74 (PTI 1996) — ultimate rock-grout bond ≈ 10 % of UCS, maximum 3.1 MPa | Pass |
| CFEM 2006 Table 26.6 (p. 423) — soil anchors: ultimate load transfer per metre of bond length | Pass |
| CFEM 2006 Table 26.7 (p. 424) — rock anchors: ultimate load transfer per metre of bond length | Pass |
| CFEM 2006 §26.12.4.1 — allowable anchor load = ultimate capacity / 3 where no pull-out test is made | Pass |
⚑ k0-at-rest-web-validation.test.ts
Validation for `k0-at-rest` — Jaky / Mayne-Kulhawy coefficient of earth pressure at rest and the at-rest wall thrust (`k0-at-rest.ts`).
Analyses validated: k0-at-rest · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `k0-at-rest` — Jaky / Mayne-Kulhawy coefficient of earth pressure at rest and the
at-rest wall thrust (`k0-at-rest.ts`).
Published sources (every number below was read from the page named beside it, in the repo's
reference library; the EM 1110-2-2502 table was ALSO read as a rendered page image because its
text layer is OCR of a 1989 scan; none is recalled from memory):
1. USACE EM 1110-2-2502 (1989), Retaining and Flood Walls, Appendix E, Table E-1 "At-Rest Earth
Pressure Coefficients" — column "Jaky, Equation 3-4", φ′ = 10° … 45° in 1° steps, printed to
3 decimals (PDF p. 250).
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage — §12.2 Eqs 12.3/12.4
and Example 12.1 (pp. 597-599).
3. Bowles, J.E. (1997), Foundation Analysis and Design 5th ed., McGraw-Hill — Eq. 2-18a, Example 2-2
(K0 for nc and OCR = 5 clay), and the K0 values worked inside Examples 4-10, 13-6, 14-1, 16-1
and the Ch. 12 bridge-abutment discussion.
4. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley — Ch. 8 Example 8.2.
5. NAVFAC DM-7.02 (1986), Foundations and Earth Structures — paragraph "e. Restrained Walls", which
follows Figure 12 of the lateral-pressure section.
WHAT THE ENGINE IS. `computeK0AtRest` evaluates Jaky's K0,nc = 1 − sin φ′ and the Mayne-Kulhawy
over-consolidated form K0 = (1 − sin φ′)·OCR^sin φ′, then the triangular at-rest stress σ′h = K0·γ·H and
thrust P0 = ½·K0·γ·H² for a DRY backfill with no surcharge and H/3 lever arm.
TOLERANCES, stated per group:
· Table E-1 and the Bowles / NAVFAC K0 values are printed to 2-3 decimals, so the tolerance is one
half unit in the last printed digit (0.0005 for 3 d.p., 0.005 for 2 d.p.) — the book rounded the
same closed-form number the engine computes.
· Das Ex. 12.1 rounds σ′h to 20.63 kN/m² (exact 20.625) — tolerance 0.01.
· Bowles Ex. 2-2 rounds K0,nc to 0.58 (exact 0.5774) before applying OCR^n, so its 1.15 differs from the
unrounded 1.1399 by the propagated 0.45 % rounding of that factor — tolerance 0.012.
SCOPE OF THE EVIDENCE, stated honestly. The NC branch has 36 tabulated + 12 worked published values.
The OVER-CONSOLIDATED branch has only Bowles Ex. 2-2 (two printed numbers, 1.14 and 1.15); no second
independent OCR worked answer was found in the library (Craig, FHWA-NHI-06-088 and Han print the
Mayne-Kulhawy equation but no numeric K0,oc). The engine is therefore released on the strength of the
NC closed form plus one OC example — a reader relying on heavily over-consolidated K0 should know that.
KNOWN, DELIBERATELY-UNTESTED PUBLISHED STATEMENT (investigated, not hidden): the Canadian Foundation
Engineering Manual 4th ed. §24.2 text layer gives the Mayne-Kulhawy exponent as "m ≈ 1 − sin φ′",
which disagrees with Das Eq. 12.4, the FHWA soils-and-foundations manual (Ω = sin φ′), Han's Eq. 2.104
and Bowles (n = sin φ′). The majority of the sources read support sin φ′, which is what the engine uses;
the CFEM line was not asserted and was not re-checked against the page image.
| Test block (the published value it checks) | Verdict |
| EM 1110-2-2502 Table E-1: Jaky K0 for φ′ = 10°…27° (printed 0.826 … 0.546) | Pass |
| EM 1110-2-2502 Table E-1: Jaky K0 for φ′ = 28°…45° (printed 0.531 … 0.293) | Pass |
| Das Example 12.1: K0 = 0.5, σ′h = 20.63 kN/m² at 2.5 m, triangle force 25.788, lever arm 0.833 m | Pass |
| Lambe & Whitman Example 8.2: initial horizontal stress K0·γ·z = 24.8 kN/m² at 3 m | Pass |
| NAVFAC DM-7.02: "for φ′ = 30°, K0 = 0.5" | Pass |
| Bowles: K0 printed in Examples 4-10, 13-6, 16-1 and the Ch. 12 abutment discussion | Pass |
| Bowles Example 14-1: K0 = 0.50, R0 = ½ × 16.5 × 9.3² × 0.5 = 357 kN, average pressure 38.38 kPa | Pass |
| Bowles Example 2-2 (φ′ = 25°, OCR = 5): K0,nc = 0.58 and K0,OCR = 1.14 / 1.15 | Pass |
| Bowles §2-8: a fluid has K0 = 1.0, the isotropic limit of Jaky at φ′ = 0 | Pass |
mse-wall-web-validation.test.ts
`mse-wall` — anchored to the FHWA GEC-11 worked example.
Analyses validated: mse-wall · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`mse-wall` — anchored to the FHWA GEC-11 worked example.
SOURCES
FHWA, "Design and Construction of Mechanically Stabilized Earth Walls and Reinforced Soil
Slopes", Publication No. FHWA-NHI-10-024 (Vol I) and FHWA-NHI-10-025 (Vol II),
November 2009 (GEC No. 11):
Vol I §4.4.2 Eq. 4-2 / 4-3 — external active coefficient Kab (Coulomb, after
AASHTO 2007 Figure 4-4), broken-backslope case
Vol I §4 Eq. 4-28 σH = Kr[(γr·Z)·γEV-MAX] (level, no surcharge)
Eq. 4-29 σH = Kr[γr(Z + Seq)·γEV-MAX] (sloping backfill)
Eq. 4-30 σH = Kr[γr(Z + heq)·γEV-MAX] (live-load surcharge)
γEV-MAX = 1.35 ("EV" maximum load factor); heq = 2 ft
Vol I §4.3.2 reinforcement vertical spacing sv ≤ 0.8 m recommended
Vol II App. E EXAMPLE E1 — "MBW unit faced, MSE wall with broken backslope and live
load surcharge, reinforced with geogrids" (Format A)
EXAMPLE E1's PUBLISHED DESIGN SITUATION (Vol II pp. E1-2 … E1-4)
Exposed height He = 18 ft, MBW facing with 3° batter, 2H:1V broken backslope 9 ft high,
level toe. Minimum embedment H/20 = 0.9 ft, "therefore use minimum embedment depth of
2.0 ft. Thus, design height of the wall, H = 20 ft." Reinforcement length 0.9H = 18 ft.
Foundation φ'f = 30°, γf = 125 pcf. Reinforced fill φ'r = 34°, γr = 125 pcf.
Retained backfill φ'b = 30°, γb = 125 pcf. Traffic surcharge heq = 2.0 ft.
PUBLISHED INTERMEDIATES USED AS ANCHORS
angle I = arctan(9/40) = 12.7° (the manual rounds; the exact value is 12.6804°)
Coulomb Ψ term = 2.133
external coefficient Kab = 0.360
THE IDENTITY THAT MAKES THIS A REAL CHECK
Our engine computes the external coefficient with the RANKINE sloping-backfill form
Ka = cosβ·(cosβ − √(cos²β − cos²φ))/(cosβ + √(cos²β − cos²φ)), whereas GEC-11 Eq. 4-2/4-3
is the COULOMB form with wall friction δ. Those are the same number when δ = β on a
vertical face — which is exactly the case Figure 4-4 and Example E1 use ("for vertical and
near vertical wall face", β = δ = I). Rather than take that on trust, the test computes
both forms independently and requires agreement to 1e-12 across seven φ/β combinations.
So the engine is checked against the standard's own formula, not merely against a number
that happens to match at one point.
WHY THIS ENGINE
`mse-wall` was one of the 27 bespoke engines with ZERO published-example validation,
despite already carrying an `MseDesignCode` selector for FHWA / BS 8006 / IS 14458. It was
built to the right sources and never checked against one.
| Test block (the published value it checks) | Verdict |
| GEC-11 Example E1: backslope angle I = arctan(9/40) = 12.7° | Pass |
| GEC-11 Vol I Eq. 4-3: the Coulomb Ψ term = 2.133 at Example E1’s conditions | Pass |
| GEC-11 Vol I Eq. 4-2: external coefficient Kab = 0.360, and our engine reproduces it | Pass |
| the Coulomb (δ = β, θ = 90°) and Rankine-sloped forms are IDENTICAL — swept, not assumed | Pass |
| GEC-11 Eq. 4-28 / 4-29 / 4-30: the published EV load factor is 1.35 and heq = 2 ft | Pass |
| GEC-11 Example E1: the engine runs the published geometry and reports coherent externals | Pass |
| §4.4.2: the external thrust uses the RETAINED soil, and a weaker retained soil raises it | Pass |
| §4.3.2: a vertical spacing above 0.8 m is warned | Pass |
| a backslope steeper than the retained friction angle is refused, not silently zeroed | Pass |
| every numeric output is finite at the published configuration | Pass |
⚑ rc-section-web-validation.test.ts
Dedicated validation for the singly-reinforced RC flexural section (`rc-section.ts`): limit-state flexure to IS 456:2000 cl.
Analyses validated: rc-section · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the singly-reinforced RC flexural section (`rc-section.ts`): limit-state flexure to
IS 456:2000 cl. 38.1 and Annex G (G-1.1): xu,max/d, Mu,lim, required Ast, minimum/maximum steel.
PUBLISHED SOURCES (each opened and read for this suite):
1. Bureau of Indian Standards (1980), SP 16 "Design Aids for Reinforced Concrete" (prepared to the 1978
edition of the Code). NOT in the local library (independent audit 2026-10-07, A4-2); the values below were read from the law.resource.org copy named in this header and are page-locatable there:
Table 3 (page 48, fck = 25 N/mm², pt against Mu/bd² for fy 240/250/415/480/500); Tables C, D (page 10:
Mu,lim factors); worked Examples 1 and 2 (page 11). Also obtained from law.resource.org
(https://law.resource.org/pub/in/bis/S03/is.sp.16.1980.pdf), read 2026-10-06.
2. IS 456:2000, Plain and Reinforced Concrete - Code of Practice, library copy: clause 38.1 Note (limiting
xu,max/d = 0.53 / 0.48 / 0.46 for Fe 250 / 415 / 500) and Annex G-1.1 (the moment-of-resistance
expressions the engine implements).
3. NPTEL (IIT Kharagpur, Design of Reinforced Concrete Structures), Module 3 "Limit State of Collapse:
Flexure", Lesson 6 "Numerical Problems on Singly Reinforced Rectangular Beams" (Version 2 CE IIT
Kharagpur), Design Problem 3.1 (fck 20, fy 415, b 250): text read through the idoc.pub mirror
https://idoc.pub/documents/numerical-problems-on-singly-reinforced-rectangular-beams-134wp8mprzl7 on
2026-10-06 (the original NPTEL file was not reachable from here). No publication year is printed in
the text that was read, so none is claimed.
WHAT IS PUBLISHED ANSWER HERE. SP 16 Table 3 is a printed table of the required steel percentage for
given Mu/bd²; Tables C/D are printed limiting-moment factors; Examples 1-2 and the NPTEL problem print the
worked Mu,lim and Ast results. Each `near(...)` with a locator comment is one such printed number.
The engine is used with b = 1000 mm, d = 1000 mm for the SP 16 table so that pt = Ast/(b d) × 100 directly.
TOLERANCES, AND WHY THEY ARE NOT ONE HALF-UNIT EVERYWHERE. Two bounded differences between the sources and the
engine are stated by the sources themselves, so they are allowed for explicitly rather than hidden:
(a) SP 16 derives its tables with a lever arm of 0.416·xu (p.10: "0.416 xu (which has been rounded off to
0.42 xu in the code)"), giving the coefficient 1.005 in its Mu expression, whereas IS 456:2000 Annex G
prints 0.42 / coefficient 1.0, which the engine follows. For the pt tables the resulting relative
difference is at most about 0.2 % (worst case at the limiting moment), so the pt tolerance is one
half-unit of the printed third decimal plus 0.25 % of the value.
(b) For Mu,lim the same 0.416 versus 0.42 lever arm gives a relative difference of
(1 - 0.42x)/(1 - 0.416x) - 1, at most 0.3 % for xu,max/d up to 0.53; the printed Mu,lim factors are also
rounded to three significant figures (up to 0.25 %), so Mu,lim tolerances are 0.3 % plus the printed
half-unit.
(c) The engine inverts Annex G with SP 16's constant 4.6 where the exact constant is 4/0.87 = 4.5977; that
makes the engine's Ast larger (conservative) by about 0.07 %, so the NPTEL Ast tolerances are 0.1 %.
NOT ASSERTED. SP 16 prints inadmissible cells as blanks and still shows values in the narrow band between the
engine's Mu,lim (0.42 lever arm) and SP 16's own limit (0.416), e.g. fy 250, fck 25, Mu/bd² = 3.72 (SP 16
2.196, limit 3.73; engine limit 3.71). Values inside that band are deliberately not asserted. The chart
readings of SP 16 Example 2 (pt 0.475 % and 0.78 %, read off plotted charts) are also not asserted.
| Test block (the published value it checks) | Verdict |
| SP 16 Table 3 (fck 25): Fe 415 column, printed pt (%) against Mu/bd² | Pass |
| SP 16 Table 3 (fck 25): Fe 250, Fe 500, Fe 480 and Fe 240 columns | Pass |
| SP 16 Table 3 blanks: Mu/bd² above the Table D limit is not a singly-reinforced design | Pass |
| SP 16 Table C: Mu,lim / (fck b d²) for Fe 250, 415, 500 (printed to 3 d.p.) | Pass |
| SP 16 Table D: Mu,lim / bd² (N/mm²) for fck 15-30 and Fe 250/415/500 | Pass |
| SP 16 Example 1: 30 x 60 cm beam, M 15, Fe 415, Mu = 170 kN·m, d = 56.25 cm | Pass |
| SP 16 Example 2: slab, 10 cm thick, d = 8 cm, Mu = 9.60 kN·m/m, M 15 — printed limiting moments | Pass |
| IS 456:2000 cl.38.1 Note: xu,max/d = 0.53, 0.48, 0.46 for Fe 250, 415, 500 (printed to 2 d.p.) | Pass |
| NPTEL Lesson 6 Design Problem 3.1: printed limiting depth, Ast and Mu,lim | Pass |
⚑ retaining-wall-web-validation.test.ts
RETAINING-WALL — web-validation benchmark against published worked examples and Rankine tables.
Analyses validated: retaining-wall · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
RETAINING-WALL — web-validation benchmark against published worked examples and Rankine tables.
`retaining-wall.ts` is the four-check stability analysis of a cantilever wall with level backfill:
Rankine thrust on the virtual back plane through the heel (H′ = stem height + base thickness),
overturning, sliding, eccentricity and base pressure, with passive resistance at the toe ignored.
SOURCES (each opened; locator next to every value):
1. Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill — Example 12-6 "Design the
retaining wall of Fig. E12-6a" (§12-7, printed pp. 776-779) with Table E12-6 (weights, arms, moments);
Example 12-5 "Analyze the retaining wall … for overturning and sliding stability" (printed p. 772);
Table 11-3 "Rankine active earth pressure coefficients Ka" (printed p. 603, read from the page image).
2. Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage, Table 12.1 "Variation of
Ka(R)" (printed p. 608), the α = 0°, θ = 0° row (Rankine, vertical back, level ground).
WHY THESE TWO EXAMPLES AND NOT DAS EXAMPLE 13.1. Das Example 13.1 (the classic cantilever wall) has an
INCLINED backfill (α = 10°), a tapered stem, passive resistance in the sliding check and the vertical
component Pv of an inclined thrust; none of those is in this engine, so its weights and moments cannot be
reproduced and it is not used. Bowles Example 12-6 is a constant-thickness stem, level backfill wall with a
surcharge, which is this engine's geometry. The book DELIBERATELY takes Ka = K0 = 1 − sin 36° = 0.412 (not
Rankine) "to account for compaction-induced lateral pressures"; the engine takes φ, so the test supplies
φ = 2(45° − atan√0.412) = 24.6°, whose Rankine coefficient is exactly 0.412. That is a change of INPUT to
match the source's assumption, not a tolerance change.
WHAT THE ENGINE DOES NOT DO, hence what is not asserted:
- Bowles adds the vertical component P′av = Pa tan(0.8φ) of friction on the heel plane to the resisting
moment (36.23 kN·m/m); the engine does not. Bowles' overturning number N0 = 3.14 includes it, so it is
not compared; the sum WITHOUT it (156.36 − 36.23 = 120.13) is printed in the text and is compared.
- Bowles' sliding uses the effective width B′ = B − 2e for base adhesion, and bearing uses Meyerhof's
rectangular pressure q = ΣV/B′ = 71.7 kPa; the engine uses the full width and the linear 1 ± 6e/B form.
Neither printed result is compared (they follow a different method, not a different number).
TOLERANCES, each from the source's rounding:
- Bowles prints forces to 0.01 kN and moments to 0.01 kN·m; the engine's values use unrounded inputs, so
±0.03 on weights/moments, ±0.05 on the thrust (its pressures are rounded to 0.01 kPa before summing).
- The resultant position and eccentricity are printed to 2 d.p. (0.70, 0.29, 0.33) → ±0.005.
- Ka tables: Bowles 4 d.p. (±0.00005); Das 3 d.p. (±0.0005); the engine's `ka` is unrounded.
- Example 12-5 used K′a = 0.171 for φ = 45° (the exact tan²(22.5°) = 0.1716): 0.33 % high in the engine,
so the forces/moments from it are compared to 0.4 %.
| Test block (the published value it checks) | Verdict |
| Bowles Ex. 12-6 — geometry and heel-plane thrust: B = 1.98 m, H′ = 2.90 m, Pa = 44.30 kN/m, Mo = 49.75 | Pass |
| Bowles Ex. 12-6 — Table E12-6: weights and moments about the toe | Pass |
| Bowles Ex. 12-6 — resultant position and eccentricity: x̄ = 0.70 m, e = 0.29 m < B/6 = 0.33 m | Pass |
| Bowles Ex. 12-6 — the Rankine coefficient the book set aside: Table 11-3 gives 0.260 for φ = 36° | Pass |
| Bowles Ex. 12-5 (p. 772) — Pa = 96.28 kN/m, Mo = 245.58 kN·m/m and the two concrete parts | Pass |
| Bowles 5e Table 11-3 (p. 603) — Rankine Ka, β = 0, φ = 26°…42° | Pass |
| Das 8e Table 12.1 (p. 608) — Ka(R) at α = 0°, θ = 0°, φ′ = 28°…40° | Pass |
secant-pile-wall-web-validation.test.ts
Web-benchmark validation for `secant-pile-wall`.
Analyses validated: secant-pile-wall · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `secant-pile-wall`.
SOURCES (each cited at the assertion that uses it):
DIN 4126:2013-09 §5.3 — secant-pile overlap geometry; watertightness requires the overlap
remaining after verticality tolerance to exceed 0.10·D. §7 — concrete grades, C25/30+
for a structural (secondary) pile.
BS EN 1538 / DIN 4126 — 0.5 % verticality tolerance as the default construction assumption.
Rankine / Coulomb (1776) / IS 14458 (Part 2):1997 Cl 5.2 — earth-pressure coefficients and
wall friction δ.
IS 456:2000 Annex G G-1.1.b — M_u,lim = 0.138·f_ck·b·d²; Table 16 — 75 mm cover.
IS 2911 (Part 1 Sec 2):2010 — bored-pile α-method shaft friction and Cl 7.1 FoS 2.5;
Tomlinson (1977) α bands; Cl 6.3.1.1 end bearing (9·s_u in clay).
Bjerrum & Eide (1956) / Terzaghi (1943) — basal heave FoS = N_c·s_u/(γH + q).
CIRIA C760 (2017) §6.2 — secant walls; §6.3 / Padfield & Mair (1984) — free-earth propping.
Each expected value reconstructs its chain in code (batch 7t method note).
| Test block (the published value it checks) | Verdict |
| watertightness is the overlap left AFTER verticality tolerance, vs 0.10·D | Pass |
| a deeper wall loses more overlap and eventually fails watertightness | Pass |
| the overlap must be geometrically possible | Pass |
| per-pile actions use pitch = Ds + Dp − 2·ov, halved for hard/hard | Pass |
| a wider overlap tightens the pitch and so reduces the load per pile | Pass |
| moment capacity is IS 456 M_lim = 0.138·f_ck·Ds·d_eff², with d_eff floored (E-12) | Pass |
| a below-grade secondary concrete grade is flagged against DIN 4126 §7 | Pass |
| vertical capacity uses the Tomlinson α bands and 9·s_u end bearing, with FoS 2.5 | Pass |
| in sand the capacity is K₀·σv·tanδ shaft plus a halved Meyerhof base | Pass |
| basal heave uses N_c = 7 on γ_top·H + q, and withholds in a frictional soil | Pass |
| a prop reduces the wall moment and its force is reported per metre and per pile | Pass |
| invalid geometry is refused with a zeroed result | Pass |
seismic-structural-web-validation.test.ts
Web-benchmark validation for TWELVE seismic, structural and deep-foundation runner engines.
Analyses validated: bray-travasarou, concrete-durability, design-spectrum, embankment-stress, excavation-settlement, helical-pile, machine-foundation, makdisi-seed, newmark-displacement, rc-section, strut-design, tunnel-ground-reaction · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for TWELVE seismic, structural and deep-foundation runner engines.
Family suite — `runner-coverage.mjs` counts ENGINES, so one file anchoring twelve is deliberate.
ENGINES AND SOURCES
makdisi-seed — Makdisi & Seed (1978) JGED 104(GT7) deformable embankment
newmark-displacement — Newmark (1965) sliding block; Jibson (2007) regression
bray-travasarou — Bray & Travasarou (2007) ASCE JGGE 133(4) 381-392
design-spectrum — IS 1893 (Part 1):2016 Cl 6.4.2, Fig. 2, Table 3
strut-design — IS 800:2007 Cl 7.1.2, Perry-Robertson buckling curves
rc-section — IS 456:2000 Cl 38 + Annex G singly-reinforced flexure
concrete-durability — IS 456:2000 Tables 4 & 5 sulphate exposure classes
machine-foundation — IS 2974-1; Barkan (1962); Richart, Hall & Woods (1970)
tunnel-ground-reaction — Hoek convergence-confinement; Carranza-Torres & Fairhurst
excavation-settlement — Clough & O'Rourke (1990) GSP 25; Boscardin & Cording (1989)
embankment-stress — Osterberg (1957) trapezoidal fill influence
helical-pile — ICC-ES AC358; Hoyt & Clemence (1989); Perko (2009)
Every expected value is reconstructed from the published expression in code.
| Test block (the published value it checks) | Verdict |
| makdisi-seed uses the 1978 fundamental period and normalised displacement | Pass |
| newmark-displacement reproduces the Jibson (2007) regression | Pass |
| bray-travasarou reproduces the 2007 flexible-sliding-mass regression | Pass |
| design-spectrum follows IS 1893 (Part 1):2016 Cl 6.4.2 | Pass |
| strut-design reproduces the IS 800:2007 Perry-Robertson buckling curve | Pass |
| rc-section reproduces IS 456:2000 Cl 38 flexure and the steel limits | Pass |
| concrete-durability applies the IS 456 Table 4 sulphate classes | Pass |
| machine-foundation reproduces the Barkan C_u stiffness and the SDOF response | Pass |
| tunnel-ground-reaction reproduces the Hoek convergence-confinement solution | Pass |
| excavation-settlement applies the Clough & O'Rourke (1990) envelopes | Pass |
| embankment-stress uses the Osterberg (1957) trapezoidal influence | Pass |
| helical-pile reproduces the AC358 individual-bearing plate method | Pass |
sheet-pile-second-source-web-validation.test.ts
SHEET-PILE — second-source web-validation suite (companion to `sheet-pile-web-validation.test.ts`).
Analyses validated: sheet-pile · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
SHEET-PILE — second-source web-validation suite (companion to `sheet-pile-web-validation.test.ts`).
The companion suite benchmarks `sheet-pile.ts` value-by-value against Das, B.M. (2016), Principles of
Foundation Engineering, 8th ed., Cengage, Chapter 14 (Examples 14.1, 14.2, 14.7, 14.9; text pp. 719-745) —
91 assertions, ONE source, and it exercises the closed-form `rankine_classical` method. This file adds the
independent sources the release bar asks for, for the parts of the engine Das does not reach.
SOURCES (each opened; locator next to every value):
1. Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill — Table 11-3 "Rankine active
earth pressure coefficients Ka" and Table 11-4 "Rankine passive earth pressure coefficients Kp"
(printed p. 603, β = 0 row, φ = 26°…42°, 4 d.p.). Read from the rendered page image (pdf page 632).
These are the coefficients both the closed-form and the net-envelope methods are built on.
2. Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012), Chapter 22:
Example 22.4 "Analysis of anchored bulkhead in sand by free earth support method" (printed pp.
419-420) and Example 22.3 "Analysis of cantilever sheet piles in sand by simplified method"
(printed pp. 418-419). The simplified pressure diagram of these examples (active behind, passive in
front below the dredge line, no pressure reversal, ΣM about the toe or the tie) is the net-pressure
envelope of `method: 'net_envelope'`, so the pressure ordinates Varghese prints are exactly what the
engine's profile must contain.
WHAT IS AND IS NOT A PUBLISHED-ANSWER CHECK HERE.
- Bowles Tables 11-3/11-4 (18 values) and Varghese's printed pressure ordinates 6, 48, 20 and 30 kN/m²
and the zero-pressure level a = 1.0 m (5 values) are published numbers compared with the engine.
- Varghese's PRINTED EMBEDMENTS (Ex. 22.4 D = 6.3 m, Ex. 22.3 D = 6.35 m) are NOT reproduced, and the
engine is not at fault: the book's cubics do not follow from its own stated equilibrium equations.
Ex. 22.4. The book equates (1/2)(1/3)(18)(8 + D)²[(2/3)(8 + D) − 1] to (1/2)(3·18·D)·D·(2D/3 + 7).
Expanding that gives D³ + 9D² − 21D − 52 = 0, root D = 3.113 m. The book prints
D³ + 8.75D² − 81.25D − 76 = 0, whose root is 6.235 m (printed as 6.3 m).
Ex. 22.3. The book sums the active moment about the toe as 30D + 120 + 10(D + 3)² + (10/9)(3 + D)²,
but the triangle of active pressure below the water table has force (5/3)(D + 3)² and arm
(D + 3)/3, i.e. a moment (5/9)(D + 3)³ — cubic, not quadratic, in D. Correct equilibrium
5D³ = 30D + 120 + 10(D + 3)² + (5/9)(D + 3)³ has root D = 7.455 m; the book's quadratic form
gives 6.35 m.
The two "proof-by-consequence" tests below show the engine agrees with the roots of the book's STATED
equations (3.113 m and 7.455 m); those two roots are my own hand arithmetic from the book's equations,
labelled as such, and are NOT counted as published answers.
NOT BENCHMARKED (recorded in the validation report). USS Steel Sheet Piling Design Manual (1984) Design
Examples (printed pp. 86-100) and NAVFAC DM-7.2 Figure 21 are complete solved walls, but they use passive
coefficients from wall-friction charts (Kp = 6.56, 6.63), different Ka above and below the dredge line,
and line loads; the engine's single-φ layer model cannot be fed those coefficients, so they are not
reproducible as inputs. Craig (2012) Examples 11.6 and 11.8 apply Eurocode 7 partial factors and tabulate
Ka = 0.33 while quoting 0.35.
TOLERANCES: Bowles tables are printed to 4 d.p. → ±0.00005. Varghese prints ordinates as exact products of
his rounded coefficients (1/3, 3) → ±0.05 kN/m² on the engine's interpolated ordinate; a = 1.0 m → ±0.01 m.
| Test block (the published value it checks) | Verdict |
| Bowles 5e Table 11-3 (p. 603) — Rankine Ka, β = 0, φ = 26°…42° | Pass |
| Bowles 5e Table 11-4 (p. 603) — Rankine Kp, β = 0, φ = 26°…42° | Pass |
| Varghese Ex. 22.4 (p. 420) — active pressure at the tie level and at the dredge line | Pass |
| Varghese Ex. 22.4 (p. 420) — the net pressure returns to zero a = 1.0 m below the dredge line | Pass |
| Varghese Ex. 22.3 (p. 419) — active pressures at the water table and at the dredge line | Pass |
| Ex. 22.4 — engine embedment equals the root of the moment equation the book states (3.113 m), not the printed 6.3 m | Pass |
| Ex. 22.3 — engine embedment equals the root of the correct cantilever equilibrium (7.455 m), not the printed 6.35 m | Pass |
sheet-pile-web-validation.test.ts
SHEET-PILE WALLS — web-validation benchmark against published worked examples.
Analyses validated: sheet-pile · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
SHEET-PILE WALLS — web-validation benchmark against published worked examples.
SOURCE (single, primary, closed-form):
Das B.M., "Principles of Foundation Engineering", Cengage Learning,
Chapter 14 "Sheet-Pile Walls":
§14.4 Cantilever sheet piling penetrating sandy soils, Eqs (14.1)-(14.23)
§14.5 Special cases — the no-water-table form, Eqs (14.24)-(14.35)
§14.9 Free earth support method, penetration of sandy soil, Eqs (14.67)-(14.69)
§14.11 Moment reduction for anchored walls penetrating sand (Rowe 1952)
Worked Example 14.1 (cantilever, water table at 2 m) — text pp. 719-721
Worked Example 14.2 (the same wall with NO water table) — text pp. 723-724
Worked Example 14.7 (anchored, free-earth support) — text pp. 737-738
Worked Example 14.9 (Rowe moment reduction, section choice) — text p. 745
WHY THIS SOURCE. `sheet-pile.ts` previously cited "Bowles 5e §14-2 … §14-6"
for the cantilever / free-earth / Rowe procedures. Verified against the book:
Bowles 5e Chapter 14 is "Walls for Excavations" (braced cuts) and Bowles
Chapter 13 — the sheet-pile chapter — does not present these closed-form
solutions at all; it replaces them with an FEM beam-on-nonlinear-springs
analysis (§13-6). The section numbers 14.3 / 14.4 / 14.11 belong to DAS
Chapter 14. Citations corrected in engine-audit batch 6k (defect E-50).
TOLERANCES. Each assertion carries the tolerance the SOURCE's own precision
justifies, stated at the call site:
- quantities the text prints to 4 significant figures → 0.25 %
- L4, which the text obtains "by trial and error" and reports to one
decimal → a wider band, with the residual of the text's OWN polynomial at
its OWN printed root measured, so the gap is attributed, not excused.
Where the text's printed number does not follow from the text's own printed
inputs, that is stated and the recomputation is asserted instead. No expected
value in this file was invented.
COUNT: 40 cited values across 3 worked examples + 4 proof-by-consequence
checks + 6 refusal checks.
| Test block (the published value it checks) | Verdict |
| Das Ex 14.1 — Rankine coefficients and the pressure diagram (10 published values) | Pass |
| Das Ex 14.1 — quartic coefficients A1..A4 (Eqs 14.17-14.20) | Pass |
| Das Ex 14.1 — L4 is a trial-and-error stop at 4.8 m, not a rounding (proof by residual) | Pass |
| Das Ex 14.1 — Mmax, section modulus and total length (parts b and c) | Pass |
| Das Ex 14.2 — the no-water-table case falls out of the SAME implementation | Pass |
| Das Ex 14.2 — Eq (14.30) for z̄ is an erratum: the Ka coefficient is 1, not 2 | Pass |
| Das Ex 14.7 — anchored free-earth support, 12 published values | Pass |
| Das Ex 14.7 — F, x and Mmax reproduce EXACTLY at the L4 the text prints | Pass |
| Das Ex 14.9 — total pile length H′ = L1 + L2 + Dactual = 14.48 m | Pass |
| anchored free-earth diagram satisfies ΣF = 0 AND ΣM = 0 at the toe | Pass |
| cantilever toe moment residual equals Das Eq (14.14)’s trapezoid-arm idealisation exactly | Pass |
| rankine_classical reproduces Ex 14.1 end-to-end through computeSheetPile | Pass |
| E-51 — net_envelope is conservative by a pinned factor, not by an unknown one | Pass |
| rankine_classical refuses every case Das §14.4/§14.9 does not derive | Pass |
| rankine_classical honours Das’s Kp factor of safety (Step 13 note) | Pass |
soil-nail-wall-web-validation.test.ts
`soil-nail-wall` — anchored to FHWA GEC No.
Analyses validated: soil-nail-wall · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`soil-nail-wall` — anchored to FHWA GEC No. 7 Table 5.1.
SOURCE
FHWA, "Soil Nail Walls Reference Manual", Publication No. FHWA-NHI-14-007,
FHWA GEC 007, February 2015, NHI Course No. 132085, developed following
AASHTO LRFD Bridge Design Specifications 7th Edition.
Table 5.1 (p. 107) — "Minimum Recommended Factors of Safety for the Design of Soil Nail
Walls Using the ASD Method", with static and seismic columns
note (2) to Table 5.1 — the conditions under which FSOS = 1.35 may be accepted
TABLE 5.1, TRANSCRIBED
limit state symbol static seismic
Overall stability FSOS 1.5 1.1
Overall, short-term excavation FSOS 1.25-1.33 NA
Basal heave FSBH 2.0 / 2.5 2.3
Pullout resistance FSPO 2.0 1.5
Lateral sliding FSLS 1.5 1.1
Tendon tensile, Grades 60 & 75 FST 1.8 1.35
Tendon tensile, Grades 95 & 150 FST 2.0 1.50
Facing flexural FSFF 1.5 1.1
Facing punching shear FSFP 1.5 1.1
WHY THIS ENGINE
`soil-nail-wall` was one of the 27 bespoke engines with ZERO published-example validation.
It also cited FHWA-IF-03-017 (2003) throughout — the edition GEC No. 7 (2015) supersedes.
Table 5.1 itself notes that "the limit state and symbol nomenclature differ from that
presented in the previous version of this manual", so the citation mattered.
DEFECTS FOUND
E-44 (P2) — `required_fos` defaulted to **1.35**. Table 5.1's recommendation for overall
stability under static, long-term conditions is **1.5**; 1.35 appears only in note (2), and
only "for non-critical, permanent structures ... when uncertainty is considered to be
limited due to the availability of sufficient geotechnical information and successful local
experience on soil nailing". Defaulting to the concession silently relaxed the target by
10 % for every caller who did not set it. Default is now 1.5; choosing 1.35 is still
allowed but the conditions are stated.
E-45 (P3) — the pullout, tendon and facing checks used the STATIC targets even when a
seismic coefficient was supplied. Table 5.1's seismic column is lower (1.5 / 1.35 / 1.1),
so the engine rejected designs the standard accepts. Over-conservative rather than unsafe,
but wrong. Note the blanket 0.75 factor previously applied to overall stability happens to
reproduce the pullout (2.0 → 1.5) and tendon (1.8 → 1.35) rows exactly, but NOT the
overall-stability row: 0.75 × 1.5 = 1.125 against a published 1.1. The published values are
now used directly.
| Test block (the published value it checks) | Verdict |
| E-44: the default overall-stability target is Table 5.1’s 1.5, not note (2)’s 1.35 | Pass |
| E-44: opting into FSOS = 1.35 is allowed but its note-(2) conditions are stated | Pass |
| GEC No. 7 Table 5.1: the static acceptance targets are 2.0 pullout, 1.8 tendon, 1.5 facing | Pass |
| E-45: under seismic loading the SEISMIC column applies (FSPO 1.5, FST 1.35, FSFF 1.1) | Pass |
| E-45: the published seismic FSOS is 1.1 — not 0.75 × the static target | Pass |
| Table 5.1 internal consistency: every seismic target is at or below its static counterpart | Pass |
| the engine cites the CURRENT edition, FHWA-NHI-14-007 (GEC No. 7, 2015) | Pass |
| every numeric output is finite, and a wall with no nails is refused | Pass |
⚑ staged-excavation-wall-web-validation.test.ts
STAGED-EXCAVATION-WALL (and EMBEDDED-WALL-SSI) — web-validation benchmark: the published parts.
Analyses validated: embedded-wall-ssi, staged-excavation-wall · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
STAGED-EXCAVATION-WALL (and EMBEDDED-WALL-SSI) — web-validation benchmark: the published parts.
`staged-excavation-wall.ts` is a subgrade-reaction (beam on elasto-plastic Winkler springs) embedded-wall
solver. Two of its building blocks are PUBLISHED closed-form procedures and are checked here against
printed numbers: the NAVFAC DM-7.2 "modified Boussinesq" lateral pressure on a rigid wall from a line load
(`navfacLineLoadPressure`) and from a point load (`navfacPointLoadPressure`), which the solver uses for
non-uniform surcharges.
⚠️ WHAT THIS SUITE DOES NOT PROVE. The solver's headline outputs — deflection, bending moment, shear and
prop/anchor reaction from the beam-on-springs solution — have NO published numeric answer among the
sources opened: they depend on the chosen subgrade modulus k_s, and the examples that print both k_s and
the resulting moments are software verification cases (Bowles 5e Examples 13-1 to 13-4 use a different
nonlinear two-sided spring program with k_s = f(depth) and embedment recycling; the DeepEX users manual has no
verification example; Craig 8e Examples 11.6-11.8 and EC7 Worked Examples A.7 are limit-equilibrium with
partial factors). Those are not equality benchmarks for this method. This engine is therefore NOT
reference-backed for its structural response, whatever the manifest counts.
SOURCES (each opened; locator next to every value):
1. FHWA-NHI-06-089 (2006), Soils and Foundations, Volume II, Chapter 10 "Earth Retaining Structures",
Example 10-2 "Construct the lateral pressure diagram due to a line load of 700 lb/ft located 15 ft
behind the top of a 30 ft high unyielding wall" (printed pp. 10-32 and 10-33): a table of Ph against
depth, after the NAVFAC/USS procedure (its Figure 10-14, after the USS Steel Sheet Piling Design Manual). The chapter is bound
into the Vol1 file on disk, whose running head reads "Soils and Foundations – Volume II",
Chapter 10, December issue of that year.
2. NAVFAC DM-7.2 (1982), Foundations and Earth Structures, Figure 11 "Horizontal Pressures on Rigid Wall
from Surface Load" (printed p. 7.2-74; the table of P_H and R for m = 0.1…0.7) and Figure 30 "Example
of Analysis of Pressures on Flexible Wall of Narrow Cut in Clay" (printed p. 7.2-107; the surcharge
step P_H2 = .78 Qp/H = 0.39 kip, R2 = .59 H = 11.8 ft). Read from the rendered page images (pdf pages
91 and 124).
TOLERANCES, each from the source's own rounding:
- FHWA Example 10-2 prints Ph to one decimal of a psf → ±0.05 psf (half the last digit).
- NAVFAC Figure 11 prints resultant coefficients and R/H to 2 d.p. → ±0.005; Figure 30 prints P_H2 in kip
to 2 d.p. → ±0.005 kip and R2 as .59H = 11.8 ft → ±0.005 H = ±0.1 ft.
- The resultants and centroids are obtained by numerical integration of the engine's kernel over the wall
height (midpoint rule, 40 000 strips: error < 1e-6 of the value).
KNOWN DISAGREEMENTS WITH FIGURE 11 (recorded, not asserted). The printed resultant for m ≤ 0.4 is
P_H = 0.55 Q_L, but integrating NAVFAC's OWN printed kernel σ_H = (Q_L/H)·0.20n/(0.16 + n²)² over 0 ≤ n ≤ 1
gives 0.5388 Q_L (−2.0 %); the point-load coefficients .78 (m = 0.2, 0.4) and .45 (m = 0.6) integrate to
0.7875 and 0.4565 (+1.0 %, +1.4 %); R = .60H (line, m ≤ 0.3) and .48H (line, m = 0.7) integrate to .608H
and .489H. These are inside a few percent and the engine implements the kernel equations exactly as
printed, so the discrepancy is inside the source (chart constants vs. its own formulae), but each exceeds
the ±0.005 that the printed digits justify, so none is asserted.
| Test block (the published value it checks) | Verdict |
| FHWA NHI-06-089 Example 10-2 (pp. 10-32, 10-33) — line-load lateral pressure Ph (psf) at n = z/H = 0.1 … 1.0 | Pass |
| NAVFAC DM-7.2 Fig. 11 (p. 7.2-74) — line load, m > 0.4: P_H = 0.64 Q_L/(m² + 1) | Pass |
| NAVFAC DM-7.2 Fig. 11 (p. 7.2-74) — height R of the resultant above the base, as a fraction of H | Pass |
| NAVFAC DM-7.2 Fig. 30 (p. 7.2-107) — surcharge step: m = 4/20 = 0.2, Qp = 10 kip, H = 20 ft | Pass |
steel-section-mphi-web-validation.test.ts
Steel circular / pipe pile section engine (`steel-section-mphi.ts`, registered as `steel-pile-section`) checked against PUBLISHED tabulated section properties.
Analyses validated: steel-pile-section · Recorded run: passed — 20 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Steel circular / pipe pile section engine (`steel-section-mphi.ts`, registered as `steel-pile-section`)
checked against PUBLISHED tabulated section properties. Every expected number was read from a page that
was opened on 2026-10-06; the engine's own output is never used to produce an expected value.
SOURCES
AISC Shapes Database v16 "Pipe" rows (STD / XXS) as reproduced, in both imperial and metric columns, on
https://calcs.app/steel/section-properties/Pipe12STD · …/Pipe6STD · …/Pipe12XXS (read 2026-10-06;
the page states "Metric values are source tabulated values from the AISC v16 database"). The AISC
Manual tables themselves could not be opened: aisc.org serves a bot challenge (HTTP 403), which was
not circumvented.
ASTM A1085 round HSS table (A, I, S, r, Z), Engineers Edge, "Round Structural Tube Per. ASTM 1085",
https://engineersedge.com/standard_material/astm-hhs-structural.htm (read 2026-10-06). ASTM A1085
design wall = the full nominal wall, so the printed t is fed to the engine unchanged.
Hibbeler, Mechanics of Materials, and Gere and Goodno, Mechanics of Materials (plastic bending of a solid
circle, Z = 4r³/3, shape factor 16/(3π)) — read SECONDHAND from the worked examples (r = 2 and r = 1)
printed at https://www.calculatorx.com/calc/mechanical/circular-plastic-modulus (read 2026-10-06);
the textbooks themselves were not opened, so this is a secondary web source.
Bureau of Indian Standards (2007), IS 800:2007 cl. 9.3.1.1(e) — read in the library copy — for the
circular-hollow-tube bending-with-axial-load formula (see the last test).
TOLERANCES. Every tolerance here is the SOURCE'S OWN PRINTING PRECISION and nothing else:
· A1085 rows print I, S, Z to 3 significant figures → tolerance = half a unit of the last printed digit
(e.g. "1460" → ±5, "91.5" → ±0.05). The engine is given exact D and t, so there is no input rounding.
· AISC Pipe rows additionally carry the rounding of the printed design wall tdes (0.349 and 0.261 in):
the tolerance adds ½-ulp(tdes)/tdes, because thin-wall I, S and Z scale with t. The STD rows at
tdes = 0.34 and 0.3 in (Pipe10STD, Pipe8STD) were left out: their printed tdes carries 1.5–1.7 %
of rounding and nothing tighter can be claimed from them.
· The solid-circle values are closed forms printed to 6–7 s.f.
WHAT THIS SUITE IS: tabulated section properties are published numbers, and matching dozens of them across
a wide range of sizes catches unit, diameter/radius and Z-formula errors. They are NOT an
independent check of the elastic-plastic mechanics, and the suite does not pretend otherwise: the
M–N interaction has no published numeric answer that could be opened, so it is covered only by the
labelled HAND CHECK tests at the end, which do not count as published values.
PUBLISHED-VALUE COUNT: A1085 13 rows × 3 (I, S, Z) = 39; AISC Pipe 2 rows (STD) × 3 = 6 plus two printed
Mp/Ms ratios; solid circle 5. (Several are the same closed form at different sizes, so the number of
independent facts is smaller than the number of assertions.) Sources: 3 web sources + the IS 800 clause.
| Test block (the published value it checks) | Verdict |
| [1] ASTM A1085 20 x 0.5 in: I = 1460 in⁴, S = 146 in³, Z = 190 in³ | Pass |
| [1] ASTM A1085 20 x 0.375 in: I = 1110 in⁴, S = 111 in³, Z = 144 in³ | Pass |
| [1] ASTM A1085 18 x 0.5 in: I = 1050 in⁴, S = 117 in³, Z = 153 in³ | Pass |
| [1] ASTM A1085 16 x 0.625 in: I = 894 in⁴, S = 112 in³, Z = 148 in³ | Pass |
| [1] ASTM A1085 16 x 0.5 in: I = 732 in⁴, S = 91.5 in³, Z = 120 in³ | Pass |
| [1] ASTM A1085 14 x 0.375 in: I = 373 in⁴, S = 53.3 in³, Z = 69.6 in³ | Pass |
| [1] ASTM A1085 12.75 x 0.5 in: I = 362 in⁴, S = 56.7 in³, Z = 75.1 in³ | Pass |
| [1] ASTM A1085 12.75 x 0.25 in: I = 192 in⁴, S = 30.1 in³, Z = 39.1 in³ | Pass |
| [1] ASTM A1085 10.75 x 0.375 in: I = 165 in⁴, S = 30.6 in³, Z = 40.4 in³ | Pass |
| [1] ASTM A1085 10 x 0.25 in: I = 91.1 in⁴, S = 18.2 in³, Z = 23.8 in³ | Pass |
| [1] ASTM A1085 8.625 x 0.322 in: I = 72.5 in⁴, S = 16.8 in³, Z = 22.2 in³ | Pass |
| [1] ASTM A1085 6.625 x 0.25 in: I = 25.5 in⁴, S = 7.69 in³, Z = 10.2 in³ | Pass |
| [1] ASTM A1085 5 x 0.188 in: I = 8.24 in⁴, S = 3.30 in³, Z = 4.36 in³ | Pass |
| [2] AISC v16 Pipe12STD (OD 12.75 in, tdes 0.349 in): I = 262 in⁴, S = 41 in³, Z = 53.7 in³ | Pass |
| [2] AISC v16 Pipe6STD (OD 6.625 in, tdes 0.261 in): I = 26.5 in⁴, S = 7.99 in³, Z = 10.6 in³ | Pass |
| [3] the printed Mp/Ms ratios: 1.3 for Pipe12STD and 1.4 for Pipe12XXS (the thicker wall has the larger shape factor) | Pass |
| [4] solid circle r = 2: Z = 32/3, S = 2π, shape factor f = 16/(3π) = 1.697653 | Pass |
| [5] solid circle r = 1: Z = 4/3, S = π/4 | Pass |
| [6] HAND CHECK (not a published value): Mp and My are fy·Z and fy·S, and axial load lowers Mp by the exact circular plastic M–N value | Pass |
| [7] IS 800:2007 cl. 9.3.1.1(e): for a circular hollow tube Mnd = 1.04·Md·(1 − n^1.7) ≤ Md — the engine's exact reduction is the same order and never exceeds Md | Pass |
structural-elements-web-validation.test.ts
WEB / TEXTBOOK-BENCHMARK validation for the structural-elements engine (beam-on-elastic-foundation Winkler FE + 2-D elasto-plastic FE structure library: beam/plate, anchor, tension-only geogrid, Mohr-Coulomb interface).
Analyses validated: structural-elements · Recorded run: passed — 28 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB / TEXTBOOK-BENCHMARK validation for the structural-elements engine
(beam-on-elastic-foundation Winkler FE + 2-D elasto-plastic FE structure library:
beam/plate, anchor, tension-only geogrid, Mohr-Coulomb interface).
PUBLISHED WORKED EXAMPLES (added 2026-10-07; each number was read from the page named — Hetényi from the
archive.org scan, Bowles from the local 5e PDF — none recalled from memory):
1. Hetényi, M. (1946) Beams on Elastic Foundation, Univ. of Michigan Press — §18 Example (Figure 40,
pp. 47-49: free-ended wooden beam under P + q, printed deflections, soil pressures, M and Q at the
middle) and §12 Examples 1 and 4 (pp. 33-36: 0.7921 / 0.5842 / 0.7489 moment reductions; ring-reinforced
tube, bending stress 82 % above the hoop stress).
2. Bowles, J.E. (1997) Foundation Analysis and Design 5e, Example 9-6 / Fig. E9-6b (printed FADBEMLP
output, 6.38 m footing, 13 nodes, 2.64 m wide, ks = 22 000 kN/m³, local PDF p. 549). Bowles doubles the
two END springs; this engine reproduces that model exactly by putting the two extra spring forces at
x = 0 and x = L in `anchors` (5808 and 14520 kN/m = ks·b·Δ/2 of the end elements). With them the
engine matches the 13 printed deflections to ≤ 1.3 % and the interior moments to ≤ 4 %.
WHAT IS AND IS NOT PUBLISHED HERE. The beam-on-Winkler-foundation core (consistent foundation matrix,
Hermite beam, applied point loads/moments/UDLs, free ends) is checked against the two sources above. The
ANCHOR, GEOGRID and INTERFACE elements are checked only against their own exact constitutive identities
(T = P0 + k·δ, tension cut-off, τ ≤ c + σ·tanδ) — no published numerical worked example for them was found,
so those assertions are derivations, not published values, and are not counted as such in the report.
Earlier cited / exactly-derivable assertions (the release rules mandatory last gate) follow.
Primary source of the closed forms:
Hetényi, M. (1946) "Beams on Elastic Foundation," Univ. of Michigan Press:
- Eq 8 (p. 8): λ = ⁴√( k / (4·E·I) )
- Eq 17 (p. 14): infinite beam, central point load P
w_max = P·λ/(2k), M_max = P/(4λ), V = ∓P/2 at the load,
and ∫k·w dx = P (total soil reaction = applied load).
- Uniform load q over a long beam: interior w = q/k, M → 0 ("floating" beam).
Timoshenko S.P. (1955) Strength of Materials II §1-2 (same β = λ).
Elasto-plastic FE structure elements — node-to-node anchor (T = P0 + k_a·δ),
geogrid (tension-only: T = 0 in compression), interface (Mohr-Coulomb,
τ ≤ c + σ_n·tan δ, elastic-perfectly-plastic slip).
Rigid-body equilibrium for the anchor / geogrid checks is exact:
a rigid beam (EI → ∞) on a uniform foundation k over length L with a
central spring settles uniformly, so w = P / (k·L + k_spring).
Tolerances: FE-vs-Hetenyi closed forms use 1.5 % (mesh-discretisation error at
~0.2 m elements); rigid-beam and constitutive identities are near-exact (checked
to <1e-3). Every tolerance is stated at its assertion.
| Test block (the published value it checks) | Verdict |
| SE web 1-3: λ = (k/4EI)^(1/4) — Hetenyi 1946 Eq 8 | Pass |
| SE web 4-6: infinite beam w_max = P·λ/(2k) — Hetenyi 1946 Eq 17 | Pass |
| SE web 7-9: infinite beam M_max = P/(4λ) — Hetenyi 1946 Eq 17 | Pass |
| SE web 10-11: infinite beam soil reaction ∫k·w dx = P (Hetenyi equilibrium) | Pass |
| SE web 12: infinite beam shear jump |V| = P/2 at the load (Hetenyi Eq 17) | Pass |
| SE web 13-14: full-length UDL — interior w = q/k, interior M ≈ 0 ("floating" beam) | Pass |
| SE web 15-17: anchor spring — rigid beam, w = P/(kL+k_a) and T = k_a·δ | Pass |
| SE web 18-19: anchor pre-stress — T = P0 + k_a·δ and w = (P−P0)/(kL+k_a) | Pass |
| SE web 20-21: geogrid carries T = k_g·δ in tension (stretched) | Pass |
| SE web 22-23: geogrid carries ZERO force in compression (tension-only) | Pass |
| SE web 24: interface strength cap τ_max = c + σ_n·tan δ (Mohr-Coulomb) | Pass |
| SE web 25-26: interface elastic below cap — τ = k_s·slip, |τ| < τ_max | Pass |
| SE web 27-28: interface caps shear at τ_max under a large load (plastic slip) | Pass |
| SE web 29: superposition — response to (P1)+(P2) = response to both together | Pass |
| SE web 30: symmetry — a symmetric load pair gives a symmetric deflection profile | Pass |
| SE web 31: static equilibrium — ΣFᵥ ≈ 0 and ΣM ≈ 0 for a multi-load case | Pass |
| SE web 32: invalid inputs return errors without throwing (NaN/∞ guard) | Pass |
| SE web 33: all profile outputs are finite for a well-posed problem | Pass |
| audit: a solve that fails its own equilibrium check is REFUSED, not reported | Pass |
| audit: the real, valid case is byte-identical to before the fix | Pass |
| SE published: Hetényi §18 — λ and λl (p. 47) | Pass |
| SE published: Hetényi §18 — deflections, soil pressures, M and Q at C of the free-ended beam (pp. 48-49) | Pass |
| SE published: Hetényi §12 Example 1 — forces at x = π/2λ reduce the maximum moment (0.7921 / 0.5842 / 0.7489) | Pass |
| SE published: Hetényi §12 Example 4 — ring on a long tube: bending stress 82 % above the hoop stress (p. 36) | Pass |
| SE published: Bowles Example 9-6 — the 13 printed nodal deflections (COMP X, mm) | Pass |
| SE published: Bowles Example 9-6 — printed soil pressures (SOIL Q, kPa) at nodes 1, 4, 7, 10, 13 | Pass |
| SE published: Bowles Example 9-6 — printed nodal bending moments (kN·m), sign per Bowles | Pass |
| SE published: Bowles Example 9-6 — comment 1: Σ spring forces 3374.71 kN against 3375 kN input | Pass |
strut-design-web-validation.test.ts
STRUT-DESIGN — web-validation benchmark against two independently published column-curve tables.
Analyses validated: strut-design · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
STRUT-DESIGN — web-validation benchmark against two independently published column-curve tables.
`strut-design.ts` is the Perry-Robertson multiple-column-curve check (IS 800:2007 cl. 7.1.2): the steel
strut / waler of a braced excavation checked for flexural buckling. Its output is the design
compressive stress f_cd (and the stress reduction factor χ behind it). Both are PRINTED, as tables of
answers, in the two documents below — so this suite checks the engine against printed numbers, not
against the equation it implements.
SOURCES (both opened; values read from the page images / text layer named here):
1. IS 800:2007, "General Construction in Steel — Code of Practice" (3rd revision, BIS, New Delhi),
Table 9(a)-(d) "Design Compressive Stress f_cd (MPa) for Column Buckling Class a / b / c / d"
(Clause 7.1.2.1), printed pp. 40-43 — f_cd tabulated against KL/r (10…250) and f_y (200…540 MPa),
including the partial safety factor γm0 = 1.10 (Table 5, cl. 5.4.1). The file on disk is a 300-ppi
scan; every value used below was read from the rendered page image (pdf pages 51-54), not from OCR.
Table 3, item (i), cl. 3.8 (printed p. 20): maximum KL/r = 180 for a member carrying compression
from dead and imposed loads.
2. CEN (1992), Eurocode 3 "Design of steel structures — Part 1-1: General rules and rules for
buildings", DD ENV 1993-1-1:1992 (BSI reprint), Table 5.5.1 (imperfection factors a 0.21, b 0.34,
c 0.49, d 0.76) and Table 5.5.2 "Reduction factors χ" (printed p. 73): χ tabulated to 4 d.p. against
the non-dimensional slenderness λ̄ = 0.2…3.0 for the four buckling curves, plus λ1 = 93.9 ε
(cl. 5.5.1.2(1)).
HOW THE ENGINE IS DRIVEN. Radius of gyration is fixed at 100 mm and the effective length is set to
(KL/r)·r, so KL/r is exactly the tabulated slenderness. IS 800 Table 9 uses E = 2×10^5 MPa and
γm0 = 1.10. Table 5.5.2 is in λ̄, which the engine forms as (KL/r)·√(fy/(π²E)); fy = 235 MPa and
E = 2.1×10^5 MPa give λ1 = π√(E/fy) = 93.9, the ENV value, and KL/r is set to λ̄·λ1.
TOLERANCES, justified by the sources' own rounding and by the engine's output rounding:
- IS 800 Table 9 prints f_cd to 3 significant figures (integers above 100, one decimal below). The
tolerance is HALF of the last printed digit plus 0.05 MPa, because `computeStrutDesign` rounds
`design_stress_fcd_mpa` to one decimal by design.
- ENV Table 5.5.2 prints χ to 4 d.p.; `chi` is rounded to 3 d.p. by the engine, so the tolerance is
0.00005 + 0.0005.
No tolerance was widened to make a value pass; every tabulated value tested is listed.
SCOPE. 100 + 48 IS 800 f_cd values and 116 ENV χ values, plus the printed KL/r = 180 limit and λ1 = 93.9.
The two dependent checks at the end (Pd = Ae·fcd) are plain arithmetic on a printed value and are
labelled as such; they are not counted as published answers.
| Test block (the published value it checks) | Verdict |
| IS 800:2007 Table 9(a) (printed p.40) — class a, fy = 250 MPa, KL/r 10…250 (25 published values) | Pass |
| IS 800:2007 Table 9(a) (printed p.40) — class a, fy = 300 and 450 MPa columns (12 published values) | Pass |
| IS 800:2007 Table 9(b) (printed p.41) — class b, fy = 250 MPa, KL/r 10…250 (25 published values) | Pass |
| IS 800:2007 Table 9(b) (printed p.41) — class b, fy = 300 and 450 MPa columns (12 published values) | Pass |
| IS 800:2007 Table 9(c) (printed p.42) — class c, fy = 250 MPa, KL/r 10…250 (25 published values) | Pass |
| IS 800:2007 Table 9(c) (printed p.42) — class c, fy = 300 and 450 MPa columns (12 published values) | Pass |
| IS 800:2007 Table 9(d) (printed p.43) — class d, fy = 250 MPa, KL/r 10…250 (25 published values) | Pass |
| IS 800:2007 Table 9(d) (printed p.43) — class d, fy = 300 and 450 MPa columns (12 published values) | Pass |
| ENV 1993-1-1:1992 Table 5.5.2 (p.73) — buckling curve a, λ̄ = 0.2…3.0 (29 published values) | Pass |
| ENV 1993-1-1:1992 Table 5.5.2 (p.73) — buckling curve b, λ̄ = 0.2…3.0 (29 published values) | Pass |
| ENV 1993-1-1:1992 Table 5.5.2 (p.73) — buckling curve c, λ̄ = 0.2…3.0 (29 published values) | Pass |
| ENV 1993-1-1:1992 Table 5.5.2 (p.73) — buckling curve d, λ̄ = 0.2…3.0 (29 published values) | Pass |
| ENV 1993-1-1:1992 cl. 5.5.1.2(1): λ1 = 93.9 ε at fy = 235 MPa — KL/r = 93.9 is λ̄ = 1.000 | Pass |
| IS 800:2007 Table 3 item (i), cl. 3.8 (p. 20): KL/r limit of 180 for a member in compression from dead + imposed load | Pass |
| Dependent arithmetic (NOT a published answer): Pd = Ae·fcd (IS 800 cl. 7.1.2) applied to the printed f_cd | Pass |
wall-surcharge-web-validation.test.ts
Validation for the non-uniform wall-surcharge (NAVFAC modified-Boussinesq) + passive-berm additions to the embedded-wall engine (`staged-excavation-wall.ts`).
Analyses validated: embedded-wall-ssi, staged-excavation-wall · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the non-uniform wall-surcharge (NAVFAC modified-Boussinesq) +
passive-berm additions to the embedded-wall engine (`staged-excavation-wall.ts`).
the release rules ≥20-cited-value gate. Anchors:
- NAVFAC DM-7.2 / USS Sheet Pile Manual — line & point-load lateral wall
pressure; for m > 0.4 the LINE-load resultant ∫σh dz = 0.64·Q (closed form
of the empirical kernel) and the pressure peaks at n = z/H = m/√3.
- Superposition & linearity in Q; a narrow strip (q·w = Q) → the line-load
solution (the integration kernel is self-consistent).
- CIRIA C760 §5 — a passive berm increases toe resistance (less deflection).
- Boussinesq elasticity — pressure → 0 at the surface and at depth.
| Test block (the published value it checks) | Verdict |
| NAVFAC line load I_L = σh·H/Q_L — published values, m ≤ 0.4 branch | Pass |
| NAVFAC line load I_L — published values, m > 0.4 branch | Pass |
| NAVFAC point load I_P = σh·H²/Q_P — published values, m ≤ 0.4 branch | Pass |
| NAVFAC point load I_P — published values, m > 0.4 branch | Pass |
| NAVFAC line load: resultant ≈ 0.64·Q for m > 0.4 (closed form) | Pass |
| NAVFAC line load: pressure peaks at n = m/√3 (m > 0.4) | Pass |
| NAVFAC line load: linear in Q, and → 0 at surface and at depth | Pass |
| NAVFAC point load: linear in Q, correct Q/H² scaling, decays | Pass |
| strip surcharge → line-load limit as width → 0 with q·w = Q | Pass |
| strip surcharge superposes and stays positive; wide strip spreads the pressure | Pass |
| wall: a retained strip surcharge raises the bending moment | Pass |
| wall: a passive berm reduces wall deflection (CIRIA C760) | Pass |
| no surcharges / no berm ⇒ unchanged from the base wall (regression guard) | Pass |
walls-web-validation.test.ts
WEB-BENCHMARK validation for the retaining-wall external-stability engine (the release rules ≥20 cited-value gate).
Analyses validated: retaining-wall · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the retaining-wall external-stability engine
(the release rules ≥20 cited-value gate). Every target is derived from the UNIVERSALLY
PUBLISHED closed-form equations and confirmed to reproduce, for a single fixed
cantilever geometry, to the decimal:
• Rankine (1857): Ka = tan²(45−φ/2).
• Active thrust: Pa = ½·Ka·γ·H² (H = full stem+base height).
• Overturning FoS = ΣMr / ΣMo (Das §8; IS 14458), with ΣMo = Pa·H/3.
• Sliding FoS = (ΣV·tanδ + c_a·B) / Pa (Das §8; IS 14458).
• Eccentricity e = B/2 − (ΣMr−ΣMo)/ΣV ; base pressure q_max = ΣV/B·(1+6e/B)
(middle-third / Meyerhof — Bowles §11).
Fixed geometry (per metre run): stem H_s=6 m ×0.5 m; base 0.6 m thick, B=3.9 m
(toe 0.8 + stem 0.5 + heel 2.6); γ_fill=18, γ_concrete=24, δ_base=20°, level backfill,
no surcharge. Hand-computed for this geometry (independent of φ):
ΣV = 72(stem)+56.16(base)+280.8(backfill) = 409.0 kN/m
ΣMr = 75.6 + 109.5 + 730.1 = 915.2 kN·m/m (moments about the toe)
H_total = 6.6 m → ΣMo = Pa·2.2. These match the engine exactly across φ. 22 values.
| Test block (the published value it checks) | Verdict |
| Wall web: φ=25° — Ka, Pa, overturning & sliding FoS (Rankine + Das §8) | Pass |
| Wall web: φ=30° — Ka, Pa, overturning & sliding FoS (Rankine + Das §8) | Pass |
| Wall web: φ=35° — Ka, Pa, overturning & sliding FoS (Rankine + Das §8) | Pass |
| Wall web: φ=40° — Ka, Pa, overturning & sliding FoS (Rankine + Das §8) | Pass |
| Wall web: φ=30° — eccentricity e & q_max (middle-third, Bowles §11) | Pass |
| Wall web: φ=35° — eccentricity e & q_max (middle-third, Bowles §11) | Pass |
Piles and deep foundations
Cited validation suites — 30
⚑ broms-lateral-pile-web-validation.test.ts
PUBLISHED-VALUES: 9 -- distinct published values for this engine (engine-level total, declared once); independent audit A2: 9 printed values; the further 30 assertions are digitised chart readings (+-5 %) and are not counted.
Analyses validated: broms-lateral-pile · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 9 -- distinct published values for this engine (engine-level total, declared once); independent audit A2: 9 printed values; the further 30 assertions are digitised chart readings (+-5 %) and are not counted. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Validation for the Broms long-pile (yield-governed) free-head lateral capacity
(`broms-lateral-pile.ts`, `computeBromsLateralPile`). the release rules gate: published values only.
SOURCES (every value below was read from a document opened for this suite):
[FHWA] FHWA-NHI-10-016 (2010 edition), "Drilled Shafts: Construction Procedures and LRFD Design
Methods", Chapter 12 §12.3.4.1 "Broms Method" (printed worked examples, Eq. 12-15…12-32).
[Das] Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage, Chapter 9
§9.18, Figure 9.36(b) p.465 "Broms's solution for ultimate lateral resistance of long
piles — (b) in clay".
[Varg] Varghese, P.C. (2005), Foundation Engineering, PHI Learning, Chapter 13, Example 13.3
(Broms chart, long pile in clay).
WHAT IS CHECKED, AND HOW
· [FHWA] prints complete numerical solutions of the Broms limit-equilibrium model (clay: soil
resistance 9·cu·d below 1.5d; sand: 3·Kp·γ·z·d). The book's INPUT is the applied head load Pt
and moment Mt (= Pt·e); its printed OUTPUTS are the depth of zero shear f and the maximum
moment Mmax. Our engine runs the inverse problem (given the yield moment, return the head
load), so each case is checked as a round trip on PUBLISHED numbers: feed the engine the
book's printed Mmax (as My) and the book's e = Mt/Pt, and require Hu = the book's Pt, hinge
depth = the book's 1.5d + f, and sand f, Kp.
· [Das] Figure 9.36(b) is the Broms chart for long piles in clay. Its curves were digitised from
a 400-dpi raster of the printed page (axis ticks located by pixel detection, values
log-interpolated between the two neighbouring labelled ticks). Chart readings carry the
reading uncertainty of a hand-drawn redraw whose decade spacing varies ±4.5 % tick to tick
(measured: 570–624 px/decade on the ordinate) plus a ≈1 % curve line width, so they are
asserted at ±5 % — the source's own precision, not a fitted tolerance.
· [Varg] prints a chart reading "Hu/(cu·D²) ≈ 7 … Hu = 63 kN" (one significant figure).
Unit conversions used (exact definitions): 1 kip = 4.4482216 kN · 1 in = 0.0254 m ·
1 ft = 0.3048 m · 1 psi = 6.894757 kPa · 1 pcf = 0.157087 kN/m³ · 1 kip·in = 0.1129848 kN·m.
NOT ASSERTED (recorded, see the SAND CHART note at the bottom): Das Fig. 9.36(a) readings.
| Test block (the published value it checks) | Verdict |
| FHWA-NHI-10-016 Eq.12-21/12-22/12-24 clay case A (Pt=100 kip, Mt=2000 kip-ft): Hu from printed Mmax | Pass |
| FHWA clay case A: depth of maximum moment = 1.5·Bb + f = 72 + 15.43 in | Pass |
| FHWA Eq.12-25/12-26 clay case B (Pt=40 kip, Mt=800 kip-ft): Hu and hinge depth from printed Mmax | Pass |
| FHWA clay: printed Mmax (1,050 kip-ft) given in kip-ft returns the same 40 kip | Pass |
| FHWA Eq.12-33: Kp = tan²(45°+32°/2) = 3.25 | Pass |
| FHWA sand: Hu from the printed Mmax = 956 kip-ft returns Pt = 40 kip | Pass |
| FHWA Eq.12-35: sand depth of maximum moment f = 5.85 ft | Pass |
| Varghese Example 13.3: long free-head pile in clay, Hu ≈ 7·cu·D² = 63 kN | Pass |
| Das Fig. 9.36(b): My/(cu·D³) = 40, free-head curves e/D = 0,1,2,4,8,16 | Pass |
| Das Fig. 9.36(b): My/(cu·D³) = 100, free-head curves e/D = 0,1,2,4,8,16 | Pass |
| Das Fig. 9.36(b): My/(cu·D³) = 200, free-head curves e/D = 0,1,2,4,8,16 | Pass |
| Das Fig. 9.36(b): My/(cu·D³) = 400, free-head curves e/D = 0,1,2,4,8,16 | Pass |
| Das Fig. 9.36(b): the six marked long-pile points | Pass |
| P&D Fig. 7.9(a) clay short piles, free head: L/d = 10, 14, 18 | Pass |
| P&D Fig. 7.12(a) sand short piles: free head e/L = 0, 0.2, 0.4 and the restrained line | Pass |
⚑ drilled-shaft-web-validation.test.ts
Published-value validation for drilled-shaft axial capacity (`drilled-shaft.ts`, `computeDrilledShaft`): α-method side, β-method side, and base resistance in clay and sand.
Analyses validated: drilled-shaft · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation for drilled-shaft axial capacity (`drilled-shaft.ts`,
`computeDrilledShaft`): α-method side, β-method side, and base resistance in clay and sand.
the release rules gate: every expected value below is a number printed in a source opened for this suite.
SOURCES
[FHWA] FHWA-NHI-10-016 (2010 edition), Drilled Shafts: Construction Procedures and LRFD
Design Methods — Chapter 13 (Illustrative Example 13-2, Table 13-2 "Bearing capacity
factor N*c", Eq. 13-14) and Appendix A "Design Example for Replacement Bridge",
Tables A-7 and the layer-4 / layer-7 calculations on pp. A-15 … A-16.
[Das] Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage, Chapter 10
(Reese & O'Neill drilled-shaft method): Examples 10.3, 10.4, 10.5, Table 10.4, Eq. 10.26
(b2 = 192 kN/m²), Eq. 10.41.
[AASHTO] AASHTO (2007) LRFD Bridge Design Specifications 4th ed. SI, §10.8.3.5.2b–c
(β-method cap 0.19 MPa; tip resistance 0.057·N60 MPa ≤ 3.0 MPa).
HOW THE ENGINE IS MAPPED TO THE PUBLISHED EXAMPLES
· The engine treats ONE uniform soil. Layered published examples are reproduced layer by layer
(each layer as its own uniform shaft). Clay side resistance excludes the top 1.5 m and the
bottom 1·B (the Reese–O'Neill method as given in [Das] and [AASHTO]); FHWA-NHI-10-016 (2010) keeps only the top
5 ft. To compare like with like the engine shaft is given L = (layer length) + 1.5 m + B, so
the engine's active length equals the layer length printed in the example.
· Das Example 10.5 has two clay layers. The engine runs a uniform clay, so the printed total is
reproduced by linear superposition S(cu=40, L=3.76) + S(cu=60, L=6.0) − S(cu=60, L=3.76): the
active intervals are [1.5, 3.0] at cu = 40, [1.5, 5.24] at cu = 60, minus [1.5, 3.0] at cu = 60,
i.e. 1.5 m at cu = 40 plus 2.24 m at cu = 60 — the printed ΔL1 = 1.5 m and ΔL2 = 2.24 m.
· Units: 1 psf = 0.0478803 kPa · 1 ft = 0.3048 m · 1 lb = 4.4482216e-3 kN · 1 kip = 4.4482216 kN.
TOLERANCES (source rounding): Das prints 5 s.f. → 0.1 %; FHWA App. A prints whole pounds →
0.01 %; FHWA Example 13-2 prints "930.9 kips" but uses 5 ft for the surface zone while the engine
uses 1.5 m (0.024 m of a 13.7 m active length = 0.18 %) → 0.3 %; AASHTO prints 0.057 (2 s.f.,
±0.9 %) and 0.19 MPa (±2.6 %); Das Table 10.4 uses pa = 100 kPa against the engine's
500/1000/2000 psf anchors (FHWA Table 13-2) → 1.2 %.
NOT ASSERTED (recorded in the report): FHWA Appendix A layers 2, 3, 5, 7 use the Kulhawy K-tanδ
β-method and Das Example 10.3's side resistance uses the gravel β (2.0 − 0.15 z^0.75) — neither
is this engine's O'Neill-Reese sand β = 1.5 − 0.244 √z; Das Examples 10.1–10.2 are belled-shaft
bearing capacity (Chen–Kulhawy / Berezantzev); Example 10.4's skin friction uses α* = 0.4.
| Test block (the published value it checks) | Verdict |
| Das Example 10.5: Σ αcu·p·ΔL = 255.28 kN (ΔL1 = 1.5 m at cu 40, ΔL2 = 2.24 m at cu 60) | Pass |
| Das Example 10.5: qp = 6cu(1 + 0.2L/Db) = 1957.5 kPa exceeds 9cu, so qp = 1305 kPa | Pass |
| Das Example 10.5: base resistance qp·Ap = 1475.9 kN | Pass |
| Das Example 10.4: base in cu = 2175 psf clay, Ds = 3.3 ft: Qp(net) = Ap·cu·N*c = 167.4 kip | Pass |
| Das Example 10.3: qp = 57.5·N60 = 57.5 × 30 = 1725 kN/m² | Pass |
| Das Table 10.4: cu/pa = 0.25, 0.5, ≥1 → N*c = 6.5, 8.0, 9.0 (pa = 100 kPa) | Pass |
| FHWA Table 13-2: su = 500, 1000, 2000 psf → N*c = 6.5, 8.0, 9.0 | Pass |
| FHWA Example 13-2: unit side resistance 0.55 × 2,395 psf = 1,317 psf | Pass |
| FHWA Example 13-2: RSN = π (5 ft)(45 ft)(1,317 psf) = 930.9 kips | Pass |
| FHWA App. A layer 4: fSN = 0.55 × 1,750 = 963 psf (962.5 printed as 963) | Pass |
| FHWA App. A layer 4: RSN = π (8 ft)(15 ft)(962.5 psf) = 362,854 lb | Pass |
| FHWA App. A layer 6: fSN = 0.55 × 2,300 = 1,265 psf | Pass |
| FHWA App. A layer 6: RSN = 2,559,330 lb | Pass |
| FHWA App. A layer 7 base: qBN = 0.60 N60 = 24.6 tsf = 49.2 ksf (N60 = 41) | Pass |
| FHWA App. A layer 7 base: RBN = π/4 (8 ft)² (49.2 ksf) = 2,473 kips | Pass |
| AASHTO (2007) Eq. 10.8.3.5.2c-1: qp = 0.057 N60 MPa → 1710 kPa at N60 = 30 | Pass |
| AASHTO (2007) §10.8.3.5.2c: tip resistance limited to 3.0 MPa; FHWA Eq. 13-14: 30 tsf = 2,873 kPa | Pass |
| AASHTO (2007) Eq. 10.8.3.5.2b-1 / Das Eq. 10.26: unit side resistance in sand never exceeds 0.19 MPa (192 kN/m²) | Pass |
driven-pile-dynamics-web-validation.test.ts
Published-value validation for the Hiley driven-pile dynamic formula (`driven-pile-dynamics.ts`, `computeDrivenPileDynamics`).
Analyses validated: driven-pile-dynamics · Recorded run: passed — 26 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation for the Hiley driven-pile dynamic formula
(`driven-pile-dynamics.ts`, `computeDrivenPileDynamics`). the release rules gate: published values only.
SOURCES (each opened for this suite; locators beside each value):
[Bowles] Bowles, J.E. (1997), Foundation Analysis and Design 5th ed., McGraw-Hill, Chapter 17,
Example 17-2 (Hiley, Eq. 17-3, test pile No. 1 of Mansur & Hunter) and Example 17-4.
[Varghese] Varghese, P.C. (2005), Foundation Engineering, PHI Learning, Chapter 10, Examples
10.1–10.3 and Eqs. 10.1–10.3 (modified Hiley formula, Indian pile-code practice).
[IRC78] IRC:78-2014 "Standard Specifications and Code of Practice for Road Bridges, Section VII
Foundations and Substructure", Appendix 7, Part 1 Method-2 — the printed table of the
Hiley blow efficiency η against P/W and the coefficient of restitution e (quoting the
modified Hiley formula of the Indian pile-foundation standard, Part 1 Section 1).
NOTE ON UNITS. The Hiley formula is homogeneous in the weight unit (Ru carries the unit of the
ram weight; the blow factor is a ratio), so the tonnes of [Varghese] are fed through the engine's
kN fields and the printed Ru in tonnes is compared directly — no conversion is applied.
TOLERANCES, each from the source's own rounding:
· [Bowles] prints Pu to 4 s.f. and collects (12.45+0.16·31.5)/44.0 with a rounded 43.95 → 44.0
(+0.11 % on the Table E17-4 outputs): 0.3 %. Example 17-2 is quoted to 4 s.f.: 0.1 %.
· [Varghese] prints Ru to 3 s.f. and sets to 3 s.f.: 0.5 % (the set is itself solved from the
rounded C/2 = 0.921 cm).
· [IRC78] prints η to two decimals and, as the table shows (1/6 = 0.167 printed 0.16, 1/8 = 0.125
printed 0.12, 1/3.5 = 0.286 printed 0.28), TRUNCATES in places: ±0.01, one unit of the last
printed digit. All 60 printed cells are asserted — none omitted.
ENGINE CORRECTION FOUND BY THIS SUITE. Before the fix the engine used only the first branch
of the blow efficiency, η = (W + e²P)/(W + P). IRC:78-2014 and Varghese Eq. 10.3 both print a
second branch for a ram LIGHTER than e·P, η = (W + e²P)/(W + P) − [(W − eP)/(W + P)]². Without it
19 of the 60 printed IRC:78 cells fail (measured at ±0.01) (e.g. P/W = 5, e = 0.4: engine 0.300 vs printed 0.27).
| Test block (the published value it checks) | Verdict |
| IRC:78-2014 App.7 η table, P/W = 0.5: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 1: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 1.5: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 2: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 2.5: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 3: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 3.5: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 4: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 5: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 6: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 7: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| IRC:78-2014 App.7 η table, P/W = 8: e = 0.5, 0.4, 0.32, 0.25, 0 | Pass |
| Bowles Example 17-2: first trial k2 = 6.8 mm gives Pu = 1331 kN (printed "rounded") | Pass |
| Bowles Example 17-2: converged k2 = 9.5 mm gives Pu = 1264 kN | Pass |
| Bowles Example 17-2: blow-efficiency term (125 + 0.5²·21.86)/(125 + 21.86) = 0.888 | Pass |
| Bowles Example 17-2: hammer energy term eh·Eh = 0.78 × 48.8 = 38.06 kN·m | Pass |
| Bowles Example 17-2: allowable Pa = 1260/4 = 315 kN at the book's rounded Pu = 1260 | Pass |
| Bowles Table E17-4: set 1, 2, 4 mm → Pu 901.4, 849.8, 758.2 kN | Pass |
| Bowles Table E17-4: set 6, 8, 10 mm → Pu 679.0, 611.3, 553.4 kN | Pass |
| Bowles Table E17-4: set 25, 50 mm → Pu 307.9, 170.2 kN | Pass |
| Varghese Example 10.1: efficiency of blow η = (5 + 9.7·0.25²)/(5 + 9.7) = 0.381 | Pass |
| Varghese Example 10.1: total temporary compression C = 0.212 + 1.222 + 0.409 = 1.843 cm | Pass |
| Varghese Example 10.1: set S = 0.95 mm/blow gives Ru = 300 t (safe 120 t at FS 2.5) | Pass |
| Varghese Example 10.2 resistance-set table: Ru 250, 200, 150, 100 t at S = 2.98, 6.03, 11.10, 21.27 mm | Pass |
| Varghese Example 10.2: Ru for S → 0 is 331 t (hammer energy over C/2 alone) | Pass |
| Varghese Example 10.3 (400×400, 15 m, fall 1.5 m): η = 0.48 and S = 2.0 mm gives Ru = 225 t | Pass |
⚑ helical-pile-web-validation.test.ts
Published-value validation for helical (screw) pile capacity (`helical-pile.ts`, `computeHelicalPile`): individual-plate bearing Qh = Ah·(9·c + q'·Nq) and the installation-torque correlation Qu = Kt·T.
Analyses validated: helical-pile · Recorded run: passed — 19 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation for helical (screw) pile capacity (`helical-pile.ts`,
`computeHelicalPile`): individual-plate bearing Qh = Ah·(9·c + q'·Nq) and the installation-torque
correlation Qu = Kt·T. the release rules gate: every expected value is a number printed in a source
that was opened (web pages fetched 2026-10-07; URLs below).
SOURCES
[SW] Supportworks (2014), "Design Examples — Helical Piles", Examples 1 (clay) and 2 (sand),
https://commercial.supportworks.com/technical-information/design-examples/helical-piles.html
(Chance/Hubbell Technical Manual Individual Bearing Method, ICC-ES AC358 default Kt).
[TMG] Moumneh, R. (2026), "Reading a Boring Log for Helical Pile Design: A Worked Example",
TMG Manufacturing, https://tmgmfg.com/blog/boring-log-helical-pile-design/ — three worked
configurations with per-plate loads, both Nq equations, and the AC358 Kt values.
CONTEXT (not asserted): the Canadian Foundation Engineering Manual 4th ed. §18.2.1.4 gives the same
plate-bearing form (Eq. 18.11) and Kt = 10 ft⁻¹ (33 m⁻¹) for small square shafts, 7 ft⁻¹ (23 m⁻¹) for
90 mm pipe, falling to 3 ft⁻¹ (10 m⁻¹) near 200 mm — the basis of the Kt note in the engine.
HOW THE ENGINE IS MAPPED TO THE EXAMPLES
· The engine takes ONE representative plate diameter and n plates. The published leads mix
10/12/14 in. plates at different depths, so each plate is run as its own `num_helices = 1` case
(depth and γ′ chosen so that σ′v = γ′·z equals the printed q′) and the plate loads are summed.
· Areas are compared NET of the shaft — the engine's π(D² − d²)/4 — against the printed areas.
· Nq models: [SW] uses 1 + 0.56(12φ)^(φ/54) ('chance'); [TMG] carries both this and Perko's
0.5(12φ)^(φ/54) ('perko', the engine default).
· Units: 1 psf = 0.0478803 kPa · 1 ft = 0.3048 m · 1 in = 0.0254 m · 1 lb = 4.4482216e-3 kN ·
1 ft·lb = 1.3558179e-3 kN·m.
TOLERANCES (source rounding): printed areas carry 2–3 s.f. (±0.005 ft² on 0.5 = 1 %, ±0.0005 on
0.479 = 0.1 %); printed plate loads are whole pounds computed from those rounded areas, so the
engine's exact areas differ by ≤ 0.3 %; Nq quoted to 3 s.f. → 0.3 %.
ENGINE CORRECTIONS FOUND BY THIS SUITE (both make the engine lower, i.e. conservative):
1. Plate area was the GROSS π·D²/4; every published example uses the plate area NET of the shaft.
2. Nq was the Reissner closed form (23.2 at 32°); the helical industry uses 0.5(12φ)^(φ/54)
(Perko) or 1 + 0.56(12φ)^(φ/54) (Chance) — 17.0 / 20.0 at 32°. The Reissner value is kept as
`nq_model: 'reissner'` for comparison.
| Test block (the published value it checks) | Verdict |
| Supportworks Example 1: net plate areas 10/12/14 in. on a 2.875 in. shaft = 0.50/0.74/1.02 ft² | Pass |
| Supportworks Example 1: Qu = ΣAh(9c) = (2.26)(9)(3,000) = 61,020 lb | Pass |
| Supportworks Example 1: Qa = Qu / FOS = 61/2 = 30.5 kips (FOS 2) | Pass |
| Supportworks Example 1: Torque Correlation, T = Qu/Kt = 60,000/9 = 6,667 ft·lb (Kt = 9 ft⁻¹) | Pass |
| Supportworks Example 2: Nq = 1 + 0.56(12φ)^(φ/54) = 42.6 at φ = 38° and 15.7 at φ = 30° | Pass |
| Supportworks Example 2: net plate areas 10/12 in. on a 3.5 in. shaft = 0.48/0.72 ft² | Pass |
| Supportworks Example 2: Qu = ΣAh(q′Nq) = 84,310 lb (q′12" = 1,595, q′10" = 1,731 psf, φ = 38°) | Pass |
| Supportworks Example 2: loose sand above the 12 in. plate (φ = 30°) gives Qu = 53,420 lb | Pass |
| Supportworks Example 2: T = Qu/Kt = 80,000/7 = 11,428 ft·lb (Kt = 7 ft⁻¹, 3.5 in. shaft) | Pass |
| TMG: Nq at φ = 34° is 22.0 (Perko 0.5(12φ)^(φ/54)) and 25.7 (1 + 0.56(12φ)^(φ/54)) | Pass |
| TMG: net areas on a 2⅞ in. shaft, 12 in. = 0.740 and 10 in. = 0.500 ft² | Pass |
| TMG: net areas on a 3½ in. shaft, 10/12/14 in. = 0.479/0.719/1.002 ft² | Pass |
| TMG attempt one (2⅞ in. shaft, φ = 34°, Nq = 25.7): plate loads 20,122 and 15,898 lb; Qult = 36.0 kip | Pass |
| TMG attempt one with Nq = 22.0 (Perko): Qult = 30.8 kip | Pass |
| TMG attempt two (3½ in. shaft, 10/12/14 in.): plate loads 19,606 / 26,686 / 32,613 lb; Qult = 78.9 kip | Pass |
| TMG attempt two with Nq = 22.0 (Perko): Qult = 67.5 kip | Pass |
| TMG attempt three (four plates 10/12/14/14 in.): plate loads 21,072 / 28,887 / 35,683 / 30,310 lb; Qult = 116.0 kip | Pass |
| TMG attempt three with Nq = 22.0 (Perko): Qult = 99.3 kip | Pass |
| TMG: required torque T = 80,000/Kt → 8,889 ft·lb at Kt = 9 ft⁻¹ (attempt one) and 11,429 ft·lb at Kt = 7 ft⁻¹ | Pass |
hetenyi-beam-web-validation.test.ts
Beam on an elastic foundation — validated against **Hetényi (1946)**, *Beams on Elastic Foundation*, University of Michigan Press, and **Bowles (1997)**, *Foundation Analysis and Design* 5th ed., McGraw-Hill.
Analyses validated: hetenyi-beam · Recorded run: passed — 23 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Beam on an elastic foundation — validated against **Hetényi (1946)**, *Beams on Elastic
Foundation*, University of Michigan Press, and **Bowles (1997)**, *Foundation Analysis and
Design* 5th ed., McGraw-Hill.
PUBLISHED SOURCES (every number asserted from a source was read from the page named — Hetényi from
the archive.org scan, Bowles from the local 5e PDF; none is recalled from memory):
1. Hetényi, M. (1946) Beams on Elastic Foundation, Univ. of Michigan Press:
§5 Eqs 7 a-d / 8 a-d / 9 a-d (p. 15-16, UDL on the infinite beam), §6 Eq 6 a-d (p. 14, concentrated
moment), §12 Examples 1 and 4 (pp. 33-36), §18 Example, Figure 40 (pp. 47-49, free-ended wooden
beam under P + q — ~30 printed intermediate and final values), Table I (p. 223, rows λx = 0.70-1.50,
the A/B/C/D functions).
2. Bowles, J.E. (1997) Foundation Analysis and Design 5e, Example 9-6 and Fig. E9-6b (printed
FADBEMLP output for a 6.38 m, 13-node, 2.64 m-wide footing on ks = 22 000 kN/m³; local PDF p. 549).
WHAT THE TWO SOURCES ARE AND ARE NOT. Hetényi's example is the engine's own model (continuous Winkler
foundation, free ends by end-conditioning), so agreement there is tight (≤ 1 %, with every exception
explained in the test that carries it). Bowles's Example 9-6 is a FINITE-ELEMENT solution that doubles the
two end springs (Westergaard's suggestion, the author's Comments 1-2 after Example 9-6) — a modelling
option the Hetényi closed form does not have. The engine therefore cannot reproduce Bowles's printed numbers to better than
the end-spring effect (deflections +4 % at the loaded end to +17 % at the far end). That is quantified,
not hidden: an independent Euler-Bernoulli beam + nodal-spring solver in this file reproduces Bowles's
printed deflections and moments to ≤ 0.6 % WITH doubled end springs, and the engine reproduces the same
solver to ≤ 2 % WITHOUT them — so the 4-17 % gap is the documented end-spring option, not an engine fault.
ENGINE DEFECTS FOUND BY THIS VALIDATION (fixed 2026-10-07):
· UDL kernel: 21-point Simpson quadrature integrated across the shear kernel's jump → Q = 550.3 lb
where Hetényi §18 prints 630.2 lb. Replaced by the closed forms of §5 Eqs 7-9.
· Concentrated-moment kernel had the wrong PARITY (M even, V odd; Hetényi p. 14: M and y reverse sign
to the left of the moment, Q does not). A pure couple then produced a net vertical soil reaction
(±33.6 kN of 3375 kN on Bowles Ex 9-6). Found only because Bowles's example has applied moments.
─── original header (still true) ───
Beam on an elastic foundation — validated against **Hetényi (1946)**, *Beams on Elastic
Foundation*, University of Michigan Press.
Batch 4 identified this as the cheapest high-value validation win in the whole bespoke set,
for a specific reason: Hetényi's infinite-beam solutions are **exact closed forms with
closed-form maxima**, so this engine can be checked to machine precision rather than to a
chart-reading tolerance. Almost nothing else in the geotech suite can be.
The governing equation (Hetényi Ch 1 §1, pp. 1–7) is
E·I · d⁴w/dx⁴ + k·b · w = q(x)
with the characteristic parameter (Eq 8, p. 8)
λ = ⁴√( k·b / (4·E·I) )
For a **concentrated load P on an infinite beam** (Hetényi Eq 17, p. 15) the solution and its
maxima are:
w(x) = (P·λ / 2k·b) · e^(−λx)·(cos λx + sin λx) w_max = P·λ / (2·k·b) at x = 0
M(x) = (P / 4λ) · e^(−λx)·(cos λx − sin λx) M_max = P / (4·λ) at x = 0
V(x) = −(P / 2) · e^(−λx)· cos λx V_max = P / 2 at x = 0⁺
Those three maxima are the anchors. They are not approximations and they are not read off a
figure — which is why the tolerances below are 0.1 % or tighter, not the few-percent bands the
empirical engines need.
A note on what "validated" means here. Hetényi publishes the *analytical solution*, so
matching it proves the engine implements Hetényi correctly — it does not prove Hetényi
describes any particular real footing. The Winkler assumption (independent springs, no soil
continuity) is the modelling limitation, and it is the reason `raft-winkler` also offers a
Biot/elastic-continuum method. That distinction is stated rather than glossed.
Also checked here: the classical **characteristic-length regimes**. Hetényi (and Bowles
Table 9-3) classify a beam by λL — λL < π/4 behaves as rigid, λL > π as effectively infinite.
The engine exposes `lambda_L` and `rigidity_class`, so the banding is verifiable directly.
| Test block (the published value it checks) | Verdict |
| Hetényi Eq 8 — the characteristic parameter λ and the derived rigidities | Pass |
| Hetényi Eq 17 — infinite beam, concentrated load: the three closed-form maxima | Pass |
| Hetényi Eq 17 — the full deflection and moment PROFILE, not just the peaks | Pass |
| Hetényi — an applied MOMENT on an infinite beam (Eq 23) | Pass |
| Hetényi — superposition holds (the solution is linear) | Pass |
| Hetényi — the λL rigidity bands | Pass |
| Hetényi — a long finite beam converges on the infinite-beam solution | Pass |
| Hetényi §18 — λ and λl (p. 47) | Pass |
| Hetényi §18 — the P load on the infinite beam at A and B (Eq 5 c-d, p. 47) | Pass |
| Hetényi §18 — the UDL on the infinite beam at A, B (Eqs 8, 9) and C (Eq 7) — the Simpson-defect regression | Pass |
| Hetényi §18 — P + q on the infinite beam: the printed totals at A and B (p. 47) | Pass |
| Hetényi §18 — the infinite-beam deflections at A, C, B (table a, p. 48) | Pass |
| Hetényi §18 — the FINITE free-ended beam: deflections, soil pressure, M and Q at C (pp. 48-49) | Pass |
| Hetényi §12 Example 1 — equal forces at x = π/2λ reduce the maximum moment (0.7921, 0.5842, 0.7489) | Pass |
| Hetényi §12 Example 4 — reinforcing ring on a long tube: bending stress is 82 % above the hoop stress (p. 35-36) | Pass |
| Hetényi §6 — concentrated moment: y and M reverse to the left, Q does not; M jumps by M₀ across the load | Pass |
| Hetényi — a pure couple on a FINITE free beam carries no net soil force and balances its own moment | Pass |
| Hetényi — an applied moment AT a free end: M just inside the end equals the applied moment (free-end condition) | Pass |
| Hetényi Table I — A, B, C, D at λx = 0.70, 0.89, 1.00, 1.25, 1.50 (printed to 4 decimals) | Pass |
| Bowles Example 9-6 — an independent solver WITH the printed doubled end springs reproduces the printed output | Pass |
| Bowles Example 9-6 — global equilibrium: the engine's soil reaction sums to the applied 3375 kN (printed 3374.71 vs 3375.00) | Pass |
| Bowles Example 9-6 — the engine against the printed deflections, pressures and moments (model-limited band) | Pass |
| Bowles Example 9-6 — WHY the engine differs: against the same solver without the end-spring doubling it agrees | Pass |
lateral-pile-group-published-web-validation.test.ts
Published-answer validation for the lateral pile-GROUP p-multiplier engine (`lateral-pile-group.ts`).
Analyses validated: lateral-pile-group · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-answer validation for the lateral pile-GROUP p-multiplier engine
(`lateral-pile-group.ts`). Complements `lateral-pile-group-web-validation.test.ts`, whose own
header declares its table checks to be equation/table-fidelity evidence; THIS suite checks the
numbers that two independent design documents PRINT, and drives them through the full group
solver (row assignment, piles-per-row weighting), not only through the lookup function.
SOURCES (each opened for this suite; locators beside every value):
[FHWA] FHWA-NHI-10-016 (2010 edition), Drilled Shafts Manual, Chapter 14 — Table 14-2
"Recommended P-multiplier, Pm, values for design by row position" (§14.5.1), and the
worked examples of §14.6.1 (2×2 group) and §14.6.2 (2×3 group) which print the
weighted-average Pm used for a group.
[AASHTO] AASHTO (2007) LRFD Bridge Design Specifications 4th ed. SI, §10.7.2.4,
Table 10.7.2.4-1 "Pile P-Multipliers, Pm, for Multiple Row Shading"
(printed for 3B and 5B spacing only; the Table is itself "averaged from Hannigan
et al. (2005)").
The two tables agree at 3D/5D, which is itself a cross-source check of the engine's anchors.
The 4D column exists in [FHWA] only — AASHTO would interpolate (row 2: 0.675) and the engine
follows FHWA's printed 0.65 — so 4D is asserted against [FHWA] alone.
Every expected value is a number printed in the cited table/example; none was computed by this
engine. The tolerances are the tables' own precision (2 decimals printed → exact to 1e-9 in
the lookup; 1e-6 through the solver).
| Test block (the published value it checks) | Verdict |
| FHWA Table 14-2, 3D c-c: lead 0.7, 2nd 0.5, 3rd+ 0.35 | Pass |
| FHWA Table 14-2, 4D c-c: lead 0.85, 2nd 0.65, 3rd+ 0.5 | Pass |
| FHWA Table 14-2, 5D c-c: lead 1.0, 2nd 0.85, 3rd+ 0.7 | Pass |
| FHWA Table 14-2, ≥6D c-c: no group reduction in any row (1.0, 1.0, 1.0) | Pass |
| AASHTO (2007) Table 10.7.2.4-1, 3B spacing: Row 1 0.7, Row 2 0.5, Row 3 and higher 0.35 | Pass |
| AASHTO (2007) Table 10.7.2.4-1, 5B spacing: Row 1 1.0, Row 2 0.85, Row 3 and higher 0.7 | Pass |
| AASHTO Table 10.7.2.4-1 "Row 3 and higher": a 5th row still takes the row-3 value | Pass |
| FHWA §14.6.1 (2×2 group, s = 3D): weighted average Pm = [2(0.7)+2(0.5)]/4 = 0.6 | Pass |
| FHWA §14.6.2 (2×3 group, three rows of two shafts, s = 3D): weighted average Pm = 0.52 | Pass |
lateral-pile-group-web-validation.test.ts
Formula-fidelity validation against Brown (1987) Table 14-2 (as tabulated in FHWA-NHI-10-016 Drilled Shafts Manual §14.5.1), IDENTICAL to AASHTO LRFD Bridge Design Table 10.7.2.4-1 -- the published p-multiplier (Pm) values by row and spaci…
Analyses validated: lateral-pile-group · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against Brown (1987) Table 14-2 (as tabulated in
FHWA-NHI-10-016 Drilled Shafts Manual §14.5.1), IDENTICAL to AASHTO LRFD
Bridge Design Table 10.7.2.4-1 -- the published p-multiplier (Pm) values by
row and spacing that this engine's `autoPMultiplier` implements exactly --
and Reese & Van Impe (2011) Sec.8's side-by-side reduction factor formula
(`sideBySideMultiplier`). Both functions are exported specifically so they
can be validated directly against the published table anchors, without
running the (numerically-solved) full group analysis.
| Test block (the published value it checks) | Verdict |
| [1-12] all 12 published table anchors (AASHTO LRFD Table 10.7.2.4-1 / Brown Table 14-2): rows 1-3 at spacing 3D/4D/5D/6D | Pass |
| [13-14] linear interpolation between anchors matches exactly: row1 at 3.5D = 0.775, row2 at 4.5D = 0.75 | Pass |
| [15] spacing below 3D holds the 3D anchor (extrapolation is unsupported by the data, per the engine's own documented policy) | Pass |
| [16] spacing at or above 6D gives Pm=1.0 for every row (no shadowing at wide spacing) | Pass |
| [17] row 4+ shares the row-3+ column exactly, per the table's own "3rd+" grouping | Pass |
| [18-19] side-by-side factor matches the exact Reese & Van Impe (2011) closed-form 0.64.(s/D)^0.34: s/D=3 -> 0.929825, s/D=2 -> 0.810084 | Pass |
| [20] side-by-side factor caps at 1.0 for wide spacing | Pass |
| [21] side-by-side factor defaults to 1.0 (no reduction) when spacing is not supplied, per the documented policy that it is second-order and off by default | Pass |
| [22] the leading row (highest Pm) always carries at least as much load per pile as trailing rows, at the common cap deflection | Pass |
| [23] group efficiency is < 1 (shadowing reduces total capacity relative to isolated piles) and equals group load / (n . isolated load at the same deflection) exactly | Pass |
| [24] a manual p_multipliers override is used verbatim instead of the auto AASHTO table | Pass |
| [25] invalid inputs (zero diameter, spacing, or load) are refused | Pass |
lateral-pile-matlock-reese-web-validation.test.ts
Web-benchmark validation for the p-y lateral-pile FDM solver against the EXACT Matlock & Reese (1960) nondimensional solution — the closed-form analytical benchmark that underlies COM624 / a p-y beam-column (Reese) solver.
Analyses validated: lateral-pile · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the p-y lateral-pile FDM solver against the
EXACT Matlock & Reese (1960) nondimensional solution — the closed-form
analytical benchmark that underlies COM624 / a p-y beam-column (Reese) solver. For a pile in soil with a
linearly-increasing modulus Es = nh·z, the response is governed by the relative
stiffness factor T = (EI/nh)^(1/5) and universal nondimensional coefficients.
Feeding our solver the `linear_subgrade` p-y model (p = k·z·y, k = nh) must
reproduce those coefficients — proof the beam-on-nonlinear-Winkler solver is
correct at its linear limit, exactly what lets a user diff our numbers vs a p-y beam-column (Reese) solver.
Coefficients (long pile, Zmax = L/T ≥ 5), Reese & Van Impe (2010) Table 4.x /
Matlock & Reese (1960):
Free head, lateral load P (M=0): y_g = 2.435·P·T³/EI , Mmax = 0.772·P·T
Free head, moment M (P=0): y_g = 1.623·M·T²/EI
Fixed head, lateral load P: y_g = 0.930·P·T³/EI , M_head = −0.930·P·T
These are exact published constants, cited in every lateral-pile text.
| Test block (the published value it checks) | Verdict |
| free-head lateral load → Matlock-Reese Ay = 2.435 and Am = 0.772 | Pass |
| free-head applied moment → Matlock-Reese By = 1.623 | Pass |
| fixed-head lateral load → 0.930·P·T³/EI deflection and −0.930·P·T moment | Pass |
| response is linear in load and follows the T-scaling law | Pass |
| the linear_subgrade p-y is exactly p = k·z·y (no cap, elastic reference) | Pass |
lateral-pile-pdelta-web-validation.test.ts
Validation for the axial P-Δ (beam-column) term added to the laterally-loaded pile solver (`lateral-pile.ts`).
Analyses validated: lateral-pile · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the axial P-Δ (beam-column) term added to the laterally-loaded
pile solver (`lateral-pile.ts`). the release rules gate.
- Reese & Van Impe (2011) §3.6 — combined axial + lateral loading: axial
compression amplifies the lateral moment & deflection via the P·y″ term.
- Timoshenko & Gere, Theory of Elastic Stability — beam-column amplification
grows monotonically with P and diverges as P → the buckling load.
- Regression: P = 0 reproduces the pure-lateral solve byte-for-byte.
| Test block (the published value it checks) | Verdict |
| P = 0 (and axial omitted) are byte-identical — regression guard | Pass |
| Axial compression amplifies head deflection and max moment (P-Δ) | Pass |
| Amplification grows monotonically and accelerates toward buckling | Pass |
| A very large axial load drives buckling/overload (no finite equilibrium) | Pass |
| Fixed-head pile also shows axial amplification | Pass |
| Amplification obeys the Timoshenko-Gere magnification law Af = 1/(1−P/Pcr), with Pcr ≈ Davisson-Robinson | Pass |
micropile-web-validation.test.ts
Published-value validation for micropile capacity (`micropile.ts`, `computeMicropile`): structural allowable loads of the composite cased/uncased section and the grout-to-ground bond.
Analyses validated: micropile · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation for micropile capacity (`micropile.ts`, `computeMicropile`):
structural allowable loads of the composite cased/uncased section and the grout-to-ground bond.
the release rules gate: every expected value is a number printed in the source below, which was opened
for this suite.
SOURCE (the only one available — see SHORTFALL)
FHWA-NHI-05-039 (2005 edition), "Micropile Design and Construction — Reference Manual for NHI
Course 132078", U.S. Dept. of Transportation / FHWA (public domain; downloaded from
https://rosap.ntl.bts.gov/view/dot/50231 on 2026-10-07, 456 p.). Locators next to each value:
· Chapter 5, Eq. 5-1 … 5-2, 5-9, and the worked example of Figure 5-2 (p. 5-11 … 5-12)
· Chapter 6 §6.7.4 "Design example for slope stabilization with micropiles" (p. 6-43 … 6-44)
· Appendix D "Sample Problem No. 1" Steps 3–6 (p. D-10 … D-13)
· Appendix E "Sample Problem No. 2" Structural Capacity Evaluation (p. E-2 … E-4)
SHORTFALL (honest statement): one source document. The engine's other cited references (Bruce &
Juran; Sabatini et al. as a generic citation) could not be opened here, and no second local book
carries micropile design equations with worked numbers (searched the reference library — the national
bridge-design specification of 2007 has no micropile article — Tomlinson, CFEM, Varghese, Han, and the
Caltrans guidance note).
The suite therefore meets the ≥20-assertion count on ONE source and must not be read as
two-source validation.
TOLERANCES (source rounding): FHWA prints loads to 3 s.f. (671, 620, 415, 730, 596 kN; 2,479 kN; 276
kips) → 0.3 %; the manual uses π = 3.14 in Appendix D Step 5 (0.05 %) and rounds the required
2.56 m bond length to 2.6 m (1.9 %).
Unit conversions: 1 kip = 4.4482216 kN · 1 in² = 645.16 mm² · 1 ksi = 6.894757 MPa.
| Test block (the published value it checks) | Verdict |
| FHWA NHI-05-039 Eq. 5-1, Fig. 5-2 example: Pc-allowable = 276 kips | Pass |
| FHWA Appendix D Step 3: cased length Pt-allowable = 0.55 Fy (Abar + Acasing) = 620 kN | Pass |
| FHWA Appendix D Step 3: cased length Pc-allowable = 0.4 f′c Agrout + 0.47 Fy (Abar + Acasing) = 671 kN | Pass |
| FHWA Appendix D Step 4: uncased length Pt-allowable = 0.55 Fy-bar Abar = 415 kN | Pass |
| FHWA Appendix D Step 4: uncased length Pc-allowable = 730 kN | Pass |
| FHWA Appendix D Step 5 (Eq. 5-9): PG-allowable = (265/2.0)(3.14)(0.191)(7.5) = 596 kN at Lb = 7.5 m | Pass |
| FHWA Appendix D Step 5 (Eq. 5-10): the required bond length Lb = 7.48 m carries PG-allowable = 595 kN | Pass |
| FHWA Appendix D Step 6: the 595 kN design load is satisfied (671 / 730 / 596 kN allowables all ≥ 595) — "pile axial design is OK" | Pass |
| FHWA Chapter 6 Eq. 6-1: Pult = 66 kPa × 10 m × π × 0.229 m = 475 kN | Pass |
| FHWA Chapter 6 §6.7.4: Lbelow = 475/(515 π 0.229) × 2.0 = 2.6 m provides the 475 kN | Pass |
| FHWA Appendix E (Eq. 5-6): Pc-allowable = 0.4 (27.6)(0.0218) + 0.47 (552)(0.00863) = 2,479 kN | Pass |
| FHWA Appendix E: Fa = 0.47 Fy = 259.44 MPa is the steel compression stress in Pc-allowable | Pass |
| FHWA Appendix E: Fb-type allowable 0.55 Fy = 303.6 MPa is the steel tension stress in Pt-allowable | Pass |
⚑ pile-axial-load-transfer-web-validation.test.ts
Axial load-transfer (t-z / q-w) engine (`pile-axial-load-transfer.ts`) compared with the PUBLISHED numbers that could actually be opened and that map onto something this engine computes.
Analyses validated: pile-axial-load-transfer · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Axial load-transfer (t-z / q-w) engine (`pile-axial-load-transfer.ts`) compared with the PUBLISHED numbers that
could actually be opened and that map onto something this engine computes. Read this header first: the
covered scope is NARROW and the suite says so.
WHAT IS COVERED — the engine's ultimate END BEARING (base_ult = A·q_max), through which two published factors
are recovered exactly:
· sand: q_max = N_q·σ'v with N_q = e^{π tanφ}·tan²(45° + φ/2). Published N_q:
Das, B.M. (2016), Principles of Foundation Engineering, Cengage (page footers "Copyright 2016"),
Table 4.2 "Bearing Capacity Factors" (book p.~125, Ch.4; page text read): N_q to 2 d.p., φ' = 0…50° (rows 20–42° used).
Bowles, J.E. (1997), Foundation Analysis and Design 5th ed., Table 4-4 "Bearing-capacity factors for the
Meyerhof, Hansen and Vesic equations" (Ch.4): N_q to 1 d.p. for φ = 0, 5, 10, 15, 20, 25, 26, 28, 30, 32,
34, 36, 38, 40, 45, 50°. Bowles notes the table is computer-generated and "slight differences … can be
obtained" with other arithmetic; his last digit differs from Das by up to one unit (e.g. 64.1 vs 64.20,
134.7 vs 134.88, 318.5 vs 319.07).
· clay: q_max = 9·s_u, i.e. N_c = 9. Published: Varghese, P.C. (2005), Foundation Engineering, PHI Learning,
Example 13.2 ("Find Nc from Skempton curve … L/D = 8 > 4; Nc = 9"), and Mittal, S. (2025), Pile Foundation
Design and Construction 3rd ed., Example 3.1 (Eq 3.12 evaluated with "9.0").
TOLERANCES: the source's own printing precision — half a unit of the last printed digit for Das (±0.005) —
plus the engine's output quantisation (it reports kN to 0.1; with the pile below that is ±0.0021 on N_q). For Bowles
ONE full unit of the last printed digit (±0.1), because of his own stated floating-point note above (rows up to 40° only). Nothing else.
The pile is D = 1.0 m, L = 3 m, γ = 10 kN/m³ dry (σ'v = 30 kPa at the toe) so that N_q·σ'v stays below the engine's
12 000 kPa cap for every φ up to 50°.
ROWS LEFT OUT (recorded, not asserted): the exact closed form gives N_q(48°) = 222.2996 and N_q(50°) = 319.0573, which
Das prints as 222.31 and 319.07 (two printed units off — the table's arithmetic differs in the 5th significant figure),
and Bowles prints 134.7 and 318.5 at 45° and 50° against the formula's 134.87 and 319.06 (0.13 % and 0.17 % low — his
program arithmetic). The engine follows the formula, so these four printed values disagree with the engine and with each
other by amounts larger than their own stated printing precision; they were dropped rather than given a wider tolerance.
WHAT IS *NOT* COVERED, AND WHY — read before trusting the engine on the rest:
· the t-z and q-w curve SHAPES, the α (API) and β (K·tanδ) skin-friction laws, and the segment-marching solver have
NO published numeric check here. The API RP 2A/2GEO clay t-z table (t/t_max vs z/D) and the Coyle & Reese (1966)
curves could not be opened as numbers (the Rocscience pages carry them as figures; the API/ASCE papers are PDFs
behind walls).
· UNRESOLVED MISMATCH recorded, not asserted: NCHRP 24-17 Appendix D (Paikowsky et al.) prints the Reese & O'Neill
sand trend q_st/Q_s = −2.16S⁴ + 6.34S³ − 7.36S² + 4.15S (S = settlement/diameter in %) and evaluates it as
0.5829 at S = 0.2 and 0.892 at S = 0.5. The engine's `reese_oneill` t-z ramps linearly to 1.0 at w/D = 0.5 %, i.e.
0.40 at 0.2 % (−31 %) and 1.00 at 0.5 % (+12 %); the published curve peaks near 0.97 at S ≈ 1 %. The engine calls
its model a "trend", so this is a simplification not a coding slip, and changing it would move every reese_oneill
result, so it is left for a decision.
· API RP 2A (2002), as reproduced at rocscience.com/help/rspile/…/api-sand (read 2026-10-06): limiting skin friction
47.8 / 67.0 / 81.3 / 95.7 / 114.8 kPa and N_q 8 / 12 / 20 / 40 / 50 for δ = 15 / 20 / 25 / 30 / 35°. The engine uses
the closed-form N_q above (18.4 at φ 30°, 64.2 at 40° — i.e. −8 % … +28 % against the API values at δ = 25…35°, φ ≈
δ + 5°) and a flat 100 kPa skin cap (49 % above the API limit for δ = 20°). Different documented choices, recorded.
· the worked example Mittal Ex 3.1 ("Qu = 44.9 tonnes") is internally inconsistent (its own terms sum to ≈ 23 t) and
was NOT used.
PUBLISHED-VALUE COUNT: 10 (Das) + 6 (Bowles) + 2 (N_c = 9) = 18 — all on the end-bearing factors. By scope that is
well under what "release-ready" means for a t-z engine, and the suite is NOT evidence for the load-settlement curve.
| Test block (the published value it checks) | Verdict |
| [1] Das Table 4.2: N_q = 6.40 at φ' = 20° | Pass |
| [1] Das Table 4.2: N_q = 10.66 at φ' = 25° | Pass |
| [1] Das Table 4.2: N_q = 14.72 at φ' = 28° | Pass |
| [1] Das Table 4.2: N_q = 18.40 at φ' = 30° | Pass |
| [1] Das Table 4.2: N_q = 23.18 at φ' = 32° | Pass |
| [1] Das Table 4.2: N_q = 33.30 at φ' = 35° | Pass |
| [1] Das Table 4.2: N_q = 48.93 at φ' = 38° | Pass |
| [1] Das Table 4.2: N_q = 64.20 at φ' = 40° | Pass |
| [1] Das Table 4.2: N_q = 85.38 at φ' = 42° | Pass |
| [1] Das Table 4.2: N_q = 134.88 at φ' = 45° | Pass |
| [2] Bowles Table 4-4: N_q = 6.4 at φ = 20° | Pass |
| [2] Bowles Table 4-4: N_q = 10.7 at φ = 25° | Pass |
| [2] Bowles Table 4-4: N_q = 18.4 at φ = 30° | Pass |
| [2] Bowles Table 4-4: N_q = 29.4 at φ = 34° | Pass |
| [2] Bowles Table 4-4: N_q = 37.7 at φ = 36° | Pass |
| [2] Bowles Table 4-4: N_q = 64.1 at φ = 40° | Pass |
| [3] Varghese Ex 13.2 (Skempton): N_c = 9 for a deep clay base | Pass |
| [4] Mittal Ex 3.1 (Eq 3.12): N_c = 9.0 | Pass |
⚑ pile-buckling-web-validation.test.ts
Partially-embedded pile buckling (`pile-buckling.ts`, Davisson–Robinson equivalent cantilever) checked against PUBLISHED numbers.
Analyses validated: pile-buckling · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Partially-embedded pile buckling (`pile-buckling.ts`, Davisson–Robinson equivalent cantilever) checked
against PUBLISHED numbers. Every expected value was read from a page that was opened; none is taken from
this engine. Locators sit beside each value.
SOURCES
Tomlinson, M.J. & Woodward, J. (2015), Pile Design and Construction Practice 6th ed., CRC Press, §6.3.9:
Eq 6.50 z_f = 1.4R (constant modulus), Eq 6.51 z_f = 1.8T (linearly increasing), Eqs 6.52–6.53 the
buckling loads; Eq 6.11 R = (EI/(kB))^¼ (p.332), Eq 6.12 T = (EI/n_h)^⅕.
NAVFAC (1986), DM 7.02 Foundations and Earth Structures, Deep Foundations "Pile Buckling": "fixed at
depth 1.8T", "depth of fixity as 1.4R … B is pile width (diameter) and K_h is defined in the units of
force/length³" (text layer of the library copy; the clause was read there).
Bureau of Indian Standards (2007), IS 800:2007 Table 11 "Effective Length of Prismatic Compression
Members" (printed p.45; the page was rendered and read as an image): 2.0L, 1.0L, 1.2L, 0.8L, 0.65L.
Bowles, J.E. (1997), Foundation Analysis and Design 5th ed., Example 16-14: 254 mm × 6.35 mm pipe pile,
E = 200 000 MPa, I = 0.379×10⁻⁴ m⁴, 7.00 m above ground, "EULER BUCKLING LOAD = 381.7 KN" (k = 2 for
a column fixed at one end, fixed at the ground line).
Varghese, P.C. (2005), Foundation Engineering, PHI Learning, Example 13.3 (R = 0.546 m from
EI = (10×10²)(4×10⁻⁴) MN·m², K_h B = 15 × 0.3) and Example 13.4 (T = 1.32 m from EI = 40×10⁶ N·m²,
n_h = 10×10⁶ N/m³).
Mittal, S. (2025), Pile Foundation Design and Construction Including Well Foundation 3rd ed., CBS, the
20-pile IS 2911 lateral example: T = 1.63 m from E = 28 500 MPa, I = 0.0031 m⁴, n_h = 7750 kN/m³.
TOLERANCES are the sources' own printing precision (half a unit of the last printed digit) plus the engine's
documented 3-decimal output rounding where it matters. Nothing is tuned.
ENGINE DEFECT FOUND BY [6] (fixed 2026-10-06 in pile-buckling.ts): the clay stiffness factor was computed
as R = (EI/k_h)^¼ with no pile width. Tomlinson Eq 6.11, NAVFAC and Varghese Eq 13.6 all put K = k_h·B in the
denominator, and without B the quotient has units m⁵. On Varghese Ex 13.3 the old formula gives R = 0.404 m
against the printed 0.546 m (−26 %) — and for any pile narrower than 1 m it under-states z_f and over-states
P_cr (unconservative). The fix adds an optional `pile_width_m` (default 1 m = the old behaviour, with a
warning that says so).
NOT ASSERTED, on purpose:
· the depth of fixity against the IS 2911 chart (Varghese Fig 13.7: z_f/R = 1.42 at e/R = 1.83, z_f/T = 1.92 at
e/T = 0; Mittal: L_f/T = 2.2): that is a different, e-dependent method from the constant 1.4R / 1.8T this
engine implements, so a numeric comparison would judge the method choice, not the implementation.
· Bowles Example 16-14's finite-element first-mode load of 198.0 kN: it includes the pile tip on rock, the
50 % point-load split and a parabolic skin-friction reduction, none of which the equivalent-cantilever
method models. The engine gives ≈ 209 kN there (+5.5 %); informative only.
· the sway case K = 1.2 of IS 800 Table 11 has no option in this engine.
Note on labels: the engine's `pinned` option carries K = 1.0, which is the pin–pin row of IS 800 Table 11 (and
Tomlinson Eq 6.53's fixed-and-translating head), not "pinned top, fixed base" (that is 0.8, the `fixed_pinned` option).
PUBLISHED-VALUE COUNT: 10 (IS 800: 4; z_f coefficients 1.4 and 1.8, each in Tomlinson and NAVFAC; Bowles
381.7; Varghese 0.546 and 1.32; Mittal 1.63). Below the repo's 20; the shortfall is reported.
| Test block (the published value it checks) | Verdict |
| [1] IS 800 Table 11: fixed-free column has effective length 2.0 L | Pass |
| [2] IS 800 Table 11: pinned-pinned column has effective length 1.0 L | Pass |
| [3] IS 800 Table 11: translation held, fixed one end and pinned at the other has effective length 0.8 L | Pass |
| [4] IS 800 Table 11: both ends fixed and translation held has effective length 0.65 L | Pass |
| [5] Tomlinson Eq 6.51 and NAVFAC DM 7.02: for a linearly increasing modulus z_f = 1.8 T | Pass |
| [6] Tomlinson Eq 6.50 and NAVFAC DM 7.02: for a constant modulus z_f = 1.4 R | Pass |
| [7] Bowles Ex 16-14: 7.00 m free-standing part, EI = 200 000 MPa × 0.379×10⁻⁴ m⁴, fixed at the ground line (k = 2) → Euler load 381.7 kN | Pass |
| [8] Varghese Ex 13.3: R = [EI/(K_h B)]^¼ = 0.546 m for EI = 0.4 MN·m², K_h = 15 MN/m³, B = 0.3 m | Pass |
| [9] Varghese Ex 13.4: T = (EI/n_h)^⅕ = 1.32 m for EI = 40×10⁶ N·m², n_h = 10×10⁶ N/m³ | Pass |
| [10] Mittal: T = 1.63 m for E = 28 500 MPa, I = 0.0031 m⁴ (as printed), n_h = 7750 kN/m³ | Pass |
pile-capacity-web-validation.test.ts
WEB-BENCHMARK validation for the axial pile-capacity engine (the release rules mandatory ≥20 cited-value gate).
Analyses validated: pile-capacity · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the axial pile-capacity engine
(the release rules mandatory ≥20 cited-value gate). Every value below is a PUBLISHED
pile-design factor from a primary source, reproduced in the standard textbooks
and in the on-disk reference library:
• Skempton (1959) — end-bearing factor Nc = 9 for bored piles in clay at
L/D ≥ 4; adopted by IS 2911-1:2010 Cl B-1.2, Tomlinson "Pile Design &
Construction Practice", Das, and AASHTO LRFD §10.7.3.9.
• Tomlinson / API RP2A — adhesion factor α: α = 1.0 for soft clay
(su ≤ 25 kPa) reducing to ≈ 0.5 for stiff clay (su ≥ 70 kPa). The engine's
simplified line is α = 1 − (su−25)/90 between (Tomlinson, PDCP).
• IS 2911 (Part 1/Sec 1):2010 Annex B-2 Fig. 2 — α vs Cu (α = 1 below 40 kPa, 0.445 at 100,
flat 0.27 beyond 180). CORRECTED 2026-09-27: this file previously asserted "α = 1 − (cu−25)/70"
as the IS 2911 rule; no such expression appears in IS 2911 (Part 1/Sec 1 or Sec 4):2010, whose
Annex B Note refers only to Fig. 2. Chart read-off tolerance ±0.02.
• Reissner (1924) — bearing factor Nq = e^{π·tanφ}·tan²(45+φ/2), used for the
pile tip in sand and capped at the critical depth, which IS 2911-1 Annex B-1 Note 5 sets at
15·D for φ ≤ 30° increasing to 20·D for φ ≥ 40°. Reproduced in Das Table 3.1.
These are the canonical, universally-published pile factors — the same across
IS 2911, EC7 and AASHTO (the codes differ only in the safety convention, which
is exercised separately by the design-code tests). The engine must reproduce
each EXACTLY (α, Nc, Nq are closed-form), so the tolerance is tight.
HONEST NOTE on sand tip resistance: the engine deliberately uses the
shallow/general Reissner Nq (not Meyerhof's 1976 DEEP driven-pile Nq, which is
3–4× higher). This is a documented CONSERVATIVE choice (see pile-capacity.ts
`NqForPiles`). These tests validate the values the engine actually claims.
| Test block (the published value it checks) | Verdict |
| pile web-validation: Tomlinson / API adhesion factor α (PDCP curve) | Pass |
| pile web-validation: IS 2911-1 Annex B-2 Fig. 2 α (chart read-off ±0.02) | Pass |
| pile web-validation: Skempton Nc = 9 base resistance in clay (qb = 9·su) | Pass |
| pile web-validation: Reissner Nq at pile tip in sand (capped at Lc=15D) | Pass |
| pile web-validation: critical depth 15·D at φ ≤ 30° → 20·D at φ ≥ 40° (IS 2911-1 Annex B-1 Note 5) | Pass |
| pile web-validation: full Qult integration — hand-verified from cited factors | Pass |
| pile web-validation: INTERNATIONAL design paths — AASHTO LRFD + EC7 partial factors | Pass |
pile-capacity-worked-examples-web-validation.test.ts
pile-capacity — FULL WORKED EXAMPLES (the ≥20-value gate).
Analyses validated: pile-capacity · Recorded run: passed — 28 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
pile-capacity — FULL WORKED EXAMPLES (the ≥20-value gate). Every expected value is PRINTED in the
cited source, read 2026-09-27 from `Geo Technical engineering books/`. Source-specific choices
the source states (its α, K, δ/φ, critical depth, model factor) are passed as inputs.
[DAS] Das, Principles of Foundation Engineering: Ex 9.2 (Qp in clay), Ex 9.5 (sand shaft with
L′ = 15D), Ex 9.7 (α method, Das Table 9.10 α = 0.87 / 0.74 / 0.51).
[BOW] Bowles 5e: Ex 16-3 (soft clay, single α = 1.05), Ex 16-4 (α = 0.98 / 0.88).
[DUB] Geotechnet EC7 worked examples (Dublin 2013) A.8.2: driven pile in boulder clay, α = 0.4,
Irish NA model factor 1.75, R_c;d printed as a + b·Ls for DA1-C1, DA1-C2 (R4), DA2 (R2),
DA3 (M2, R3) — checked at two shaft lengths each.
[EN] EN 1997-1:2004 Annex A Tables A.6 / A.7 (γb, γs for R1–R4).
[AASHTO] AASHTO LRFD 4th ed. (2007, SI) Tables 10.5.5.2.3-1 and 10.5.5.2.4-1.
Das's piles in Ex 9.5 are 406 mm SQUARE; the engine is circular, so the shaft is compared per metre
of perimeter (Das: 2094.43 kN / 1.628 m).
| Test block (the published value it checks) | Verdict |
| [DAS] Ex 9.2 Meyerhof point resistance in clay Qp = 9·cu·Ap = 132.9 kN | Pass |
| [DAS] Ex 9.7 α method (Table 9.10 α) → Qs = 1050 kN | Pass |
| [DAS] Ex 9.7 α method, layer 1 shaft = 93.7 kN | Pass |
| [DAS] Ex 9.7 α method, layer 2 shaft = 297.5 kN | Pass |
| [DAS] Ex 9.7 α method, layer 3 shaft = 659.1 kN | Pass |
| [DAS] Ex 9.5 sand shaft, K = 1.3, δ = 0.8φ, L′ = 15D → Qs = 2094.43 kN on a 1.628 m perimeter | Pass |
| [BOW] Ex 16-3 very soft clay, single α = 1.05 → Qs = 284.9 kN | Pass |
| [BOW] Ex 16-3 point Ppu = 9·su·Ap = 7.7 kN | Pass |
| [BOW] Ex 16-4 upper soft clay (α 0.98): Qs,1 = 256 kN | Pass |
| [BOW] Ex 16-4 medium clay (α 0.88): 70.2 kN per metre | Pass |
| [BOW] Ex 16-4 point Qp = 9·su·Ap = 82 kN | Pass |
| [DUB] A.8.2 characteristic base Rb;k = 9·cu·Ab = 386 kN | Pass |
| [DUB] A.8.2 characteristic shaft Rs;k = 153 kN per metre (α 0.4) | Pass |
| [DUB] A.8.2 EC7_DA1_C1: R_c;d = 221 + 87.4·Ls at Ls = 8 m | Pass |
| [DUB] A.8.2 EC7_DA1_C1: R_c;d = 221 + 87.4·Ls at Ls = 16 m | Pass |
| [DUB] A.8.2 EC7_DA1_C2: R_c;d = 170 + 67.3·Ls at Ls = 8 m | Pass |
| [DUB] A.8.2 EC7_DA1_C2: R_c;d = 170 + 67.3·Ls at Ls = 16 m | Pass |
| [DUB] A.8.2 EC7_DA2: R_c;d = 201 + 79.5·Ls at Ls = 8 m | Pass |
| [DUB] A.8.2 EC7_DA2: R_c;d = 201 + 79.5·Ls at Ls = 16 m | Pass |
| [DUB] A.8.2 EC7_DA3: R_c;d = 158 + 62.3·Ls at Ls = 8 m | Pass |
| [DUB] A.8.2 EC7_DA3: R_c;d = 158 + 62.3·Ls at Ls = 16 m | Pass |
| [EN] EN Table A.6 driven R4 (DA1-C2): γb 1.3, γs 1.3 | Pass |
| [EN] EN Table A.7 bored R1 (DA1-C1): γb 1.25, γs 1.0 | Pass |
| [EN] EN Table A.7 bored R4 (DA1-C2): γb 1.6, γs 1.3 | Pass |
| [AASHTO] Table 10.5.5.2.3-1 driven pile in clay, α-method: φ = 0.35 | Pass |
| [AASHTO] Table 10.5.5.2.3-1 driven pile in sand, Nordlund/Thurman: φ = 0.45 | Pass |
| [AASHTO] Table 10.5.5.2.4-1 drilled shaft in clay: side 0.45, tip 0.40 | Pass |
| [AASHTO] Table 10.5.5.2.4-1 drilled shaft in sand: side 0.55, tip 0.50 | Pass |
pile-downdrag-web-validation.test.ts
PILE DOWNDRAG (negative skin friction) — web-validation benchmark.
Analyses validated: pile-downdrag · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PILE DOWNDRAG (negative skin friction) — web-validation benchmark.
SOURCES
A) Das B.M., "Principles of Foundation Engineering", Cengage Learning,
§9.22 "Negative Skin Friction", Eqs (9.122)-(9.126):
Example 9.19 — clay fill over granular soil (Figure 9.42a)
Example 9.20 — granular fill over clay (Figure 9.42b)
Case study — Bjerrum, Johannessen & Eide (1969), test pile in the
harbour of Oslo, Norway: computed 2348 kN against a
MEASURED maximum downdrag of about 2500 kN. This is the
only field measurement in the section and is the most
valuable anchor here, because it checks the method
against reality rather than against its own algebra.
B) FHWA-NHI-10-016 (May 2010) "Drilled Shafts: Construction Procedures and
LRFD Design Methods", §13.6 Downdrag:
§13.6.4 Eq (13-35) fND = a′ + K σ′v tan δ′, "K can be taken equal to
the in-situ value, K₀"; O'Neill & Reese (1999)
recommend α = 1.0 for downdrag
§13.6.5 Eq (13-38) Σηγ F + γp(DD) ≤ Σφ_S R_SN,i + φ_B R_BN
AASHTO LRFD (2007): γ_DD = 1.25 max / 0.35 min
Two standard families, one Indian-independent: a US textbook closed form and
the US federal LRFD design method. IS 2911-1 Cl 7.4.2 remains the third path
in the engine and is unchanged by this batch.
COUNT: 34 cited values + 5 proof-by-consequence checks.
| Test block (the published value it checks) | Verdict |
| Das Ex 9.19 — clay fill over granular, Eq (9.123): 6 published values | Pass |
| Das Ex 9.19 — Qn scales as Hf², which is what Eq (9.123) asserts | Pass |
| Das Ex 9.20 — neutral depth Eq (9.124) and drag Eq (9.126): 8 published values | Pass |
| Das Ex 9.20 — the closed-form root satisfies Eq (9.124) AS PRINTED, not just our rearrangement | Pass |
| E-54 — end-bearing vs floating is a factor of two on the drag force | Pass |
| Oslo harbour test pile — reproduces the published 2348 kN and lands within 6.1 % of the measured 2500 kN | Pass |
| E-55 (unsafe) — α banded by s_u gives 0.4 where FHWA §13.6.4 requires 1.0: 2.5x under-predicted drag | Pass |
| E-53 (conservative) — β interpolated on φ′ is 2.04x the K₀ form the sources use | Pass |
| the general summation and the closed form agree on the Oslo clay layer | Pass |
| AASHTO LRFD downdrag load factors are 1.25 (max) and 0.35 (min) | Pass |
| LRFD check counts only the side resistance BELOW the neutral plane | Pass |
| vesic_bowles refuses to infer the idealisation from a layer stack | Pass |
| vesic_bowles validates its own envelope | Pass |
| Eq (9.124) always places the neutral plane between 50 % and 70.7 % of the penetrated clay | Pass |
| method labels cover every method, so no selector can render blank | Pass |
pile-group-is2911-web-validation.test.ts
Pile group capacity — validated against **IS 2911 (Part 1/Sec 1):2010** (driven cast in-situ concrete piles) and the published efficiency formulae it refers to without mandating.
Analyses validated: pile-group · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Pile group capacity — validated against **IS 2911 (Part 1/Sec 1):2010** (driven cast in-situ
concrete piles) and the published efficiency formulae it refers to without mandating.
Sources, both read directly from the library:
`Geo Technical engineering books/is.2911.1.1.2010.pdf` — Part 1/Sec 1
`Geo Technical engineering books/is.2911.1.4.2010.pdf` — Part 1/Sec 4 (bored piles)
Converse-Labarre — the form in universal Indian practice (Bowles 5e §16, Tomlinson §10.3)
Tomlinson (2004) *Pile Design and Construction Practice* 4e §10.4 — block equation
Poulos & Davis (1980) *Pile Foundation Analysis and Design* §4.6
─────────────────────────────────────────────────────────────────────────────
WHAT IS 2911 PRESCRIBES, AND WHAT IT POINTEDLY DOES NOT
─────────────────────────────────────────────────────────────────────────────
**Cl 6.7.1 declines to mandate an efficiency equation**, verbatim: *"a number of efficiency
equations are in use. However, it is difficult to establish the accuracy of these efficiency
equations as the behaviour of pile group is dependent on many complex factors. It is desirable
to consider each case separately on its own merits."*
That matters for how this engine is described. Converse-Labarre is OUR default, chosen because
it is the form in universal Indian practice — **it is not an IS requirement**, and the module
header previously read as though Cl 6.7 supplied it. So this suite anchors the efficiency
formulae to their own published definitions, and anchors to IS 2911 only the things IS 2911
actually states:
• **Cl 6.7.2** — group capacity ≤ N × single-pile capacity; equality for friction piles driven
into progressively stiffer material and for end-bearing piles; for driven piles in loose sand
it *"may even be higher due to the effect of compaction"*.
• **Cl 6.7.3** — the BLOCK check: *"the group may be visualized as a block with the piles
embedded within the soil… by taking into account the frictional capacity along the perimeter
of the block and end-bearing at the bottom of the block"*. Method prescribed, **no equation
given** — so the equation form is Tomlinson's, and this suite says so rather than implying
IS 2911 supplied it.
• **Cl 6.7.3.1** — a cap on firm stratum may contribute, but the total must not exceed the
Cl 6.7.3 block capacity.
• **Cl 6.8.2** — *"The minimum factor of safety on static formula shall be 2.5."*
**A citation error this suite exists partly to lock down.** The module cited *"IS 2911 Annex F —
block failure check"* in **eight** places. Verified against both PDFs: Part 1/Sec 1 has Annexes
A–E only and **no Annex F**; Part 1/Sec 4 *does* have an Annex F and it is **"COMMITTEE
COMPOSITION"**. The block check is **Cl 6.7.3** in both. The method and the numbers were right;
only the pointer was wrong — the third error of this exact class in this audit, after
`settlement` (2:1 spread cited to IS 8009 Cl 9.2.2, a clause about sandwiched clay) and
`seismic-site-class` (zone factors cited to Table 2, the soil-classification table).
| Test block (the published value it checks) | Verdict |
| Converse-Labarre efficiency — 10 published configurations | Pass |
| IS 2911 Cl 6.7.2 — group capacity never exceeds N × single-pile capacity | Pass |
| IS 2911 Cl 6.7.3 — the block check, with Tomlinson §10.4 as the equation form | Pass |
| the block check is applied to cohesive soil and skipped for cohesionless (Cl 6.7.2) | Pass |
| Feld and Seiler-Keeney are offered as alternatives, and all three are bounded in (0, 1] | Pass |
| the references cite Cl 6.7.3, not the non-existent Annex F | Pass |
⚑ pile-group-settlement-web-validation.test.ts
Pile-group settlement engine (`pile-group-settlement.ts`, Randolph–Wroth interaction factors) compared with what could actually be opened.
Analyses validated: pile-group-settlement · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Pile-group settlement engine (`pile-group-settlement.ts`, Randolph–Wroth interaction factors) compared with
what could actually be opened. THIS IS A CROSS-CHECK AGAINST CHART VALUES, NOT A FULL VALIDATION, and the
header says so first because the honest count is small.
SOURCE READ
Kouretzis, G., "Fundamentals of Foundation Engineering and their Applications" (2nd ed., University of
Newcastle open textbook), §6.19–6.20 and Example 6.10, https://eng.libretexts.org/Bookshelves/Civil_Engineering/Fundamentals_of_Foundation_Engineering_and_their_Applications_2e/06:_PILE_FOUNDATIONS/6.40:_Example_6.10
(read 2026-10-06; no publication year is printed on the page, so none is claimed). Example 6.10: six
300 mm piles, L/D = 25 (so L = 7.5 m), E_p/E_s = 2000 "in a deep clay layer", s/D = 5. The interaction
factors were read by the author off the Poulos–Mattes chart and printed to 2 d.p.: α = 0.42 at s/D = 5,
0.35 at s/D = 7.07, 0.27 at s/D = 10, 0.25 at s/D = 11.2 — and, for the same group, Fleming's
R_s = n^Φ with Φ = 0.5 gives R_s = 2.44 (settlement 36.6 mm at 500 kN/pile, single-pile 15 mm at 500 kN).
WHAT IS ASSERTED
The four chart α values, through 1×2 groups (then Σα at the loaded pile = 1 + α, so α = Σα − 1).
ASSUMPTION THAT COULD NOT BE VERIFIED: ν = 0.5 (undrained clay). The page gives no ν and the figure
(its Fig 6.77) could not be opened; the Randolph–Wroth radius r_m = 2.5·ρ·L·(1 − ν) depends on it directly.
TOLERANCE — declared, not derived from the source: ±0.025 absolute. The source prints 2 d.p. from a chart
read by eye (≈ ±0.01), and the engine's logarithmic closed form is an approximation to Poulos's numerically
computed elastic-continuum α, not a reproduction of it. The engine's deviations when the suite was written
were +0.023 (s/D 5), +0.009 (7.07), +0.006 (10), −0.001 (11.2): the band therefore has almost no headroom
at the closest spacing, and that is the reason it is stated plainly here instead of being widened.
WHAT IS *NOT* ASSERTED, AND WHY (recorded as an unresolved definition mismatch, not a pass):
· R_s = 2.44 (Fleming, 2×3 group) and Varghese Ex 13.1 (Sg/Si = [(4B + 2.7)/(B + 3.6)]² = 3.66 for a 3×3 group,
B = 2.1 m, Varghese (2005) Foundation Engineering §13.5.2) are AVERAGE group settlements for a group that
settles as a unit, whereas this engine reports the CENTRE pile under EQUAL loads (flexible cap). For the
Varghese group the engine gives 5.70 against the published 3.66, and for Example 6.10's 2×3 group 3.05 against
the chart-based textbook flow (whose equations are page images and were not readable). Those are different
quantities, not one quantity disagreeing — but a user who compares the engine's "settlement ratio" with a
published R_s will see the engine ~50 % higher, which the UI label does not warn about.
· the Randolph & Wroth (1979) paper, Poulos & Davis (1980) and Fleming's Piling Engineering could not be opened
(paywalled / scanned / HTML login walls), so no published R_s table was available.
PUBLISHED-VALUE COUNT: 4 chart values (one source). Shortfall against the repo's 20: 16, and the second source
is missing too. Status: PARTIAL / NOT RELEASE-READY.
| Test block (the published value it checks) | Verdict |
| [1] Kouretzis Ex 6.10 (Poulos–Mattes chart): α = 0.42 at s/D = 5 | Pass |
| [2] Kouretzis Ex 6.10: α = 0.35 at s/D = 7.07 | Pass |
| [3] Kouretzis Ex 6.10: α = 0.27 at s/D = 10 | Pass |
| [4] Kouretzis Ex 6.10: α = 0.25 at s/D = 11.2 | Pass |
pile-group-worked-examples-web-validation.test.ts
pile-group — PUBLISHED WORKED EXAMPLES (deep review 14, 2026-10-03).
Analyses validated: pile-group · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
pile-group — PUBLISHED WORKED EXAMPLES (deep review 14, 2026-10-03). Every expected value below is printed in
the cited source; the inputs are the source's own. 21 cited values.
[BW1] Bowles, Foundation Analysis and Design 5e (1997) §18-3, Example 18-1: 5 × 3 friction piles, D = 400 mm,
s = 1000 mm, Converse-Labarre (Eq. 18-1): θ = 21.8°, "E_g = … = 0.64 or 64 percent".
[BW2] Bowles Example 18-2: the same group in clay, s_u = 30 kPa, L = 20 m; single pile P_u = 486 kN/pile;
"For 15 piles Q_ult = 15 × 486 = 7290 kN … Use Q_ult = 7290 kN" (block 9423 kN does not govern).
Bowles' BLOCK uses α = 0.6 on the block shear and a 250 mm cap projection; the engine's block follows
Tomlinson/Das (full c_u, outer pile faces) and is larger (11 011 kN), so only the GOVERNING value is
asserted — both conventions agree that the individual-pile sum governs.
[DS] Das, Principles of Foundation Engineering (Cengage, 2016) §9.24, Example 9.21: 3 × 4 group of 14 in
square piles at d = 35 in in two-layer saturated clay (c_u 1050 psf over 15 ft, 1775 psf over 45 ft),
ΣQ_u = 3141.9 kip (Eq. 9.130); block (Eq. 9.131) with L_g = 9.92 ft, B_g = 7 ft, N*_c = 8.75 →
4313 kip; "Hence, ΣQ_u = 3141.9 kip". Das sums the individual piles (η = 1) — the engine's `unity`
route. The block's layered shaft term Σ2(L_g+B_g)c_uΔL equals 2(L_g+B_g)·L·c̄_u with the
thickness-weighted c̄_u, which is what the engine's single shaft strength takes.
[VG] Varghese, Foundation Engineering (PHI, 2005) Example 13.1: nine driven piles 300 mm at 3d, Q_ult of one
pile 396 kN, "Assume efficiency = 1 … Q_u = 396 × 9 = 3564 kN; Q_safe = 3564/2.5 = 1426 kN".
[FD] Feld (1943) rule as worked in Pratama, Widjaja & Budianto (2023), "Numerical study on pile group
efficiency for piles embedded in cohesive and cohesionless soils", E3S Web of Conferences (ICCIM 2023)
04003: "the E_g value for a 3 × 3 group pile is (4 × 13/16 + 4 × 11/16 + 8/16)/9 = 0.722, while for a
2 × 2 group pile is (4 × 13/16)/4 = 0.813".
[SV] Structville (Kolade 2022), "Axial load distribution of piles under eccentric vertical load", solved
example (https://structville.com/axial-load-of-piles-under-vertical-eccentric-load): 3 × 3 at 1.2 m,
P = 4888.244 kN; (a) concentric: 543.14 kN per pile; (b) M_xx = 2700, M_yy = 1350 kN·m:
−19.36, 355.64, 730.64, 168.14, 543.14, 918.14, 355.64, 730.64, 1105.64 kN.
[VH] "Pile Foundation Design: A Student Guide" (vulcanhammer.net), Example 3.1: 12 vertical piles at 0.9 m,
Q = 2600 kN at 0.2 m and 0.15 m eccentricity (M = 520 and 390 kN·m): maximum 329 kN, minimum 105 kN.
[IS] IS 2911 (Part 1/Sec 1):2010 Cl 6.8.2: "The minimum factor of safety on static formula shall be 2.5."
Tolerances: printed precision — Bowles' 0.64 to ±0.005; kN values printed to 0.01 to ±0.02 kN; the
vulcanhammer integers to ±0.5 kN; Das' kip values to 0.05 %.
| Test block (the published value it checks) | Verdict |
| [BW1] Bowles Ex 18-1: Converse-Labarre 5 × 3, D 400 mm, s 1000 mm → E_g = 0.64 | Pass |
| [BW2] Bowles Ex 18-2: 15 × 486 kN = 7290 kN governs (η = 1, block does not govern) | Pass |
| [DS] Das Ex 9.21: block 4313 kip, ΣQu 3141.9 kip governs | Pass |
| [VG] Varghese Ex 13.1: 9 × 396 = 3564 kN, Q_safe = 3564/2.5 = 1426 kN; [IS] default FoS 2.5 | Pass |
| [FD] Feld 1/16 rule: 3 × 3 → 0.722, 2 × 2 → 0.813 | Pass |
| [SV] Structville 3 × 3 rigid cap: concentric 543.14 kN; eccentric −19.36 … 1105.64 kN | Pass |
| [VH] vulcanhammer Ex 3.1: 12 piles at 0.9 m, Q 2600 kN, M 520 / 390 kN·m → max 329, min 105 kN | Pass |
| a working reaction is checked against Qu/FoS, not against the ultimate Qu | Pass |
| FoS below 1 is refused; below 2.5 is warned with the clause | Pass |
| spacing warnings cite IS 2911-1 Cl 6.6 (2.5D end-bearing, 3D friction), not Cl 6.7 | Pass |
| non-finite and impossible inputs are refused, never returned as η = NaN or an infinite group | Pass |
pile-head-stiffness-web-validation.test.ts
Pile-head stiffness engine (`pile-head-stiffness.ts`) checked against PUBLISHED Matlock–Reese numbers.
Analyses validated: pile-head-stiffness · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Pile-head stiffness engine (`pile-head-stiffness.ts`) checked against PUBLISHED Matlock–Reese numbers.
Every expected value was read on 2026-10-06 from a page that was opened; none comes from this engine.
WHY THIS IS A FAIR TEST OF A NONLINEAR p-y ENGINE: the engine freezes secant springs k(z) = p/y and builds
the 2×2 head matrix from that LINEAR system. With the `linear_subgrade` p-y model (p = n_h·z·y, uncapped)
the springs ARE the Matlock–Reese soil, so the matrix must reproduce the published long-pile coefficients.
SOURCES
Das, B.M. (2016), Principles of Foundation Engineering, Cengage Learning (library copy; page footers read
"Copyright 2016"): Table 9.15 "Coefficients for Long Piles, k_z = n_h·z" (book p.459), row Z = 0:
A_x = 2.435, A_θ = −1.623, B_x = 1.623, B_θ = −1.750 — the Matlock & Reese (1960) coefficients; and
Example 9.14 (book pp.467–468): HP 250×85, E_p = 207×10⁶ kN/m², I_p = 123×10⁻⁶ m⁴, n_h = 12 000 kN/m³,
L = 25 m, allowable top deflection 8 mm, M_g = 0 → "Q_g = 53.59 kN" with T = 1.16 m printed.
Mufty, A. (2026), "Reese and Matlock Pile Response to Lateral Loading in Elastic Soil Using RSPile",
Rocscience article published 2026-04-23, https://www.rocscience.com/learning/reese-and-matlock-pile-response-to-lateral-loading-in-elastic-soil-using-rspile
(read 2026-10-06): Example 1 — D = 0.6 m, L = 7.5 m, E = 31 529 MPa, n_h ≈ 30 MN/m³ (read off Reese 1975),
H = 200 kN, Z_max = 5.13; the head-fixed moment "−271.1 kN·m" that returns the free-head pile to the
fixed-head answer (its closing exercise). Its deflection/moment profiles are figures and were not readable.
TOLERANCES, and what they are. The engine solves the beam by finite differences, so even an exact linear
soil is reproduced only to the discretisation error of the scheme; measured on these cases it is
0.06 % (A_x) to 0.34 % (the derived matrix terms). Band declared: ±1 %. Separately, Das Example 9.14
prints T = 1.16 m (true T = 1.1626 m); T³ carries the rounding three times, so Q_g = 53.59 kN is good only
to ±1.3 % (T printed to 3 s.f.: half-ulp 0.005/1.16 = 0.43 %, cubed) — that example uses ±1.5 %.
TWO LABELS, kept honest:
PUBLISHED — the engine's output is compared with a number printed in the source.
DERIVED — the engine's K22/K33/K23 compared with the exact 2×2 inversion of the PUBLISHED flexibility
coefficients (K = F⁻¹ with F = [[A_x T³, B_x T²],[B_x T², |B_θ| T]]/EI). The inputs are
published; the inversion is arithmetic done in this file, so these do NOT count as published
values.
PUBLISHED-VALUE COUNT: 4 (A_x = 2.435; B_x = 1.623; Das Ex 9.14 Q_g = 53.59 kN; Rocscience M = 271.1 kN·m),
plus 3 DERIVED. That is far below the repo's 20: the sources that would supply more (Matlock & Reese 1960,
Reese & Van Impe 2010, NAVFAC DM 7.02 Figs 11–13) are either scans or printed as charts with no numbers,
and no published pile-head stiffness matrix with inputs could be opened. The shortfall is reported, not padded.
| Test block (the published value it checks) | Verdict |
| [1] PUBLISHED Das Table 9.15 (Z = 0): free-head deflection under a lateral load is A_x·Q·T³/EI with A_x = 2.435 | Pass |
| [2] PUBLISHED Das Table 9.15 (Z = 0): free-head deflection under a head moment is B_x·M·T²/EI with B_x = 1.623 | Pass |
| [3] PUBLISHED Das Example 9.14: HP 250×85 in n_h = 12 000 kN/m³ deflects 8 mm under Q_g = 53.59 kN (free head, M = 0) | Pass |
| [4] PUBLISHED Rocscience Example 1: the moment that holds the head against rotation is 271.1 kN·m (H = 200 kN) | Pass |
| [5] DERIVED K22 = (EI/T³)·|B_θ|/(A_x|B_θ| − B_x²) from the published coefficients | Pass |
| [6] DERIVED K33 = (EI/T)·A_x/(A_x|B_θ| − B_x²) from the published coefficients | Pass |
| [7] DERIVED |K23| = (EI/T²)·B_x/(A_x|B_θ| − B_x²) from the published coefficients | Pass |
pile-load-test-is2911p4-web-validation.test.ts
Pile load test interpretation — validated against **IS 2911 (Part 4):2013**, *Code of Practice for Design and Construction of Pile Foundations, Part 4: Load Test on Piles* (2nd revision).
Analyses validated: pile-load-test · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Pile load test interpretation — validated against **IS 2911 (Part 4):2013**, *Code of Practice
for Design and Construction of Pile Foundations, Part 4: Load Test on Piles* (2nd revision).
Source: `Geo Technical engineering books/IS2911-Part4-2013.pdf`, read directly.
─────────────────────────────────────────────────────────────────────────────
THE ACCEPTANCE CRITERIA, VERBATIM FROM Cl 7.1.5
─────────────────────────────────────────────────────────────────────────────
The safe load "should be least of the following":
**a) For piles up to and including 600 mm diameter:**
1) *"Two-thirds of the final load at which the total displacement attains a value of 12 mm
unless otherwise required in a given case on the basis of nature and type of structure in
which case, the safe load should be corresponding to the stated total displacement
permissible"*; and
2) *"Fifty percent of the final load at which the total displacement equal to 10 percent of
the pile diameter in case of uniform diameter piles and 7.5 percent of bulb diameter in
case of under-reamed piles."*
**b) For piles more than 600 mm diameter:**
1) *"Two-thirds of the final load at which the total displacement attains a value of 18 mm
or maximum of 2 percent pile diameter whichever is less…"*; and
2) the same 50 % / 10 %-of-diameter criterion.
Also Cl 7.1.5.1: a routine test shall reach *"at least 1.5 times the working load"*, with
settlement at test load *"not greater than 12 mm for piles diameter up to and including 600 mm
and 18 mm or 2 percent of pile diameter whichever is less for piles of diameter more than
600 mm."*
**E-33 (P2), found by reading the clause.** The engine hardcoded 12 mm for every diameter,
ignoring branch (b). That is the CONSERVATIVE direction — a lower displacement threshold picks a
lower point off the load-settlement curve — but it is not the code, and it materially under-rates
large bored piles, which are the common case at 900–1500 mm:
D = 700 mm → min(18, 14.0) = 14.0 mm (12 mm was 17 % too low)
D = 900 mm → min(18, 18.0) = 18.0 mm (12 mm was 50 % too low)
D = 1200 mm → min(18, 24.0) = 18.0 mm (12 mm was 50 % too low)
| Test block (the published value it checks) | Verdict |
| IS 2911-4 Cl 7.1.5(a) — piles ≤ 600 mm use the 12 mm displacement criterion | Pass |
| IS 2911-4 Cl 7.1.5(b) — piles > 600 mm use min(18 mm, 2 % of D) [E-33] | Pass |
| IS 2911-4 Cl 7.1.5 criterion (2) — 50 % of the load at 10 % of the pile diameter | Pass |
| the "unless otherwise required in a given case" override is honoured and disclosed | Pass |
| a test that never reaches the criteria must refuse to set a safe load | Pass |
| monotonicity and bounds across the criteria | Pass |
pile-load-transfer-web-validation.test.ts
Validation for API axial load-transfer curves (`pile-load-transfer.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for API axial load-transfer curves (`pile-load-transfer.ts`).
the release rules gate. Anchors: API RP2GEO §8.4 t-z (clay) and q-z table values.
| Test block (the published value it checks) | Verdict |
| API clay t-z table points (RP2GEO) | Pass |
| API clay t-z interpolates monotonically to the peak | Pass |
| API q-z tip table points (RP2GEO), peak at z/D=0.10 | Pass |
| API sand t-z: linear to peak at 0.1 in then plateau | Pass |
pile-raft-web-validation.test.ts
Web-benchmark validation for `pile-raft` — the Poulos "PDR" piled-raft stiffness method.
Analyses validated: pile-raft · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `pile-raft` — the Poulos "PDR" piled-raft stiffness method.
SOURCES:
Poulos, H.G. (2001) "Piled raft foundations: design and applications", Géotechnique /
ISSMGE TC18 — the combined stiffness and load-sharing relations:
K_pr = [K_p + K_r(1 − 2α_rp)] / [1 − α_rp²·K_r/K_p]
X = (K_p − α_rp·K_r) / [K_p + K_r(1 − 2α_rp)] (pile load fraction)
with α_rp ≈ 0.8 for a typical pile spacing s/d ≈ 5.
Fleming, Weltman, Randolph & Elson (2009) Piling Engineering 3e §5.3 — Eq 5.33 raft stiffness
k_r = 2G√(BL)/[I(1 − ν)] = E_s√(BL)/[I(1 − ν²)] (W2-P1-2 replaced the "Mayne & Poulos I_ρ = 0.95·√(B/L)" form,
which divided by B twice), Eq 5.29 α_rp, and the domain k_p ≥ α_rp·k_r of Eqs 5.27–5.28.
Fleming et al. (1985) — group settlement ratio R_s ≈ √n_p.
ACI 336.2R-88 / Brown (1969) / IS 2950-1:1981 — relative stiffness
K_r = E_c·I_b/(E_s·B³), I_b = t³/12; rigid if K_r ≥ 0.5, flexible if < 0.05.
Each expected value reconstructs its chain in code (batch 7t method note).
| Test block (the published value it checks) | Verdict |
| the component stiffnesses follow their published definitions | Pass |
| a negative Poulos denominator is refused rather than answered (neither the spurious K_pr nor a parallel spring) | Pass |
| a well-conditioned case exercises the primary K_pr branch | Pass |
| load is conserved and the pile fraction stays in [0, 1] across a wide sweep | Pass |
| more piles carry more load and settle less | Pass |
| the raft stiffness is Fleming Eq 5.33, k_r = E_s·√(BL)/[I(1 − ν²)] | Pass |
| relative stiffness K_r = E_c·I_b/(E_s·B³) classifies rigid / intermediate / flexible | Pass |
| thickness and E_c without a soil modulus: refused, naming E_s (no hidden k_s default) | Pass |
| pile utilisation is against the WORKING load and warns past the PDR limit | Pass |
| invalid inputs are refused with no numbers | Pass |
⚑ pile-section-mphi-web-validation.test.ts
Reinforced-concrete moment–curvature engine (`pile-section-mphi.ts`) checked against PUBLISHED numbers.
Analyses validated: pile-section-mphi · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Reinforced-concrete moment–curvature engine (`pile-section-mphi.ts`) checked against PUBLISHED numbers.
Every expected value below is a number printed in a source that was opened and read; the locator sits
beside it. Values are NOT taken from this engine, from memory, or hand-computed unless the comment says
"HAND CHECK" (those are labelled and are not counted as published values).
SOURCES
Brown, D.A., Turner, J.P. & Castelli, R.J. (2010), Drilled Shafts: Construction Procedures and LRFD
Design Methods, FHWA-NHI-10-016 (`Geo Technical engineering books/FHWA-NHI-10-016-2010-Drilled-Shafts…pdf`):
§12.3.3.3.4 Example + Fig 12-24 ("Mult = 1791" kip-ft); Appendix A design example (I = 4,169,220 in⁴);
Table 8-2 (bar diameters/areas). The manual's own nonlinear-bending model (Eqs 12-8…12-12) is the
COM624/LPILE Hognestad model this engine implements.
Pincheira, J. (2021), Reinforced Concrete Design 9th ed., Oxford University Press, Example 10.18.1 —
20-in spiral circular column, 8 #10, f'c 5000 psi, fy 60 ksi — read from the StructurePoint
publication "Interaction Diagram - Circular Spiral Reinforced Concrete Column (ACI 318-19)",
Version May-24-2022, https://structurepoint.org/publication/pdf/Interaction-Diagram-Circular-Spiral-Reinforced-Concrete-Column-ACI-318-19.pdf
(read 2026-10-06). Nominal (Pn, Mn) at five control points; hand values equal spColumn to 2 d.p.
Wang, C. (2018), Reinforced Concrete Design 8th ed., Oxford University Press, Example 3.11.1 — 14×29 in
doubly reinforced beam — read from the StructurePoint publication "Doubly Reinforced Concrete Beam
Design (ACI 318-14)", Version March-05-2020,
https://www.structurepoint.org/publication/pdf/Doubly-Reinforced-Concrete-Beam-Design-ACI318-14.pdf
(read 2026-10-06): Mn = 855 kip-ft (singly, As 7.74 in²) and 1048 kip-ft (As 9.42, A's 1.81 in²).
HOW PUBLISHED US-UNIT CASES ARE FED TO AN ENGINE THAT TAKES fck (cube) AND Mn (nominal):
· the engine uses cylinder f'c = 0.8·fck, so fck = f'c/0.8 reproduces the source's f'c exactly;
· cover_mm is to the OUTSIDE of the bars and the centroid sits at cover + d_b/2 (IS 456 cl.26.4.1), so
each case passes the source's bar diameter and a cover that puts the centroid where the source does
(circular: SP's d1 = 2.64 in = 2.0 clear-to-bar + 0.635; beam: 3.0 in to the centre = 2.5 + 0.5).
WHAT THE TOLERANCES ARE — AND ARE NOT. They are NOT source rounding (the sources print 4–5 s.f.). The
engine integrates a Hognestad parabola to ε_cu = 0.0035 (IS 456); the published ACI numbers use the
rectangular block with ε_cu = 0.003, and the FHWA number is the COM624 model with ε_cu = 0.003. That
model-form difference is the whole deviation, and it was measured, not assumed: re-running the same
engine with ε_cu = 0.003 reproduced the flexure-governed points to −0.3 … −1.7 % (see the DEVIATIONS
table). Two bands, chosen by which mechanism governs, and declared here so a reviewer can disagree:
FLEXURE ±4 % — tension-controlled states (P ≲ 0.2·P0): Mn is As·fy·(d − a/2)-dominated and the
ε_cu/stress-block difference moves it by a few % only;
COMPRESSION ±10 % — compression-governed states, where the ACI rectangular block (β1 = 0.80, full
0.85 f'c to depth a) and the parabola-plus-tail integrate to different concrete
forces when the neutral axis is deep.
Observed deviations when this suite was written (engine − published)/published:
FHWA Mult −0.3 % · Pincheira Pn=0 +2.4 % · Pn=29.5 kip +3.4 % · Pn=518.9 +3.2 % · Pn=856.3 +1.7 % ·
Pn=1312.6 −6.5 % · Wang singly −1.2 % · Wang doubly −0.7 %.
AN ENGINE DEFECT THIS SUITE FOUND (fixed 2026-10-06 in pile-section-mphi.ts): the Hognestad parabola
peaked at f'c instead of f''c = 0.85·f'c (Hognestad 1951; FHWA Eq 12-8; ACI 318-19 §22.2.2.4.1). Against
the same Pincheira points the old engine read +4.4 / +5.8 / +11.6 / +15.8 / +21.9 % (unconservative,
worst at high axial load). The three largest are the compression-governed points below.
PUBLISHED-VALUE COUNT: 11 (FHWA 3: Mult and two gross I; Pincheira 6: d1 and five Mn; Wang 2). That is below the
20 the repo asks for; the shortfall is reported, not padded. Boilerplate guard assertions were deliberately
left out so the manifest's assertion count stays close to the real number of published values.
| Test block (the published value it checks) | Verdict |
| [1] the engine puts the bar centroid where Pincheira Ex 10.18.1 does: d1 = 2.64 in | Pass |
| [2] Pincheira Ex 10.18.1 Point 6 pure bending: Mn at Pn = 0.0 kip is 320.11 kip-ft | Pass |
| [2] Pincheira Ex 10.18.1 Point 5 εs = εy + 0.003 (tension-controlled limit): Mn at Pn = 29.5 kip is 328.13 kip-ft | Pass |
| [2] Pincheira Ex 10.18.1 Point 4 fs = fy (balanced, c = 10.28 in): Mn at Pn = 518.93 kip is 407.73 kip-ft | Pass |
| [2] Pincheira Ex 10.18.1 Point 3 fs = 0.5 fy: Mn at Pn = 856.27 kip is 375.24 kip-ft | Pass |
| [2] Pincheira Ex 10.18.1 Point 2 fs = 0: Mn at Pn = 1312.64 kip is 277.54 kip-ft | Pass |
| [4] FHWA-NHI-10-016 Fig 12-24: the 48-in shaft with 12 #11 bars reaches Mult = 1791 kip-ft | Pass |
| [5] FHWA-NHI-10-016 §12.3.3.3.4: I = π·d⁴/64 = 260,576 in⁴ for the 48-in shaft (gross section) | Pass |
| [6] FHWA-NHI-10-016 Appendix A: I = 4,169,220 in⁴ for the 96-in shaft | Pass |
| [7] Wang Ex 3.11.1 singly reinforced, As = 7.74 in² (max tension-controlled): Mn = 855 kip-ft | Pass |
| [8] Wang Ex 3.11.1 doubly reinforced, As = 9.42 in², A's = 1.81 in²: Mn = 1048 kip-ft | Pass |
pile-section-pm-interaction-ec2-web-validation.test.ts
EN 1992-1-1 code path of the P–M interaction engine (`pile-section-pm-interaction.ts`, `code: 'EN 1992-1-1'`) checked against PUBLISHED values.
Analyses validated: pile-section-pm-interaction · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
EN 1992-1-1 code path of the P–M interaction engine (`pile-section-pm-interaction.ts`,
`code: 'EN 1992-1-1'`) checked against PUBLISHED values. Every expected number is printed in a source
that was opened and read; the locator is beside it.
SOURCE
The Concrete Centre (2009), Worked Examples to Eurocode 2, Volume 1 (CCIP-041). Free from
concretecentre.com.
• §5 Column design examples, printed pages 135–172:
§5.1 Edge column (p.135) — 300×300, C30/37, B500, d2 = 49 mm, 4H25 (As = 1964 mm²).
§5.3 Internal column (p.146) — 500×500, C50/50, B500, d2/h = 0.20, 12H32 (As = 9648 mm²).
§5.4 Small perimeter column, 2 h fire (p.157) — 350×350, C30/37, B500, d2/h = 0.25,
4H32+4T25 (As = 5180 mm²) and 8T32 (As = 6432 mm²).
• Appendix C design aids, printed page 208: Figures C4c (rectangular, d2/h = 0.15) and C4d
(d2/h = 0.20) — the EC2 column interaction charts. They plot the design curves in the
nondimensional form
y = NEd/(b·h·fck) vs x = MEd/(b·h²·fck), parameter ρ_s = As·fyk/(b·h·fck),
with fcd = αcc·fck/γc, fyd = fyk/γs, γc = 1.5, γs = 1.15, αcc = 0.85 (UK National Annex).
HOW THE CHARTS WERE READ. The Appendix C pages are vector PDF; a 300 dpi render was digitised: the
plot box was cropped, gridlines removed, the solid ρ_s contours isolated by connected-component size,
and each contour's x sampled at even y levels. The digitisation was verified by the chart borders
(x = 0.0003…0.3996, y = 0.0021…1.2986). Reading uncertainty ≈ ±1–2 %.
TOLERANCE: ±10 % for the chart points, ±5 % for the worked examples. The engine runs a small POSITIVE
bias against the chart that grows with the steel ratio — 0.5…5 % for ρ_s ≤ 0.6 (≤ 3.6 % steel) and up
to 9 % on the heaviest ρ_s ≥ 0.8 contours (4.8–6 % steel, which exceed EC2's 4 % maximum). The bias is
reported in VERIFY-FINDINGS.md rather than hidden by the band: it is consistent with the engine not
deducting the concrete displaced by the compression reinforcement and with using the §3.1.7
parabola-rectangle rather than the simplified block.
FEEDING THE ENGINE: EC2 works in cylinder strength, so fck is passed directly (the engine does NOT apply
the cube→cylinder 0.8 conversion on this code path), and αcc = 0.85 selects fcd = 0.85·fck/1.5. As is the
chart's TOTAL reinforcement, split over the two opposite faces. The bar diameter is stated explicitly so
that the engine's bar centroid sits at d2 = cover + db/2.
| Test block (the published value it checks) | Verdict |
| Concrete Centre App. C Fig C4c (p.208), d2/h=0.15, ρ_s=0.2 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4c (p.208), d2/h=0.15, ρ_s=0.4 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4c (p.208), d2/h=0.15, ρ_s=0.6 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4c (p.208), d2/h=0.15, ρ_s=0.8 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4c (p.208), d2/h=0.15, ρ_s=1 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4d (p.208), d2/h=0.2, ρ_s=0.2 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4d (p.208), d2/h=0.2, ρ_s=0.4 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4d (p.208), d2/h=0.2, ρ_s=0.6 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4d (p.208), d2/h=0.2, ρ_s=0.8 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C Fig C4d (p.208), d2/h=0.2, ρ_s=1 — M/(bh²fck) at four N/(bhfck) levels | Pass |
| Concrete Centre App. C charts supply 2×19 = 38 published values (≥ 20) | Pass |
| Concrete Centre §5.1 (p.135): 300×300 C30/37, 4H25, d2=49 — MRd at NEd=1620 kN is 76.1 kN·m | Pass |
| Concrete Centre §5.3 (p.146): 500×500 C50/50, 12H32, d2/h=0.20 — MRd at NEd=9000 kN is 356.3 kN·m | Pass |
| Concrete Centre §5.4 (p.157): 350×350 C30/37, 4H32+4T25, d2/h=0.25 — MRd at NEd=1824.1 kN is 205.8 kN·m | Pass |
| Concrete Centre §5.4 (p.157): 350×350 C30/37, 8T32, d2/h=0.25 — MRd at NEd=1824.1 kN is 240.5 kN·m | Pass |
⚑ pile-section-pm-interaction-is456-web-validation.test.ts
IS 456 code path of the P–M interaction engine (`pile-section-pm-interaction.ts`, `code: 'IS 456'`) checked against PUBLISHED values.
Analyses validated: pile-section-pm-interaction · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
IS 456 code path of the P–M interaction engine (`pile-section-pm-interaction.ts`, `code: 'IS 456'`)
checked against PUBLISHED values. Every expected number below was printed in a source that was opened
and read; the locator is beside it.
SOURCE
SP 16 (1980), Design Aids for Reinforced Concrete to IS: 456-1978, Bureau of Indian Standards
(Indian government publication; scan read from archive.org item gov.in.is.sp.16.1980).
• Chart 33, printed page 118 — "Compression with Bending, Rectangular Section, Reinforcement
Distributed Equally on Two Sides", fy = 415 N/mm², d'/D = 0.15. The chart plots the design
interaction curves in the code's nondimensional form
Y = Pu/(fck·b·D) vs X = Mu/(fck·b·D²), parameter p/fck, As = p·b·D/100.
• Worked Example 6, page 103 (square column, uniaxial) and Worked Example 7, pages 103–104
(circular column, uniaxial), which read p/fck off Charts 33 and 52.
HOW THE CHART WAS READ. The chart is a scanned raster; its ten solid p/fck contours were digitised
from a 400 dpi render of printed page 118 (the plot frame spans pixels x 754…2827, y 915…3855, i.e.
X = 0…0.5, Y = 0…1.4). Curves were isolated (dark < 118, frame and axis ticks removed, 3 px dilation
to bridge the gaps left where the dashed bar-stress lines cross), and each curve's X was sampled at
six even Y levels. The reading uncertainty is about ±1–2 % of X. Which contour is which p/fck was
established two ways: from the chart's own printed labels (0.10, 0.12, … 0.25 on this chart) and from
the anchor printed in Worked Example 6 — the load point (X = 0.088, Y = 0.494) is assigned p/fck = 0.09,
i.e. it falls between the 0.08 and 0.10 contours, which the engine reproduces to 2 %.
TOLERANCE: ±5 %. This is a chart-reading tolerance, not a widened one: the digitisation itself is good
to ~1–2 %, and the largest engine-vs-chart deviation observed over these 54 points is 3.0 % (engine
slightly LOW at the higher axial loads, converging to zero at low axial load). A value outside ±5 %
would be reported as a finding in VERIFY-FINDINGS.md rather than absorbed by a wider band.
FEEDING THE ENGINE: fck and fy are used directly (IS 456 works in characteristic cube strength and the
0.446·fck / 0.87·fy design block already carries γm = 1.5 / 1.15). d'/D = 0.15 with 25 mm bars gives
cover = 0.15·D − db/2. As is the chart's TOTAL reinforcement, split equally over the two faces.
| Test block (the published value it checks) | Verdict |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.06 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.10 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.12 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.14 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.16 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.18 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.20 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.22 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 Chart 33 (p.118), p/fck = 0.25 — Mu/(fck·b·D²) at six Pu/(fck·b·D) levels | Pass |
| SP 16:1980 chart-valve count — the Chart 33 contours supply 9×6 = 54 published values (≥ 20) | Pass |
| SP 16:1980 Worked Example 6 (p.103): 450×450 M25 Fe415, Pu=2500 kN, Mu=200 kNm → p/fck=0.09 (As=4556 mm²), two sides | Pass |
| SP 16:1980 Worked Example 7 (pp.103–104): Ø500 M20 Fe250, 8 bars, Pu=1600 kN, Mu=125 kNm → p/fck=0.087 (As=3416 mm²) | Pass |
⚑ pile-section-pm-interaction-web-validation.test.ts
P–M interaction engine (`pile-section-pm-interaction.ts`) checked against PUBLISHED numbers.
Analyses validated: pile-section-pm-interaction · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
P–M interaction engine (`pile-section-pm-interaction.ts`) checked against PUBLISHED numbers. Every
expected value is a number printed in a source that was opened and read; the locator is beside it.
SOURCES
Pincheira, J. (2021), Reinforced Concrete Design 9th ed., Oxford University Press, Example 10.18.1 —
20-in spiral circular column, 8 #10, f'c 5000 psi, fy 60 ksi, cover 1.5 in — read from the
StructurePoint publication "Interaction Diagram - Circular Spiral Reinforced Concrete Column
(ACI 318-19)", Version May-24-2022,
https://structurepoint.org/publication/pdf/Interaction-Diagram-Circular-Spiral-Reinforced-Concrete-Column-ACI-318-19.pdf
(read 2026-10-06). Its seven control points (§1–§7) and Table 8 give nominal Pn/Mn and factored
φPn/φMn; the source states hand values equal spColumn's.
Brown, D.A., Turner, J.P. & Castelli, R.J. (2010), Drilled Shafts: Construction Procedures and LRFD
Design Methods, FHWA-NHI-10-016, Appendix A Step 12.4 (`Geo Technical engineering books/FHWA-NHI-10-016-2010-…pdf`):
96-in shaft, 40 #14 bars, f'c 4,000 psi, fy 60 ksi, "nominal crushing strength of 29,703 kips";
Table 8-2 for bar areas (#14 = 2.25 in², #10 = 1.27 in²).
FEEDING THE SOURCES TO THE ENGINE: it takes cube fck and uses cylinder f'c = 0.8·fck, so fck = f'c/0.8
reproduces the source's f'c; tie_type 'spiral' selects φ = 0.75 and the 0.85 cap of ACI 318-19
Table 21.2.2 / 22.4.2.1 exactly as the source does; cover is to the OUTSIDE of the bar (SP's d1 =
2.64 in = 1.5 clear + 0.5 spiral + 0.635 bar radius).
TWO KINDS OF CHECK, kept apart because they deserve different tolerances:
CLOSED-FORM anchors (P0, Pnt, φPn,max, φPnt, the FHWA crushing load) — the source prints 4–6 s.f. and
the formula does not depend on a stress-strain model, so the tolerance is the source's own rounding
(half a unit of the last printed digit).
STRAIN-COMPATIBILITY points (Mn at a given Pn, φMn at a given φPn) — NOT source rounding. The engine
integrates a Hognestad parabola to ε_cu = 0.0035 (IS 456); the source uses the ACI rectangular block
with ε_cu = 0.003. Re-running the engine with ε_cu = 0.003 brought the flexure-governed points to
−0.3 … −1.7 % and left the compression-governed ones at −3 … −9 % (block vs parabola), so the
deviation is model form, measured rather than assumed. Bands declared up front: ±4 % flexure-
governed (P ≲ 0.2·P0), ±10 % compression-governed. Deviations observed when the suite was written:
Pn 29.5 kip +2.8 % · 518.9 +3.2 % · 856.3 +1.7 % · 1312.6 −6.6 % · pure bending +2.4 %.
AN ENGINE DEFECT FOUND BY THIS COMPARISON (fixed 2026-10-06 in pile-section-mphi.ts, which this engine
sweeps): the fibre model's concrete peaked at f'c instead of f''c = 0.85·f'c (Hognestad 1951; FHWA Eq
12-8). Before the fix the same points read +5.8 / +11.6 / +15.8 / +21.9 % — unconservative, worst at
high axial load.
NOT CHECKED, ON PURPOSE: the balance point. The engine defines it as the PEAK of the swept envelope,
while the source's Pb/Mb is the state fs = fy; they are different quantities and asserting one against
the other would compare apples with oranges.
PUBLISHED-VALUE COUNT: 15 (Pincheira 14: P0, Pnt, φPn,max, φPnt, pure-bending Mn, four nominal Mn, five
factored φMn; FHWA 1: the 29,703-kip crushing load). Below the repo's 20; the shortfall is reported.
| Test block (the published value it checks) | Verdict |
| [1] Pincheira §1.1: nominal axial strength at zero eccentricity P0 = 1902 kip | Pass |
| [2] Pincheira §7: maximum tension Pnt = fy·Ast = −609.60 kip | Pass |
| [3] Pincheira §1.3: maximum (allowable) factored axial strength φPn,max = 0.85·0.75·P0 = 1212.3 kip | Pass |
| [4] Pincheira §7: factored maximum tension φPnt = 0.90·609.60 = −548.64 kip | Pass |
| [5] FHWA-NHI-10-016 App. A: 96-in shaft, 40 #14, f'c 4 ksi, fy 60 ksi — "nominal crushing strength of 29,703 kips" | Pass |
| [6] Pincheira §6: pure bending Mn = 320.11 kip-ft | Pass |
| [7] Pincheira §5 εs = εy + 0.003: Mn(29.5 kip) = 328.13 kip-ft on the nominal envelope | Pass |
| [7] Pincheira §4 fs = fy: Mn(518.93 kip) = 407.73 kip-ft on the nominal envelope | Pass |
| [7] Pincheira §3 fs = 0.5 fy: Mn(856.27 kip) = 375.24 kip-ft on the nominal envelope | Pass |
| [7] Pincheira §2 fs = 0: Mn(1312.64 kip) = 277.54 kip-ft on the nominal envelope | Pass |
| [8] Pincheira Table 8 pure bending (φ = 0.90): φMn at φPn = 0 kip is 288.09 kip-ft | Pass |
| [8] Pincheira Table 8 tension-controlled limit: φMn at φPn = 26.55 kip is 295.31 kip-ft | Pass |
| [8] Pincheira Table 8 balanced (φ = 0.75): φMn at φPn = 389.2 kip is 305.8 kip-ft | Pass |
| [8] Pincheira Table 8 fs = 0.5 fy: φMn at φPn = 642.2 kip is 281.43 kip-ft | Pass |
| [8] Pincheira Table 8 fs = 0: φMn at φPn = 984.48 kip is 208.16 kip-ft | Pass |
⚑ pile-settlement-vesic-web-validation.test.ts
Single-pile working-load settlement — validated against **Vesić's own report**, not a secondary account of it.
Analyses validated: pile-settlement-vesic · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Single-pile working-load settlement — validated against **Vesić's own report**, not a secondary
account of it.
PRIMARY SOURCE, read directly:
Vesić, A.S. (1977) *Design of Pile Foundations*, NCHRP Synthesis of Highway Practice 42,
Transportation Research Board, 68 pp. ISBN 0-309-02544-3.
`Geo Technical engineering books/_new_2026-09-19/NCHRP-Synthesis-42-1977-Vesic-Design-of-Pile-Foundations.pdf`
(downloaded from onlinepubs.trb.org — a free TRB publication).
SECOND SOURCE, independent of the first:
Das, B.M. (2016) *Principles of Foundation Engineering*, Cengage (page footers: "Copyright 2016"), §9.17 "Elastic Settlement of Piles",
Eqs 9.80–9.87, Table 9.14, and the worked example on pp.455–456.
─────────────────────────────────────────────────────────────────────────────────────────────────────
WHAT VESIĆ PUBLISHES, in his numbering and his symbols
─────────────────────────────────────────────────────────────────────────────────────────────────────
w_p = C_p·Q_p / (B·q_o) Eq 42
w_s = C_s·Q_s / (D·q_o) Eq 43
C_s = (0.93 + 0.16·√(D/B))·C_p Eq 44
⚠️ HIS **B IS THE PILE WIDTH** AND HIS **D IS THE EMBEDDED DEPTH** — the opposite of this module,
which uses D for the diameter and L for the length. So Eq 44's √(D/B) is √(L/D) here. The two
conventions are one transposition apart, and a suite that did not say so could "verify" the wrong
ratio and pass: at L = 15 m, D = 0.5 m the two readings are √30 = 5.477 and √(1/30) = 0.183, a factor
of 30 in the (0.93 + 0.16·√·) bracket. Test [7] pins the direction explicitly.
Table 6 (p.33) — typical C_p, reproduced identically as Das Table 9.14:
driven bored
sand (dense to loose) 0.02–0.04 0.09–0.18
clay (stiff to soft) 0.02–0.03 0.03–0.06
silt (dense to loose) 0.03–0.05 0.09–0.12
ξ (Vesić's α, p.32, on his Figs 28A–28D): 0.5 for uniform or parabolic skin friction, "as much as
0.67 (Fig. 28B) and as little as 0.33 (Fig. 28C)", and "around 0.1" for hard-driven slender piles in
sand.
Scope of Table 6 (p.33): total long-term settlement where the bearing stratum extends at least 10
pile diameters below the tip and the soil below is of comparable or higher stiffness; "if this ratio
drops to 5, the settlement is 88 percent of value obtained by Eq. 42. When the ratio drops to 1, the
settlement is still about 51 percent of that value." Consolidation settlement "normally does not
exceed 15 percent of the total".
─────────────────────────────────────────────────────────────────────────────────────────────────────
WHAT THIS SUITE IS AND IS NOT — stated as precisely as the evidence allows
─────────────────────────────────────────────────────────────────────────────────────────────────────
PUBLISHED NUMERIC ANSWERS the engine is compared with: exactly two, both from Das Example 9.13 — the point
load Q_wp = 152 kN and the elastic shortening s_e(1) = 0.00353 m (tests [1]–[5]). That is all there is: Vesić
(1977) states Eqs 42–44 and Table 6 but prints no (inputs → settlement) worked example; Das's own example
computes s_e(2) and s_e(3) by the ELASTIC E_s/I_wp route (Eqs 9.82, 9.84 → 15.5 mm and 0.84 mm), which is a
different method from the C_p semi-empirical route this engine implements (Eqs 9.83, 9.86–9.87), so those
two printed answers cannot be used against s2 and s3 and are not. The semi-empirical s2 and s3 therefore have
NO published numeric answer here: for s2 and s3 this suite is formula-fidelity evidence ONLY — tests [7]–[13] are
HAND CHECKS (not published values) that pin the engine to the primary source's own equations and to the
transposition trap in Eq 44 described above. That wording is deliberate and is left in so that the validation
manifest keeps this engine below "reference-backed" until a published s2/s3 answer is found.
PUBLISHED TABLE AND RANGE VALUES exercised (admissible-span tests [14]–[24]): Vesić Table 6 / Das Table 9.14
(12 cell bounds), Vesić p.32 ξ (0.5, 0.67, 0.33, 0.1), Vesić p.33 (88 %, 51 %, 15 %). They are citable numbers
and the engine's warnings are checked against them, but they are not computed answers.
SECOND SOURCE (added 2026-10-06): Canadian Geotechnical Society (2006), Canadian Foundation Engineering
Manual 4th ed., §18.3.1.1 (book p.280, page image read): Eq 18.21b S_p = (Q_ta + α_s·Q_sa)·L/(A_p·E_p) with
α_s = 0.5 (uniform/parabolic) and 0.67 (linear); Eq 18.25 C_s = 0.93 + 0.16·(L/d)^0.5; Table 18.6 — identical to
Vesić's Table 6 EXCEPT that CFEM prints driven-pile sand as 0.02–0.09 where Vesić and Das print 0.02–0.04.
The engine accepts 0.09 either way (its admissible span is 0.02–0.18), and test [25] records that the two
published tables disagree rather than choosing between them. CFEM's Eq 18.23 also omits the C_p factor that
Vesić's Eq 44 carries in C_s; the engine follows Vesić.
PUBLISHED-VALUE COUNT, honestly: 2 computed answers + 29 table/range values. The repo's bar of 20 published
VALUES is met in number only if range-acceptance counts as a value; as a bar on computed answers it is NOT
met (2 of 20). The s2/s3 path has no published answer at all.
⚠️ AND A DISCREPANCY IN DAS THAT IS NOT OURS TO FIX. His worked example prints
"s_e(1) = 0.00353 m = 3.35 mm" and carries **3.35** into its total of 19.69 mm. But 0.00353 m is
**3.53 mm**, and recomputing from his own printed inputs — (152 + 0.62·350)·21 / (0.1045 · 21×10⁶) —
gives 0.003531 m. The metres are right and the millimetres are a transposition. This engine returns
3.5311 mm, which agrees with the book's arithmetic and not with its typeset answer. Matching 3.35
would mean breaking a correct engine to reproduce a typographical error, so test [4] asserts 3.531
and states why.
| Test block (the published value it checks) | Verdict |
| [1-3] Das §9.17 worked example: the published load split is reproduced exactly | Pass |
| [4-5] the published elastic shortening — and the transposition in the printed answer | Pass |
| [6] the equivalent diameter really does reproduce the published section area | Pass |
| [7-8] HAND CHECK (not a published value) — Vesić Eq 44: C_s = (0.93 + 0.16·√(D/B))·C_p, with HIS D = depth and HIS B = width | Pass |
| [9-11] HAND CHECK (not a published value) — Vesić Eqs 42 and 43 term by term, and the total is a plain sum | Pass |
| [12-13] HAND CHECK (not a published value) — the proportionalities, which the closed forms make exact | Pass |
| [14-19] Vesić Table 6 (p.33) is the admissible span for C_p, and it is enforced | Pass |
| [20-22] ξ is bounded by Vesić p.32 — 0.1 to 0.67, not the narrower band once claimed here | Pass |
| [23-24] the SCOPE of Table 6 is declared on every run, not assumed | Pass |
| [25-27] the refusals are real, and a cleared box cannot produce a finite absurdity | Pass |
| [28-29] all of the load at the point, and all of it on the shaft, are both exact limits | Pass |
| [25] Canadian Foundation Engineering Manual Table 18.6 prints driven sand as 0.02–0.09; Vesić Table 6 and Das Table 9.14 print 0.02–0.04 — the engine accepts both | Pass |
| [26] CFEM Eq 18.21b: α_s = 0.5 for a uniform or parabolic skin-friction distribution and 0.67 for a linear one — both inside the engine's ξ span | Pass |
py-curves-web-validation.test.ts
Validation for the p-y backbone library (`py-curves.ts`).
Analyses validated: py-curves · Recorded run: passed — 35 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the p-y backbone library (`py-curves.ts`).
the release rules ≥20-cited-value gate. Each assertion traces to the family's primary
source or an exact analytic property of its published backbone:
- Matlock (1970) OTC 1204 — soft clay: N_p = min(3+σ'v/su+0.5z/b, 9),
p_u = N_p·su·b, y50 = 2.5·ε50·b, p = 0.5·p_u·(y/y50)^(1/3).
- Welch & Reese (1972) — stiff clay (no water): p = 0.5·p_ult·(y/y50)^0.25.
- Reese, Cox & Koop (1975) OTC 2312 — stiff clay (water): N_p ≤ 11, √ branch.
- Reese, Cox & Koop (1974) OTC 2080 — sand: y_m = b/60, y_u = 3b/80, plateau.
- O'Neill & Murchison (1983) / API RP 2GEO — sand tanh: p→A·p_u, slope k·z at 0,
A = max(0.9, 3−0.8z/b) static, 0.9 cyclic.
- Rollins et al. (2005a) JGGE 131(1) — liquefied sand p = P_d·A·(B·y)^C
(exact hand-computed anchors; b∈[0.3,2.6] m clamp; y capped at 150 mm).
- Franke & Rollins (2013) — hybrid = min(p_clay, p_liq).
- Reese & Nyman (1978) — weak rock: α_r = 1−(2/3)RQD, p_ur plateau.
- Simpson & Brown (2003) — Piedmont: plateau past y/b = 0.0375.
Cross-checked against the RSPile theory manual (Rocscience) and Reese & Van
Impe (2011). Exact numeric anchors independently hand-computed (see PR body).
| Test block (the published value it checks) | Verdict |
| Matlock 1970 — deep N_p caps at 9: p_u = 9·su·b | Pass |
| Matlock 1970 — surface N_p = 3: p_u = 3·su·b | Pass |
| Matlock 1970 — p(y50) = 0.5·p_u exactly | Pass |
| Matlock 1970 — cube-root branch: p(y50/8) = 0.5·p_u·(1/8)^(1/3) = 0.25·p_u | Pass |
| Matlock 1970 — monotonic non-decreasing to plateau | Pass |
| Welch-Reese 1972 — p(y50) = 0.5·p_ult; deep p_ult = 9·su·b | Pass |
| Welch-Reese 1972 — quarter-power branch: p(y50/16) = 0.5·pult·(1/16)^0.25 = 0.25·pult | Pass |
| Reese 1975 — deep wedge N_p caps at 11: p_u = 11·su·b | Pass |
| Reese 1975 — √ branch: p(y50) = 0.5·p_u | Pass |
| Reese 1974 sand — ultimate wedge p_s > 0 and increases with depth | Pass |
| Reese 1974 sand — backbone monotonic and reaches a plateau | Pass |
| Reese 1974 sand — initial branch stiffness = k·z near origin | Pass |
| API sand — p → A·p_u as y→∞ (A static = max(0.9, 3−0.8z/b)) | Pass |
| API sand — initial slope dp/dy|₀ = k·z (tanh′(0)=1) | Pass |
| API sand — static factor A ≥ 0.9 always (deep) and cyclic = 0.9 | Pass |
| Rollins 2005 — exact anchor: z=2 m, b=1 m, y=100 mm ⇒ p = 44.914 kN/m | Pass |
| Rollins 2005 — exact anchor: z=3 m, b=0.6 m, y=50 mm ⇒ p = 17.942 kN/m | Pass |
| Rollins 2005 — displacement capped at 150 mm (p(200)=p(150)) | Pass |
| Rollins 2005 — diameter clamped to [0.3, 2.6] m | Pass |
| Rollins 2005 — concave-up at shallow depth (C>1 ⇒ p(2y)>2·p(y)) | Pass |
| Franke-Rollins 2013 — hybrid = min(p_clay, p_liq) | Pass |
| Reese-Nyman 1978 — α_r = 1−(2/3)·RQD and shallow p_ur plateau | Pass |
| Reese-Nyman 1978 — deep p_ur = 5.2·α_r·qu·b | Pass |
| Reese-Nyman 1978 — RQD=100 ⇒ α_r = 1/3 | Pass |
| Simpson-Brown 2003 — Piedmont plateau past y/b = 0.0375 | Pass |
| Simpson-Brown 2003 — Piedmont initial linear branch p = b·y·E_si for y/b<0.001 | Pass |
| PY_FAMILIES catalogue lists 11 families, each with a citation | Pass |
| Johnson 2006 loess — p_u = 0.409·q_c·b, initial slope E_i = p_u/y_ref, plateau→p_u | Pass |
| pyBackbone dispatch matches direct calls (soft clay + liquefied) | Pass |
| pyBackboneCurve returns monotone-y grid starting at (0,0) | Pass |
| API RP2A sand — plateau p_u matches the published C1/C2/C3 chart (φ=30/35/40°) | Pass |
| Matlock 1970 — full normalized backbone p/p_u = 0.5·(y/y50)^(1/3) | Pass |
| Welch-Reese 1972 — full normalized backbone p/p_ult = 0.5·(y/y50)^0.25 | Pass |
| Reese-Nyman 1978 weak rock — p/p_ur = 0.5·(y/y_rm)^0.25 on the power branch | Pass |
| Rollins 2005 — further exact liquefied-sand anchors (hand-computed) | Pass |
settlement-seepage-pile-web-validation.test.ts
Web-benchmark validation for ELEVEN settlement, seepage/earth-pressure and lateral-pile runner engines.
Analyses validated: basal-heave, broms-lateral-pile, burland-burbidge, elastic-settlement, flow-net-seepage, infinite-slope, is8009-settlement, retaining-wall, settlement, skempton-bjerrum · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for ELEVEN settlement, seepage/earth-pressure and lateral-pile
runner engines. Family suite, same rationale as the other two: each engine is one published
closed-form relation, so each gets exact assertions here rather than a near-empty file of its
own. The ledger carries a separate "family suite" row so the filename-keyed counter is not
mistaken for engine coverage.
ENGINES AND SOURCES
elastic-settlement — Steinbrenner F1/F2 influence factors; Bowles, Foundation Analysis
and Design 5th ed. Eq. 5-16; Das, Principles of Foundation Eng.
is8009-settlement — IS 8009 Part 1 layered elastic settlement (structural anchors)
cv-oedometer — Casagrande log-t (T50 = 0.197) and Taylor √t (T90 = 0.848)
skempton-bjerrum — Skempton & Bjerrum (1957) μ = A + α(1 − A)
burland-burbidge — Burland & Burbidge (1985) Proc. ICE 78, settlement of sand
flow-net-seepage — Casagrande flow net, q = k·h·N_f/N_d (Terzaghi & Peck)
retaining-wall — Rankine active thrust + statics (all 13 outputs verified)
infinite-slope — infinite-slope FoS, dry / seepage-parallel / r_u
basal-heave — Bjerrum & Eide (1956) and Terzaghi (1943); regression for E-101
pile-settlement-vesic — Vesic (1977) three-component pile head settlement
broms-lateral-pile — Broms (1964a) clay and (1964b) sand, long free-head pile
`pile-head-stiffness` is deliberately NOT here: it is a premium server-routed engine whose
`compute()` returns an entitlement notice rather than a result, so it cannot be anchored
through RUNNER_CONFIGS. It needs a server-path test instead — recorded in the ledger.
Every expected value is reconstructed from the published expression in code. Where a value
could not be traced to a source (the Bjerrum-Eide N_c chart fit, the IS 8009 influence
scheme) the engine is anchored on exact structural identities and monotonicity instead of an
invented decimal.
| Test block (the published value it checks) | Verdict |
| elastic-settlement reproduces the Steinbrenner F1/F2 factors and Bowles settlement | Pass |
| is8009-settlement obeys the IS 8009 structural identities | Pass |
| cv-oedometer uses the published T50 and T90 time factors | Pass |
| skempton-bjerrum applies μ = A + α(1 − A) from Skempton & Bjerrum (1957) | Pass |
| burland-burbidge reproduces the 1985 ICE paper expressions | Pass |
| flow-net-seepage computes q = k·h·N_f/N_d (Terzaghi & Peck) | Pass |
| retaining-wall reproduces Rankine thrust and wall statics exactly | Pass |
| infinite-slope reproduces the dry, seepage-parallel and r_u forms | Pass |
| basal-heave reproduces both methods and never publishes an unreconcilable FoS | Pass |
| pile-settlement-vesic reproduces the Vesic (1977) three components | Pass |
| broms-lateral-pile solves the Broms (1964) long-pile equations in clay and sand | Pass |
wave-equation-driving-web-validation.test.ts
WEB-BENCHMARK validation for the wave-equation pile-driving engine (Smith 1960) — now with the DIESEL variable-stroke thermodynamics and RESIDUAL-STRESS ANALYSIS that close the GRLWEAP-parity gap.
Analyses validated: wave-equation-driving · Recorded run: passed — 37 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the wave-equation pile-driving engine (Smith 1960)
— now with the DIESEL variable-stroke thermodynamics and RESIDUAL-STRESS ANALYSIS
that close the GRLWEAP-parity gap. the release rules mandatory step. Absolute BPF from this
reduced-order explicit Smith scheme is not expected to equal GRLWEAP to the digit,
so we anchor on the checks that ARE exact and source-independent — impact velocity,
the allowable driving-stress limits, the qualitative wave-mechanics (free-end
tension, monotone bearing graph, refusal) — plus the DOCUMENTED diesel behaviour
(Rausche & Klesney 2007): the diesel stroke/energy RISES with driving resistance and
is calibrated to the rated stroke at refusal, while an external-combustion (Vulcan)
hammer holds a fixed stroke. The published WEAP87 Vulcan-08 bearing graph is a
trend + order-of-magnitude cross-check.
Sources: Smith (1960) ASCE JSMFD 86(4); Rausche & Klesney (2007) "Hammer types,
efficiencies and models in GRLWEAP" (diesel stroke rises with resistance, η=0.8
diesel / 0.67 air-steam, P_max back-calc to rated stroke); TRB HRR 333-005 (Smith
FD eqs, critical Δt); Holloway et al. (1978) residual stress; FHWA-HRT-04-107 Ch.4
Table 14 (GRL quake/damping); FHWA-NHI-16-009 GEC-12 (allowable driving stresses);
vulcanhammer.info WEAP87 Vulcan-08 18″-pipe bearing graph.
| Test block (the published value it checks) | Verdict |
| WEAP 1: Vulcan-08 impact velocity = 3.61 m/s (matches WEAP87 11.84 ft/s exactly) | Pass |
| WEAP 2: v0 scales as √(energy) | Pass |
| WEAP 3: v0 scales as 1/√(ram weight) | Pass |
| WEAP 4: hammer_model overrides ram/energy/η (Delmag D30) | Pass |
| WEAP 5: custom (no model) keeps user-entered ram/energy | Pass |
| WEAP 6: the library exposes ≥5 inspectable hammers (vs GRLWEAP closed register) | Pass |
| WEAP 7: steel allowable = 0.90·f_y (default f_y 350 MPa ⇒ 315 MPa) | Pass |
| WEAP 8: steel allowable tracks the entered f_y | Pass |
| WEAP 9: prestressed concrete comp = 0.85·f′c − f_pe (35, 5 MPa ⇒ 24.75 MPa) | Pass |
| WEAP 10: prestressed concrete tension = f_pe + 0.25√f′c ⇒ 6.48 MPa | Pass |
| WEAP 11: timber allowable = 3× design stress | Pass |
| WEAP 12: bearing graph blow count is MONOTONE increasing in Rᵤ | Pass |
| WEAP 13: higher Rᵤ ⇒ harder driving (more blows/m) than lower Rᵤ | Pass |
| WEAP 14: higher Rᵤ ⇒ smaller permanent set | Pass |
| WEAP 15: free-end reflection ⇒ tensile stress appears (esp. at low resistance) | Pass |
| WEAP 16: compressive driving stress is significant (of order the impact stress) | Pass |
| WEAP 17: refusal — very high Rᵤ ⇒ ≥800 blows/m or REFUSAL verdict | Pass |
| WEAP 18: overstress — tiny allowable ⇒ OVERSTRESS + stress_ok false | Pass |
| WEAP 19: a workable case ⇒ DRIVABLE/hard + stress_ok true | Pass |
| WEAP 20: stress utilisation = max(comp,tens)/allowable ·100 | Pass |
| WEAP 21: WEAP87 order-of-magnitude — 400-kip (1779 kN) blow count in a plausible band | Pass |
| WEAP 22: transferred energy (ENTHRU) is positive and below the rated energy | Pass |
| WEAP 23: blows/250mm = blows/m ÷ 4 | Pass |
| WEAP 24: invalid input ⇒ errors, no crash | Pass |
| WEAP 25: Delmag diesel uses the variable-stroke model (diesel_model = true) | Pass |
| WEAP 26: diesel stroke RISES with driving resistance (GRLWEAP behaviour) | Pass |
| WEAP 27: diesel energy per blow RISES with resistance and is ≤ rated at refusal cap | Pass |
| WEAP 28: diesel stroke approaches the rated stroke at refusal (calibration target) | Pass |
| WEAP 29: an external-combustion hammer (Vulcan-08) holds a FIXED stroke | Pass |
| WEAP 30: bearing graph carries the (variable, for diesel) stroke per Rᵤ | Pass |
| WEAP 31: RSA runs, converges to a steady set, and labels itself | Pass |
| WEAP 32: RSA vs standard differ modestly (residual pre-stress effect), same order | Pass |
| WEAP 33: DIESEL transfer efficiency ≈ GRL measured 39% (band 29–49%, CoV 26%) | Pass |
| WEAP 34: single-acting AIR/STEAM efficiency ≈ GRL measured 56% (band 43–69%) | Pass |
| WEAP 35: HYDRAULIC efficiency ≈ GRL measured 69% (band 52–86%) | Pass |
| WEAP 36: transfer_efficiency_pct = 100·ENTHRU/rated (self-consistent) | Pass |
| WEAP 37: diesel refusal stroke ≈ 95% of rated (GRLWEAP §B2 P_max calibration) | Pass |
Tunnels and underground works
FE kernel registry — 9 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
k5b-plaxis-verif-hoek-brown-tunnel | plastic radius around the unsupported circular opening (R = 2 m, σ0 = 15 MPa, GSI 50, mi 10, σci 30 MPa) [m] | PLAXIS-Verification-Hoek-Brown-material-model.pdf, p. 1–4 (study case 1, p_i = 0: Rpl 3.80 m) | 3.8 | 3.794 | default policy (strict, then the PLAXIS criterion with the initial stiffness — D124 + D684): (λ: 1; Rpl m: 3.821; elastic-zone σr worst % of σ0: 1.2; steps (fallback): 10; iterations (fallback): 45); strict (verification mode, parityFallback false): stops at λ 0.9000 (20 steps / 27 cuts / 1219 it) — D683: a strict residual floor (active-set cycling at the tolerance, D380 class); at the carried p_i = 1500 kPa Rpl 2.873 m vs Carranza-Torres 2.853 m, σr 0.72 % of σ0 | default policy Rpl vs PLAXIS 3.80: 0.55 | +0.71 % | Pass |
k5d1-lame-normal-pressureself-check | worst relative radial-displacement error on both faces of a thick cylinder loaded by a normal-pressure line load `pn` on its curved (polyline) inner face [relative error] | — | — | 0.002 | 0.0008874 | — | — | Pass |
k5d1-contraction-ringself-check | radius change of a bonded elastic lining under a line contraction C_ref = 0.5 % [m] | PLAXIS-2D-2025.1-Reference-Manual §5.4.3, §9.4.2, p. p. 79, p. 445 (C_planar = C_ref/2) | — | -0.00178571 | -0.00178701 | — | +0.07 % | Pass |
k5d1-hb-tunnel-case2 | plastic radius around the circular opening supported by a 2500 kPa normal pressure [m] | PLAXIS-Verification-Hoek-Brown-material-model.pdf, p. 1–4 (study case 2, p_i = 2500 kPa: Rpl 2.58 m) | 2.58 | 2.582 | 2.598 | +0.70 % | +0.62 % | Pass |
k5d1-plaxis-2d-tut6-natm | NATM tunnel, β-method (60 % / 100 %) in two excavation stages: crown settlement, lining forces [mm, kNm/m, kN/m] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 108–120 (Fig. 6–11, 6–13: figures only) | — | — | crown uy phase 1..4 mm: [-7.45, -8.65, -9.17, -9.11]; crest (−7, 35) uy phase 4 mm: -19.77; liningTop M max/min kNm/m: [2.5, -4.8]; liningTop N min kN/m: -164; liningInvert M max/min kNm/m: [2.6, -3.3]; liningInvert N min kN/m: -59 | — | — | Recorded, no published value |
k5d1-plaxis-2d-tut5-building-tilt | building tilt at the end of phase 5 (lining), displacements from phase 2 on: (uy(15, 3) − uy(5, 3)) / 10 m [%] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 106–107 (Fig. 5–9: (5, 3) → (4.995, 2.981), (15, 3) → (14.995, 2.998)) | 0.168 | — | 0.1834 | +9.17 % | — | Deviation |
k5d1-plaxis-2d-tut5-contraction | applied plate contraction strain of the TBM (C_ref/2) [-] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 103 (§5.7 phase 3: Cref 0.5 %) | — | 0.0025 | 0.0025 | — | 0.00 % | Pass |
tunnel-s1-plaxis3d-tut5-ground-settlement | maximum settlement at ground level after phase 5 (PLAXIS: horizontal cross-section at z = 1.95 m; ours: surface z = 2 m) [cm] | PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf (+ PLAXIS-3D-2026.1-Tutorial-Manual.pdf), p. §5.9, pp. 111–112 (2026.1: pp. 112–113) | 1.9 (PLAXIS 3D) | — | 1.8549 | −2.37 % | — | Deviation |
tunnel-s1-plaxis3d-tut5-max-uz | maximum vertical displacement after phase 5 (Fig 5-34 caption) [cm] | PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf (+ PLAXIS-3D-2026.1-Tutorial-Manual.pdf), p. §5.9, pp. 111–112 (2026.1: pp. 112–113) | 3.1 (PLAXIS 3D) | — | 3.4275 | +10.6 % | — | Deviation |
Row details: reference source, case, mesh, the test that reproduces it, notes
k5b-plaxis-verif-hoek-brown-tunnel — Pass · K5b
Reference: Carranza-Torres (2004) closed form at p_i = 0 (PLAXIS verification document Eqs. 5-10): 3.794 m
Case: cases/plaxis-verification-hoek-brown-tunnel.json
Mesh: 1015 T15 (kernel 'medium', refinement polylines r = 2–5 m)
Reproduce: tests/k5b_fe.rs hoek_brown_tunnel_default_policy_plastic_radius (gate: Rpl within 4 % of the closed form at p_i = 0, σr < 2 % of σ0) + plaxis_hoek_brown_tunnel_plastic_radius (strict verification mode: same bars at the carried p_i; locks the D683 stall class)
Notes: D684 (Lead D, 9 Nov 2026): the PLAXIS-parity criterion now uses PLAXIS 2D RM 2025.1 Eq. 7-21 (sums of nodal force magnitudes) and the D124 fallback iterates with the initial stiffness as PLAXIS does (RM §7.9.3.19): the default run completes the excavation with Rpl 3.821 m (+0.71 % vs Carranza-Torres, +0.55 % vs PLAXIS 3.80), σr drift 1.20 % of σ0. Before: 3.439 m (−9.4 %), σr 5.35 % (Newton fallback on a drifting arc-length path). || Lead A (9 Nov 2026, prog-a-tut 9d6f7234, Modal 2026-11-09T04-21-49; baseline at 66df8b96 Modal 2026-11-09T04-57-50): strict stops at λ 0.9000 on BOTH trees (the recorded 0.950 is stale; the test's ≥ 0.95 gate was passed by 7.6e-7 when recorded). Under the D124 default policy the excavation completes (λ 1.0) at the PLAXIS criterion, but the plastic radius is 3.439 m vs Carranza-Torres 3.794 / PLAXIS 3.80 (−9.5 %) and the elastic-zone σr is off by 5.35 % of σ0: the completed answer is NOT accurate enough to pass, so the row stays a deviation. || OPEN (K5b-HB-TUNNEL): the excavation phase stops at ΣMstage 0.950 (18 cuts, 2893 iterations; earlier builds 0.975) — global Newton cycling as the wall points reach the Hoek–Brown apex (σ3 → 0). At the λ reached the plastic radius is +1.2 % from the closed form at p_i = (1 − λ)σ0 = 750 kPa and the elastic-zone σr is within 0.86 % of σ0. The test asserts λ ≥ 0.95 — passed by 7.6e-7, i.e. AT the threshold. Study case 2 (p_i = 2500 kPa, PLAXIS 2.58 m) needs a normal-pressure line load (not in the kernel). K5d-1 (19 Oct): study case 2 now runs with the normal-pressure line load — row k5d1-hb-tunnel-case2 (2.598 m vs 2.58).
k5d1-lame-normal-pressure — Pass · K5d-1
Reference: Lamé closed form u_r(a) = 1.5275e-2 m (plane strain); the value is the test tolerance
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 normal_pressure_on_a_curved_boundary -- --nocapture
Notes: T15, polyline arcs (the chord error dominates); Σ nodal forces = p·R per quarter to 1e-9. FELA and LEM refuse `pn` (give qx, qy).
k5d1-contraction-ring — Pass · K5d-1
Reference: bonded elastic ring in an elastic medium (closed form)
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 line_contraction -- --nocapture
Notes: Hoop N 142.580 vs 142.857 kN/m (−0.19 %); applied c = 0.0025 = C/2.
k5d1-hb-tunnel-case2 — Pass · K5d-1
Reference: Carranza-Torres (2004) Eq. 10
Case: cases/plaxis-verification-hoek-brown-tunnel-case2.json
Mesh: 1302 T15 (as k5b-plaxis-verif-hoek-brown-tunnel)
Reproduce: tests/k5d1_tutorials.rs hoek_brown_tunnel_case2_normal_pressure (ignored: ~19 s release)
Notes: D108 re-run with the K5d normal-pressure line load: every phase converged (ΣMstage = 1, 10 steps, no cuts — unlike case 1 the wall never reaches the HB apex); 1658 plastic points; mean σr at r < 2.08 m 2709 kPa (p_i 2500). Test tolerance 4 %.
k5d1-plaxis-2d-tut6-natm — Recorded, no published value · K5d-1
Case: cases/plaxis-2d-tutorial-06-natm-tunnel-k5d.json
Mesh: 1755 T15
Reproduce: tests/k5d1_tutorials.rs tutorial6_natm_tunnel_beta_method (ignored: ~5.2 min release)
Notes: Re-run 13 Nov 2026 after KB-3 (1755 T15, 222 s, every phase converged): crown settlement in phases 1 to 4 −7.45 / −8.65 / −9.17 / −9.11 mm; crest −19.77 mm; lining top M 2.5 / −4.8 kNm/m, N −164 kN/m; lining invert M 2.6 / −3.3 kNm/m, N −59 kN/m. KB-3 changes the result bits but no printed quantity (the parent commit gives identical values); the difference from the 2 Nov record (1875 T15) comes from the later mesh change. || Recorded, no published value: the tutorial prints figures only (Figs 6-11, 6-13); lining moments are the same order as Fig. 6-13. || D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): crest uy phase 4 −19.59 → −19.77 mm (+0.18 mm), liningTop M min −5.0 → −4.9 kNm/m; crown uy P1–P4 [−7.42, −8.62, −9.14, −9.07], liningTop N −174, liningInvert M [2.6, −3.4] / N −64 re-measured identical. Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before (HS layer next to the tunnel; the HB rock is unaffected). 274 s. Figures only: no verdict. || No PLAXIS numbers to compare (figures only) — recorded as a run, every phase converged; the supports are retained at d = 0.6 in phases 1 and 3 and released in 2 and 4; the crown settles further when the support is released. Lining moments are the same order as Fig. 6–13 (single-digit kNm/m).
k5d1-plaxis-2d-tut5-building-tilt — Deviation · K5d-1
Case: cases/plaxis-2d-tutorial-05-shield-tunnel-k5d.json
Mesh: 1280 T15
Reproduce: tests/k5d1_tutorials.rs tutorial5_shield_tunnel_contraction_grouting (ignored: strict criterion, ~2.5 h release on 2 vCPU)
Notes: Note 12 Nov 2026: this case has a curved interface, and the interface fix KB-3 changed how those are computed; the number here predates it and has not been re-run. || V4/D525/D529 re-record after the HS-family fix: tilt 0.183 % (was 0.1836), Δy 18.34 vs 17 mm, rotation 0.105° vs 0.097°; corners uy -20.43 vs −19 mm and -2.09 vs −2 mm, ux -5.89 vs −5 mm (PLAXIS values read from the coordinates printed in Fig. 5–9, 1 mm resolution). Phases: building 7 steps / 0 cuts / 29 it / 53 s; tbm 7 steps / 0 cuts / 28 it / 54 s; conicity 50 steps / 6 cuts / 890 it / 656 s; grouting 487 steps / 154 cuts / 15148 it / 6801 s; lining 54 steps / 15 cuts / 1410 it / 504 s; total 8068 s on Modal (2 vCPU, canonical). || Δy 18.36 vs 17 mm (+8 %), rotation 0.105° vs 0.097°; corners uy −20.70 vs −19 mm and −2.33 vs −2 mm, ux −5.90 vs −5 mm (PLAXIS values read from the coordinates printed in Fig. 5–9, 1 mm resolution). Every phase converged. Substitutions: tail-void grouting = a 230 kPa normal pressure on the contour (PLAXIS: user-defined pore pressure in the dry clusters); TBM and lining two plates on one line; mesh-conforming embedded piles. The test asserts the tilt within ±25 % of PLAXIS.
k5d1-plaxis-2d-tut5-contraction — Pass · K5d-1
Reference: RM 2025.1 §9.4.2: C_planar = C_ref / 2
Case: cases/plaxis-2d-tutorial-05-shield-tunnel-k5d.json
Mesh: 1280 T15
Reproduce: tests/k5d1_tutorials.rs tutorial5_shield_tunnel_contraction_grouting (ignored: strict criterion, ~2.5 h release on 2 vCPU)
Notes: Note 12 Nov 2026: this case has a curved interface, and the interface fix KB-3 changed how those are computed; the number here predates it and has not been re-run. || V4/D525/D529 re-record: surface (0, 3) settlement -4.72 mm after conicity, -16.78 after grouting, -18.23 after the lining. TBM most compressive N -519 kN/m, max |M| 136.4 kNm/m (phase 2); lining N -223 kN/m, |M| 19.7 kNm/m. Phases: building 7 steps / 0 cuts / 29 it / 53 s; tbm 7 steps / 0 cuts / 28 it / 54 s; conicity 50 steps / 6 cuts / 890 it / 656 s; grouting 487 steps / 154 cuts / 15148 it / 6801 s; lining 54 steps / 15 cuts / 1410 it / 504 s. OPEN (K5d1-T5-GROUT-SLOW): the grouting phase needs 292 steps / 83 cuts / 8556 iterations (3619 s of the 4429 s run; D80 robustness 26/109 Anderson rescues) — the undrained (B) clays with HS-small sands around the unsupported contour under a 230 kPa pressure; converges, but slowly.
tunnel-s1-plaxis3d-tut5-ground-settlement — Deviation · tunnel-s1 → 3-D tunnel on the modelling screen (geometry.tunnel spec, 14 Nov 2026)
Reference: published band (D-tunnel-s1-3): 1.85–2.10 cm = the 2025.1 (1.9) and 2026.1 (2.05) values ± half a last digit
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1 / 2026.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §5 “Phased excavation of a shield tunnel [GSE]” (inputs Tables 5-1, 5-2, §5.6–5.8; results §5.9 pp. 111–112) and the 2026.1 edition §5.9 pp. 112–113; page: 111–112; caseId: Tutorial 5 (shield tunnel, phase 5)
Mesh: structured mapped tet10 half model 20 × 80 × 20 m, n_core 3: 16 146 elements, 72 333 mesh DOF (64 839 free in the last stage), shell TBM + shell lining at r = 4.25 m, elastic interface at PLAXIS's stiffness rule (no slip); canonical direct LDLᵀ
Reproduce: tests/k11_tunnel_spec3d.rs plaxis3d_tutorial5_through_the_spec (ignored: 386 s on Modal, server shape 4 CPU / 8 GiB) — the spec path the modelling screen runs (fixture tests/fixtures/tunnel3d-plaxis3d-tut5.json = the screen's Tutorial 5 template, checked by apps/web/lib/modelling/__tests__/tunnel3d.test.ts)
Notes: Re-run 14 Nov 2026 through the 3-D ModelSpec (`geometry.tunnel`, model/tunnel3d_spec.rs) — the path the screen's Tutorial 5 template sends: 1.8549 cm, equal to the hand-built API run of FINDING F-2 round 2 (1.855 cm; the spec writes the shield contraction rate as C/(L − a), the API test as 0.0006667). Inside the band 1.85–2.10 cm set before the run (D-tunnel-s1-3), but the same run misses max uz (next row), so the case is not reproduced and the row stays a deviation. vs 2026.1 2.05 cm: −9.5 %. Tied lining (API, round 2): 1.521 cm (−20 %).
tunnel-s1-plaxis3d-tut5-max-uz — Deviation · tunnel-s1 → 3-D tunnel on the modelling screen (geometry.tunnel spec, 14 Nov 2026)
Reference: published band (D-tunnel-s1-3): 3.05–3.25 cm = the 2025.1 (3.1) and 2026.1 (3.2) values ± half a last digit
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1 / 2026.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §5 “Phased excavation of a shield tunnel [GSE]” (inputs Tables 5-1, 5-2, §5.6–5.8; results §5.9 pp. 111–112) and the 2026.1 edition §5.9 pp. 112–113; page: 111–112; caseId: Tutorial 5 (shield tunnel, phase 5)
Mesh: structured mapped tet10 half model 20 × 80 × 20 m, n_core 3: 16 146 elements, 72 333 mesh DOF (64 839 free in the last stage), shell TBM + shell lining at r = 4.25 m, elastic interface at PLAXIS's stiffness rule (no slip); canonical direct LDLᵀ
Reproduce: tests/k11_tunnel_spec3d.rs plaxis3d_tutorial5_through_the_spec (ignored: 386 s on Modal, server shape 4 CPU / 8 GiB) — the spec path the modelling screen runs (fixture tests/fixtures/tunnel3d-plaxis3d-tut5.json = the screen's Tutorial 5 template, checked by apps/web/lib/modelling/__tests__/tunnel3d.test.ts)
Notes: Re-run 14 Nov 2026 through the 3-D ModelSpec (`geometry.tunnel`), the screen's path: 3.4275 cm, equal to the API run (FINDING F-2 round 2), +5.5 % above the band ceiling 3.25 cm; vs 2026.1 3.2 cm: +7.1 %. Max heave 0.2347 cm. Known differences from PLAXIS (each a Decision in the tunnel-s1 report): shell lining at r = 4.25 m instead of a 0.25 m volume, an elastic interface without Coulomb slip, a structured mapped mesh. Tied lining (API): 3.136 cm inside the band with the trough outside.
Cited validation suites — 9
⚑ shotcrete-age-stiffness-web-validation.test.ts
Web-validation for `shotcrete-age-stiffness.ts` — the time-dependent E(t) and fcu(t) of young shotcrete used in NATM / SEM lining modelling.
Analyses validated: shotcrete-age-stiffness · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-validation for `shotcrete-age-stiffness.ts` — the time-dependent E(t) and
fcu(t) of young shotcrete used in NATM / SEM lining modelling.
PUBLISHED SOURCES (opened and read for this suite):
1. Neuner, M., Cordes, T., Drexel, M. & Hofstetter, G. (2017), "Time-Dependent
Material Properties of Shotcrete: Experimental and Numerical Study",
Materials 10(9):1067 (open access, doi:10.3390/ma10091067). Table 2 prints
the measured Young's modulus and uniaxial compressive strength of Brenner
Base Tunnel shotcrete SpC25/30/(56)/J2 at ages 6 h … 28 d. Eqs. (5)-(8) print
the CEB-FIP law and the s_stiff / s_strength parameter equations.
2. PLAXIS 3D 2025.1 Material Models Manual §14.3.1 (on disk:
books/PLAXIS-3D-2025.1-Material-Models-Manual-Seequent.pdf). Eqs. 14–17 …
14–22 print the same CEB-FIP law and the Oluokun bridge; Table 14–1 prints
the EN 14487-1 J1/J2/J3 mean strengths at 0.1, 0.5, 12, 24 h.
WHAT IS ASSERTED AND WHY.
· The CEB-FIP law and the s-parameter equations are CLOSED FORMS printed in
both sources — asserted EXACTLY (the "exact closed forms count" case).
· The two anchor measurements E(1), E(28), fcu(1), fcu(28) are PRINTED numbers
(Neuner 2017 Table 2) — asserted to the printed value.
· The intermediate ages (2, 3, 7 d) are printed measurements the closed-form
law is expected to follow closely — asserted within the printed standard
deviation of the measurement (Table 2 SD), a legitimate citable tolerance.
· The EN 14487-1 class table values are printed (PLAXIS Table 14–1) — asserted
exactly at the tabulated ages.
NOT ASSERTED: the Meschke tE/ΔtE early-age branch (needs parameters not in the
sources read); the creep / shrinkage models (outside this engine's scope); the
SCDP solidification-theory compliance function (no closed form).
| Test block (the published value it checks) | Verdict |
| CEB-FIP s-parameters: s_stiff and s_strength from the printed equations (exact) | Pass |
| CEB-FIP law reproduces the 1-day and 28-day anchors exactly | Pass |
| CEB-FIP E(t) and fcu(t) are the exact printed closed form (Neuner Eqs. 5-8) | Pass |
| CEB-FIP vs measured Neuner series: documented model deviation (FINDING-2) | Pass |
| CEB-FIP very-early-age lower limit: fcu ≥ 0.005·fcu,28 (PLAXIS MM §14.3.1) | Pass |
| CEB-FIP stiffness is monotonic and constant beyond t_hydr | Pass |
| EN 14487-1 J2 class tabulated strengths at the printed ages (exact) | Pass |
| EN 14487-1 J1/J3 classes at 12 h and 24 h (printed Table 14–1) | Pass |
| EN 14487-1 → Oluokun bridge after 24 h reaches fcu,28 at 28 d | Pass |
| Oluokun fc(t) = αc·e^(−b_c/t) against the printed equation (exact) | Pass |
| Round-length helper: age at full load = (d + 2RT)/Lr × tr (definition) | Pass |
| Round-length helper warns when the ring is very young at full load (< 8 h) | Pass |
| wrapper: input validation and monotonicity warnings | Pass |
| Smaniotto 2022 §4.1: strength at 1 d is the STATED "50 %" of the 28-d strength (23.8 / 47.6 MPa) — engine anchors reproduce it | Pass |
| Smaniotto 2022 Table 5 / A.3: Young's modulus anchors 18 200 MPa (1 d) and 28 700 MPa (28 d) reproduced by the CEB-FIP law | Pass |
| Smaniotto 2022 Table A.3: Meschke-Kropik-Mang E(t), anchored at 1 d / 28 d, tracks the measured 2, 7, 14 d means within 2 SD | Pass |
| Smaniotto 2022 Tables A.1/A.3 — FINDING: the two-anchor CEB-FIP law over-predicts the measured intermediate-age strength and stiffness by more than 2 SD at 2 d and 7 d | Pass |
| Smaniotto 2022 Table A.1 — the Oluokun law driven by the same anchors over-predicts the 7-d strength by more than CEB-FIP does | Pass |
⚑ tunnel-face-pressure-web-validation.test.ts
Web-validation for `tunnel-face-pressure.ts` — the required closed-face TBM face support pressure by the DAUB 2016 wedge-silo and the undrained stability ratio.
Analyses validated: tunnel-face-pressure · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-validation for `tunnel-face-pressure.ts` — the required closed-face TBM face
support pressure by the DAUB 2016 wedge-silo and the undrained stability ratio.
PUBLISHED SOURCE (opened and read for this suite; on disk
_new_2026-11-04_tunnel-face/DAUB-2016-Face-Support-Pressure-Recommendations.pdf):
DAUB (2016), "Recommendations for Face Support Pressure Calculations for Shield
Tunnelling in Soft Ground", v10/2016, 64 pp. The §8 worked examples are
reproduced below against the PRINTED numbers DAUB publishes.
WHAT IS ASSERTED AND WHY. DAUB §8.1 (slurry, sandy soil, D = 10 m, t_crown = 15 m,
gw at −2 m) and §8.2 (EPB, clay, 13 m clay over 2 m sand) are complete worked
examples whose intermediate and final values are PRINTED to 1 decimal. These are
exact reproductions of the printed equations, so the engine's outputs are asserted
to the printed values within printing round-off (±0.5 of the last printed digit),
the "exact limits count" case of the brief. The undrained stability-ratio example
(DAUB §8.2) prints Ncr = 6.537 (Atkinson & Mair) and N = 4.358 — asserted exactly.
NOT ASSERTED: the slurry-penetration transfer efficiency (DAUB §8.1.2 needs the
graphical area ratio AA/BB of Fig. 32, not a number); the DIN 4085 lamella method
(a different model, not implemented); numerical SLS methods (§6.3, out of scope).
| Test block (the published value it checks) | Verdict |
| DAUB §8.1: critical sliding angle ϑcrit = 66.56° (printed) | Pass |
| DAUB §8.1: wedge forces G, Pv, TR at ϑcrit (printed values) | Pass |
| DAUB §8.1: circular-face earth force Emax,ci = 3237.7 kN (printed) | Pass |
| DAUB §8.1: water force Wci = 14137.2 kN and total Sci = 19700.5 kN (printed) | Pass |
| DAUB §8.1: minimum crown pressure s_crown,min = 190.8 kN/m² (printed) | Pass |
| DAUB §8.1: working band 201 → 219 kN/m² (printed conclusion) | Pass |
| DAUB §8.1: water floor 1.05 × groundwater = 136.5 kN/m² (printed check) | Pass |
| Coefficient sets: Anagnostou & Kovári (K2=0.4) requires ≥ the DAUB/Jancsecz force | Pass |
| Deep overburden (t > 2D) engages the Janssen silo branch (DAUB Eq. 12) | Pass |
| Shallow overburden (t ≤ 2D) uses the full-overburden branch (DAUB Eq. 11) | Pass |
| DAUB §8.2: Atkinson & Mair Ncr = 6.537 and N = 4.358 (printed) | Pass |
| DAUB §8.2: support pressure at axis s_axis = 213.7 kN/m² (printed) | Pass |
| DAUB §8.2: minimum crown pressure s_crown,min = 143.7 kN/m² (printed) | Pass |
| DAUB §8.2: working band 174 → 211 kN/m² (printed conclusion) | Pass |
| DAUB §8.2: stability-ratio family — Broms ≤ 6, Davis lower bound ordering | Pass |
| DAUB §8.2: Davis local-failure check γ2,sat·D/cu ≤ 10.96 (Eq. 26) | Pass |
| wrapper: input validation | Pass |
| wrapper: shallow-cover warning fires below 1·D overburden | Pass |
⚑ tunnel-ground-reaction-web-validation.test.ts
Dedicated validation for the tunnel ground reaction curve (`tunnel-ground-reaction.ts`) — the convergence-confinement closed form for a circular tunnel in a Mohr-Coulomb, zero-plastic-volume-change rock mass under a hydrostatic field stres…
Analyses validated: mohr-coulomb, tunnel-ground-reaction · Recorded run: passed — 16 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the tunnel ground reaction curve (`tunnel-ground-reaction.ts`) — the
convergence-confinement closed form for a circular tunnel in a Mohr-Coulomb, zero-plastic-volume-change
rock mass under a hydrostatic field stress (critical support pressure, plastic radius, wall convergence).
PUBLISHED SOURCES (each opened and read for this suite; values below are the printed numbers):
1. Hoek, E. (2006), Practical Rock Engineering (the course notes as revised that year), chapter
"Tunnels in weak rock", Equations 1-7 and Figure 4 (the printed spreadsheet worked example:
σci = 10 MPa, mi = 10, GSI = 25, ν = 0.30, r0 = 3.0 m, p0 = 2.0 MPa, pi = 0).
File: Practical-Rock-Engineering-Full-Text.pdf in the reference library.
2. Hoek, E. (2012), Rock-support interaction analysis for tunnels in weak rock masses (Rocscience
RocSupport theory document, PDF dated 2012-04-02), Figure 4 "Characteristic curve for a tunnel
excavated in weak rock" (r0 = 5 m, φ = 23°, c = 1.5 MPa, E = 1800 MPa, ν = 0.3, p0 = 7 MPa).
Fetched and read 2026-10-06; the full URL is recorded beside its inputs further down.
3. Brady, B.H.G. & Brown, E.T. (2004), Rock Mechanics for Underground Mining, 3rd ed., Section 11.3
worked example and Table 11.1 (r0 = 3 m, p0 = 10 MPa, G = 600 MPa, φ = 45°, C = 2.414 MPa).
File: rock-mechanics_for-underground-mining.pdf in the reference library.
4. Carranza-Torres, C. (2003), "Dimensionless graphical representation of the exact elasto-plastic
solution of a circular tunnel in a Mohr-Coulomb material subject to uniform far-field stress",
Rock Mechanics and Rock Engineering 36(3), 237-253, Figure 5 (a = 2 m, σ0 = 40 MPa, σci = 10 MPa,
φ = 30°, G = 1 GPa, ν = 0.25, non-associated flow with ψ = 0°).
https://repository.geologyscience.ru/bitstream/handle/123456789/35257/Carr_03.pdf (read 2026-10-06).
WHAT IS PUBLISHED ANSWER AND WHAT IS NOT. Every `near(...)` below whose comment carries a source locator
is a number PRINTED in that source (worked-example output, table entry or chart reading) — not a value
computed with this engine or re-derived from the formula. Where an engine INPUT has to be obtained from
the source's own stated inputs by a published relation (e.g. the Hoek spreadsheet's Hoek-Brown fit giving
c, φ, E; or c obtained by inverting the printed σci and φ), that is said in a comment and the input is
cross-checked against the intermediate value the source prints.
NOT ASSERTED (recorded so nothing is hidden): (a) Brady & Brown's plastic-branch rows (re = 3.316 ...
10.487 m, δi = 0.027 ... 0.632 m) use a dilatant, brittle (residual φf = 30°, no residual cohesion)
model, which is a DIFFERENT model from this engine's perfectly plastic zero-dilation closed form, so they
are not comparable; (b) Carranza-Torres' associated-flow result (ur/a = 22 %) is a different flow rule;
(c) the RocSupport document's "support of about 0.6 MPa at ui = 0.0304 m" is a reading from a plotted
curve, described only as "of the order of" 0.6 MPa, and is not asserted; (d) the Hoek chapter's
empirical Monte-Carlo fit curves (its Equations 8-9) are statistical fits, not this closed form.
Tolerance rule: half a unit in the last printed digit of each source value, unless a comment says
otherwise (and then why).
| Test block (the published value it checks) | Verdict |
| Hoek (2006) Fig.4: replicated spreadsheet inputs equal the printed intermediate values | Pass |
| Hoek (2006) Fig.4: engine reproduces the printed Output row (pi = 0) | Pass |
| Hoek (2012) RocSupport Fig.4: characteristic curve end point (pi = 0) | Pass |
| Brady & Brown (2004) §11.3: strength parameters and critical support pressure | Pass |
| Brady & Brown (2004) Table 11.1: elastic-branch wall displacement δi (m), 3 d.p. printed | Pass |
| Carranza-Torres (2003) Fig.5: intermediate computations and critical pressure | Pass |
| Carranza-Torres (2003) Fig.5: plastic radius and wall convergence (ψ = 0°) | Pass |
| Carranza-Torres (2004) App.A: engine HB parameters at GSI = 50 (self-consistent) | Pass |
| C-T&F (1999) §4.3: Hoek-Brown critical internal pressure p*i = 16 MPa | Pass |
| Shotcrete/concrete capacity — H&B (1980) Eq. (121) exact closed form (Table 17 cross-checked) | Pass |
| Shotcrete/concrete capacity — H&B (1980) Table 17 PRINTED values, read by the inner lining radius (ro = ri + tc) | Pass |
| Steel-set capacity — Hoek (2012) corrected Eq. (14), cross-checked (SOURCES-GRC §7.2) | Pass |
| Rockbolt capacity — H&B (1980) Table 17 rows H, I, J, K (Eq. 128/18, radius-independent) | Pass |
| Combined support stiffness and capacity — H&B (1980) Eq. (129) additivity | Pass |
| Equilibrium: FS = psmax/peq; support installed after ui0 (Hoek 2012 §5.3) | Pass |
| RocSupport Tutorial Example 1 — NOT ASSERTED (finding, not a widened tolerance) | Pass |
⚑ tunnel-grout-pressure-web-validation.test.ts
Web-validation for `tunnel-grout-pressure.ts` — annular grout-pressure bounds and the shield conicity → PLAXIS contraction (volume-loss) relation.
Analyses validated: tunnel-grout-pressure · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-validation for `tunnel-grout-pressure.ts` — annular grout-pressure bounds and
the shield conicity → PLAXIS contraction (volume-loss) relation.
PUBLISHED SOURCES (opened and read for this suite):
1. PLAXIS 3D 2025.1 Reference Manual §5.4.4 (Surface contraction), p. 100 —
on disk books/PLAXIS-3D-2025.1-Reference-Manual-Seequent.pdf. Verbatim:
"the applied contraction is equal to the tunnel contraction to simulate small
volume loss ( ≈3% volume contraction)" and "the value of surface contraction
to be applied is equal to the volume loss as a percentage of the tunnel volume."
2. MDPI Applied Sciences 13(18):10437 (2023), "Pressure Model Study on
Synchronous Grouting in Shield Tunnels" — reprints the Sophia Rail Tunnel
verification data: external diameter 9.5 m, lining 0.4 m, overburden ≈ 200 kPa
at the crown, measured grout pressure at the crown ≈ 200 kPa and at the invert
≈ 370 kPa. (The same Sophia data Bezuijen & Talmon published.)
3. Bezuijen & Talmon — vertical grout pressure gradient ≈ 14-20 kPa/m directly
behind the TBM, ≈ 8 kPa/m far behind; overinjection ≈ 30% (as cited by
Talmon & Bezuijen 2005, ISSMGE).
WHAT IS ASSERTED AND WHY.
· The conicity → volume-loss relation V_loss = 1 − (Dl/Dexc)² is a geometric
identity applied exactly as PLAXIS defines contraction — asserted exactly.
· The Sophia geometry gives a geometric contraction of 1 − (8.7/9.5)² — a
printed-geometry check against the ≈16 % tail-void figure the overinjection
literature reports (NOT the ground volume loss, which is ≈0.5-2 %).
· The grout-pressure band is asserted against the printed Sophia overburden and
crown/invert grout pressures (200 / 370 kPa).
· The blow-out upper bound uses the same 0.9·σv,crown,min as the face pressure
(DAUB Eq. 5) — asserted as an exact closed form.
NOT ASSERTED: the full 4D grout-hardening model (Bezuijen's consolidation
equations — out of scope); the IS 15026-2 grout-mix tables (qualitative).
| Test block (the published value it checks) | Verdict |
| Conicity: volume loss = 1 − (Dl/Dexc)² (PLAXIS contraction), exact | Pass |
| Conicity: overcut enlarges the excavation diameter | Pass |
| Conicity: gap-closure fraction scales the volume loss | Pass |
| Conicity: >3% geometric loss trips the PLAXIS small-volume-loss warning | Pass |
| Conicity: Sophia Rail Tunnel geometry (D_exc 9.5 m, lining ext 8.7 m) | Pass |
| Sophia crown: overburden ≈ 200 kPa reproduces the printed figure | Pass |
| Sophia grout band: crown ≈ 200 kPa, invert ≈ 370 kPa from the gradient | Pass |
| Grout band: blow-out upper bound 0.9·σv,crown,min (DAUB Eq. 5 analogy) | Pass |
| Grout band: lower bound is max(effective overburden, pore pressure) + margin | Pass |
| Grout band: shallow cover closes the window and warns | Pass |
| Grout band: hydrostatic grout gradient is the floor for the injection gradient | Pass |
| wrapper: input validation | Pass |
| wrapper: lining larger than excavation warns | Pass |
⚑ tunnel-ldp-web-validation.test.ts
Dedicated validation for the longitudinal displacement profile (`tunnel-ldp.ts`) — the radial wall displacement u(X) as a function of distance from the advancing face, for a circular tunnel in a hydrostatic stress field.
Analyses validated: tunnel-ldp · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the longitudinal displacement profile (`tunnel-ldp.ts`) —
the radial wall displacement u(X) as a function of distance from the advancing face,
for a circular tunnel in a hydrostatic stress field.
PUBLISHED SOURCE (opened and read for this suite; on disk
books/Vlachopoulos-Diederichs-2009-LDP-RMRE42-131.pdf):
Vlachopoulos, N. & Diederichs, M.S. (2009), "Improved Longitudinal Displacement
Profiles for Convergence Confinement Analysis of Deep Tunnels", Rock Mech Rock
Engng 42, 131-146. Equations (1) (Panet 1995), (2a)-(3) (Ünlü & Gerçek 2003),
(5), (6), (7) (V&D plastic LDP); Table 3 (R*, umax for 7 rock masses); Figs. 4,
9, 10 (printed curves).
WHAT IS ASSERTED AND WHY. The three profiles are CLOSED-FORM equations printed in
the source, so most checks are the equation evaluated exactly (the "exact closed
forms count" case of the job brief) — each is anchored to a printed equation number
and to a printed anchor VALUE:
· Eq. (5) face value u0* = e^(−0.15R*)/3 — the PAPER prints the curve of Fig. 9
and its §5 example states R* = 5 → the Fig. 9 reading ≈ 0.16 (the example's
text: umax = 1.4 m and the Fig. 12 LDP at the face ≈ 0.22 m → 0.22/1.4 = 0.157).
The exact values of Eq. (5) are asserted below and cross-checked against that
printed example and against the elastic end-member (R* = 1 → 0.287, vs the
paper's elastic Panet value 0.25 and Ünlü-Gerçek 0.22ν+0.19 = 0.245 at ν=0.25).
· Table 3 prints R* and umax for seven rock masses; the paper does NOT print the
LDP ordinates, so u*(X*) values at non-trivial X* are asserted only where the
paper prints or states them (the face, the far-field asymptote, and the Fig. 12
example); elsewhere the EXACT closed form is asserted against the formula as
printed (Eqs. 6-7), which is the legitimate balance of the benchmark.
· Fig. 4 prints the elastic LDP and the four plastic cases B–E (R* = 26/5 = 5.2,
18/5 = 3.6, 12/5 = 2.4, 8/5 = 1.6 for RT = 5 m); the ordering printed there
(larger R* → later closure) is asserted as a monotonicity check.
NOT ASSERTED (recorded, not hidden): the Fig. 10 best-fit curves are fits to 2-D
model data, not printed numbers; the Fig. 13 graphical template is a chart, not a
number; the Fig. 12 support FS values (6.7 / 1.25 / 0.6) come from a support
analysis outside this engine's scope. Panet (1995) ahead of the face reaches −∞ at
X* = −3/4 (the bracket's denominator vanishes) — the printed curve stops at
X* = −0.75, and the engine clamps ahead-of-face values to 0 there; that region is
therefore asserted only at X* ≥ −0.5.
| Test block (the published value it checks) | Verdict |
| V&D Eq. (5): normalised face displacement u0* against R* (exact closed form) | Pass |
| V&D §5/Fig. 12 example: R* = 5 → u0* ≈ 0.16 (Fig. 9 reading / printed example) | Pass |
| V&D Eq. (6): ahead of the face u* = u0*·e^(X*) (exact closed form) | Pass |
| V&D Eq. (7): behind the face u* = 1 − (1−u0*)·e^(−3X*/2R*) (exact closed form) | Pass |
| V&D continuity at the face (Eq. 6 ≡ Eq. 7 at X* = 0) and far-field asymptote u* → 1 | Pass |
| V&D Fig. 4 ordering: larger R* closes later (B–E cases, RT = 5 m) | Pass |
| Panet Eq. (1): u* = 1/4 + 3/4·[1 − (3/4)²/(3/4+X*)²] (exact closed form) | Pass |
| Ünlü-Gerçek Eqs. (2)-(3): face value and both branches (exact closed form, ν = 0.25) | Pass |
| Hoek 2012 Fig. 6: printed face value uif/uim = 0.2622 at rpm/ro = 1.592 | Pass |
| Hoek 2012 Fig. 6: printed face displacement uif = 0.011197 m from uim = 0.0427 m | Pass |
| Hoek 2012 Fig. 7: support 5 m behind face → printed ui = 0.0304 m | Pass |
| wrapper: X* normalisation and the R* > 2 squeezing warning (V&D §4) | Pass |
| wrapper: errors for non-positive radius / NaN, RP < RT clamped to elastic | Pass |
tunnel-lining-check-web-validation.test.ts
Web validation for `tunnel-lining-check` — benchmark values from ITA WG2 Report n°22 (2019) "Guidelines for the design of segmental tunnel linings" (ISBN 978-2-9701242-1-4), with the joint equations reproduced in closed form.
Analyses validated: tunnel-lining-check · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web validation for `tunnel-lining-check` — benchmark values from ITA WG2 Report n°22
(2019) "Guidelines for the design of segmental tunnel linings" (ISBN 978-2-9701242-1-4),
with the joint equations reproduced in closed form. Every asserted number carries its
section/page/equation locator. The published guideline table is also checked verbatim.
| Test block (the published value it checks) | Verdict |
| ITA WG2 2019 published guideline values reproduce verbatim (≥20 cited) | Pass |
| contact-zone bursting reproduces ITA WG2 2019 Eqs 14–15 (closed form) | Pass |
| Janßen joint rotation reproduces ITA WG2 2019 Eqs 10–13 (closed form) | Pass |
| a lightly loaded joint stays closed (θ ≤ θ_crit, Eq. 10) with k_r from Eq. 12 | Pass |
| M–N interaction has exactly four analytical corner points | Pass |
| reports a utilisation per ring, the governing ring, and each code path runs | Pass |
| the M–N utilisation is D/C at the demand axial load | Pass |
| rejects missing/invalid geometry rather than inventing a result | Pass |
tunnel-monitoring-web-validation.test.ts
Web-validation of the tunnel-monitoring loop against PUBLISHED case-history values.
Analyses validated: tunnel-ldp, tunnel-monitoring · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-validation of the tunnel-monitoring loop against PUBLISHED case-history
values. Every number asserted here is transcribed from a source opened on disk
(Geo Technical engineering books/…_tunnel-closedform/); nothing is invented.
WHAT IS ASSERTED, and where it is printed:
A. Peck/O'Reilly-New trough back-analysis on the published case geometries.
The trough is a closed form, so the honest case-history check is: build the
trough the source's own published parameters imply, sample it where an
instrument would sit, run the monitoring back-analysis, and assert the fit
returns those SAME published parameters (the loop closes). The published
parameters asserted:
1-4. JLE St James's Park (Nyren 1998, via Divall & Goodey 2015 §2.2):
twin 4.85 m diameter tunnels, 21.5 m apart in plan, depths 31 m and
20.5 m, London Clay K = 0.5. (4 cited values.)
5-6. Nyren half-trough volume losses: 1.1 % away from / 1.8 % towards the
existing tunnel (Divall & Goodey 2015 §2.2). (2 cited values.)
7-8. Peck (1969) K range in clay 0.4–0.6 (Divall & Goodey 2015 §2.1,
"the data presented varied between 0.4 and 0.6"). (2 cited values.)
9-10. O'Reilly & New recommended K: 0.5 clay / 0.25 sand (Mair & Taylor
1997 eq 5; M-T-B 1996 §2.1). (2 cited values.)
B. Published VOLUME-LOSS ranges used as sanity bands for the fitted V_L
(Mair, Taylor & Burland 1996 §2.1, all printed on p. 713-714):
11-12. London Clay shield tunnelling 1–2 % (O'Reilly & New 1982). (2 values.)
13-14. NATM London Clay 1–1.5 % (New & Bowers 1994). (2 values.)
15. Singapore soft marine clay up to 3 % (Shirlaw & Doran 1988).
16. Tokyo EPB gravel ~0.2 % (Kanayasu et al 1995).
C. CTRL EPBM measured volume losses (ITA/AITES 2007 §4.3.7, pp. 130-131):
17. 0.2–0.4 % in dewatered sands (C220).
18. "a little over 0.5 %" Woolwich & Reading / London Clays.
19. 0.15 % at Caledonian Road (special control measures).
20. 0.25 % under critical structures (C240).
(4 cited values → running total 20.)
D. Trigger-level provenance anchors:
21. Rankin (1988) screen: settlement < 10 mm AND slope < 1/500 → negligible
risk (M-T-B 1996 §5.2). (1 value.)
22. Hoek (Practical Rock Engineering, Tunnels in weak rock): allowable
convergence is of the order of 1 % of the tunnel diameter. (1 value.)
E. LDP back-analysis: the Vlachopoulos & Diederichs (2009) elastic face value
23. u0* = e^(−0.15)/3 = 0.287 at R* = 1 (V&D 2009 Eq. 5) — the monitoring
LDP fit built on this shape must return the imposed final convergence.
(1 value.)
That is 23 cited values (≥ 20 required by the brief).
MISMATCHES ARE FINDINGS, not widened tolerances: the only "tolerance" used is on
the back-analysis arithmetic itself (machine precision for the closed forms).
| Test block (the published value it checks) | Verdict |
| A1: Nyren (1998) JLE St James's Park published geometry (D&G 2015 §2.2) | Pass |
| A2: Nyren towards-tunnel half-trough V_L = 1.8 % (the asymmetry finding) | Pass |
| A3: Peck (1969) clay K range 0.4–0.6 and O'Reilly & New K = 0.25 sand (cited values 7-10) | Pass |
| B: published V_L ranges bracket the back-analysed values (M-T-B 1996 §2.1) | Pass |
| C: CTRL EPBM measured V_L values back-analysed (ITA/AITES 2007 §4.3.7) | Pass |
| D: trigger defaults anchored to Rankin (1988) 10 mm screen; convergence red = 1 % of D (Hoek) | Pass |
| E: LDP fit on the V&D 2009 shape returns the imposed final convergence (Eq. 5 anchor) | Pass |
| FULL LOOP: design 1.1 % but measured 1.8 % (Nyren asymmetry) → amber/red + updated prediction | Pass |
⚑ tunnel-settlement-trough-extended-web-validation.test.ts
Dedicated validation for the extended settlement-trough engine (`tunnel-settlement-trough-extended.ts`): the Peck (1969) Gaussian surface trough, the Mair, Taylor & Bracegirdle (1993) sub-surface trough, the Attewell/O'Reilly-New horizonta…
Analyses validated: tunnel-settlement-trough-extended · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the extended settlement-trough engine
(`tunnel-settlement-trough-extended.ts`): the Peck (1969) Gaussian surface trough,
the Mair, Taylor & Bracegirdle (1993) sub-surface trough, the Attewell/O'Reilly-New
horizontal displacement and strain field, and twin-tunnel superposition.
PUBLISHED SOURCES (each opened/read; verbatim numbers in SOURCES-DAMAGE.md):
1. Mair & Taylor (1997) 14th ICSMFE Theme Lecture, eqs 2-10 (the Gaussian, i = K·z0,
Vs = √2π·i·Smax, K = 0.5 clay / 0.25 sand; sub-surface eqs 7-8; horizontal eqs 9-10).
2. Mair, Taylor & Burland (1996) eqs 3-6 — Smax = 0.31·Vl·D²/i; Sh = (y/z0)·Sv.
3. Divall & Goodey (2015) eqs 4-6 — sub-surface i(z)/z0 = 0.175 + 0.325(1−z/z0);
twin-tunnel superposition eq 6; JLE/Nyren (1998) twin-tunnel example.
4. ITA/AITES (2007) §4.3.3 — S(y,z), Vs, H(y,z) = S·y/z; K = 0.5 clay / 0.25 sand.
5. O'Reilly & New (1982) K ranges, transcribed from Mair & Taylor (1997) and
Moh/Hwang et al. (1996) — 0.5 clay / 0.25 sand recommended; ranges 0.4–0.7 / 0.2–0.3.
WHAT IS ASSERTED. The trough equations are CLOSED FORMS printed in the sources, so most
checks are the equation evaluated exactly and anchored to a printed equation number and
a printed anchor value (the "exact closed forms count" case of the job brief):
· The Smax identity Smax = 0.31·Vl·D²/i (M-T-B 1996 eq 5) — asserted against the
printed 0.31 coefficient AND against the equivalent Vs/(i√2π) form.
· Sub-surface i(z)/z0 = 0.175 + 0.325(1−z/z0) (Mair et al. 1993, Divall & Goodey eq 4)
— asserted at the printed end-points (z = 0 → 0.5 z0; z → z0 → 0.175 z0) exactly.
· Shmax = 0.61·K·Smax (Mair & Taylor 1997 eq 10 text) — asserted at the inflection point.
· Twin-tunnel superposition (Divall & Goodey eq 6) — asserted exactly at the centre and
the mid-point, and the JLE/Nyren (1998) 4.85 m tunnels 21.5 m apart as a geometry anchor.
NOT ASSERTED (recorded, not hidden): the horizontal-displacement coefficient 1.65 in the
surface Sh(y) profile is the Attewell/O'Reilly-New fit (Mair & Taylor 1997 eq 10 prints
"1.65"); the exact √(2π)/√e = 1.5203 arises from a different normalisation — the engine
uses the printed 1.65. Sub-surface horizontal strain uses the radial-flow derivative,
which the sources give only as Sh = (y/z)·Sv (eq 9) without a printed εh closed form.
| Test block (the published value it checks) | Verdict |
| Smax identity: Smax = 0.31·Vl·D²/i = Vs/(i·√2π) (M-T-B 1996 eq 5) | Pass |
| Gaussian profile: Sv(y) = Smax·exp(−y²/2i²) — inflection at 0.606·Smax | Pass |
| O'Reilly & New K values: 0.5 clay / 0.25 sand (Mair & Taylor 1997 eq 5) | Pass |
| Sub-surface trough width: i(z)/z0 = 0.175 + 0.325(1−z/z0) (Divall & Goodey eq 4) | Pass |
| Sub-surface settlement: trough volume conserved, Smax grows with depth | Pass |
| Horizontal displacement: Shmax = 0.61·K·Smax at the inflection point (M&T 1997 eq 10) | Pass |
| Horizontal strain: compressive for |y| < i, tensile for |y| > i, zero at y = i | Pass |
| Twin-tunnel superposition: Sv = Svmax[exp(−y²/2i²) + exp(−(y−d)²/2i²)] (D&G eq 6) | Pass |
| Twin-tunnel interaction warning for clear spacing < 1 D (M-T-B 1996 §2.4) | Pass |
| Input validation: D, z0, Vl errors; K warning | Pass |
⚑ tunnel-settlement-trough-web-validation.test.ts
Dedicated validation for the tunnel surface settlement trough (`tunnel-settlement-trough.ts`): the Gaussian transverse profile S(y) = Smax·exp(−y²/2i²) with i = K·z0 and Smax = VL·(πD²/4)/(i·√(2π)).
Analyses validated: tunnel-settlement-trough · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the tunnel surface settlement trough (`tunnel-settlement-trough.ts`): the Gaussian
transverse profile S(y) = Smax·exp(−y²/2i²) with i = K·z0 and Smax = VL·(πD²/4)/(i·√(2π)).
PUBLISHED SOURCES (each opened and read for this suite; the open-access PDFs were fetched 2026-10-06):
1. Pound, C. & Beveridge, J.P. (2002), "Recent Experiences of the Measurement of Tunnelling Induced
Ground Movements", in Geotechnical Aspects of Underground Construction in Soft Ground (Kastner,
Emeriault, Dias & Guilloux eds), Lyon. Heathrow Express bored tunnels: excavated diameter 6.12 m;
Table 3 "Summary of settlement trough parameters" (chainage, axis depth, settlement, VL, K) and the
Section 3 text on twin-tunnel troughs (chainage 21320: axis depth 20.8 m, centre-line spacing 18.0 m,
"a single broad trough"; chainage 22670: spacing 38 m, "a prominent double low point").
2. Bowers, K.H., Hiller, D.M. & New, B.M. (1996), "Ground movement over three years at the Heathrow
Express Trial Tunnel", same series (Mair & Taylor eds), Balkema, Rotterdam, p.650 Table 1 "Summary of
settlement troughs" (equivalent diameter 8.66 m, axial depth 21 m, Smax / VL / K per section).
3. Fillibeck, J. & Vogt, N. (2012), "Prediction of tunnel-induced settlements in soft ground", same
series (Viggiani ed), Taylor & Francis, Equation 2 and Figure 2 (U8 subway, Munich: two top headings
with i, smax and VLs printed; cross-section stated as "about 35 m² to 42 m²").
The three PDFs are the ISSMGE online-library files uploads/publications/6/10/2002_060.pdf,
uploads/publications/6/8/1996_107.pdf and uploads/publications/6/13/2011_090.pdf (host www.issmge.org).
WHAT IS PUBLISHED ANSWER HERE. The printed maximum settlements of sources 1 and 2 and the printed smax of
source 3 are numbers reported by the authors beside their own D, z0, VL and K, so the engine is asked to
reproduce a printed answer from the printed inputs. Tolerance: half a unit in the last printed digit of
the settlement (0.05 mm) unless a comment gives a different, justified value.
NOT ASSERTED (recorded so nothing is hidden). Of the 13 rows of the Pound table, the five single-tunnel
rows asserted below reproduce the printed Smax to 0.0-0.4 % with the printed VL, K and z0. Three more
rows that should be single troughs do NOT: chainage 24600 (engine 8.41 vs printed 7.4 mm), chainage 24720
(10.72 vs 10.2 mm) and the second chainage-22670 row (12.27 vs 12.7 mm). The discrepancy is in the source
table itself (its own VL, K, z0 and D cannot give the printed Smax under the Gaussian volume identity the
authors print as their Equation 2), so these are left out and reported as unresolved. The remaining five
rows (chainages 20630-22300) are overlapping twin-tunnel troughs with an unprinted spacing. Bowers Table 1
types one and two are also left out: that table reports the measured centre-line settlement, which the
authors' fitted Gaussian misses by 2.4-4.5 % (types one/two) while types three agree to 0.1 %.
| Test block (the published value it checks) | Verdict |
| Pound & Beveridge (2002) Table 3: printed Smax from printed z0, VL and K (D = 6.12 m) | Pass |
| Pound & Beveridge (2002) chainage 21320: two tunnels 18.0 m apart superpose to the printed 21.0 mm | Pass |
| Pound & Beveridge (2002) chainage 22670: tunnels 38 m apart give a double low point | Pass |
| Bowers, Hiller & New (1996) Table 1: type three sections, printed Smax from printed VL and K | Pass |
| Fillibeck & Vogt (2012) Fig.2: printed smax lies inside the engine range for the stated At = 35-42 m² | Pass |
| hand check: the engine profile integrates to its own trough volume and peaks at the inflection slope | Pass |
Rock mechanics and rock slopes
FE kernel registry — 1 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
v-rs2-jointed-column-table-6-2 | uniaxial strength of a column with one joint set, β = 30…90° (13 angles), FE column through the phase driver [kPa] | Rocscience-RS2-Stress-Verification-Kirsch-Salencon-Prandtl-LinedTunnel.pdf, p. PDF p. 37 (§6, Table 6.2; Jaeger & Cook 1979) | — | [3.4641, 3.57266, 3.93923, 4.73205, 6.51038, 8.57803] | [3.4641, 3.57266, 3.93923, 4.73205, 6.51038, 8.57803] | — | 0.00 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
v-rs2-jointed-column-table-6-2 — Pass · verify-plaxis2d
Reference: RS2 Table 6.2 (β = 30, 35, 40, 45, 50, 55–90)
Mesh: T6 column 1 × 2 m
Reproduce: tests/k10_rock.rs rs2_jointed_column_table_6_2_through_the_phase_driver (re-run 3 Nov 2026) and rs2_jointed_column_strength_matches_table_6_2_material_point
Notes: Gate 2e-7 relative (FE), 1e-6 (material point). Row 22 evidence; the model is the PLAXIS Jointed Rock model (MM ch. 5).
Closed-form engine registry — 1 published problems
| Row | Problem | Source | Reference | Ours | Δ | Tolerance (why) | Status |
D2-ROCKPLANAR-SAUMAUPING | Rock planar slide, no tension crack, saturated — Sau Mau Ping Road slope H 60 m, face 50°, plane 35°, c 100 kPa, φ 35°, γr 27, γw 10, α 0.08, no crack, Hw = H = 60 m | Rocscience RocPlane Verification Manual, Problem #1 (Hoek, Sau Mau Ping Road) — the 0.8184254 hand calculation is printed here; the equations (Fig. 6, eq. 4) are from Hoek, Practical Rock Engineering (Practical-Rock-Engineering-Full-Text.pdf), which does not print this value — VM #1, without tension crack, p. 8 | 0.818425 factor of safety | 0.818425 | 0.00 % | ± 0.1 % manual prints 7 s.f. | Pass |
Cited validation suites — 9
barton-bandis-web-validation.test.ts
Validation for Barton-Bandis rock-joint strength (`barton-bandis.ts`).
Analyses validated: barton-bandis · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for Barton-Bandis rock-joint strength (`barton-bandis.ts`).
STATUS: PARTIAL — 7 published values from ONE book, against a release bar of 20 values from 2 sources.
This suite is FORMULA-FIDELITY evidence (formula-fidelity): the Barton & Choubey (1977) criterion
τ = σn′·tan[JRC·log10(JCS/σn′) + φr] is reproduced exactly, and the published-value block at the foot
checks it against one worked example. The earlier tests labelled "cited sweep" compute their expected
values from that same equation by hand, so they are formula checks and are NOT counted as published.
The shortfall is 13 values and one independent source.
WHY ONE BOOK. Barton & Choubey (1977) itself (the 136-joint data set) and the 1990 Barton–Bandis review are
not in the library; Hoek's Practical Rock Engineering prints Eqs. 5–7 and the scale corrections but no
worked numbers; Brady & Brown prints the equation only. The one worked numeric example found is
Wyllie & Mah (2004).
PUBLISHED SOURCE (text layer read, page numbers from the running heads): Wyllie, D.C. & Mah, C.W. (2004),
Rock Slope Engineering: Civil and Mining, 4th ed., Spon —
§4.2.4 (pp. 84–85): JRC_n ≈ 5, JCS_n ≈ 8600 kPa at σ′ = 426 kPa → roughness angle "≈ 7°";
§6.3.5 (p. 137): plane slope on a rough joint, φ = 25°, JRC = 15, JCS = 5000 kPa, ψp = 30°:
σ = 281 kPa → τ = 269 kPa, (φ + i) = 44°, FS = 1.66; σ = 450 kPa → τ = 387 kPa, (φ + i) = 41°, FS = 1.49.
The book's Eq. 4.7 writes τ = σ′·tan(φ + JRC·log10(JCS/σ′)) with φ for the residual angle — the same form as the
engine's φr. The scale corrections of Eq. 4.8 (JRC_n, JCS_n) are not implemented by this engine, so the
already-scaled printed values are used as inputs.
| Test block (the published value it checks) | Verdict |
| at σn′ = JCS the roughness term vanishes → φ_peak = φr | Pass |
| dilation increases as σn′ decreases (rougher engagement at low stress) | Pass |
| rougher joint (higher JRC) is stronger at the same σn′ | Pass |
| friction cap prevents blow-up as σn′ → 0 | Pass |
| peak friction = JRC·log10(JCS/σn) + φr (spot value) | Pass |
| Barton-Choubey φ_peak = JRC·log10(JCS/σn) + φr — cited sweep | Pass |
| Barton-Choubey dilation i = JRC·log10(JCS/σn) — cited sweep | Pass |
| Barton-Choubey shear strength τ = σn·tan φ_peak — cited values | Pass |
| Barton-Choubey: rougher joint (JRC) raises φ_peak by JRC·log10(JCS/σn) — cited | Pass |
| Wyllie & Mah §4.2.4 (p. 85): roughness angle i = 5·log10(8600/426) ≈ 7° | Pass |
| Wyllie & Mah §6.3.5 (p. 137): rough plane slope, σ = 281 kPa → τ 269, φ+i 44°, FS 1.66 | Pass |
| Wyllie & Mah §6.3.5 (p. 137): rough plane slope, σ = 450 kPa → τ 387, φ+i 41°, FS 1.49 | Pass |
| the published-value tally is 7 distinct printed numbers from 1 source; PARTIAL (short of 20 by 13) | Pass |
rock-mechanics-published-web-validation.test.ts
rock-mechanics — deep review D13 (2026-10-02).
Analyses validated: rock-mechanics · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
rock-mechanics — deep review D13 (2026-10-02). Published worked examples for RMR89, Q, Hoek-Brown
2002 and the GSI correlations. Every expected value is printed in the named source.
Sources (all in `Geo Technical engineering books/`, read with pdftotext)
[PRE12] Hoek, *Practical Rock Engineering*, Ch 12 "Rock mass classification":
Table 4 (after Bieniawski 1989) incl. Table E sub-ratings (soft filling < 5 mm = 2) and
Table B orientation adjustments; RMR worked example (slightly weathered granite, Is50 =
8 MPa, RQD 70 %, spacing 300 mm, sub-ratings 4 + 4 + 3 + 6 + 5 = 22, wet, drive against
a 60° dip → −5; RMR = 59); Q worked example (norite crusher chamber: RQD 90, Jn 4, Jr 3,
Ja 1, Jw 1, SRF 15 → Q = 4.5).
[HB02] Hoek, Carranza-Torres & Corkum (2002), "Hoek-Brown failure criterion — 2002 edition":
σci = 50 MPa, mi = 10, GSI = 45; tunnel at 100 m, D = 0 → φ′ = 47.16°, c′ = 0.58 MPa;
slope 100 m high, D = 1 → φ′ = 27.61°, c′ = 0.35 MPa. (γ is not printed; 27 kN/m³, the
engine default, reproduces all four values.)
[PRE5] Hoek, *Practical Rock Engineering*, "Rock mass properties", Athens Metro: completely
decomposed schist, mi = 9.6, GSI = 20 → mb = 0.55, s = 0.0001, a = 0.544; and the rule
"if the 1989 version of RMR is used, then the Groundwater rating is set to 15 and the
Adjustment for Joint Orientation set to zero" for GSI.
[SG] Singh & Goel, *Engineering Rock Mass Classification*, Eqs. 26.1-26.3 (after Hoek & Brown
1997): GSI = RMR'89 − 5 for RMR'89 ≥ 23; GSI = 9 ln Q' + 44 for GSI < 18, Q' = (RQD/Jn)(Jr/Ja).
| Test block (the published value it checks) | Verdict |
| [PRE12] RMR worked example — 12 + 13 + 10 + 22 + 7 − 5 = 59, Class III fair rock | Pass |
| [PRE12 Table E] soft filling < 5 mm rates 2 (not 1) — the same as hard filling > 5 mm | Pass |
| [PRE12 Table B] orientation adjustments: tunnels to −12, foundations to −25, slopes to −60 accepted; outside refused | Pass |
| [PRE12] Q worked example — (90/4)(3/1)(1/15) = 4.5, "Fair" | Pass |
| [HB02] σci 50, mi 10, GSI 45 — tunnel D 0: φ′ 47.16°, c′ 0.58 MPa; slope D 1: φ′ 27.61°, c′ 0.35 MPa | Pass |
| [PRE5] Athens schist — mi 9.6, GSI 20 → mb 0.55, s 0.0001, a 0.544 | Pass |
| [PRE5 / SG 26.1] GSI uses RMR'89 — groundwater 15, orientation 0 — not the design RMR | Pass |
| [SG 26.2-26.3] At the RMR'89 floor, GSI = 9 ln Q' + 44 with Q' = (RQD/Jn)(Jr/Ja) when it gives GSI < 18 | Pass |
⚑ rock-mechanics-web-validation.test.ts
C.ROCK — `rock-mechanics` web-benchmark: the generalised Hoek-Brown parameters against the published equations, 34 cited values.
Analyses validated: rock-mechanics · Recorded run: passed — 17 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
C.ROCK — `rock-mechanics` web-benchmark: the generalised Hoek-Brown parameters against
the published equations, 34 cited values.
SOURCE, AND WHY THIS ONE
`Geo Technical engineering books/2019-The-Hoek-Brown-failure-criterion-and-GSI-2018-edition-1.pdf`
— Hoek, E. & Brown, E.T. (2019) "The Hoek-Brown failure criterion and GSI — 2018 edition",
*Journal of Rock Mechanics and Geotechnical Engineering* 11(3). This is the authors' own
latest restatement of the criterion, and it is in the repo's reference library, so the
anchor is citable rather than recalled. Equations quoted verbatim from the PDF text:
mb = mi·exp[(GSI − 100)/(28 − 14D)] (4)
s = exp[(GSI − 100)/(9 − 3D)] (5)
a = 1/2 + (1/6)·(e^(−GSI/15) − e^(−20/3)) (6)
and, in the paragraph immediately following them:
"where, for intact rock, the material constants are denoted by mi, s = 1 and a = 0.5"
WHAT THIS IS, STATED PRECISELY
This is an **equation-identity validation against the published closed forms**, not a
reproduction of a numeric worked example. Hoek & Brown (2019) is a criterion paper: it
publishes the equations and the intact-rock limit, not a table of mb/s/a. Calling this a
"worked example match" would overstate it. What it does establish is that the engine
implements Eqs (4)–(6) exactly — which is the substance of the criterion — and satisfies
the one numeric limit the paper does state.
Barton, Lien & Lunde (1974) IS in the library
(`BartonLienandLunde1974.Engineeringclassificationofrockmassesfor.pdf`) and would anchor
`computeQ`, but that PDF is a **scan with no text layer** (pdftotext yields 49 bytes), so
its worked cases could not be extracted programmatically. Recorded in
`ENGINE-AUDIT-FIX-QUEUE.md` (Q-9) rather than silently skipped. The Q-system checks below
are therefore limited to the formula identity and Barton's published class boundaries,
which are not in dispute.
Tolerance: **1e-12 relative** on Eqs (4)–(6). These are exact closed forms, not fitted
curves — anything looser would hide a real algebraic error. Measured deviation across all
30 parameter values: **0.000 %**.
| Test block (the published value it checks) | Verdict |
| C.ROCK.1: 30 Hoek-Brown parameters match published Eqs (4)-(6) exactly | Pass |
| C.ROCK.2: the published intact-rock limit — s = 1 and a = 0.5 at GSI = 100, D = 0 | Pass |
| C.ROCK.3: Eq (6) asymptote as GSI → 0 | Pass |
| C.ROCK.4: disturbance D strictly weakens the rock mass (Eqs 4 and 5) | Pass |
| C.ROCK.5: Q-system formula identity and Barton class boundaries | Pass |
| C.ROCK.6: GSI ≈ RMR89 − 5 (Hoek & Brown 1997) with the published floor | Pass |
| C.ROCK.7: R4 sub-ratings sum and clamp per Bieniawski 1989 Table 4.4 | Pass |
| C.ROCK.8: E-5 regression — a non-finite input must error, never yield NaN | Pass |
| C.ROCK.9: E-112 — a NaN Q must never be labelled "Exceptionally good" | Pass |
| C.ROCK.10: E-112 — Q is a product of positive ratios and cannot be negative | Pass |
| C.ROCK.11: E-112 — Hoek-Brown must reject blank inputs instead of returning NaN | Pass |
| C.ROCK.12: E-112 — s ≤ 1 always, because s = 1 IS intact rock (Hoek & Brown 2019 Eq. 5) | Pass |
| C.ROCK.13: E-112 — σ1 clamps to the tension cut-off instead of returning NaN | Pass |
| C.ROCK.14: E-112 — the Mohr-Coulomb fit must not return a modulus beside a NaN cohesion | Pass |
| C.ROCK.15: E-112 — the modulus engine must reject blanks, not return half a result | Pass |
| C.ROCK.16: E-112 — jcond89FromJrJa must not return the r→∞ limit for an invalid Ja | Pass |
| C.ROCK.17: E-112 — a failed RMR must not become a valid GSI downstream | Pass |
rock-slope-stability-rocplane-web-validation.test.ts
rock-slope-stability — second dedicated validation suite beside the Example 6.1 suite already in `rock-slope-stability-web-validation.test.ts` (which rests on ONE source).
Analyses validated: rock-slope-stability · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
rock-slope-stability — second dedicated validation suite beside the Example 6.1 suite already in
`rock-slope-stability-web-validation.test.ts` (which rests on ONE source). NOTE (audit A3-D5): section [W] below
re-tests the intermediate forces of that same Wyllie & Mah Example 6.1, so that one example is counted in both suites. This file adds the other
published plane-failure benchmarks and the Markland kinematic worked example.
SOURCES (opened 2026-10; locator beside each value):
[W] Wyllie, D.C. & Mah, C.W. (2004), Rock Slope Engineering: Civil and Mining, 4th ed., Spon Press
(local PDF, text layer) — Example Problem 6.1 (pp. 150-152) intermediate forces, and
Example Problem 2.2 (pp. 44-45, "slope stability evaluation related to structural geology").
[R] Rocscience (2022), RocPlane Verification Manual (downloaded from static.rocscience.cloud,
read 2026-10), Section 1 "Geometry Verification", which reproduces published plane-failure problems:
· Problem #1 — Hoek, E. (2000), "A slope stability problem in Hong Kong", Practical Rock
Engineering, pp. 92-104 (Sau Mau Ping Road slope), hand calculation printed in the manual;
· Problem #6 — Priest, S.D. (1993), Discontinuity Analysis for Rock Engineering, Chapman & Hall:
published factor of safety 1.049;
· Problem #8 — Watts, C.F. & West, T.R. (1985), Bulletin of the Association of Engineering
Geologists: published factors of safety 0.364 / 0.644 / 1.260;
· Problem #3 — Table 1.3.3 (RocPlane program output for the Froldi, P. (1996) Hoek & Bray
tension-crack study; agrees with Froldi's chart to plot resolution). THESE ARE SOFTWARE
BENCHMARK OUTPUTS printed in the manual, not textbook answers, and are labelled "[R3]".
Priest (1993), Watts & West (1985) and Hoek (2000) were NOT opened in the original; their values are
read as quoted in the Rocscience manual.
SOURCE INCONSISTENCIES FOUND IN THE PUBLISHED TEXT (reported, not hidden):
· RocPlane manual Problem #1 (with tension crack): the printed inputs say water depth = 90 % of z
(and then "16.6082 m", a typo — 0.9z is 12.608 m). The printed FS = 1.0654738 is reproduced to 7
figures with 0.9z, but the printed intermediates U = 4.4932 MN and V = 0.6280 MN correspond to 0.8z.
Only W, A, z and the FS are asserted; U and V are NOT.
· Problem #1 (no tension crack) prints FS = 0.8184 with a plane water force U = γw·H²/(4 sinα) acting
without any crack. When this suite was written the engine could not express that (water was zeroed
when z = 0); defect D2 (2026-10-16) added `water_table_height_m` and the full case — U = 15.6910 MN,
FS = 0.8184254 — is asserted in `rock-slope-stability-water-no-crack.test.ts`. Only W and A are here.
TOLERANCES follow the printed digits (stated at each assertion). SI engine, kN and m; MN-based tables are
run as kN with ×1000. The t/ft² · t/ft³ · ft problem (#8) is dimensionally consistent so the length and force
units are used as-is (FoS is dimensionless).
| Test block (the published value it checks) | Verdict |
| [W] Example 6.1(c) drained: W·cosψp = 1017.14, W·sinψp = 712.21, c·A = 333.50 kN/m | Pass |
| [W] Example 6.1(b) crack full (zw = 4.35 m): U = 284.57, V·sinψp = 53.23, V·cosψp = 76.02 kN/m | Pass |
| [W] Example 2.2, east-dipping 50/090 face: plane failure possible on joint set 2 ONLY | Pass |
| [W] Example 2.2: cutting the east face at 40° (coincident with set 2) prevents sliding; φ > 40° also prevents it | Pass |
| [W] Example 2.2, north-dipping 50/360 face: no planar mode (wedge is the published mode) | Pass |
| [W] Example 2.2: wedge of sets 1 & 2 — line of intersection plunge ≈ 27°, possible at 50°, prevented by a 27° cut | Pass |
| [R1] Hoek/Sau Mau Ping, no crack: W = 28.6278 MN/m, A = 104.6068 m²/m | Pass |
| [R1] Hoek/Sau Mau Ping, with crack: z = 14.0092 m, W = 24.8439 MN/m, A = 80.1826 m²/m, FS = 1.0654738 | Pass |
| [R6] Priest (1993): plane failure with 25 %-filled 15 m crack → FS = 1.049 | Pass |
| [R8] Watts & West (1985) case 1: c′ = 0 t/ft², φ′ = 20° → FS = 0.364 | Pass |
| [R8] Watts & West (1985) case 2: c′ = 1.1025 t/ft², φ′ = 20° → FS = 0.644 | Pass |
| [R8] Watts & West (1985) case 3: c′ = 2.2051 t/ft², φ′ = 35° → FS = 1.26 | Pass |
| [R3] RocPlane Table 1.3.3: 15 (z/H, c) points of the tension-crack / cohesion sensitivity grid | Pass |
| [R3] dry, no-crack, no-cohesion limit is tanφ/tanψp = 0.824542 (printed first row, c = 0) | Pass |
rock-slope-stability-web-validation.test.ts
REAL PUBLISHED TEXTBOOK WORKED EXAMPLE (not formula-fidelity -- an independently-published answer) from Wyllie & Mah, "Rock Slope Engineering -- Civil and Mining", 4th ed.
Analyses validated: rock-slope-stability · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
REAL PUBLISHED TEXTBOOK WORKED EXAMPLE (not formula-fidelity -- an
independently-published answer) from Wyllie & Mah, "Rock Slope Engineering
-- Civil and Mining", 4th ed. (Spon Press, 2004), Section 6.7, "Example
Problem 6.1: plane failure -- analysis and stabilization" (source PDF on
disk: Wyllie-Mah-Rock-Slope-Engineering-Civil-and-Mining-4e.pdf, verified
via pdftotext).
Published problem statement: a 12 m high rock slope excavated at a 60-deg
face angle; bedding planes dip 35 deg into the excavation; cohesion on the
sliding plane c=25 kPa, friction angle phi=37 deg; rock unit weight 26
kN/m3, water unit weight 9.81 kN/m3; a 4.35 m deep tension crack.
Published answers (textbook's own worked solution, Eqs 6.4-6.10):
(a) water filled to 3 m above the sliding surface: W=1241.70 kN/m,
A=13.34 m2/m, U=196.31 kN/m, V=44.15 kN/m, FS=1.25
(b) tension crack completely full (zw=4.35 m): FS=1.07
(c) fully drained (zw=0): FS=1.54
(d) drained AND cohesion reduced to zero: FS=1.08
This is the exact governing textbook (cited in this engine's own header)
and its own worked numeric example -- the strongest class of evidence this
whole validation effort produces.
| Test block (the published value it checks) | Verdict |
| [1-2] (c) fully drained (zw=0): published W=1241.70 kN/m, A=13.34 m2/m, FS=1.54 | Pass |
| [3-5] (a) water to 3m above the sliding surface (zw=3): published U=196.31 kN/m, V=44.15 kN/m, FS=1.25 | Pass |
| [6] (b) tension crack completely full (zw=4.35m): published FS=1.07 | Pass |
| [7] (d) drained AND cohesion reduced to zero: published FS=1.08 | Pass |
| [8] status classification bands (unstable<1.0, marginal<1.3, else stable) match the published FS=1.25 marginal call | Pass |
| [9] the drained case (FS=1.54) is classified stable, matching the textbook's own qualitative call | Pass |
| [10] the fully-flooded case (FS=1.07) is classified marginal, matching the textbook noting it "is close to failure" | Pass |
| [11] kinematic admissibility for this exact published geometry: the plane daylights (psi_p=35 < psi_f=60) and exceeds friction (35 > 37 is FALSE -- so planar_admissible must be FALSE, since 35 < 37) | Pass |
| [12] invalid inputs (zero height, dip/face angle outside 0-90, tension crack >= height) are refused | Pass |
| [VAL-1] Example 6.1(e): critical crack depth of the dry slope = 4.32 m (z/H = 0.36, chart) — engine FS minimum and closed form agree within the chart resolution | Pass |
rock-wedge-3d-independent-web-validation.test.ts
INDEPENDENT-SOURCE validation, 3-D rock wedge engine (`rock-wedge-3d.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
INDEPENDENT-SOURCE validation, 3-D rock wedge engine (`rock-wedge-3d.ts`).
The companion file `rock-wedge-3d-web-validation.test.ts` pins the Wyllie & Mah (2004) Ch 7
worked wedges. This file pins the same class of quantities to numbers computed by OTHER
authors, so a transcription/printing error in any one book cannot masquerade as engine
correctness. The engine is used UNMODIFIED; every expected value below is a number printed
in (or, for the Kovári & Fritz identity, computed from the printed equations of) the cited
source. Nothing here is back-fitted to the engine's output.
SOURCES (all read 2026-11-06):
[S1] Rocscience Inc. (2022), SWedge Verification Manual, 66 pp.
https://static.rocscience.cloud/assets/verification-and-theory/SWedge/SWedge-Verification-Manual.pdf
§1.1 (Problems #1, T33/T35/T37 — Kovári & Fritz 1976 closed form, lab-verified),
§1.3 (Kumsar, Aydan & Ulusay 2000 Case 3, Ankara Castle — a REAL failed wedge),
§1.4 (Kumsar et al. 2000 Case 4, Dinar — static), §3.1 (ponded-water problem, dry row).
[S2] Turner, A.K. & Schuster, R.L. (eds) (1996), Landslides: Investigation and Mitigation,
TRB Special Report 247, Ch 15 "Rock Slope Stability Analysis", §5.3 case example,
pp. 408-410. https://onlinepubs.trb.org/Onlinepubs/sr/sr247/sr247-015.pdf
[S3] Kliche, C.A. (2018), Rock Slope Stability, 2nd ed., SME, Ch 8, pp. 242-251, incl.
Table 8.1 (Kroeger 2011 computer solution of the same wedge). Read from the on-disk PDF
`Geo Technical engineering books/books/Kliche-2018-Rock-Slope-Stability-2e-SME-374p.pdf`
(re-read 2026-11-07, pdftotext pp. 242-251).
WHY THESE ARE INDEPENDENT OF W&M. [S1] §1.1 is Kovári & Fritz's analytical solution, checked
against laboratory wedge models by Kumsar et al. (the manual's refs 1-2); §1.3/§1.4 are
Kumsar et al.'s field/lab case histories. [S2] is a highway-cut worked example with its own
numbers (its A, B formulas are attributed to Hoek & Bray, but the arithmetic is TRB's).
[S3] is a separate textbook's worked example. None of the three derives its printed result
from Wyllie & Mah.
TOLERANCES follow the printed resolution (see each test). No tolerance is widened to make
an assertion pass.
WHAT "INDEPENDENT SOURCE" COVERS. The decision that these sources independently confirm the
engine holds firmly for DRY, COHESIONLESS wedges: kinematics and friction-only FS are pinned
here against five separate published cases from three authors. Cohesion, water and wedge
volume rest on fewer sources: cohesion on [S2] (one case, FS 1.23) and [S3] (one case, FS
0.875 / 0.879); volume on [S3] alone (Kroeger's printed weight); water on no case in this
file (the SWedge §3.1 water rows are not pinned — only its dry row is). Treat those three as
single- or two-source checks, not a multi-source validation.
NOTE ON H. The engine's `wedge_height_m` is Hoek's total vertical height of the wedge, from
the toe (where the line of intersection daylights in the face) to the APEX (where it meets
the upper surface). Other authors measure other heights: SWedge's H is slope height, and
Kliche's H is toe-to-CREST (see [S3]). For a dry, cohesionless wedge FS is scale-free (W&M eq
7.14: FS = A tanφA + B tanφB, which the engine returns as `friction_only_fos`), so every
c = 0 case below is insensitive to the definition and FS can be pinned directly. A cohesive
case (or a volume) can only be compared after converting the source's H to the engine's,
as [S3] does below. Cohesive SWedge cases are not pinned because the manual's H could not be
converted unambiguously.
| Test block (the published value it checks) | Verdict |
| [S1] §1.1 Table 1.1.5 (T35): joints 45/141 & 45/219, face 70/180 ⇒ plunge 37.852°; FS ≅ 1 | Pass |
| [S1] §1.1 Table 1.1.5 (T33 & T37): dip/φ 42.7/33 ⇒ 35.645°; 47.5/37 ⇒ 40.301° | Pass |
| [S1] §1.3 (Kumsar et al. 2000 Case 3, Ankara Castle): FS = 0.7123 | Pass |
| [S1] §1.4 (Kumsar et al. 2000 Case 4, Dinar, static): FS = 2.0203 | Pass |
| [S1] §3.1 Table 3.1.3 (ponded-water problem, dry row): FS = 0.9218 | Pass |
| [S1 §1.1] Kovári & Fritz closed form: λ = 1/sin ω and FS = λ·cos i_a·tanφ/sin i_a | Pass |
| [S2] §5.3: wedge factors A = 0.91 and B = 0.80 | Pass |
| [S2] §5.3: drained FS = 1.23 and cohesion destroyed ⇒ FS = 1.01 | Pass |
| [S3] Ch 8: line of intersection αi = 349°, βi = 39° (stereonet reading) and 348.5°/39.3° (Table 8.1) | Pass |
| [S3] Ch 8 + Table 8.1: H = 25 m toe-to-crest ⇒ W = 7,203,843 kg, FS = 0.875 (c ≠ 0), 0.686 (c = 0); Kliche FS 0.879 | Pass |
rock-wedge-3d-web-validation.test.ts
3-D wedge engine vs the published worked wedges in Wyllie & Mah (2004) "Rock Slope Engineering — Civil and Mining" 4th ed., Spon (source on disk: Wyllie-Mah-Rock-Slope-Engineering-Civil-and-Mining-4e.pdf).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
3-D wedge engine vs the published worked wedges in Wyllie & Mah (2004) "Rock Slope Engineering —
Civil and Mining" 4th ed., Spon (source on disk: Wyllie-Mah-Rock-Slope-Engineering-Civil-and-Mining-4e.pdf).
CASE 1 — §7.4, Tables 7.1 and 7.2 (after Hoek, Bray & Boyd 1973; Hoek & Bray 1981)
Plane A 45°→105, plane B 70°→235, face 65°→185, upper surface 12°→195; wedge height H = 40 m;
γr = 25 kN/m³, γw = 9.81 kN/m³; cA = 24 kPa, cB = 48 kPa.
Published results: ψ5 = 31.2°; A = 1.548, B = 0.956; FS friction-only (eq 7.14) = 1.24;
FS saturated = 1.36 (Table 7.2 sum 0.241 + 0.494 + 0.893 − 0.376 + 0.348 − 0.244); FS with zero
cohesion and maximum water pressure = 0.62; FS completely drained = 1.98.
NOTE ON THE BOOK'S OWN TABLES. Table 7.1 prints φA = 20°, φB = 30°, but the calculation sheet
(Table 7.2) uses tanφA = 0.577 (30°) and tanφB = 0.364 (20°), and only that assignment reproduces
the quoted 1.24 / 1.36 / 0.62 / 1.98 (with Table 7.1's φ the friction-only FS would be
1.548·tan20° + 0.956·tan30° = 1.115, not 1.24). The calculation-sheet assignment is used here.
TOLERANCE. The book reads X, Y, θ… off a hand-plotted stereonet in whole degrees and carries
3-digit trigonometry. Re-deriving its own X = sinθ24/(sinθ45·cosθ2.na) from the exact geometry gives
3.40 against the printed 3.336 (2 %), so ±0.02 on an FS of order 1-2 is the resolution of the
source, not slack in the engine. ψ5 and the orientation-only factors A, B (no hand-read angles in
eqs 7.12-7.13 beyond θna.nb and ψ5) are checked tighter.
CASE 2 — §7.6.3, Table 7.5 (comprehensive analysis, Rocscience 2001)
Planes 3 (60°→360) and 5 (54°→118), φ = 30°, c = 0, face 76°→060, upper surface 15°→070,
H1 = 28 m. Case (i): dry, static, c = 0 ⇒ FS = 1.05. With c = 0 and no water the FS is
independent of size and tension crack, so the published figure tests the orientation algebra.
| Test block (the published value it checks) | Verdict |
| Table 7.2: the line of intersection plunges ψ5 = 31.2° and the wedge is a valid, daylighting two-plane wedge | Pass |
| Table 7.2: wedge factors A = 1.548 and B = 0.956 (eqs 7.12-7.13) | Pass |
| §7.5 eq 7.14 / Table 7.2: friction-only FS = A·tanφA + B·tanφB = 1.24 | Pass |
| §7.4: completely drained FS with cohesion = 1.98 | Pass |
| Table 7.2: saturated FS with cohesion = 1.36 | Pass |
| §7.4: zero cohesion and maximum water pressure (saturated) = 0.62 — the worst case, unstable | Pass |
| Table 7.2 ordering holds: drained 1.98 > saturated 1.36 > friction-only 1.24 > worst case 0.62 | Pass |
| §7.6.3 case (i): planes 60/360 and 54/118, φ = 30°, c = 0, dry ⇒ FS = 1.05 | Pass |
| §7.6.3 case (i) is size-independent: the same orientations at H = 5 m and H = 200 m give the same FS | Pass |
rockfall-trajectory-web-validation.test.ts
Web-validation for the rockfall-trajectory engine (`rockfall-trajectory.ts`).
Analyses validated: rockfall-trajectory · Recorded run: passed — 25 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-validation for the rockfall-trajectory engine (`rockfall-trajectory.ts`).
the release rules gate: ≥20 independent, citable anchors. Rockfall lumped-mass mechanics
reduce to closed-form checks that trace to standard sources:
A. Energy conservation on a frictionless face → toe velocity v = √(2gH)
(Meriam & Kraige, Engineering Mechanics — Dynamics; Hoek 2007 Ch.9).
B. Inclined-plane slide with rolling friction → v = √(2gH·(1 − μ/tanβ))
(a = g(sinβ − μcosβ); Meriam & Kraige; Wyllie & Mah 2004 Ch.12).
C. Coefficient-of-restitution energy loss → runout & bounce grow with Rn,Rt;
Rn=Rt=1 (elastic) conserves energy (Pierson/Gullixson/Chassie 2001; RocFall).
D. Ritchie (1963) fallout-ditch (catchment) width & depth table, as reproduced
in Wyllie & Mah (2004) Table 12.3 / FHWA rockfall catchment design guide.
Anchor count below: 5 (free-slide) + 5 (friction slide) + 4 (Ritchie width/depth)
+ 4 (restitution/energy) + 2 (height/angle monotonicity) + 1 (arrest) + 2 (barrier)
= 23 independent checks (> the 20 gate).
| Test block (the published value it checks) | Verdict |
| A. frictionless slide toe velocity = √(2gH) for H=10 m | Pass |
| A. frictionless slide toe velocity = √(2gH) for H=20 m | Pass |
| A. frictionless slide toe velocity = √(2gH) for H=30 m | Pass |
| A. frictionless slide toe velocity = √(2gH) for H=50 m | Pass |
| A. frictionless slide toe velocity = √(2gH) for H=100 m | Pass |
| B. friction slide v_toe = √(2gH(1−μ/tanβ)) for H=30 β=60 μ=0.4 | Pass |
| B. friction slide v_toe = √(2gH(1−μ/tanβ)) for H=20 β=45 μ=0.3 | Pass |
| B. friction slide v_toe = √(2gH(1−μ/tanβ)) for H=40 β=70 μ=0.5 | Pass |
| B. friction slide v_toe = √(2gH(1−μ/tanβ)) for H=15 β=50 μ=0.35 | Pass |
| B. friction slide v_toe = √(2gH(1−μ/tanβ)) for H=25 β=55 μ=0.45 | Pass |
| C1. kinetic energy at the toe = ½ m v² (definition) | Pass |
| C2. higher normal restitution R_n → longer runout & higher bounce | Pass |
| C3. elastic (R_n=R_t=1) conserves energy → block does not arrest (runs to cap) | Pass |
| C4. more dissipative bounces (lower R) → fewer/shorter → shorter runout | Pass |
| D. Ritchie ditch for H=5 β=45 → 3.7 m × 1 m | Pass |
| D. Ritchie ditch for H=15 β=60 → 7 m × 1.5 m | Pass |
| D. Ritchie ditch for H=25 β=80 → 7.6 m × 1.8 m | Pass |
| D. Ritchie ditch for H=8 β=40 → 3.7 m × 1.2 m | Pass |
| E1. taller slope → higher toe velocity | Pass |
| E2. steeper face → higher toe velocity (larger downslope gravity component) | Pass |
| F. μ ≥ tanβ (friction angle ≥ slope angle) → block arrests on the face | Pass |
| G1. a low barrier in the bounce path is overtopped (inadequate) | Pass |
| G2. a tall, strong barrier is adequate | Pass |
| W3-D5 rockfall: Rn = 0 and Rt = 0 are honoured (0 = perfectly plastic), > 1 refused; a plastic impact rolls on | Pass |
| W3-D5 rockfall: a barrier at the toe (offset 0) is assessed; a barrier without a height is not assessed (it read ADEQUATE) | Pass |
stereonet-web-validation.test.ts
Stereonet + kinematic screening vs the published worked examples in Wyllie & Mah (2004) "Rock Slope Engineering — Civil and Mining" 4th ed., Spon, Ch 2: Example Problem 2.1 (stereo plots of structural geology data, p.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Stereonet + kinematic screening vs the published worked examples in
Wyllie & Mah (2004) "Rock Slope Engineering — Civil and Mining" 4th ed., Spon, Ch 2:
Example Problem 2.1 (stereo plots of structural geology data, p. 43-44) and
Example Problem 2.2 (slope stability evaluation related to structural geology, p. 44-45).
Source on disk: Wyllie-Mah-Rock-Slope-Engineering-Civil-and-Mining-4e.pdf.
The book solves both by hand on an equal-area net and rounds to the nearest degree, so every
comparison carries a tolerance of that order; the tolerance is stated beside each assertion.
| Test block (the published value it checks) | Verdict |
| Example 2.1(b): clustering the 17 poles finds the book's three sets and sets 80/010 aside | Pass |
| Example 2.1(b): mean poles agree with the book's 78/305, 40/081, 20/163 to within 2° of arc | Pass |
| Example 2.1(c): angle between the mean poles of sets 1 and 3 is 94° (included angle 86°) | Pass |
| Example 2.1(e): the line of intersection of sets 1 and 2 plunges 27° toward 029° | Pass |
| Example 2.2: east-dipping 50° face, φ = 25° ⇒ plane failure on set 2 only | Pass |
| Example 2.2: cutting the east slope at 40°, coincident with set 2, prevents sliding on set 2 | Pass |
| Example 2.2: if the friction angle exceeded the 40° dip, sliding on set 2 would not occur | Pass |
| Example 2.2: north-dipping 50° face ⇒ wedge failure on sets 1 and 2, and no plane failure | Pass |
| Example 2.2: cutting the north slope at 27° (the intersection plunge) is not undercut by the wedge | Pass |
| closed form: the wedge daylights exactly when ψf exceeds atan(tanψi / cos(αi − αf)) (≈ 30.3° for sets 1+2 on a north face) | Pass |
Groundwater flow and seepage
FE kernel registry — 32 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-verif-concrete-dam-I-Q | Dam I: total discharge under the dam [m³/s/m] | PLAXIS-Verification-Concrete-dam-confined-flow.pdf, p. 4 (Table 2) | 1.030e-5 | 1.029e-5 | 1.031e-5 | +0.06 % | +0.15 % | Pass |
plaxis-verif-concrete-dam-II-Q | Dam II (upstream screen): total discharge [m³/s/m] | PLAXIS-Verification-Concrete-dam-confined-flow.pdf, p. 4 (Table 2) | 8.681e-6 | 8.840e-6 | 8.686e-6 | +0.06 % | −1.74 % | Pass |
plaxis-verif-concrete-dam-III-Q | Dam III (downstream screen): total discharge [m³/s/m] | PLAXIS-Verification-Concrete-dam-confined-flow.pdf, p. 4 (Table 2) | 8.679e-6 | 8.840e-6 | 8.686e-6 | +0.08 % | −1.74 % | Pass |
plaxis-verif-concrete-dam-I-uplift | Dam I: uplift pressure head at A (dam toe) [m] | PLAXIS-Verification-Concrete-dam-confined-flow.pdf, p. 4 (Table 3) | 2.18 | 2.25 | 2.181 | +0.05 % | −3.07 % | Pass |
plaxis-verif-concrete-dam-II-uplift | Dam II: uplift pressure head at A [m] | PLAXIS-Verification-Concrete-dam-confined-flow.pdf, p. 4 (Table 3) | 2.08 | 2.13 | 2.073 | −0.34 % | −2.68 % | Pass |
plaxis-verif-concrete-dam-III-uplift | Dam III: uplift pressure head at A (upstream side of the screen) [m] | PLAXIS-Verification-Concrete-dam-confined-flow.pdf, p. 4 (Table 3) | 4.01 | 3.87 | 4.004 | −0.15 % | +3.46 % | Pass |
plaxis-verif-seepage-length | seepage face length along the slope above the tail water [m] | PLAXIS-Verification-Seepage-length.pdf, p. 5 (Table 1) | 25.35 | 25.5 | 25.375 | +0.10 % | −0.49 % | Pass |
plaxis-verif-muskat | seepage face height on the downstream boundary above the tail water [m] | PLAXIS-Verification-Muskat-problem-2018.pdf, p. 4 (Table 1) | 1.611 | 1.55 | 1.5867 | −1.51 % | +2.37 % | Pass |
plaxis-verif-sand-layer-Q | total discharge through an unconfined sand layer [m³/day/m] | PLAXIS-Verification-Unconfined-flow-sand-layer.pdf, p. 3 (Table 1) | 0.154 | 0.15 | 0.15387 | −0.08 % | +2.58 % | Pass |
plaxis-verif-earth-dam-Q | total discharge through the earth dam [m³/s/m] | PLAXIS-Verification-Unconfined-flow-earth-dam.pdf, p. 2 (Table 1) | 0.000544 | 0.000536 | 0.00054579 | +0.33 % | +1.83 % | Pass |
plaxis-verif-triangular-dam-Q | total discharge Q = kL/2 through the triangular dam [m³/day/m] | PLAXIS-Verification-Triangular-earth-dam.pdf, p. 2–5 | 0.5 | 0.5 | 0.5 | 0.00 % | 0.00 % | Pass |
plaxis-verif-theis-thiem-r10 | steady head at r = 10 m (pumping well, axisymmetric) [m] | PLAXIS-Verification-Theis-Thiem.pdf, p. 4 | 13.534 | 13.5342 | 13.5342 | +1.0e-3 % | 0.00 % | Pass |
plaxis-verif-theis-thiem-r100 | steady head at r = 100 m [m] | PLAXIS-Verification-Theis-Thiem.pdf, p. 4 | 14.267 | 14.2678 | 14.2678 | +5.0e-3 % | 0.00 % | Pass |
plaxis-verif-infiltration-steady | steady suction head profile, worst |ψ − Gardner| over y = 0.5…3 m [m] | PLAXIS-Verification-One-dimensional-infiltration.pdf, p. 1–4 (Eq. 4; Fig. 3) | — | 0 | 3.490e-7 | — | — | Pass |
plaxis-verif-infiltration-transient | transient suction head, worst |ψ − Srivastava & Yeh| at t = 0.1/0.25/0.5/1/5 d [m] | PLAXIS-Verification-One-dimensional-infiltration.pdf, p. 1–4 (Eq. 5–7; Fig. 4) | — | 0 | 0.0014 | — | — | Pass |
plaxis-verif-evaporation-steady | steady suction head, worst |ψ − Gardner| [m] | PLAXIS-Verification-One-dimensional-evaporation.pdf, p. 1–4 | — | 0 | 9.800e-5 | — | — | Pass |
plaxis-verif-evaporation-transient | transient suction head, worst |ψ − Srivastava & Yeh| [m] | PLAXIS-Verification-One-dimensional-evaporation.pdf, p. 1–4 | — | 0 | 0.0018 | — | — | Pass |
k4-gate-confined-box | confined flow box: discharge and linear head (P2/P1 and equal order) [m³/day/m] | — | — | 1 | 1 | — | 0.00 % | Pass |
k4-gate-dupuit | unconfined flow, sharp vG soil: discharge vs Dupuit [m³/s/m] | — | — | 2.100e-5 | 2.117e-5 | — | +0.82 % | Pass |
k4-gate-thiem | Thiem steady drawdown (see plaxis-verif-theis-thiem-*) [m] | — | — | 13.5342 | 13.5342 | — | 0.00 % | Pass |
k4-crosscheck-fe-seepage-layers | fe-seepage (TS oracle) layered column discharge [m³/s/m] | — | — | 5.600e-5 | 5.600e-5 | — | 0.00 % | Pass |
k4-crosscheck-fe-seepage-blockself-check | fe-seepage block with a cutoff: discharge vs the oracle 80×40 Q4 [m³/s/m] | — | — | 1.229e-5 | 1.229e-5 | — | +7.0e-3 % | Pass |
k4-crosscheck-unconfinedself-check | unconfined-seepage (TS oracle): discharge (Hypres coarse vG) [m³/s/m] | — | — | 2.087e-5 | 2.109e-5 | — | +1.07 % | Pass |
k9-sy-rainfall-hyetograph | worst |ψ − Srivastava & Yeh| under a rainfall table (24 values, 4 global times) [m] | PLAXIS-Verification-One-dimensional-infiltration.pdf, p. pp. 1–4 (Eqs. 5–7) | — | 0 | 0.0015 | — | — | Pass |
k9-drawdown-ramp-8m | Δh at 8 m depth after 1 day of a 0.5 m/day head ramp [m] | —, p. C&J §2.5 | — | -0.185 | -0.185 | — | 0.00 % | Pass |
k9-fxh-kr-10kPa | Fredlund–Xing–Huang k_r at 10 kPa (a 10, n 2, m 1, ψr 3000, aev 5) [–] | Fredlund-Rahardjo-Fredlund-2012_Unsaturated-Soil-Mechanics-in-Engineering-Practice_Wiley_939p.pdf, p. Eq. 8.21, Fig. 5.29 parameters | — | 0.210374 | 0.210328 | — | −0.02 % | Pass |
k9-kisch-liner-Q | leakage through a clay blanket (Yolo light clay / Superstition sand) [m/s] | Seequent-GeoStudio-SEEPW-Verification-Kisch-Clay-Liner-Unsaturated.pdf, p. pp. 2–7; FRF 2012 Table 8.2 | — | 1.323e-7 | 1.323e-7 | — | −7.6e-3 % | Pass |
v-plaxis-infiltration-transient-asserted | worst |ψ − Srivastava & Yeh| at t = 0.1/0.25/0.5/1/5 d, y = 0.5…3 m (ASSERTED < 5 mm); infiltration 0.1 m/d [m] | PLAXIS-Verification-One-dimensional-infiltration.pdf, p. pp. 1–4 (Eqs. 4–7; Fig. 3–4) | — | 0 | 0.0014 | — | — | Pass |
v-plaxis-evaporation-transient-asserted | worst |ψ − Srivastava & Yeh| at the same times (ASSERTED < 5 mm); evaporation 0.002 m/d [m] | PLAXIS-Verification-One-dimensional-evaporation.pdf, p. pp. 1–4 | — | 0 | 0.00185 | — | — | Pass |
v-k9-flow-function-rainfall | worst |ψ − S&Y superposed| under a table flow function (re-run 3 Nov 2026) [m] | PLAXIS-Verification-One-dimensional-infiltration.pdf, p. pp. 1–4 (Eqs. 5–7) | — | 0 | 0.0015 | — | — | Pass |
v-k9-flow-function-drawdown | Δh at 8 m after 1 d of a 0.5 m/d head ramp (head and level functions; re-run 3 Nov 2026) [m] | —, p. Carslaw & Jaeger 1959 §2.5 | — | -0.185 | -0.185 | — | — | Pass |
v-rocscience-ponded-water-effective-stress | worst |σ′yy − (−(γsat − γw)·d)| of a 2 m drained column (γsat 20, γw 10) under 0 / 1.5 / 3 m of standing water above its surface [kPa] | — | — | 0 | 5.862e-13 | — | — | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
plaxis-verif-concrete-dam-I-Q — Pass · K4
Reference: Lambe & Whitman (flow net)
Mesh: T15, 1297 elements
Reproduce: tests/k4_flow.rs plaxis_concrete_dam_confined_flow
Notes: Lambe & Whitman flow net. Gate: PLAXIS 1 %, flow net 2 %.
plaxis-verif-concrete-dam-II-Q — Pass · K4
Reference: Lambe & Whitman (flow net)
Mesh: T15, 1597 elements
Reproduce: tests/k4_flow.rs plaxis_concrete_dam_confined_flow
Notes: PLAXIS itself misses the flow net by 1.8 %; we agree with PLAXIS to 0.06 %.
plaxis-verif-concrete-dam-III-Q — Pass · K4
Reference: Lambe & Whitman (flow net)
Mesh: T15, 1611 elements
Reproduce: tests/k4_flow.rs plaxis_concrete_dam_confined_flow
Notes: Mirror of Dam II: the same discharge (ours equal to 5 digits; PLAXIS 8.679 vs 8.681).
plaxis-verif-concrete-dam-I-uplift — Pass · K4
Reference: Lambe & Whitman (flow net)
Mesh: T15, 1297 elements
Reproduce: tests/k4_flow.rs plaxis_concrete_dam_confined_flow
Notes: Gate: PLAXIS within 1 %. The flow-net value is a hand drawing (PLAXIS −2.9 %).
plaxis-verif-concrete-dam-II-uplift — Pass · K4
Reference: Lambe & Whitman (flow net)
Mesh: T15, 1597 elements
Reproduce: tests/k4_flow.rs plaxis_concrete_dam_confined_flow
Notes: Gate: PLAXIS within 1 %.
plaxis-verif-concrete-dam-III-uplift — Pass · K4
Reference: Lambe & Whitman (flow net)
Mesh: T15, 1611 elements
Reproduce: tests/k4_flow.rs plaxis_concrete_dam_confined_flow
Notes: A sits on the upstream face of the screen (hint p. 4) — the B-side value of the split pressure node. Gate: PLAXIS within 1 %.
plaxis-verif-seepage-length — Pass · K4
Reference: Strack & Asgian 1978 (chart)
Mesh: T15, 4423 elements
Reproduce: tests/k4_flow.rs plaxis_seepage_length
Notes: Strack & Asgian (1978) chart l/L = 0.255. Hypres topsoil coarse vG (Standard coarse). Gate: 2 % of both. Converged in 15 iterations (Picard → Newton, early active-set updates; plain Picard stalled — fixed).
plaxis-verif-muskat — Pass · K4
Reference: Kang-Kun & Leap 1997 (chart)
Mesh: T15 Fine
Reproduce: tests/k4_flow.rs plaxis_muskat_seepage_face
Notes: Muskat via Kang-Kun & Leap (1997) chart (PLAXIS itself +4.2 %). Hypres topsoil coarse vG. Gate: chart 5 %, PLAXIS 3 %. Approximate van Genuchten variant (ψs −2.37, ψk −1.06 m): 1.6533 m (PLAXIS +2.6 %), test muskat_with_approximate_van_genuchten, gate PLAXIS 5 %.
plaxis-verif-sand-layer-Q — Pass · K4
Reference: Dupuit / Charny (exact, saturated only)
Mesh: T15
Reproduce: tests/k4_flow.rs plaxis_unconfined_sand_layer_dupuit
Notes: Dupuit discharge is exact for saturated flow (Charny); the excess (ours +2.6 %, PLAXIS +2.7 %) is flow in the unsaturated (capillary) zone — PLAXIS explains the same. Mass balance in = out to 1e-6. Gate: PLAXIS 1 %.
plaxis-verif-earth-dam-Q — Pass · K4
Reference: Lambe & Whitman (flow net)
Mesh: T15, 1247 elements
Reproduce: tests/k4_flow.rs plaxis_unconfined_earth_dam
Notes: Lambe & Whitman flow net (PLAXIS 0.000544 = +1.49 % on the flow net 0.000536; ours +0.33 % on PLAXIS). Gate: PLAXIS 1 %, flow net 2.5 %.
plaxis-verif-triangular-dam-Q — Pass · K4
Reference: Harr 1962 exact solution
Mesh: T15 → P2 pressure
Reproduce: tests/k4_flow.rs plaxis_triangular_earth_dam_exact
Notes: Exact closed form (Davison / Harr): h = L − (x² − y²)/(4L) is quadratic, so P2 pressures reproduce it to round-off: max |p − p_exact| 1.0e-13 kPa; h(D) = 0.75 exact; CB is all seepage face. Gate 1e-9.
plaxis-verif-theis-thiem-r10 — Pass · K4
Reference: Thiem (exact), Theis W(u)
Mesh: T15 axisymmetric, 280 elements
Reproduce: tests/k4_flow.rs plaxis_theis_thiem
Notes: Thiem exact (steady); at t = 1500 s (PLAXIS time) 13.53439. Transient vs Theis W(u), 90–120 s: worst 0.0258 m with PLAXIS steps (≤ 100 s), 0.0015 m with 1-s steps — a time-discretisation error, not a model error. Gate: Thiem 2 mm, PLAXIS 2 mm.
plaxis-verif-theis-thiem-r100 — Pass · K4
Reference: Thiem (exact)
Mesh: T15 axisymmetric, 280 elements
Reproduce: tests/k4_flow.rs plaxis_theis_thiem
Notes: Thiem exact; at t = 1500 s 14.26797.
plaxis-verif-infiltration-steady — Pass · K4
Reference: Gardner 1958 closed form
Mesh: T15 column
Reproduce: tests/k4_flow.rs plaxis_one_dimensional_infiltration_and_evaporation
Notes: PLAXIS: figures only. Gardner exponential model (added in K4; PLAXIS used a spline fit). ψ(3) = 1.14026 = Gardner. Gate 2 mm.
plaxis-verif-infiltration-transient — Pass · K4
Reference: Srivastava & Yeh 1991
Mesh: T15 column
Reproduce: tests/k4_flow.rs plaxis_one_dimensional_infiltration_and_evaporation
Notes: Srivastava & Yeh (1991) series, 400 roots. Phase times read as cumulative (ambiguous wording, flagged). Figures only in PLAXIS.
plaxis-verif-evaporation-steady — Pass · K4
Reference: Gardner 1958 closed form
Mesh: T15 column
Reproduce: tests/k4_flow.rs plaxis_one_dimensional_infiltration_and_evaporation
Notes: ψ(3) = 3.81711 vs 3.81701.
plaxis-verif-evaporation-transient — Pass · K4
Reference: Srivastava & Yeh 1991
Mesh: T15 column
Reproduce: tests/k4_flow.rs plaxis_one_dimensional_infiltration_and_evaporation
Notes: Worst at the surface early on (sharpest gradient).
k4-gate-confined-box — Pass · K4
Reference: exact
Reproduce: tests/k4_flow.rs confined_box_linear_head_and_discharge_exact
Notes: Exact to 1e-10 in all four orders (T6/T15 × mixed/equal); p linear exact to 1e-9.
k4-gate-dupuit — Pass · K4
Reference: Dupuit / Charny
Mesh: 2304 elements
Reproduce: tests/k4_crosscheck.rs crosscheck_unconfined_seepage
Notes: Dupuit discharge is exact for the saturated problem; a sharp soil (ga 10, gn 4) approaches it: +0.82 % (gate 1 %).
k4-gate-thiem — Pass · K4
Reference: Thiem
Reproduce: tests/k4_flow.rs plaxis_theis_thiem
Notes: Gate 2 mm.
k4-crosscheck-fe-seepage-layers — Pass · K4
Reference: exact; packages/geotech fe-seepage
Reproduce: tests/k4_crosscheck.rs crosscheck_fe_seepage_layers
Notes: Kernel, TS oracle and the exact series-resistance answer agree to 1e-12.
k4-crosscheck-fe-seepage-block — Pass · K4
Reference: packages/geotech fe-seepage (TS oracle)
Reproduce: tests/k4_crosscheck.rs crosscheck_fe_seepage_block
Notes: Oracle Richardson 1.227772e-5 (kernel +0.069 %). Heads h(2,1) 9.39695 vs 9.39701, h(8,4) 6.38233 vs 6.38230; antisymmetry h(5,1) 8.000002. Difference = the oracle's Q4 discretisation (Q4 → T15).
k4-crosscheck-unconfined — Pass · K4
Reference: packages/geotech unconfined-seepage (TS oracle)
Reproduce: tests/k4_crosscheck.rs crosscheck_unconfined_seepage
Notes: Oracle (Q4, sharp free surface) Richardson 2.0871e-5; kernel +1.07 % (sharp vG +1.44 %). Exit point 4.10 m vs oracle 4.287 (within one oracle element 0.43 m); phreatic at x = 10: 7.795 vs 7.809. Differences: the oracle has no capillary zone (free-surface iteration); the kernel carries unsaturated flow (Dupuit +0.45 / +0.82 %).
k9-sy-rainfall-hyetograph — Pass · K9
Reference: Srivastava & Yeh (1991) superposed (exact for the Gardner soil)
Benchmark: vendor: closed-form; product: —; version: —; doc: PLAXIS-Verification-One-dimensional-infiltration.pdf; page: pp. 1–4 (Eqs. 5–7); caseId: k9-sy-rainfall-hyetograph
Comparison (closed-form): Srivastava & Yeh (1991) superposed (exact for the Gardner soil) = 0, tolerance < 4 mm.
Case: (test fixture)
Reproduce: tests/k9_unsat.rs rainfall_hyetograph_srivastava_yeh_superposition
Notes: table time function on the inflow boundary across 4 phases. Gate: < 4 mm.
k9-drawdown-ramp-8m — Pass · K9
Reference: −4 r t i²erfc(x/2√(Dt))
Benchmark: vendor: closed-form; product: —; version: —; doc: —; page: C&J §2.5; caseId: k9-drawdown-ramp-8m
Comparison (closed-form): −4 r t i²erfc(x/2√(Dt)) = -0.185, tolerance < 3e-3 m (6 depths).
Case: (test fixture)
Reproduce: tests/k9_unsat.rs linear_drawdown_carslaw_jaeger_ramp
Notes: linear time function on a head and on a level. Gate: < 3e-3 m (6 depths).
k9-fxh-kr-10kPa — Pass · K9
Reference: 20 000-point quadrature of Eq. 8.21
Benchmark: vendor: closed-form; product: —; version: —; doc: Fredlund-Rahardjo-Fredlund-2012_Unsaturated-Soil-Mechanics-in-Engineering-Practice_Wiley_939p.pdf; page: Eq. 8.21, Fig. 5.29 parameters; caseId: k9-fxh-kr-10kPa
Comparison (closed-form): 20 000-point quadrature of Eq. 8.21 = 0.210374, tolerance 0.2 %.
Reproduce: tests/k9_unsat.rs fredlund_xing_functions
Notes: 400-node log table. Gate: 0.2 %.
k9-kisch-liner-Q — Pass · K9
Reference: shooting ODE of q = k(p)(1 + p′/γw) (SEEP/W ≈ 1.3e-7 with its own functions)
Benchmark: vendor: closed-form; product: —; version: —; doc: Seequent-GeoStudio-SEEPW-Verification-Kisch-Clay-Liner-Unsaturated.pdf; page: pp. 2–7; FRF 2012 Table 8.2; caseId: k9-kisch-liner-Q
Comparison (closed-form): shooting ODE of q = k(p)(1 + p′/γw) (SEEP/W ≈ 1.3e-7 with its own functions) = 1.323e-7, tolerance 0.5 %.
Reproduce: tests/k9_unsat.rs kisch_clay_liner_fredlund_xing_leong_rahardjo
Notes: D365: SEEP/W unit-gradient suction −5.22 kPa vs ours −4.64 kPa (different k-functions). Gate: 0.5 %.
v-plaxis-infiltration-transient-asserted — Pass · verify-plaxis2d
Reference: Srivastava & Yeh 1991 (the document's Eq. 5–7)
Mesh: T15 column, 60 intervals
Reproduce: tests/v_plaxis_verif_infiltration.rs plaxis_1d_infiltration_and_evaporation_steady_and_transient_vs_published_closed_forms
Notes: PLAXIS prints figures only; the published value is the document's closed form. Tolerance 5 mm fixed before the run. Steady vs Gardner 3.5e-7 m. Kernel uses the exact Gardner curve; PLAXIS a spline fit of it.
v-plaxis-evaporation-transient-asserted — Pass · verify-plaxis2d
Reference: Srivastava & Yeh 1991
Mesh: T15 column, 60 intervals
Reproduce: tests/v_plaxis_verif_infiltration.rs (same test)
Notes: Steady vs Gardner 9.8e-5 m (gate 2 mm).
v-k9-flow-function-rainfall — Pass · verify-plaxis2d
Reference: S&Y 1991 superposed over the flux history
Reproduce: tests/k9_unsat.rs rainfall_hyetograph_srivastava_yeh_superposition
Notes: Gate 4 mm; asserted. Row 59 evidence.
v-k9-flow-function-drawdown — Pass · verify-plaxis2d
Reference: −4 r t i²erfc(x/2√(Dt))
Reproduce: tests/k9_unsat.rs linear_drawdown_carslaw_jaeger_ramp
Notes: Gate 3e-3 m, 6 depths. Row 59 evidence.
v-rocscience-ponded-water-effective-stress — Pass · verify-rocscience (RS2 parity #42, Settle3 M26/E1)
Reference: effective-stress principle (Terzaghi): σ′ = (γsat − γw)·d, independent of the water depth above the surface; unloaded surface would be off by γw·h_w = 15 / 30 kPa
Mesh: rect-mesh 0.1 × 2 m, 10 rows, T6 (order 2)
Reproduce: tests/v_rocscience_ponded_water.rs effective_stress_under_standing_water_is_independent_of_the_water_depth
Notes: Closed-form expectation, no PLAXIS/RS2 number. Measured worst 5.71e-13 / 5.86e-13 / 5.76e-13 kPa for h_w = 0 / 1.5 / 3 m; gate 0.05 kPa. Shows (a) the phreatic level above the surface loads the ground as γw·h_w without any manual load, (b) submerged unit weight (buoyancy) is applied. Horizontal water level only.
Cited validation suites — 19
capillary-rise-web-validation.test.ts
Validation for `capillary-rise` — Hazen/Terzaghi capillary rise h_c = C/(e·D10) and suction (`capillary-rise.ts`, `computeCapillaryRise`).
Analyses validated: capillary-rise · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `capillary-rise` — Hazen/Terzaghi capillary rise h_c = C/(e·D10) and suction
(`capillary-rise.ts`, `computeCapillaryRise`).
Published sources (every number below was read from the page named beside it; none is recalled):
1. Terzaghi, K., Peck, R.B. & Mesri, G. (1996), Soil Mechanics in Engineering Practice 3rd ed., Wiley —
Art. 15.6.1 "Capillarity and suction", Eq. 15.20–15.23 (library copy, scanned, pp. 90–91):
h_c (m) = C/(e·D10) with D10 in mm and "C ... ranges between 0.01 and 0.05"; suction u_s = γw·z (Eq. 15.21).
NB the engine docblock cites "Terzaghi & Peck §16"; in this edition the article is 15.6.1.
2. Holtz, R.D. & Kovacs, W.D. (1981), An Introduction to Geotechnical Engineering, Prentice-Hall — §6.2:
Table 6-1 (after Hansbo 1975; p. 176) "clay ≥ 10 m" and Example 6.3 (clay with D10 = 1 µm). Page image read.
3. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Ch. 2, p. 40: γw = 9.81 kN/m³ and
z_s = u_c/γw for the height of the suction zone.
4. Acharya, A. (2021), Soil Mechanics Ch. 6 lecture notes (abhashacharya.com.np/wp-content/uploads/2021/05/
Chapter-6.pdf), "Associated Numerical" — the same problem is Example 6.5 of other university lecture notes.
A university lecture note, NOT a textbook; it is used for one ratio problem only (see the last test).
UNIT MAPPING (not an engine fault): Terzaghi–Peck give h_c in metres with D10 in millimetres and C = 0.01–0.05.
The engine takes Hazen's C in cm² and D10 in mm: h_c(m) = 0.1·C(cm²)/(e·D10(mm)), so C(cm²) = 10·C(T–P), i.e.
the engine's 0.1–0.5 cm² range IS the published 0.01–0.05.
SHORTFALL — formula-fidelity evidence only. No source found prints a complete Hazen worked example
(D10, e, C → h_c with a printed answer). Terzaghi–Peck and Hazen print the equation and the C range; Holtz &
Kovacs Table 6-1 prints capillary rise by soil type but not the D10 or e of those soils, so it cannot be
turned into an input→answer pair without inventing inputs. Published-value count is therefore small and is
reported as such; the hand-evaluated values below are the printed equation at the printed constants.
| Test block (the published value it checks) | Verdict |
| Terzaghi–Peck–Mesri Eq. 15.23 at the printed C limits (0.01 and 0.05, D10 in mm, h_c in m) | Pass |
| the engine’s C warning band is exactly the published 0.01–0.05 (= 0.1–0.5 cm²) | Pass |
| Terzaghi–Peck Eq. 15.21 and Craig p. 40: suction = γw·h_c with γw = 9.81 kN/m³ | Pass |
| Terzaghi–Peck Art. 15.6.1: rise grows as the effective size falls, and is ∝ 1/D10 and ∝ 1/e | Pass |
| Holtz & Kovacs Table 6-1 / Example 6.3: a clay with D10 = 1 µm rises at least 10 m | Pass |
| Acharya (2021) lecture-note problem: soil A (D10 = 0.06 mm) rises 60 cm; soil B (D10 = 0.1 mm, same e) ⇒ 360 mm | Pass |
darcy-velocity-web-validation.test.ts
darcy-velocity — validation of Darcy's law (discharge velocity, seepage velocity, flow rate) against PUBLISHED worked numbers.
Analyses validated: darcy-velocity · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
darcy-velocity — validation of Darcy's law (discharge velocity, seepage velocity, flow rate) against
PUBLISHED worked numbers. `darcy-velocity.ts`:
i = Δh/L v = k·i v_s = v/n Q = v·A
Published sources (opened and read; page numbers are the books' own):
1. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley:
Chapter 17, Fig. 17.8 discussion (p. 256): "v = k × i = 0.5 cm/sec × 3.6/1.8 = 1 cm/sec. The
seepage velocity is equal to the approach velocity/porosity, i.e. 1/0.33 = 3 cm/sec."
Chapter 18, §18.1 / Fig. 18.1 (p. 266–267): tube 1.2 m × 1.2 m, k = 0.05 × 10⁻² m/s, head lost
4.8 m in ten squares of 0.3 m ⇒ "gradient H/(10 × 0.3) = 1.6" and "Q = kiA = … = 0.00115 m³/sec".
2. Holtz, R.D. & Kovacs, W.D. (1981), An Introduction to Geotechnical Engineering, Prentice-Hall,
Example 7.1 (p. 207–208): constant-head test, 7.3 cm diameter × 16.8 cm long sample, head 75 cm,
945.7 g collected in 1 min ⇒ "k = 0.08 cm/s" (scanned copy, read by OCR; key numbers checked by eye).
HONEST SCOPE. These are the only worked Darcy-velocity NUMBERS found in the local library: the other
books carry the equation and typical-k tables but no worked v, v_s or Q (Craig §2.2, Das §2.10, Freeze &
Cherry Eq. 2.82 — read, nothing to compare). The number of distinct published values is therefore
small (listed per test); it is reported as a shortfall against the 20-value bar, not padded.
| Test block (the published value it checks) | Verdict |
| Lambe & Whitman 1969 Fig 17.8: k = 0.5 cm/s, 3.6 m over 1.8 m → v = 1 cm/s | Pass |
| Lambe & Whitman 1969 Fig 17.8: n = 0.33 → seepage velocity "3 cm/sec" | Pass |
| Lambe & Whitman 1969 Fig 18.1: 4.8 m over 10 × 0.3 m → gradient 1.6 | Pass |
| Lambe & Whitman 1969 Fig 18.1: Q = kiA over the 1.2 × 1.2 m tube = 0.00115 m³/s | Pass |
| Holtz & Kovacs 1981 Ex 7.1: printed k = 0.08 cm/s reproduces the collected volume (945.7 cm³ in 1 min) to its 1-s.f. precision | Pass |
| Holtz & Kovacs 1981 Ex 7.1: cross-sectional area of the 7.3 cm sample is 41.9 cm² (printed) | Pass |
| v_s > v for every porosity below 1 (Lambe & Whitman Eq. 17.3: v_s = v/n) | Pass |
| a cleared flow length is refused rather than reported as v = 3e9 m/s | Pass |
dewatering-system-web-validation.test.ts
Dedicated validation for the equivalent-well dewatering system (`dewatering-system.ts`): steady discharge of a ring of wells idealised as one large well, Q = πk(H²−h²)/ln(R/re) (unconfined) and Q = 2πkbs/ln(R/re) (confined), with the Sicha…
Analyses validated: dewatering-system · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the equivalent-well dewatering system (`dewatering-system.ts`): steady discharge of a
ring of wells idealised as one large well, Q = πk(H²−h²)/ln(R/re) (unconfined) and Q = 2πkbs/ln(R/re) (confined),
with the Sichardt radius of influence R = 3000·s·√k.
PUBLISHED SOURCES (each opened and read for this suite):
1. Cashman, P.M. & Preene, M. (2012), Groundwater Lowering in Construction: A Practical Guide to Dewatering,
2nd ed., Appendix 5 "Design Examples", Design Example 1 (equivalent-well analysis of deep wells in a
confined aquifer, 35 x 15 m excavation, D = 9 m, drawdown 8.5 m, four permeabilities): printed re, R0 and Q.
The page was read at https://ebrary.net/199793/engineering/design_examples on 2026-10-06; that page does
not state its edition, so the 2012 second edition is the bibliographic entry assumed here (the Appendix 5
figures quoted are the page's own).
2. Textbook chapter "Groundwater and Well Hydraulics" (Chapter 4), Section 4.2 "Steady Radial Flow to a
Well", worked Examples 4.2.2 (two confined cases), 4.2.3 and 4.2.4 (unconfined), pages 156-159; text read
at https://pdfcoffee.com/radial-flow-for-unconfined-aquifer-pdf-free.html on 2026-10-06. ⚠ The extract
does not show the book's title, author or year, so none is claimed.
3. Course handout "Summary GW Equations Applications", Florida International University (Fuentes), Example
9.7 (confined well) and 9.8 (unconfined well, 12-inch diameter, 100 ft saturated thickness, 600 gpm), read on
2026-10-06 (the URL is recorded beside the handout tests below). ⚠ The handout does not name the textbook
its examples come from, and its text layer is an OCR scrape; only values re-derivable from its own printed
inputs are used.
4. IS 9759:1981, Guidelines for Dewatering During Construction, library copy, clause 4.4.2.3 (read from the
page image): R = C'(H - hw)√k with C' = 0.9, k in 10^-4 cm/s, "based on Sichardt's equation".
WHAT IS PUBLISHED ANSWER HERE. Sources 1-3 print the discharge (or the hydraulic conductivity and the discharge)
of worked problems; the engine is given the problem's own data and asked for Q. The inputs that the sources
print only indirectly are built from their stated geometry and said so in comments. The radius of influence
R is passed through the engine's documented override wherever the source states its own R (Sources 1-2 use a
measured or source-specific R, not the engine's default).
TWO MODELLING DIFFERENCES THAT ARE REPORTED, NOT HIDDEN.
(a) Source 1 computes R0 for an equivalent well as re + 3000(H - hw)√k (distance from the well-array CENTRE);
the engine's default Sichardt R is 3000·s·√k from the centre WITHOUT the added re. The default R is then
smaller by re, which raises Q by 0.7-2.7 % in this example (conservative for pump sizing). Asserted below
as "engine R + re equals the printed R0" so the relationship is pinned, not assumed.
(b) Source 1 takes re = 18.5 m from the PERIMETER of the 39 x 19 m well array, re = (a + b)/π; the engine takes
the AREA-equivalent circle, re = √(ab/π) = 15.4 m for that array, which lowers Q by about 7 %. The engine's
formula is the other published choice, so the equivalent-radius input is built here as a square of the
same radius (side √π·re). IS 9759 clause 4.4.2.3 gives a constant 0.9 for k in 10^-4 cm/s, i.e. 900·s·√k
with k in m/s, 3.3 times smaller than Sichardt's 3000 used by Source 1 and by this engine. It is not
asserted; the engine accepts the override for a design to IS 9759.
Tolerance rule: half a unit in the last printed digit of the printed answer; where the printed inputs are
themselves rounded (3 significant figures) the propagated relative rounding is stated.
| Test block (the published value it checks) | Verdict |
| Cashman & Preene Design Example 1: printed Q (m³/s) from the printed re and R0 | Pass |
| Cashman & Preene Design Example 1: engine Sichardt R plus re equals the printed R0 (Eq. 13.15 structure) | Pass |
| Cashman & Preene Design Example 1: the engine default (no R0 added) is the conservative side, +0.7 to +2.7 % | Pass |
| Textbook Example 4.2.2 (confined, b = 25 m): K = 16.8 m/day reproduces Q = 0.05 m³/s = 4320 m³/day | Pass |
| Textbook Example 4.2.2 (confined, b = 30 m, 1 m dia well): K = 13.3 m/day, head at well 34.5 m, R = 79 m → Q = 113 m³/h | Pass |
| Textbook Example 4.2.3 (unconfined, h0 = 25 m): K = 18.3 m/day reproduces Q = 0.05 m³/s = 4320 m³/day | Pass |
| Textbook Example 4.2.4 (unconfined, 33 m saturated, 0.5 m dia well): K = 12.68 m/day, head at well 27.7 m, R = 198 m → Q = 1920 m³/day | Pass |
| Course handout Example 9.7 (confined well): printed drawdown 127 ft reproduces Q = 2000 gpm | Pass |
| Course handout Example 9.8 (unconfined well): printed drawdown 38.2 ft reproduces Q = 600 gpm | Pass |
earth-dam-seepage-web-validation.test.ts
PUBLISHED-VALUES: 10 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: ten values, all from one worked example (Craig Ex 2.4).
Analyses validated: earth-dam-seepage · Recorded run: passed — 16 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 10 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: ten values, all from one worked example (Craig Ex 2.4). Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
earth-dam-seepage — validation against the PUBLISHED Kozeny/Casagrande basic-parabola solution for a
homogeneous earth dam on an impervious base with a horizontal (toe) drain.
`earth-dam-seepage.ts`: y0 = √(d² + h²) − d ; q = k·y0 ; y(x) = √(2·y0·x + y0²) (x from the focus).
Published sources (opened and read from the local reference library / fetched):
1. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon/Taylor & Francis,
§2.9 "Seepage through embankment dams": Eq. 2.38–2.40 (Kozeny's basic parabola, p. 67) and WORKED
EXAMPLE 2.4 (p. 69–71): homogeneous anisotropic dam, transformed to k' = √(kx·kz) = 2.7e-8 m/s,
head h = 18.00 m, Casagrande start point G at x = −40.80 m, z = +18.00 m from the focus A, giving
x0 = 1.90 m, the printed "TABLE E" of parabola ordinates and q = 2·k'·x0 = 1.0e-7 m³/s (p. 71);
the same example's hand-drawn flow net (Nf = 4, Nd = 18) gives q = 1.1e-7 m³/s (p. 70).
2. Casagrande, A. (1937), "Seepage through Dams", Journal of the New England Water Works Association,
June 1937 (Harvard University reprint; pages 146–147 of the reprint): §F.c "Solution for a horizontal
discharge surface (α = 180°)", Eq. (14)–(16): the line of seepage is Kozeny's confocal parabola with
focus at the toe, y0 = √(d²+h²) − d, q = k·y0 = 2·k·a0, focal distance a0 = y0/2. Read from the OCR
copy at literature.wolkersdorfer.info/literature/Seepage Through Dams_cropped.pdf on 2026-10-07.
HONEST SCOPE. Source 1 supplies the published NUMBERS (x0, z0, the Table E ordinates, q). Source 2 is
the ORIGINAL DERIVATION of the equations the engine implements — the relations below taken from it are
statements about the equations, not independent published numeric answers, and are labelled as such.
Craig's Table E was computed from x0 rounded to 1.90 m (true value 1.897 m); the tolerances below are
the propagation of that printed rounding, derived in `tolTableE`, never widened to make a test pass.
Inputs: Craig prints the transformed-section geometry (d = 40.80 m, h = 18.00 m, k' = 2.7e-8 m/s);
the engine receives exactly those printed numbers.
| Test block (the published value it checks) | Verdict |
| Craig 2012 Ex 2.4: focal distance x0 = 1.90 m (engine y0/2) | Pass |
| Craig 2012 Ex 2.4: parabola ordinate at the focus, z0 = 2·x0 = 3.80 m (TABLE E, x = 0) | Pass |
| Craig 2012 Ex 2.4: seepage from the basic parabola q = 2·k'·x0 = 1.0e-7 m³/s per metre | Pass |
| Craig 2012 Ex 2.4: analytic q agrees with the same example's hand-drawn flow net (1.1e-7) to its own scatter | Pass |
| Craig 2012 TABLE E: point (x=-5.0, z=7.24) lies on the parabola with y0 = 3.80 m | Pass |
| Craig 2012 TABLE E: point (x=-10.0, z=9.51) lies on the parabola with y0 = 3.80 m | Pass |
| Craig 2012 TABLE E: point (x=-20.0, z=12.9) lies on the parabola with y0 = 3.80 m | Pass |
| Craig 2012 TABLE E: point (x=-30.0, z=15.57) lies on the parabola with y0 = 3.80 m | Pass |
| Craig 2012 TABLE E: ordinate at x=-5.0 m is z=7.24 m (engine parabola y(L/2)) | Pass |
| Craig 2012 TABLE E: ordinate at x=-10.0 m is z=9.51 m (engine parabola y(L/2)) | Pass |
| Craig 2012 TABLE E: ordinate at x=-20.0 m is z=12.9 m (engine parabola y(L/2)) | Pass |
| Craig 2012 TABLE E: ordinate at x=-30.0 m is z=15.57 m (engine parabola y(L/2)) | Pass |
| Casagrande 1937 Eq.(16): q = k·y0 = 2·k·a0, with focal distance a0 = y0/2 | Pass |
| Casagrande 1937 Eq.(15): y0 = √(d²+h²) − d (hand evaluation at Craig's d = 40.80, h = 18.00) | Pass |
| Casagrande 1937: seepage is independent of the number of channels drawn — doubling k doubles q, h→0 gives q→0 | Pass |
| freeboard check: Craig Ex 2.4 crest (20.00 m) over the 18.00 m pool leaves 2.00 m | Pass |
fe-seepage-web-validation.test.ts
Web-benchmark validation for `fe-seepage` — steady confined FE seepage and the unconfined free-surface solve.
Analyses validated: fe-seepage, unconfined-seepage · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `fe-seepage` — steady confined FE seepage and the unconfined
free-surface solve.
SOURCES:
Darcy — 1-D confined flow between two fixed heads: the head varies LINEARLY and
Q = k·(Δh/L)·H per unit width. Exact, so asserted to machine precision.
Series-flow equivalent conductivity — for two blocks in series along the flow path the
equivalent k is the HARMONIC mean weighted by length: L/k_eq = Σ Lᵢ/kᵢ. Exact.
Dupuit (1863) / Forchheimer / Charny (1951) — unconfined discharge through an
earth dam: q = k·(h₁² − h₂²)/(2L). Exact for the Dupuit assumptions.
Terzaghi, Peck & Mesri §15-16 — exit gradient and piping, i_crit = γ′/γ_w.
Smith, Griffiths & Margetts, "Programming the FEM" 5e §2 — the FE formulation.
Harr (1962) "Groundwater and Seepage"; Bathe & Khoshgoftaar (1979) — free-surface FE.
These are the strongest kind of anchor: closed-form solutions the FE must reproduce, not
chart readings. Where the FE is compared to a closed form the tolerance is stated and the
reason for it given.
| Test block (the published value it checks) | Verdict |
| 1-D confined flow reproduces Q = k·(Δh/L)·H exactly | Pass |
| the head field is linear in x, to machine precision | Pass |
| Q scales exactly with k, with the gradient, and with the flow area | Pass |
| refining the mesh drives Q toward the closed form | Pass |
| two zones in series give the harmonic-mean equivalent k (exact) | Pass |
| pure horizontal flow has no upward gradient, so piping is withheld not zeroed | Pass |
| upward flow produces a real exit gradient and a finite piping FoS | Pass |
| the unconfined solve reports the exact Dupuit discharge q = k(h₁² − h₂²)/(2L) | Pass |
| the free surface falls monotonically from upstream to downstream | Pass |
| a domain with no fixed head is refused rather than solved as all-zero | Pass |
| invalid geometry, conductivity and mesh divisions are all refused | Pass |
| the unconfined solve refuses a downstream head above the upstream one | Pass |
field-permeability-web-validation.test.ts
Web-benchmark validation for `field-permeability` — in-situ borehole permeability.
Analyses validated: field-permeability · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `field-permeability` — in-situ borehole permeability.
SOURCES (governing equations, each cited at the assertion that uses it):
Hvorslev, M.J. (1951) "Time Lag and Soil Permeability in Ground-Water Observations",
US Army Corps of Engineers Waterways Experiment Station, Bulletin No. 36 — the intake
shape factors F and the variable/constant-head relations.
IS 5529 (Part 1):2013 — in-situ permeability tests in boreholes.
Terzaghi & Peck — the permeability classification bands.
WHY THE ARITHMETIC IS SHOWN. Every expected value below is computed from the published
equation with the intermediate steps written out, so a reviewer can check the number
without running the engine. None is a value this engine produced and was then blessed —
that distinction is the whole point of the audit.
The governing relations:
A = π·d²/4 standpipe area, d = casing inner diameter
F = 2.75·D flush-bottom intake in uniform soil (Hvorslev)
F = 2π·L / sinh⁻¹(L/D) screened/well-point intake, exact isotropic
(≈ 2π·L/ln(2L/D) for L/D ≳ 4)
k = (A/F)·ln(H1/H2)/(t2 − t1) variable head (falling or rising)
k = Q/(F·H) constant head
| Test block (the published value it checks) | Verdict |
| flush-bottom shape factor is Hvorslev F = 2.75·D | Pass |
| screened shape factor is F = 2π·L/sinh⁻¹(L/D), with the published asymptote | Pass |
| variable-head k matches Hvorslev (1951) on a hand-computed case | Pass |
| a rising-head test gives the same k as the falling-head equivalent | Pass |
| constant-head k matches Hvorslev k = Q/(F·H) | Pass |
| using the flush-bottom factor for a screened interval changes k materially | Pass |
| a short screened interval (L/D < 4) is flagged, not silently trusted | Pass |
| permeability classes break at the Terzaghi-Peck decade boundaries | Pass |
| a poor ln(H)-vs-t fit is flagged with its R² | Pass |
⚑ filter-design-web-validation.test.ts
PUBLISHED-VALUES: 6 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: the sources publish filter LIMITS, not worked filter-design answers.
Analyses validated: filter-design · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 6 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: the sources publish filter LIMITS, not worked filter-design answers. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
filter-design — validation of the granular-filter retention / permeability / segregation criteria
against the PUBLISHED numeric limits. `filter-design.ts`:
D15f/D85b ≤ 4 (Terzaghi) · ≤ 5 (USACE) D15f/D15b ≥ 4 (Terzaghi) · ≥ 5 (USACE)
D50f/D50b ≤ 25 D15f ≥ 0.1 mm D85f ≤ 75 mm (advisory)
Published sources (opened and read; page numbers are the books' own):
1. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley, §19.4 "Filter requirements"
(p. 292–293), Eq. (19.10)–(19.12): D15(filter)/D85(soil) < 5 ; 4 < D15(filter)/D15(soil) < 20 ;
D50(filter)/D50(soil) < 25 — "developed from tests by Terzaghi … extended by the Corps of Engineers".
2. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon, §2.10 (p. 73–74):
Eq. 2.41 (D15)f/(D85)s < 5 and Eq. 2.42 (D15)f/(D15)s > 5 (page images read).
3. USACE EM 1110-2-2300 (2004), General Design and Construction Considerations for Earth and Rock-Fill
Dams, Appendix B: Table B-2 (category 4: D15 < 4 to 5 × d85), step f (permeability: D15 ≥ 3 to 5 ×
d15 "but no smaller than 0.1 mm"), step g / note 2 (maximum particle size 3 in. = 75 mm), and
paragraph B-6 with Figure B-1: a gap-graded base whose 85 % size is 5.2 mm overall but 0.1 mm for the
fine matrix.
WHAT THIS SUITE IS. These sources publish LIMITS, not worked filter-design answers: none of them prints
a numeric example "base soil → filter → verdict" that the engine could reproduce (EM 1110-2-1913
Appendix D's example is graphical and prints no numbers). Each test therefore checks that the engine
switches its verdict at the PUBLISHED limit — just inside passes, just outside fails (±1 %). That is
evidence the published numbers are implemented, not evidence of a published answer; it is reported as a
shortfall against the 20-value bar.
EXACT-LIMIT NOTE. Craig Eq. 2.41/2.42 and Lambe & Whitman print STRICT inequalities (< 5, > 5, < 25);
the engine's ratios are inclusive (≤ 5, ≥ 5, ≤ 25), so a ratio of exactly 5.000 passes where the books
would not. That is a boundary of measure zero for graphically read sizes, so it is not asserted either way.
NOT IMPLEMENTED BY THE ENGINE (and so not asserted): Lambe & Whitman's upper bound 20 on the permeability
ratio; EM 1110-2-2300's soil-category table (Table B-2 categories 1–3, e.g. D15 ≤ 0.7 mm for a broadly
graded base); Craig's D15 ≤ 0.5 mm for filters to fine soils; EM Eq. B-2 (D50 of filter ≥ 1 × the pipe
hole, where the engine instead checks the USBR D85 ≥ 2 × opening).
| Test block (the published value it checks) | Verdict |
| Lambe & Whitman 1969 Eq 19.10 / Craig 2012 Eq 2.41: D15f/D85s = 4.95 (< 5) passes the USACE retention limit | Pass |
| Lambe & Whitman 1969 Eq 19.10 / Craig 2012 Eq 2.41: D15f/D85s = 5.05 (> 5) fails the USACE retention limit | Pass |
| EM 1110-2-2300 Table B-2 (category 4, "D15 < 4 to 5 × d85"): the Terzaghi end of the band is 4 — 3.96 passes, 4.04 fails | Pass |
| Craig 2012 Eq 2.42: D15f/D15s = 5.05 (> 5) passes the USACE permeability limit, 4.95 fails | Pass |
| Lambe & Whitman 1969 Eq 19.11 (lower bound 4): D15f/D15s = 4.04 passes the Terzaghi permeability limit, 3.96 fails | Pass |
| Lambe & Whitman 1969 Eq 19.12: D50f/D50s = 24.75 (< 25) passes, 25.25 fails | Pass |
| EM 1110-2-2300 App. B step f: filter D15 = 0.1 mm is acceptable, 0.099 mm is not | Pass |
| EM 1110-2-2300 App. B step g: a filter D85 of 75 mm raises no oversize advisory, 75.1 mm does | Pass |
| EM 1110-2-2300 ¶B-6: with the total-sample d85 = 5.2 mm a D15 = 2 mm filter retains the base (ratio 0.38) | Pass |
| EM 1110-2-2300 ¶B-6: with the matrix d85 = 0.1 mm the same D15 = 2 mm filter fails retention (ratio 20) | Pass |
| ratios: 3 mm filter on the base D15/D50/D85 = 0.02/0.1/1 mm gives 3, 150 and 30 (hand arithmetic) | Pass |
| a cleared base D85 is refused rather than giving a ratio of 6e8 | Pass |
flow-net-seepage-web-validation.test.ts
flow-net-seepage — validation against PUBLISHED worked flow-net examples.
Analyses validated: flow-net-seepage · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
flow-net-seepage — validation against PUBLISHED worked flow-net examples.
`flow-net-seepage.ts`: q = k · H · (Nf/Nd) · width ; i_exit = (H/Nd) / l_last.
Published sources (each opened and read from the local reference library; page numbers are the
book's own printed numbers):
1. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon/Taylor & Francis,
Chapter 2 "Seepage": flow-net illustration Fig. 2.8 (p. 52), Example 2.1 (p. 54–55),
Example 2.2 (p. 55). Values printed in the worked solutions.
2. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version, 1979), Wiley,
Chapter 18 "Two-Dimensional Fluid Flow": one-dimensional flow net Fig. 18.1 (p. 266–267),
Example 18.1 (p. 268), Example 18.2 (p. 271), Example 18.4 (p. 273).
3. NAVFAC DM-7.01 (1986), Soil Mechanics, Chapter 5 Fig. 1 "Flow Net Construction and
Seepage Analysis" (p. 7.1-260), dry-dock underseepage example.
WHAT IS BEING CHECKED. The engine takes Nf, Nd (read off a flow net by the user) — these authors
read them off their own sketched nets, so the `Nf`/`Nd` used below are the values THEY printed.
What is tested is that, given the printed k, H, Nf, Nd (and last-field length), the engine returns
the printed shape factor, seepage quantity and exit gradient. Every expected value below is a
number printed in the cited source; the locator is next to it. Where a source rounds, the
tolerance is half of the last printed digit (stated in the comment).
Inputs the source does not print are marked "inferred": Lambe & Whitman Ex. 18.1 does not print
Nf, only the shape factor used (0.5); Nf = 4, Nd = 8 reproduces it and Nd = 8 is implied by the
printed head drop "7.5/8". Nothing in this file was computed with our own engine and labelled
published.
| Test block (the published value it checks) | Verdict |
| Craig 2012 Fig 2.8: sheet piling, Nf=3 Nd=8 → shape factor 0.375, q = 2.25e-5 m³/s/m | Pass |
| Craig 2012 Ex 2.1: cofferdam, Nf=6 Nd=10 H=4.50 → k = 2.6e-5 m/s from q = 0.25 m³/h/m | Pass |
| Craig 2012 Ex 2.1: forward check — printed k = 2.6e-5 reproduces printed inflow 0.25 m³/h/m | Pass |
| Craig 2012 Ex 2.1: hydraulic gradient below the excavation i = 0.50 (Δh = 4.50/10, Δs = 0.9 m) | Pass |
| Craig 2012 Ex 2.2: dam spillway Nf=3 Nd=10 → shape factor 0.3, q = 3.75e-5 m³/s/m | Pass |
| Craig 2012 Ex 2.2: a 60 m long spillway passes 60 × the per-metre seepage | Pass |
| Lambe & Whitman 1969 Fig 18.1: nf=4 nd=10 → shape factor 0.4 | Pass |
| Lambe & Whitman 1969 Fig 18.1: Q/L = 0.00096 m³/s/m (per metre), Q = 0.00115 m³/s over 1.2 m | Pass |
| Lambe & Whitman 1969 Fig 18.1: gradient i = H/(10 × 0.3) = 1.6 | Pass |
| Lambe & Whitman 1969 Ex 18.1: sheet pile wall → shape ½, Q/L = 18.75e-9 m³/s/m, exit i = 0.27 | Pass |
| Lambe & Whitman 1969 Ex 18.2: concrete dam nf=4 nd=12.6 → shape factor 0.317 | Pass |
| Lambe & Whitman 1969 Ex 18.2: Q/L = 0.00124 m³/s/m and gradient in square X = 0.19 | Pass |
| Lambe & Whitman 1969 Ex 18.4: earth dam nf=2.65 nd=9 → shape factor 0.294 | Pass |
| Lambe & Whitman 1969 Ex 18.4: Q/L = 5.36e-4 m³/s/m and gradient in square I = 0.40 | Pass |
| NAVFAC DM-7.01 Fig 1: dry-dock underseepage nf=6 nd=15 → 0.4 ft³/min per ft | Pass |
| Craig 2012 p.52: refining the net (Nf,Nd) = (3,8) → (6,16) leaves q unchanged | Pass |
| zero head loss → zero seepage and exit gradient (Darcy: no gradient, no flow) | Pass |
| invalid flow net (Nd = 0) is rejected, not silently floored (q would be 1e5 × too large) | Pass |
frost-depth-web-validation.test.ts
Validation for `frost-depth` — Stefan and modified-Berggren frost penetration (`frost-depth.ts`, `computeFrostDepth`).
Analyses validated: frost-depth · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `frost-depth` — Stefan and modified-Berggren frost penetration
(`frost-depth.ts`, `computeFrostDepth`).
Published sources (every number below was read from the text named beside it; none is recalled):
1. US Army TM 5-852-6 / AFR 88-19 Vol. 6 (1988), "Arctic and Subarctic Construction: Calculation Methods for
Determination of Depths of Freeze and Thaw in Soils", ¶3-2 Eq. 3-1 (X = λ·√(48·K·nF/L), US units) and
the ¶3-3 homogeneous-soil example (sandy silt): K_avg = 0.76 Btu/ft·h·°F, nF = 2600 °F-days, λ = 0.89,
L = 144·100·(w) = 2160 Btu/ft³, printed depth "≈ 5.8 ft". Read from the manual's OCR text, NOT from the
page image: the OCR prints "w = 16 %" against 144·100·0.16 = 2304, but the printed 2160 and the heat-capacity
line both need w = 0.15 (Pavement Interactive's reproduction of the same example states w = 15 % and
L = 2160), so w = 15 % is used. The OCR answer "5.8" is suspect too: the printed arithmetic
0.89·√(48·0.76·2600/2160) evaluates to 5.90 ft, so the tolerance below spans 5.8–5.9 ft.
2. Canadian Geotechnical Society (2006), Canadian Foundation Engineering Manual 4th ed., §13.4: latent heat
of fusion of water "L = 334 kJ/kg" and volumetric latent heat of water "334 MJ/m³".
3. Mitchell, J.K. & Soga, K. (2005), Fundamentals of Soil Behavior 3rd ed., Wiley — §9 "Ground freezing",
Eq. 9.172 (Stefan, Z = (2k_f ∫T_s dt / L)^½, with the freezing index F for ∫T_s dt) and Eq. 9.173
(modified Berggren, the Stefan depth multiplied by the correction coefficient λ).
SHORTFALL — formula-fidelity evidence only. One printed worked example (with a doubtful OCR answer) and two
printed constants were found. The canonical sources with more examples (Andersland & Ladanyi, "Frozen Ground
Engineering"; Aldrich 1956, HRB Bulletin 135; UFC 3-130-06) were not obtainable in this environment. The
engine takes λ as an INPUT (the manual reads it from a chart of thermal ratio and fusion parameter), so the
λ chart itself is not validated here.
| Test block (the published value it checks) | Verdict |
| TM 5-852-6 ¶3-3: volumetric latent heat 144·100·0.15 = 2160 Btu/ft³ | Pass |
| TM 5-852-6 ¶3-3: modified Berggren depth ≈ 5.8 ft (printed arithmetic 5.90 ft) | Pass |
| Canadian Foundation Engineering Manual §13.4: L = 334 kJ/kg of water and 334 MJ/m³ of pure water | Pass |
| Mitchell & Soga Eq. 9.172 / 9.173: the modified depth is λ times the Stefan depth | Pass |
grain-size-permeability-web-validation.test.ts
grain-size-permeability — validation of the Hazen branch (and the temperature dependence used by the Kozeny–Carman branch) against PUBLISHED tabulated values.
Analyses validated: grain-size-permeability · Recorded run: passed — 32 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
grain-size-permeability — validation of the Hazen branch (and the temperature dependence used by the
Kozeny–Carman branch) against PUBLISHED tabulated values. `grain-size-permeability.ts`:
Hazen: k [cm/s] = C · D10² [mm²], C ≈ 0.4–1.2 (default 1.0), valid 0.1 ≤ D10 ≤ 3 mm and Cu < 5
K–C: k = (g/(C_KC·ν(T))) · e³/(1+e) · D10² (ν from a Poiseuille-type polynomial)
Published sources (opened and read; page numbers are the books' own):
1. Look, B.G. (2007), Handbook of Geotechnical Investigation and Design Tables, Taylor & Francis /
Balkema, Table 8.3 "Permeability based on Hazen's relationship" (p. 93): k for D10 = 0.1 … 1.0 mm.
Page image checked by eye.
2. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon, Eq. 2.4 (p. 41):
k = 10⁻² D10² (m/s) with D10 in mm, and the printed temperature statement "the values at 10 and 0 °C
are 77 % and 56 %" of the value at 20 °C.
3. FHWA NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, §5.6.4 Eq. 5-14 (p. 5-61):
k [cm/s] = C·(D10 [mm])², C = 0.4–1.2, "D10 sizes between 0.1 and 3.0 mm", clean sands only.
4. Freeze, R.A. & Cherry, J.A. (1979), Groundwater, Prentice-Hall, Eq. (8.47): "For K in cm/s and d10 in
mm, the coefficient A ... is equal to 1.0" (Groundwater Project edition, read 2026-10-07).
5. USACE EM 1110-2-1906 (1970), Laboratory Soils Testing, Appendix VII Table VII-1: the printed viscosity
correction factor R_T = μ(T)/μ(20 °C) "computed from Table 170, Smithsonian Physical Tables".
HOW THE LOOK TABLE IS MAPPED. The table prints only k, labelled with C = 0.10 and C = 0.15. Its entries
equal 1.0·D10² and 1.5·D10² in cm/s with D10 in mm, i.e. the ENGINE's C = 1.0 and 1.5 (a factor-10
difference in how Look labels C — inferred from the printed numbers, pattern (10·D10)²·10⁻⁴ m/s, and
stated here rather than assumed). The 'C = 0.15' row corresponds to the engine's C = 1.5, outside the
0.4–1.2 range of FHWA Eq. 5-14; the engine must (and does) warn for it.
Tolerance for each Look entry = half of its last printed digit (the table prints 1–2 significant figures).
One printed cell reads "1,2" (decimal comma) and is read as 1.2.
NOT COVERED. No source read prints a worked Kozeny–Carman NUMBER, so the absolute K–C value (and the
engine's constant 1.79e-6 m²/s in ν(T)) has no published anchor here. Only the TEMPERATURE RATIO of the
K–C branch is tested (EM 1110-2-1906 Table VII-1). That ratio uses the engine's viscosity polynomial,
which differs from the printed table by 0.2–0.3 % for 10–40 °C (0.7 % at 5 °C, 1.2 % at 0 °C): the
tolerance below (0.5 %) states the accuracy of that correlation, not the table's rounding.
| Test block (the published value it checks) | Verdict |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.1 mm → k = 1e-4 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.2 mm → k = 4e-4 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.3 mm → k = 0.9e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.4 mm → k = 1.6e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.5 mm → k = 2.5e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.6 mm → k = 3.6e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.7 mm → k = 4.9e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.8 mm → k = 6.4e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 0.9 mm → k = 0.8e-2 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.10 ≙ engine C = 1.0): D10 = 1.0 mm → k = 1.0e-2 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.1 mm → k = 1.5e-4 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.2 mm → k = 6e-4 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.3 mm → k = 1.4e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.4 mm → k = 2.4e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.5 mm → k = 3.8e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.6 mm → k = 5.4e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.7 mm → k = 7.4e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.8 mm → k = 9.6e-3 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 0.9 mm → k = 1.2e-2 m/s | Pass |
| Look 2007 Table 8.3 (row C = 0.15 ≙ engine C = 1.5): D10 = 1.0 mm → k = 1.5e-2 m/s | Pass |
| Look 2007 Table 8.3 "C = 0.15" row lies outside FHWA Eq. 5-14 (C = 0.4–1.2): the engine warns | Pass |
| Craig 2012 Eq 2.4: k = 10⁻² D10² m/s — D10 = 0.3 mm ⇒ 9e-4 m/s with the default C | Pass |
| Freeze & Cherry 1979 Eq 8.47: A = 1.0 for K in cm/s and d10 in mm — the engine default | Pass |
| FHWA 2006 Eq 5-14: Hazen is valid for D10 from 0.1 to 3.0 mm (inclusive) and not outside | Pass |
| Look 2007 §8.3: Hazen is "ideally for uniformly graded material with U < 5" | Pass |
| USACE EM 1110-2-1906 Table VII-1: R_T(10 °C) = 1.301 ⇒ k(10)/k(20) = 0.769 | Pass |
| USACE EM 1110-2-1906 Table VII-1: R_T(15 °C) = 1.135 ⇒ k(15)/k(20) = 0.881 | Pass |
| USACE EM 1110-2-1906 Table VII-1: R_T(25 °C) = 0.889 ⇒ k(25)/k(20) = 1.125 | Pass |
| USACE EM 1110-2-1906 Table VII-1: R_T(30 °C) = 0.797 ⇒ k(30)/k(20) = 1.255 | Pass |
| USACE EM 1110-2-1906 Table VII-1: R_T(40 °C) = 0.653 ⇒ k(40)/k(20) = 1.531 | Pass |
| Craig 2012 p.41: at 10 °C the permeability is 77 % of its 20 °C value | Pass |
| a cleared D10 is refused rather than reported as k = 1e-18 cm/s ("impermeable") | Pass |
insitu-groundwater-web-validation.test.ts
Web-benchmark validation for TWELVE anchor/pile, in-situ-test, groundwater and liquefaction-residual runner engines.
Analyses validated: cptu-dissipation, dewatering-system, drilled-shaft, earth-dam-seepage, ground-anchor, micropile, post-liquefaction-strength, spt-correction, subgrade-reaction, triaxial-csl, vacuum-preload, well-foundation · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for TWELVE anchor/pile, in-situ-test, groundwater and
liquefaction-residual runner engines. Family suite — `runner-coverage.mjs` counts ENGINES.
ENGINES AND SOURCES
ground-anchor — BS 8081:2015; PTI DC35.1-14; Littlejohn & Bruce (1975)
vacuum-preload — Kjellman (1952); Indraratna et al. (2005); Hansbo (1981) PVD
drilled-shaft — O'Neill & Reese (1999) FHWA-IF-99-025; Brown et al. GEC-10
micropile — FHWA-NHI-05-039 Eq 5-3/5-4
triaxial-csl — Schofield & Wroth (1968); BS 1377-8 / ASTM D4767
cptu-dissipation — Teh & Houlsby (1991) Géotechnique 41(1); Mayne (2007)
dewatering-system — Sichardt radius; Thiem/Dupuit; CIRIA C750; IS 9759
earth-dam-seepage — Casagrande (1937) basic parabola
subgrade-reaction — Vesić; Bowles; IS 2950
well-foundation — IRC 45:1972 elastic theory (Coulomb K_a/K_p)
spt-correction — IS 2131:2025 §5.6; Peck-Hanson-Thornburn (1974)
post-liquefaction-strength — Olson & Stark (2002) CGJ; Seed & Harder (1990)
Every expected value is reconstructed from the published expression in code. Where a
composite code procedure could not be traced by hand (the IRC 45 combined second moment, the
FHWA side-resistance exclusion lengths, the IS 2131 full correction chain) the engine is
anchored on the parts that ARE citable plus structural bounds, rather than on a guessed value.
TOLERANCES: several of these engines round outputs for display. Per the note in batch 7ae,
the "printed values reproduce the printed conclusion" standard is applied at each engine's
display precision, not at machine precision.
| Test block (the published value it checks) | Verdict |
| ground-anchor uses the BS 8081 grout-ground bond and the tendon limit | Pass |
| vacuum-preload combines the effective vacuum with Terzaghi 1-D settlement | Pass |
| drilled-shaft uses the O'Neill-Reese α method and N_c = 9 base | Pass |
| micropile applies the FHWA-NHI-05-039 bond and composite-section limits | Pass |
| triaxial-csl fits the CSL through p-q states and recovers φ′ | Pass |
| cptu-dissipation reproduces Teh & Houlsby (1991) | Pass |
| dewatering-system uses the Sichardt radius and the Dupuit unconfined flow | Pass |
| earth-dam-seepage reproduces the Casagrande (1937) basic parabola | Pass |
| subgrade-reaction returns k_s = q/δ and converts units consistently | Pass |
| well-foundation uses Coulomb K_a/K_p and IRC 45 elastic theory | Pass |
| spt-correction applies the Peck overburden factor over the IS 6403 bearing zone | Pass |
| post-liquefaction-strength applies Olson & Stark (2002) | Pass |
⚑ layered-permeability-web-validation.test.ts
layered-permeability — validation of the equivalent horizontal (arithmetic) and vertical (harmonic) permeability of a layered deposit against PUBLISHED numbers.
Analyses validated: layered-permeability · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
layered-permeability — validation of the equivalent horizontal (arithmetic) and vertical (harmonic)
permeability of a layered deposit against PUBLISHED numbers. `layered-permeability.ts`:
k_h = Σ(kᵢhᵢ)/Σhᵢ k_v = Σhᵢ/Σ(hᵢ/kᵢ) k_h/k_v ≥ 1
Published sources (opened and read):
1. Viswanathan, B.V.S. (2013), "Soil Mechanics", NPTEL course 105101084 (IIT Bombay), Lecture 24
"Flow of water through soils-V" (transcript, http://elearn.psgcas.ac.in/nptel/courses/video/
105101084/lec24.pdf, read 2026-10-07; spelling as printed in the transcript header): worked example of
flow PARALLEL to three sand layers (k = 1×10⁻⁴, 0.5×10⁻⁴ and 2×10⁻⁴ m/s; H = 6, 4 and 3 m) ending
"equivalent coefficient of permeability ... 1.077 × 10⁻⁴ m/s". The year 2013 is the creation date of
the transcript file (PDF metadata); the lecture-series recording date is not printed in it.
2. Freeze, R.A. & Cherry, J.A. (1979), Groundwater, Prentice-Hall, §2.5 Eq. (2.31)–(2.32) (p. 34):
"if we consider a set of cyclic couplets K1, K2, K1, K2, … with K1 = 10⁴ and K2 = 10², then
Kx/Kz = 25. For K1 = 10⁴ and K2 = 1, Kx/Kz = 2500", and "Kx > Kz for all possible sets of values".
Read from the Groundwater Project edition, https://fc79.gw-project.org/english/chapter-2/.
3. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley, Example 18.5(b) (p. 276):
two tubes in parallel, k = 0.05 and 0.005 cm/s, printed Q/L = 0.45 × 10⁻³ and 0.045 × 10⁻³
(m³/s)(m). Its part (a) prints an exponent its own arithmetic does not reproduce and is not used.
HONEST SCOPE. These are the only worked NUMERIC results for equivalent layered permeability found in the
local library and the web pages opened: the textbooks there (Craig §2.2, Das §2.10, Mitchell & Soga) give
the equations and qualitative statements but no worked k_h/k_v number; Lambe & Whitman and Holtz & Kovacs
carry theirs in pages that are scans without a text layer and the relevant pages were not located. The
number of distinct published values is therefore small (4 numbers, 1 inequality) and is reported as a
shortfall against the 20-value bar, not padded.
| Test block (the published value it checks) | Verdict |
| NPTEL 105101084 Lecture 24: k = 1, 0.5, 2 (×10⁻⁴ m/s), H = 6, 4, 3 m → k_h = 1.077e-4 m/s | Pass |
| Freeze & Cherry 1979 §2.5: couplets K1 = 10⁴, K2 = 10² → Kx/Kz = 25 | Pass |
| Freeze & Cherry 1979 §2.5: couplets K1 = 10⁴, K2 = 1 → Kx/Kz = 2500 | Pass |
| Freeze & Cherry 1979 §2.5: "Kx > Kz for all possible sets of values of K1 … Kn" | Pass |
| Lambe & Whitman 1969 Ex 18.5(b): parallel tubes A (0.05 cm/s) + B (0.005 cm/s) → total Q/L = 0.495e-3 m³/s/m | Pass |
| a zero-permeability layer is refused rather than reported as an impermeable profile | Pass |
percolation-web-validation.test.ts
Web-benchmark validation for `percolation` — falling-head percolation / infiltration test used to size soak pits and storm-water recharge.
Analyses validated: percolation · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `percolation` — falling-head percolation / infiltration test
used to size soak pits and storm-water recharge.
SOURCES (each cited at the assertion that uses it):
IS 2470 (Part 1):1985 — septic tanks: design criteria; percolation rate → soak-pit area.
USEPA "Onsite Wastewater Treatment Systems Manual" (2002) §5 — the percolation test
procedure and the minutes-per-25 mm (1 inch) suitability classes.
Porchet / USEPA falling-head cylindrical relation, which accounts for BASE + SIDEWALL
infiltration rather than base only:
k = (r/2)·ln[(r + 2h₁)/(r + 2h₂)] / Δt
Bouwer (1986) — field infiltration rate ≈ field-saturated hydraulic conductivity.
Per the method note added in batch 7t, every expected value RECONSTRUCTS its chain from the
published formula in code; printed decimals are quoted only to the precision they are good to.
| Test block (the published value it checks) | Verdict |
| the percolation rate is the steady-state drop rate, with a consistent unit chain | Pass |
| the reference drop is configurable but the CLASS stays per 25 mm | Pass |
| suitability bands break at the published 4 / 12 / 30 / 60 min-per-25 mm edges | Pass |
| an unsuitable result warns, and a rapid one warns about groundwater | Pass |
| Porchet k matches the published cylindrical falling-head relation | Pass |
| Porchet is withheld, with a reason, when the head cannot support it | Pass |
| soak-pit area is design flow over the allowable infiltration, with FoS 2 | Pass |
| sizing an area always carries the septic-effluent under-sizing warning | Pass |
| a hole that was not pre-soaked for 24 h is flagged | Pass |
| a rate that has not stabilised is flagged rather than averaged away | Pass |
| only the last three intervals set the rate — earlier transients are excluded | Pass |
pump-test-web-validation.test.ts
PUBLISHED-VALUES: 17 -- distinct published values for this engine (engine-level total, declared once); author's own count of published numbers, excluding 2 pass/fail verdicts.
Analyses validated: pump-test · Recorded run: passed — 19 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 17 -- distinct published values for this engine (engine-level total, declared once); author's own count of published numbers, excluding 2 pass/fail verdicts. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
pump-test — validation of the straight-line (Jacob) pumping-test interpretation against PUBLISHED
worked field examples. `pump-test.ts`:
T = 2.303·Q / (4π·Δs) S = 2.25·T·t0 / r² k = T / b
(Δs = drawdown per log-cycle of time, t0 = zero-drawdown time intercept, r = observation distance.)
Published sources (opened and read; page numbers are the books' own printed numbers):
1. Kruseman, G.P. & de Ridder, N.A. (1990), Analysis and Evaluation of Pumping Test Data, 2nd ed.,
ILRI Publication 47, Wageningen (the copy read is the 2000 reprint, hydrology.nl, read 2026-10-07).
Eq. 3.8/3.9 and WORKED EXAMPLES with their printed inputs and printed results:
Example 3.4 (p. 68) 'Oude Korendijk', r = 30 m → KD = 385 m²/d, S = 1.7e-4
Example 3.6 (p. 70) 'Oude Korendijk', s vs t/r² plot → KD = 437 m²/d, S = 1.7e-4
Example 8.1 (p. 136) Papadopulos' anisotropic test → KD = 173 m²/d and S/KD at 3 wells
Example 15.1 (p. 224) 'Hoogezand' single-well test → KD = 1800 m²/d
Example 17.1 (p. 260–261) fractured volcanic rock, UE-25b#1 → T = 333 m²/d, S = 0.146 / 0.15
2. Freeze, R.A. & Cherry, J.A. (1979), Groundwater, Prentice-Hall, §8.6 "Semilog plots" Eq. (8.45)–(8.46):
the printed unit-conversion coefficients of the Cooper–Jacob equations (C = 0.18 and D = 2.25 in SI;
C = 264 and D = 0.3 in US gal/min, gal/day/ft, ft, days). Read from the Groundwater Project edition,
https://fc79.gw-project.org/english/chapter-8/ on 2026-10-07.
HOW THE ENGINE IS EXERCISED. Each example is run with ITS printed Q, Δs, t0 and r; the engine's T and S
are compared with the printed answers. Where the book worked in minutes, the intercept is converted
with the exact 1 d = 1440 min. Tolerances are the printed precision (and, where the book used 2.30 and
3.14 instead of 2.303 and π, the resulting ≤ 0.3 % arithmetic difference) — stated at each assertion.
The aquifer thickness b is not an input of any published example's answer: k = T/b is checked only as
arithmetic on the engine's own T, and is labelled as such.
| Test block (the published value it checks) | Verdict |
| Kruseman & de Ridder Ex 3.4: Oude Korendijk, Δs = 0.375 m → KD = 385 m²/d | Pass |
| Kruseman & de Ridder Ex 3.4: Oude Korendijk, t0 = 0.25 min, r = 30 m → S = 1.7e-4 | Pass |
| Kruseman & de Ridder Ex 3.4: S = 1.7e-4 is classified as a confined aquifer, as the book treats the test | Pass |
| Kruseman & de Ridder Ex 3.6: Δs = 0.33 m → KD = 437 m²/d | Pass |
| Kruseman & de Ridder Ex 3.6: (t/r²)0 = 2.45e-4 min/m² → S = 1.7e-4 | Pass |
| Kruseman & de Ridder Ex 8.1: Papadopulos test, Δs = 1.15 m → (KD)e = 173 m²/d | Pass |
| Kruseman & de Ridder Ex 8.1: OW-1 S/KD = 7.22e-7 d/m² | Pass |
| Kruseman & de Ridder Ex 8.1: OW-2 S/KD = 9.35e-7 d/m² | Pass |
| Kruseman & de Ridder Ex 8.1: OW-3 S/KD = 9.39e-7 d/m² | Pass |
| Kruseman & de Ridder Ex 15.1: Hoogezand, Q = 28.7 m³/h, Δs = 0.07 m → KD = 1800 m²/d | Pass |
| Kruseman & de Ridder Ex 17.1: UE-25b#1, Δs = 1.70 m → T = 333 m²/d | Pass |
| Kruseman & de Ridder Ex 17.1: t2 = 3.4e-3 min, r_w = 0.11 m → S = 0.15 (printed 0.146) | Pass |
| Kruseman & de Ridder Ex 17.1: S = 0.15 is "the specific yield of unconfined aquifers" (book, p.261) | Pass |
| Freeze & Cherry 1979 Eq 8.45: SI coefficient C = 0.18 in T = C·Q/Δs | Pass |
| Freeze & Cherry 1979 Eq 8.46: SI coefficient D = 2.25 in S = D·T·t0/r² | Pass |
| Freeze & Cherry 1979 Eq 8.45: US-unit coefficient C = 264 (T in gal/day/ft, Q in gal/min, Δs in ft) | Pass |
| Freeze & Cherry 1979 Eq 8.46: US-unit coefficient D = 0.3 (T in gal/day/ft, t in days, r in ft) | Pass |
| k = T/b is arithmetic on the engine's T (hand check: 385.1/7 = 55.0 m/d) | Pass |
| a cleared Δs is refused rather than giving T ≈ 1e11 (the measured failure of the old floor) | Pass |
quick-condition-web-validation.test.ts
quick-condition — validation of the critical hydraulic gradient, exit gradient and factor of safety against heave/boiling against PUBLISHED worked examples and tables.
Analyses validated: quick-condition · Recorded run: passed — 17 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
quick-condition — validation of the critical hydraulic gradient, exit gradient and factor of safety
against heave/boiling against PUBLISHED worked examples and tables. `quick-condition.ts`:
i_cr = (Gs − 1)/(1 + e) = γ′/γw i_e = Δh / L FoS = i_cr / i_e
Published sources (opened and read; page numbers are the books' own):
1. Holtz, R.D. & Kovacs, W.D. (1981), An Introduction to Geotechnical Engineering, Prentice-Hall,
Chapter 7 "Water in soils II" (a scanned copy, read by OCR and the key pages checked by eye):
Table 7-1 "Typical values of i_c for ρs = 2.68 Mg/m³" (p. 235), Examples 7.13–7.14 (p. 235–238),
Example 7.19 exit gradient at a dam toe (p. 256–257).
2. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics, 8th ed., Spon: §3.7 (p. 91) and
Example 3.4 (p. 95) — factor of safety against heave adjacent to sheet piling.
3. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley: exit gradients printed in
Examples 18.1 (0.27), 18.2 (0.19) and 18.4 (0.40), p. 268–273.
4. Bond, A.J., Schuppener, B., Scarpelli, G. & Orr, T.L.L. (2013), Eurocode 7: Geotechnical Design —
Worked examples, JRC Report EUR 26227 EN, Appendix A.6.2 "Verification against failure of hydraulic
heave" (p. 140–141): h_r = 2.13 m, embedment t = 6.60 m, gradient 0.32, γ′ = 10 kN/m³.
5. Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage, §15.8 (p. 802–803):
"A factor of safety of about 1.5 is desirable."
Inputs the sources do not print are marked "assumed" at the test. Tolerances are the printed precision.
| Test block (the published value it checks) | Verdict |
| Holtz & Kovacs 1981 Table 7-1: dense sand e = 0.5, Gs = 2.68 → i_c = 1.12 | Pass |
| Holtz & Kovacs 1981 Table 7-1: medium sand e = 0.75, Gs = 2.68 → i_c = 0.96 | Pass |
| Holtz & Kovacs 1981 Table 7-1: loose sand e = 1, Gs = 2.68 → i_c = 0.84 | Pass |
| Holtz & Kovacs 1981 Ex 7.13: Gs = 2.65, e = 0.65 → i_c = 1.0 | Pass |
| Holtz & Kovacs 1981 Ex 7.13: a head of 5.0 m over the 5 m sample is exactly the quick condition (FoS = 1) | Pass |
| Holtz & Kovacs 1981 Ex 7.13: the engine calls i = i_c a quick condition (effective stress is zero there) | Pass |
| Holtz & Kovacs 1981 Ex 7.14: seepage force per unit volume at quick conditions j = 9.81 kN/m³ | Pass |
| Holtz & Kovacs 1981 Ex 7.19: exit gradient = (12/10.4)/8.5 = 0.14, "not critical" | Pass |
| Lambe & Whitman 1969 Ex 18.1: sheet pile, Δh = 7.5/8 m over l = 3.45 m → exit gradient 0.27 | Pass |
| Lambe & Whitman 1969 Ex 18.2: concrete dam, Δh = 7.8/12.6 m over l = 3.3 m → gradient in square X = 0.19 | Pass |
| Lambe & Whitman 1969 Ex 18.4: earth dam, Δh = 12/9 m over l = 3.36 m → gradient in square I = 0.40 | Pass |
| Craig 2012 Ex 3.4: γsat = 20 kN/m³ → γ′ = 10.2 kN/m³ and i_cr = 1.04 | Pass |
| Craig 2012 Ex 3.4: h_m = 2.6 m over 6 m → average gradient i_m = 0.43 and F = 2.4 | Pass |
| Bond et al. 2013 EC7 A.6.2: h_r = 2.13 m over t = 6.60 m → gradient 0.32 | Pass |
| Bond et al. 2013 EC7 A.6.2: γ′ = 10 kN/m³ when i_cr = 1 and γw = 10 kN/m³ | Pass |
| Das 2016 §15.8: FoS = 1.5 is where the engine stops calling the state marginal | Pass |
| a cleared seepage length is refused, not floored to 1e-9 m | Pass |
seepage-fe-mesh-web-validation.test.ts
Web-benchmark validation for the TerraCore general-mesh 2-D seepage FE (`seepage-fe-mesh.ts`).
Analyses validated: mesh-viewer, seepage · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the TerraCore general-mesh 2-D seepage FE
(`seepage-fe-mesh.ts`). the release rules gate: ≥12 cited values against independent
closed forms / textbook results. Compression-positive / inflow-positive
convention. Solved with the shared CG kernel (`linear-solver-cg.ts`).
Independent anchors (all citable, live/textbook):
• 1-D confined flow between two heads → LINEAR head field h(x)=h1−(Δh/L)x and
Darcy discharge q = k·(Δh/L)·A, velocity v = k·Δh/L (Darcy 1856; Harr,
"Groundwater and Seepage" §1–2; Das, "Principles of Geotechnical
Engineering" 7e, Ch.8 Eq.8.x). → 6 values
• Continuity: total inflow = total outflow. → 1 value
• Same linear field is exact on an UNSTRUCTURED Delaunay mesh (CST reproduces
a linear potential exactly — Zienkiewicz & Taylor Vol 1 patch test). → value
• Flow-net shape factor: Q = k·Δh·(N_f/N_d), with N_f/N_d = H/L for the
confined rectangle (Cedergren, "Seepage, Drainage and Flow Nets" Ch.4;
Harr §2). → 2 values
• Radial (Thiem) flow to a well: h(r)=h_w+(H−h_w)·ln(r/r_w)/ln(R/r_w) and
sector discharge Q_θ = θ·k·(H−h_w)/ln(R/r_w) (Thiem 1906; Harr §5; Das
Ch.8). → 4 values
• Unconfined (phreatic) flow through a rectangular section on a horizontal
impervious floor: Dupuit/Charny EXACT discharge q = (k/2L)(h1²−h2²)
(Dupuit 1863; Charny 1951; Harr §2.6/§4). → 2 values
| Test block (the published value it checks) | Verdict |
| 1-D confined: linear head, Darcy q and velocity (Harr §2, Das Ch.8) | Pass |
| confined discharge scales linearly with k (Darcy) | Pass |
| anisotropic ky does not change purely horizontal discharge | Pass |
| 1-D confined on an unstructured Delaunay mesh reproduces the linear field | Pass |
| flow-net: Q/(k·Δh) equals the shape factor N_f/N_d = H/L (Cedergren §4) | Pass |
| Thiem radial: logarithmic head + Q_θ = θ·k·Δh/ln(R/r_w) (Thiem 1906, Harr §5) | Pass |
| unconfined dam section: q = (k/2L)(h1²−h2²) (Dupuit 1863 / Charny 1951, Harr §2.6) | Pass |
seepage-web-validation.test.ts
Formula-fidelity validation against Terzaghi & Peck; Das, "Principles of Geotechnical Engineering" Sec.7-8; Casagrande (1937) transformed-section method; Thiem (1906) and Dupuit (1863) steady-state well-flow theory; Sichardt's empirical ra…
Analyses validated: seepage · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against Terzaghi & Peck; Das, "Principles of
Geotechnical Engineering" Sec.7-8; Casagrande (1937) transformed-section
method; Thiem (1906) and Dupuit (1863) steady-state well-flow theory;
Sichardt's empirical radius-of-influence formula -- all cited in this
module's own header. Every function here is a fully closed-form textbook
equation, hand-computed independently in Python and matched to full
precision.
| Test block (the published value it checks) | Verdict |
| [1] flow-net discharge q = k.H.(Nf/Nd): k=1e-5 m/s, H=5m, Nf=6, Nd=12 -> q=2.5e-5 m3/s per unit width | Pass |
| [2] critical hydraulic gradient ic = (Gs-1)/(1+e): Gs=2.65, e=0.6 -> ic=1.031250 | Pass |
| [3] piping factor of safety FoS = ic/i_exit: ic=1.03, i_exit=0.5 -> FoS=2.06 | Pass |
| [4] Thiem (1906) confined well discharge Q = 2.pi.T.s/ln(R/rw): k=1e-5, b=10m, s=3m, R=200m, rw=0.15m -> Q=2.619654e-4 m3/s | Pass |
| [5] Dupuit (1863) unconfined well discharge Q = pi.k.(H^2-hw^2)/ln(R/rw): k=1e-5, H=15m, hw=8m, R=200m, rw=0.15m -> Q=7.029405e-4 m3/s | Pass |
| [6] Sichardt empirical radius of influence R = 3000.s.sqrt(k): s=3m, k=1e-5 m/s -> R=28.460499m | Pass |
| [7] Casagrande equivalent isotropic permeability k_eq = sqrt(kx.ky): kx=2e-5, ky=8e-6 -> k_eq=1.264911e-5 m/s | Pass |
| [8] Casagrande transformed-section horizontal scale factor = sqrt(ky/kx): kx=2e-5, ky=8e-6 -> scale=0.632456 | Pass |
| [9] critical gradient at the exact physical boundary (Gs=1 or e undefined) returns NaN, never a fabricated finite number | Pass |
| [10] piping FoS at zero exit gradient returns Infinity (no upward flow, no piping risk), not a divide-by-zero NaN | Pass |
| [11] Thiem discharge scales exactly linearly with drawdown s, per the closed-form (Q proportional to s) | Pass |
| [12] invalid inputs throw rather than returning a silently-fabricated number (Nd<=0, kx/ky<=0) | Pass |
transient-seepage-web-validation.test.ts
Validation for the transient unsaturated-seepage (Richards) engine (`transient-seepage.ts`).
Analyses validated: transient-seepage · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the transient unsaturated-seepage (Richards) engine
(`transient-seepage.ts`). the release rules gate. Anchors:
- van Genuchten (1980) — Se = [1+(α|ψ|)^n]^(−m); Se(0)=1, Se(−1/α)=2^(−m),
Se→0 as ψ→−∞; θ = θr + Se(θs−θr).
- Mualem (1976) — K(0)=Ks, K monotone decreasing with suction.
- Celia, Bouloutas & Zarba (1990) — the mixed-form scheme conserves mass:
∫inflow − ∫outflow = Δstorage (mass-balance error → 0).
- Green & Ampt / Richards — a wetting front advances monotonically under
surface infiltration; the surface wets toward θs.
- Unit-gradient steady state — under a constant flux q < Ks with free
drainage, the column reaches steady throughput (drainage rate → q).
| Test block (the published value it checks) | Verdict |
| Celia-Bouloutas-Zarba (1990) benchmark θ(ψ) — the canonical Richards test soil | Pass |
| van Genuchten SWCC + Mualem K anchors | Pass |
| mass is conserved (Celia et al. 1990): infiltration = Δstorage + drainage | Pass |
| a wetting front advances monotonically under infiltration | Pass |
| the surface wets toward θs under infiltration; θ stays within [θr, θs] | Pass |
| unit-gradient steady state: drainage rate → applied flux (q < Ks) | Pass |
| ponded-head top BC infiltrates faster than a small flux; input validation | Pass |
| audit: a fully non-converged solve is REFUSED, not reported from the imposed flux | Pass |
| audit: K_s far outside any real soil is refused before the solve even runs | Pass |
| audit: an implausible infiltration flux is refused before the solve | Pass |
| audit: a refused run is NaN, not 0 — the client renders "—", not "0.0 mm" | Pass |
| audit: the real, valid case is unaffected by the new bounds | Pass |
unconfined-seepage-web-validation.test.ts
C.FE.3 — FE unconfined (free-surface / phreatic) seepage web-benchmark.
Analyses validated: fe-seepage, unconfined-seepage · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
C.FE.3 — FE unconfined (free-surface / phreatic) seepage web-benchmark.
The engine finds the phreatic line + discharge for flow between an upstream
reservoir (h1) and a downstream tailwater (h2) across a rectangular section on
an impermeable base (embankment / dewatered-excavation seepage). It is
validated against the Dupuit-Forchheimer discharge, which Charny (1951) proved
EXACT for the discharge even though the Dupuit phreatic line is approximate:
q = k · (h1² − h2²) / (2·L) per unit width
phreatic line h(x)² = h1² − (h1²−h2²)·x/L (Dupuit parabola)
Sources:
- Dupuit (1863); Forchheimer; Charny (1951) — exactness of the discharge.
- Harr, M.E. (1962) "Groundwater and Seepage" — unconfined flow, §2-4.
- Bathe & Khoshgoftaar (1979) — FE free-surface (material-property) method.
| Test block (the published value it checks) | Verdict |
| C.FE.3: FE discharge matches the exact Dupuit q within 8% | Pass |
| C.FE.3: phreatic line follows the Dupuit parabola h(x)²=h1²−(h1²−h2²)x/L | Pass |
| C.FE.3: free surface starts at h1 upstream and is monotonically falling | Pass |
| C.FE.3: discharge scales linearly with k and quadratically with head | Pass |
| C.FE.3: near-equal reservoir levels → near-zero discharge | Pass |
| C.FE.3: input guards return clean errors, not NaN/crash | Pass |
Heat transfer, freezing and solute transport
FE kernel registry — 18 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
k9-rs2-plate-centre | T(0.5, 0.5), square plate 100 / 500 °C [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §1 pp. 5–10 (Eq. 1.8) | — | 200 | 200 | — | 0.00 % | Pass |
k9-rs2-plate-0.5-0.75 | T(0.5, 0.75) [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §1 (Eq. 1.8) | — | 316.212 | 316.212 | — | 0.00 % | Pass |
k9-rs2-rod-x0 | T(0, 1), unit flux into a rod [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §3 pp. 13–14 (Eq. 3.1; Nithiarasu & Lewis Ex. 6.4.2) | — | 1.12838 | 1.12833 | — | −4.4e-3 % | Pass |
k9-rs2-rod-x1 | T(1, 1) [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §3 (Eq. 3.1) | — | 0.39928 | 0.39928 | — | 0.00 % | Pass |
k9-rs2-rod-x2 | T(2, 1) [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §3 (Eq. 3.1) | — | 0.10051 | 0.10051 | — | 0.00 % | Pass |
k9-rs2-convective-1h | surface T after 1 h (h 40, T∞ −15, from 20 °C) [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §4 pp. 15–17 (C&J) | — | -4.8568 | -4.8506 | — | +0.13 % | Pass |
k9-rs2-convective-1d | surface T after 1 day [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §4 (C&J) | — | -12.6642 | -12.6634 | — | +6.3e-3 % | Pass |
k9-nafems-t4 | T_E, NAFEMS T4 (steady, convection) [°C] | Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_8_HeatTransferAnalysis.pdf, p. §8.1 Table 8.1.1 | — | 18.3 | 18.2558 | — | −0.24 % | Pass |
k9-nafems-t3 | T_C(32 s), harmonic end temperature 100 sin(πt/40) [°C] | Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_8_HeatTransferAnalysis.pdf, p. §8.3 Table 8.3.1 | — | 36.6 | 36.6029 | — | +7.9e-3 % | Pass |
k9-barlow-davis | T_C(58 s), Barlow & Davis 1987 [°C] | Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_8_HeatTransferAnalysis.pdf, p. §8.4 Table 8.4.1 | — | 9.62 | 9.6095 | — | −0.11 % | Pass |
k9-rs2-forced-convection-npe | Péclet number N_PE = C_w q L / λ [–] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §7 pp. 25–27 (Eq. 7.3) | — | 4.186 | 4.186 | — | 0.00 % | Pass |
k9-rs2-forced-convection-down-y0.05 | T(0.05 m), downward flow [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §7 (Eq. 7.2) | — | 0.51001 | 0.51001 | — | 0.00 % | Pass |
k9-rs2-forced-convection-up-y0.25 | T(0.25 m), upward flow [°C] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §7 (Eq. 7.2) | — | 0.48999 | 0.48999 | — | 0.00 % | Pass |
k9-neumann-front-100d | thaw front after 100 days [m] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §5 pp. 18–20 (set-up); C&J §11.2 | — | 0.3748 | 0.3748 | — | 0.00 % | Pass |
k9-neumann-front-10d | thaw front after 10 days [m] | Rocscience-RS2-Thermal-Analysis-Verification.pdf, p. §5; C&J §11.2 | — | 0.1185 | 0.1186 | — | +0.08 % | Pass |
k9-hollow-cylinder-q | heat flow through a hollow cylinder (axisymmetric, per radian) [W/rad] | —, p. C&J §7.2 | — | 11.6769 | 11.6769 | — | 0.00 % | Pass |
k9-ogata-banks-x1.2-t3 | c/c0 at 1.2 m after 3 days (v 0.4 m/d, D 0.0041 m²/d) [–] | —, p. Ogata & Banks (1961) USGS PP 411-A | — | 0.526 | 0.5256 | — | −0.08 % | Pass |
k9-vga-retarded-decay-x0.4-t4 | c/c0 at 0.4 m after 4 days (R 2.6, t½ 2 d) [–] | —, p. van Genuchten & Alves (1982) | — | 0.4097 | 0.4096 | — | −0.02 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
k9-rs2-plate-centre — Pass · K9
Reference: series Eq. 1.8 (exact centre 200 by superposition; RS2 quotes 200.11)
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §1 pp. 5–10 (Eq. 1.8); caseId: k9-rs2-plate-centre
Comparison (closed-form): series Eq. 1.8 (exact centre 200 by superposition; RS2 quotes 200.11) = 200, tolerance |Δ| < 0.02 °C vs the series and within 0.1 % of RS2 200.11.
Reproduce: tests/k9_thermal.rs rs2_steady_square_plate
Notes: T6 32×32. Gate: |Δ| < 0.02 °C vs the series and within 0.1 % of RS2 200.11.
k9-rs2-plate-0.5-0.75 — Pass · K9
Reference: series Eq. 1.8
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §1 (Eq. 1.8); caseId: k9-rs2-plate-0.5-0.75
Comparison (closed-form): series Eq. 1.8 = 316.212, tolerance |Δ| < 0.02 °C.
Reproduce: tests/k9_thermal.rs rs2_steady_square_plate
Notes: Gate: |Δ| < 0.02 °C.
k9-rs2-rod-x0 — Pass · K9
Reference: Carslaw & Jaeger §2.9 / RS2 Eq. 3.1
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §3 pp. 13–14 (Eq. 3.1; Nithiarasu & Lewis Ex. 6.4.2); caseId: k9-rs2-rod-x0
Comparison (closed-form): Carslaw & Jaeger §2.9 / RS2 Eq. 3.1 = 1.12838, tolerance |Δ| < 2e-3.
Reproduce: tests/k9_thermal.rs rs2_transient_flux_into_rod
Notes: Crank–Nicolson, 200 steps. Gate: |Δ| < 2e-3.
k9-rs2-rod-x1 — Pass · K9
Reference: RS2 Eq. 3.1
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §3 (Eq. 3.1); caseId: k9-rs2-rod-x1
Comparison (closed-form): RS2 Eq. 3.1 = 0.39928, tolerance |Δ| < 2e-3.
Reproduce: tests/k9_thermal.rs rs2_transient_flux_into_rod
Notes: Gate: |Δ| < 2e-3.
k9-rs2-rod-x2 — Pass · K9
Reference: RS2 Eq. 3.1
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §3 (Eq. 3.1); caseId: k9-rs2-rod-x2
Comparison (closed-form): RS2 Eq. 3.1 = 0.10051, tolerance |Δ| < 2e-3.
Reproduce: tests/k9_thermal.rs rs2_transient_flux_into_rod
Notes: Gate: |Δ| < 2e-3.
k9-rs2-convective-1h — Pass · K9
Reference: Carslaw & Jaeger §2.7
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §4 pp. 15–17 (C&J); caseId: k9-rs2-convective-1h
Comparison (closed-form): Carslaw & Jaeger §2.7 = -4.8568, tolerance |Δ| < 0.05 °C.
Reproduce: tests/k9_thermal.rs rs2_convective_surface_semi_infinite
Notes: Graded mesh (2 mm at the surface). Gate: |Δ| < 0.05 °C.
k9-rs2-convective-1d — Pass · K9
Reference: Carslaw & Jaeger §2.7
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §4 (C&J); caseId: k9-rs2-convective-1d
Comparison (closed-form): Carslaw & Jaeger §2.7 = -12.6642, tolerance |Δ| < 0.05 °C.
Reproduce: tests/k9_thermal.rs rs2_convective_surface_semi_infinite
Notes: Gate: |Δ| < 0.05 °C.
k9-nafems-t4 — Pass · K9
Reference: NAFEMS (1990) reference via MIDAS (NAFEMS 18.25)
Benchmark: vendor: NAFEMS; product: —; version: —; doc: Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_8_HeatTransferAnalysis.pdf; page: §8.1 Table 8.1.1; caseId: k9-nafems-t4
Comparison (vendor): NAFEMS (1990) reference via MIDAS (NAFEMS 18.25) = 18.3, tolerance |Δ| < 0.1 °C; heat balance AB + BC + CD = 0 to 1e-6.
Reproduce: tests/k9_thermal.rs nafems_t4_steady_convection
Notes: T6 24×40. Gate: |Δ| < 0.1 °C; heat balance AB + BC + CD = 0 to 1e-6.
k9-nafems-t3 — Pass · K9
Reference: NAFEMS T3 reference via MIDAS
Benchmark: vendor: NAFEMS; product: —; version: —; doc: Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_8_HeatTransferAnalysis.pdf; page: §8.3 Table 8.3.1; caseId: k9-nafems-t3
Comparison (vendor): NAFEMS T3 reference via MIDAS = 36.6, tolerance |Δ| < 0.1 °C.
Reproduce: tests/k9_thermal.rs nafems_t3_and_barlow_harmonic_boundary
Notes: harmonic time function; CN, Δt 0.05 s. Gate: |Δ| < 0.1 °C.
k9-barlow-davis — Pass · K9
Reference: Barlow & Davis (1987) via MIDAS
Benchmark: vendor: NAFEMS; product: —; version: —; doc: Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_8_HeatTransferAnalysis.pdf; page: §8.4 Table 8.4.1; caseId: k9-barlow-davis
Comparison (vendor): Barlow & Davis (1987) via MIDAS = 9.62, tolerance |Δ| < 0.08 °C.
Reproduce: tests/k9_thermal.rs nafems_t3_and_barlow_harmonic_boundary
Notes: Gate: |Δ| < 0.08 °C.
k9-rs2-forced-convection-npe — Pass · K9
Reference: RS2 Eq. 7.3
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §7 pp. 25–27 (Eq. 7.3); caseId: k9-rs2-forced-convection-npe
Comparison (closed-form): RS2 Eq. 7.3 = 4.186, tolerance |Δ| < 1e-3.
Case: k9-rs2-forced-convection-bredehoeft-papadopulos.json
Reproduce: tests/k9_thermal.rs rs2_forced_convection_bredehoeft_papadopulos
Notes: q from the flow phase (3.33e-8 m/s). Gate: |Δ| < 1e-3.
k9-rs2-forced-convection-down-y0.05 — Pass · K9
Reference: Bredehoeft & Papadopulos (1965) Eq. 7.2
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §7 (Eq. 7.2); caseId: k9-rs2-forced-convection-down-y0.05
Comparison (closed-form): Bredehoeft & Papadopulos (1965) Eq. 7.2 = 0.51001, tolerance |Δ| < 2e-4 (5 heights × down / up / normal flow).
Case: k9-rs2-forced-convection-bredehoeft-papadopulos.json
Reproduce: tests/k9_thermal.rs rs2_forced_convection_bredehoeft_papadopulos
Notes: Gate: |Δ| < 2e-4 (5 heights × down / up / normal flow).
k9-rs2-forced-convection-up-y0.25 — Pass · K9
Reference: Bredehoeft & Papadopulos (1965) Eq. 7.2
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §7 (Eq. 7.2); caseId: k9-rs2-forced-convection-up-y0.25
Comparison (closed-form): Bredehoeft & Papadopulos (1965) Eq. 7.2 = 0.48999, tolerance |Δ| < 2e-4.
Case: k9-rs2-forced-convection-bredehoeft-papadopulos.json
Reproduce: tests/k9_thermal.rs rs2_forced_convection_bredehoeft_papadopulos
Notes: Gate: |Δ| < 2e-4.
k9-neumann-front-100d — Pass · K9
Reference: Neumann two-phase solution (C&J §11.2), λ 1.5, C 4.18e6 / 1.93e6, L 334 MJ/m³ × 0.999
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §5 pp. 18–20 (set-up); C&J §11.2; caseId: k9-neumann-front-100d
Comparison (closed-form): Neumann two-phase solution (C&J §11.2), λ 1.5, C 4.18e6 / 1.93e6, L 334 MJ/m³ × 0.999 = 0.3748, tolerance within 2 % + 3 mm; profile ≤ 0.05 °C.
Reproduce: tests/k9_thermal.rs neumann_two_phase_thaw
Notes: latent heat smeared over ±0.01 °C. Gate: within 2 % + 3 mm; profile ≤ 0.05 °C.
k9-neumann-front-10d — Pass · K9
Reference: Neumann (C&J §11.2)
Benchmark: vendor: closed-form; product: —; version: —; doc: Rocscience-RS2-Thermal-Analysis-Verification.pdf; page: §5; C&J §11.2; caseId: k9-neumann-front-10d
Comparison (closed-form): Neumann (C&J §11.2) = 0.1185, tolerance within 2 % + 3 mm.
Reproduce: tests/k9_thermal.rs neumann_two_phase_thaw
Notes: Gate: within 2 % + 3 mm.
k9-hollow-cylinder-q — Pass · K9
Reference: λ ΔT h / ln(b/a)
Benchmark: vendor: closed-form; product: —; version: —; doc: —; page: C&J §7.2; caseId: k9-hollow-cylinder-q
Comparison (closed-form): λ ΔT h / ln(b/a) = 11.6769, tolerance 0.1 % and T(r) within 2e-3 °C.
Reproduce: tests/k9_thermal.rs axisymmetric_hollow_cylinder
Notes: Gate: 0.1 % and T(r) within 2e-3 °C.
k9-ogata-banks-x1.2-t3 — Pass · K9
Reference: Ogata & Banks (1961)
Benchmark: vendor: closed-form; product: —; version: —; doc: —; page: Ogata & Banks (1961) USGS PP 411-A; caseId: k9-ogata-banks-x1.2-t3
Comparison (closed-form): Ogata & Banks (1961) = 0.526, tolerance worst |Δc| < 0.01 over 24 values (measured 0.0012).
Reproduce: tests/k9_transport.rs ogata_banks_and_retarded_decaying_column
Notes: Gate: worst |Δc| < 0.01 over 24 values (measured 0.0012).
k9-vga-retarded-decay-x0.4-t4 — Pass · K9
Reference: van Genuchten & Alves (1982) / Bear (1972)
Benchmark: vendor: closed-form; product: —; version: —; doc: —; page: van Genuchten & Alves (1982); caseId: k9-vga-retarded-decay-x0.4-t4
Comparison (closed-form): van Genuchten & Alves (1982) / Bear (1972) = 0.4097, tolerance worst |Δc| < 0.01 over 16 values (measured 0.0002).
Reproduce: tests/k9_transport.rs ogata_banks_and_retarded_decaying_column
Notes: Gate: worst |Δc| < 0.01 over 16 values (measured 0.0002).
Cited validation suites — 1
unsaturated-thermal-web-validation.test.ts
Web-validation for the unsaturated-soil + thermal (THM) engine (`unsaturated-thermal.ts`).
Analyses validated: unsaturated-thermal · Recorded run: passed — 23 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-validation for the unsaturated-soil + thermal (THM) engine
(`unsaturated-thermal.ts`). the release rules live gate — ≥20 cited assertions.
Sources anchored below (each assertion cites its clause/table):
• van Genuchten (1980) SSSAJ 44:892-898 — SWCC closed form + published
parameter sets (Table 1: Guelph Loam, Beit Netofa Clay, Hygiene Sandstone).
• Bishop (1959) — single effective stress σ′ = (σ−u_a)+χ(u_a−u_w).
• Vanapalli, Fredlund, Pufahl & Clifton (1996) CGJ 33:379-392 — extended
Mohr-Coulomb strength / apparent (matric-suction) cohesion.
• Carslaw & Jaeger (1959) "Conduction of Heat in Solids" §2.5 — semi-infinite
solid, step surface temperature; erfc values cross-checked against the
standard error-function table (Abramowitz & Stegun Table 7.1).
Imported by RELATIVE path (never the barrel), per the build brief.
| Test block (the published value it checks) | Verdict |
| van Genuchten: Se(ψ=0)=1 and θ(ψ=0)=θ_s (van Genuchten 1980, Eq. 3) | Pass |
| van Genuchten: Se→0 and θ→θ_r as ψ→∞ (van Genuchten 1980) | Pass |
| van Genuchten: Se strictly decreasing in suction (van Genuchten 1980) | Pass |
| van Genuchten m = 1 − 1/n for n=2, 4, 1.5 (van Genuchten 1980, m-n constraint) | Pass |
| van Genuchten: at αψ=1, Se = 2^(−m) exactly (van Genuchten 1980, Eq. 3) | Pass |
| van Genuchten: θ at αψ=1, n=2 = θ_r + 2^(−0.5)(θ_s−θ_r) = 0.332843 (van Genuchten 1980) | Pass |
| van Genuchten 1980 Table 1 — Guelph Loam (α=0.0115, n=2.03, θs=0.520, θr=0.218) | Pass |
| van Genuchten 1980 Table 1 — Beit Netofa Clay (α=0.00152, n=1.17, θs=0.446, θr=0.0) | Pass |
| van Genuchten 1980 Table 1 — Hygiene Sandstone (α=0.0079, n=10.4): sharp air-entry | Pass |
| Bishop 1959: χ = Se exactly (χ=1 saturated, χ=0 dry) | Pass |
| Bishop 1959: net normal stress (σ−u_a) and u_w = u_a − ψ | Pass |
| Bishop 1959: σ′ = (σ−u_a)+Se·ψ anchor = 270.7107 kPa (αψ=1, n=2, σ=200) | Pass |
| Bishop 1959: σ′ (suction stress Se·ψ) increases with suction over the working range | Pass |
| Vanapalli 1996: apparent cohesion c_app = ψ·Se·tanφ′ anchor = 40.825 kPa | Pass |
| Vanapalli 1996: c_app == ψ·Se·tanφ′ holds for arbitrary state | Pass |
| Vanapalli 1996: total cohesion = c′ + c_app; τ = c′ + (σ−u_a)tanφ′ + c_app | Pass |
| Vanapalli 1996: unsaturated τ ≤ saturated τ (χ=Se≤1); equal only at ψ=0 | Pass |
| Carslaw & Jaeger §2.5: erfc argument z/(2√(D_th·t)) and surface value | Pass |
| Carslaw & Jaeger §2.5: erfc(z/2) matches standard table at arg=0.5, 1, 2 | Pass |
| Carslaw & Jaeger §2.5: t=0 interior unchanged; t→∞ whole profile reaches T_s | Pass |
| Linear thermal strain ε = α_T·ΔT — sign and magnitude | Pass |
| guards: pathological inputs are REFUSED, not clamped into a plausible answer | Pass |
| unsaturated-thermal: the real physical limits stay LEGAL and self-consistent | Pass |
Earthquake engineering, dynamics and liquefaction
FE kernel registry — 69 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
k7a-rayleigh-alpha-ground-response | Rayleigh αR for ξ = 8 % at 1.5 and 7.5 Hz [1/s] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. p. 2 | 1.257 | 1.25664 | 1.25664 | −0.03 % | 0.00 % | Pass |
k7a-rayleigh-beta-ground-response | Rayleigh βR for ξ = 8 % at 1.5 and 7.5 Hz [s] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. p. 2 | 0.002829 | 0.00282942 | 0.00282942 | +0.01 % | 0.00 % | Pass |
k7a-rayleigh-alpha-footing | Rayleigh αR for ξ = 3 % at 1.751 and 3.0 Hz [1/s] | PLAXIS-Verification-Vertical-dynamic-response-footing.pdf, p. p. 1 | 0.4168 | 0.416825 | 0.416825 | +6.0e-3 % | 0.00 % | Pass |
k7a-rayleigh-beta-footing | Rayleigh βR for ξ = 3 % at 1.751 and 3.0 Hz [s] | PLAXIS-Verification-Vertical-dynamic-response-footing.pdf, p. p. 1 | 0.00201 | 0.00200995 | 0.00200995 | −2.2e-3 % | 0.00 % | Pass |
k7a-1d-wave-arrival-middle | time the front reaches point B (5 m below the top; u_B = 0.5 mm) [s] | PLAXIS-Verification-One-dimensional-wave-propagation.pdf, p. p. 2 | 0.05 | 0.05 | 0.05072 | +1.44 % | +1.44 % | Pass |
k7a-1d-wave-plateau-fixed-baseself-check | mean u_B between the arrival and the return of the reflection (0.07–0.13 s) [m] | PLAXIS-Verification-One-dimensional-wave-propagation.pdf, p. p. 2–3 | -0.001 | -0.001 | -0.0010001 | −0.01 % | −0.01 % | Pass |
k7a-1d-wave-after-reflection-fixed-base | mean u_B after the reflection from the fixed base has passed (0.17–0.23 s) [m] | PLAXIS-Verification-One-dimensional-wave-propagation.pdf, p. p. 3 | 0 | 0 | -2.274e-8 | — | — | Pass |
k7a-1d-wave-arrival-base-viscous | time the front reaches the base (point A, 10 m) with a viscous base [s] | PLAXIS-Verification-One-dimensional-wave-propagation.pdf, p. p. 3 | 0.1 | 0.1 | 0.10083 | +0.83 % | +0.83 % | Pass |
k7a-1d-wave-absorbing-reflection | reflection at the viscous base: |mean u_B(0.17–0.25 s) + 1 mm| / 1 mm [%] | PLAXIS-Verification-One-dimensional-wave-propagation.pdf, p. p. 3 | — | 0 | 0 | — | — | Pass |
k7a-1d-wave-spec-mesher | model B through the ModelSpec route (kernel mesher, very_fine T15): arrival at the base [s] | PLAXIS-Verification-One-dimensional-wave-propagation.pdf, p. p. 1–3 | 0.1 | 0.1 | 0.10083 | +0.83 % | +0.83 % | Pass |
k7a-shear-column-f0 | first natural frequency of the 50 m layer (free vibration after a static top shear is removed; DFT peak) [Hz] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. p. 2 | 1.5 (shear-beam closed form) | 1.50006 | 1.49956 | −0.03 % | −0.03 % | Pass |
k7a-ground-response-rigid-0p75hz | amplification |a_top / a_base| at 0.75 Hz, rigid base, Rayleigh ξ = 8 % (1.5 / 7.5 Hz) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. p. 2–4, Fig. 5 | — | 1.406 | 1.4058 | — | −0.01 % | Pass |
k7a-ground-response-rigid-1p5hz | amplification |a_top / a_base| at 1.5 Hz, rigid base, Rayleigh ξ = 8 % (1.5 / 7.5 Hz) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. p. 2–4, Fig. 5 | 8 | 7.9506 | 7.9467 | −0.67 % | −0.05 % | Pass |
k7a-ground-response-rigid-3p0hz | amplification |a_top / a_base| at 3.0 Hz, rigid base, Rayleigh ξ = 8 % (1.5 / 7.5 Hz) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. p. 2–4, Fig. 5 | — | 0.9826 | 0.9826 | — | 0.00 % | Pass |
k7a-ground-response-rigid-4p5hz | amplification |a_top / a_base| at 4.5 Hz, rigid base, Rayleigh ξ = 8 % (1.5 / 7.5 Hz) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. p. 2–4, Fig. 5 | — | 3.3698 | 3.3665 | — | −0.10 % | Pass |
k7a-ground-response-elastic-rock-0p75hz | amplification |v_top / v_outcrop| at 0.75 Hz on elastic rock (Vr = 2 Vs, ρr = ρ), outcrop velocity input [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. (closed form; PLAXIS compliant base) | — | 1.1086 | 1.1083 | — | −0.03 % | Pass |
k7a-ground-response-elastic-rock-1p5hz | amplification |v_top / v_outcrop| at 1.5 Hz on elastic rock (Vr = 2 Vs, ρr = ρ), outcrop velocity input [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. (closed form; PLAXIS compliant base) | — | 1.5827 | 1.5816 | — | −0.07 % | Pass |
k7a-ground-response-elastic-rock-4p5hz | amplification |v_top / v_outcrop| at 4.5 Hz on elastic rock (Vr = 2 Vs, ρr = ρ), outcrop velocity input [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. (closed form; PLAXIS compliant base) | — | 1.2211 | 1.2208 | — | −0.02 % | Pass |
k7a-beam-static-deflection | mid-span deflection under q = 1 kN/m/m (static phase before the free vibration) [m] | PLAXIS-Verification-Simply-supported-beam-frequency.pdf, p. p. 2 | 0.1302 | 0.130208 | 0.13023 | +0.02 % | +0.02 % | Pass |
k7a-beam-natural-frequency | first natural frequency of the simply supported beam (free vibration after the load is removed) [Hz] | PLAXIS-Verification-Simply-supported-beam-frequency.pdf, p. p. 2 | 1.57 | 1.5708 | 1.56976 | −0.02 % | −0.07 % | Pass |
k7a-lamb-p-onset | onset of the P wave at r = 50 m (2 % of the peak) [s] | PLAXIS-Verification-Lamb-problem.pdf, p. p. 1–3, Fig. 4 | — | 0.3415 | 0.3311 | — | −3.05 % | Pass |
k7a-lamb-rayleigh-peak-time | time of the Rayleigh-wave (negative) peak of uy at r = 50 m [s] | PLAXIS-Verification-Lamb-problem.pdf, p. Fig. 4 | — | 0.6116 | 0.63 | — | +3.01 % | Pass |
k7a-lamb-rayleigh-peak-amplitude | Rayleigh-wave peak of uy at r = 50 m [mm] | PLAXIS-Verification-Lamb-problem.pdf, p. Fig. 4 | -0.01 | — | -0.00987 | +1.30 % | — | Pass |
k7a-elastoplastic-yieldself-check | max |τ| at a base stress point of a φ = 0 Mohr–Coulomb column shaken beyond its strength (c = 250 kPa) [kPa] | — | — | 250 | 250 | — | 0.00 % | Pass |
k7a-hht-zero-is-newmarkself-check | HHT-α with α = 0 vs Newmark average acceleration [-] | — | — | 0 | 0 | — | — | Pass |
k7a-dam-free-vibration | first two natural frequencies of a dam with depth-varying G (PLAXIS 2.9 / 6.4 Hz; closed form 3.1 / 7.0 Hz) [Hz] | PLAXIS-Verification-Free-vibration-dam-2018.pdf, p. p. 1–3 | 2.9 | 3.1 | — | — | — | Pending |
k7a-pulse-multilayer | surface deflection under a pulse load on a 3-layer pavement (stiff / soft subgrade) [mm] | PLAXIS-Verification-Pulse-load-multilayer.pdf, p. p. 1–4 | — | — | — | — | — | Pending |
k7a-vertical-footing-dynamic | vertical dynamic stiffness K_v = F πR² / w_max of the rigid circular footing (plate in a dynamic phase, D185) [kN/m] | PLAXIS-Verification-Vertical-dynamic-response-footing.pdf, p. p. 1–4 | 2367090 | 2335570 | 2363810 | −0.14 % | +1.21 % | Pass |
k7a-surface-waves | surface-wave amplitude vs distance from a harmonic prescribed displacement (BEM Chouw et al. 1991) [m] | PLAXIS-Verification-Surface-waves.pdf, p. p. 1–3 | — | — | — | — | — | Pending |
k7a-midas-ch4-dynamics | Midas GTS NX dynamics benchmarks [-] | Midas-GTS-NX-2019-v2.1-Benchmarks-Verification-Chapter_4_Dynamics.pdf, p. Ch. 4 | — | — | — | — | — | Pending |
k7b-vertical-footing-wmax | w_max under the footing centre (point A) [mm] | PLAXIS-Verification-Vertical-dynamic-response-footing.pdf, p. p. 4 | 53.09 | 53.8 | 53.161 | +0.13 % | −1.19 % | Pass |
k7b-plate-beam-deflection | static midspan deflection under q = 1 kN/m/m — a real PLATE (K7a used a continuum substitute) [m] | PLAXIS-Verification-Simply-supported-beam-frequency.pdf, p. p. 2 | 0.1302 | 0.130208 | 0.13023 | +0.02 % | +0.02 % | Pass |
k7b-plate-beam-frequency | first natural frequency — plate mass w/g with rotary inertia (consistent and HRZ-lumped) [Hz] | PLAXIS-Verification-Simply-supported-beam-frequency.pdf, p. p. 2 | 1.57 | 1.5708 | 1.56976 | −0.02 % | −0.07 % | Pass |
k7b-undrained-p-wave-excess | excess pore pressure behind a step-load P front, undrained A (ν_u 0.495) [kPa] | closed form (Biot / Terzaghi undrained oedometric loading), p. — | — | 9.736 | 9.7364 | — | +4.1e-3 % | Pass |
k7b-undrained-p-wave-arrival | arrival of half the undrained front at 5 m [s] | closed form, p. — | — | 0.0081245 | 0.00825 | — | +1.54 % | Pass |
k7b-tied-column-0.75hz | rigid-base amplification at 0.75 Hz with TIED side DOFs (D186) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. Fig. 5 | — | 1.406 | 1.4058 | — | −0.01 % | Pass |
k7b-tied-column-1.5hz | rigid-base amplification at 1.5 Hz with TIED side DOFs (D186) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. Fig. 5 | 8 | 7.9506 | 7.9467 | −0.67 % | −0.05 % | Pass |
k7b-tied-column-3.0hz | rigid-base amplification at 3.0 Hz with TIED side DOFs (D186) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. Fig. 5 | — | 0.9826 | 0.9826 | — | 0.00 % | Pass |
k7b-tied-column-4.5hz | rigid-base amplification at 4.5 Hz with TIED side DOFs (D186) [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. Fig. 5 | — | 3.3698 | 3.3665 | — | −0.10 % | Pass |
k7b-free-field-rigid-1p5 | amplification with FREE-FIELD sides (D186): rigid base 1.5 Hz, centre [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. Fig. 5 (1-D reference) | — | 7.9506 | 7.9718 | — | +0.27 % | Pass |
k7b-free-field-rigid-3 | amplification with FREE-FIELD sides (D186): rigid base 3 Hz, centre [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. Fig. 5 (1-D reference) | — | 0.9826 | 0.9968 | — | +1.45 % | Pass |
k7b-free-field-rock-1p5 | amplification with FREE-FIELD sides (D186): elastic rock (compliant base) 1.5 Hz, centre [-] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. Fig. 5 (1-D reference) | — | 1.5827 | 1.5873 | — | +0.29 % | Pass |
k7b-baseline-closed-form | linear baseline coefficient c0 (v_c(T) = u_c(T) = 0) [m/s²] | closed form, p. — | — | 0.233803 | 0.233801 | — | −6.0e-4 % | Pass |
k7b-elc180-pga | PGA of the El Centro 1940 ELC-180 record through the ground-motion registry (DY-5) [g] | USGS SLAMMER v1.1 record set (TM 12-B1), public domain, p. record table | — | 0.313 | 0.312881 | — | −0.04 % | Pass |
k7b-elc180-base-driftself-check | absolute base displacement at the end of the record, drift-corrected [m] | PLAXIS-Verification-Ground-response-linear-soil-2018.pdf, p. — | — | 0 | -1.990e-13 | — | — | Pass |
k7b-pm4sand-crr15-dr35 | CRR at 15 uniform cycles (3 % single-amplitude shear strain), undrained cyclic DSS, Dr 0.35, G0 476, hpo 0.53 [-] | Boulanger_Ziotopoulou_PM4Sand_v31_CGM-17-01_rev3.pdf (UCD/CGM-17/01 rev. 3, PM4Sand v3.1; same Table 4.4 as v3), p. p. 78, Fig. 4.6 | — | 0.09 | 0.0874 | — | −2.80 % | Pass |
k7b-pm4sand-crr15-dr55 | CRR at 15 uniform cycles (3 % single-amplitude shear strain), undrained cyclic DSS, Dr 0.55, G0 677, hpo 0.4 [-] | Boulanger_Ziotopoulou_PM4Sand_v31_CGM-17-01_rev3.pdf (UCD/CGM-17/01 rev. 3, PM4Sand v3.1; same Table 4.4 as v3), p. p. 78, Fig. 4.6 | — | 0.147 | 0.142 | — | −3.40 % | Pass |
k7b-pm4sand-crr15-dr75 | CRR at 15 uniform cycles (3 % single-amplitude shear strain), undrained cyclic DSS, Dr 0.75, G0 890, hpo 0.63 [-] | Boulanger_Ziotopoulou_PM4Sand_v31_CGM-17-01_rev3.pdf (UCD/CGM-17/01 rev. 3, PM4Sand v3.1; same Table 4.4 as v3), p. p. 78, Fig. 4.6 | — | 0.312 | 0.2948 | — | −5.50 % | Pass |
k7b-pm4sand-csr-n-slope-dr35 | slope b of CSR ∝ N^−b, Dr 0.35 [-] | Boulanger_Ziotopoulou_PM4Sand_Model_CGM-15-01_2015.pdf (UCD/CGM-15/01, PM4Sand v3), p. p. 87 | — | 0.25 | 0.241 | — | +12.8 % | Pass |
k7b-pm4sand-csr-n-slope-dr55 | slope b of CSR ∝ N^−b, Dr 0.55 [-] | Boulanger_Ziotopoulou_PM4Sand_Model_CGM-15-01_2015.pdf (UCD/CGM-15/01, PM4Sand v3), p. p. 87 | — | 0.29 | 0.279 | — | +1.03 % | Pass |
k7b-pm4sand-csr-n-slope-dr75 | slope b of CSR ∝ N^−b, Dr 0.75 [-] | Boulanger_Ziotopoulou_PM4Sand_Model_CGM-15-01_2015.pdf (UCD/CGM-15/01, PM4Sand v3), p. p. 87 | — | 0.3 | 0.286 | — | −12.7 % | Pass |
k7b-pm4sand-drained-phi-dr35 | peak φ′DSS, drained monotonic DSS at 1 atm, Dr 0.35 [°] | Boulanger_Ziotopoulou_PM4Sand_Model_CGM-15-01_2015.pdf (UCD/CGM-15/01, PM4Sand v3), p. pp. 90–92 | — | 30 | 29.81 | — | −0.63 % | Pass |
k7b-pm4sand-drained-phi-dr55 | peak φ′DSS, drained monotonic DSS at 1 atm, Dr 0.55 [°] | Boulanger_Ziotopoulou_PM4Sand_Model_CGM-15-01_2015.pdf (UCD/CGM-15/01, PM4Sand v3), p. pp. 90–92 | — | 33.5 | 33.3 | — | −0.60 % | Pass |
k7b-pm4sand-drained-phi-dr75 | peak φ′DSS, drained monotonic DSS at 1 atm, Dr 0.75 [°] | Boulanger_Ziotopoulou_PM4Sand_Model_CGM-15-01_2015.pdf (UCD/CGM-15/01, PM4Sand v3), p. pp. 90–92 | — | 37.7 | 37.42 | — | −0.74 % | Pass |
k7b-liquefaction-column-ruself-check | max r_u = Δp/σ′v0 at 4 m and 7 m depth [-] | closed form (r_u ≤ 1) + cross-check, p. — | — | 0.95 | 4 m: 0.8024; 7 m: 1.0311 | — | — | Deviation |
k7-plaxis-2d-tut15-surface-1.37-undamped | steady vertical displacement amplitude at the surface point r = 1.37 m, without Rayleigh damping (Fig. 15-9) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 241 | 0.0339 | — | 0.0336 | −0.80 % | — | Pass |
k7-plaxis-2d-tut15-surface-1.94-undamped | steady vertical displacement amplitude at the surface point r = 1.94 m, without Rayleigh damping (Fig. 15-9) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 241 | 0.0236 | — | 0.0239 | +1.20 % | — | Pass |
k7-plaxis-2d-tut15-surface-3.60-undamped | steady vertical displacement amplitude at the surface point r = 3.60 m, without Rayleigh damping (Fig. 15-9) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 241 | 0.0138 | — | 0.0141 | +1.90 % | — | Pass |
k7-plaxis-2d-tut15-surface-1.37-damped | steady vertical displacement amplitude at the surface point r = 1.37 m, with Rayleigh damping (Fig. 15-10) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 242 | 0.0322 | — | 0.0319 | −0.90 % | — | Pass |
k7-plaxis-2d-tut15-surface-1.94-damped | steady vertical displacement amplitude at the surface point r = 1.94 m, with Rayleigh damping (Fig. 15-10) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 242 | 0.022 | — | 0.0222 | +0.90 % | — | Pass |
k7-plaxis-2d-tut15-surface-3.60-damped | steady vertical displacement amplitude at the surface point r = 3.60 m, with Rayleigh damping (Fig. 15-10) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 242 | 0.0116 | — | 0.012 | +3.10 % | — | Pass |
k7-plaxis-2d-tut15-footing-lysmer-analog | steady vertical displacement amplitude of the rigid footing (axis), mass = the plate only (the manual's static generator load carries no mass), B = m(1−ν)/(4ρR³) = 0.275 [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 232–241 | — | 0.1416 | 0.136 | — | −3.99 % | Pass |
k7-plaxis-2d-tut15-footing-lysmer-analog-with-generator-mass | steady vertical displacement amplitude of the rigid footing (axis) carrying the generator mass too, B = 0.715 [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 232–241 | — | 0.1481 | 0.142 | — | −4.11 % | Pass |
k7-plaxis-2d-tut15-boundary-distance-20x10-vs-40x20 | absorbing-boundary reflection error: largest change of the steady amplitude (4 points) when the model is doubled from 20 × 10 m (the manual) to 40 × 20 m [%] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 232–233 | — | 0 | 2.76 | — | — | Pass |
k7-plaxis-2d-tut15-boundary-distance-10x5-vs-40x20 | absorbing-boundary reflection error: largest change of the steady amplitude (4 points) when the model is halved from 20 × 10 m to 10 × 5 m, against the 40 × 20 m model [%] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 232–233 | — | 0 | 4.6 | — | — | Pass |
k7-plaxis-2d-tut15-free-vibration-residual-undamped | residual surface displacement after the generator stops, r = 1.37 m, no damping (amplitude over 0.6–1.0 s) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 241 | 0.0034 | — | 0.00531 | +56.2 % | — | Deviation |
k7-plaxis-2d-tut15-free-vibration-residual-damped | residual surface displacement after the generator stops, r = 1.37 m, with Rayleigh damping (amplitude over 0.6–1.0 s) [mm] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 242 | 0.0008 | — | 0.00313 | +291.3 % | — | Deviation |
k7-plaxis-2d-tut15-rayleigh-alpha | Rayleigh α from ξ1 = ξ2 = 5 % at f1 = 1 Hz, f2 = 10 Hz (SDOF equivalent, Fig. 15-8) [1/s] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 240 | 0.5712 | 0.5712 | 0.571199 | 0.00 % | 0.00 % | Pass |
k7-plaxis-2d-tut15-rayleigh-beta | Rayleigh β from ξ1 = ξ2 = 5 % at f1 = 1 Hz, f2 = 10 Hz (SDOF equivalent, Fig. 15-8) [s] | PLAXIS-2D-2025.1-Tutorial-Manual.pdf, p. 240 | 0.001447 | 0.001447 | 0.0014469 | −9.0e-3 % | −9.0e-3 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
k7a-rayleigh-alpha-ground-response — Pass · K7a
Reference: α = 2ξω1ω2/(ω1+ω2)
Comparison (closed-form): α = 2ξω1ω2/(ω1+ω2) = 1.25664, tolerance printed digits
Case: (helper) rayleigh_from_ratio(0.08, 1.5, 7.5)
Reproduce: cargo test -p tbk-core --test k7_dynamics rayleigh_coefficients_match_plaxis_published_values
Notes: PLAXIS prints 1.257 (4 digits); asserted |ours − 1.257| < 5e-4.
k7a-rayleigh-beta-ground-response — Pass · K7a
Reference: β = 2ξ/(ω1+ω2)
Comparison (closed-form): β = 2ξ/(ω1+ω2) = 0.00282942, tolerance printed digits
Case: (helper) rayleigh_from_ratio(0.08, 1.5, 7.5)
Reproduce: cargo test -p tbk-core --test k7_dynamics rayleigh_coefficients_match_plaxis_published_values
Notes: PLAXIS 2.829e-3; asserted to 5e-7.
k7a-rayleigh-alpha-footing — Pass · K7a
Reference: α = 2ξω1ω2/(ω1+ω2)
Comparison (closed-form): α = 2ξω1ω2/(ω1+ω2) = 0.416825, tolerance printed digits
Case: (helper) rayleigh_from_ratio(0.03, 1.751, 3.0)
Reproduce: cargo test -p tbk-core --test k7_dynamics rayleigh_coefficients_match_plaxis_published_values
Notes: asserted to 5e-5 (PLAXIS 4 digits).
k7a-rayleigh-beta-footing — Pass · K7a
Reference: β = 2ξ/(ω1+ω2)
Comparison (closed-form): β = 2ξ/(ω1+ω2) = 0.00200995, tolerance printed digits
Case: (helper) rayleigh_from_ratio(0.03, 1.751, 3.0)
Reproduce: cargo test -p tbk-core --test k7_dynamics rayleigh_coefficients_match_plaxis_published_values
Notes: asserted to 5e-6.
k7a-1d-wave-arrival-middle — Pass · K7a
Reference: distance / Vp, Vp = √(E_oed/ρ) = 100 m/s
Comparison (closed-form): distance / Vp, Vp = √(E_oed/ρ) = 100 m/s = 0.05, tolerance ±0.0025 s
Case: (test fixture: tests/k7_dynamics.rs wave_1d, model A)
Mesh: 80 T15 (rect-mesh 1 × 40)
Reproduce: cargo test -p tbk-core --test k7_dynamics one_dimensional_wave_arrival_and_absorbing_base
Notes: Axisymmetric 0.25 × 10 m column, 40 T15 cells (0.25 m), Newmark α = 0.2652, β = 0.53 (PLAXIS's, numerically damped), consistent mass, 500 steps of 0.5 ms; K0 initial phase. Tolerance ±0.0025 s (half a cell's travel time).
k7a-1d-wave-plateau-fixed-base — Pass · K7a
Reference: the prescribed step
Comparison (closed-form): the prescribed step = -0.001, tolerance ±0.05 mm
Case: (test fixture: wave_1d, model A)
Reproduce: cargo test -p tbk-core --test k7_dynamics one_dimensional_wave_arrival_and_absorbing_base
Notes: PLAXIS: 'as an average, the displacement at point B agrees with the theory'. Tolerance 5 % of 1 mm.
k7a-1d-wave-after-reflection-fixed-base — Pass · K7a
Reference: incident −1 mm + reflected +1 mm
Comparison (closed-form): incident −1 mm + reflected +1 mm = 0, tolerance ±0.05 mm
Case: (test fixture: wave_1d, model A)
Reproduce: cargo test -p tbk-core --test k7_dynamics one_dimensional_wave_arrival_and_absorbing_base
Notes: PLAXIS Fig. 2: B returns to 0 after ≈ 0.15 s. Tolerance 0.05 mm.
k7a-1d-wave-arrival-base-viscous — Pass · K7a
Reference: distance / Vp
Comparison (closed-form): distance / Vp = 0.1, tolerance ±0.005 s
Case: (test fixture: wave_1d, model B)
Reproduce: cargo test -p tbk-core --test k7_dynamics one_dimensional_wave_arrival_and_absorbing_base
Notes: Lysmer–Kuhlemeyer dashpots (c1 = c2 = 1) replace the base fixity; the K0 support reactions become constant forces. Tolerance ±0.005 s.
k7a-1d-wave-absorbing-reflection — Pass · K7a
Reference: no reflection for normal incidence (Lysmer & Kuhlemeyer 1969)
Comparison (closed-form): no reflection for normal incidence (Lysmer & Kuhlemeyer 1969) = 0, tolerance ≤ 3 %
Case: (test fixture: wave_1d, model B)
Reproduce: cargo test -p tbk-core --test k7_dynamics one_dimensional_wave_arrival_and_absorbing_base
Notes: Measured 0.00 % (< 0.005 %); threshold 3 %. PLAXIS Fig. 4: A and B stay at −1 mm.
k7a-1d-wave-spec-mesher — Pass · K7a
Reference: distance / Vp
Comparison (closed-form): distance / Vp = 0.1, tolerance ±0.005 s
Case: verification/cases/k7a-plaxis-1d-wave-propagation-viscous.json
Mesh: 128 T15 (mesh2d very_fine)
Reproduce: cargo test -p tbk-core --test k7_dynamics one_dimensional_wave_model_spec_case
Notes: 128 T15 from the kernel mesher; mean u_A 0.13–0.25 s = −1.0000e-3 m. run_spec_json returns the `dynamic` block.
k7a-shear-column-f0 — Pass · K7a
Reference: f0 = Vs/(4H), Vs = √(G/ρ) = 300.006 m/s
Benchmark: vendor: literature; product: shear-beam closed form; version: —; doc: —; page: —; caseId: f0-vs-4h
Comparison (closed-form): f0 = Vs/(4H), Vs = √(G/ρ) = 300.006 m/s = 1.50006, tolerance 0.5 %
Case: (test fixture: shear_column_natural_frequency_vs_over_4h)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics shear_column_natural_frequency_vs_over_4h
Notes: 2 m × 50 m column, 20 T15 cells, vertical DOFs fixed on the sides (PLAXIS's 1-D hint), average acceleration, Δt = T0/100, 20 periods. Tolerance 0.5 %.
k7a-ground-response-rigid-0p75hz — Pass · K7a
Reference: |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation)
Comparison (closed-form): |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation) = 1.406, tolerance 2 %
Case: (test fixture: column_amplification, rigid base)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics ground_response_transfer_function_rigid_base
Notes: Steady state of a harmonic base acceleration (14 periods, 80 steps per period, average acceleration, consistent mass), vertical DOFs fixed on the sides, K0 = 0 (free sides). The Imperial Valley record of the PLAXIS case is not on disk, so the transfer function is checked against the exact one at single frequencies; PLAXIS / DEEPSOIL Fig. 5 peak ≈ 8 at 1.5 Hz is a figure read. Tolerance 2 %.
k7a-ground-response-rigid-1p5hz — Pass · K7a
Reference: |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation)
Comparison (closed-form): |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation) = 7.9506, tolerance 2 %
Case: (test fixture: column_amplification, rigid base)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics ground_response_transfer_function_rigid_base
Notes: Steady state of a harmonic base acceleration (14 periods, 80 steps per period, average acceleration, consistent mass), vertical DOFs fixed on the sides, K0 = 0 (free sides). The Imperial Valley record of the PLAXIS case is not on disk, so the transfer function is checked against the exact one at single frequencies; PLAXIS / DEEPSOIL Fig. 5 peak ≈ 8 at 1.5 Hz is a figure read. Tolerance 2 %.
k7a-ground-response-rigid-3p0hz — Pass · K7a
Reference: |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation)
Comparison (closed-form): |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation) = 0.9826, tolerance 2 %
Case: (test fixture: column_amplification, rigid base)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics ground_response_transfer_function_rigid_base
Notes: Steady state of a harmonic base acceleration (14 periods, 80 steps per period, average acceleration, consistent mass), vertical DOFs fixed on the sides, K0 = 0 (free sides). The Imperial Valley record of the PLAXIS case is not on disk, so the transfer function is checked against the exact one at single frequencies; PLAXIS / DEEPSOIL Fig. 5 peak ≈ 8 at 1.5 Hz is a figure read. Tolerance 2 %.
k7a-ground-response-rigid-4p5hz — Pass · K7a
Reference: |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation)
Comparison (closed-form): |1/cos k*H|, k² = ρ(ω² − iαω)/(G(1 + iωβ)) (absolute formulation) = 3.3698, tolerance 2 %
Case: (test fixture: column_amplification, rigid base)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics ground_response_transfer_function_rigid_base
Notes: Steady state of a harmonic base acceleration (14 periods, 80 steps per period, average acceleration, consistent mass), vertical DOFs fixed on the sides, K0 = 0 (free sides). The Imperial Valley record of the PLAXIS case is not on disk, so the transfer function is checked against the exact one at single frequencies; PLAXIS / DEEPSOIL Fig. 5 peak ≈ 8 at 1.5 Hz is a figure read. Tolerance 2 %.
k7a-ground-response-elastic-rock-0p75hz — Pass · K7a
Reference: Kramer 1996 Eq. 7.40: |1/(cos k*H + i α* sin k*H)|, α* = G*k/(ρr Vr ω)
Benchmark: vendor: literature; product: Kramer 1996 §7.2.1; version: —; doc: —; page: —; caseId: elastic-rock-0.75hz
Comparison (closed-form): Kramer 1996 Eq. 7.40: |1/(cos k*H + i α* sin k*H)|, α* = G*k/(ρr Vr ω) = 1.1086, tolerance 2 %
Case: (test fixture: column_amplification, compliant base)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics ground_response_transfer_function_elastic_rock
Notes: Compliant base: Lysmer dashpots of the rock material + the input traction C_b·v_outcrop (= 2ρV v_incident, Joyner & Chen 1975). Tolerance 2 %.
k7a-ground-response-elastic-rock-1p5hz — Pass · K7a
Reference: Kramer 1996 Eq. 7.40: |1/(cos k*H + i α* sin k*H)|, α* = G*k/(ρr Vr ω)
Benchmark: vendor: literature; product: Kramer 1996 §7.2.1; version: —; doc: —; page: —; caseId: elastic-rock-1.5hz
Comparison (closed-form): Kramer 1996 Eq. 7.40: |1/(cos k*H + i α* sin k*H)|, α* = G*k/(ρr Vr ω) = 1.5827, tolerance 2 %
Case: (test fixture: column_amplification, compliant base)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics ground_response_transfer_function_elastic_rock
Notes: Compliant base: Lysmer dashpots of the rock material + the input traction C_b·v_outcrop (= 2ρV v_incident, Joyner & Chen 1975). Tolerance 2 %.
k7a-ground-response-elastic-rock-4p5hz — Pass · K7a
Reference: Kramer 1996 Eq. 7.40: |1/(cos k*H + i α* sin k*H)|, α* = G*k/(ρr Vr ω)
Benchmark: vendor: literature; product: Kramer 1996 §7.2.1; version: —; doc: —; page: —; caseId: elastic-rock-4.5hz
Comparison (closed-form): Kramer 1996 Eq. 7.40: |1/(cos k*H + i α* sin k*H)|, α* = G*k/(ρr Vr ω) = 1.2211, tolerance 2 %
Case: (test fixture: column_amplification, compliant base)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics ground_response_transfer_function_elastic_rock
Notes: Compliant base: Lysmer dashpots of the rock material + the input traction C_b·v_outcrop (= 2ρV v_incident, Joyner & Chen 1975). Tolerance 2 %.
k7a-beam-static-deflection — Pass · K7a
Reference: 5qL⁴/(384EI)
Comparison (closed-form): 5qL⁴/(384EI) = 0.130208, tolerance 1 %
Case: (test fixture: beam)
Mesh: 80 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics simply_supported_beam_deflection_and_frequency
Notes: SUBSTITUTION (D185): K7a refuses plates in dynamic phases, so the PLAXIS plate (d = 0.1 m, EA = 1.2e6, EI = 1000, w = 0.981, ν = 0) is a 10 × 0.1 m continuum beam (E = 1.2e7 kPa, γ = 9.81 → ρ = 1 t/m³), pinned at the neutral axis, 40 T15 cells. Tolerance 1 %.
k7a-beam-natural-frequency — Pass · K7a
Reference: f1 = (π/2L²)√(EI/m)
Comparison (closed-form): f1 = (π/2L²)√(EI/m) = 1.5708, tolerance 1 %
Case: (test fixture: beam)
Mesh: 80 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics simply_supported_beam_deflection_and_frequency
Notes: T1 = 0.6370 s (PLAXIS 0.637). Continuum substitute (D185): shear and rotary inertia lower f by ~0.03 % at L/d = 100. Average acceleration, Δt = 2.5 ms, consistent mass. HHT α = −0.1: 1.56974 Hz. Tolerance 1 %.
k7a-lamb-p-onset — Pass · K7a
Reference: 0.05 s + r/Vp, Vp = 171.6 m/s
Comparison (closed-form): 0.05 s + r/Vp, Vp = 171.6 m/s = 0.3415, tolerance ±0.02 s
Case: (test fixture: lamb_problem_arrivals_and_surface_wave, #[ignore] ~41 s)
Mesh: 6720 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics lamb_problem_arrivals_and_surface_wave -- --ignored
Notes: Axisymmetric 100 × 30 m, 140 × 24 T15 cells (0.5 m to x = 60 m, 1 m above y = 6 m depth… see test), viscous bottom and right, Rayleigh α = 0.001, β = 0.002, 500 steps of 2 ms, average acceleration, consistent mass. Onset 10 ms early: the implicit scheme's precursor at a 2 % threshold. Tolerance ±0.02 s.
k7a-lamb-rayleigh-peak-time — Pass · K7a
Reference: 0.0625 s (pulse peak) + r/V_R, V_R = 0.9194 Vs = 91.1 m/s
Comparison (closed-form): 0.0625 s (pulse peak) + r/V_R, V_R = 0.9194 Vs = 91.1 m/s = 0.6116, tolerance ±0.02 s
Case: (test fixture: lamb_problem_arrivals_and_surface_wave)
Mesh: 6720 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics lamb_problem_arrivals_and_surface_wave -- --ignored
Notes: +18 ms (3 %): the far-field Rayleigh pulse of a point load peaks after the arrival of its pulse peak (Pekeris 1955 shape), and β = 0.002 damps the high frequencies; PLAXIS Fig. 4 peaks at ≈ 0.6 s too (figure read). Tolerance ±0.02 s.
k7a-lamb-rayleigh-peak-amplitude — Pass · K7a
Comparison (figure): PLAXIS = -0.01, tolerance 20 % (figure read)
Case: (test fixture: lamb_problem_arrivals_and_surface_wave)
Mesh: 6720 T15
Reproduce: cargo test -p tbk-core --test k7_dynamics lamb_problem_arrivals_and_surface_wave -- --ignored
Notes: Figure read of PLAXIS 2D / Foinquinos & Roesset (2000) ≈ −0.010 mm (the closed form is not on disk — D188); the S-wave hump +0.0031 mm at 0.54 s (figure ≈ +0.004). Tolerance 20 % (figure-read uncertainty, set before the run).
k7a-elastoplastic-yield — Pass · K7a
Reference: the yield surface (c)
Benchmark: vendor: literature; product: Mohr–Coulomb yield condition; version: —; doc: —; page: —; caseId: tresca-shaking
Comparison (closed-form): the yield surface (c) = 250, tolerance ≤ c
Case: (test fixture: elastoplastic_column_stays_on_the_yield_surface)
Reproduce: cargo test -p tbk-core --test k7_dynamics elastoplastic_column_stays_on_the_yield_surface
Notes: Same Gauss-point update as static phases (solver::element_kernel), full Newton on the tangent effective matrix; the elastic twin reaches 998 kPa. Asserted τ ≤ c(1 + 1e-8).
k7a-hht-zero-is-newmark — Pass · K7a
Reference: Hilber, Hughes & Taylor 1977
Benchmark: vendor: literature; product: HHT-α; version: —; doc: —; page: —; caseId: alpha-0
Comparison (closed-form): Hilber, Hughes & Taylor 1977 = 0, tolerance bitwise
Case: (test fixture: hht_zero_is_average_acceleration_bitwise)
Reproduce: cargo test -p tbk-core --test k7_dynamics hht_zero_is_average_acceleration_bitwise
Notes: Histories and end state bit-identical.
k7a-dam-free-vibration — Pending · K7a
Reference: Kramer 1996 (βn roots, G = Gb(z/H)^m)
Case: —
Reproduce: —
Notes: Doable with K7a (continuum, free vibration); not built in this round.
k7a-pulse-multilayer — Pending · K7a
Reference: spectral element method (figure)
Case: —
Reproduce: —
Notes: Doable with K7a (axisymmetric, viscous boundaries); not built in this round.
k7a-vertical-footing-dynamic — Pass · K7b
Reference: Pradhan, Baidya & Ghosh (2004) Eq. 1, as evaluated in [VF] p. 4
Comparison (closed-form): Pradhan et al. 2004 (analytical K_v) = 2335570, tolerance ±5 %
Comparison (plaxis): PLAXIS 2D 2018 = 2367090, tolerance reported
Case: tests/k7b_dynamics.rs footing_doc (100 × 50 m axisymmetric, 26 × 13 graded cells, T15)
Mesh: 676 T15 (rect, graded to 0.5 m under the footing)
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics vertical_dynamic_footing_stiffness_matches_plaxis_verification
Notes: Weightless rigid plate (EA 1e12, EI 3.335e9) on γ 16 / E 5.2e5 / ν 0.3, Rayleigh 0.4168 / 0.00201, 10 000 kPa at 4 Hz, viscous bottom + right, 1536 steps of 1/1536 s, average acceleration, consistent mass. w_max 53.161 mm (PLAXIS 2D 53.09). PLAXIS 2D misses the analytical value by 1.3 %, ours by 1.21 %. max|u_A − u_B| 0.0013 mm (rigid). Was blocked:K7b.
k7a-surface-waves — Pending · K7a
Reference: boundary elements (figure)
Case: —
Reproduce: —
Notes: Doable with K7a (harmonic prescribed displacement + viscous boundaries); not built in this round.
k7a-midas-ch4-dynamics — Pending · K7a
Case: —
Reproduce: —
Notes: Not read in this round (time); listed so the gap stays visible.
k7b-vertical-footing-wmax — Pass · K7b
Reference: F πR² / K_v(analytical)
Comparison (closed-form): F πR² / K_v(analytical) = 53.8, tolerance ±5 % (via K_v)
Case: tests/k7b_dynamics.rs footing_doc
Mesh: 676 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics vertical_dynamic_footing_stiffness_matches_plaxis_verification
Notes: Points B (r = 2 m) moves with A to 0.0013 mm; |u|max C (10 m) 7.461 mm, D (40 m) 2.043 mm — decreasing with distance as [VF] Fig. 3.
k7b-plate-beam-deflection — Pass · K7b
Reference: 5qL⁴/(384EI)
Comparison (closed-form): 5qL⁴/(384EI) = 0.130208, tolerance ±1 %
Case: tests/k7b_dynamics.rs sb_plate
Mesh: 40 plate elements (order 4)
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics simply_supported_plate_frequency_with_plate_mass
Notes: Soil deactivated (as PLAXIS), plate EA 1.2e6, EI 1000, w 0.981, ν 0; q released at t = 0. Half-amplitude of the free vibration 0.13049 m.
k7b-plate-beam-frequency — Pass · K7b
Reference: (π/2L²)√(EI/m), m = w/g
Comparison (closed-form): (π/2L²)√(EI/m), m = w/g = 1.5708, tolerance ±1 %
Case: tests/k7b_dynamics.rs sb_plate
Mesh: 40 plate elements (order 4)
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics simply_supported_plate_frequency_with_plate_mass
Notes: Consistent and lumped-hrz give 1.56976 Hz; T1 0.6370 s (PLAXIS 0.637).
k7b-undrained-p-wave-excess — Pass · K7b
Reference: Δp = q M/(M + E′oed), M = K_u − K′
Comparison (closed-form): Δp = q M/(M + E′oed), M = K_u − K′ = 9.736, tolerance ±2 %
Case: tests/k7b_dynamics.rs undrained_wave
Mesh: 40 T15 axisymmetric column
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics undrained_p_wave_speed_and_excess_pore_pressure
Notes: D187: undrained A/B generate Δp = −αMΔεv at the Gauss points in a dynamic phase (K4 route). Δσyy,total −10.0004 kPa (q = 10).
k7b-undrained-p-wave-arrival — Pass · K7b
Reference: 5 / Vp,u, Vp,u = √((K_u + 4G/3)/ρ) = 615.43 m/s
Comparison (closed-form): 5 / Vp,u, Vp,u = √((K_u + 4G/3)/ρ) = 615.43 m/s = 0.0081245, tolerance ±5 %
Case: tests/k7b_dynamics.rs undrained_wave
Mesh: 40 T15 axisymmetric column
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics undrained_p_wave_speed_and_excess_pore_pressure
Notes: Newmark 0.2652 / 0.53 smooths the front (+1.55 %).
k7b-tied-column-0.75hz — Pass · K7b
Reference: |1/cos k*H| (damped layer, Kramer 1996 §7.2)
Comparison (closed-form): |1/cos k*H| (damped layer, Kramer 1996 §7.2) = 1.406, tolerance ±2 %
Case: tests/k7b_dynamics.rs layer (2 m wide, tied sides, K0 0.5)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics tied_column_reproduces_the_1d_transfer_function_with_k0
Notes: K7a needed K0 = 0 and fixed vertical side DOFs; tied sides carry K0 = 0.5 with no start out-of-balance (the lateral reactions fold, D190).
k7b-tied-column-1.5hz — Pass · K7b
Reference: |1/cos k*H| (damped layer, Kramer 1996 §7.2)
Comparison (closed-form): |1/cos k*H| (damped layer, Kramer 1996 §7.2) = 7.9506, tolerance ±2 %
Case: tests/k7b_dynamics.rs layer (2 m wide, tied sides, K0 0.5)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics tied_column_reproduces_the_1d_transfer_function_with_k0
Notes: K7a needed K0 = 0 and fixed vertical side DOFs; tied sides carry K0 = 0.5 with no start out-of-balance (the lateral reactions fold, D190).
k7b-tied-column-3.0hz — Pass · K7b
Reference: |1/cos k*H| (damped layer, Kramer 1996 §7.2)
Comparison (closed-form): |1/cos k*H| (damped layer, Kramer 1996 §7.2) = 0.9826, tolerance ±2 %
Case: tests/k7b_dynamics.rs layer (2 m wide, tied sides, K0 0.5)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics tied_column_reproduces_the_1d_transfer_function_with_k0
Notes: K7a needed K0 = 0 and fixed vertical side DOFs; tied sides carry K0 = 0.5 with no start out-of-balance (the lateral reactions fold, D190).
k7b-tied-column-4.5hz — Pass · K7b
Reference: |1/cos k*H| (damped layer, Kramer 1996 §7.2)
Comparison (closed-form): |1/cos k*H| (damped layer, Kramer 1996 §7.2) = 3.3698, tolerance ±2 %
Case: tests/k7b_dynamics.rs layer (2 m wide, tied sides, K0 0.5)
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics tied_column_reproduces_the_1d_transfer_function_with_k0
Notes: K7a needed K0 = 0 and fixed vertical side DOFs; tied sides carry K0 = 0.5 with no start out-of-balance (the lateral reactions fold, D190).
k7b-free-field-rigid-1p5 — Pass · K7b
Reference: exact 1-D transfer function
Comparison (closed-form): exact 1-D transfer function = 7.9506, tolerance ±2 %
Case: tests/k7b_dynamics.rs layer (100 m wide, free-field sides)
Mesh: 400 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics free_field_boundaries_reproduce_the_1d_response_in_a_wide_model
Notes: x = 5 m 7.9801 (+0.37 %); plain viscous sides give 0.716 (−91 %)
k7b-free-field-rigid-3 — Pass · K7b
Reference: exact 1-D transfer function
Comparison (closed-form): exact 1-D transfer function = 0.9826, tolerance ±2 %
Case: tests/k7b_dynamics.rs layer (100 m wide, free-field sides)
Mesh: 400 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics free_field_boundaries_reproduce_the_1d_response_in_a_wide_model
Notes: x = 5 m 0.9834 (+0.09 %)
k7b-free-field-rock-1p5 — Pass · K7b
Reference: exact 1-D transfer function
Comparison (closed-form): exact 1-D transfer function = 1.5827, tolerance ±2 %
Case: tests/k7b_dynamics.rs layer (100 m wide, free-field sides)
Mesh: 400 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics free_field_boundaries_reproduce_the_1d_response_in_a_wide_model
Notes: x = 5 m 1.5855 (+0.17 %); the column base takes the base dashpots and input
k7b-baseline-closed-form — Pass · K7b
Reference: c0 T + c1 T²/2 = v(T), c0 T²/2 + c1 T³/6 = u(T)
Comparison (closed-form): c0 T + c1 T²/2 = v(T), c0 T²/2 + c1 T³/6 = u(T) = 0.233803, tolerance ±0.1 %
Case: a = sin(2π·1.3 t), T = 3.1 s, Δt = 1 ms
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics baseline_correction_matches_the_closed_form
Notes: c1 −0.1503883 vs −0.1503891; corrected discrete end velocity / displacement ≤ 6e-14 (D191 drift correction).
k7b-elc180-pga — Pass · K7b
Reference: SLAMMER record table
Comparison (published): SLAMMER record table = 0.313, tolerance ±0.0005 g
Case: verification/ground-motions/elc180-usgs-slammer.json
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics el_centro_record_parses_with_drift_correction
Notes: 3949 samples at 0.01 s; drift correction changes the PGA by +0.001 %; end v −9.42e-4 m/s → 4e-16, u 2.13e-4 m → 1e-14.
k7b-elc180-base-drift — Pass · K7b
Reference: rest
Comparison (closed-form): rest = 0, tolerance ≤ 1e-9 m
Case: [GR] column driven at a rigid base by ELC-180
Mesh: 40 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics el_centro_drives_a_rigid_base_without_drift
Notes: Uncorrected: 2.1345e-4 m (D191). Surface PGA 10.378 m/s² and peak relative ux 0.08263 m identical with / without the correction.
k7b-pm4sand-crr15-dr35 — Pass · K7c
Reference: Table 4.4 / Fig. 4.6
Comparison (published): Table 4.4 / Fig. 4.6 = 0.09, tolerance ±10 %
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand calibration_crr15_three_sands
Notes: FIXED in K7c (D232): PM4Sand v3.1 (default); FLAC-driver protocol (DSS_undrained_uniform_cyclic.fis) — FLAC and continuous cycle counts agree to 4 digits. K7b v3: 0.0792 (−12.0 %), reproduced by `version: 3`.
k7b-pm4sand-crr15-dr55 — Pass · K7c
Reference: Table 4.4 / Fig. 4.6
Comparison (published): Table 4.4 / Fig. 4.6 = 0.147, tolerance ±10 %
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand calibration_crr15_three_sands
Notes: FIXED in K7c (D232): PM4Sand v3.1 (default); FLAC-driver protocol (DSS_undrained_uniform_cyclic.fis) — FLAC and continuous cycle counts agree to 4 digits. K7b v3: 0.1275 (−13.2 %), reproduced by `version: 3`.
k7b-pm4sand-crr15-dr75 — Pass · K7c
Reference: Table 4.4 / Fig. 4.6
Comparison (published): Table 4.4 / Fig. 4.6 = 0.312, tolerance ±10 %
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand calibration_crr15_three_sands
Notes: FIXED in K7c (D232): PM4Sand v3.1 (default); FLAC-driver protocol (DSS_undrained_uniform_cyclic.fis) — FLAC and continuous cycle counts agree to 4 digits. K7b v3: 0.2847 (−8.8 %), reproduced by `version: 3`.
k7b-pm4sand-csr-n-slope-dr35 — Pass · K7c
Reference: Fig. 4.6
Comparison (published): Fig. 4.6 = 0.25, tolerance ±0.08
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand cyclic_csr_n_slope_and_bounds
Notes: K7c: v3.1 values.
k7b-pm4sand-csr-n-slope-dr55 — Pass · K7c
Reference: Fig. 4.6
Comparison (published): Fig. 4.6 = 0.29, tolerance ±0.08
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand cyclic_csr_n_slope_and_bounds
Notes: K7c: v3.1 values.
k7b-pm4sand-csr-n-slope-dr75 — Pass · K7c
Reference: Fig. 4.6
Comparison (published): Fig. 4.6 = 0.3, tolerance ±0.08
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand cyclic_csr_n_slope_and_bounds
Notes: K7c: v3.1 values.
k7b-pm4sand-drained-phi-dr35 — Pass · K7b
Reference: Figs. 4.12 / 4.14
Comparison (published): Figs. 4.12 / 4.14 = 30, tolerance ±1.5°
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand drained_monotonic_dss_reaches_critical_state
Notes: εv at γ = 10 %: -0.11 % vs -0.15 % (±0.5 %); critical state τ/σ′v = 0.545 = sin φcv (28.6°). Dr 0.75 checked at γ = 300 % (the report's Fig. 4.12 implies ≈ 9 % εv before critical state).
k7b-pm4sand-drained-phi-dr55 — Pass · K7b
Reference: Figs. 4.12 / 4.14
Comparison (published): Figs. 4.12 / 4.14 = 33.5, tolerance ±1.5°
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand drained_monotonic_dss_reaches_critical_state
Notes: εv at γ = 10 %: -0.84 % vs -0.85 % (±0.5 %); critical state τ/σ′v = 0.545 = sin φcv (28.6°). Dr 0.75 checked at γ = 300 % (the report's Fig. 4.12 implies ≈ 9 % εv before critical state).
k7b-pm4sand-drained-phi-dr75 — Pass · K7b
Reference: Figs. 4.12 / 4.14
Comparison (published): Figs. 4.12 / 4.14 = 37.7, tolerance ±1.5°
Case: element test, stress point (Voigt-6), DSS σ′v0 100 kPa, K0 0.5
Reproduce: cargo test -p tbk-core --release --test k7b_pm4sand drained_monotonic_dss_reaches_critical_state
Notes: εv at γ = 10 %: -1.62 % vs -1.65 % (±0.5 %); critical state τ/σ′v = 0.545 = sin φcv (28.6°). Dr 0.75 checked at γ = 300 % (the report's Fig. 4.12 implies ≈ 9 % εv before critical state).
k7b-liquefaction-column-ru — Deviation · K7b
Reference: pre-set gate: r_u ≥ 0.95 at 4 m, ≤ 1.05 everywhere
Comparison (cross-check): packages/geotech effective-stress-site-response.ts (Dobry/Matasovic, a different model) via app/kernel/scripts/k7b-liquefaction-crosscheck.mjs = liquefied: true; r_u at 4 m: 0.9936; max r_u: 0.9949; time to r_u 0.95: 1.363; liquefied thickness m: 7, tolerance verdict only (labelled cross-check)
Case: tests/k7b_dynamics.rs liquefaction_column_doc (1 m × 10 m, 20 T15, PM4Sand Dr 0.55 undrained A below a 2 m MC crust, water table 2 m deep, tied sides, rigid base 0.2 g × 2 Hz, 10 s, Δt 5 ms)
Mesh: 20 T15
Reproduce: cargo test -p tbk-core --release --test k7b_dynamics liquefaction_column_pm4sand_ru_reaches_one -- --ignored
Notes: OPEN (D233): the coupled effective-stress column converges through liquefaction (full Newton, 5 725 iterations, 50 s release); at 7 m r_u ≥ 0.95 from 0.68 s and 0.995 at 10 s; at 4 m r_u peaks at 0.80 (gate 0.95 fails — not widened). Likely mechanism: the deeper layer liquefies first and isolates the upper sand (base isolation). The PM4Sand cyclic-resistance shortfall at Dr 0.55 that this note used to blame (D232) has since been fixed; this row has NOT been re-run since, so the 0.80 at 4 m is the value from before that fix. Surface |ux| 1.97 m is ABSOLUTE (the undrifted harmonic base input moves ≈ A/ω·t = 1.56 m).
k7-plaxis-2d-tut15-surface-1.37-undamped — Pass · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-9 (figure read ±0.0007 mm) = 0.0339, tolerance ±10 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_surface_amplitudes_match_the_manual_figures
Notes: Figure read at 300 dpi (1 µm = 12.4 px): the value is the mean amplitude (half the peak-to-peak) of cycles 3–5, ±0.7 µm (scatter between cycles; the manual prints no number). Ours: half the peak-to-peak range over t ∈ [0.2, 0.5] s of phase 2 at the mesh node r = 1.375 (PLAXIS node at r = 1.37). Model as the manual: E′ 50 000 kPa, ν′ 0.3, γ 20, plate EA 7.6e6 / EI 24e3 / w 5, static 8 kPa, harmonic 10 kPa sin(2π·10 t) for 0.5 s, viscous bottom + right, 1000 steps of 0.5 ms, average acceleration, consistent mass; no material damping. Gate ±10 % (figure read ±2–5 % + the two codes' different meshes), set before the first run.
k7-plaxis-2d-tut15-surface-1.94-undamped — Pass · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-9 (figure read ±0.0007 mm) = 0.0236, tolerance ±10 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_surface_amplitudes_match_the_manual_figures
Notes: Figure read at 300 dpi (1 µm = 12.4 px): the value is the mean amplitude (half the peak-to-peak) of cycles 3–5, ±0.7 µm (scatter between cycles; the manual prints no number). Ours: half the peak-to-peak range over t ∈ [0.2, 0.5] s of phase 2 at the mesh node r = 1.9375 (PLAXIS node at r = 1.94). Model as the manual: E′ 50 000 kPa, ν′ 0.3, γ 20, plate EA 7.6e6 / EI 24e3 / w 5, static 8 kPa, harmonic 10 kPa sin(2π·10 t) for 0.5 s, viscous bottom + right, 1000 steps of 0.5 ms, average acceleration, consistent mass; no material damping. Gate ±10 % (figure read ±2–5 % + the two codes' different meshes), set before the first run.
k7-plaxis-2d-tut15-surface-3.60-undamped — Pass · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-9 (figure read ±0.0007 mm) = 0.0138, tolerance ±10 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_surface_amplitudes_match_the_manual_figures
Notes: Figure read at 300 dpi (1 µm = 12.4 px): the value is the mean amplitude (half the peak-to-peak) of cycles 3–5, ±0.7 µm (scatter between cycles; the manual prints no number). Ours: half the peak-to-peak range over t ∈ [0.2, 0.5] s of phase 2 at the mesh node r = 3.6 (PLAXIS node at r = 3.60). Model as the manual: E′ 50 000 kPa, ν′ 0.3, γ 20, plate EA 7.6e6 / EI 24e3 / w 5, static 8 kPa, harmonic 10 kPa sin(2π·10 t) for 0.5 s, viscous bottom + right, 1000 steps of 0.5 ms, average acceleration, consistent mass; no material damping. Gate ±10 % (figure read ±2–5 % + the two codes' different meshes), set before the first run.
k7-plaxis-2d-tut15-surface-1.37-damped — Pass · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-10 (figure read ±0.0007 mm) = 0.0322, tolerance ±10 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_surface_amplitudes_match_the_manual_figures
Notes: Figure read at 300 dpi (1 µm = 12.4 px): the value is the mean amplitude (half the peak-to-peak) of cycles 3–5, ±0.7 µm (scatter between cycles; the manual prints no number). Ours: half the peak-to-peak range over t ∈ [0.2, 0.5] s of phase 2 at the mesh node r = 1.375 (PLAXIS node at r = 1.37). Model as the manual: E′ 50 000 kPa, ν′ 0.3, γ 20, plate EA 7.6e6 / EI 24e3 / w 5, static 8 kPa, harmonic 10 kPa sin(2π·10 t) for 0.5 s, viscous bottom + right, 1000 steps of 0.5 ms, average acceleration, consistent mass; Rayleigh ξ = 5 % at 1 and 10 Hz (α 0.5712, β 1.447e-3). Gate ±10 % (figure read ±2–5 % + the two codes' different meshes), set before the first run.
k7-plaxis-2d-tut15-surface-1.94-damped — Pass · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-10 (figure read ±0.0007 mm) = 0.022, tolerance ±10 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_surface_amplitudes_match_the_manual_figures
Notes: Figure read at 300 dpi (1 µm = 12.4 px): the value is the mean amplitude (half the peak-to-peak) of cycles 3–5, ±0.7 µm (scatter between cycles; the manual prints no number). Ours: half the peak-to-peak range over t ∈ [0.2, 0.5] s of phase 2 at the mesh node r = 1.9375 (PLAXIS node at r = 1.94). Model as the manual: E′ 50 000 kPa, ν′ 0.3, γ 20, plate EA 7.6e6 / EI 24e3 / w 5, static 8 kPa, harmonic 10 kPa sin(2π·10 t) for 0.5 s, viscous bottom + right, 1000 steps of 0.5 ms, average acceleration, consistent mass; Rayleigh ξ = 5 % at 1 and 10 Hz (α 0.5712, β 1.447e-3). Gate ±10 % (figure read ±2–5 % + the two codes' different meshes), set before the first run.
k7-plaxis-2d-tut15-surface-3.60-damped — Pass · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-10 (figure read ±0.0007 mm) = 0.0116, tolerance ±10 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_surface_amplitudes_match_the_manual_figures
Notes: Figure read at 300 dpi (1 µm = 12.4 px): the value is the mean amplitude (half the peak-to-peak) of cycles 3–5, ±0.7 µm (scatter between cycles; the manual prints no number). Ours: half the peak-to-peak range over t ∈ [0.2, 0.5] s of phase 2 at the mesh node r = 3.6 (PLAXIS node at r = 3.60). Model as the manual: E′ 50 000 kPa, ν′ 0.3, γ 20, plate EA 7.6e6 / EI 24e3 / w 5, static 8 kPa, harmonic 10 kPa sin(2π·10 t) for 0.5 s, viscous bottom + right, 1000 steps of 0.5 ms, average acceleration, consistent mass; Rayleigh ξ = 5 % at 1 and 10 Hz (α 0.5712, β 1.447e-3). Gate ±10 % (figure read ±2–5 % + the two codes' different meshes), set before the first run.
k7-plaxis-2d-tut15-footing-lysmer-analog — Pass · K7
Reference: Lysmer analog, Lysmer (1965) Eqs. 85, 87–90 (closed form); its own accuracy vs the exact half-space: ≤ 8 % for a0 < 0.8 (p. 44, Eq. 86, Fig. 21)
Comparison (closed-form): Lysmer 1965 analog (k = 4GR/(1−ν), c = 3.4R²√(Gρ)/(1−ν)) = 0.1416, tolerance ±8 % (analog accuracy, a0 < 0.8)
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_footing_amplitude_matches_lysmer_analog
Notes: Lysmer's analog (Lysmer 1965, Contract Report 3-115, Eqs. 85, 87–90; Lysmer & Richart 1966; Richart, Hall & Woods 1970 §7): k = 4GR/(1−ν) = 54 945 kN/m, c = 3.4R²√(Gρ)/(1−ν) = 240.4 kN s/m, a0 = ωR/Vs = 0.323 (Vs 97.1 m/s), |u| = F0/√((k−mω²)² + (cω)²), F0 = 10 kPa·πR² = 7.854 kN. FE amplitude on the axis 0.1360 mm (plate edge 0.1351 mm, −4.61 %); gate ±8 % = the analog's own cited accuracy at a0 < 0.8 (so this verifies the FE to within the analog's accuracy, not better). Phase lag behind the load: FE 15.14°, analog 15.81° (Δ −0.66°, reported, no cited tolerance). Lysmer p. 44: the analog error may reach 35 % only for a0 > 0.8 and B < 1/2 — a0 here is 0.32. The manual gives no footing displacement figure (only surface points).
k7-plaxis-2d-tut15-footing-lysmer-analog-with-generator-mass — Pass · K7
Reference: Lysmer analog, Lysmer (1965) Eqs. 85, 87–90 (closed form); accuracy ≤ 8 % for a0 < 0.8 (p. 44)
Comparison (closed-form): Lysmer 1965 analog = 0.1481, tolerance ±8 % (analog accuracy, a0 < 0.8)
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15) with plate weight w = 13 kN/m/m (footing 5 + generator 8: the plate now carries the generator's MASS)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_footing_amplitude_matches_lysmer_analog
Notes: Not a PLAXIS case: the manual's static load has no mass; this variant puts the generator's weight into the plate to exercise the mass term of the analog (m = 1.041 t). Lysmer's analog (Lysmer 1965, Contract Report 3-115, Eqs. 85, 87–90; Lysmer & Richart 1966; Richart, Hall & Woods 1970 §7): k = 4GR/(1−ν) = 54 945 kN/m, c = 3.4R²√(Gρ)/(1−ν) = 240.4 kN s/m, a0 = ωR/Vs = 0.323 (Vs 97.1 m/s), |u| = F0/√((k−mω²)² + (cω)²), F0 = 10 kPa·πR² = 7.854 kN. Plate edge 0.1411 mm (−4.73 %). Phase lag FE 15.84°, analog 16.55° (Δ −0.71°). Gate ±8 % as above.
k7-plaxis-2d-tut15-boundary-distance-20x10-vs-40x20 — Pass · K7
Reference: no reflection → the steady amplitude does not depend on the box size (Lysmer & Kuhlemeyer 1969 absorbing boundaries)
Comparison (closed-form): Lysmer & Kuhlemeyer 1969 (no reflection) = 0, tolerance ≤ 5 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15) vs the same model in 40 × 20 m
Mesh: 170 T15 (20 × 10) vs 286 T15 (40 × 20)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_boundary_distance_study
Notes: Boundary-distance study, undamped, steady amplitude over t ∈ [0.2, 0.5] s at the footing axis and r = 1.375 / 1.9375 / 3.6 m; the box also deepens (layer depth 5 → 10 → 20 m; λs = 9.7 m at 10 Hz). 40 × 20 m: 0.1360 / 0.0346 / 0.0245 / 0.0139 mm; 20 × 10 m: 0.1360 / 0.0336 / 0.0239 / 0.0141 mm (−0.01 / −2.76 / −2.37 / +1.20 %); 10 × 5 m: 0.1382 / 0.0339 / 0.0238 / 0.0133 mm (+1.67 / −1.86 / −2.65 / −4.60 %). Gate ≤ 5 % at every point, set before the first run. The part of the signal that returns from the boundaries is much larger after the load stops: free-vibration residual (phase 3, t ∈ [0.1, 0.5] s) at r 1.375: 3.31 µm (40 × 20), 5.31 µm (20 × 10), 13.70 µm (10 × 5) — see the free-vibration residual rows.
k7-plaxis-2d-tut15-boundary-distance-10x5-vs-40x20 — Pass · K7
Reference: no reflection → the steady amplitude does not depend on the box size (Lysmer & Kuhlemeyer 1969 absorbing boundaries)
Comparison (closed-form): Lysmer & Kuhlemeyer 1969 (no reflection) = 0, tolerance ≤ 10 %
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15) at 10 × 5 m vs 40 × 20 m
Mesh: 91 T15 (10 × 5) vs 286 T15 (40 × 20)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_boundary_distance_study
Notes: Boundary-distance study, undamped, steady amplitude over t ∈ [0.2, 0.5] s at the footing axis and r = 1.375 / 1.9375 / 3.6 m; the box also deepens (layer depth 5 → 10 → 20 m; λs = 9.7 m at 10 Hz). 40 × 20 m: 0.1360 / 0.0346 / 0.0245 / 0.0139 mm; 20 × 10 m: 0.1360 / 0.0336 / 0.0239 / 0.0141 mm (−0.01 / −2.76 / −2.37 / +1.20 %); 10 × 5 m: 0.1382 / 0.0339 / 0.0238 / 0.0133 mm (+1.67 / −1.86 / −2.65 / −4.60 %). Gate ≤ 10 % at every point, set before the first run.
k7-plaxis-2d-tut15-free-vibration-residual-undamped — Deviation · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-9 (figure read ±0.4 µm) = 0.0034, tolerance reported
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15)
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_damping_accelerates_the_free_vibration
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): undamped 5.31 µm, damped 3.13 µm, ratio 0.591; dominant 9.6 Hz; extra log-decrement per cycle from Rayleigh damping 0.417 vs 2πξ(f) = 0.303 — the damping is at least as strong as specified. Checked (no defect found): α 0.5712 / β 1.447e-3 equal PLAXIS's (rows k7-plaxis-2d-tut15-rayleigh-alpha/-beta); C = αM + βK on the absolute velocity; the Lysmer dashpots ρVp / ρVs with C1 = C2 = 1 (RM 2025.1 §7.11.8.2 'standard values') are integrated with the axisymmetric r weight (model/dynamic.rs edge_mass_scalar). The 'residual' is OUR measure (half peak-to-peak over 0.6–1.0 s): the manual prints no number, only Figs 15-9 / 15-10 and 'the vibration is totally seized' (p. 242); the figure reads stand. Rough estimate, not a proof: Rayleigh damping at ξ ≈ 0.048, 9.6 Hz attenuates a shear wave by exp(−ξωx/Vs) ≈ 0.30 over 40 m and ≈ 0.55 over 20 m, so PLAXIS's damped/undamped tail ratio ≈ 0.24 points at long-path (side-boundary) returns and ours (0.59) at short-path (base) returns; with our box at 40 × 20 m the undamped tail falls to 3.31 µm (the figure's value). More energy seems to come back from our base boundary than from PLAXIS's in the same box. Cause not isolated (class C: probable boundary-absorption or mesh difference, not reached). || Phase 3 (generator stopped, static load on), residual = half the peak-to-peak range of u_y at the surface point r 1.375 over t ∈ [0.6, 1.0] s global. Figure read of the manual (Fig. 15-9): ≈ 3.4 µm ±0.4 µm. Ours is larger: 5.31 µm undamped. The kernel's own box-size study shows the residual is energy returning from the boundaries (r 1.375, undamped: 10 × 5 m 13.70 µm, 20 × 10 m 5.31 µm, 40 × 20 m 3.31 µm — the 40 × 20 m value is the one that matches the figure). Viscous boundaries with C1 = C2 = 1 as the 2025.1 Reference Manual standard values (§7.11.8.2); the manual's mesh (Fig. 15-3) is coarser than ours in the far field, which is the first suspect. Near-field steady amplitudes agree with the figures within 3.1 % (surface rows). Qualitative claim gated and passing: damped residual < undamped (ratio 0.59 at r 1.375, 0.77 at 3.6, 0.55 on the axis) and the damped decay is steeper. The extra log decrement per cycle that Rayleigh damping adds (≈ 0.34 + 0.07 = 0.42 at r 1.375, 9.6 Hz) is of the order of the Rayleigh 2πξ(f) = 0.30 (reported, not gated).
k7-plaxis-2d-tut15-free-vibration-residual-damped — Deviation · K7
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-10 (figure read ±0.3 µm) = 0.0008, tolerance reported
Case: tests/k7_tut15_generator.rs doc(Cfg::plaxis()) (20 × 10 m axisymmetric, 17 × 10 graded cells, T15) with Rayleigh ξ = 5 % at 1 and 10 Hz
Mesh: 170 T15 (rect, graded: 0.25 m under the 0.5 m radius footing, nodes at r = 1.375 / 1.9375 / 3.6)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_damping_accelerates_the_free_vibration
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): undamped 5.31 µm, damped 3.13 µm, ratio 0.591; dominant 9.6 Hz; extra log-decrement per cycle from Rayleigh damping 0.417 vs 2πξ(f) = 0.303 — the damping is at least as strong as specified. Checked (no defect found): α 0.5712 / β 1.447e-3 equal PLAXIS's (rows k7-plaxis-2d-tut15-rayleigh-alpha/-beta); C = αM + βK on the absolute velocity; the Lysmer dashpots ρVp / ρVs with C1 = C2 = 1 (RM 2025.1 §7.11.8.2 'standard values') are integrated with the axisymmetric r weight (model/dynamic.rs edge_mass_scalar). The 'residual' is OUR measure (half peak-to-peak over 0.6–1.0 s): the manual prints no number, only Figs 15-9 / 15-10 and 'the vibration is totally seized' (p. 242); the figure reads stand. Rough estimate, not a proof: Rayleigh damping at ξ ≈ 0.048, 9.6 Hz attenuates a shear wave by exp(−ξωx/Vs) ≈ 0.30 over 40 m and ≈ 0.55 over 20 m, so PLAXIS's damped/undamped tail ratio ≈ 0.24 points at long-path (side-boundary) returns and ours (0.59) at short-path (base) returns; with our box at 40 × 20 m the undamped tail falls to 3.31 µm (the figure's value). More energy seems to come back from our base boundary than from PLAXIS's in the same box. Cause not isolated (class C: probable boundary-absorption or mesh difference, not reached). || Phase 3 (generator stopped, static load on), residual = half the peak-to-peak range of u_y at the surface point r 1.375 over t ∈ [0.6, 1.0] s global. Figure read of the manual (Fig. 15-10): ≈ 0.8 µm ±0.3 µm. Ours is larger: 3.13 µm damped (the ratio damped/undamped is 0.59 vs ≈ 0.24 in the figures). The kernel's own box-size study shows the residual is energy returning from the boundaries (r 1.375, undamped: 10 × 5 m 13.70 µm, 20 × 10 m 5.31 µm, 40 × 20 m 3.31 µm — the 40 × 20 m value is the one that matches the figure). Viscous boundaries with C1 = C2 = 1 as the 2025.1 Reference Manual standard values (§7.11.8.2); the manual's mesh (Fig. 15-3) is coarser than ours in the far field, which is the first suspect. Near-field steady amplitudes agree with the figures within 3.1 % (surface rows). Qualitative claim gated and passing: damped residual < undamped (ratio 0.59 at r 1.375, 0.77 at 3.6, 0.55 on the axis) and the damped decay is steeper. The extra log decrement per cycle that Rayleigh damping adds (≈ 0.34 + 0.07 = 0.42 at r 1.375, 9.6 Hz) is of the order of the Rayleigh 2πξ(f) = 0.30 (reported, not gated).
k7-plaxis-2d-tut15-rayleigh-alpha — Pass · K7
Reference: printed in Fig. 15-8 (α = 2ξω1ω2/(ω1+ω2))
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-8 = 0.5712, tolerance ±0.00005
Case: tests/k7_tut15_generator.rs tut15_rayleigh_coefficients_match_the_manual (no mesh)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_rayleigh_coefficients_match_the_manual
Notes: Gate: within half a unit of the 4th printed digit.
k7-plaxis-2d-tut15-rayleigh-beta — Pass · K7
Reference: printed in Fig. 15-8 (β = 2ξ/(ω1+ω2))
Comparison (plaxis): PLAXIS 2D 2025.1 Tutorial Manual Fig. 15-8 = 0.001447, tolerance ±0.0000005
Case: tests/k7_tut15_generator.rs tut15_rayleigh_coefficients_match_the_manual (no mesh)
Reproduce: cargo test -p tbk-core --release --test k7_tut15_generator tut15_rayleigh_coefficients_match_the_manual
Notes: Gate: within half a unit of the 4th printed digit (1.447E-3).
Cited validation suites — 32
cpt-liquefaction-web-validation.test.ts
Validation for the CPT liquefaction-triggering engine (`cpt-liquefaction.ts`).
Analyses validated: cpt-liquefaction · Recorded run: passed — 24 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the CPT liquefaction-triggering engine (`cpt-liquefaction.ts`).
PUBLISHED SOURCES (both opened and read for this suite):
- Boulanger, R.W. & Idriss, I.M. (2014), "CPT and SPT Based Liquefaction Triggering Procedures",
Report No. UCD/CGM-14/01, Center for Geotechnical Modeling, Univ. of California, Davis.
Table 3.1 (the 253-case CPT case-history database, with the authors' own printed q_c1N, Δq_c1N,
q_c1N,cs, r_d, CSR, K_σ, MSF and CSR_{M=7.5,σ'=1atm} for every case), Table 4.1, §4.1 (counts of
points below / above the deterministic curve), §2.5 (MSF_max statements), Eq. 2.24 / 4.1 / 5.24.
- Idriss, I.M. & Boulanger, R.W. (2008), "Soil Liquefaction During Earthquakes", EERI Monograph
MNO-12, Appendix B: the authors' printed worked CPT example (Loma Prieta site, a_max 0.28 g,
M 6.9, water table 1.8 m) — printed spreadsheet rows read from the page images.
WHAT IS A PUBLISHED ANSWER HERE. Every number passed as the EXPECTED value in the Table 3.1 /
Appendix B / §4.1 tests is a number printed in those documents; it is not computed by this engine
or by hand. The two tests at the end labelled "HAND-DERIVED" check a relation between two
equations (not a printed answer) and are not counted as published values.
ENGINE BUG FOUND BY THIS SUITE (fixed in cpt-liquefaction.ts): the engine used the constant 2.60
in the CRR expression. 2.60 is the MEDIAN curve (P_L = 50 %) of the probabilistic Eq. 5.24; the
deterministic curve the report recommends for a factor of safety (Eq. 2.24 / 4.1, P_L ≈ 16 %) uses
2.80. With 2.60 the engine over-stated CRR by exp(0.20) = 1.22 (unconservative) and placed 25
liquefied case histories below the "deterministic" curve where the report finds 5 (and 20, not 32,
no-liquefaction cases above it). With 2.80 the whole 253-row database reproduces the report's
counts exactly — see the "§4.1 counts" test.
TOLERANCES (each one justified by the source's own rounding, none loosened to pass):
- The report normalises with P_a = 101 kPa; the engine uses 101.325 kPa (0.3 % different), which
moves C_N by ≤ 0.3 % · m ≈ 0.2 %.
- Table 3.1 prints σ_vc and σ'_vc as whole kPa, so a stress of ~35–50 kPa is uncertain by up to
±0.5 kPa ≈ 1–1.5 %; CSR (a ratio of the two) therefore carries up to ≈ 2 % — tolerance 3 %.
- q_c1N is printed to 0.1, r_d / K_σ / MSF to 0.01 (±0.005), CSR to 0.001.
| Test block (the published value it checks) | Verdict |
| Table 3.1 — 1964 Niigata, D Kawagisho-cho — clean sand (FC 3 %), z 4.4 m, M 7.6 | Pass |
| Table 3.1 — 1968 Inangahua, Three Channel Flat — silty sand (FC 18 %), N_c cap region (CN 1.55) | Pass |
| Table 3.1 — 1981 Westmorland, Kornbloom Rd (K4) — very high fines (FC 85 %), M 5.9 | Pass |
| Table 3.1 — 1989 Loma Prieta, Sandhold Road SI-2 — very dense sand, q_c1N,cs 311.9 > 211 (cap region) | Pass |
| Table 3.1 — 1995 Hyogoken-Nambu, Fukuzumi Park — deepest case (11.8 m), K_σ < 1 | Pass |
| Table 3.1 — 1994 Northridge, Balboa Blvd Unit C (BAL-10) — highest σ′_v (147 kPa), FC 50 % | Pass |
| Table 3.1 — 2011 Tohoku, Hinode ES — M 9.0, FC 25 %, K_σ at its 1.10 cap | Pass |
| Table 3.1 — 1995 Hyogoken-Nambu, Yoshida Kogyo Factory — q_c1N,cs 216 just above 211, K_σ at 1.10 cap | Pass |
| Table 3.1 — 1999 Kocaeli, Hotel Sapanca SH-4 — lowest σ′_v (19 kPa): C_N capped at 1.70 | Pass |
| Table 3.1 — 1989 Loma Prieta, Marine Lab (C4) — loose clean sand q_c1N,cs 24.4 (m-limit region) | Pass |
| Table 3.1 — 1981 Westmorland, McKim Ranch Unit A (M7) — smallest M (5.9), MSF 1.12 | Pass |
| Table 3.1 — 2011 Tohoku, Akemi ES — M 9.0, 10.1 m, σ′_v ~ 1 atm | Pass |
| MNO-12 App. B row 47 — z 1.80 m (water table), q_cN 26.5, σ 34/34 kPa | Pass |
| MNO-12 App. B row 49 — z 1.90 m, q_cN 34.0, σ 36/35 kPa | Pass |
| MNO-12 App. B row 51 — z 2.00 m, q_cN 39.6, σ 38/36 kPa | Pass |
| MNO-12 App. B row 53 — z 2.10 m, q_cN 45.1, σ 40/37 kPa | Pass |
| MNO-12 App. B row 166 — z 7.75 m, q_cN 150.5, σ 153/95 kPa (C_N below 1.7) | Pass |
| MNO-12 App. B row 168 — z 7.85 m, q_cN 112.3, σ 155/96 kPa | Pass |
| MNO-12 App. B row 170 — z 7.95 m, q_cN 81.8, σ 157/97 kPa | Pass |
| MNO-12 App. B row 175 — z 8.20 m, q_cN 120.0, σ 162/99 kPa | Pass |
| §2.5 printed statement: MSF_max = 1.8 at q_c1Ncs ≈ 160 | Pass |
| §2.5 printed statement: MSF_max ≈ 1.10 for q_c1Ncs < 60 (loose sands) | Pass |
| B&I 2014 §4.1 counts: 253 cases; 5 liquefaction points below and 32 no-liquefaction points above the deterministic curve | Pass |
| HAND-DERIVED: deterministic CRR = median (C0 = 2.60) CRR × exp(−0.20), i.e. one σ_lnR below the median | Pass |
design-code-spectrum-ec8-web-validation.test.ts
EN 1998-1 (Eurocode 8) horizontal elastic response spectrum — anchored to the standard and to a published European worked example.
Analyses validated: design-code-spectrum · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
EN 1998-1 (Eurocode 8) horizontal elastic response spectrum — anchored to the standard
and to a published European worked example.
SOURCES
BS EN 1998-1:2004, "Eurocode 8: Design of structures for earthquake resistance —
Part 1: General rules, seismic actions and rules for buildings":
Table 3.1 Ground types A-E (+ S1, S2) (p. 30)
§3.2.2.2(1)P expressions (3.2)-(3.5) — the four spectrum branches (p. 36)
Table 3.2 Type 1 spectrum parameters S, TB, TC, TD (p. 38)
Table 3.3 Type 2 spectrum parameters S, TB, TC, TD (p. 38)
§3.2.2.2(2)P NOTE — when to use Type 2 rather than Type 1 (p. 37)
"Eurocode 8: Seismic Design of Buildings — Worked examples" (support to the
implementation, harmonisation and further development of the Eurocodes), §2.1.2.1
"Seismic actions" (p. 29) — the fully specified design case used below.
WHY THIS MATTERS
Until now TerraBrains had NO verified European seismic path: EN 1998 was not on disk,
so the EC8 branch of `design-code-spectrum` had never been checked against the standard.
The audit measured 17 EN/BS citations on the rendered /capabilities page against 108
IS/IRC, and this was the largest single hole in that gap.
DEFECT FOUND (E-38, unsafe direction)
The engine hardcoded the **Type 1** spectrum. EN 1998-1 §3.2.2.2(2)P NOTE states that
where "the earthquakes that contribute most to the seismic hazard defined for the site
… have a surface-wave magnitude, Ms, not greater than 5,5, it is recommended that the
Type 2 spectrum is adopted" — which covers much of northern and central Europe. Type 2
has a HIGHER soil factor on every ground type except A, so silently returning Type 1
UNDER-predicts the plateau acceleration:
ground type | S (Type 1) | S (Type 2) | Type 1 under-predicts by
A | 1.00 | 1.00 | —
B | 1.20 | 1.35 | 11.1 %
C | 1.15 | 1.50 | 23.3 %
D | 1.35 | 1.80 | 25.0 %
E | 1.40 | 1.60 | 12.5 %
(Percentages are 1 − S_T1/S_T2, i.e. how much of the Type 2 plateau is missing.)
SECOND DEFECT (E-39)
Ground type **E** was absent from the parameter table entirely, so a type-E site fell
through to C or D. Table 3.1 defines E by PROFILE GEOMETRY — "a surface alluvium layer
with Vs values of type C or D and thickness varying between about 5 m and 20 m,
underlain by stiffer material with Vs > 800 m/s" — so it is unreachable from Vs30 and
must be selectable. Fixed with an explicit `ec8_ground_type` override.
Types S1 and S2 are deliberately NOT offered: §3.1.2(4) requires special study, so
handing back a table value for them would be a wrong answer dressed as a right one.
| Test block (the published value it checks) | Verdict |
| EN 1998-1 Table 3.2 (Type 1): S, TB, TC, TD reproduced for ground types A-E | Pass |
| EN 1998-1 Table 3.3 (Type 2): S, TB, TC, TD reproduced for ground types A-E | Pass |
| EC8 worked example §2.1.2.1: ground B, Type 1, agR = 0.25g, γI = 1.0 ⇒ plateau 0.75 g | Pass |
| EC8 worked example: the design spectrum with q = 3.0 is the elastic one divided by q on the plateau | Pass |
| E-38: Type 1 UNDER-predicts the Type 2 plateau on every ground type except A | Pass |
| E-38: the two shapes really are different curves, not a scale factor | Pass |
| EN 1998-1 Table 3.1: Vs30 bands A > 800, B 360-800, C 180-360, D < 180 | Pass |
| E-39: ground type E is unreachable from Vs30 and must be selectable explicitly | Pass |
| the spectrum is continuous at TB, TC and TD for both shapes and all ground types | Pass |
| defaults are unchanged: no spectrum_type ⇒ Type 1, and ag defaults to 0.25 g | Pass |
| a negative or absent ag is clamped, and Sa stays finite everywhere | Pass |
design-code-spectrum-web-validation.test.ts
WEB-BENCHMARK validation for the shared design-code-spectrum module and the 2-D site-response CODE-SITE-FACTOR overlay (`fe-site-response-2d`).
Analyses validated: design-code-spectrum, fe-site-response-2d · Recorded run: passed — 17 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the shared design-code-spectrum module and the
2-D site-response CODE-SITE-FACTOR overlay (`fe-site-response-2d`).
The elastic spectra themselves (IS 1893 / ASCE 7 / EC8) are already validated
to ≥20 cited points by `nonlinear-site-response-codespectrum-web-validation` — the
SAME `codeDesignSpectrum` is used here (one source of truth). This file adds
EXACT golden anchors for the NEW `codeSiteAmplification` (the soil-class / rock
design-Sa ratio the code implicitly credits) plus the 2-D FE overlay verdict.
The anchors are exact because inside every code's constant-acceleration
plateau the soil/rock ratio collapses to a pure site-factor ratio:
• EC8 §3.2.2.2: in [TB,TC]∩[TB_A,TC_A], Sa = ag·S·2.5 ⇒ ratio = S_soil/S_A
(A 1.0 · B 1.2 · C 1.15 · D 1.35).
• ASCE 7-16 §11.4.6: in [T0,Ts], Sa = SDS = (2/3)Fa·Ss ⇒ ratio = Fa_soil/Fa_A
(Fa from Table 11.4-1; A hard-rock Fa=0.8).
• IS 1893:2016 Cl 6.4.2: the plateau (Sa/g)=2.5 is the SAME for all soil
types, so the short-period soil factor is 1.0 — IS amplifies the LONGER
period range (higher Tc, softer k), not the short-period plateau.
Sources: IS 1893 (Part 1):2016 Cl 6.4.2 Table 3; ASCE/SEI 7-16 Tables 11.4-1/2;
EN 1998-1:2004 Table 3.2/3.3; Kramer (1996) Ch.7; Bard & Bouchon (1985).
| Test block (the published value it checks) | Verdict |
| dcs 1: EC8 class C / rock A at T=0.3 s ⇒ S ratio = 1.15/1.0 = 1.15 | Pass |
| dcs 2: EC8 class B / rock A at T=0.3 s ⇒ 1.20 | Pass |
| dcs 3: EC8 class D / rock A at T=0.3 s ⇒ 1.35 | Pass |
| dcs 4: EC8 amplification is independent of a_g (ratio cancels) | Pass |
| dcs 5: ASCE class D / rock A at T=0.3 s, Ss=1.0 ⇒ Fa ratio 1.1/0.8 = 1.375 | Pass |
| dcs 6: ASCE class D / rock A at low Ss=0.25 ⇒ Fa 1.6/0.8 = 2.0 | Pass |
| dcs 7: ASCE class C / rock A at Ss=1.0 ⇒ Fa 1.2/0.8 = 1.5 | Pass |
| dcs 8: IS 1893 short-period (T=0.3 s) soil factor = 1.0 (same 2.5 plateau) | Pass |
| dcs 9: IS 1893 Type II / I at T=0.6 s ⇒ (1.36/0.6)/(1.0/0.6) = 1.36 | Pass |
| dcs 10: IS 1893 Type III / I at T=1.0 s ⇒ 1.67 (soft-soil long-period amplification) | Pass |
| dcs 11: softer soil ⇒ higher (or equal) code site factor at a long period | Pass |
| dcs 12: site class strings match the Vs thresholds | Pass |
| dcs 13: rock reference class is the firm-rock class (A / A / I) | Pass |
| dcs 14: 2-D overlay reports site class, code factor and a verdict for each code | Pass |
| dcs 15: a basin (2-D focusing) EXCEEDS the code 1-D site factor (Mexico City lesson) | Pass |
| dcs 16: no overlay fields when seismic_code is omitted (opt-in) | Pass |
| dcs 17: the 2-D overlay uses the SAME code factor as a direct module call | Pass |
⚑ dynamic-compaction-web-validation.test.ts
Web/published-source validation for `dynamic-compaction.ts` (Ménard dynamic compaction).
Analyses validated: dynamic-compaction · Recorded run: passed — 80 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web/published-source validation for `dynamic-compaction.ts` (Ménard dynamic compaction).
Every expected value below was READ from a document on disk (opened with pdftotext, and the
two GEC-1 case-history tables were also rendered and read as images). Nothing is a number
from memory and nothing was produced by running this engine. Page numbers are the PRINTED
page of each document.
[S3] Rocscience, Settle3 Dynamic Compaction Verification Manual, v5.026 (2025), pp. 3–8
(Settle3-Verification-Manual-Dynamic-Compaction.pdf). Example "derived from Jie Han's
(2014) design example": 18.2 t tamper, 1.5 m diameter; high-energy pass 6 drops from
30.2 m, ironing pass 3 drops from 7.2 m, 3 m × 3 m grid, n_c = 0.35.
[HAN] Han, J. (2015) Principles and Practice of Ground Improvement, Wiley, §3.5, pp. 89–99
(Han-Principles-and-Practice-of-Ground-Improvement-Wiley-2015-435p.pdf): Eqs 3.16–3.23,
Tables 3.9–3.13, design example §3.5.5 (pp. 98–99). Note the Settle3 manual cites the
2014 printing of the same example; the book on disk is the 2015 printing.
[G1] Lukas, R.G. (1995) Dynamic Compaction, FHWA-SA-95-037 (GEC-1): Eq. 1 p. 27, Table 2 p. 17,
Table 7 p. 33, Table 8 p. 34, Indiana landfill case pp. 59–63, Florida case pp. 65–67
(FHWA-SA-95-037-GEC1-1995-Lukas-Dynamic-Compaction.pdf).
[RD] Lukas, R.G. (1986) Dynamic Compaction for Highway Construction Vol. I, FHWA/RD-86/133,
pp. 47–52 (Eqs 4–5, Tables 5–6) (FHWA-RD-86-133-Lukas-1986-...-Vol-I.pdf).
TOLERANCE POLICY. A tolerance is never widened to make a case pass. Each case states why its
tolerance is what it is: (a) half a unit in the last digit the source PRINTS, or (b) the source
itself rounded an intermediate value (so the published number and an unrounded recomputation
must differ by that rounding), stated per case. Cases that do not reproduce within their
source-justified tolerance are recorded as DEVIATIONS, not hidden (see the last block).
LEDGER. Computed-value cases are enumerated in CASES; table-lookup transcription checks are
listed separately in LOOKUPS and are NOT counted towards the ≥ 20 computed-value bar.
PUBLISHED-VALUES: 50
(Distinct (source, locator) printed values reproduced by the computed cases: Settle3 11 + Han 11 +
GEC-1 10 + FHWA/RD-86/133 Table 5 18 (7 distinct theoretical speeds, 9 ratios, 2 efficiency statements).
Excluded from the 50 as duplicates or hand checks: HAN-3 (30.2 m again by a second equation), HAN-11
(1.5 + 0.3), HAN-14 (the Settle3 1.5 m crater again), RD-V Great Lakes 18 ft (34.0 ft/s again).
Not counted either: the 18 table-lookup transcriptions, the 4 recorded deviations, the inferred 30 ft check.)
| Test block (the published value it checks) | Verdict |
| [S3-1] Depth of improvement D_i = 0.35·√(18.2·30.2) (m) — S3 §1.2 p.4 | Pass |
| [S3-2] Applied energy, high-energy pass AE_HEP (MJ/m²) — S3 §1.3 p.4 | Pass |
| [S3-3] Applied energy, ironing pass AE_IP (MJ/m²) — S3 §1.3 p.4 | Pass |
| [S3-4] Total applied energy AE_HEP + AE_IP ("~4.02 MJ/m² per pass") — S3 §1.3 p.5 | Pass |
| [S3-5] Improved elastic modulus E = (E/N)·N = 2 × 32.56 (MPa) — S3 §1.5 Eq. 4 p.6 | Pass |
| [S3-6] Crater depth, Rollins–Kim detailed formula (m) "≈ 1.5 m" — S3 §1.6 Eq. 5 p.7 | Pass |
| [S3-7] Area ratio of improvement a_r = 1.767/9 — S3 §1.7 p.7 | Pass |
| [S3-8] Induced settlement S = N_p·a_r·d_cd = 2 × 0.196 × 1.5 (m) — S3 §1.7 Eq. 6 p.7 | Pass |
| [S3-9] Peak particle velocity at 20 m (mm/s) — S3 §1.8 Eq. 7 p.8 | Pass |
| [S3-10] Design total energy = 850 kJ/m³ × 8.2 m = 6.97 MJ/m² (via design mode) — S3 §1.4 p.5 | Pass |
| [S3-11] Required energy per pass, two passes = 6.97/2 = 3.485 MJ/m² — S3 §1.4 p.5 | Pass |
| [HAN-1] Required energy per blow W_t·H_d = (8.2/0.35)² (t·m) — HAN §3.5.5 p.98 | Pass |
| [HAN-2] Required drop height for the 18.2 t tamper = 550/18.2 (m) — HAN §3.5.5 p.98 | Pass |
| [HAN-3] Typical drop height H_d = (W_t·H_d)^0.54 (m) "also 30.2 m" — HAN Eq. 3.17 p.93 / §3.5.5 p.98 | Pass |
| [HAN-4] Total applied energy 850 kJ/m³ × 8.2 m (MJ/m²) — HAN §3.5.5 p.98 | Pass |
| [HAN-5] Ironing energy AE_IP = 300 kJ/m³ × 1.5 m (MJ/m²) — HAN Eq. 3.22, §3.5.5 p.98 | Pass |
| [HAN-6] High-energy total AE_HEP·N_p = 6.97 − 0.45 (MJ/m²) — HAN §3.5.5 p.98 | Pass |
| [HAN-7] Per-pass energy for two passes (MJ/m²) — HAN §3.5.5 p.98 | Pass |
| [HAN-8] Drops per point N_d = 3260·9/(18.2·30.2·10) (Han writes g = 10 m/s²) — HAN Eq. 3.20, §3.5.5 p.98 | Pass |
| [HAN-9] Drops selected = round-up of the requirement (integer), at the engine's default g = 9.81 — HAN §3.5.5 p.98 | Pass |
| [HAN-10] Rough crater depth d_cd = 0.075·√550 (m) — HAN Eq. 3.18 / §3.5.5 p.98 | Pass |
| [HAN-11] Allowable crater depth = tamper height + 0.3 = 1.5 + 0.3 (m) — HAN §3.5.5 p.98 | Pass |
| [HAN-12] Area ratio of improvement π(1.5/2)²/3.0² ("= 0.20") — HAN §3.5.5 p.99 | Pass |
| [HAN-13] Induced settlement, 2 passes: 2 × 0.20 × 1.75 (m) — HAN §3.5.5 p.99 | Pass |
| [HAN-14] Detailed (Rollins–Kim) crater for the same 6 drops, p = 18.2/(π·0.75²) (m) — HAN Eq. 3.19 via S3 §1.6 | Pass |
| [G1-1] Energy per blow for D = 8.2 m, n = 0.35: (8.2/0.35)²·g (MJ) — G1 Ch.7 p.62 (Indiana) | Pass |
| [G1-2] Energy per blow for the 18.2 Mg tamper dropped 29.9 m (MJ) — G1 Ch.7 p.62 (Indiana) | Pass |
| [G1-3] Depth of improvement of 18.2 Mg × 29.9 m at n = 0.35 (m) — design target "8.2 m" — G1 Ch.7 p.62 (Indiana) | Pass |
| [G1-4] Total applied energy 735 kJ/m³ × 8.5 m (MJ/m²) — G1 Ch.7 p.62 (Indiana) | Pass |
| [G1-5] Energy per blow for D = 7.6 m, n = 0.4: (7.6/0.4)²·g (MJ) — G1 Ch.7 p.65 (Florida) | Pass |
| [G1-6] Required drop height for the 15 Mg tamper (m) — G1 Ch.7 p.65 (Florida) | Pass |
| [G1-7] Average applied energy 300 kJ/m³ × 7.6 m (MJ/m²) — G1 Ch.7 p.65 (Florida) | Pass |
| [G1-8] Energy of an 8-blow pass on the 9.1 m grid (kJ/m²) — G1 Table 13 p.67 (Florida) | Pass |
| [G1-9] Energy of a 9-blow pass on the 9.1 m grid (kJ/m²) — G1 Table 13 p.67 (Florida) | Pass |
| [G1-10] Energy of a 10-blow pass on the 9.1 m grid (kJ/m²) — G1 Table 13 p.67 (Florida) | Pass |
| [RD-V Becancour 10 ft] Theoretical impact velocity √(2gH), H = 10 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Becancour 10 ft] Measured/theoretical velocity ratio, v = 23.2 ft/s — RD Table 5 p.49 | Pass |
| [RD-V Becancour 20 ft] Theoretical impact velocity √(2gH), H = 20 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Becancour 20 ft] Measured/theoretical velocity ratio, v = 31.5 ft/s — RD Table 5 p.49 | Pass |
| [RD-V Becancour 58 ft] Theoretical impact velocity √(2gH), H = 58 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Becancour 58 ft] Measured/theoretical velocity ratio, v = 55 ft/s — RD Table 5 p.49 | Pass |
| [RD-V Tulsa 18 ft] Theoretical impact velocity √(2gH), H = 18 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Tulsa 18 ft] Measured/theoretical velocity ratio, v = 30.5 ft/s — RD Table 5 p.49 | Pass |
| [RD-V Tulsa 38 ft] Theoretical impact velocity √(2gH), H = 38 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Tulsa 38 ft] Measured/theoretical velocity ratio, v = 43 ft/s — RD Table 5 p.49 | Pass |
| [RD-V Tulsa 73 ft] Theoretical impact velocity √(2gH), H = 73 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Tulsa 73 ft] Measured/theoretical velocity ratio, v = 60 ft/s — RD Table 5 p.49 | Pass |
| [RD-V Great Lakes 18 ft] Theoretical impact velocity √(2gH), H = 18 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Great Lakes 18 ft] Measured/theoretical velocity ratio, v = 31.1 ft/s — RD Table 5 p.49 | Pass |
| [RD-V Great Lakes 33 ft] Theoretical impact velocity √(2gH), H = 33 ft (ft/s) — RD Table 5 p.49 | Pass |
| [RD-R Great Lakes 33 ft] Measured/theoretical velocity ratio, v = 42.5 ft/s — RD Table 5 p.49 | Pass |
| [RD-R StMarys radar] Free-fall (radar) measured/theoretical ratio, 77.4 ft/s at 98 ft — RD Table 5 p.49 | Pass |
| [RD-E1] Energy delivered at 90 % of theoretical speed, fraction of W·H ("approximately 80 percent") — RD p.50 | Pass |
| [RD-E2] Energy delivered at 97 % of theoretical speed, free fall ("94 percent") — RD p.50 | Pass |
| LEDGER: at least 20 computed-value cases from four independent published sources | Pass |
| [lookup T7-granular-high] engine table equals G1 Table 7 | Pass |
| [lookup T7-granular-low] engine table equals G1 Table 7 | Pass |
| [lookup T7-silt-high] engine table equals G1 Table 7 | Pass |
| [lookup T7-silt-low] engine table equals G1 Table 7 | Pass |
| [lookup T7-clay-high] engine table equals G1 Table 7 ("Not recommended") | Pass |
| [lookup T7-clay-low] engine table equals G1 Table 7 | Pass |
| [lookup T8-pervious] engine table equals G1 Table 8 | Pass |
| [lookup T8-semipervious] engine table equals G1 Table 8 | Pass |
| [lookup T8-landfill] engine table equals G1 Table 8 | Pass |
| [lookup T8-proctor] engine table equals G1 Table 8 note | Pass |
| [lookup T2-pervious] engine table equals G1 Table 2 | Pass |
| [lookup T2-sandy-silt] engine table equals G1 Table 2 | Pass |
| [lookup T2-silt] engine table equals G1 Table 2 | Pass |
| [lookup T2-clay-fill] engine table equals G1 Table 2 | Pass |
| [lookup T2-landfill] engine table equals G1 Table 2 | Pass |
| [lookup T3.13-commercial] engine table equals HAN Table 3.13 | Pass |
| [lookup T3.13-residential] engine table equals HAN Table 3.13 | Pass |
| [lookup T3.13-sensitive] engine table equals HAN Table 3.13 | Pass |
| PPV helper reproduces S3 Eq. 7 and its inverse (safe distance) closes exactly | Pass |
| Han Eq. 3.17 typical drop height equals the energy-per-blow route for the S3 energy (≈ 30.2 m) | Pass |
| SUPPLEMENTARY — Florida Table 13 energies close to ≤ 0.5 % if the printed "9.1 m" grid is the 30 ft (9.144 m) it was likely converted from | Pass |
| DEVIATION D-1 — Indiana landfill phase energy: published 3.12 MJ/m² per phase vs 3.03 recomputed (−3.0 %) | Pass |
| DEVIATION D-2 — Han §3.5.5 "13 % × 8.2 m = 1.10 m": the source arithmetic does not close (0.13 × 8.2 = 1.066 m) | Pass |
| DEVIATION D-3 — Florida Table 13 induced settlement rows sum to 568 mm; the printed total is 694 mm | Pass |
| DEVIATION D-4 — Han Table 3.11 (p.96) has no "sandy silts" row (it repeats "Sands and gravels" 40–50); GEC-1 Table 2 (primary) has sandy silts at SPT 34–45 | Pass |
effective-stress-site-response-web-validation.test.ts
Validation for the 1-D COUPLED EFFECTIVE-STRESS (liquefaction-capable) site-response column (`effective-stress-site-response.ts`) — the DEEPSOIL "effective stress" / OpenSees 1-D deliverable.
Analyses validated: effective-stress · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the 1-D COUPLED EFFECTIVE-STRESS (liquefaction-capable) site-response column
(`effective-stress-site-response.ts`) — the DEEPSOIL "effective stress" / OpenSees 1-D
deliverable. The decisive anchors are the two signatures a total-stress analysis CANNOT
produce, both observed in the field and in centrifuge tests:
· POST-LIQUEFACTION DE-AMPLIFICATION — a liquefied layer cannot transmit shear, so the
late-window surface motion collapses ("natural base isolation": Port Island 1995,
Wildlife 1987). Measured here: late-window surface RMS falls to ~10 % of the
total-stress value and surface PGA drops ~40 %.
· PERIOD LENGTHENING — the softened profile's travel-time period grows (here ~2.1×).
A TOTAL-STRESS CONTROL run (`generate_pore_pressure: false`) is the regression anchor: it must
produce r_u = 0, δ_G = 1 and a period ratio of exactly 1, proving the pore-pressure coupling is
the ONLY difference between the two analyses.
NOTE ON THE INPUT MOTION (a real finding): a single Ricker pulse peaks long before cyclic pore
pressure can build, so it cannot show de-amplification. The signature requires SUSTAINED
multi-cycle shaking — the anchors below therefore drive the column with a tapered 2 Hz train.
Refs (on disk): DEEPSOIL v7 User Manual §4.3; Matasovic (1992); Matasovic & Vucetic (1993,
1995); Carlton (2014); Kramer "Geotechnical Earthquake Engineering" §7, §9; Idriss & Boulanger
"Soil Liquefaction During Earthquakes"; Zienkiewicz et al. "Computational Geomechanics" Ch. 9.
| Test block (the published value it checks) | Verdict |
| [1-4] TOTAL-STRESS CONTROL: with generation off there is no pore pressure, no degradation, no period change | Pass |
| [5-7] EFFECTIVE STRESS: pore pressure builds, layers liquefy, and it is time-stamped | Pass |
| [8-9] SIGNATURE 1 — post-liquefaction DE-AMPLIFICATION of the surface motion | Pass |
| [10-11] SIGNATURE 2 — period lengthening of the softened profile | Pass |
| [12-13] DRY sand above the water table cannot liquefy | Pass |
| [14-15] effective overburden is buoyant below the water table and increases with depth | Pass |
| [16] a LOOSER sand (lower V_s) generates more pore pressure than a denser one | Pass |
| [17] a STRONGER motion generates more pore pressure | Pass |
| [18] Terzaghi dissipation (C_v > 0) leaves LESS residual pore pressure than the undrained limit | Pass |
| [19-21] outputs are physical and internally consistent | Pass |
| [22-23] the solve converges and returns no NaN/Infinity | Pass |
| [24] the elastic period is 4H/V_s and δ_G tracks r_u through √(1 − r_u) | Pass |
⚑ fe-liquefaction-2d-web-validation.test.ts
EXTERNAL-VALUE VALIDATION — phenomenological `fe-liquefaction-2d` path.
Analyses validated: fe-liquefaction-2d · Recorded run: passed — 2 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
EXTERNAL-VALUE VALIDATION — phenomenological `fe-liquefaction-2d` path.
Benchmark: VELACS Model No. 1 (Taboada, 1995), with the recorded input motion
and four excess-pore-pressure traces reproduced in Taiebat & Pak (2004), WCEE
Paper 2239, Figs. 7–9. `case-velacs-model1.ts` retains the source, digitisation
method, and the four independently readable end-of-record values. This suite
intentionally exercises the default phenomenological path, not PM4Sand.
The comparison is not a manufactured pass: it preserves the model's measured
shallow agreement and its known deep over-triggering. That makes an external
value regression visible while keeping the published evidence and limitation
together in the dedicated validation gate.
STATUS (audited 2026-10-07) — BLOCKED for release; the engine DISAGREES with the published record at depth.
What is and is not engine evidence here:
· The "20 anchors" test checks that the digitised FIXTURE (`case-velacs-model1.ts`) still holds its stored
numbers. It compares no engine output to anything, so it is NOT counted as published-value validation.
· The engine comparison is 4 end-of-record (20 s) excess-pore-pressure values from one source (Taiebat & Pak
(2004) reproducing Taboada (1995)): 2 agree (1.25 m within 10 %, 2.5 m within 20 %) and 2 are PINNED AS
WRONG (5 m > 50 %, 7.5 m > 100 % error — the default path reaches ru ≈ 1 where the experiment did not).
· Shortfall against the ≥20-published-values / ≥2-sources bar: 4 engine-vs-source values (2 matching), 1
source. A second independent published liquefaction FE benchmark with tabulated numeric answers was
not found in the local library; the deep over-triggering is a constitutive limitation of the
phenomenological path (the PM4Sand path is the proper one) and was not fixed here.
| Test block (the published value it checks) | Verdict |
| VELACS Model 1: all 20 fixed pore-pressure anchors remain traceable to the published record | Pass |
| VELACS Model 1: phenomenological pore-pressure comparison is source-traced and honest | Pass |
fe-site-response-2d-web-validation.test.ts
WEB-BENCHMARK validation for the 2-D FE site-response (SH-wave basin) engine.
Analyses validated: fe-site-response-2d · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the 2-D FE site-response (SH-wave basin) engine.
STATUS (audited 2026-10-07) — PARTIAL, formula-fidelity for all but one value. The header below used to
claim "≥20 web-sourced cases"; the suite has 7 tests (9 assertions), of which the T0 = 4H/Vs cases, the Kramer spectral
upper bound and the trend checks are closed-form or inequality checks, and the basin check is an
acceptance BAND [1.05, 4] on 2-D/1-D, not a published point value. The published PRINTED answer actually
reproduced is Kramer (1996) Example 7.1: a 10 ft layer with v_s = 1050 ft/s on rigid rock has
f0 = v_s/4H = 26.25 Hz (added below). Shortfall against the ≥20-published-values / ≥2-sources bar:
1 printed value, 1 source (plus bands from Bard & Bouchon 1985 and Riga et al. 2018 that are ranges, not
values). Kramer's other ch. 7 examples (7.2-7.4) print only time-history peaks of the Gilroy No. 1 record,
which this engine cannot be driven with; SHAKE91 example outputs are likewise 1-D equivalent-linear
time-history results. No published SH-wave basin case with tabulated numeric answers was found in the
local library.
≥20 web-sourced cases (the release rules mandatory step) — see status above: NOT met.
Measurement-type note: our peak_amplification is a TIME-DOMAIN peak ratio; the
closed-form 1-D transfer-function peak A = 1/(α+π/2·ξ) is a FREQUENCY-DOMAIN spectral
peak and is an UPPER BOUND on the time-domain ratio (a transient never puts all its
energy at resonance). Sources: Kramer (1996) GEE Ch.7; SimCenter TFT theory
(T0=4H/Vs); Bard & Bouchon (1985) BSSA 75(2) basin resonance; EuroSeisTest / Volvi
(Chávez-García, Makra, Raptakis) 2D aggravation 2–3; Riga et al. (2018) SDEE deep-basin
aggravation 1.5–2.5; geometrical focusing (Bull. Earthq. Eng. 2014) up to ~3×.
| Test block (the published value it checks) | Verdict |
| 2D-SR web C1–C4: T0 = 4H/Vs (exact) | Pass |
| 2D-SR web: flat profile gives 2D/1D = 1.00 (validates vs 1-D baseline) | Pass |
| 2D-SR web C5–C8: time-domain peak < Kramer spectral peak 1/(α+π/2·ξ) [upper bound] | Pass |
| 2D-SR web C12–C19: basin 2D/1D focusing lands in the published band [1.15, 4] | Pass |
| 2D-SR web: higher impedance contrast ⇒ higher 1-D amplification | Pass |
| 2D-SR web: more damping ⇒ lower amplification | Pass |
| 2D-SR web C10/C11: surface amplification stays physically bounded (< 12) | Pass |
| 2D-SR published: Kramer Example 7.1 — f0 = 26.25 Hz for H = 10 ft, Vs = 1050 ft/s | Pass |
⚑ lateral-spread-christchurch-web-validation.test.ts
WEB-VALIDATION for `lateral-spread` against a PUBLISHED CASE HISTORY and an INDEPENDENT REFERENCE IMPLEMENTATION of the same model.
Analyses validated: lateral-spread · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-VALIDATION for `lateral-spread` against a PUBLISHED CASE HISTORY and an INDEPENDENT
REFERENCE IMPLEMENTATION of the same model.
WHY A SECOND SUITE. `lateral-spread-web-validation.test.ts` is careful, correct and cites four
sources, and it has one structural weakness that it states itself in its last header line:
"every expected value below evaluates the published equation independently in the test". That is
formula fidelity. It proves our code implements the equation we wrote down; it cannot prove we
wrote the equation down correctly, because the test and the engine would share the same
misreading. The primary paper is paywalled, so the way out is not a better reading of it — it is
two sources that are NOT us and NOT each other:
(A) A CASE HISTORY with every input published and a displacement published alongside it.
(B) An INDEPENDENT IMPLEMENTATION of the same equation by a third party.
── (A) THE CASE HISTORY ─────────────────────────────────────────────────────────────────────
Robinson, K., Cubrinovski, M. & Bradley, B.A. (2013) "Sensitivity of predicted
liquefaction-induced lateral spreading displacements from the 2010 Darfield and 2011
Christchurch earthquakes", Proc. 19th NZGS Geotechnical Symposium, Queenstown (open access,
nzgs.org). Avon Loop, central Christchurch; transect T6, "location A".
The paper states in prose: "The field measurement of lateral displacement at this location was
~0.9 m, with a model prediction of ~3.2 m (using R_eq, i.e. back-calculated from recorded PGA)."
R values are given in §4.1: R = 16.9 km and 4 km for the September 2010 (Mw 7.1) and February
2011 (Mw 6.2) events, with R_eq = 15.5 km and 1 km respectively. The displacement is CUMULATIVE
over both events, which is also stated ("The predicted spreading displacements from the two
seismic events were summed").
The site parameters are in Figure 5(a), not the prose, so they were read off the figure rendered
at 160 dpi — W = 13% (varied to 20%), T₁₅ 1.5↔3.5 m (so 2.5 m base, consistent with the stated
"±1 m"), F₁₅ = 14% with D₅₀₍₁₅₎ = 0.19 mm (and the coupled low-displacement end F₁₅ = 35% /
D₅₀ = 0.13 mm). A FIGURE READ IS A WEAKER SOURCE THAN PROSE and the standard applied here is
that it must be corroborated, not trusted: this input set reproduces the prose's ~3.2 m, AND
every endpoint of every bar in Figure 5(a) independently — which is four more checks on the
same reading than a single value would give. Measured:
base (R_eq: 15.5 & 1 km) engine 3.267 m paper "~3.2 m" (prose) +2.1%
W → 20% engine 4.216 m Fig 5(a) right end ≈ 4.2
T₁₅ → 1.5 m engine 2.479 m Fig 5(a) left end ≈ 2.45
T₁₅ → 3.5 m engine 3.918 m Fig 5(a) right end ≈ 3.9
F₁₅ → 35% & D₅₀ → 0.13 mm engine 1.511 m lower than base — the paper's stated direction
R = R (16.9 & 4 km) engine 1.460 m "a much closer prediction to the observed"
The last two are the ones worth having. The F₁₅/D₅₀ case is COUNTER-INTUITIVE and the paper
spells out why: raising F₁₅ lowers the prediction while lowering D₅₀ raises it, "the higher F₁₅
value dominates ... and yields a lower prediction". An engine with either coefficient's sign
flipped passes a monotonicity test and fails this one. And the R-vs-R_eq case reproduces the
paper's actual engineering conclusion, not just an arithmetic result.
── (B) THE INDEPENDENT IMPLEMENTATION ───────────────────────────────────────────────────────
OpenQuake Engine, `openquake.hazardlib.gsim.youd_etal_2002.YoudEtAl2002` (GEM Foundation, AGPL,
docs.openquake.org). A separate team's coded form of the same 2002 paper, with its own published
coefficient tables. It agrees with us on every coefficient, and on the two things that are easy
to get wrong and invisible if you get them wrong:
· THE DEPENDENT VARIABLE HAS NO OFFSET. OpenQuake computes `mean = log(10.0 ** Σ)` — i.e.
D_H = 10^Σ. Our engine used to compute 10^Σ − 0.01, carrying the offset from the 1990s
Bartlett & Youd formulation across to the 2002 coefficients; audit E-90 removed it on
reasoning alone, biasing every prediction low by exactly 0.01 m (−33% at 0.03 m) in the
unconservative direction. This suite is the first EXTERNAL confirmation that the removal
was right, rather than a second opinion from the same reasoning.
· THE FREE-FACE INTERCEPT IS FOLDED, NOT ADDED. OpenQuake carries two whole tables,
c0 = −16.213 (slope) and c0 = −16.713 (free face), where our engine and the primary paper
express the second as the first plus b_off = −0.500. Those must be the same number, and if
b_off were ever applied twice or to the wrong branch, only a cross-check like this notices.
Robinson et al. (2013) Eq. (1) independently restates the free-face form with the same folded
−16.713 intercept and the same R* = R + 10^(0.89·Mw − 5.64), so (A) and (B) corroborate each
other on the functional form as well as agreeing with us.
── SOURCES ──────────────────────────────────────────────────────────────────────────────────
· Robinson, K., Cubrinovski, M. & Bradley, B.A. (2013), Proc. 19th NZGS Geotechnical
Symposium — case history, Eq. (1), Figure 5(a), §4.1 R values.
· OpenQuake Engine v3.26 `gsim/youd_etal_2002.py`, COEFFS_SLOPE and COEFFS_FREEFACE
(GEM Foundation) — independent implementation.
· Youd, T.L., Hansen, C.M. & Bartlett, S.F. (2002), JGGE 128(12), 1007–1017 — the primary
(paywalled; reached only through the two above).
NOT ASSERTED, deliberately: Figure 5(b)'s ±10% sensitivity ordering. Our engine reproduces the
W > T₁₅ > D₅₀ part of it (5.8% / 5.3% / 4.9%), but the published F₁₅ bar is ≈10% where a 10%
relative change in F₁₅ gives 5.4%, so the paper is perturbing F₁₅ in some other unit and
guessing which would be inventing a benchmark rather than citing one.
| Test block (the published value it checks) | Verdict |
| Christchurch location A: cumulative prediction ≈ 3.2 m (Robinson et al. 2013 §5) | Pass |
| Christchurch location A: the two events decompose as the paper describes | Pass |
| Christchurch location A: over-predicts the 0.9 m field survey by more than 2× (paper abstract) | Pass |
| Christchurch location A: W → 20% reproduces Figure 5(a) ≈ 4.2 m | Pass |
| Christchurch location A: T₁₅ 1.5 / 3.5 m reproduce both ends of the Figure 5(a) bar | Pass |
| Christchurch location A: coupled F₁₅ 35% / D₅₀ 0.13 mm LOWERS the prediction (fines dominate) | Pass |
| Christchurch location A: R = R is closer to the observation than R = R_eq (paper §5) | Pass |
| OpenQuake cross-check: free-face branch agrees to 1e-9 over a spread of cases | Pass |
| OpenQuake cross-check: sloping-ground branch agrees to 1e-9 | Pass |
| OpenQuake cross-check: the free-face intercept is exactly the slope intercept − 0.500 | Pass |
| OpenQuake cross-check: the dependent variable is 10^Σ with NO offset (audit E-90) | Pass |
| OpenQuake cross-check: R* = R + 10^(0.89·Mw − 5.64) and σ_logD = 0.197 | Pass |
lateral-spread-web-validation.test.ts
Web-benchmark validation for `lateral-spread` — the Youd, Hansen & Bartlett (2002) revised multilinear regression for liquefaction-induced lateral spread displacement.
Analyses validated: lateral-spread · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `lateral-spread` — the Youd, Hansen & Bartlett (2002)
revised multilinear regression for liquefaction-induced lateral spread displacement.
SOURCES
Youd, T.L., Hansen, C.M. & Bartlett, S.F. (2002) "Revised multilinear regression
equations for prediction of lateral spread displacement", J. Geotech. Geoenviron.
Eng. 128(12), 1007-1017. [the primary; paywalled]
Gillins, D.T. & Bartlett, S.F. (2014) "Multilinear Regression Equations for
Predicting Lateral Spread Displacement from Soil Type and Cone Penetration Test
Data", JGE 140(4) — accepted manuscript, Oregon State University institutional
repository (open access). Its Eq. (1) and (2) RESTATE the YHB model verbatim and
list YHB's partial regression coefficients; Bartlett co-authored both papers, so
this is a first-party restatement rather than a secondary summary.
USGS (2007) "Lateral spread hazard mapping of the northern Salt Lake Valley, Utah,
for a M7.0 scenario earthquake" — displacement hazard bands 0-0.1 / 0.1-0.3 /
0.3-1.0 / >1.0 m, which are the band edges this engine reports.
PUBLISHED FORM — Gillins & Bartlett (2014) Eq. (1)-(2):
Log DH = bo + boff·α + b1·M + b2·Log R* + b3·R + b4·Log W + b5·Log S
+ b6·Log T15 + b7·Log(100 − F15) + b8·Log(D50_15 + 0.1 mm)
R* = R + 10^(0.89·M − 5.64)
bo = −16.213 · boff = −0.500 · b1 = 1.532 · b2 = −1.406 · b3 = −0.012
b4 = 0.592 · b5 = 0.338 · b6 = 0.540 · b7 = 3.413 · b8 = −0.795
σ_logDH = 0.1970
"For sloping-ground conditions, α is set to zero, W is set to 1, and site-specific
estimates of S (%) are entered. For free-face conditions, α and S are set to 1, and
site-specific values of W (%) are entered."
AUDIT NOTE (E-90). The engine previously computed 10^(Σ) − 0.01, describing the sum as
log(D + 0.01). The published dependent variable is Log DH with NO offset — the +0.01
belongs to the earlier Bartlett & Youd formulation, which needed a defined logarithm for
zero-displacement case histories. The 2002 coefficients were bolted to the 1990s
dependent variable, biasing every prediction low by exactly 0.01 m: −33 % at DH = 0.03 m,
−20 % at 0.05, −10 % at 0.10, and always in the unconservative direction. It also pushed
band-edge cases down a band (0.10 m → 0.090 m read as "none" instead of "minor").
Every expected value below evaluates the published equation independently in the test.
| Test block (the published value it checks) | Verdict |
| gentle-ground displacement matches YHB (2002) Eq. 1 (α = 0, W = 1) | Pass |
| free-face displacement matches YHB (2002) Eq. 1 (α = 1, S = 1) | Pass |
| R* follows Eq. 2 and boff is exactly the two-intercept difference | Pass |
| the confidence band uses the published σ_logDH = 0.1970 | Pass |
| E-90: the dependent variable is log DH, with no 0.01 m offset | Pass |
| damage bands break at the published 0.1 / 0.3 / 1.0 / 3.0 m edges | Pass |
| out-of-range inputs warn per YHB Table 6 rather than failing silently | Pass |
liquefaction-effective-stress-web-validation.test.ts
Validation for the COUPLED EFFECTIVE-STRESS liquefaction kernel (`liquefaction-effective-stress.ts`) — cyclic excess-pore-pressure generation and the stiffness/strength degradation it causes, i.e.
Analyses validated: liquefaction · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the COUPLED EFFECTIVE-STRESS liquefaction kernel
(`liquefaction-effective-stress.ts`) — cyclic excess-pore-pressure generation and the
stiffness/strength degradation it causes, i.e. the piece that turns our total-stress Masing
site-response column into an effective-stress (liquefaction-capable) analysis.
Every anchor is an EXACT published formula or a required physical trend, each cited:
[1-4] Carlton (2014) F = 3810·V_s^−1.55 (DEEPSOIL v7 Eq 4.11)
[5-8] Carlton (2014) s = (FC+1)^0.1252 (DEEPSOIL v7 Eq 4.12)
[9-11] Matasovic (1993) δ_G = √(1 − r_u) (DEEPSOIL v7 Eq 4.30)
[12-14] Matasovic (1993) δ_τ = 1 − r_u^v (DEEPSOIL v7 Eq 4.31)
[15-18] Dobry/Matasovic generation law behaviour (DEEPSOIL v7 Eq 4.10):
threshold γ_tvp, saturation at p, monotone in N_c and in γ_c
[19-21] the analytic inverse (cycles to a target r_u) round-trips the forward law EXACTLY
[22-23] required physical trends: a looser sand (lower V_s) liquefies in fewer cycles;
fines raise the strain exponent
[24-26] Terzaghi 1-D dissipation (DEEPSOIL v7 Eq 4.33): drains, stays bounded, free-draining
surface, unconditionally stable at any C_v·dt/dz²
[27-28] reversal bookkeeping (N_eq += ½ per reversal, r_u monotone under undrained loading)
SCOPE (honest): a LEVEL-GROUND 1-D constitutive kernel. NOT a 2-D/3-D coupled dynamic
effective-stress continuum — there is no flow-failure / lateral-spreading mechanism in a mesh
here, and that remains a documented specialist seat.
Refs (on disk): DEEPSOIL v7 User Manual §4.3; Matasovic (1992); Matasovic & Vucetic (1993,
1995); Carlton (2014); Kramer "Geotechnical Earthquake Engineering"; Idriss & Boulanger
"Soil Liquefaction During Earthquakes".
| Test block (the published value it checks) | Verdict |
| [1-4] Carlton (2014): F = 3810·V_s^−1.55 exactly (DEEPSOIL Eq 4.11) | Pass |
| [5-8] Carlton (2014): s = (FC+1)^0.1252 exactly (DEEPSOIL Eq 4.12) | Pass |
| [9-11] Matasovic (1993): δ_G = √(1 − r_u) exactly (DEEPSOIL Eq 4.30) | Pass |
| [12-14] Matasovic (1993): δ_τ = 1 − r_u^v exactly (DEEPSOIL Eq 4.31) | Pass |
| [15] Dobry/Matasovic: strains at or below γ_tvp generate NO pore pressure (Eq 4.10) | Pass |
| [16] Dobry/Matasovic: r_u SATURATES at the limiting ratio p as N_c → ∞ | Pass |
| [17-18] Dobry/Matasovic: r_u increases monotonically with N_c and with strain amplitude | Pass |
| [19-21] the analytic inverse round-trips the forward generation law EXACTLY | Pass |
| [22] required trend: a LOOSER sand (lower V_s) liquefies in FEWER cycles | Pass |
| [23] required trend: fines content raises the strain exponent s | Pass |
| [24-26] Terzaghi 1-D dissipation drains, stays bounded, and is stable at any C_v·dt/dz² (Eq 4.33) | Pass |
| [27-28] reversal bookkeeping: N_eq += ½ per reversal and r_u is monotone under undrained loading | Pass |
| cyclicLiquefaction reports a consistent history (r_u monotone, flags agree) | Pass |
liquefaction-monitoring-web-validation.test.ts
Web-benchmark validation for TWELVE liquefaction-triggering, in-situ-correlation, seismic-code and monitoring runner engines.
Analyses validated: cpt-liquefaction, design-code-spectrum, dmt, driven-pile-dynamics, embankment-stability, expansive-heave, liquefaction, multilayer-consolidation, pile-group-settlement, probabilistic-slope, spt-correlations, stabilization-mix, vs-liquefaction · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for TWELVE liquefaction-triggering, in-situ-correlation, seismic-code
and monitoring runner engines. Family suite — `runner-coverage.mjs` counts ENGINES.
ENGINES AND SOURCES
expansive-heave — IS 9214:1979 swell magnitude
probabilistic-slope — FOSM reliability index; Duncan (2000) JGGE 126(4)
multilayer-consolidation — Terzaghi 1-D, layered C_c/C_r/OCR; IS 8009-1
design-code-spectrum — ASCE/SEI 7-16 §11.4, Tables 11.4-1/11.4-2; IS 1893; EN 1998-1
pile-group-settlement — Poulos & Davis (1980); Randolph & Wroth (1979) Géot. 29(4)
stabilization-mix — IRC SP:89-2018 CTB/CTSB 7-day UCS bands
vs-liquefaction — Andrus & Stokoe (2000) JGGE; Youd et al. (2001) NCEER
cpt-liquefaction — Boulanger & Idriss (2014) UCD/CGM-14/01
dmt — Marchetti (1980); TC16 (2001)
driven-pile-dynamics — Hiley formula
embankment-stability — undrained bearing N_c·c_u; Ladd (1991) SHANSEP
spt-correlations — IS 6403 Fig 1; Stroud (1974); Bowles Tables 3.4/5.6
Every expected value is reconstructed from the published expression in code — including the
FULL Andrus-Stokoe and Boulanger-Idriss CRR chains, which are the two most consequential
correlations in the whole product.
Overrides go through the VALIDATING `run()` in `_registry-harness.ts`: an unknown field or an
invalid select value fails loudly. Every select option used below was read from the registry
first — the four times I guessed one instead, the engine silently computed something else.
| Test block (the published value it checks) | Verdict |
| expansive-heave reproduces the IS 9214 swell magnitude | Pass |
| probabilistic-slope computes β = (μ_FoS − 1)/σ_FoS and P_f = Φ(−β) | Pass |
| multilayer-consolidation sums the layered Terzaghi settlements | Pass |
| design-code-spectrum reproduces ASCE 7-16 and switches code correctly | Pass |
| pile-group-settlement uses the Randolph-Wroth influence radius | Pass |
| stabilization-mix applies the IRC SP:89 CTB and CTSB UCS bands | Pass |
| vs-liquefaction reproduces the full Andrus & Stokoe (2000) CRR chain | Pass |
| cpt-liquefaction reproduces the Boulanger & Idriss (2014) CRR chain | Pass |
| dmt reproduces the Marchetti (1980) index chain | Pass |
| driven-pile-dynamics reproduces the Hiley formula | Pass |
| embankment-stability uses the undrained N_c·c_u bearing limit | Pass |
| spt-correlations maps N to unit weight and equivalent q_c by soil type | Pass |
liquefaction-settlement-web-validation.test.ts
Web-benchmark validation for `liquefaction-settlement` — post-liquefaction reconsolidation settlement by the Ishihara-Yoshimine route.
Analyses validated: liquefaction-settlement · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `liquefaction-settlement` — post-liquefaction
reconsolidation settlement by the Ishihara-Yoshimine route.
SOURCE (on disk, `Geo Technical engineering books/`):
Idriss, I.M. & Boulanger, R.W. (2008) "Soil Liquefaction during Earthquakes",
EERI Monograph MNO-12. Equations 86-96, pp. 140-142 and the worked spreadsheet
appendix. Corroborated by the Rocscience Settle3 Liquefaction Theory Manual
§10.1.1 (also on disk), which states the same relation as its Eq. 93.
The engine implements the closed form, so every expected value below is the published
equation evaluated independently in the test — not a number this engine produced.
Eq 86 γlim = 1.859·(1.1 − √((N1)₆₀cs/46))³ ≥ 0
Eq 87 γlim = 1.859·(1.1 − Dr)³ ≥ 0 [same, in terms of Dr]
Eq 89 Fα = 0.032 + 4.7·Dr − 6.0·Dr² [Dr limited to ≥ 0.4]
Eq 90 γmax = 0 if FoS ≥ 2
Eq 91 γmax = min{γlim, 0.035(2−FoS)(1−Fα)/(FoS−Fα)} if 2 > FoS > Fα
Eq 92 γmax = γlim if FoS ≤ Fα
Eq 95 εv = 1.5·exp(−2.5·Dr)·min(0.08, γmax)
Eq 96 εv = 1.5·exp(−0.369·√((N1)₆₀cs))·min(0.08, γmax) [what is coded]
TOKIMATSU & SEED — see `tokimatsu-seed-1984-fig6.test.ts` for the primary validation
(D9, 2026-10-16): the report's Fig 6 is digitised and Table 5 sites P-6 (15.5 in) and P-1
(0.7 in) plus all 13 published layer strains are reproduced. Source:
Tokimatsu, K. & Seed, H.B. (1984) "Simplified Procedures for the Evaluation of Settlements
in Clean Sands", UCB/EERC-84/16 / NSF PB85-197887 (public domain, on disk). (The citation is
kept on one line: the manifest's citation pattern does not read across a ` * ` wrap, and the
2026-10-16 rewording had demoted this suite to one counted source.) The p.11 statements are kept
below as consistency checks on the chart, which the report constructs from them.
| Test block (the published value it checks) | Verdict |
| εv matches I&B (2008) Eq 96 across (N1)₆₀cs at FoS = 0.9 | Pass |
| the γmax branches of Eq 90-92 are selected as published | Pass |
| Eq 95 (Dr form) and Eq 96 (N form) agree to the published rounding | Pass |
| E-91: Dr is floored at 0.4 for Eq 89, as I&B require | Pass |
| Eq 86 γlim, and the 8 % ceiling that makes the LDI 50 % cap moot | Pass |
| settlement is εv × thickness and sums down the profile | Pass |
| E-99/D9: at (N1)60 = 20 the liquefied-zone strain sits in the 0.9-1.5 % band Fig 6 is drawn from | Pass |
| E-99/D9: the report's envelope — 2-3 % for loose-to-medium sand, higher for very loose | Pass |
| E-99: the T&S path still behaves monotonically and stays finite | Pass |
liquefaction-triggering-variants-web-validation.test.ts
G9 — liquefaction-triggering VARIANTS: Robertson & Wride (1998) / Youd et al.
Analyses validated: cpt-liquefaction, cpt-sbt-ic, liquefaction · Recorded run: passed — 32 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
G9 — liquefaction-triggering VARIANTS: Robertson & Wride (1998) / Youd et al. (2001), Robertson
(2009), Moss et al. (2006) for the CPT; Cetin et al. (2004) and Cetin et al. (2018) for the SPT.
PUBLISHED SOURCES (each opened and read; every EXPECTED value below is printed in one of them):
[C18] Cetin, Seed, Kayen, Moss, Bilge, Ilgac & Chowdhury (2018) "The use of the SPT-based seismic
soil liquefaction triggering evaluation methodology in engineering hazard assessments",
MethodsX 5:1556-1575, doi:10.1016/j.mex.2018.11.016 (CC-BY, PMC6287064). The fully worked
illustrative site: Table 3 (CN, CR, N1,60 and CSR for 19 depths) and Eqs 29-54.
[CGM10] Idriss & Boulanger (2010) UCD/CGM-10/02, §7.3 and App. A: the Cetin et al. (2004) MSF
"= 1.99 at M = 5.5 and 0.76 at M = 8.5", Kσ = (σ'v/Pa)^−0.278 limited to 1.5, and the Moss
et al. (2006) MSF exponent 0.118 and Kσ exponent 0.00028 extracted from their equations.
[MOSS] Moss et al. (2005) PEER 2005/15, Table 4.1 (the 188-case CPT database with per-case depth,
σv, σ'v, amax, rd, CSR, c, qc,1, Rf) and Fig 5.8 (Robertson & Wride Kc labels).
[BI14] Boulanger & Idriss (2014) UCD/CGM-14/01, Table 3.1 (CPT database: σvc, σ'vc, qcN, fsN and
the printed Robertson-Wride soil behaviour type index Ic computed with n = 0.5).
TOLERANCES are the printing precision of the source (stated per test), never widened to pass.
| Test block (the published value it checks) | Verdict |
| Φ and Φ⁻¹: MethodsX Eq 43 Φ(1.77) = 0.96 and Eq 51c Φ(1.30) = 0.90; inverse round-trips | Pass |
| [C18] Eq 29-30: rd(5.5 m, Mw 6.8, amax 0.28, Vs12 220) = 0.97, σεrd = 0.084 | Pass |
| [C18] Eq 32: mean CSR at the critical depth = 0.23 (σv 105.2, σ'v 80.7) | Pass |
| [C18] Eq 39: CRR(N1,60 11.4, FC 14, Mw 6.8, σ'v 80.7, PL 50 %) = 0.15 | Pass |
| [C18] Eq 43: PL = Φ(1.77) = 0.96 at CSR 0.23 | Pass |
| [C18] Eq 42: (N1)60cs = 11.4 + 14·(0.00167·11.4 + 0.089) = 12.9 | Pass |
| [C18] Eqs 45, 47: Kσ(80.7 kPa) = 1.08, KMw(6.8) = 1.26 | Pass |
| [C18] Eqs 49, 53, 54: CSR_ref = 0.17 and FS = CRR/CSR = 0.65 both ways | Pass |
| [C18] Eqs 51a-51c: σtot from σinput 7.01 = 4.03; PL with input uncertainty = Φ(1.30) = 0.90 | Pass |
| [C18] Table 2 corrections reproduce Table 3: CN (σ'v) and CR (rod = depth + 1.2 m) | Pass |
| [C18] engine run of the Table 3 profile (procedure cetin_2018): N1,60 and CSR at every saturated depth | Pass |
| [C18] engine at the critical-layer means reproduces FS 0.65 and PL 0.96 | Pass |
| [CGM10] Cetin 2004 MSF = (Mw/7.5)^−2.217: 1.99 at M 5.5, 0.76 at M 8.5 | Pass |
| [CGM10] Cetin 2004 Kσ = (σ'v/Pa)^−0.278, limited to 1.5 | Pass |
| [CGM10] Cetin 2004 CFINES, FC < 5 % → 0, and (N1)60 = 0 does not divide by zero | Pass |
| [CGM10] Cetin 2004 engine: FoS scales with Mw exactly by the published MSF | Pass |
| [MOSS] rd Eq 4.13 reproduces Table 4.1 rd (mid-depth of the critical layer) to its 2 dp | Pass |
| [CGM10] Moss 2006 embedded MSF = (Mw/7.5)^−0.118 and Kσ = (σ'v/Pa)^−0.00028 | Pass |
| [MOSS] PL and CRR are consistent inverses; deterministic default PL = 15 % (§5.3) | Pass |
| [MOSS] c (Eq 4.2) against the c column of Table 4.1 — chart-read values, median |Δc| ≤ 0.06 | Pass |
| [BI14] R&W Ic (n = 0.5 branch) reproduces the printed Ic of 13 Table 3.1 cases to ±0.015 | Pass |
| [MOSS Fig 5.8 / Youd 2001 Eq 19] Kc: 1.0 at Ic 1.64, 2.14 at 2.36, 3.31 at 2.60 | Pass |
| Youd 2001 Eq 11: the two CRR7.5 branches meet at (qc1N)cs = 50; MSF(7.5) = 1.0 within 0.5 % | Pass |
| Robertson 2009 Ic iteration is the already-validated cpt-sbt-ic implementation | Pass |
| cpt-liquefaction: default procedure is unchanged (B&I 2014) and ignores sleeve friction | Pass |
| cpt-liquefaction: R&W / Robertson 2009 / Moss require sleeve friction | Pass |
| cpt-liquefaction R&W: clay-like Ic > 2.6 is non-susceptible, not a FoS | Pass |
| cpt-liquefaction R&W: (qc1N)cs ≥ 160 → too dense to liquefy (Youd 2001 validity limit) | Pass |
| cpt-liquefaction R&W hand-chain: FoS = CRR7.5(Kc·qc1N)·MSF·Kσ / CSR with NCEER rd | Pass |
| cpt-liquefaction Robertson 2009: Kc = 1 in the 1.64 < Ic < 2.36, F < 0.5 % zone (R&C 2012) | Pass |
| liquefaction (SPT): default procedure unchanged; Cetin procedures report PL; edge cases | Pass |
| liquefaction (SPT): probability input validated; deterministic PL changes CRR monotonically | Pass |
liquefaction-web-validation.test.ts
Formula-fidelity validation against Boulanger & Idriss (2014) "CPT and SPT Based Liquefaction Triggering Procedures", Report No.
Analyses validated: liquefaction · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against Boulanger & Idriss (2014) "CPT and SPT
Based Liquefaction Triggering Procedures", Report No. UCD/CGM-14/01
(source PDF on disk: Boulanger-Idriss-2014-CGM-14-01-triggering.pdf,
verified via pdftotext to carry the EXACT equations below), plus Youd et
al. (2001) NCEER and IS 1893 Part 1:2016 (cited in the existing
liquefaction-bi2014.test.ts golden test this suite extends).
Every governing equation is verified against the report text directly:
Eq 2.15a-c: CN = min(1.7, (Pa/sv')^m), m = 0.784 - 0.0768.sqrt(N160cs)
Eq 2.16a-c: Ksigma = min(1.1, 1 - Csigma.ln(sv'/Pa)), Csigma = min(0.3, 1/(18.9-2.55.sqrt(N160cs)))
Eq 2.18-2.21: MSF = 1 + (MSFmax-1).(8.64.exp(-M/4)-1.325), MSFmax = min(1.8, 1.09+(N160cs/31.5)^2)
Eq 2.25: CRR_M7.5,sv=1atm = exp(N160cs/14.1 + (N160cs/126)^2 - (N160cs/23.6)^3 + (N160cs/25.4)^4 - 2.8)
These are all verified by independently re-deriving them from the reported
intermediate values (N160cs, sv', M) in Python and matching the engine's
own output to full precision -- proving the engine implements the EXACT
governing report's equations, not an approximation or a transcription
error, for every stage of the calculation chain.
| Test block (the published value it checks) | Verdict |
| [1] EXISTING GOLDEN CASE (B&I 2014 Ex 8.1-class, M7.5, 0.36g, loose silty sand): FoS in the hand-computed 0.25-0.40 band, status liquefiable | Pass |
| [2] CRR_M7.5,sv=1atm matches Eq. 2.25 exactly, re-derived from the engine's own reported N160cs | Pass |
| [3] Ksigma matches Eq. 2.16a-c exactly, re-derived from the engine's own reported N160cs and effective stress | Pass |
| [4] MSF matches Eq. 2.18-2.21 exactly, re-derived from the engine's own reported N160cs and the case magnitude | Pass |
| [5] the final CRR (case-specific) equals CRR_M7.5,sv=1atm . MSF . Ksigma exactly (Miller/Idriss chain of corrections) | Pass |
| [6] FoS = CRR/CSR exactly | Pass |
| [7] CN overburden correction never exceeds the published 1.7 cap (Eq. 2.15a), even at very low overburden stress | Pass |
| [8] looser sand (larger m-exponent per Eq. 2.15c) gives a larger CN at the same effective stress than denser sand | Pass |
| [9] saturated unit weight raises total stress below the water table by exactly the submerged increment | Pass |
| [10] a higher PGA increases CSR and hence lowers the factor of safety, all else equal | Pass |
| [11] invalid inputs (zero PGA, zero SPT-N, magnitude out of range) are refused | Pass |
liquefaction-worked-examples-web-validation.test.ts
liquefaction — FULL WORKED EXAMPLES (the ≥20-value gate), end-to-end through computeLiquefaction.
Analyses validated: liquefaction · Recorded run: passed — 70 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
liquefaction — FULL WORKED EXAMPLES (the ≥20-value gate), end-to-end through computeLiquefaction.
Every expected value is PRINTED in the cited source, read 2026-09-27 from `Geo Technical engineering
books/`.
[MNO12] Idriss & Boulanger (2008) EERI MNO-12, Appendix A single-boring spreadsheet (book pp.
238-239): (N1)60cs, CSR, Kσ and CRR_M7.5,σ=1 per depth. The spreadsheet's MSF is the 2008
N-independent form (1.16) while this engine uses the 2014 N-dependent MSF, so FS/CRR are
NOT compared — only the procedure-independent columns. Printed to 2–3 dp.
[CGM10] Idriss & Boulanger (2010) UCD/CGM-10/02 Table 3.1 case histories: (N1)60cs and CSR. The
table gives σv and σ′v, not unit weights; a uniform γ = σv/z with the printed water table
reproduces σv exactly and σ′v within ≈ 1 kPa, hence ±0.2 blows / ±0.006 on CSR.
[CGM14] Boulanger & Idriss (2014) UCD/CGM-14/01 Table 6.1: the revised N-dependent MSF, printed to
2 dp → ±0.015.
[YOUD] Youd et al. (2001) Table 3, "Idriss" column = 10^2.24/Mw^2.56 — the expression IS 1893
(Part 1):2016 Annex F Step 5 prescribes (no worked example exists in IS 1893). ±0.015 — the
table truncates rather than rounds at Mw 5.5 (2.211 printed 2.20).
| Test block (the published value it checks) | Verdict |
| [MNO12] App. A z = 1.8 m: (N1)60cs = 8.5 | Pass |
| [MNO12] App. A z = 1.8 m: CSR = 0.181 | Pass |
| [MNO12] App. A z = 1.8 m: Kσ = 1.09 | Pass |
| [MNO12] App. A z = 1.8 m: CRR_M7.5,σ=1 = 0.108 | Pass |
| [MNO12] App. A z = 2.6 m: (N1)60cs = 7.05 | Pass |
| [MNO12] App. A z = 2.6 m: CSR = 0.211 | Pass |
| [MNO12] App. A z = 2.6 m: Kσ = 1.07 | Pass |
| [MNO12] App. A z = 2.6 m: CRR_M7.5,σ=1 = 0.098 | Pass |
| [MNO12] App. A z = 3.4 m: (N1)60cs = 9.37 | Pass |
| [MNO12] App. A z = 3.4 m: CSR = 0.23 | Pass |
| [MNO12] App. A z = 3.4 m: Kσ = 1.06 | Pass |
| [MNO12] App. A z = 3.4 m: CRR_M7.5,σ=1 = 0.114 | Pass |
| [MNO12] App. A z = 4.1 m: (N1)60cs = 11.39 | Pass |
| [MNO12] App. A z = 4.1 m: CSR = 0.243 | Pass |
| [MNO12] App. A z = 4.1 m: Kσ = 1.05 | Pass |
| [MNO12] App. A z = 4.1 m: CRR_M7.5,σ=1 = 0.128 | Pass |
| [MNO12] App. A z = 4.9 m: (N1)60cs = 13.29 | Pass |
| [MNO12] App. A z = 4.9 m: CSR = 0.252 | Pass |
| [MNO12] App. A z = 4.9 m: Kσ = 1.05 | Pass |
| [MNO12] App. A z = 4.9 m: CRR_M7.5,σ=1 = 0.142 | Pass |
| [MNO12] App. A z = 5.6 m: (N1)60cs = 28.14 | Pass |
| [MNO12] App. A z = 5.6 m: CSR = 0.257 | Pass |
| [MNO12] App. A z = 5.6 m: Kσ = 1.06 | Pass |
| [MNO12] App. A z = 5.6 m: CRR_M7.5,σ=1 = 0.389 | Pass |
| [MNO12] App. A z = 6.4 m: (N1)60cs = 23.4 | Pass |
| [MNO12] App. A z = 6.4 m: CSR = 0.261 | Pass |
| [MNO12] App. A z = 6.4 m: Kσ = 1.03 | Pass |
| [MNO12] App. A z = 6.4 m: CRR_M7.5,σ=1 = 0.257 | Pass |
| [MNO12] App. A z = 7.2 m: (N1)60cs = 32.28 | Pass |
| [MNO12] App. A z = 7.2 m: CSR = 0.263 | Pass |
| [MNO12] App. A z = 7.2 m: Kσ = 1.03 | Pass |
| [MNO12] App. A z = 7.2 m: CRR_M7.5,σ=1 = 0.674 | Pass |
| [MNO12] App. A z = 7.9 m: (N1)60cs = 24.18 | Pass |
| [MNO12] App. A z = 7.9 m: CSR = 0.264 | Pass |
| [MNO12] App. A z = 7.9 m: Kσ = 1.01 | Pass |
| [MNO12] App. A z = 7.9 m: CRR_M7.5,σ=1 = 0.272 | Pass |
| [MNO12] App. A z = 9.4 m: (N1)60cs = 25.13 | Pass |
| [MNO12] App. A z = 9.4 m: CSR = 0.264 | Pass |
| [MNO12] App. A z = 9.4 m: Kσ = 0.98 | Pass |
| [MNO12] App. A z = 9.4 m: CRR_M7.5,σ=1 = 0.293 | Pass |
| [MNO12] App. A z = 10.2 m: (N1)60cs = 15.57 | Pass |
| [MNO12] App. A z = 10.2 m: CSR = 0.262 | Pass |
| [MNO12] App. A z = 10.2 m: Kσ = 0.98 | Pass |
| [MNO12] App. A z = 10.2 m: CRR_M7.5,σ=1 = 0.161 | Pass |
| [MNO12] App. A z = 11 m: (N1)60cs = 13.52 | Pass |
| [MNO12] App. A z = 11 m: CSR = 0.261 | Pass |
| [MNO12] App. A z = 11 m: Kσ = 0.98 | Pass |
| [MNO12] App. A z = 11 m: CRR_M7.5,σ=1 = 0.144 | Pass |
| [MNO12] App. A: the two CH rows (PI 30) and the unsaturated 1.1 m row are not analysed | Pass |
| [CGM10] Table 3.1 1964 Niigata, Showa Br. 2: (N1)60cs = 8.2 | Pass |
| [CGM10] Table 3.1 1964 Niigata, Showa Br. 2: CSR = 0.21 | Pass |
| [CGM10] Table 3.1 1968 Tokachi-Oki, Aomori Station: (N1)60cs = 16.5 | Pass |
| [CGM10] Table 3.1 1968 Tokachi-Oki, Aomori Station: CSR = 0.335 | Pass |
| [CGM10] Table 3.1 1948 Fukui, Shonenji Temple: (N1)60cs = 11.8 | Pass |
| [CGM10] Table 3.1 1948 Fukui, Shonenji Temple: CSR = 0.39 | Pass |
| [CGM10] Table 3.1 1948 Fukui, Takaya 45: (N1)60cs = 21.1 | Pass |
| [CGM10] Table 3.1 1948 Fukui, Takaya 45: CSR = 0.283 | Pass |
| [CGM10] Table 3.1 1964 Niigata, Old Town 2: (N1)60cs = 23.5 | Pass |
| [CGM10] Table 3.1 1964 Niigata, Old Town 2: CSR = 0.184 | Pass |
| [CGM14] Table 6.1 1999 Chi-Chi, Wufeng Site A1: MSF = 0.97 | Pass |
| [CGM14] Table 6.1 1999 Kocaeli, Degirmendere DN-1: MSF = 1 | Pass |
| [CGM14] Table 6.1 1999 Kocaeli, Building C3: MSF = 1 | Pass |
| [CGM14] Table 6.1 1999 Chi-Chi, Yuanlin BH-31: MSF = 0.99 | Pass |
| [YOUD] Table 3 / IS 1893 Annex F Step 5: MSF(Mw 5.5) = 2.2 | Pass |
| [YOUD] Table 3 / IS 1893 Annex F Step 5: MSF(Mw 6) = 1.76 | Pass |
| [YOUD] Table 3 / IS 1893 Annex F Step 5: MSF(Mw 6.5) = 1.44 | Pass |
| [YOUD] Table 3 / IS 1893 Annex F Step 5: MSF(Mw 7) = 1.19 | Pass |
| [YOUD] Table 3 / IS 1893 Annex F Step 5: MSF(Mw 7.5) = 1 | Pass |
| [YOUD] Table 3 / IS 1893 Annex F Step 5: MSF(Mw 8) = 0.84 | Pass |
| [YOUD] Table 3 / IS 1893 Annex F Step 5: MSF(Mw 8.5) = 0.72 | Pass |
⚑ machine-foundation-web-validation.test.ts
Dedicated validation for the block machine-foundation vertical mode (`machine-foundation.ts`): Barkan/IS 2974 stiffness kz = Cu·A, natural frequency fnz = (1/2π)√(kz/m), frequency ratio r = f/fnz, damped magnification M = 1/√((1−r²)² + (2D…
Analyses validated: machine-foundation · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Dedicated validation for the block machine-foundation vertical mode (`machine-foundation.ts`): Barkan/IS 2974
stiffness kz = Cu·A, natural frequency fnz = (1/2π)√(kz/m), frequency ratio r = f/fnz, damped magnification
M = 1/√((1−r²)² + (2Dr)²) and forced amplitude Az = (F0/kz)·M.
PUBLISHED SOURCES (each opened and read for this suite):
1. Varghese, P.C. (2005), Foundation Engineering, PHI Learning, New Delhi (library copy, ninth printing 2012):
Chapter 23, Example 23.1 "Design of a block foundation for a vertical compressor" (pages 442-443) —
printed fnz = 19.8 Hz, frequency ratio 10/19.8 = 0.5, amplitude 5.4 x 10^-5 m = 0.054 mm "acceptable,
being less than 0.2 mm". Units of the book: tonnes-force and metres with g = 10 (so 1 tf = 10 kN, which
the book itself uses: 3.06 t/m² = 30.6 kN/m²).
2. Bowles, J.E. (1997), Foundation Analysis and Design, 5th ed., McGraw-Hill, Example 20-1 (page 1114 and
Figure E20-1a): the printed FADDYNF1 output for the vertical mode of a 3.66 m x 7.32 m base (A = 26.80 m²,
mass 19.99 kN·s²/m, static spring 4.3049 x 10^6 kN/m, F0 = 90 kN at 900 rpm): WN, W/WN, C/CC, YP/YS and
YP for 800, 900 and 1000 rpm. Library copy of the scanned book, read from the rendered page image.
3. Vora, K. (2018), "Analytical Solution of Machine Foundation as per IS: 2974 (Part-1) by VC++ Application
Software", International Journal of Innovative Research in Science, Engineering and Technology 7(4),
3379-3384, Example 1 (gas-engine foundation, Barkan empirical method) — the printed program results.
https://www.ijirset.com/upload/2018/april/21_Analytical.PDF (fetched and read 2026-10-06). ⚠ These
are the output of the author's own program for a problem the author says was "selected from different
books"; the originating book answer was not available, so this source is weaker than the first two
and is labelled as program output below.
4. IS 2974 (Part 1):1982 cl 5.3.2 (200 microns below 20 Hz) is the permissible amplitude Varghese uses.
WHAT IS PUBLISHED ANSWER HERE. Every `near(...)` carries the printed number next to its locator. Engine inputs
that the source prints only indirectly are obtained from the source's own stated data and said so.
NOT ASSERTED (recorded so nothing is hidden). (a) Bowles' static spring 4.3049 x 10^6 kN/m comes from his
rectangular-footing shape factor (L/B = 2); this engine's elastic-half-space option uses the Richart
equivalent-circle spring 4Gr0/(1-nu), which for the same G, nu = 0.33 and A gives 4.175 x 10^6 kN/m, 3.0 %
lower. That is an approximation difference between two published methods, not an error, so the Bowles spring
is supplied through Cu = K/A and only the response part of the engine is compared; the half-space stiffness
is checked against its own closed form at the end (hand check, not counted as a published value). (b) The
engine's resonance band 0.8-1.2 is NOT the IS 2974 (Part 1) cl 5.2 criterion (0.4 / 1.5 frequency ratios) and
is not asserted as a code value; see the header of `machine-foundation.ts`. (c) Varghese's sliding, rocking
and coupled frequencies are other modes.
| Test block (the published value it checks) | Verdict |
| Varghese (2005) Example 23.1: vertical frequency, frequency ratio and undamped amplitude | Pass |
| Bowles (1997) Example 20-1A: printed natural frequency WN and frequency ratios W/WN | Pass |
| Bowles (1997) Example 20-1A: printed YP/YS (magnification) and YP (mm) at 800, 900, 1000 rpm | Pass |
| Vora (2018) Example 1: printed program results for the gas-engine foundation | Pass |
| hand check: elastic half-space stiffness kz = 4 G r0 / (1 − ν) for the Bowles base (equivalent circle) | Pass |
makdisi-seed-web-validation.test.ts
makdisi-seed — dedicated validation against PUBLISHED worked answers (`makdisi-seed.ts`).
Analyses validated: makdisi-seed · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
makdisi-seed — dedicated validation against PUBLISHED worked answers (`makdisi-seed.ts`).
STATUS: PARTIAL — nine published numbers from two sources; the release rules asks for ≥ 20. See SHORTFALL.
WHAT THE ENGINE DOES. T0 = 2.6·H/Vs, ky/kmax, and U = [U/(kmax·g·T0)]·kmax·g·T0. The normalised displacement
is an INPUT read off the Makdisi-Seed chart, so what can be checked against a published answer is the
period, the ratio and the displacement ARITHMETIC — not the chart itself.
SOURCES (opened 2026-10):
[K] Kramer, S.L. (1996), Geotechnical Earthquake Engineering, Prentice Hall (local PDF, text layer) —
Example 7.6 (p. 289: 150 ft earth dam, Vs = 1200 ft/s, ω1 = 19.2 rad/s), Example 10.5 (p. 449:
ky = 0.24 g, amax = 0.442 g, T0 = 0.33 s, U/(amax g T0) ≈ 0.04 → u = 0.19 ft = 2.3 in) and
Problem 10.9 (which restates the Example 7.6 dam as "3.1 Hz").
[M] Makdisi, F.I. & Seed, H.B. (1977), A Simplified Procedure for Estimating Earthquake-Induced
Deformations in Dams and Embankments, Report UCB/EERC-77/19 (NSF/NTIS PB-276820, downloaded from
nehrpsearch.nist.gov, OCR text layer; the same procedure as the ASCE JGED 104(GT7) 1978 paper).
Appendix A "Example Problem" (h = 150 ft, vs = 600 fps → T1 = 0.65 s) and the worked application
on p. 29-30 (M 8¼, T0 = 0.99 s, kmax = 0.2, ky = 0.14, ky/kmax = 0.7, U/(kmax g T0) = 0.013 s →
U = 0.08 ft = 2.4 cm).
SHORTFALL (reported, not padded). The Makdisi-Seed design curves themselves (Fig. 16 of [M], Fig. 10.19 of [K])
are charts whose readings are INPUTS to this engine, and no further worked example with printed numbers was found
in the library (the 1978 ASCE paper and Seed's 1979 Rankine Lecture were not obtainable). The other 20 or so
cases in [M] Tables 2-4 print displacements in cm but not the normalised displacement, so using them would
mean inverting the engine's own formula — not a published check, so they are not used.
TOLERANCES follow the printed digits and are stated at each assertion. Imperial examples are run in SI
(1 ft = 0.3048 m); the engine's g = 9.81 m/s² differs from 32.2 ft/s² by 0.05 %.
| Test block (the published value it checks) | Verdict |
| [K] Example 7.6 dam (H = 150 ft, Vs = 1200 ft/s): T0 = 0.33 s (printed in Ex. 10.5) and f = 3.1 Hz (Problem 10.9) | Pass |
| [K] Example 10.5: ky/kmax = 0.24/0.442 = 0.54 | Pass |
| [K] Example 10.5: chart value 0.04 → u = 0.19 ft = 2.3 in | Pass |
| [M] Appendix A example (h = 150 ft, vs = 600 fps): first period T1 = 0.65 s | Pass |
| [M] p. 29-30: kmax = 0.2, ky = 0.14 → ky/kmax = 0.7 | Pass |
| [M] p. 29-30: U/(kmax·g·T0) = 0.013 s, T0 = 0.99 s → U = 0.08 ft = 2.4 cm | Pass |
| HAND-CHECK: U = norm·kmax·g·T0 and ky ≥ kmax is reported as not mobilised | Pass |
| invalid inputs are refused (no fabricated displacement): zero H, Vs, kmax; negative ky or chart value | Pass |
nonlinear-site-response-codespectrum-web-validation.test.ts
WEB-BENCHMARK validation for the CODE DESIGN-SPECTRUM OVERLAY added to the nonlinear-site-response engine (IS 1893:2016 + ASCE 7-16).
Analyses validated: nonlinear-site-response · Recorded run: passed — 20 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the CODE DESIGN-SPECTRUM OVERLAY added to the
nonlinear-site-response engine (IS 1893:2016 + ASCE 7-16). the release rules mandatory
step. Every case is EXACT and hand-reproducible from the code equations — the
code spectrum is deterministic (Vs30 + code params), independent of the FE run,
so `code_sa_at_structure_g` at a chosen period is an exact golden assert.
IS 1893 Cl 6.4.2: Sa(T) = (Z/2)·(Sa/g); Sa/g = 1+15T (T≤0.1), 2.5 (0.1≤T≤Tc),
k/T (T>Tc); (Tc,k) = (0.40,1.00) I · (0.55,1.36) II · (0.67,1.67) III.
ASCE 7-16 §11.4.6: SDS=(2/3)Fa·Ss, SD1=(2/3)Fv·S1; Sa = SDS(0.4+0.6T/T0) (T<T0),
SDS (T0≤T≤Ts), SD1/T (Ts<T≤TL), SD1·TL/T² (T>TL); T0=0.2·SD1/SDS, Ts=SD1/SDS.
Sources: IS 1893 (Part 1):2016 Cl 6.4.2 Fig.2/Table 3; ASCE/SEI 7-16 §11.4 (Fa/Fv
Tables 11.4-1/2), Kramer (1996) GEE Ch.7 for the site-response engine itself.
| Test block (the published value it checks) | Verdict |
| overlay 1: IS site class — Vs=250 ⇒ Type II (medium) | Pass |
| overlay 2: IS site class — Vs=500 ⇒ Type I (rock/hard) | Pass |
| overlay 3: IS site class — Vs=150 ⇒ Type III (soft) | Pass |
| overlay 4: ASCE site class — Vs=250 ⇒ D (stiff soil); Vs=500 ⇒ C | Pass |
| overlay 5: IS plateau — T=0.2 s ⇒ Sa = (Z/2)·2.5 = 0.20 g | Pass |
| overlay 6: IS rising branch — T=0.05 s ⇒ (Z/2)·(1+15·0.05) = 0.14 g | Pass |
| overlay 7: IS Type-II falling branch — T=1.0 s ⇒ (Z/2)·(1.36/1.0) = 0.1088 g | Pass |
| overlay 8: IS design Sa scales linearly with Z | Pass |
| overlay 9: ASCE plateau — T=0.5 s (T0<T<Ts) ⇒ Sa = SDS = 1.0 g | Pass |
| overlay 10: ASCE falling branch — T=1.0 s ⇒ SD1/T = 0.68 g | Pass |
| overlay 11: ASCE — T=2.0 s ⇒ SD1/T = 0.34 g | Pass |
| overlay 12: code spectrum is aligned 1:1 with the site-specific spectrum | Pass |
| overlay 13: verdict matches the site-vs-code comparison at the structure period | Pass |
| overlay 14: no structure period ⇒ verdict prompts to enter one | Pass |
| overlay 15: default code is IS 1893 (India-first) | Pass |
| overlay 16: EC8 ground type — Vs=250⇒C, Vs=500⇒B, Vs=900⇒A | Pass |
| overlay 17: EC8 plateau — T=0.4 s ⇒ ag·S·2.5 = 0.25·1.15·2.5 = 0.71875 g | Pass |
| overlay 18: EC8 falling branch — T=1.0 s ⇒ ag·S·2.5·(TC/T) = 0.43125 g | Pass |
| overlay 19: EC8 rising branch — T=0.1 s ⇒ ag·S·(1+T/TB·1.5) = 0.503125 g | Pass |
| overlay 20: EC8 design Sa scales linearly with ag | Pass |
nonlinear-site-response-web-validation.test.ts
WEB-BENCHMARK validation for the 1-D nonlinear time-domain site-response engine.
Analyses validated: nonlinear-site-response · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the 1-D nonlinear time-domain site-response engine.
≥20 web-sourced cases (the release rules mandatory step).
Note: `amplification` is a surface/input PGA ratio (broadband), which is LOWER than
a single-frequency spectral peak — compare like-for-like. Sources: Kramer (1996) GEE
Ch.7; SimCenter TFT theory (T0=4H/Vs); Stewart & Kwok (PEER 2008/804) nonlinear
ground-response benchmarking; Kwok et al. (eScholarship) — "Vs30≤200 & PGA≥0.1 g ⇒
nonlinear required"; Seyhan & Stewart (PEER 2013-13) & ASCE 7-16 Fa (deamplification
with intensity); PMC12881525 stratified-soil amplification study.
| Test block (the published value it checks) | Verdict |
| NLSR web C1–C6: T0 = 4H/Vs (exact) | Pass |
| NLSR web C7–C10: weak-motion amplification decreases monotonically with damping | Pass |
| NLSR web C11–C13: strong motion DE-amplifies vs weak (period lengthening + hysteretic damping) | Pass |
| NLSR web C16–C18: max shear strain grows monotonically with input PGA | Pass |
| NLSR web C17: soft site (Vs≤200) + PGA≥0.1 g ⇒ strains large enough that NL matters | Pass |
| NLSR web C20–C21: softer profile ⇒ longer site period | Pass |
| NLSR web C24–C25: NEHRP-style deamplification — amplification falls as input PGA rises | Pass |
| NLSR web: surface history + response spectrum are finite and non-empty | Pass |
| NLSR web: elastic transfer function peaks at f₀, 3f₀, 5f₀ | Pass |
| NLSR web: strain/stress depth profiles + hysteresis loop are physical | Pass |
| NLSR web: input accel history aligns with time + surface, peaks at the input PGA | Pass |
| NLSR web: G/Gmax degrades + damping rises with strain (per-layer stiffness) | Pass |
| NLSR web: vel/disp histories + Arias intensity + D₅₋₉₅ are physical | Pass |
| NLSR web: surface Fourier spectrum peaks near the site period f₀ | Pass |
pm4sand-web-validation.test.ts
Validation for the PM4Sand engine (`pm4sand.ts`).
Analyses validated: pm4sand · Recorded run: passed — 37 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the PM4Sand engine (`pm4sand.ts`).
the release rules ≥20-cited-value gate. Two tiers, both traceable to published values:
TIER 1 — CLOSED-FORM state & calibration relations (EXACT, each cited to the
PM4Sand manual CGM-15-01 or Idriss & Boulanger 2008). These are the
liquefaction-triggering relations practitioners use directly:
- M = 2·sin φ_cv (eq 14); M^b/M^d surfaces (eqs 12-13); coincide at ξ_R=0.
- Bolton A_do (eq 45): 1.26 at ξ_R=−0.1 and 1.45 at ξ_R=−0.7 (manual, p.25).
- Default G_o = 167·√((N1)₆₀+2.5) (eq 97): 678/892 at N=14/26 (manual).
- Vs1 = 85·((N1)₆₀+2.5)^0.25 (eq 96): 171/196 at N=14/26 (manual).
- D_R = √((N1)₆₀/46) (eq 92): 0.55/0.75 at N=14/26 (manual).
- Idriss-Boulanger (2008) CRR: 0.092/0.148/0.316 at N=6/14/26 (targets
0.090/0.147/0.312 in the manual, matched within rounding).
- Kσ (Boulanger-Idriss 2004): =1 at 1 atm, <1 at higher stress.
- MSF (I&B 2008): =1 at M=7.5, >1 at smaller magnitudes.
TIER 2 — the reduced plane-strain incremental INTEGRATOR, validated for the
behaviours it faithfully reproduces (not a bit-for-bit figure match; the full
fabric-history memory set is only partially implemented — see pm4sand.ts):
- undrained cyclic DSS reaches full liquefaction (r_u → ~1);
- cycles-to-liquefaction decreases as CSR increases (correct CRR-N trend);
- element CRR at 15 cycles for the manual's mid-density calibration
(D_R=55%, G_o=677, h_po=0.40) matches the I&B target 0.147 within 12%;
- h_po (the contraction knob) monotonically raises CRR.
| Test block (the published value it checks) | Verdict |
| CGM-15-01 eq 14 — M = 2·sin(33°) = 1.089 | Pass |
| CGM-15-01 eqs 12-13 — surfaces coincide at critical state (ξ_R = 0) | Pass |
| CGM-15-01 eqs 12-13 — dense-of-critical gives M^b > M > M^d | Pass |
| CGM-15-01 eq 45 — Bolton A_do = 1.26 at ξ_R = −0.1 (nb=0.5, nd=0.1) | Pass |
| CGM-15-01 eq 45 — Bolton A_do = 1.45 at ξ_R = −0.7 | Pass |
| CGM-15-01 eq 97 — G_o = 167·√((N1)₆₀+2.5): 678 & 892 at N=14 & 26 | Pass |
| CGM-15-01 eq 96 — Vs1 = 85·((N1)₆₀+2.5)^0.25: 171 & 196 at N=14 & 26 | Pass |
| CGM-15-01 eq 92 — D_R = √((N1)₆₀/46): 0.552 & 0.752 at N=14 & 26 | Pass |
| Idriss-Boulanger 2008 — CRR at N=6/14/26 ≈ 0.090/0.147/0.312 (targets) | Pass |
| Idriss-Boulanger CRR is monotonically increasing with density | Pass |
| Boulanger-Idriss 2004 — Kσ = 1 at 1 atm and < 1 above 1 atm | Pass |
| Idriss-Boulanger 2008 — MSF = 1 at M=7.5 and > 1 for smaller M | Pass |
| CGM-15-01 eq 10-11 — relative-state index negative for dense sand | Pass |
| CGM-15-01 Table 4.2 — default h_o = max((0.25+Dr)/2, 0.30) | Pass |
| CGM-15-01 Table 4.2 — default z_max = 0.7 at ξ_R0 = 0, capped at 20 | Pass |
| Pezeshk/IB-2014 — CRR₇.₅ matches the worked table across 13 (N1)₆₀cs values | Pass |
| Pezeshk/IB-2014 — Kσ matches the worked table across 5 rows | Pass |
| Idriss-Boulanger CRR caps at 2.0 for very dense sand ((N1)₆₀cs ≥ ~38) | Pass |
| Pezeshk/IB-2014 — r_d(z, M=7.7) matches the worked table across 8 depths | Pass |
| Pezeshk/IB-2014 — CSR = 0.65·(a_max/g)·(σv/σ′v)·r_d matches 8 rows | Pass |
| Pezeshk/IB-2014 — end-to-end FoS via the a_max path matches the table (0.469) | Pass |
| Integrator — undrained cyclic DSS reaches full liquefaction (r_u → ~1) | Pass |
| Integrator — cycles-to-liquefaction decreases as CSR increases (CRR-N trend) | Pass |
| Integrator — mid-density element CRR matches I&B target 0.147 within 12% | Pass |
| Integrator — h_po (contraction knob) monotonically raises element CRR | Pass |
| Integrator — stress path shows p reduction toward liquefaction | Pass |
| computePm4Sand — end-to-end wrapper returns a factor of safety and CRRs | Pass |
| cyclesToLiquefactionFromFoS — N = 15 at FoS = 1, monotone in FoS | Pass |
| Dense sand no longer contradicts FoS — N45/CSR0.5 safe, N30/CSR0.1 safe | Pass |
| Loose sand triggers fast — N6/CSR0.35 FoS<1 and cycles<15 | Pass |
| cycles-to-liquefaction is monotone: denser/weaker shaking ⇒ more cycles | Pass |
| audit: CSR = 0 is REFUSED, not reported as FoS ≈ 110 929 | Pass |
| audit: negative n160 / sigmaVc are REFUSED, not silently turned into NaN with errors: [] | Pass |
| audit: maxCycles is bounded — no heap exhaustion from an extreme value | Pass |
| audit: the kernel bounds stored series in place even for a run that never triggers | Pass |
| audit: the real, valid case is BYTE-IDENTICAL to before the fix | Pass |
| audit: n160 = 0 (very loose sand) stays LEGAL | Pass |
pore-pressure-generation-web-validation.test.ts
Formula-fidelity validation for the tool surfaced at /tools/liquefaction- response (module: pore-pressure-generation.ts, NOT named after the slug -- one of the documented module-resolution traps).
Analyses validated: liquefaction-response · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation for the tool surfaced at /tools/liquefaction-
response (module: pore-pressure-generation.ts, NOT named after the slug --
one of the documented module-resolution traps). Validates against:
- Seed & Idriss (1982) EERI monograph equivalent-uniform-cycles table
(N_eq vs magnitude), reproduced exactly at its published anchors
(M5.25->2.5, M6.0->5, M6.75->10, M7.5->15, M8.5->26);
- Seed, Martin & Lysmer (1976) ASCE JGED 102(GT4) / Booker, Rahman & Seed
(1976) GADFLEA excess pore-pressure ratio ru = (2/pi).arcsin[(N/NL)^(1/2beta)],
beta=0.7 (DeAlba, Chan & Seed 1976) -- an exact closed-form checked at
its defining anchor (ru=1 at N=NL) and two intermediate ratios;
- the FS=CRR/CSR and NL=Neq.FS^(1/b) chain, cross-checked against the
already-validated liquefaction.ts engine's own reported CRR/CSR for the
same B&I 2014 case (see liquefaction-web-validation.test.ts).
| Test block (the published value it checks) | Verdict |
| [1-5] equivalent uniform cycles N_eq matches the published Seed & Idriss (1982) table anchors exactly: M5.25=2.5, M6.0=5, M6.75=10, M7.5=15, M8.5=26 | Pass |
| [6] ru=1 exactly at cycle ratio N/NL=1 (the defining anchor of initial liquefaction, per Seed-Martin-Lysmer 1976) | Pass |
| [7-8] ru matches the exact Seed-Martin-Lysmer closed-form at two intermediate ratios: ratio=0.5 -> ru=0.417265, ratio=0.25 -> ru=0.242312 | Pass |
| [9] ru=0 exactly at N=0 (no cycles, no pore pressure generated) | Pass |
| [10-13] CROSS-ENGINE CHECK: feeding this engine the actual B&I 2014 CRR/CSR from the already-validated liquefaction.ts engine (see liquefaction-web-validation.test.ts) reproduces the exact expected FS, Neq, and NL | Pass |
| [14] a non-liquefying case (FS>1) is correctly flagged, and the final ru stays below 1 | Pass |
| [15] the stiffness ratio G/Gmax = sqrt(1-ru) exactly, per Hardin & Drnevich (1972) stress dependence | Pass |
| [16] the effective stress path sigma_v_eff = sigma_v0.(1-ru) exactly, when sigma_v0 is supplied | Pass |
| [17] invalid inputs (zero CSR/CRR, magnitude outside 4-9.5) are refused | Pass |
response-spectrum-web-validation.test.ts
Validation for the seismic response spectrum (`response-spectrum.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the seismic response spectrum (`response-spectrum.ts`).
the release rules gate. Anchors (Chopra "Dynamics of Structures"):
• rigid limit T→0 ⇒ Sa → PGA;
• resonance of a lightly-damped SDOF to a sinusoid ⇒ Sa ≈ PGA/(2ζ);
• zero input ⇒ zero response; Arias intensity closed form.
| Test block (the published value it checks) | Verdict |
| PGA of the sinusoid = amplitude A | Pass |
| rigid limit: Sa(T→0) → PGA | Pass |
| resonance: Sa ≈ PGA/(2ζ) for a SDOF tuned to the input frequency | Pass |
| pseudo-spectral relations Sv=ω·Sd, Sa=ω²·Sd hold | Pass |
| zero ground motion → zero response | Pass |
| Arias intensity closed form Ia = (π/2g)∫a²dt | Pass |
rvt-site-response-web-validation.test.ts
Validation for the RVT site-response engine (`rvt-site-response.ts`).
Analyses validated: rvt-site-response, site-response-multilayer · Recorded run: passed — 34 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the RVT site-response engine (`rvt-site-response.ts`).
the release rules ≥20-cited-value gate. Each assertion traces to a published relation:
- Boore (2003) — spectral moments mₙ = 2∫(2πf)ⁿ|X|²df; RVT peak factor.
- Cartwright & Longuet-Higgins (1956) — bandwidth ξ, extrema/zero-crossing rates,
expected peak-factor integral.
- Davenport (1964) — broadband peak-factor asymptote √(2lnν)+γ/√(2lnν).
- Boore & Joyner (1984) — oscillator rms duration limits.
- Kramer (1996) Ch.7 — single-layer site period T₀ = 4H/Vs and resonant amplification.
- Structural dynamics — SDOF resonant amplification 1/(2β).
Analytic anchors use a band-limited white FAS (|X| = A on [f₁,f₂]), for which
the moments are exact quintic integrals and the RVT bandwidth ξ is EXACTLY √5/3
on [0,fmax] (a clean, source-independent check of the moment machinery).
| Test block (the published value it checks) | Verdict |
| spectral moment m0 = 2A²(f2−f1) | Pass |
| spectral moment m2 = 2A²(2π)²(f2³−f1³)/3 | Pass |
| spectral moment m4 = 2A²(2π)⁴(f2⁵−f1⁵)/5 | Pass |
| moments scale with A² | Pass |
| RVT bandwidth ξ = √(m₂²/(m₀m₄)) of [0,fmax] white noise = √5/3 (exact) | Pass |
| zero-crossing rate = 2·fmax/√3 for [0,fmax] white | Pass |
| extrema rate = 2·fmax·√(3/5) for [0,fmax] white | Pass |
| n_extrema ≥ n_zero | Pass |
| peak factor > 1 | Pass |
| peak factor increases with duration | Pass |
| CLH peak factor ≈ Davenport asymptote (broadband) | Pass |
| peak factor is O(√(2 ln Ne)) | Pass |
| rms duration → D_gm at long period | Pass |
| rms duration → D_gm + Tn/(2πβ) at short period | Pass |
| rms duration ≥ D_gm | Pass |
| rms duration decreases with damping | Pass |
| PSA(T→0) approaches PGA | Pass |
| response spectrum positive & finite | Pass |
| lower oscillator damping → higher Sa | Pass |
| Brune corner frequency drops with magnitude | Pass |
| single-layer site period ≈ 4H/Vs | Pass |
| soft-soil amplification > 1 | Pass |
| surface PGA ≥ rock PGA | Pass |
| surface Sa peak ≥ surface PGA | Pass |
| softer soil → longer period + more amplification | Pass |
| fundamental period within physical band of 4H/Vs | Pass |
| Kramer Eq 7.19 — single layer over rigid rock: |F|(f0) = 1/(ξ·π/2) | Pass |
| Kramer — single layer over elastic rock: |F|(f0) = 1/α_z (undamped soil) | Pass |
| Kramer — fundamental period T0 = 4H/Vs across cases | Pass |
| Kramer — odd higher modes resonate: |F|(3f0) > |F|(2f0) | Pass |
| Toro 1995 Vs randomization — median ≈ base, ordered p16 ≤ median ≤ p84, deterministic | Pass |
| audit: bedrock damping far beyond 100% critical is REFUSED | Pass |
| audit: a negated layer (thickness, Vs, unit weight, damping) is REFUSED, not a plausible period | Pass |
| audit: the real, valid single-layer case is unaffected by the new per-field checks | Pass |
⚑ seismic-site-class-crosscode-web-validation.test.ts
seismic-site-class — deep review D11 (2026-10-02).
Analyses validated: seismic-site-class · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
seismic-site-class — deep review D11 (2026-10-02). Cited, published values for the site-class
averages, the IS 1893 design coefficient, and the ASCE 7-16 / ASCE 7-22 / EN 1998-1
cross-classification. Every expected value below is printed in the named source; nothing is
derived from this engine.
Sources
[IDOT] Illinois DOT, Bureau of Bridges & Structures, AGMU design guide "LRFD Soil Site Class
Definition" (Jan 2009/2010), worked example of a 4-span bridge: five 100-ft profiles with
per-layer d, N, su and the published N̄ (Method B) and s̄u (Method C), classified to
AASHTO Table 3.10.3.1-1 (the same N̄ / s̄u limits as ASCE 7-16 Table 20.3-1).
https://idot.illinois.gov/…/agmu-design-guides/lrfd-soil-site-class-definition.pdf
The profiles are entered at 0.3 m per ft: a travel-time average is unchanged by a
uniform scaling of every thickness, and 100 ft maps onto exactly the 30 m window.
IDOT assigns bedrock N = 100 and su = 5 ksf; those are entered as given in its tables.
[PEER] Wair, DeJong & Shantz (2012), "Guidelines for Estimation of Shear Wave Velocity
Profiles", PEER 2012/08, Eq. 1.2 example after Dobry et al. (2000): 18 m of Vs = 90 m/s
over 12 m of Vs = 260 m/s → Vs30 = 122 m/s; arithmetic mean 158 m/s.
[CE] Company Educator, "Advanced Soil Dynamics – Measuring Shear Wave Velocity", solved
problems 1-2 (Vs30 = 372.2, 308 and 424 m/s). Educational source; only its Vs30
arithmetic is used (its "Site Class D" for 372 m/s is itself inconsistent with the
NEHRP table it quotes, so its class labels are NOT used).
[EQ03] IITK-NICEE / IITGN, "Explanatory Examples on Indian Seismic Code IS 1893 (Part 1)" —
IS 1893:2016 edition, Example 1: Zone V, I = 1, R = 5, Type II, T = 0.28 s → Sa/g = 2.5,
Ah = 0.09. https://www.iitk.ac.in/nicee/IITGN-WB/EQ03.pdf
[STAAD] Bentley STAAD.Pro verification "V. IS 1893 2016 Static Seismic": Z = 0.36, I = 1.2,
R = 5, hard soil, Ta = 0.39 s → Sa/g = 2.5, Ah = 0.108, VB,min = 2.4 % of W (Cl 7.2.2).
[IS] IS 1893 (Part 1):2016, read from the PDF: Table 7 (ρ = 0.7 / 1.1 / 1.6 / 2.4 %),
Cl 6.3.5.3 (N < 15 Zones III-V, N < 10 Zone II), Cl 6.4.2(a)/(b).
[EN] EN 1998-1:2004 Table 3.1 (ground types), Tables 3.2 / 3.3 (recommended S, TB, TC, TD).
[JRC] Fardis et al., "Eurocode 8: Seismic Design of Buildings — Worked examples" (JRC 2012)
§3.2: clay with cu,d = 300 kPa (270 kPa seismic) → "Ground type B".
| Test block (the published value it checks) | Verdict |
| [IDOT] N̄ (Method B) on five published 100-ft profiles — 9, 7, 21, 19, 23 blows/ft | Pass |
| [IDOT] s̄u (Method C, cohesive layers only) — 0.68, 2.17, 4.62, 3.51, 4.62 ksf | Pass |
| [IDOT] the published class for each measure (AASHTO 3.10.3.1-1 = ASCE 7-16 Table 20.3-1 limits) | Pass |
| [IDOT] → IS 1893 Table 4 on the published N̄: 9, 7 → Type III; 21, 19, 23 → Type II | Pass |
| [PEER] Dobry et al. 2000 example: 18 m @ 90 m/s over 12 m @ 260 m/s → Vs30 = 122 m/s (arithmetic 158) | Pass |
| [CE] travel-time Vs30 solved problems — 372.2, 308 and 424 m/s | Pass |
| [EQ03] IS 1893:2016 Example 1 — Zone V, I 1, R 5, Type II, T 0.28 s → Sa/g 2.5, Ah 0.09 | Pass |
| [STAAD] IS 1893:2016 static seismic — Z 0.36, I 1.2, R 5, hard soil, Ta 0.39 s → Sa/g 2.5, Ah 0.108, VBmin 2.4 % | Pass |
| [IS] Table 7 minimum VB/W for buildings — 0.7, 1.1, 1.6, 2.4 % (Zones II-V) | Pass |
| [IS] Cl 6.4.2(a) vs (b): a rigid structure gets 2.5 by the equivalent static method, 1 + 15T by the response spectrum method | Pass |
| [IS] Cl 6.3.5.3 — the liquefaction N limit is 15 in Zones III-V and 10 in Zone II, and no site type is exempt | Pass |
| [EN] Table 3.2 / 3.3 recommended spectrum parameters on ground types C and D | Pass |
| [JRC] Worked example §3.2: clay with cu,d = 300 kPa (270 kPa seismic) is ground type B | Pass |
| [EN] Table 3.1 ground type E — 5-20 m of vs < 360 m/s directly over vs > 800 m/s | Pass |
| D11 regressions — averaging tracks true depth, s̄u stays on the cohesive layers, s̄u alone never gives Type I | Pass |
seismic-site-class-is1893-web-validation.test.ts
Seismic site classification and design coefficient — validated against **IS 1893 (Part 1):2016**, *Criteria for Earthquake Resistant Design of Structures*, Part 1 General Provisions and Buildings (6th revision).
Analyses validated: seismic-site-class · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Seismic site classification and design coefficient — validated against
**IS 1893 (Part 1):2016**, *Criteria for Earthquake Resistant Design of Structures*, Part 1
General Provisions and Buildings (6th revision).
Source: `Geo Technical engineering books/IS1893-Part1-2016.pdf`, read directly. The clause and
table numbers below are quoted from that text, not from memory — which mattered, because the
engine had the wrong table number (see the citation note in `seismic-site-class.ts`).
WHAT THE STANDARD SAYS, verbatim from the PDF:
**Table 3 — Seismic Zone Factor Z (Clause 6.4.2)**
Seismic Zone II III IV V
Z 0.10 0.16 0.24 0.36
**Cl 6.4.2** "The design horizontal seismic coefficient Ah for a structure shall be
determined by: Ah = (Z/2)·(Sa/g) / (R/I)" — with "Z = seismic zone factor given in Table 3".
(Note it is Table 3, not Table 2. Table 2 is "Classification of Types of Soils".)
**Cl 6.4.2 Fig 2(b)** design acceleration spectrum for the response-spectrum method:
rocky / hard soil 1+15T (T<0.10) 2.5 (0.10–0.40) 1.00/T (0.40–4.00) 0.25 (T>4)
medium stiff soil 1+15T (T<0.10) 2.5 (0.10–0.55) 1.36/T (0.55–4.00) 0.34 (T>4)
soft soil 1+15T (T<0.10) 2.5 (0.10–0.67) 1.67/T (0.67–4.00) 0.42 (T>4)
This suite exists because `seismic-site-class` had **zero** web-validation while feeding every
seismic design in the product, and it carried two real defects that only reading the code
itself exposed:
• **Q-3 / E-8 (P2)** — omitting the zone produced Z = 0 and therefore **Ah = 0**, silently.
• **E-31 (P2)** — the spectrum had **no T > 4 s floor**, so it kept decaying as c/T. IS 1893
makes Sa/g constant beyond 4 s, and those constants are exactly the T = 4 s values. The
missing floor under-predicted design acceleration by 1.25× at T = 5 s rising to **2.50× at
T = 10 s** — the unconservative direction, and precisely for the long-period structures
(tall buildings, base isolation, long-span bridges, tanks) that most need it right.
| Test block (the published value it checks) | Verdict |
| IS 1893:2016 Table 3 — the four published zone factors Z | Pass |
| Q-3 / E-8 — omitting the seismic zone is REFUSED, never a silent Ah = 0 | Pass |
| IS 1893:2016 Cl 6.4.2 Fig 2(b) — the design acceleration spectrum, all three site classes | Pass |
| E-31 — the T > 4 s floor exists, and the old behaviour would have been unconservative | Pass |
| IS 1893:2016 Cl 6.4.2 — Ah = (Z/2)·(I/R)·(Sa/g), end to end | Pass |
| the references cite the tables that were actually used, with the corrected numbers | Pass |
site-response-design-chain-web-validation.test.ts
Web-benchmark validation for the SEVEN remaining inline runner engines: 1-D site response (equivalent-linear, nonlinear and effective-stress), climate/EICM, the staged embedded wall, and the two probabilistic/full-chain foundation engines.
Analyses validated: bearing-capacity-reliability, climate-zone-eicm, effective-stress-liquefaction, foundation-analysis, nonlinear-site-response, site-response, site-response-multilayer, staged-excavation-wall · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the SEVEN remaining inline runner engines: 1-D site response
(equivalent-linear, nonlinear and effective-stress), climate/EICM, the staged embedded wall,
and the two probabilistic/full-chain foundation engines.
ENGINES AND SOURCES
site-response-multilayer — Kramer (1996) Ch.7; Schnabel-Lysmer-Seed (1972) SHAKE
nonlinear-site-response — Kramer Ch.7; DEEPSOIL; IS 1893/ASCE 7/EC8 spectrum overlay
effective-stress-liquefaction — Hashash et al. (2020) DEEPSOIL v7 Eq. 4.10/4.30/4.31
climate-zone-eicm — Köppen-Geiger zones; AASHTO MEPDG Manual of Practice §3
staged-excavation-wall — Hetényi (1946); CIRIA C760 §5; Padfield & Mair (CIRIA 104)
bearing-capacity-reliability — IS 6403; EC7 characteristic value; Phoon & Kulhawy (1999)
foundation-analysis — IS 2131 → IS 6403 → IS 8009 full chain
Three of these are numerical column/beam solvers whose interior decimals are not traceable to
a published worked example by hand. They are anchored on the quantities that ARE citable —
`T = 4H/V_s`, the travel-time average `H/Σ(h_i/V_si)`, the IS 1893 spectrum, the EC7 5th
percentile, Rankine K_a/K_p — plus internal closures and physical bounds. That is stated
rather than papered over with an invented expected value.
Overrides go through the validating `run()`: every select option was read from the registry
before use.
| Test block (the published value it checks) | Verdict |
| site-response-multilayer reports both the exact and quarter-wavelength periods | Pass |
| nonlinear-site-response uses T = 4H/V_s and overlays the code spectrum | Pass |
| effective-stress-liquefaction keeps r_u bounded and its outputs mutually consistent | Pass |
| climate-zone-eicm returns distinct, physically ordered values for all six zones | Pass |
| staged-excavation-wall uses Rankine K_a/K_p and keeps the wall check consistent | Pass |
| bearing-capacity-reliability takes the EC7 characteristic value as the 5th percentile | Pass |
| foundation-analysis takes the LESSER of shear and settlement capacity at every width | Pass |
site-response-eql-web-validation.test.ts
Validation for the equivalent-linear site-response engine + G/Gmax–damping curve library (`site-response-eql.ts`, `gmax-damping-curves.ts`).
Analyses validated: site-response-eql · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the equivalent-linear site-response engine + G/Gmax–damping
curve library (`site-response-eql.ts`, `gmax-damping-curves.ts`).
the release rules ≥20-cited-value gate. Each assertion traces to a published source:
- Vucetic & Dobry (1991) JGE 117(1) Figs 1–2 — G/Gmax & D vs PI (digitised).
- Seed & Idriss (1970) EERC 70-10 — sand mean G/Gmax & D.
- Darendeli (2001) UT-Austin PhD — reference-strain model γr, D_min, curvature.
- Seed & Idriss (1970) — effective-strain ratio R_γ = (M−1)/10.
- Kramer (1996) §7 — period lengthening & de-amplification of strong motion;
reduction to the linear transfer function at low strain.
| Test block (the published value it checks) | Verdict |
| Vucetic-Dobry (1991): G/Gmax anchors at γ = 0.1% vs PI | Pass |
| Vucetic-Dobry (1991): damping anchors at γ = 0.1% vs PI | Pass |
| Vucetic-Dobry: small-strain plateau and large-strain degradation | Pass |
| Seed-Idriss (1970) sand: mean G/Gmax and damping anchors | Pass |
| Darendeli (2001): reference strain and D_min for PI=0, 1 atm | Pass |
| Darendeli (2001): G/Gmax = 0.5 at γ = γr (definition of the reference strain) | Pass |
| EQL reduces to the linear transfer function at very low input | Pass |
| EQL lengthens the period and de-amplifies under strong motion (Kramer §7) | Pass |
| EQL effective-strain ratio R_γ tracks magnitude (Seed-Idriss) | Pass |
| EQL input validation | Pass |
| EQL small-strain fundamental period = 4H/Vs (Kramer Eq 7.16 + Ex 7.1/7.2) | Pass |
site-response-fe-1d-web-validation.test.ts
WEB-VALIDATION for the 1-D site-response FE by Newmark-β time integration (`site-response-fe-1d.ts`).
Analyses validated: site-response · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-VALIDATION for the 1-D site-response FE by Newmark-β time integration
(`site-response-fe-1d.ts`). the release rules gate — every value below traces to an
independent closed form / textbook.
A. NEWMARK-β integrator vs the SDOF closed forms (Chopra, "Dynamics of
Structures" §3.2): the steady-state deformation-response factor
Rd(r,ζ) = 1/√[(1−r²)² + (2ζr)²], r = ω/ωn.
• r=1 (resonance): Rd = 1/(2ζ) = 10.000 (ζ=0.05)
• r=0.5: Rd = 1.33038
• r=2.0: Rd = 0.33260
• r→0 (static): Rd → 1.0
B. SITE amplification vs Kramer, "Geotechnical Earthquake Engineering" Ch. 7
(uniform damped layer on rigid rock, vertically-propagating SH waves):
• fundamental frequency f1 = Vs/(4H) (Eq. 7.13)
• resonant frequencies fn = (2n−1)·Vs/(4H)
• peak surface/base amp |A(ωn)| = 1/[ζ(2n−1)π/2] (Eq. 7.20)
n=1 → 2/(πζ) = 12.7324 · n=2 (f=3f1) → 2/(3πζ) = 4.2441
(the mode-1 factor is the shear-beam participation 4/π times the SDOF
transmissibility 1/2ζ — 4/π·1/2ζ = 2/(πζ).)
• low-frequency limit A → 1 (surface rides with the base).
C. Rayleigh damping coefficients (Chopra Eq. 11.4.9):
a0 = 2ζ·ωi·ωj/(ωi+ωj), a1 = 2ζ/(ωi+ωj).
D. Internal consistency: the Newmark TIME-domain steady-state surface/base
ratio at f1 must reproduce the frequency-domain transfer function (and the
Kramer closed form) — proves the integrator, not just the FD solve.
| Test block (the published value it checks) | Verdict |
| A1. Newmark SDOF resonance r=1 → Rd = 1/(2ζ) = 10.000 (Chopra §3.2) | Pass |
| A2. Newmark SDOF r=0.5 → Rd = 1.33038 (Chopra §3.2) | Pass |
| A3. Newmark SDOF r=2.0 → Rd = 0.33260 (Chopra §3.2) | Pass |
| A4. Newmark SDOF quasi-static r=0.1 → Rd → 1.0 (Chopra §3.2) | Pass |
| A5. Newmark undamped free vibration preserves period + amplitude | Pass |
| B1. fundamental frequency f1 = Vs/(4H) = 2.00 Hz (Kramer Eq. 7.13) | Pass |
| B2. peak mode-1 amplification = 2/(πζ) = 12.7324 (Kramer Eq. 7.20) | Pass |
| B3. 2nd resonance at f2 = 3·f1 = 6.0 Hz, amp = 2/(3πζ) = 4.2441 (Kramer) | Pass |
| B4. low-frequency limit → amplification ≈ 1 (surface rides the base) | Pass |
| B5. second uniform site Vs=180, H=30 → f1 = 1.50 Hz (Kramer Eq. 7.13) | Pass |
| C1. Rayleigh a0,a1 match the closed form and give ζ at both controls | Pass |
| D1. Newmark time-domain surface/base ratio at f1 = FD transfer fn ≈ 2/(πζ) | Pass |
| E1. computeSiteResponseFE1D reports f1, peak amp and runs a base motion | Pass |
| E2. edge cases: invalid inputs surface errors, not NaN | Pass |
site-response-web-validation.test.ts
Formula-fidelity validation against Kramer, "Geotechnical Earthquake Engineering" Ch.7 -- the classical single-layer, vertically-propagating SH-wave transfer function on an elastic half-space.
Analyses validated: site-response · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against Kramer, "Geotechnical Earthquake
Engineering" Ch.7 -- the classical single-layer, vertically-propagating
SH-wave transfer function on an elastic half-space. Every quantity here
(travel-time period T0=4H/Vs, resonant frequencies fn=(2n-1)Vs/4H, the
impedance ratio, and the damped peak amplification) is a fully closed-form
textbook equation, hand-computed independently in Python and matched to
full precision.
| Test block (the published value it checks) | Verdict |
| [1-2] fundamental period T0=4H/Vs=0.4s, fundamental frequency f0=1/T0=2.5Hz | Pass |
| [3] resonant frequencies fn=(2n-1).Vs/(4H) for n=1,2,3: 2.5, 7.5, 12.5 Hz | Pass |
| [4] impedance ratio alpha = (rho_soil.Vs_soil)/(rho_rock.Vs_rock) matches exactly: 0.215311 | Pass |
| [5] peak damped amplification A_max = 1/(alpha + (pi/2).xi) matches exactly: 3.403087 | Pass |
| [6] surface PGA equals rock PGA times the peak amplification exactly | Pass |
| [7] a softer soil column (lower impedance ratio) produces MORE amplification -- the classical soft-site resonance danger | Pass |
| [8] a deeper soil layer lowers the fundamental frequency (longer period), all else equal | Pass |
| [9] more damping reduces the peak amplification, all else equal | Pass |
| [10] the amplification spectrum starts at exactly 1.0 at zero frequency (no dynamic effect at DC) | Pass |
| [11] a bedrock softer than the soil column is refused (Vs_rock >= Vs_soil is required for the model to be physically meaningful) | Pass |
| [12] invalid inputs (zero thickness, zero Vs, damping outside [0,1)) are refused | Pass |
spectral-matching-web-validation.test.ts
Validation for the RSPMatch-style time-domain spectral matcher (`spectral-matching.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the RSPMatch-style time-domain spectral matcher (`spectral-matching.ts`).
The matcher adjusts a seed accelerogram with tapered-cosine wavelets so its 5%-damped
response spectrum tracks a target design spectrum, while preserving the non-stationary
character (PGA, Arias build-up, duration) of the seed.
Anchors (a synthetic broadband seed matched to a plateau-then-1/T target spectrum):
1. matching DRAMATICALLY reduces the spectral misfit vs the seed;
2. over the well-resolved period range T ≥ 0.5 s the match is within ~10 % (typically
a few %) — the structural/site period band that governs design;
3. no baseline drift — the matched motion's final velocity ≈ 0;
4. non-stationarity preserved — PGA and Arias intensity stay the same order as the seed;
5. deterministic (same seed + target ⇒ same matched motion).
Honest scope: very short periods (T < ~0.3 s, approaching the sampling/high-frequency
limit) converge less tightly with the tapered-cosine wavelet — a known RSPMatch trait
(the Al Atik & Abrahamson 2010 improved wavelet is required for <5 % everywhere).
Refs: Abrahamson (1992); Hancock et al. (2006) JEE 10; Al Atik & Abrahamson (2010) JEE 14.
| Test block (the published value it checks) | Verdict |
| spectral matching dramatically reduces the misfit vs the seed | Pass |
| match is within ~10% over the well-resolved period range T ≥ 0.5 s | Pass |
| matched motion has no baseline drift (final velocity ≈ 0) | Pass |
| non-stationarity preserved: PGA and Arias stay the same order as the seed | Pass |
| deterministic: same seed + target ⇒ identical matched motion | Pass |
| config wrapper returns misfit in % and preserves the record length | Pass |
topographic-amplification-web-validation.test.ts
WEB-BENCHMARK validation for the 2-D topographic-amplification (SH ridge/crest) engine.
Analyses validated: site-response-multilayer, topographic-amplification · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the 2-D topographic-amplification (SH ridge/crest) engine.
S_T = crest motion / free-field motion is reported as the PEAK over a frequency sweep — the
design definition used by EC8, Ashford-Sitar and Bouckovalas-Papadimitriou (topographic
amplification is frequency-dependent and peaks at a geometry-set resonance).
CITED SOURCES (web-researched, 2026-07):
- EN 1998-5:2004 (Eurocode 8 Part 5) Annex A: slope < 15° → S_T = 1.0; isolated cliffs/slopes
15–30° → S_T ≥ 1.2; ridges (crest ≪ base) with slope > 30° → S_T ≥ 1.4; S_T decays linearly
to 1.0 at the base; ×≥1.2 with a loose surface layer. [CEN EN 1998-5:2004 Annex A]
- Trifunac, M.D. (1972/73) "Scattering of plane SH waves by a semi-cylindrical canyon", EESD
1:267 — rigorous analytical ceiling: convex-topography surface amplification < 2.
- Geli, Bard & Jullien (1988) BSSA 78(1):42 — isolated-ridge crest/base amplification ≈ 2 at
resonance (wavelength ≈ ridge width), overall range ~1.2–2.5.
- Ashford & Sitar (1997) BSSA 87(3):701 & Ashford-Sitar (2002): steep slopes amplify; slope
> 60° → topographic amplification factor ≈ 1.5; crest response > 1.5× free-field at resonance.
- Bouckovalas & Papadimitriou (2005) SDEE 25:547 — aggravation 1.2–1.5 for slope i > 17°;
≈ 1.0 below the threshold.
A ridge flank rises H over half-width b, so the slope angle is atan(H/b): H/b = tan15°=0.268,
tan30°=0.577, tan45°=1.0, tan60°=1.732.
| Test block (the published value it checks) | Verdict |
| topo web EC8: flat surface S_T = 1.00 across geometries (3 cases) | Pass |
| topo web Trifunac: S_T < 2 for every ridge shape (6 cases, incl. steep) | Pass |
| topo web EC8: 15°–30° slopes give S_T ≥ 1.2 (4 cases) | Pass |
| topo web EC8: >30° ridges give S_T ≥ 1.4 (3 cases) | Pass |
| topo web Ashford-Sitar: steep ridges (60°, 70°) amplify 1.4–2.0, never de-amplify | Pass |
| topo web EC8: gentle ridges (slope ~6°, ~10°) ⇒ S_T ≈ 1.0–1.25 | Pass |
| topo web: S_T rises monotonically with slope angle (5°→10°→20°→30°→45°) | Pass |
| topo web EC8: crest is the surface-profile peak, base ≈ free-field | Pass |
| topo web Geli: resonant crest amplification is in the 1.3–2.0 band for a steep ridge | Pass |
| topo web: dimensionless frequency η at the peak is reported and physical (0.3–2) | Pass |
vs-liquefaction-web-validation.test.ts
Validation for the shear-wave-velocity liquefaction-triggering engine (`vs-liquefaction.ts`, Andrus & Stokoe 2000 simplified procedure as adopted by the NCEER workshop).
Analyses validated: vs-liquefaction · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the shear-wave-velocity liquefaction-triggering engine (`vs-liquefaction.ts`,
Andrus & Stokoe 2000 simplified procedure as adopted by the NCEER workshop).
PUBLISHED SOURCES (all three opened and read for this suite):
- Youd, T.L. & Idriss, I.M. (2001), "Liquefaction Resistance of Soils: Summary Report from the
1996 NCEER and 1998 NCEER/NSF Workshops", J. Geotech. Geoenviron. Eng. ASCE 127(10) 817-833:
Table 3 (magnitude scaling factors, Idriss column = Eq. 24), p. 825 text (CRR = 0.033 at
V_s1 = 100 m/s; V*_s1 varying linearly from 215 m/s at FC <= 5 % to 200 m/s at FC >= 35 %).
- Andrus, R.D., Stokoe, K.H. & Chung, R.M. (1999), "Draft Guidelines for Evaluating Liquefaction
Resistance Using Shear Wave Velocity Measurements and Simplified Procedures", NISTIR 6277, NIST,
Gaithersburg (public domain): Tables 2.1, 3.2, 3.3, 3.4 and the worked case studies of §5.2
(Treasure Island Fire Station, Marina District School; Loma Prieta 1989, Mw 7).
- Andrus, R.D., Stokoe, K.H., Chung, R.M. & Juang, C.H. (2003), "Guidelines for Evaluating
Liquefaction Resistance Using Shear Wave Velocity Measurements and Simplified Procedures",
NIST GCR 03-854: §3.1 worked example (Eqs. 3.1-3.5), Tables E.2, E.3 (same sample
calculations, final edition).
WHAT IS A PUBLISHED ANSWER HERE. Every expected number below is printed in one of those documents
(table entry, worked-example result, or sentence) and is quoted with its locator. Nothing is
computed by this engine or by hand to make a test pass. Inputs are the documents' own printed
inputs (V_s, σ_v, σ'_v, depth, a_max, Mw, FC).
TOLERANCES (set from the sources' own rounding and conventions; none loosened after the fact):
- The worked examples print V_s1 as a whole m/s, CSR to 2-3 decimals and CRR / FS to 2-3
decimals from UNROUNDED intermediates, so recomputing from the printed (rounded) inputs differs
by the input rounding: V_s printed as a whole number (±0.5 m/s => V_s1 ±0.5 m/s).
- r_d: the sources read r_d from the Seed & Idriss (1971) average curve to 2 decimals; this engine
uses the Liao & Whitman (1986) relation adopted by NCEER (Youd 2001). The two curves agree to
0.01 at these depths (< 7 m), so the tolerance is one unit of the printed second decimal.
- MSF: Youd 2001 Table 3 lists the revised-Idriss factors to 2 decimals as communicated by Idriss,
while its own Eq. 24 (which this engine uses) gives e.g. 2.214 at Mw 5.5 against the printed 2.20
— a difference inside the source, 0.6 % at most. The tolerance 0.015 is that difference, not a
free parameter.
- Marina District FS: the 1999 report quotes a_max as "about 0.15 g, the average of" 0.13 g and
0.16 g (i.e. 0.145-0.15 g), so a published FS inherits ±3.4 % from the input alone; the
tolerance there is 3.5 %.
| Test block (the published value it checks) | Verdict |
| Youd & Idriss (2001) Table 3 — revised Idriss MSF at Mw 5.5 … 8.5 | Pass |
| Youd & Idriss (2001) p. 825 — CRR_7.5 = 0.033 at V_s1 = 100 m/s (clean sand) | Pass |
| Youd & Idriss (2001) p. 825 — V*_s1 = 215 m/s (FC ≤ 5 %) … 200 m/s (FC ≥ 35 %) | Pass |
| Treasure Island crosshole, 4.57 m — V_s1, V*_s1, CSR, CRR and F_S of the worked example | Pass |
| Treasure Island crosshole, 5.49 m — Table 3.2 row 2 (V_s1 150 m/s, r_d 0.96) | Pass |
| Treasure Island crosshole, 6.40 m — Table 3.2 row 3 (V_s1 158 m/s, r_d 0.95, CSR 0.14) | Pass |
| Treasure Island SASW, 5.34 m — Table 3.3 (V_s1 149 m/s, r_d 0.96) and the F_S = 0.75 minimum | Pass |
| Marina District School, 3.02 m — Table 3.4 row 1 (V_s1 104 m/s, r_d 0.98, CSR 0.10) and F_S = 0.42 | Pass |
| Marina District School, 3.94 m — Table 3.4 row 2 (V_s1 156 m/s, r_d 0.97, CSR 0.11) and F_S = 0.90 | Pass |
Constitutive models and element tests
FE kernel registry — 48 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-verif-cavity-pressure | normalised cavity pressure p/c at (a − a0)/a0 = 4 (also 0.4 / 1.2 / 2.8 within 0.15 %) [-] | PLAXIS-Verification-Cylindrical-cavity-expansion.pdf, p. 3 (Verification, small displacements; Figure 4) | — | 7.6846 | 7.6812 | — | −0.04 % | Pass |
plaxis-verif-cavity-rp | radius of the plastic zone at a = 5 m (outermost plastic integration point) [m] | PLAXIS-Verification-Cylindrical-cavity-expansion.pdf, p. 3 (Table 1, small displacements) | 28.01 | 28.28 | 28.003 | −0.03 % | −0.99 % | Pass |
plaxis-verif-cavity-large-pressure | normalised cavity pressure p/c at (a − a0)/a0 = 4, updated mesh (worst step over the curve −0.22 %) [-] | PLAXIS-Verification-Cylindrical-cavity-expansion.pdf, p. 3 (Verification, large displacements; Figure 4) | — | 5.5668 | 5.5628 | — | −0.07 % | Pass |
plaxis-verif-cavity-large-rp | radius of the plastic zone at a = 5 m, current configuration (outermost plastic integration point) [m] | PLAXIS-Verification-Cylindrical-cavity-expansion.pdf, p. 3 (Table 1, large displacements) | 48.85 | 49.11 | 48.74 | −0.23 % | −0.76 % | Pass |
plaxis-verif-biaxial-leself-check | ux / uy of the corner nodes [mm] | PLAXIS-Verification-Biaxial-compression-linear-elastic.pdf, p. 1–2 | −0.9375 / 0.3125 … | identical | identical to 1e-13 | 0.00 % | 0.00 % | Pass |
plaxis-verif-biaxial-shear | γxy [-] | PLAXIS-Verification-Biaxial-shearing-linear-elastic.pdf, p. 1–2 | 0.0025 | 0.0025 | 0.0025 | 0.00 % | 0.00 % | Pass |
plaxis-verif-biaxial-mc | failure σ1 (load control) [kPa] | PLAXIS-Verification-Biaxial-Mohr-Coulomb.pdf, p. 1–3 | -6.4641 | -6.4641 | -6.4641 | 0.00 % | 0.00 % | Pass |
k5b-hs-triaxial-element-compression | HS drained triaxial compression: σ'1 at failure (σ'3 = −100 kPa) [kPa] | PLAXIS-Verification-Triaxial-Hardening-Soil-2018.pdf, p. 2–3 (Table 1) | -372.86 | -372.86 | -372.859 | +2.0e-4 % | +2.0e-4 % | Pass |
k5b-hs-triaxial-element-extension | HS drained triaxial extension: σ'1 at failure [kPa] | PLAXIS-Verification-Triaxial-Hardening-Soil-2018.pdf, p. 2–3 (Table 1) | -26.06 | -26.06 | -26.0579 | +8.1e-3 % | +8.1e-3 % | Pass |
k5b-hs-triaxial-fe-compression | HS triaxial through the FE solver: σ'1 at failure (stops at λ 0.779598 of −100 → −450; honest collapse) [kPa] | PLAXIS-Verification-Triaxial-Hardening-Soil-2018.pdf, p. 1–3 | -372.86 | -372.86 | -372.859 | +3.0e-4 % | +3.0e-4 % | Pass |
k5b-hs-triaxial-fe-extension | HS triaxial extension through the FE solver: σ'1 at failure (λ 0.739421) [kPa] | PLAXIS-Verification-Triaxial-Hardening-Soil-2018.pdf, p. 1–3 | -26.06 | -26.06 | -26.058 | +7.7e-3 % | +7.7e-3 % | Pass |
k5b-hs-hyperbola-e50 | HS drained triaxial at σ'3 = −pref, normally consolidated (cap active — the STANDARD test): secant E50 at qf/2 (and, with the cap out of the way, max |ε1 − hyperbola of the internal Ei^ref|/ε1 up to 0.55 qf) [kPa] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/), p. ch. 6, Eqs 6-1…6-5 | — | 20000 | 19999.6 | — | −2.0e-3 % | Pass |
k5b-hs-small-dss-reloading | HS small: simple-shear secant G(γ) = G0/(1 + 0.385 γ/γ0.7) (worst relative error) [-] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/); Benz 2007 App. A, p. ch. 7, Eqs 7-1…7-6 | — | 0 | 7.000e-15 | — | — | Pass |
k5b-hs-small-triaxial-failure | HS small (G0ref 3 Gur, γ0.7 1e-4) drained triaxial: σ'1 at failure [kPa] | PLAXIS-Verification-Triaxial-Hardening-Soil-2018.pdf, p. 2–3 | -372.86 | -372.86 | -372.859 | +2.0e-4 % | +2.0e-4 % | Pass |
k5b-ss-isotropic-lambda-kappa | Soft Soil isotropic NC compression / unloading: recovered λ*, κ* (input 0.1055 / 0.01635) [-] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/), p. ch. 10, Eqs 10-1…10-3 | — | 0.1055 / 0.01635 | 0.105515 / 0.016335 | — | — | Pass |
k5b-ss-oedometer-k0ncself-check | Soft Soil oedometer: σ'h/σ'v on the NC line [-] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/), p. ch. 10, Eq. 10-8 (M from K0nc) | — | 0.61 | 0.609978 | — | −3.6e-3 % | Pass |
k5b-ssc-isotropic-creep | Soft Soil Creep: isotropic creep strain at 1012 d under constant p' (backward Euler, 5 % growing steps) [-] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/), p. ch. 11, Eqs 11-1…11-9 | — | 0.027681 | 0.027585 | — | −0.35 % | Pass |
k5b-ssc-haney-pp | Haney clay: p_p^eq after POP 432.4 initialisation [kPa] | PLAXIS-Verification-Soft-Soil-Creep-Haney-clay-2018.pdf, p. 2 | 373 | — | 372.99 | −2.7e-3 % | — | Pass |
k5b-ssc-haney-rate-effectself-check | Haney clay undrained triaxial peak q at 0.00094 / 0.15 / 1.10 %/min [kPa] | PLAXIS-Verification-Soft-Soil-Creep-Haney-clay-2018.pdf, p. 1–5 (Fig. 2: curves only) | — | — | A: 269.7; B: 327.3; C: 353 | — | — | Pass |
k5b-mcc-undrained-nc | MCC undrained triaxial on NC clay (p'0 200, λ 0.25, κ 0.05, M 0.9): p' at critical state [kPa] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/); Wood 1990 §7, p. ch. 8 | — | 114.87 | 114.859 | — | −9.1e-3 % | Pass |
k5b-hb-envelope | Hoek–Brown triaxial strength at σ3 = 0, −1, −5, −15 MPa (GSI 50, mi 10, σci 30 MPa): max relative miss [-] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/); Hoek, Carranza-Torres & Corkum 2002, p. ch. 4, Eqs 4-1…4-4 | — | 0 | < 1e-6 (asserted) | — | — | Pass |
k5b-ngi-adp-strengthsself-check | NGI-ADP plane-strain strengths s_u^A / s_u^P / s_u^DSS (input 50 / 25 / 35) [kPa] | PLAXIS_2D_Material_Models_Manual.pdf (2025.1; _new_2026-06-30/); Grimstad, Andresen & Jostad 2012, p. ch. 9 | — | 50 / 25 / 35 | 50.0000 / 25.0000 / 35.0000 | — | — | Pass |
k5b-tangent-check | consistent tangent vs central FD, worst relative error (4×4 through Plane<M>; 6×6 on fully 3-D states) [-] | kernel | — | 0 | 4x4 worst: 2.400e-7; 6x6 HS: 2.800e-8; HSs: 2.500e-8; SS: 2.800e-7; SSC: 2.800e-7; MCC: 9.800e-8; HB: 3.900e-9; NGI-ADP: 1.200e-9 | — | — | Pass |
k5b-return-robustness | random-state return-mapping sweep: failed returns per 4000 (HS, HSs, SS, SSC, MCC, HB, HB ψ, NGI-ADP) [-] | kernel | — | 0 | 0 | — | — | Pass |
k5a-einc-column | top settlement of a confined column with E(y) = E_ref + E_inc (y_ref − y) [m] | — | — | 0.0204028 | 0.0204028 | — | 0.00 % | Pass |
k5a-arc-length-biaxial-limit | limit load factor ΣMstage of the load-controlled bi-axial MC test under arc-length control [-] | PLAXIS-Verification-Biaxial-Mohr-Coulomb.pdf, p. 1–2 | — | 0.607122 | 0.607122 | — | 0.00 % | Pass |
k5a-mc-principal-tangentself-check | consistent tangent of the principal-space MC + tension cut-off return, non-associated (φ/ψ/σt = 30/0/0, 32/2/0, 25/0/1, 35/10/0) vs central FD and AD [|ΔD|/E] | — | — | 1.000e-6 | 5.430e-7 | — | — | Pass |
k5d1-hb-strength-factorisationself-check | Hoek–Brown Safety reduction f = σ3 − σ1 − f̄(σ3)/η(σ3): the reduced envelope is the local tangent Mohr–Coulomb reduced by ΣMsf [-] | PLAXIS-2D-2025.1-Reference-Manual §7.4.5.2, p. Eqs. 7-10…7-13 (p. 319) | — | 1.000e-6 | — | — | — | Pass |
v-hs-published-curve-1self-check | HS-1 εv medium (drained TC, MMM Fig 13.3): max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM 2015 Figs 13.2–13.5 | — | 1 | 2.452 | — | — | Deviation |
v-hs-published-curve-2self-check | HS-1 εv dense: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM 2015 Figs 13.2–13.5 | — | 1 | 1.347 | — | — | Deviation |
v-hs-published-curve-3self-check | HS-4 εv dense (Hostun): max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM 2025.1 Figs 17-9/17-10 | — | 1 | 1.001 | — | — | Deviation |
v-hs-published-curve-4self-check | HS-2 q medium (undrained): max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 3.595 | — | — | Deviation |
v-hs-published-curve-5self-check | HS-2 q dense: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 3.704 | — | — | Deviation |
v-hs-published-curve-6self-check | HS-2 P_excess medium: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 1.334 | — | — | Deviation |
v-hs-published-curve-7self-check | HS-2 P_excess dense: max normalised distance to the published markers (rule ≤ 1) [-] | PLAXIS-2D-Material-Models-Manual.pdf, p. MMM Figs 13.4/13.5 | — | 1 | 7.456 | — | — | Deviation |
v-hs-published-curve-8self-check | HSS-1 G dense σ3 100 kPa (Benz 2007 Fig 8.2/8.3): max normalised distance to the published markers (rule ≤ 1) [-] | benz-2007-small-strain-stiffness-of-soils-numerical-consequences.pdf, p. Benz 2007 Figs 8.2/8.3 | — | 1 | 1.562 | — | — | Deviation |
v-hs-published-curve-9self-check | HSS-1 G loose σ3 100 kPa: max normalised distance to the published markers (rule ≤ 1) [-] | benz-2007-small-strain-stiffness-of-soils-numerical-consequences.pdf, p. Benz 2007 Figs 8.2/8.3 | — | 1 | 2.765 | — | — | Deviation |
geostudio-sigmaw-transversely-isotropic-amadei | wall displacement and tangential stress around a hole in transversely isotropic rock, vs the Amadei closed form [-] | RS2 Stress Analysis Verification Manual (Rocscience), §8, plus Amadei (1983) / Lekhnitskii (1963) closed form, p. §8 | — | — | — | — | +0.18 % | Pass |
geostudio-sigmaw-bbm-lambda-suction-alonso | lambda(s) for suction s = 0.04 / 0.06 / 0.09 MPa [-] | Alonso, Gens & Josa (1990) Geotechnique 40(3), Fig 17(b) p.421-422 and Table 1 p.424, p. Fig 17(b) p.421-422; Table 1 p.424 | — | 0.06 | 0.0601 | — | +0.17 % | Pass |
geostudio-sigmaw-bbm-lc-yield-alonso | LC yield-curve preconsolidation pressure p0(s) for s = 0.06 / 0.09 MPa [kPa] | Alonso, Gens & Josa (1990) Geotechnique 40(3), Fig 17(b) p.421-422 and Table 1 p.424, p. Fig 17(b) p.421-422; Table 1 p.424 | — | 85 | 85.1 | — | +0.12 % | Pass |
geostudio-sigmaw-ss1-mmm-isotropic-compression | volumetric strain epsilon_v on four load steps (isotropic compression) [-] | PLAXIS 2D 2025.1 Material Models Manual §17.6 Table 17-12, p. §17.6 Table 17-12 | — | — | — | — | +2.26 % | Pass |
m17-norsand-cs-plane-strain-lode0 | NorSand drained plane-strain biaxial compression (sigma_3 constant, eps_2 = 0) to eps_1 = 150 %, dense psi_0 = -0.1 (Fig. 3.18a base set): critical stress ratio eta [-] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. App. C eq. C.7 (p. 487), App. A eqs. A.11-A.12 (p. 456); critical-state plane-strain argument: coaxial flow with eps_2 = 0 gives s_2 = 0, theta = 0 | — | 0.990034 | 0.99008 | — | +5.0e-3 % | Pass |
m17-norsand-cs-triaxial-extension | NorSand undrained triaxial EXTENSION from a loose isotropic state (psi_0 = +0.03, 200 kPa) to eps_q = 50 %: critical stress ratio eta [-] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. App. C eq. C.7 (p. 487) at theta = -30 deg (A.11, p. 456); Mohr-Coulomb relation M_te = 6 sin(phi)/(3 + sin(phi)) re-derived | — | 0.882353 | 0.88235 | — | 0.00 % | Pass |
m17-norsand-general-vs-triaxial-referenceself-check | General-stress return vs the pre-M17 triaxial integrator on 6 book paths (Fig. 3.18a drained psi_0 = -0.2, -0.1, 0, +0.04; Fig. 6.19 undrained L601, C609): max |difference| of p', q, eps_v over all output points [relative to p_0 / strain] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. Figs. 3.18a (p. 133) and 6.19 (p. 247): the curves of tests/norsand_book.rs, plus the pre-M17 integrator kept in norsand/triaxial_reference.rs | — | 0 | 7.224e-9 | — | +7.2e-7 % | Pass |
m17-norsand-brasted-plane-strain-peak-loose | NorSand drained plane strain (Cornforth apparatus, sigma_3 = 276 kPa, eps_2 = 0, K0 start), Brasted sand, loose (test A10-14): peak major principal stress sigma_1 [kPa] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. Fig. 3.23 (p. 142, PDF 164), Table 3.4 (p. 140), Table 2.1, Fig. 2.45 (p. 92) | — | 1033 | 1100 | — | +6.50 % | Deviation |
m17-norsand-brasted-plane-strain-peak-compact | NorSand drained plane strain (Cornforth apparatus, sigma_3 = 276 kPa, eps_2 = 0, K0 start), Brasted sand, compact (test A10-12): peak major principal stress sigma_1 [kPa] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. Fig. 3.23 (p. 142, PDF 164), Table 3.4 (p. 140), Table 2.1, Fig. 2.45 (p. 92) | — | 1186 | 1303 | — | +9.90 % | Deviation |
m17-norsand-brasted-plane-strain-peak-dense | NorSand drained plane strain (Cornforth apparatus, sigma_3 = 276 kPa, eps_2 = 0, K0 start), Brasted sand, dense (test A10-17): peak major principal stress sigma_1 [kPa] | books/Jefferies-Been-2016-Soil-Liquefaction-A-Critical-State-Approach-2e-CRC-712p.pdf, p. Fig. 3.23 (p. 142, PDF 164), Table 3.4 (p. 140), Table 2.1, Fig. 2.45 (p. 92) | — | 1488 | 1646 | — | +10.6 % | Deviation |
m17-norsand-fe-plane-strain-vs-elementself-check | 1 m x 1 m plane-strain T6 sample, isotropic p_0 = 100 kPa then biaxial compression (sigma_x held; drained: sigma_y +90 kPa; undrained-a with Biot K_w = 2e6 kPa: total sigma_y +36 kPa), NorSand through the phase driver vs the single-point element driver on the same load steps: worst |d eps|/|eps| over 20 steps [relative] | tests/f_norsand_fe.rs (self-consistency of the FE driver and the Gauss-point driver; not a published case) | — | 0 | 7.227e-9 | — | +7.2e-7 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
plaxis-verif-cavity-pressure — Pass · K2
Case: cases/plaxis-verification-cylindrical-cavity-expansion.json
Mesh: T15 axisymmetric, Medium, cavity wall and soil/correcting boundary refined 0.1 (domain geometry, two regions)
Reproduce: tests/k2_integration.rs plaxis_cylindrical_cavity_expansion_small_displacements
Notes: Sagaseta (1984) small-displacement solution; PLAXIS only plots it (Figure 4). The large-displacement (updated mesh) phase is row plaxis-verif-cavity-large-pressure (K8a).
plaxis-verif-cavity-rp — Pass · K2
Case: cases/plaxis-verification-cylindrical-cavity-expansion.json
Mesh: as plaxis-verif-cavity-pressure
Reproduce: tests/k2_integration.rs plaxis_cylindrical_cavity_expansion_small_displacements
Notes: A discrete measure (integration-point spacing near r = 28 m), as PLAXIS's plastic-point plot.
plaxis-verif-cavity-large-pressure — Pass · K8a
Case: cases/plaxis-verification-cylindrical-cavity-expansion-large.json
Mesh: as plaxis-verif-cavity-pressure
Reproduce: tests/k8a.rs plaxis_cylindrical_cavity_expansion_large_displacements
Notes: Sagaseta (1984) large-displacement solution (doc p. 3): p = G·F(η_r) + 2c·ln(η/η_r). Phase key largeDeformation (updated Lagrangian, Jaumann rate by Hughes & Winget 1980, geometric stiffness). p = wall force per radian / (thickness · current radius).
plaxis-verif-cavity-large-rp — Pass · K8a
Case: cases/plaxis-verification-cylindrical-cavity-expansion-large.json
Mesh: as plaxis-verif-cavity-pressure
Reproduce: tests/k8a.rs plaxis_cylindrical_cavity_expansion_large_displacements
Notes: PLAXIS 2D 2018 reports 48.85 m (−0.5 % vs theory); a discrete measure like the small-displacement row.
plaxis-verif-biaxial-le — Pass · K2a
Case: tests/model.rs
Mesh: rect-mesh T15
Reproduce: tests/model.rs plaxis_biaxial_compression_linear_elastic
Notes: K2a gate (unchanged).
plaxis-verif-biaxial-shear — Pass · K2a
Case: tests/model.rs
Mesh: rect-mesh T15
Reproduce: tests/model.rs plaxis_biaxial_shearing_linear_elastic
Notes: K2a gate (unchanged).
plaxis-verif-biaxial-mc — Pass · K2a
Case: tests/model.rs
Mesh: rect-mesh T15
Reproduce: tests/model.rs plaxis_biaxial_mohr_coulomb_load_control_fails_at_the_theoretical_stress
Notes: K2a gate. Non-associated variant (ψ = 0): modified Newton and the symmetrised tangent stay on the homogeneous branch (−6.4641); the unsymmetric Newton converges to a bifurcated equilibrium on the plateau (mean within 1 %) — ISSUES K2i-3.
k5b-hs-triaxial-element-compression — Pass · K5b
Reference: Mohr–Coulomb failure σ1 = σ3 (1+sinφ)/(1−sinφ) − 2c cosφ/(1−sinφ) (same PDF p. 3)
Case: tests/k5b_models.rs hs_plaxis_triaxial()
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs hs_plaxis_triaxial_failure
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): re-run on the doc-375 tree, value UNCHANGED (hs_plaxis_triaxial_failure −372.8592 / −26.0579; hs_small_triaxial_failure −372.8592; DSS reloading 7.0e-15; return robustness 0 / 4000 for every model). || E50ref 20000, Eoedref 20000 (cap calibrated to it), Eurref 60000, m 0.5, pref 100, c 1, φ 35°, ψ 5° (PDF p. 1); ν_ur 0.2, Rf 0.9 (PLAXIS defaults). Element test with linked lateral control (axisym ε_hoop = ε_radial).
k5b-hs-triaxial-element-extension — Pass · K5b
Reference: Mohr–Coulomb extension (same PDF p. 3)
Case: tests/k5b_models.rs hs_plaxis_triaxial()
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs hs_plaxis_triaxial_failure
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): re-run on the doc-375 tree, value UNCHANGED (hs_plaxis_triaxial_failure −372.8592 / −26.0579; hs_small_triaxial_failure −372.8592; DSS reloading 7.0e-15; return robustness 0 / 4000 for every model).
k5b-hs-triaxial-fe-compression — Pass · K5b
Reference: Mohr–Coulomb (PDF p. 3)
Case: tests/k5b_fe.rs (axisymmetric T15 rectangle, load control)
Mesh: axisymmetric T15 1 × 1 m
Reproduce: tests/k5b_fe.rs plaxis_hs_triaxial_fe_compression_and_extension (~19 s debug)
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): FE re-run on the doc-375 tree: σ1 −372.859 / −26.058 unchanged; compression now 58 load steps (was 67), extension 57 (D501: the cone no longer makes the active set singular at q = qf).
k5b-hs-triaxial-fe-extension — Pass · K5b
Reference: Mohr–Coulomb (PDF p. 3)
Case: tests/k5b_fe.rs
Mesh: axisymmetric T15 1 × 1 m
Reproduce: tests/k5b_fe.rs plaxis_hs_triaxial_fe_compression_and_extension
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): FE re-run on the doc-375 tree: σ1 −372.859 / −26.058 unchanged; compression now 58 load steps (was 67), extension 57 (D501: the cone no longer makes the active set singular at q = qf).
k5b-hs-hyperbola-e50 — Pass · K5b
Reference: E50 = E50ref at σ'3 = −pref (MMM Eq. 6-2)
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs hs_drained_triaxial_reproduces_the_hyperbola
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): quantity redefined and re-recorded 20000.0 (cap OFF: the old test checked 2E50/(2 − Rf)) → 19999.59 (NC test, cap ON). Cause: D499: Ei^ref is solved jointly with the cap, so the standard drained test returns E50 = E50ref (to 0.02 %) and primary loading is stiffer than before. Cap-off cross-check now: internal Ei^ref 42 254.9 (Eq. 6-4 would give 36 363.6), cap-off hyperbola worst error 5.3e-11 (was 2.1e-10), cap-off secant 23 240.2. The test asserts NC E50 within 2e-3 of 20 000 and the cap-off hyperbola to 1e-9. TS oracle packages/geotech/src/hs-stress-point.ts (23 285.2) now sits −14.12 % from ours (19 997.0 in k5b_models' TS table) because it still does not honour E50 with the cap — K5b-TS-HS-E50 stands. || TS oracle packages/geotech/src/hs-stress-point.ts gives 23285.2 (+16.4 %): it uses the qa/E50 (SVB Eq. 8) form, not MMM Ei = 2E50/(2 − Rf) — proposed ISSUE K5b-TS-HS-E50.
k5b-hs-small-dss-reloading — Pass · K5b
Reference: Hardin–Drnevich / Santos–Correia closed form (MMM Eq. 7-2)
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs hs_small_reloading_curve_closed_form
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): re-run on the doc-375 tree, value UNCHANGED (hs_plaxis_triaxial_failure −372.8592 / −26.0579; hs_small_triaxial_failure −372.8592; DSS reloading 7.0e-15; return robustness 0 / 4000 for every model). || Benz's plateau on the first increment; history stored without the +100 δ offset (no cancellation).
k5b-hs-small-triaxial-failure — Pass · K5b
Reference: Mohr–Coulomb
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs hs_small_triaxial_failure_matches_hs
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): re-run on the doc-375 tree, value UNCHANGED (hs_plaxis_triaxial_failure −372.8592 / −26.0579; hs_small_triaxial_failure −372.8592; DSS reloading 7.0e-15; return robustness 0 / 4000 for every model).
k5b-ss-isotropic-lambda-kappa — Pass · K5b
Reference: MMM Eq. 10-1/10-2
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs ss_isotropic_compression_and_oedometer
Notes: within 0.02 % / 0.1 %.
k5b-ss-oedometer-k0nc — Pass · K5b
Reference: input K0nc (MMM Eq. 10-8 calibrates M to it)
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs ss_isotropic_compression_and_oedometer
k5b-ssc-isotropic-creep — Pass · K5b
Reference: μ* ln(1 + t/τ) (MMM Eq. 11-4)
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs ssc_isotropic_creep_closed_form
Notes: Worst relative miss over the history 7.3e-3 (time discretisation). TS oracle soft-soil-creep.ts at 1000 d: 0.0276351 (closed 0.0276350).
k5b-ssc-haney-pp — Pass · K5b
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs ssc_haney_clay_undrained_rate_effect
k5b-ssc-haney-rate-effect — Pass · K5b
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs ssc_haney_clay_undrained_rate_effect
Notes: PLAXIS plots the curves only (Fig. 2); asserted: the faster test is the stronger (PDF p. 3). Undrained = constant-volume element.
k5b-mcc-undrained-nc — Pass · K5b
Reference: p'f = p'0 (1/2)^Λ, Λ = (λ−κ)/λ (closed form)
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs mcc_undrained_triaxial_nc_closed_form
Notes: TS oracle cam-clay-triaxial.ts 114.86845. qf 103.3734 (analytic 103.3829). Miss = end-of-test strain (not exactly at CS).
k5b-hb-envelope — Pass · K5b
Reference: σ1 = σ3 − σci (−mb σ3/σci + s)^a
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs hb_triaxial_strength_envelope
Notes: mb 1.676772, s 3.865920e-3, a 0.505734 (asserted vs HCC 2002).
k5b-ngi-adp-strengths — Pass · K5b
Reference: input anisotropic strengths
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs ngi_adp_plane_strain_strengths
Notes: DSS failure strain 0.03500 (input 3.5 %).
k5b-tangent-check — Pass · K5b
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs consistent_tangents_against_finite_differences, consistent_tangents_6d_against_finite_differences
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): HS 6x6 3.2e-8 → 2.8e-8, HSs 6x6 4.0e-8 → 2.5e-8 (HS-small plastic 4x4 case 1.97e-8: the new h_i = Gm^(1+Eur/Ei) column of Benz 7.33/7.34 is in the tangent; HS 4x4 cases 2.2e-10 … 6.2e-8). Other entries re-measured unchanged (4x4 worst 2.4e-7 = SSC no-time, SS 2.8e-7, SSC 2.8e-7, MCC 9.8e-8, HB 3.9e-9, NGI-ADP 1.2e-9); gate 1e-6.
k5b-return-robustness — Pass · K5b
Mesh: element (single stress point, adv/soiltest.rs)
Reproduce: tests/k5b_models.rs return_mapping_robustness_sweep
Notes: D525 re-record (2 Nov 2026, after the HS-family fix, doc 375 §11 — D499 E50 honoured / D501 cone shadowed by MC / D500 Benz 7.33-7.34 / D527 cap_dh): re-run on the doc-375 tree, value UNCHANGED (hs_plaxis_triaxial_failure −372.8592 / −26.0579; hs_small_triaxial_failure −372.8592; DSS reloading 7.0e-15; return robustness 0 / 4000 for every model).
k5a-einc-column — Pass · K5a
Reference: ∫ q / M(y) dy (closed form, MM 2025.1 Eq. 3-16)
Case: (test fixture: tests/k5_solver.rs)
Reproduce: cargo test -p tbk-core --test k5_solver stiffness_increasing_with_depth -- --nocapture
Notes: 2e-11 relative.
k5a-arc-length-biaxial-limit — Pass · K5a
Reference: σ1 = −6.4641 (MC closed form)
Case: (test fixture: tests/k5_solver.rs)
Reproduce: cargo test -p tbk-core --test k5_solver arc_length -- --nocapture
Notes: arcLength on / auto: the limit is reported as COLLAPSE (singular tangent at the peak, no equilibrium beyond it); off: the K2 honest non-convergence. The load-advancement criterion fails in all three (the phase load cannot be carried).
k5a-mc-principal-tangent — Pass · K5a
Reference: FD floor (h = 1e-7)
Case: (test fixture: tests/k5_material.rs)
Reproduce: cargo test -p tbk-core --test k5_material -- --nocapture
Notes: AD worst 4e-15; ψ = 0 apex rule (Clausen 2007 Table 5.1) equals mc-plane.ts at every one of 1e5 trials (14 468 apex returns).
k5d1-hb-strength-factorisation — Pass · K5d-1
Reference: identity tan φ_r = tan φ_loc / ΣMsf, c_r = c_loc / ΣMsf at every σ3 (relative; the value is the test tolerance)
Case: (test fixture: tests/k5d1.rs)
Reproduce: cargo test -p tbk-core --test k5d1 hoek_brown_strength_factorisation -- --nocapture
Notes: Asserted < 1e-6 on a σ3 × ΣMsf grid; ψ_used capped by the reduced local friction angle (recorded choice); tension limit σt / ΣMsf.
v-hs-published-curve-1 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 2.452, unchanged. Vertex-step probe (Modal 2026-11-12T00-02-29, probe_hs_plaxis_vertex_steps; columns fine-implicit | PLAXIS-steps implicit | PLAXIS-steps start-of-step ψm | split 4/16/64): HS-1 drained loose (q, εv) fine (0.38,0.41) | impl (0.45,0.32) | EXPL (0.45,0.32) | /4 (0.38,0.39) /16 (0.38,0.40) /64 (0.38,0.41) · HS-1 drained medium (q, εv) fine (0.35,2.45) | impl (0.33,1.47) | EXPL (0.35,1.03) | /4 (0.35,1.93) /16 (0.35,2.32) /64 (0.35,2.42) · HS-1 drained dense (q, εv) fine (0.44,1.35) | impl (0.44,2.19) | EXPL (0.44,0.22) | /4 (0.44,1.06) /16 (0.44,1.27) /64 (0.44,1.33) · HS-2 undrained loose (q, P_excess) fine (0.36,0.19) | impl (0.37,0.19) | EXPL (0.37,0.19) | /4 (0.36,0.19) /16 (0.36,0.19) /64 (0.36,0.19) · HS-2 undrained medium (q, P_excess) fine (3.60,1.33) | impl (5.81,2.63) | EXPL (0.94,0.27) | /4 (2.91,0.96) /16 (3.42,1.24) /64 (3.55,1.31) · HS-2 undrained dense (q, P_excess) fine (3.70,7.46) | impl (6.58,9.16) | EXPL (0.46,1.51) | /4 (2.82,5.27) /16 (3.48,6.92) /64 (3.65,7.32) · HS-3/4 Hostun loose (q, εv) fine (0.32,0.82) | impl (0.17,0.73) | EXPL (0.17,0.73) | /4 (0.27,0.80) /16 (0.31,0.82) /64 (0.32,0.82) · HS-3/4 Hostun dense (q, εv) fine (0.31,1.00) | impl (0.31,1.65) | EXPL (0.24,0.15) | /4 (0.31,0.80) /16 (0.31,0.95) /64 (0.31,0.99). Driven along PLAXIS's own published load steps with ψm from the start of each step, every one of these curves passes except HS-1 εv medium (1.03) and HS-2 P_excess dense (1.51, whose last two published points are the polyline clipped on the figure's 0 axis); splitting the steps converges monotonically back to the converged kernel. The Undrained (A) path is ruled out as the cause: the same element run with K_w → 1e12 (constant volume) gives at −ε1 = 0.03 medium q 196.025 vs 195.845 kPa, P_excess -25.626 vs -25.698 kPa (K_w 3.6875e6 kPa); dense q 464.289 vs 464.734 kPa, P_excess 38.877 vs 39.028 kPa (K_w 4.9167e6 kPa) — the pore-fluid stiffness and the volumetric coupling change nothing; the dilatancy cut-off is not the cause (MMM 2015 §6.4 p. 74: 'By default, the Dilatancy cut-off is not active' and it 'does not help … when using the Undrained (A) drainage type … the void ratio remains constant'; §13.1 pp. 139–142 does not switch it on); ψm is MMM 2015 Eq. 6.12 (= 2025.1 Eq. 6-15) including the 3/4 sin φ rule, as the kernel; and the DRAINED εv curves fail in the same dilatant phase with the same sign (kernel dilates earlier), so the cause is common to both drainage types. Classification: reference artefact (the published curves are a coarse-step PLAXIS solution), not a kernel defect; reproducing PLAXIS's lag would need a deliberate 'explicit ψm' option — a design decision, not made. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-2 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 1.347, unchanged. Vertex-step probe (Modal 2026-11-12T00-02-29, probe_hs_plaxis_vertex_steps; columns fine-implicit | PLAXIS-steps implicit | PLAXIS-steps start-of-step ψm | split 4/16/64): HS-1 drained loose (q, εv) fine (0.38,0.41) | impl (0.45,0.32) | EXPL (0.45,0.32) | /4 (0.38,0.39) /16 (0.38,0.40) /64 (0.38,0.41) · HS-1 drained medium (q, εv) fine (0.35,2.45) | impl (0.33,1.47) | EXPL (0.35,1.03) | /4 (0.35,1.93) /16 (0.35,2.32) /64 (0.35,2.42) · HS-1 drained dense (q, εv) fine (0.44,1.35) | impl (0.44,2.19) | EXPL (0.44,0.22) | /4 (0.44,1.06) /16 (0.44,1.27) /64 (0.44,1.33) · HS-2 undrained loose (q, P_excess) fine (0.36,0.19) | impl (0.37,0.19) | EXPL (0.37,0.19) | /4 (0.36,0.19) /16 (0.36,0.19) /64 (0.36,0.19) · HS-2 undrained medium (q, P_excess) fine (3.60,1.33) | impl (5.81,2.63) | EXPL (0.94,0.27) | /4 (2.91,0.96) /16 (3.42,1.24) /64 (3.55,1.31) · HS-2 undrained dense (q, P_excess) fine (3.70,7.46) | impl (6.58,9.16) | EXPL (0.46,1.51) | /4 (2.82,5.27) /16 (3.48,6.92) /64 (3.65,7.32) · HS-3/4 Hostun loose (q, εv) fine (0.32,0.82) | impl (0.17,0.73) | EXPL (0.17,0.73) | /4 (0.27,0.80) /16 (0.31,0.82) /64 (0.32,0.82) · HS-3/4 Hostun dense (q, εv) fine (0.31,1.00) | impl (0.31,1.65) | EXPL (0.24,0.15) | /4 (0.31,0.80) /16 (0.31,0.95) /64 (0.31,0.99). Driven along PLAXIS's own published load steps with ψm from the start of each step, every one of these curves passes except HS-1 εv medium (1.03) and HS-2 P_excess dense (1.51, whose last two published points are the polyline clipped on the figure's 0 axis); splitting the steps converges monotonically back to the converged kernel. The Undrained (A) path is ruled out as the cause: the same element run with K_w → 1e12 (constant volume) gives at −ε1 = 0.03 medium q 196.025 vs 195.845 kPa, P_excess -25.626 vs -25.698 kPa (K_w 3.6875e6 kPa); dense q 464.289 vs 464.734 kPa, P_excess 38.877 vs 39.028 kPa (K_w 4.9167e6 kPa) — the pore-fluid stiffness and the volumetric coupling change nothing; the dilatancy cut-off is not the cause (MMM 2015 §6.4 p. 74: 'By default, the Dilatancy cut-off is not active' and it 'does not help … when using the Undrained (A) drainage type … the void ratio remains constant'; §13.1 pp. 139–142 does not switch it on); ψm is MMM 2015 Eq. 6.12 (= 2025.1 Eq. 6-15) including the 3/4 sin φ rule, as the kernel; and the DRAINED εv curves fail in the same dilatant phase with the same sign (kernel dilates earlier), so the cause is common to both drainage types. Classification: reference artefact (the published curves are a coarse-step PLAXIS solution), not a kernel defect; reproducing PLAXIS's lag would need a deliberate 'explicit ψm' option — a design decision, not made. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-3 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 1.001, unchanged. Vertex-step probe (Modal 2026-11-12T00-02-29, probe_hs_plaxis_vertex_steps; columns fine-implicit | PLAXIS-steps implicit | PLAXIS-steps start-of-step ψm | split 4/16/64): HS-1 drained loose (q, εv) fine (0.38,0.41) | impl (0.45,0.32) | EXPL (0.45,0.32) | /4 (0.38,0.39) /16 (0.38,0.40) /64 (0.38,0.41) · HS-1 drained medium (q, εv) fine (0.35,2.45) | impl (0.33,1.47) | EXPL (0.35,1.03) | /4 (0.35,1.93) /16 (0.35,2.32) /64 (0.35,2.42) · HS-1 drained dense (q, εv) fine (0.44,1.35) | impl (0.44,2.19) | EXPL (0.44,0.22) | /4 (0.44,1.06) /16 (0.44,1.27) /64 (0.44,1.33) · HS-2 undrained loose (q, P_excess) fine (0.36,0.19) | impl (0.37,0.19) | EXPL (0.37,0.19) | /4 (0.36,0.19) /16 (0.36,0.19) /64 (0.36,0.19) · HS-2 undrained medium (q, P_excess) fine (3.60,1.33) | impl (5.81,2.63) | EXPL (0.94,0.27) | /4 (2.91,0.96) /16 (3.42,1.24) /64 (3.55,1.31) · HS-2 undrained dense (q, P_excess) fine (3.70,7.46) | impl (6.58,9.16) | EXPL (0.46,1.51) | /4 (2.82,5.27) /16 (3.48,6.92) /64 (3.65,7.32) · HS-3/4 Hostun loose (q, εv) fine (0.32,0.82) | impl (0.17,0.73) | EXPL (0.17,0.73) | /4 (0.27,0.80) /16 (0.31,0.82) /64 (0.32,0.82) · HS-3/4 Hostun dense (q, εv) fine (0.31,1.00) | impl (0.31,1.65) | EXPL (0.24,0.15) | /4 (0.31,0.80) /16 (0.31,0.95) /64 (0.31,0.99). Driven along PLAXIS's own published load steps with ψm from the start of each step, every one of these curves passes except HS-1 εv medium (1.03) and HS-2 P_excess dense (1.51, whose last two published points are the polyline clipped on the figure's 0 axis); splitting the steps converges monotonically back to the converged kernel. The Undrained (A) path is ruled out as the cause: the same element run with K_w → 1e12 (constant volume) gives at −ε1 = 0.03 medium q 196.025 vs 195.845 kPa, P_excess -25.626 vs -25.698 kPa (K_w 3.6875e6 kPa); dense q 464.289 vs 464.734 kPa, P_excess 38.877 vs 39.028 kPa (K_w 4.9167e6 kPa) — the pore-fluid stiffness and the volumetric coupling change nothing; the dilatancy cut-off is not the cause (MMM 2015 §6.4 p. 74: 'By default, the Dilatancy cut-off is not active' and it 'does not help … when using the Undrained (A) drainage type … the void ratio remains constant'; §13.1 pp. 139–142 does not switch it on); ψm is MMM 2015 Eq. 6.12 (= 2025.1 Eq. 6-15) including the 3/4 sin φ rule, as the kernel; and the DRAINED εv curves fail in the same dilatant phase with the same sign (kernel dilates earlier), so the cause is common to both drainage types. Classification: reference artefact (the published curves are a coarse-step PLAXIS solution), not a kernel defect; reproducing PLAXIS's lag would need a deliberate 'explicit ψm' option — a design decision, not made. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-4 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 3.595, unchanged. Vertex-step probe (Modal 2026-11-12T00-02-29, probe_hs_plaxis_vertex_steps; columns fine-implicit | PLAXIS-steps implicit | PLAXIS-steps start-of-step ψm | split 4/16/64): HS-1 drained loose (q, εv) fine (0.38,0.41) | impl (0.45,0.32) | EXPL (0.45,0.32) | /4 (0.38,0.39) /16 (0.38,0.40) /64 (0.38,0.41) · HS-1 drained medium (q, εv) fine (0.35,2.45) | impl (0.33,1.47) | EXPL (0.35,1.03) | /4 (0.35,1.93) /16 (0.35,2.32) /64 (0.35,2.42) · HS-1 drained dense (q, εv) fine (0.44,1.35) | impl (0.44,2.19) | EXPL (0.44,0.22) | /4 (0.44,1.06) /16 (0.44,1.27) /64 (0.44,1.33) · HS-2 undrained loose (q, P_excess) fine (0.36,0.19) | impl (0.37,0.19) | EXPL (0.37,0.19) | /4 (0.36,0.19) /16 (0.36,0.19) /64 (0.36,0.19) · HS-2 undrained medium (q, P_excess) fine (3.60,1.33) | impl (5.81,2.63) | EXPL (0.94,0.27) | /4 (2.91,0.96) /16 (3.42,1.24) /64 (3.55,1.31) · HS-2 undrained dense (q, P_excess) fine (3.70,7.46) | impl (6.58,9.16) | EXPL (0.46,1.51) | /4 (2.82,5.27) /16 (3.48,6.92) /64 (3.65,7.32) · HS-3/4 Hostun loose (q, εv) fine (0.32,0.82) | impl (0.17,0.73) | EXPL (0.17,0.73) | /4 (0.27,0.80) /16 (0.31,0.82) /64 (0.32,0.82) · HS-3/4 Hostun dense (q, εv) fine (0.31,1.00) | impl (0.31,1.65) | EXPL (0.24,0.15) | /4 (0.31,0.80) /16 (0.31,0.95) /64 (0.31,0.99). Driven along PLAXIS's own published load steps with ψm from the start of each step, every one of these curves passes except HS-1 εv medium (1.03) and HS-2 P_excess dense (1.51, whose last two published points are the polyline clipped on the figure's 0 axis); splitting the steps converges monotonically back to the converged kernel. The Undrained (A) path is ruled out as the cause: the same element run with K_w → 1e12 (constant volume) gives at −ε1 = 0.03 medium q 196.025 vs 195.845 kPa, P_excess -25.626 vs -25.698 kPa (K_w 3.6875e6 kPa); dense q 464.289 vs 464.734 kPa, P_excess 38.877 vs 39.028 kPa (K_w 4.9167e6 kPa) — the pore-fluid stiffness and the volumetric coupling change nothing; the dilatancy cut-off is not the cause (MMM 2015 §6.4 p. 74: 'By default, the Dilatancy cut-off is not active' and it 'does not help … when using the Undrained (A) drainage type … the void ratio remains constant'; §13.1 pp. 139–142 does not switch it on); ψm is MMM 2015 Eq. 6.12 (= 2025.1 Eq. 6-15) including the 3/4 sin φ rule, as the kernel; and the DRAINED εv curves fail in the same dilatant phase with the same sign (kernel dilates earlier), so the cause is common to both drainage types. Classification: reference artefact (the published curves are a coarse-step PLAXIS solution), not a kernel defect; reproducing PLAXIS's lag would need a deliberate 'explicit ψm' option — a design decision, not made. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-5 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 3.704, unchanged. Vertex-step probe (Modal 2026-11-12T00-02-29, probe_hs_plaxis_vertex_steps; columns fine-implicit | PLAXIS-steps implicit | PLAXIS-steps start-of-step ψm | split 4/16/64): HS-1 drained loose (q, εv) fine (0.38,0.41) | impl (0.45,0.32) | EXPL (0.45,0.32) | /4 (0.38,0.39) /16 (0.38,0.40) /64 (0.38,0.41) · HS-1 drained medium (q, εv) fine (0.35,2.45) | impl (0.33,1.47) | EXPL (0.35,1.03) | /4 (0.35,1.93) /16 (0.35,2.32) /64 (0.35,2.42) · HS-1 drained dense (q, εv) fine (0.44,1.35) | impl (0.44,2.19) | EXPL (0.44,0.22) | /4 (0.44,1.06) /16 (0.44,1.27) /64 (0.44,1.33) · HS-2 undrained loose (q, P_excess) fine (0.36,0.19) | impl (0.37,0.19) | EXPL (0.37,0.19) | /4 (0.36,0.19) /16 (0.36,0.19) /64 (0.36,0.19) · HS-2 undrained medium (q, P_excess) fine (3.60,1.33) | impl (5.81,2.63) | EXPL (0.94,0.27) | /4 (2.91,0.96) /16 (3.42,1.24) /64 (3.55,1.31) · HS-2 undrained dense (q, P_excess) fine (3.70,7.46) | impl (6.58,9.16) | EXPL (0.46,1.51) | /4 (2.82,5.27) /16 (3.48,6.92) /64 (3.65,7.32) · HS-3/4 Hostun loose (q, εv) fine (0.32,0.82) | impl (0.17,0.73) | EXPL (0.17,0.73) | /4 (0.27,0.80) /16 (0.31,0.82) /64 (0.32,0.82) · HS-3/4 Hostun dense (q, εv) fine (0.31,1.00) | impl (0.31,1.65) | EXPL (0.24,0.15) | /4 (0.31,0.80) /16 (0.31,0.95) /64 (0.31,0.99). Driven along PLAXIS's own published load steps with ψm from the start of each step, every one of these curves passes except HS-1 εv medium (1.03) and HS-2 P_excess dense (1.51, whose last two published points are the polyline clipped on the figure's 0 axis); splitting the steps converges monotonically back to the converged kernel. The Undrained (A) path is ruled out as the cause: the same element run with K_w → 1e12 (constant volume) gives at −ε1 = 0.03 medium q 196.025 vs 195.845 kPa, P_excess -25.626 vs -25.698 kPa (K_w 3.6875e6 kPa); dense q 464.289 vs 464.734 kPa, P_excess 38.877 vs 39.028 kPa (K_w 4.9167e6 kPa) — the pore-fluid stiffness and the volumetric coupling change nothing; the dilatancy cut-off is not the cause (MMM 2015 §6.4 p. 74: 'By default, the Dilatancy cut-off is not active' and it 'does not help … when using the Undrained (A) drainage type … the void ratio remains constant'; §13.1 pp. 139–142 does not switch it on); ψm is MMM 2015 Eq. 6.12 (= 2025.1 Eq. 6-15) including the 3/4 sin φ rule, as the kernel; and the DRAINED εv curves fail in the same dilatant phase with the same sign (kernel dilates earlier), so the cause is common to both drainage types. Classification: reference artefact (the published curves are a coarse-step PLAXIS solution), not a kernel defect; reproducing PLAXIS's lag would need a deliberate 'explicit ψm' option — a design decision, not made. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-6 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 1.334, unchanged. Vertex-step probe (Modal 2026-11-12T00-02-29, probe_hs_plaxis_vertex_steps; columns fine-implicit | PLAXIS-steps implicit | PLAXIS-steps start-of-step ψm | split 4/16/64): HS-1 drained loose (q, εv) fine (0.38,0.41) | impl (0.45,0.32) | EXPL (0.45,0.32) | /4 (0.38,0.39) /16 (0.38,0.40) /64 (0.38,0.41) · HS-1 drained medium (q, εv) fine (0.35,2.45) | impl (0.33,1.47) | EXPL (0.35,1.03) | /4 (0.35,1.93) /16 (0.35,2.32) /64 (0.35,2.42) · HS-1 drained dense (q, εv) fine (0.44,1.35) | impl (0.44,2.19) | EXPL (0.44,0.22) | /4 (0.44,1.06) /16 (0.44,1.27) /64 (0.44,1.33) · HS-2 undrained loose (q, P_excess) fine (0.36,0.19) | impl (0.37,0.19) | EXPL (0.37,0.19) | /4 (0.36,0.19) /16 (0.36,0.19) /64 (0.36,0.19) · HS-2 undrained medium (q, P_excess) fine (3.60,1.33) | impl (5.81,2.63) | EXPL (0.94,0.27) | /4 (2.91,0.96) /16 (3.42,1.24) /64 (3.55,1.31) · HS-2 undrained dense (q, P_excess) fine (3.70,7.46) | impl (6.58,9.16) | EXPL (0.46,1.51) | /4 (2.82,5.27) /16 (3.48,6.92) /64 (3.65,7.32) · HS-3/4 Hostun loose (q, εv) fine (0.32,0.82) | impl (0.17,0.73) | EXPL (0.17,0.73) | /4 (0.27,0.80) /16 (0.31,0.82) /64 (0.32,0.82) · HS-3/4 Hostun dense (q, εv) fine (0.31,1.00) | impl (0.31,1.65) | EXPL (0.24,0.15) | /4 (0.31,0.80) /16 (0.31,0.95) /64 (0.31,0.99). Driven along PLAXIS's own published load steps with ψm from the start of each step, every one of these curves passes except HS-1 εv medium (1.03) and HS-2 P_excess dense (1.51, whose last two published points are the polyline clipped on the figure's 0 axis); splitting the steps converges monotonically back to the converged kernel. The Undrained (A) path is ruled out as the cause: the same element run with K_w → 1e12 (constant volume) gives at −ε1 = 0.03 medium q 196.025 vs 195.845 kPa, P_excess -25.626 vs -25.698 kPa (K_w 3.6875e6 kPa); dense q 464.289 vs 464.734 kPa, P_excess 38.877 vs 39.028 kPa (K_w 4.9167e6 kPa) — the pore-fluid stiffness and the volumetric coupling change nothing; the dilatancy cut-off is not the cause (MMM 2015 §6.4 p. 74: 'By default, the Dilatancy cut-off is not active' and it 'does not help … when using the Undrained (A) drainage type … the void ratio remains constant'; §13.1 pp. 139–142 does not switch it on); ψm is MMM 2015 Eq. 6.12 (= 2025.1 Eq. 6-15) including the 3/4 sin φ rule, as the kernel; and the DRAINED εv curves fail in the same dilatant phase with the same sign (kernel dilates earlier), so the cause is common to both drainage types. Classification: reference artefact (the published curves are a coarse-step PLAXIS solution), not a kernel defect; reproducing PLAXIS's lag would need a deliberate 'explicit ψm' option — a design decision, not made. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-7 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 7.456, unchanged. Vertex-step probe (Modal 2026-11-12T00-02-29, probe_hs_plaxis_vertex_steps; columns fine-implicit | PLAXIS-steps implicit | PLAXIS-steps start-of-step ψm | split 4/16/64): HS-1 drained loose (q, εv) fine (0.38,0.41) | impl (0.45,0.32) | EXPL (0.45,0.32) | /4 (0.38,0.39) /16 (0.38,0.40) /64 (0.38,0.41) · HS-1 drained medium (q, εv) fine (0.35,2.45) | impl (0.33,1.47) | EXPL (0.35,1.03) | /4 (0.35,1.93) /16 (0.35,2.32) /64 (0.35,2.42) · HS-1 drained dense (q, εv) fine (0.44,1.35) | impl (0.44,2.19) | EXPL (0.44,0.22) | /4 (0.44,1.06) /16 (0.44,1.27) /64 (0.44,1.33) · HS-2 undrained loose (q, P_excess) fine (0.36,0.19) | impl (0.37,0.19) | EXPL (0.37,0.19) | /4 (0.36,0.19) /16 (0.36,0.19) /64 (0.36,0.19) · HS-2 undrained medium (q, P_excess) fine (3.60,1.33) | impl (5.81,2.63) | EXPL (0.94,0.27) | /4 (2.91,0.96) /16 (3.42,1.24) /64 (3.55,1.31) · HS-2 undrained dense (q, P_excess) fine (3.70,7.46) | impl (6.58,9.16) | EXPL (0.46,1.51) | /4 (2.82,5.27) /16 (3.48,6.92) /64 (3.65,7.32) · HS-3/4 Hostun loose (q, εv) fine (0.32,0.82) | impl (0.17,0.73) | EXPL (0.17,0.73) | /4 (0.27,0.80) /16 (0.31,0.82) /64 (0.32,0.82) · HS-3/4 Hostun dense (q, εv) fine (0.31,1.00) | impl (0.31,1.65) | EXPL (0.24,0.15) | /4 (0.31,0.80) /16 (0.31,0.95) /64 (0.31,0.99). Driven along PLAXIS's own published load steps with ψm from the start of each step, every one of these curves passes except HS-1 εv medium (1.03) and HS-2 P_excess dense (1.51, whose last two published points are the polyline clipped on the figure's 0 axis); splitting the steps converges monotonically back to the converged kernel. The Undrained (A) path is ruled out as the cause: the same element run with K_w → 1e12 (constant volume) gives at −ε1 = 0.03 medium q 196.025 vs 195.845 kPa, P_excess -25.626 vs -25.698 kPa (K_w 3.6875e6 kPa); dense q 464.289 vs 464.734 kPa, P_excess 38.877 vs 39.028 kPa (K_w 4.9167e6 kPa) — the pore-fluid stiffness and the volumetric coupling change nothing; the dilatancy cut-off is not the cause (MMM 2015 §6.4 p. 74: 'By default, the Dilatancy cut-off is not active' and it 'does not help … when using the Undrained (A) drainage type … the void ratio remains constant'; §13.1 pp. 139–142 does not switch it on); ψm is MMM 2015 Eq. 6.12 (= 2025.1 Eq. 6-15) including the 3/4 sin φ rule, as the kernel; and the DRAINED εv curves fail in the same dilatant phase with the same sign (kernel dilates earlier), so the cause is common to both drainage types. Classification: reference artefact (the published curves are a coarse-step PLAXIS solution), not a kernel defect; reproducing PLAXIS's lag would need a deliberate 'explicit ψm' option — a design decision, not made. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-8 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Investigated 12 Nov 2026 (KB-1): the kernel follows Benz Eqs 7.33/7.34 as written. Benz's first marker is reproduced within 0.5 % by a first increment that uses his code's initial Gm = 10 (App. A line 51), so it depends on the first step size and is not adopted. The loose case's second marker (−9.8 %) is unexplained. The elastic secant at the first marker is 0.9766 G0 on the reloading curve (0.954 is the loading curve). || Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 1.562, unchanged. Analysis (not resolved, no fix): the first published HS-small marker (dense 100 kPa: G 104 779 kPa at ε1 − ε3 = 2.49e-5, 0.970 G0 with G0 = E0ref/(2(1 + ν)) = 108 000 kPa, Benz Table D.1 p. 179) sits on Benz's analytical Santos & Correia curve (Fig. 8.2 caption p. 106: 'incrementally (HS-Small) and analytically derived stiffness decay curves match up pretty well': 1/(1 + 0.385·2.49e-5/2e-4) = 0.954). The kernel gives 0.88 G0 there. ENG-2 CLOSED 12 Nov 2026: the strain definition is NOT a contributor. γHist = √3‖Δe·H‖/‖Δe‖ (Benz Eq. 6.7 = MMM 2015 Eq. 7.4) is the Δe-weighted RMS of H's principal values, not √3‖H‖; on a proportional triaxial path it equals ε1 − ε3 exactly, the same as MMM 2015 Eqs. 7.5–7.6 (γ = 3/2 εq = εaxial − εlateral, p. 83) and Benz Eqs. 2.5/2.7 (pp. 5–6). Measured on the kernel overlay: γHist = 1.500000e-5 for ε1 − ε3 = 1.5e-5 (tests/hs_small_gamma_hist.rs, 3 tests). The earlier '√2' was √3‖e‖ = √2(ε1 − ε3), a mis-evaluation of Eq. 6.7. So the elastic secant at this marker is 0.954 (not 0.936), and the whole gap to 0.954/0.970 is plastic shear compliance left after the hᵢ = Gm^(1+Eur/Ei) attenuation (Benz Eqs. 7.33/7.34) — still open, not a definition question. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
v-hs-published-curve-9 — Deviation · verify-plaxis2d
Reference: doc-373 rule (pre-registered)
Reproduce: tests/constitutive_published.rs (ignored; re-run 12 Nov 2026 on Modal with --include-ignored)
Notes: Investigated 12 Nov 2026 (KB-1): the kernel follows Benz Eqs 7.33/7.34 as written. Benz's first marker is reproduced within 0.5 % by a first increment that uses his code's initial Gm = 10 (App. A line 51), so it depends on the first step size and is not adopted. The loose case's second marker (−9.8 %) is unexplained. The elastic secant at the first marker is 0.9766 G0 on the reloading curve (0.954 is the loading curve). || Re-measured 12 Nov 2026 (Modal 2026-11-11T23-56-14): max d 2.765, unchanged. Analysis (not resolved, no fix): the first published HS-small marker (dense 100 kPa: G 104 779 kPa at ε1 − ε3 = 2.49e-5, 0.970 G0 with G0 = E0ref/(2(1 + ν)) = 108 000 kPa, Benz Table D.1 p. 179) sits on Benz's analytical Santos & Correia curve (Fig. 8.2 caption p. 106: 'incrementally (HS-Small) and analytically derived stiffness decay curves match up pretty well': 1/(1 + 0.385·2.49e-5/2e-4) = 0.954). The kernel gives 0.88 G0 there. ENG-2 CLOSED 12 Nov 2026: the strain definition is NOT a contributor. γHist = √3‖Δe·H‖/‖Δe‖ (Benz Eq. 6.7 = MMM 2015 Eq. 7.4) is the Δe-weighted RMS of H's principal values, not √3‖H‖; on a proportional triaxial path it equals ε1 − ε3 exactly, the same as MMM 2015 Eqs. 7.5–7.6 (γ = 3/2 εq = εaxial − εlateral, p. 83) and Benz Eqs. 2.5/2.7 (pp. 5–6). Measured on the kernel overlay: γHist = 1.500000e-5 for ε1 − ε3 = 1.5e-5 (tests/hs_small_gamma_hist.rs, 3 tests). The earlier '√2' was √3‖e‖ = √2(ε1 − ε3), a mis-evaluation of Eq. 6.7. So the elastic secant at this marker is 0.954 (not 0.936), and the whole gap to 0.954/0.970 is plastic shear compliance left after the hᵢ = Gm^(1+Eur/Ei) attenuation (Benz Eqs. 7.33/7.34) — still open, not a definition question. || Passing in the same run: HS-1 q loose/medium/dense 0.381/0.345/0.438, HS-1 εv loose 0.408, HS-3 q 0.318, HS-3 εv loose 0.822, HS-2 q loose 0.356, HSS-1 σ1/σ3 and εv (all ≤ 0.54/0.81). Rows 19/20 stay implemented-unproven.
geostudio-sigmaw-transversely-isotropic-amadei — Pass · K10
Reference: Amadei (1983) closed form for a circular hole in transversely isotropic rock; RS2 VM §8
Benchmark: vendor: Rocscience; product: RS2 Stress Analysis; version: Verification Manual; doc: RS2 Stress Analysis Verification Manual; page: §8; caseId: hole in transversely isotropic rock
Comparison (literature): Amadei (1983) closed form = —, tolerance FE discretisation band
Case: hole in a transversely isotropic elastic rock mass (RS2 Stress Analysis Verification Manual §8)
Mesh: 1507 Gauss points; FE column around the hole
Reproduce: cargo test --release -p tbk-core --test k10_rock rs2_hole_in_transversely_isotropic_rock_matches_amadei -- --nocapture
Notes: Worst wall displacement error 1.85e-3 of max|u| (0.185 %); tangential-stress rms error 7.97e-3 of sigma_0 (0.797 %). Both inside the reported FE-discretisation band. Values transcribed from the test assertions; re-run before merge.
geostudio-sigmaw-bbm-lambda-suction-alonso — Pass · K13
Reference: lambda(0.09 MPa) = 0.06 (Alonso et al. 1990 Table 1)
Benchmark: vendor: literature; product: Barcelona basic model; version: -; doc: Alonso, Gens & Josa (1990) Geotechnique 40(3); page: Fig 17(b) p.421-422; Table 1 p.424; caseId: BBM lambda(s)
Comparison (literature): Alonso et al. (1990) Table 1 = 0.06, tolerance source rounding
Case: Barcelona basic model — elastic compressibility lambda(s) (Alonso, Gens & Josa 1990)
Mesh: material point
Reproduce: cargo test --release -p tbk-core --test k13_bbm_certified certified_lambda_of_suction -- --nocapture
Notes: lambda(0.04)=0.0902 vs 0.09, lambda(0.06)=0.0751 vs 0.075, lambda(0.09)=0.0601 vs 0.06. Inside source-rounding tolerance. Values transcribed from the test assertions; re-run before merge.
geostudio-sigmaw-bbm-lc-yield-alonso — Pass · K13
Reference: p0(0.09 MPa) = 85 kPa (Alonso et al. 1990)
Benchmark: vendor: literature; product: Barcelona basic model; version: -; doc: Alonso, Gens & Josa (1990) Geotechnique 40(3); page: Fig 17(b) p.421-422; Table 1 p.424; caseId: BBM LC yield curve
Comparison (literature): Alonso et al. (1990) = 85, tolerance source rounding (p0(0.06) 2.4 % flagged)
Case: Barcelona basic model — LC yield curve p0(s) (Alonso, Gens & Josa 1990)
Mesh: material point
Reproduce: cargo test --release -p tbk-core --test k13_bbm_certified certified_lc_yield_curve -- --nocapture
Notes: p0(0.09)=85.1 vs 85 kPa. p0(0.06)=71.7 vs published 70 kPa (~2.4 % high, inside the suite tolerance) — flagged for the tolerance-provenance ledger. Values transcribed from the test assertions; re-run before merge.
geostudio-sigmaw-ss1-mmm-isotropic-compression — Pass · K-material
Reference: PLAXIS MMM §17.6 Table 17-12 epsilon_v = [-0.235, -0.188, -0.235, -0.471]
Benchmark: vendor: Bentley; product: PLAXIS 2D; version: 2025.1 Material Models Manual; doc: PLAXIS 2D MMM 2025.1; page: §17.6 Table 17-12; caseId: SS-1 isotropic compression
Comparison (vendor): PLAXIS MMM Table 17-12 = —, tolerance 2.5 %*|patched| + 0.0005
Case: Soft Soil model — isotropic compression (PLAXIS 2D Material Models Manual §17.6 Table 17-12, SS-1)
Mesh: material point / oedometer
Reproduce: cargo test --release -p tbk-core --test constitutive_published ss1_mmm_table17_12_isotropic_compression -- --nocapture
Notes: ours epsilon_v = [-0.22999, -0.18429, -0.23007, -0.46034]; worst relative miss ~2.26 %, against a tolerance of 2.5 %*|patched| + 0.0005. Test prints 'RESULT SS-1: max |Delta|/tol 0.869 -> PASS'. Values transcribed from the test assertions; re-run before merge.
m17-norsand-cs-plane-strain-lode0 — Pass · M17 (Lead F)
Reference: closed form M(theta = 0 deg) = M_tc - M_tc^2/(3 + M_tc) cos(pi/4), M_tc = 1.25 (eq. C.7)
Mesh: single Gauss point, kernel update (6-component Voigt)
Reproduce: tests/f_norsand_general.rs critical_state_plane_strain_lode_angle_zero
Notes: Nothing fitted: the Lode angle the path develops is itself an output (beta = 30.002 deg, i.e. theta = 0 deg; deviatoric sigma_2/q = 1.9e-5) and psi -> -2.9e-5, D -> 0. Pass on the closed-form critical state.
m17-norsand-cs-triaxial-extension — Pass · M17 (Lead F)
Reference: closed form M_te = 3 M_tc/(3 + M_tc) = 0.88235 for M_tc = 1.25 (eq. C.7 at theta = -30 deg)
Mesh: single Gauss point, kernel update (6-component Voigt)
Reproduce: tests/f_norsand_general.rs critical_state_triaxial_compression_and_extension
Notes: The pre-M17 integrator used M_tc for both senses. The same test gives undrained compression eta = 1.25000 = M_tc and psi = -9e-15 for both paths.
m17-norsand-general-vs-triaxial-reference — Pass · M17 (Lead F)
Reference: the same equations on the Lode axis (theta = +30 deg, M = M_tc): the two integrators must agree
Mesh: single Gauss point, kernel update (6-component Voigt)
Reproduce: tests/f_norsand_general.rs general_integrator_reproduces_triaxial_reference
Notes: Drained curves 7.2e-9 / 7.0e-9 / 4.0e-10 / 2.5e-10; undrained 4.9e-10 / 5.3e-10. The drained figure is the driver's own secant band (|sigma_3 - p_0| < 1e-9 p_0). The model's update keeps the pre-M17 integrator on the axisymmetric triaxial-compression path, so the existing book tests (norsand_book, k13_norsand_*) are bit-identical.
m17-norsand-brasted-plane-strain-peak-loose — Deviation · M17 (Lead F)
Reference: Figure 3.23 NorSand line, read from the 400 dpi page image (tests/data/norsand_jb2016_fig3_23.txt; read error +-4 kPa, +-8 kPa where the line runs within a marker of the data)
Mesh: single Gauss point, kernel update (6-component Voigt)
Reproduce: tests/f_norsand_general.rs brasted_plane_strain_fig_3_23
Notes: Investigated 12 Nov 2026 (KB-1): Fig. 3.23 uses the same M(θ) we implement ([C.7] with [C.13]: caption p.142, Table 3.1, App. C p.490), so the earlier suggested cause (a different M(θ)) is withdrawn. Open candidates: the power-law elasticity b = 0.5 (stated on p.140; the kernel does not model it), the unstated N, and λ, which differs between §3.8.5 and Table 2.1. || DEVIATION (model stronger than the book's NorSand): +6.5 / +9.9 / +10.6 % in peak sigma_1 (loose / compact / dense) and up to 0.5 % less contractive in eps_v; early-strain stiffness 3-5 % lower. Inputs as the book states them (Gamma 0.902, lambda10 0.05, M_tc 1.27, Ir 500, nu 0.2, chi_tc 2.8, H 85 / 150 / 275, psi_0 -0.04 / -0.11 / -0.19); N = 0.3 (Fig. 2.45 stress-dilatancy slope 1 - N = 0.71). NOT stated for Brasted: the elastic power-law exponent b = 0.5 (this model: G = Ir sigma_m). Probable cause, not proven: the book's curves were computed with the Jefferies & Shuttle (2002) M(theta) = average of Mohr-Coulomb and Matsuoka-Nakai (M_ps = 1.08 at theta = 15 deg), while the module implements the simplified eq. C.7 (1.125 at 15 deg, +4.2 %). Peak sigma_1 at N = 0.4: 1086 / 1257 / 1526 kPa (printed by the test).
m17-norsand-brasted-plane-strain-peak-compact — Deviation · M17 (Lead F)
Reference: Figure 3.23 NorSand line, read from the 400 dpi page image (tests/data/norsand_jb2016_fig3_23.txt; read error +-4 kPa, +-8 kPa where the line runs within a marker of the data)
Mesh: single Gauss point, kernel update (6-component Voigt)
Reproduce: tests/f_norsand_general.rs brasted_plane_strain_fig_3_23
Notes: Investigated 12 Nov 2026 (KB-1): Fig. 3.23 uses the same M(θ) we implement ([C.7] with [C.13]: caption p.142, Table 3.1, App. C p.490), so the earlier suggested cause (a different M(θ)) is withdrawn. Open candidates: the power-law elasticity b = 0.5 (stated on p.140; the kernel does not model it), the unstated N, and λ, which differs between §3.8.5 and Table 2.1. || DEVIATION (model stronger than the book's NorSand): +6.5 / +9.9 / +10.6 % in peak sigma_1 (loose / compact / dense) and up to 0.5 % less contractive in eps_v; early-strain stiffness 3-5 % lower. Inputs as the book states them (Gamma 0.902, lambda10 0.05, M_tc 1.27, Ir 500, nu 0.2, chi_tc 2.8, H 85 / 150 / 275, psi_0 -0.04 / -0.11 / -0.19); N = 0.3 (Fig. 2.45 stress-dilatancy slope 1 - N = 0.71). NOT stated for Brasted: the elastic power-law exponent b = 0.5 (this model: G = Ir sigma_m). Probable cause, not proven: the book's curves were computed with the Jefferies & Shuttle (2002) M(theta) = average of Mohr-Coulomb and Matsuoka-Nakai (M_ps = 1.08 at theta = 15 deg), while the module implements the simplified eq. C.7 (1.125 at 15 deg, +4.2 %). Peak sigma_1 at N = 0.4: 1086 / 1257 / 1526 kPa (printed by the test).
m17-norsand-brasted-plane-strain-peak-dense — Deviation · M17 (Lead F)
Reference: Figure 3.23 NorSand line, read from the 400 dpi page image (tests/data/norsand_jb2016_fig3_23.txt; read error +-4 kPa, +-8 kPa where the line runs within a marker of the data)
Mesh: single Gauss point, kernel update (6-component Voigt)
Reproduce: tests/f_norsand_general.rs brasted_plane_strain_fig_3_23
Notes: Investigated 12 Nov 2026 (KB-1): Fig. 3.23 uses the same M(θ) we implement ([C.7] with [C.13]: caption p.142, Table 3.1, App. C p.490), so the earlier suggested cause (a different M(θ)) is withdrawn. Open candidates: the power-law elasticity b = 0.5 (stated on p.140; the kernel does not model it), the unstated N, and λ, which differs between §3.8.5 and Table 2.1. || DEVIATION (model stronger than the book's NorSand): +6.5 / +9.9 / +10.6 % in peak sigma_1 (loose / compact / dense) and up to 0.5 % less contractive in eps_v; early-strain stiffness 3-5 % lower. Inputs as the book states them (Gamma 0.902, lambda10 0.05, M_tc 1.27, Ir 500, nu 0.2, chi_tc 2.8, H 85 / 150 / 275, psi_0 -0.04 / -0.11 / -0.19); N = 0.3 (Fig. 2.45 stress-dilatancy slope 1 - N = 0.71). NOT stated for Brasted: the elastic power-law exponent b = 0.5 (this model: G = Ir sigma_m). Probable cause, not proven: the book's curves were computed with the Jefferies & Shuttle (2002) M(theta) = average of Mohr-Coulomb and Matsuoka-Nakai (M_ps = 1.08 at theta = 15 deg), while the module implements the simplified eq. C.7 (1.125 at 15 deg, +4.2 %). Peak sigma_1 at N = 0.4: 1086 / 1257 / 1526 kPa (printed by the test).
m17-norsand-fe-plane-strain-vs-element — Pass · M17 (Lead F)
Reference: the element driver (the model's own update, Newton on the stress-controlled components), same load increments
Mesh: T6, coarse, 1 x 1 m, homogeneous state; full Newton with the FD algorithmic tangent (40 / 28 iterations, 20 steps)
Reproduce: tests/f_norsand_fe.rs fe_norsand_drained_plane_strain_biaxial, fe_norsand_undrained_plane_strain_biaxial
Notes: Drained 1.989e-9 (|d sigma| 2.8e-8 kPa, state 7.5e-11); undrained-a 7.227e-9 (state 4.5e-14). With tangent elastic (modified Newton) the drained answer is the same to 4.7e-9 in 139 iterations vs 40. Runtime 3.3 s for the 4 tests.
Cited validation suites — 27
cam-clay-triaxial-web-validation.test.ts
Validation for the Modified Cam-Clay integrator (`cam-clay-triaxial.ts`).
Analyses validated: cam-clay-triaxial, soil-models · Recorded run: passed — 20 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Modified Cam-Clay integrator (`cam-clay-triaxial.ts`).
STATUS: PARTIAL — 7 published values from ONE book, against a release bar of 20 values from 2 sources.
This suite is FORMULA-FIDELITY evidence (formula-fidelity) plus the PUBLISHED VALUES block at the foot
of the file. The shortfall is 13 values and one independent source, so the manifest must not promote it.
The 15 earlier tests (M from φ_cs, NCL void ratio, su/p′₀ = (M/2)(½)^Λ for four parameter sets, ellipse
geometry, elastic/plastic step flags) were headed "Independent anchors" but every expected number is
computed from the formula in the engine's own docblock, and no M value or su/p′₀ in them was found in a
book read in this session; they are formula checks and are NOT counted as published.
PUBLISHED SOURCE actually read (PDF opened in this session; the book has no text layer, so pages were
rendered and read as images):
1. Atkinson, J.H. & Bransby, P.L. (1978), The Mechanics of Soils: An Introduction to Critical State
Soil Mechanics, McGraw-Hill —
Example 10-1 (p. 193): undrained triaxial test, N 3.25, λ 0.20, Γ 3.16, M 0.94, NC to p′ 400 kN/m²
→ v₀ = 2.0517, q′_f = 240, p′_f = 255 kN/m².
Example 10-2 (pp. 195–196): drained test, same clay and sample → v_f = 1.886, ε_v = 8.09 %
(q′_f = 548, p′_f = 583 are printed too; they are the closed-form geometry 3Mp₀/(3−M) and the
integrator is only checked against them as a hand check).
Example 11-2 (pp. 229–230), sample A: q′_f = 239, u_f = 225 kN/m².
The book gives (N, λ, Γ, M) but not κ. The engine's CSL sits (λ−κ)·ln 2 below the NCL, so the
κ consistent with the printed N and Γ is κ = λ − (N−Γ)/ln 2 = 0.0702. That κ is DERIVED here, not
printed — the comparison is "an MCC clay whose CSL coincides with the book's".
WHAT COULD NOT BE REPRODUCED, AND WHY (not hidden):
· Example 11-2 sample B (heavily over-consolidated, p′ 40 after swelling from 863, v₀ 2.052, u_f = −135).
The book's data are not an MCC-consistent set: the swelling line from the NCL point at 863 to p′ 40
at v = 2.052 implies κ = 0.050, whereas Γ − N implies κ = 0.0702 under MCC. Run as given the engine
reaches the CSL at p′ 187 (= p_c/2) instead of 255. The book's answer uses Γ alone (Atkinson &
Bransby's Example is a CSL exercise, not an MCC prediction), so this is a property of the example,
not evidence of an engine defect.
· Table 10-1 (p. 190: London clay, Weald clay, kaolin — λ 0.161/0.093/0.26, κ 0.062/0.035/0.05,
Γ 2.759/2.060/3.767, M 0.888/0.95/1.02) prints soil constants, not results, and gives no N or φ_cs,
so there is nothing to compare an output with.
· Britto & Gunn and Potts & Zdravković Vol. 1 were searched through their text layers (the Britto & Gunn
layer is poor OCR, so that search is weak evidence of absence): the MCC predictions found
(Potts Figs 7.19–7.20, Bothkennar clay) are printed as curves only, with no tabulated values. They
are deliberately not listed as sources above because nothing from them is asserted below.
| Test block (the published value it checks) | Verdict |
| M = 6sinφ/(3−sinφ): φ_cs=20° → M≈0.772 | Pass |
| M = 6sinφ/(3−sinφ): φ_cs=25.4° → M≈1.0008 | Pass |
| M = 6sinφ/(3−sinφ): φ_cs=30° → M≈1.2 | Pass |
| M = 6sinφ/(3−sinφ): φ_cs=33.4° → M≈1.3484 | Pass |
| NCL void ratio at p′=50: e = N−λ·ln p′ −1 | Pass |
| NCL void ratio at p′=100: e = N−λ·ln p′ −1 | Pass |
| NCL void ratio at p′=200: e = N−λ·ln p′ −1 | Pass |
| NCL void ratio at p′=400: e = N−λ·ln p′ −1 | Pass |
| NC CIU su/p′₀ = (M/2)(½)^Λ: M=0.89, λ=0.16, κ=0.03 | Pass |
| NC CIU su/p′₀ = (M/2)(½)^Λ: M=1, λ=0.2, κ=0.04 | Pass |
| NC CIU su/p′₀ = (M/2)(½)^Λ: M=1.2, λ=0.1, κ=0.02 | Pass |
| NC CIU su/p′₀ = (M/2)(½)^Λ: M=0.95, λ=0.25, κ=0.05 | Pass |
| yield ellipse: CSL intersects at p′=p_c/2, q=M·p_c/2 | Pass |
| MCC elastic step (inside the ellipse) is non-plastic | Pass |
| NC sample (p=pc) yields under shear (plastic) | Pass |
| derived κ puts the MCC critical-state line at the printed Γ = 3.16 (hand check, not counted) | Pass |
| Atkinson & Bransby Ex 10-1 (p. 193): undrained NC test v₀ = 2.0517, q_f = 240, p_f = 255 | Pass |
| Atkinson & Bransby Ex 10-2 (pp. 195–196): drained NC test v_f = 1.886, ε_v = 8.09 % | Pass |
| Atkinson & Bransby Ex 11-2 (pp. 229–230), sample A: q_f = 239, u_f = 225 kN/m² | Pass |
| the published-value tally is 7 distinct printed numbers from 1 source; PARTIAL (short of 20 by 13) | Pass |
constitutive-tools-web-validation.test.ts
constitutive-tools-web-validation.test.ts
Analyses validated: cam-clay-triaxial, drucker-prager, duncan-chang, ngi-adp, soft-soil-creep, von-mises · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
constitutive-tools-web-validation.test.ts
WHY THIS FILE EXISTS. `scripts/unvalidated-outputs.mjs` traces every output an
analysis displays back to the result key it reads, then checks whether that key is
named anywhere in the tests or the Modal validation scripts. Three analyses came
back with NO output named at all — nothing anywhere compared a single number they
put on screen to anything:
duncan-chang 6 outputs
drucker-prager 4 outputs
ngi-adp 4 outputs
and four more were mostly unnamed (`cam-clay-triaxial` 5 of 6, `soft-soil-creep`,
`von-mises`, `barton-bandis`). That audit was written after `footing-bearing-3d`
turned out to have applied one sixth of the footing pressure for its whole life
without a single test noticing — because its anchors were all on a DIFFERENT output
from the one the defect appeared in.
Every expected value below is derived from the governing publication's own closed
form and computed independently in the test, NOT copied from what the engine
currently returns. Where a model is a known special case of another, the test pins
the relationship rather than a number, because that is the stronger statement:
a Drucker-Prager cone matched at the compression corner MUST reproduce the
Mohr-Coulomb triaxial deviator exactly, and if it stops doing so the match is
broken however plausible the number looks.
Sources (all in `Geo Technical engineering books/` or the cited papers):
· Drucker & Prager (1952); de Souza Neto, Perić & Owen, *Computational Methods
for Plasticity* (2008) §8.3 — the compression-corner match
α = 2 sinφ / (√3 (3 − sinφ)), k = 6 c cosφ / (√3 (3 − sinφ))
· Mohr-Coulomb triaxial compression: q_f = (2c cosφ + 2σ₃ sinφ)/(1 − sinφ)
· Duncan & Chang (1970), "Nonlinear analysis of stress and strain in soils",
ASCE JSMFD 96(5) — hyperbolic q(ε), E_i = K·p_a·(σ₃/p_a)^n,
E_t = (1 − R_f·SL)²·E_i, q_ult = q_f/R_f
· Grimstad, Andresen & Jostad (2012), NGI-ADP — anisotropic undrained strengths
· Roscoe & Burland (1968) Modified Cam-Clay; Muir Wood, *Soil Behaviour and
Critical State Soil Mechanics* — M = 6 sinφ_cs/(3 − sinφ_cs),
Λ = (λ−κ)/λ, p′_cs/p′₀ = (½)^Λ for an undrained NC test
· Vermeer & Neher (1999) Soft-Soil-Creep — λ* = C_c/((1+e)ln10),
κ* ≈ 2C_s/((1+e)ln10), μ* = C_α/((1+e)ln10)
· von Mises (1913); Simo & Hughes, *Computational Inelasticity*
| Test block (the published value it checks) | Verdict |
| Drucker-Prager: cone constants equal the de Souza Neto §8.3 compression-corner match (6 anchors) | Pass |
| Drucker-Prager: the matched cone reproduces the Mohr-Coulomb triaxial deviator EXACTLY (4 anchors) | Pass |
| Drucker-Prager: φ=30°, c=10 kPa, σ₃=100 kPa → q_f = 234.641 kPa, and ψ sets β independently | Pass |
| Duncan-Chang: E_i, q_f and q_ult on the registry defaults (K=300, n=0.5, σ₃=100 kPa) | Pass |
| Duncan-Chang: the hyperbola q = ε/(1/E_i + ε/q_ult) at 1 % axial strain | Pass |
| Duncan-Chang: the model behaves as Duncan & Chang describe (5 monotonicity anchors) | Pass |
| NGI-ADP: the three anisotropic strengths are the declared ratios of s_u^A (4 anchors) | Pass |
| NGI-ADP: anisotropy ordering and the isotropic limit (5 anchors) | Pass |
| Cam-Clay: M, Λ and p′_cs/p′₀ = (½)^Λ on the registry defaults (5 anchors) | Pass |
| Cam-Clay: s_u/p′₀ = ½ M (½)^Λ, so the undrained strength follows from the CSL alone | Pass |
| Soft-Soil-Creep: λ*, κ*, μ* and M from the published definitions (6 anchors) | Pass |
| Soft-Soil-Creep: creep strain per log-decade is μ*·ln10, and λ* > κ* > μ* for a real clay | Pass |
| von Mises: q from the principal stresses, plus the yield decision (6 anchors) | Pass |
| every constitutive tool returns finite numbers on its defaults and at parameter extremes | Pass |
| duncan-chang: σ₃ = 0 is an UNCONFINED test, which the hyperbolic fit cannot represent | Pass |
dp-material-point-web-validation.test.ts
Web-benchmark validation for the Drucker-Prager material-point integrator (`dp-material-point.ts`).
Analyses validated: mohr-coulomb, soil-models · Recorded run: passed — 24 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the Drucker-Prager material-point integrator
(`dp-material-point.ts`). ≥20 cited values — the the release rules hard gate.
Anchor: with the compression-corner match to Mohr-Coulomb (Chen & Han;
de Souza Neto §8.3, on disk), DP's triaxial-compression failure deviator
equals the MC closed form exactly — so we cross-check every case against the
independently-validated `mohr-coulomb.ts` / `mc-material-point.ts` failure
(which are themselves pinned to Das/Bowles + an established FE code benchmark). The cone
tip is the same isotropic-tension apex σ = −c·cotφ.
| Test block (the published value it checks) | Verdict |
| DP q_f == MC q_f (compression corner): σ3=50, c=10, φ=30 | Pass |
| DP q_f == MC q_f (compression corner): σ3=100, c=10, φ=30 | Pass |
| DP q_f == MC q_f (compression corner): σ3=200, c=10, φ=30 | Pass |
| DP q_f == MC q_f (compression corner): σ3=100, c=0, φ=35 | Pass |
| DP q_f == MC q_f (compression corner): σ3=200, c=0, φ=35 | Pass |
| DP q_f == MC q_f (compression corner): σ3=300, c=0, φ=40 | Pass |
| DP q_f == MC q_f (compression corner): σ3=100, c=25, φ=0 | Pass |
| DP q_f == MC q_f (compression corner): σ3=50, c=50, φ=0 | Pass |
| DP q_f == MC q_f (compression corner): σ3=300, c=1, φ=34 | Pass |
| DP q_f == MC q_f (compression corner): σ3=10, c=5, φ=25 | Pass |
| DP q_f == MC q_f (compression corner): σ3=500, c=20, φ=38 | Pass |
| DP apex return → p = −c·cotφ, c=10, φ=30 | Pass |
| DP apex return → p = −c·cotφ, c=20, φ=35 | Pass |
| DP elastic step below yield returns exact elastic stress | Pass |
| DP plastic return lands on the cone (f≈0), φ=20 | Pass |
| DP plastic return lands on the cone (f≈0), φ=30 | Pass |
| DP plastic return lands on the cone (f≈0), φ=40 | Pass |
| DP dilatancy (ψ>0) raises mean stress vs ψ=0 | Pass |
| DP drained triaxial integrates to q_f (multi-step), φ=30, c=10 | Pass |
| DP drained triaxial integrates to q_f (multi-step), φ=35, c=0 | Pass |
| general DP (axis-aligned) equals the principal integrator | Pass |
| general DP return lands on the cone for a shear state, φ=25 | Pass |
| general DP return lands on the cone for a shear state, φ=35 | Pass |
| general DP objectivity: I1 invariant across shear plane | Pass |
drucker-prager-web-validation.test.ts
Validation for the Drucker-Prager cone runner (`dp-material-point.ts`: `computeDruckerPragerRunner`, `dpConstants`, `dpTriaxialFailure`) — slug `drucker-prager`.
Analyses validated: drucker-prager · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Drucker-Prager cone runner (`dp-material-point.ts`: `computeDruckerPragerRunner`,
`dpConstants`, `dpTriaxialFailure`) — slug `drucker-prager`.
STATUS: PARTIAL — 10 published values against a release bar of 20, and 9 of the 10 are triaxial
COMPRESSION failure data that any compression-matched cone must reproduce by construction. This is
FORMULA-FIDELITY evidence (formula-fidelity): the published numbers check the cone's calibration to the
Mohr–Coulomb compression corner and nothing about its shape in the deviatoric plane, its
non-associated flow, or the apex return. The shortfall is 10 values; the gap that matters is a published
DP *stress-point* result, and none was found.
WHAT THE SEARCH FOUND. The books in the library print Drucker–Prager results only as finite-element
boundary-value problems (de Souza Neto, Perić & Owen (2008), §8.4.3 strip footing, pp. 346–350), never as
material-point tables. No tabulated DP constants (α, k, η, ξ) for a stated (c, φ) were found in
de Souza Neto, Perić & Owen (2008), Yu, Potts & Zdravković Vol. 1 or Vol. 2 by text search.
PUBLISHED SOURCES (each number read from the page named, in a document opened in this session):
1. Lambe, T.W. & Whitman, R.V. (1979), Soil Mechanics, SI Version — Example 11.1 (p. 140), four drained
triaxial COMPRESSION tests on a dense quartz sand, σ3f 103/207/414/827 → σ1f 524/1020/2151/4171 at the
φ the book read (42.2/41.6/42.7/42.1°).
2. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Example 5.2 (p. 178), three CU
triaxial compression circles, σ′3/σ′1 70/262, 146/487, 228/700 at secant φ′ 35/33/31°.
3. PLAXIS (2006), PLAXIS 3D Foundation Validation Manual v1.5, §2.4 pp. 2-7/2-8 — triaxial compression,
c′ 1, φ′ 35°, σ3 100 → 372.9 kN/m².
4. COMSOL Multiphysics 6.3 Application Library, "Triaxial Test with Hardening Soil Material Model",
Table 2 — c 1, φ 34°, σ3 300 → 1064.9 kPa (vendor document; closed-form MC value).
5. de Souza Neto, Perić & Owen (2008), Computational Methods for Plasticity, §8.4.3 (pp. 346–350) —
plane-strain rigid smooth strip footing, weightless soil, c = 490 kPa, φ = ψ = 20°: limit pressure
P_lim/c ≈ 35.7 for the circumscribing cone, 17.3 for the inscribed cone, 15.0 for the plane-strain
match (Prandtl 14.8). Finite-element results, each within the book's own 1–2 % of the exact value.
⚠️ NAMING FLAG (not resolved). The book calls the 35.7 cone "outer (or extension)" and the 17.3 cone
"inner (or compression)". The engine's cone is the compression-corner match (α = 2sinφ/(√3(3−sinφ))),
which circumscribes the Mohr–Coulomb hexagon and is the LARGER cone. The plane-strain limit load this
engine's (α, k) imply, derived in the test below, is 35.42 — within 0.8 % of 35.7, nowhere near 17.3 — and the
extension-corner constants give 17.14, within 0.9 % of 17.3; the plane-strain-match constants give 14.83. So the identification used here rests on that
numerical agreement, and the book's parenthetical labels appear to be swapped relative to it.
| Test block (the published value it checks) | Verdict |
| Lambe & Whitman Ex 11.1 (p. 140): DP compression failure σ1f = σ3 + q_f at the printed φ, four tests | Pass |
| Craig Ex 5.2 (p. 178): printed σ′1 lies in the ±0.5° bracket of the printed secant φ′ | Pass |
| PLAXIS 3DF §2.4 and COMSOL Table 2: DP compression failure stress 372.9 and 1064.9 kPa | Pass |
| de Souza Neto et al. §8.4.3: plane-strain footing limit load of the compression-matched cone, P_lim/c ≈ 35.7 | Pass |
| the published-value tally is 10 distinct printed numbers from 5 sources; PARTIAL (short of 20 by 10) | Pass |
duncan-chang-web-validation.test.ts
Validation for the Duncan-Chang hyperbolic model (`duncan-chang.ts`).
Analyses validated: duncan-chang, soil-models · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Duncan-Chang hyperbolic model (`duncan-chang.ts`).
STATUS: BLOCKED at 0 published OUTPUT values of the 20 the release bar asks for. This suite is
FORMULA-FIDELITY evidence (formula-fidelity): the hyperbola, the Mohr–Coulomb failure deviator, the
initial modulus Ei = K·pa·(σ3/pa)^n and the tangent modulus Et = (1 − Rf·SL)²·Ei are reproduced exactly from
the equations as written. Every expected number below is computed from those equations; none was found
printed in a source.
WHAT THE SEARCH FOUND. The model's origin papers — Duncan & Chang (1970) and Duncan et al. (1980,
UCB/GT/80-01) — were NOT available to read: the first is not in the reference library, and the second is
behind a paid NISEE-PEER e-Library login (deliberately not circumvented). The only published numbers
found are PARAMETER sets, with the comparison figures printed as curves only: Rocscience RS2 Verification
"Duncan-Chang Model" Table 7.1 reproduces Duncan & Chang (1970) silica sand — dense K 2000, n 0.54, Rf 0.91,
φ 36.5°; loose K 295, n 0.65, Rf 0.90, φ 30.4°; c = 0, ν 0.32 — at a 294.3 kPa isotropic start. Lambe &
Whitman (1979) §12 states the hyperbola and n = 0.4–1.0 (0.5 average) without a worked numeric example.
To unblock: supply Duncan et al. (1980) (its Table of K, n, Rf, φ for named soils, and any printed stress–strain
points) or Duncan & Chang (1970) Table 1/Fig. 6 with tabulated points.
| Test block (the published value it checks) | Verdict |
| MC failure deviator matches the closed form | Pass |
| initial tangent modulus Ei = K·pa·(σ3/pa)^n | Pass |
| initial slope of q(ε) equals Ei | Pass |
| deviator asymptotes to (σ1−σ3)_ult = qf/Rf | Pass |
| tangent modulus: Et=Ei at SL=0, (1−Rf)²Ei at SL=1 | Pass |
| deviator always below failure for finite strain | Pass |
| Duncan-Chang MC failure deviator q_f = (2c·cosφ + 2σ₃·sinφ)/(1−sinφ) — cited sweep | Pass |
| Duncan-Chang initial tangent modulus Ei = K·pa·(σ₃/pa)^n — cited sweep | Pass |
| Duncan-Chang tangent modulus Et = (1−Rf·SL)²·Ei — cited SL sweep (σ₃=100) | Pass |
| Duncan-Chang hyperbolic q(ε) = ε/(1/Ei + ε·Rf/q_f) — cited values (σ₃=100) | Pass |
fe-interface-2d-web-validation.test.ts
Validation for the 2-D SSI elements embedded in the continuum (`fe-interface-2d.ts`): the zero-thickness Goodman INTERFACE (elastic normal/shear + Mohr-Coulomb slip) and the Euler-Bernoulli PLATE/beam sharing continuum node DOFs.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the 2-D SSI elements embedded in the continuum (`fe-interface-2d.ts`):
the zero-thickness Goodman INTERFACE (elastic normal/shear + Mohr-Coulomb slip) and the
Euler-Bernoulli PLATE/beam sharing continuum node DOFs.
Anchors (each an exact closed-form check):
1. INTERFACE elastic shear transfer — below the slip limit the relative slip = τ/k_s
and the normal stress σ_n = k_n·(closing) match the applied tractions.
2. INTERFACE Mohr-Coulomb slip — above τ_max the shear is capped at c + σ_n·tanδ
(Goodman, Taylor & Brekke 1968; CIRIA C760 wall friction δ = R_inter·φ).
3. PLATE cantilever — a single beam element reproduces the tip deflection PL³/3EI and
rotation PL²/2EI (Euler-Bernoulli).
4. PLATE axial — an axial member reproduces u = PL/EA.
5. frictionless interface (c=0, δ=0) slips under any shear.
Refs: Goodman, Taylor & Brekke (1968) J. Soil Mech. Found. Div. 94(SM3):637;
Cook, Malkus, Plesha & Witt "Concepts & Applications of FEA" 4th ed.; CIRIA C760 (2017).
| Test block (the published value it checks) | Verdict |
| interface elastic shear transfer: slip = τ/k_s, σ_n from the applied normal load (below slip) | Pass |
| interface Mohr-Coulomb slip: shear capped at c + σ_n·tanδ | Pass |
| frictionless interface (c=0, δ=0) slips under any shear | Pass |
| plate cantilever: tip deflection PL³/3EI and rotation PL²/2EI (Euler-Bernoulli) | Pass |
| plate axial: u = PL/EA | Pass |
| interface + continuum solve converges (slip state settles) | Pass |
hardening-soil-double-web-validation.test.ts
Validation for the FULL double-hardening Hardening-Soil integrator (`hardening-soil-double.ts`).
Analyses validated: hardening-soil · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the FULL double-hardening Hardening-Soil integrator (`hardening-soil-double.ts`).
⚠️ ATTRIBUTION FIXED in the October audit. This header and the first test used to credit
"σ₁_f = 1064.9 kPa at σ₃ = 300 kPa" to Schanz, Vermeer & Bonnier (1999). That is wrong, and was checked
against the paper itself (schanz-vermeer-bonnier-1999-…pdf in the reference library): SVB Table 1 lists
loose Hostun sand with ν_ur 0.20, m 0.65, φ 34°, ψ 0°, E_s/E₅₀ 0.8, E_ur/E₅₀ 3.0, E₅₀ʳᵉᶠ 20 MPa — no
cohesion, no R_f, and no failure stress; Fig. 6 shows σ₃ = 300 kPa drained triaxial curves but the paper
prints no σ₁_f. The PLAXIS Material Models Manual, 2015, Table 13.2 (same sand) likewise has c = 0 and prints
none. The number 1064.9 kPa IS printed, in the COMSOL Multiphysics 6.3 Application Library model
"Triaxial Test with Hardening Soil Material Model" (Table 2), which borrows the Hostun stiffnesses and
adds c = 1 kPa, ψ = 1.5°, R_f = 0.95. There it is the CLOSED-FORM Mohr–Coulomb failure stress
σ₃·N_φ + 2c·√N_φ = 300·3.5371 + 2·1.8807 = 1064.9 — it does not depend on E₅₀, m, R_f or any hardening
parameter, so it checks the MC strength cap of the hyperbola and nothing about hardening.
WHAT THIS SUITE IS: FORMULA-FIDELITY evidence (formula-fidelity, not an independently-sourced
benchmark of the hardening response). The hyperbola, the power-law E₅₀(σ₃), the E₅₀ secant identity and
the agreement with the closed-form `hardening-soil` SoilTest are checked against the equations as
written (SVB equations; PLAXIS Material Models Manual, 2015, §6.1 Eqs 6.1–6.4), not against a published
result. The published-answer evidence for the Hardening-Soil family lives in
`hardening-soil-web-validation.test.ts` and its count there is partial — see that header.
| Test block (the published value it checks) | Verdict |
| HS-double: MC failure cap σ₁_f = 1064.9 kPa at σ₃=300 (COMSOL 6.3 Table 2, closed-form MC value) | Pass |
| HS-double WEB: E₅₀(σ₃) matches the HS power law (100→20 MPa, 300→40.6 MPa) | Pass |
| HS-double: secant modulus at q_f/2 = E₅₀ (self-consistent hardening) | Pass |
| HS-double: primary backbone matches the closed-form hardening-soil SoilTest | Pass |
| HS-double: unload–reload loop stiffness ≈ E_ur ≫ loading secant (Schanz-Vermeer) | Pass |
| HS-double: plastic shear/volumetric strain tracked; dense sand dilates near failure | Pass |
| HS-double CAP: oedometer plastic compression + K₀ᴺᶜ = 1 − sinφ | Pass |
hardening-soil-web-validation.test.ts
Validation for the Hardening-Soil (HS) SoilTest engine (`hardening-soil.ts`).
Analyses validated: hardening-soil · Recorded run: passed — 21 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Hardening-Soil (HS) SoilTest engine (`hardening-soil.ts`).
STATUS: PARTIAL — 16 of the 20 published values the release bar asks for, and only 3 of the 16 are
computed stress ANSWERS. This suite is FORMULA-FIDELITY evidence (formula-fidelity: the HS equations
are reproduced exactly) plus a block of PUBLISHED VALUES at the foot of the file. The manifest must
therefore not promote the engine, and this header is why. The exact shortfall: 4 published values and,
more importantly, a published HS *stress–strain* result (an ε₁–q or E₅₀-secant number) — none of the
sources available printed one; they print figures only.
⚠️ ATTRIBUTION FIXED in the October audit. An earlier version of this header and of test A18 credited
"σ₁_f = 1064.9 kPa at σ₃ = 300 kPa" to Schanz, Vermeer & Bonnier (1999) (via "an established FE
code"). The paper was opened and does not print it: SVB Table 1 (p. 12) gives loose Hostun sand with
ν_ur 0.20, m 0.65, φ 34°, ψ 0°, E_s/E₅₀ 0.8, E_ur/E₅₀ 3.0, E₅₀ʳᵉᶠ 20 MPa — c = 0, no R_f, no failure
stress. the PLAXIS Material Models Manual, 2015, Table 13.2 (same sand) also has c = 0. The number is printed
in the COMSOL Multiphysics 6.3 Application Library model "Triaxial Test with Hardening Soil Material
Model" (Table 2), which borrows the Hostun stiffnesses and ADDS c = 1 kPa (COMSOL's "value used"
column: E₅₀ 20 MPa, E_ur 60 MPa, m 0.65, φ 34°, ψ 1.5°, R_f 0.95). It is there the closed-form
Mohr–Coulomb stress σ₃·N_φ + 2c·√N_φ, independent of E₅₀, m and R_f. It is counted below as a MC-cap
check, not as a hardening-response benchmark. The reviewer's alternative, PLAXIS σ₃ = 100 kPa,
φ = 35° → 372.9 kPa, IS published (PLAXIS 3D Foundation Validation Manual §2.4) and is added.
PUBLISHED SOURCES (each number read from the page named, in a document opened in this session):
1. PLAXIS (2006), PLAXIS 3D Foundation Validation Manual v1.5, §2.4 pp. 2-7/2-8 — c′ 1, φ′ 35°,
ψ′ 5°, E₅₀ʳᵉᶠ 20000, E_oedʳᵉᶠ 20000, E_urʳᵉᶠ 60000 kN/m², σ3 = 100 → 372.9 (theory), 373.3 (FE).
2. PLAXIS (2015), Material Models Manual, §6.1 defaults (p. 66: p_ref 100, R_f 0.9, E_ur = 3E₅₀;
p. 71 parameter list), Table 13.1 (p. 139: K₀ⁿᶜ 0.5/0.43/0.36, E_urʳᵉᶠ 60000/90000/120000),
Table 13.2 (p. 143: K₀ⁿᶜ 0.44/0.34), Table 13.13 (p. 162: K₀ⁿᶜ 0.38 at φ 38°), intro p. 7
(E_oed ≈ E₅₀ default).
3. Schanz, Vermeer & Bonnier (1999), The hardening soil model: formulation and verification, Table 1
p. 12 (E_ur/E₅₀ = 3.0 corroborates the default; parameters of loose Hostun sand).
4. COMSOL Multiphysics 6.3 Application Library, Table 2 (σ₁ = 1064.9 kPa; closed-form MC value).
5. Rocscience RS3 Verification "15 Hardening Soil Model" Table 15.1 (Berlin sand III: K₀ⁿᶜ 0.38,
E_urʳᵉᶠ 315 MPa = 3 × E₅₀ʳᵉᶠ 105 MPa) — vendor document, year not stated in the file.
The tests above the PUBLISHED VALUES block check the equations against hand-computed numbers and the
definitional identities (E₅₀(p_ref) = E₅₀ʳᵉᶠ, E_i = 2E₅₀/(2−R_f), secant at q_f/2 = E₅₀). The "Berlin
Sand I" parameter set used there is the PLAXIS Material Models Manual, 2015, Table 13.13 layer 1
(E₅₀ 45, E_ur 180, E_oed 45 MPa, m 0.55, c 1, φ 35°, ψ 5°). NB: Table 13.13 AS PRINTED (page image
checked) labels the 45000 row E_ur and the 180000 row E_oed — an apparent label swap in the manual, since
E_ur < E₅₀ is unphysical and Rocscience Table 15.1 prints layer 3 as E_ur 315, E_oed 105 MPa. This
suite uses E_ur = 180 MPa, E_oed = 45 MPa. The expected values are computed from the equations, not
printed in the manual, and are not counted as published. The "Monterey Sand" set
(E₅₀ʳᵉᶠ 102.5, m 0.707, φ 34.65°) could not be traced to a source read in this session; its three
assertions are the E_i identity, which holds for any parameters.
| Test block (the published value it checks) | Verdict |
| HS web A1: E50(σ3=pref) = E50ref [Berlin] | Pass |
| HS web A2: Eur(σ3=pref) = Eurref [Berlin] | Pass |
| HS web A4: Ei = 2·E50/(2−Rf) = 81.818 MPa [Berlin σ3=100] | Pass |
| HS web A5–A8: E50 stress scaling [Berlin] | Pass |
| HS web A9–A13: qf = 2(c·cosφ+σ3·sinφ)/(1−sinφ) [Berlin] | Pass |
| HS web: σ1f = σ3 + qf [Berlin σ3=50,200] | Pass |
| HS web A14: Ei = 119.324 MPa [Berlin σ3=200] | Pass |
| HS web A15: Eur = 327.67 MPa [Berlin σ3=300] | Pass |
| HS web A16: Eur/E50 = 4.0 stress-independent [Berlin] | Pass |
| HS web A17: φ_cv = 30.80° [Berlin φ=35,ψ=5] | Pass |
| HS web A18: COMSOL Table 2 σ1f = 1064.9 kPa [σ3=300] (MC cap, not SVB) | Pass |
| HS web A19–A21: Monterey Ei = 2·E50/(2−Rf) identity [identity, parameter set untraced] | Pass |
| HS web A22: secant modulus at qf/2 = E50 (E50_secant_error ≈ 0) | Pass |
| HS web A23: Ei/E50 = 2/(2−Rf) across Rf | Pass |
| HS web A3: Eoed(σ=pref) = Eoedref [Berlin oedometer] | Pass |
| PLAXIS 3DF Validation Manual §2.4: HS triaxial failure σ1 = 372.9 (theory) / 373.3 (FE), σ3 = 100 | Pass |
| COMSOL Table 2: σ1f = 1064.9 kPa (MC cap, independent of E50, m, Rf) | Pass |
| PLAXIS Material Models Manual (2015) Tables 13.1/13.2/13.13: K0nc = 1 − sinφ at φ = 30, 34, 35, 38, 40, 41° | Pass |
| default E_ur = 3·E50 reproduces the printed E_ur columns (PMM Table 13.1, RS3 Table 15.1) | Pass |
| PLAXIS default values: p_ref = 100, R_f = 0.9, E_oed = E50 (PMM 2015 pp. 7, 66, 71) | Pass |
| the published-value tally is 16 distinct printed numbers; PARTIAL (short of 20 by 4) | Pass |
hs-cap-oedometer-web-validation.test.ts
Validation for the HS CAP OEDOMETER / K₀ BRANCH — the combined shear+cap axisymmetric return-map (`integrateHsAxiStep` / `hsOedometerRun`) and the implicit two-parameter (M, K_s/K_c) ← (K₀ᴺᶜ, E_oed^ref) calibration (`calibrateHsCap`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the HS CAP OEDOMETER / K₀ BRANCH — the combined shear+cap axisymmetric
return-map (`integrateHsAxiStep` / `hsOedometerRun`) and the implicit two-parameter
(M, K_s/K_c) ← (K₀ᴺᶜ, E_oed^ref) calibration (`calibrateHsCap`). This completes HS
double-hardening: both yield surfaces active at once on a 1-D compression path.
PLAXIS has NO closed form for M (MMM 2015 §6.5: "M ↔ K₀ᴺᶜ") — it is solved numerically,
which is exactly what `calibrateHsCap` does.
Layered validation:
1. EXACT LIMIT (cap off): with K_s/K_c ≤ 1 the combined integrator reproduces the
independently-validated SHEAR-ONLY drained triaxial (`hsTriaxialDrained`) — proving
the shear branch of the combined return is untouched.
2. EXACT LIMIT (isotropic): under isotropic strain the deviator stays exactly zero —
the symmetrised cap flow preserves axisymmetry (dε2^p = dε3^p).
3. CALIBRATION: the calibrated pair reproduces the target K₀ᴺᶜ (=1−sinφ) AND E_oed^ref.
4. INDEPENDENT CROSS-CHECK: the oedometer tangent modulus E_oed(σv) from the combined
return-map matches the shipped, separately-validated `computeHsDouble` E_oed(σv)
power law across σv = 100/200/400 kPa.
5. PHYSICS: K₀ stays constant along NC loading (a radial stress path) — the defining
signature of a correctly-calibrated cap.
6. the consistent-γ^p initialiser leaves the shear surface exactly satisfied (a K₀ state
with γ^p = 0 would be over-yielded, which drives the return non-physical).
Refs (on disk): Schanz, Vermeer & Bonnier (1999) §4; PLAXIS 2015 Material Models Manual
§6.5 (Eq 6.21–6.23, M ↔ K₀ᴺᶜ).
| Test block (the published value it checks) | Verdict |
| EXACT limit — cap off (K_s/K_c ≤ 1) reproduces the validated shear-only triaxial | Pass |
| EXACT limit — isotropic strain keeps the deviator exactly zero (axisymmetric cap flow) | Pass |
| implicit calibration reproduces BOTH K₀ᴺᶜ and E_oed^ref | Pass |
| INDEPENDENT cross-check: E_oed(σv) matches the validated computeHsDouble power law | Pass |
| K₀ stays constant along NC loading (a radial stress path — the calibrated-cap signature) | Pass |
| consistent-γ^p / p_p initialisers leave BOTH surfaces exactly satisfied at a K₀ state | Pass |
hs-cap-web-validation.test.ts
Validation for the HS VOLUMETRIC CAP (compaction hardening) — the second HS yield surface (`hs-material-point.ts`: hsCapParams / integrateHardeningSoilVolumetric / hsIsotropicCompression).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the HS VOLUMETRIC CAP (compaction hardening) — the second HS yield
surface (`hs-material-point.ts`: hsCapParams / integrateHardeningSoilVolumetric /
hsIsotropicCompression). SVB (1999) §4 + PLAXIS Material Models Manual (2015)
Eq 6.21–6.23.
The cap closes the elastic region on the p-axis so isotropic / oedometer compression
produces plastic volume strain. This suite validates the cap on the ISOTROPIC path
(q̃=0, where the shape parameter M is irrelevant), against the defining relationships:
1. the elasto-plastic compression bulk modulus K_c = K_s^ref/(K_s/K_c) (Eq 6.22),
2. the swelling (unload/reload) modulus K_s = K_s^ref = E_ur^ref/(3(1−2ν_ur)) (Eq 6.23),
3. the ratio K_c/K_s = 1/(K_s/K_c) with K_s/K_c from K₀ᴺᶜ, E_ur^ref, E_oed^ref, ν_ur,
4. stress-dependency of both moduli via the (p/p_ref)^m power law,
5. the pre-consolidation (OCR) behaviour — elastic inside the cap, plastic once the
mean stress reaches p_p, and p_p hardening to track the maximum mean stress.
Scope note: the oedometer/K₀ path additionally needs the implicit M(K₀ᴺᶜ) calibration
and the combined shear+cap return (PLAXIS solves M and K_s/K_c iteratively) — a follow-up.
Refs (on disk): Schanz, Vermeer & Bonnier (1999) §4; PLAXIS 2015 Material Models Manual §6.5.
| Test block (the published value it checks) | Verdict |
| cap parameters: K_s^ref = E_ur^ref/(3(1−2ν_ur)) and K_s/K_c > 1 (Eq 6.23) | Pass |
| cap DISABLED when E_oed^ref omitted (shear-hardening only, no regression) | Pass |
| K_c = K_s^ref/(K_s/K_c) and K_s = K_s^ref at the reference pressure (Eq 6.22) | Pass |
| both moduli follow the (p/p_ref)^m stress-dependency | Pass |
| pre-consolidation (OCR): elastic inside the cap, plastic once p reaches p_p | Pass |
| p_p hardens to track the maximum mean stress under virgin (NC) loading | Pass |
| isotropic loading is softer than swelling (K_c < K_s) — the defining compaction-hardening signature | Pass |
hs-material-point-web-validation.test.ts
Validation for the Hardening-Soil material-point integrator (`hs-material-point.ts`) — the general SVB return-map (shear/cone hardening) that the 2-D FE will use.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the Hardening-Soil material-point integrator (`hs-material-point.ts`)
— the general SVB return-map (shear/cone hardening) that the 2-D FE will use.
The single-element drained-triaxial driver must reproduce the Schanz-Vermeer-Bonnier
(1999) hyperbolic q–ε₁ response and the Mohr-Coulomb failure deviator, at any
confining pressure. The reference q–ε₁ backbone is the already-validated closed-form
SVB SoilTest (`hardening-soil-double.ts`, itself checked vs SVB Hostun sand); the
failure stress and E₅₀ secant are absolute cited anchors.
Loose Hostun sand stiffnesses (SVB 1999 Table 1: E₅₀ʳᵉᶠ 20 MPa, Euʳʳ 60 MPa, m 0.65, φ 34°) with c 1 kPa,
ψ 4°, p_ref 100 kPa, R_f 0.9. ATTRIBUTION NOTE (2026-10): σ₁_f(σ₃=300) = 1064.9 kPa is NOT printed in SVB
(which uses c = 0); it is the closed-form Mohr–Coulomb value printed in the COMSOL Multiphysics 6.3
Application Library "Triaxial Test with Hardening Soil Material Model", Table 2 (c = 1 kPa). It checks the
MC strength cap only.
Refs: Schanz, Vermeer & Bonnier (1999); Rowe (1962).
| Test block (the published value it checks) | Verdict |
| HS return-map reproduces the SVB drained-triaxial hyperbola at σ₃=100 kPa (<3%) | Pass |
| HS return-map reproduces the SVB drained-triaxial hyperbola at σ₃=200 kPa (<3%) | Pass |
| HS return-map reproduces the SVB drained-triaxial hyperbola at σ₃=300 kPa (<3%) | Pass |
| HS return-map reproduces the SVB drained-triaxial hyperbola at σ₃=600 kPa (<3%) | Pass |
| failure deviator = MC: σ₁_f(σ₃=300) = 1064.9 kPa (COMSOL 6.3 Table 2 closed-form MC value, not an SVB number) | Pass |
| the driven deviator approaches the MC failure envelope q_f at large strain | Pass |
| secant modulus at q_f/2 equals E₅₀(σ₃) (the HS E₅₀ definition) | Pass |
| isotropic (deviator-free) loading stays elastic on the shear surface (γ^p unchanged) | Pass |
| mobilised friction hardens with plastic shear strain toward the peak φ | Pass |
| higher confining pressure → higher failure deviator and stiffer response | Pass |
| general Cartesian material point: isotropic + deviatoric strain returns a coaxial plastic state | Pass |
| general Cartesian material point handles an off-axis shear strain increment (finite, hardening) | Pass |
hs-small-fe-web-validation.test.ts
Validation for the HS-Small small-strain constitutive OVERLAY (`hs-small-stiffness.ts`): the stress-dependent very-small-strain modulus G0(σ3) and the simple-shear constitutive integrator `hsSmallSimpleShear` — the per-integration-point st…
Analyses validated: hs-small, soil-models · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the HS-Small small-strain constitutive OVERLAY (`hs-small-stiffness.ts`):
the stress-dependent very-small-strain modulus G0(σ3) and the simple-shear constitutive
integrator `hsSmallSimpleShear` — the per-integration-point stress-strain response an FE
Gauss loop uses (previously only the secant/tangent reduction FORMULAS existed).
Anchors:
1. the strain-integrated secant modulus G_s = τ/γ reproduces the closed-form
Hardin-Drnevich secant `hsSmallSecantG` below the G_ur cut-off — proving the tangent
modulus integrates EXACTLY to the secant (τ = G0·γ/(1+aγ/γ0.7)), i.e. G_t is safe to
use incrementally in an FE Gauss loop;
2. G_s(γ0.7)/G0 = 0.722 (the definition of γ0.7);
3. stress-dependent G0(σ3) follows the (σ3/p_ref)^m power law (Benz 2007 / SVB);
4. beyond the cut-off strain the tangent floors at G_ur (the overlay never softens below
the HS unload-reload stiffness) and the response stiffens vs pure Hardin-Drnevich;
5. the secant modulus degrades monotonically with strain.
Refs (on disk): Benz (2007) small-strain stiffness; Hardin & Drnevich (1972); Santos &
Correia (2001). This file covers the stand-alone PRIMARY curve (the 1-D calculator). The FE Gauss-point law —
tensor strain history with reset on reversal, the reloading curve and the hᵢ attenuation (KB-2, 12 Nov 2026) —
is gated in hs-small-kernel-law-web-validation.test.ts.
| Test block (the published value it checks) | Verdict |
| tangent integrates exactly to the Hardin-Drnevich secant (below the G_ur cut-off) | Pass |
| G_s(γ0.7)/G0 = 0.722 (definition of γ0.7) | Pass |
| stress-dependent G0(σ3) follows the (σ3/p_ref)^m power law | Pass |
| tangent floors at G_ur beyond the cut-off strain (never softer than unload-reload) | Pass |
| secant modulus degrades monotonically with shear strain | Pass |
hs-small-general-web-validation.test.ts
Validation for the GENERAL-STRESS (Voigt6) HS-Small material point `integrateHsSmallGeneral` — the FE Gauss-point entry that couples the Benz (2007) Small-Strain Overlay to the Hardening-Soil return map.
Analyses validated: hs-small · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the GENERAL-STRESS (Voigt6) HS-Small material point
`integrateHsSmallGeneral` — the FE Gauss-point entry that couples the Benz
(2007) Small-Strain Overlay to the Hardening-Soil return map. Since KB-2
(12 Nov 2026) it is the kernel's law: the step's elastic G is the RELOADING
curve (2·γ0.7) integrated over the step with the G_ur cut-off, and primary
loading is that elasticity plus HS plasticity attenuated by hᵢ = Gm^(1 + Eur/Ei)
(Benz Eqs 7.32–7.34; App. A line 192). The closed-form goldens of the law are
in `hs-small-kernel-law-web-validation.test.ts`; TS ↔ Python parity in
`hs-small-parity-recorded.test.ts`.
Anchors:
1. With the overlay inert (G0 = G_ur^ref), HS-Small reduces to the
already-validated plain HS return map — over a whole strain path.
2. On a purely ELASTIC path (inside the cone) the secant follows the
reloading curve G0/(1 + aγ/(2γ0.7)), measured THROUGH the integrator.
3. Small-strain stiffening: the mobilised shear modulus starts at G0 and
degrades monotonically, never below G_ur.
4. A fully general (shear-coupled) strain increment yields a finite stress.
Refs (on disk): Benz (2007) small-strain stiffness; Hardin & Drnevich (1972);
Santos & Correia (2001); Schanz, Vermeer & Bonnier (1999).
| Test block (the published value it checks) | Verdict |
| HS-Small with G0 = Gur^ref reduces to plain HS (1e-9) | Pass |
| HS-Small: an elastic (inside-the-cone) path follows the reloading curve G0/(1 + aγ/(2γ0.7)) (γ = 3/2 εq) | Pass |
| ENG-2: HS-Small γHist of an undrained triaxial increment equals ε1 − ε3 (PLAXIS Eq. 7.6) | Pass |
| HS-Small: mobilised shear modulus floors at the HS Eur modulus at large strain | Pass |
| HS-Small: general shear-coupled increment returns a finite stress | Pass |
hs-small-kernel-law-web-validation.test.ts
HS-small (Benz 2007) — the kernel's law in the TypeScript twin (KB-2, 12 Nov 2026).
Analyses validated: hs-small, soil-models · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
HS-small (Benz 2007) — the kernel's law in the TypeScript twin (KB-2, 12 Nov 2026). Golden gates WRITTEN
BEFORE THE FIRST RUN, each against a closed form derived from the thesis (not from the implementation):
G1 small-strain limit: a step whose γHist stays below 1e-6 returns G0 EXACTLY (App. A line 195); a virgin
step of 2e-6 returns G0/(1 + 2e-6/f2) (f2 = 2γ0.7/0.385) — G → G0 as γ → 0.
G2 first-loading degradation curve: the overlay's MONOTONIC stiffness Gm·Gur of a virgin step 0 → γ is the
Hardin–Drnevich secant G0/(1 + 0.385γ/γ0.7) (Eq. 6.8; App. A GBct(1), line 154) to 1e-12, and 1/1.385 of G0
at γ = γ0.7 (the definition of γ0.7). Plus the kernel's own expectations, `kernel/crates/tbk-core/tests/
hs_small_gamma_hist.rs` (same Benz Table D.1 dense set, Gur 36 000, G0/Gur 3): γHist = ε1 − ε3 in
undrained and drained triaxial, (√3/2)γxy in simple shear, H after 10 triaxial steps = (5d, −10d, 5d), and
Gm after step 10 = Eq. 6.10 integrated over [γ9, γ10] — each to 1e-9.
G3 Gur cut-off: a step that starts beyond γc(reload) = (√(G0/Gur) − 1)·f2 returns Gur EXACTLY; a step that
straddles γc returns (G0(γc/(1+γc/f2) − γ1/(1+γ1/f2)) + Gur(γ2 − γc))/(γ2 − γ1) to 1e-12 (Eq. 6.10 with
Eqs 7.30/7.31; App. A line 158); no step on a 400-step path ever returns less than Gur. The 1-D
calculator's secant beyond γc is (τ(γc) + Gur(γ − γc))/γ — 31 494 kPa at γ = 2e-3 on G0 1e5 / γ0.7 2e-4 /
Gur 25 000 (hand: γc = 5.1948e-4, τc = 25.974 kPa) — and agrees with the independently integrated
`hsSmallSimpleShear` within 0.5 %.
G4 Masing after one reversal (§6.1.3 rules 1–2): load triaxially to γ = 3e-4, reverse by Δγ = 1.5e-5 — the
reversed components reset, γ1 = 0, and G = G0/(1 + Δγ/f2) (back at G0, on the 2·γ0.7 curve) to 1e-12; a
second reversed step integrates the same curve over [Δγ, 2Δγ]; Gm keeps its pre-reversal minimum
(Eq. 6.13 memory). The same reset in simple shear.
G5 hᵢ attenuation (Eqs 7.33/7.34), one drained triaxial step from σ = 100 kPa isotropic (γᵖ = 0, ψ = 0, σ3
held at 100 kPa): the total strain x = ε1 − ε3 satisfies x = q/(2·G_el) + 0.75·γ_mob(q)/hᵢ with
G_el = G0/(1 + 0.385x/(2γ0.7)), hᵢ = (G0/Gur/(1 + 0.385x/γ0.7))^(1 + Eur/Ei), Ei = 2E50/(2 − Rf),
γ_mob(q) = (2/Ei)q/(1 − q/qa) − 2q/Eur with the HS Eur (Benz Box 7.1 f13) — to 1e-6.
G6 KB-2a regression: from an isotropic state in simple shear the HS-small secant is ≥ the plain-HS secant at
every strain to γxy = 1e-3, and ≥ 3× it at γxy = 1e-5 (before the fix it was 18 % SOFTER).
G7 With G0 = Gur^ref the overlay is inert and HS-small is plain HS over a whole path (1e-9).
G8 Refusals as the kernel's `HsParams::validate`: G0 ≤ Gur^ref, G0/Gur^ref > 20, γ0.7 ∉ (0, 0.1).
Refs (on disk): Benz (2007) thesis — Eqs 6.7–6.13 (pp. 62–65), 7.27–7.34 (pp. 83–85), App. A (pp. 167–170);
PLAXIS MMM 2015 ch. 7; Hardin & Drnevich (1972).
| Test block (the published value it checks) | Verdict |
| G1 small-strain limit: G = G0 exactly below γHist 1e-6; G → G0 as γ → 0 on the reloading curve | Pass |
| G2 first loading: Gm·Gur of a virgin step is the Hardin–Drnevich secant G0/(1 + 0.385γ/γ0.7) | Pass |
| G2 kernel expectations (hs_small_gamma_hist.rs): γHist measure, history accumulation, Gm over [γ9, γ10] | Pass |
| G3 Gur cut-off: Gur beyond γc(reload); the straddling step integrates the cut-off; never below Gur | Pass |
| G3 1-D calculator: the secant beyond γc integrates the tangent cut-off (Benz Fig. 7.6), = 31 494 kPa at γ = 2e-3 | Pass |
| G4 Masing after one reversal: back to G0 on the 2·γ0.7 curve; Gm keeps its minimum | Pass |
| G5 hᵢ attenuation: one drained triaxial step from 100 kPa isotropic matches the hand form to 1e-6 | Pass |
| G6 KB-2a: from an isotropic state HS-small is never softer than plain HS, and ≥ 3× stiffer at γxy = 1e-5 | Pass |
| G7 G0 = Gur^ref: the overlay is inert and HS-small is plain HS over a path (1e-9) | Pass |
| G8 refusals: the kernel’s HsParams::validate rules | Pass |
hs-small-stiffness-web-validation.test.ts
Validation for the HS-Small small-strain stiffness overlay (`hs-small-stiffness.ts`).
Analyses validated: hs-small, soil-models · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the HS-Small small-strain stiffness overlay
(`hs-small-stiffness.ts`). the release rules gate.
Anchors (independent — Benz 2007; Hardin & Drnevich 1972; Santos & Correia):
• G_s = G0 at γ→0.
• G_s = 0.722·G0 exactly at γ = γ0.7 (the DEFINITION of γ0.7).
• monotonic decay of G_s with γ; tangent < secant.
• cut-off at G_ur.
| Test block (the published value it checks) | Verdict |
| G_s → G0 as γ → 0 | Pass |
| G_s = 0.722·G0 exactly at γ = γ0.7 (definition) | Pass |
| tangent modulus below secant, and G_t = G0/(1+aγ/γ07)² | Pass |
| monotonic decay of G_s with increasing γ | Pass |
| cut-off at G_ur: G never below G_ur; cut-off strain consistent | Pass |
mc-general-stress-web-validation.test.ts
Web-benchmark validation for the symmetric-3×3 eigensolver + general-stress (Cartesian) Mohr-Coulomb material point (`tensor-3x3.ts` + the general MC entry in `mc-material-point.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the symmetric-3×3 eigensolver + general-stress
(Cartesian) Mohr-Coulomb material point (`tensor-3x3.ts` + the general MC
entry in `mc-material-point.ts`). ≥20 cited/derived values — the release rules gate.
Anchors (independent):
• Eigenvalues of a symmetric matrix — analytic (diagonal + 2×2 block).
• Frame indifference / objectivity: MC yield depends only on stress
invariants, so I1 and J2 of the returned stress are rotation-invariant
(de Souza Neto §A; any continuum-mechanics text).
• Axis-aligned general return must equal the (independently validated)
principal integrator.
| Test block (the published value it checks) | Verdict |
| eigSym3 of a diagonal matrix returns sorted diagonal | Pass |
| eigSym3 of a 2×2 shear block: [[2,1],[1,2]] → 3 and 1 | Pass |
| eigSym3 reconstruct: Σ λ n⊗n recovers the original tensor | Pass |
| general MC (axis-aligned) equals the principal integrator | Pass |
| general MC return lands on the surface for a shear state, φ=20 | Pass |
| general MC return lands on the surface for a shear state, φ=30 | Pass |
| general MC return lands on the surface for a shear state, φ=40 | Pass |
| objectivity: I1 and J2 of the returned stress are rotation-invariant | Pass |
| general MC small step stays elastic | Pass |
mc-material-point-web-validation.test.ts
Web-benchmark validation for the Mohr-Coulomb material-point integrator (`mc-material-point.ts`).
Analyses validated: mohr-coulomb · Recorded run: passed — 23 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the Mohr-Coulomb material-point integrator
(`mc-material-point.ts`). ≥20 cited values spanning common, extreme and
boundary inputs — the the release rules hard gate for "trusted numerics".
Sources:
• MC failure state — Das, "Principles of Geotechnical Engineering" §; Bowles
"Foundation Analysis and Design" 5e; the closed form in `mohr-coulomb.ts`
(σ1f = σ3·Nφ + 2c√Nφ, Nφ = tan²(45+φ/2)). Cross-checked here.
• COMSOL Multiphysics 6.3 Application Library "Triaxial Test with Hardening Soil Material Model",
Table 2 (σ3=300 kPa, φ=34°, c=1 kPa → σ1f = 1064.9 kPa, the closed-form MC value) — the same
anchor `hs-stress-point.ts` is validated to. (Earlier text called this "an established FE code".)
• Return-mapping algorithm — de Souza Neto, Perić & Owen (2008) §8.2
("Computational Methods for Plasticity"), on disk.
• Dilatancy / plastic flow direction — Potts & Zdravković Vol 1 §; Vermeer &
de Borst (1984) non-associated MC.
Tolerances are numerical (return-map convergence / rounding), not slop.
| Test block (the published value it checks) | Verdict |
| MC failure deviator matches closed form: σ3=50, c=10, φ=30 | Pass |
| MC failure deviator matches closed form: σ3=100, c=10, φ=30 | Pass |
| MC failure deviator matches closed form: σ3=200, c=10, φ=30 | Pass |
| MC failure deviator matches closed form: σ3=100, c=0, φ=35 | Pass |
| MC failure deviator matches closed form: σ3=200, c=0, φ=35 | Pass |
| MC failure deviator matches closed form: σ3=300, c=0, φ=40 | Pass |
| MC failure deviator matches closed form: σ3=100, c=25, φ=0 | Pass |
| MC failure deviator matches closed form: σ3=50, c=50, φ=0 | Pass |
| MC failure deviator matches closed form: σ3=300, c=1, φ=34 | Pass |
| MC failure deviator matches closed form: σ3=10, c=5, φ=25 | Pass |
| MC failure deviator matches closed form: σ3=500, c=20, φ=38 | Pass |
| COMSOL 6.3 Table 2 MC benchmark: σ3=300, φ=34°, c=1 → σ1f ≈ 1064.9 kPa | Pass |
| elastic step below yield returns the exact elastic stress (no plastic) | Pass |
| elastic deviatoric step just inside the surface stays elastic | Pass |
| plastic return lands ON the yield surface (f≈0), φ=20 | Pass |
| plastic return lands ON the yield surface (f≈0), φ=30 | Pass |
| plastic return lands ON the yield surface (f≈0), φ=40 | Pass |
| returned stress satisfies the MC criterion σ1 = σ3·Nφ + 2c√Nφ | Pass |
| apex return: isotropic tensile pull → σ = −c·cotφ, c=10, φ=30 | Pass |
| apex return: isotropic tensile pull → σ = −c·cotφ, c=20, φ=35 | Pass |
| associated (ψ=φ) dilates; ψ=0 is (near) isochoric plastic flow | Pass |
| drained triaxial integrates to q_f (multi-step), φ=30, c=10 | Pass |
| drained triaxial integrates to q_f (multi-step), φ=35, c=0 | Pass |
mcc-general-web-validation.test.ts
Validation for the GENERAL-STRESS (Voigt6) Modified Cam-Clay material point `integrateModifiedCamClayGeneral` — the FE Gauss-point entry that lets the general T6 solver run critical-state plasticity.
Analyses validated: cam-clay-triaxial, soil-models · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the GENERAL-STRESS (Voigt6) Modified Cam-Clay material point
`integrateModifiedCamClayGeneral` — the FE Gauss-point entry that lets the
general T6 solver run critical-state plasticity.
The general integrator must reduce EXACTLY to the already-validated triaxial
`mccStep` on any triaxial-compression path (same invariant return, radial
deviatoric mapping), and reproduce the closed-form undrained NC critical
state. It must also stay on the yield surface for a fully general (shear-
coupled) stress state, which the triaxial core never exercises.
Anchors (not our own code):
• CSL slope M = 6 sinφ_cs/(3−sinφ_cs) — Muir Wood; Schofield & Wroth.
• NC undrained: p′_cs = p′₀·(½)^Λ, q_cs = M·p′_cs, Λ = (λ−κ)/λ — Muir Wood;
Wroth 1984; Britto & Gunn.
• Invariant-space coaxial return for isotropic associated plasticity —
de Souza Neto, Perić & Owen (2008); Borja; Potts & Zdravković Vol.1.
| Test block (the published value it checks) | Verdict |
| MCC general ≡ triaxial mccStep on a triaxial path (dilatant shear) | Pass |
| MCC general ≡ triaxial mccStep on a triaxial path (isotropic compression) | Pass |
| MCC general ≡ triaxial mccStep on a triaxial path (near-undrained shear) | Pass |
| MCC general undrained NC critical state (φ_cs=25.4°) | Pass |
| MCC general undrained NC critical state (φ_cs=30°) | Pass |
| MCC general undrained NC critical state (φ_cs=22°) | Pass |
| MCC general elastic step is non-plastic and exact | Pass |
| MCC general: plastic state lies on the yield surface (triaxial) | Pass |
| MCC general: plastic state on the yield surface under shear strain | Pass |
mohr-coulomb-web-validation.test.ts
PUBLISHED-VALUES(mohr-coulomb): 17 -- distinct published values for this engine (engine-level total, declared once); re-run author's strict count: the 21 includes 4 Lambe & Whitman sigma1f/ratio pairs that are the same four experiments pri…
Analyses validated: mohr-coulomb · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES(mohr-coulomb): 17 -- distinct published values for this engine (engine-level total, declared once); re-run author's strict count: the 21 includes 4 Lambe & Whitman sigma1f/ratio pairs that are the same four experiments printed twice. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Mohr-Coulomb failure state (`mohr-coulomb.ts`) — the constitutive backbone behind the
`/tools/soil-models` surface; `bearing-capacity`, `slope-stability`, `earth-pressure` and the FE
plasticity kernels all rest on the same failure criterion.
Relations implemented (exact closed forms):
N_φ = tan²(45° + φ/2) flow factor
σ1f = σ3·N_φ + 2c·√N_φ major principal stress at failure
q_u = 2c·√N_φ (σ3 = 0) unconfined compressive strength
θ_f = 45° + φ/2 failure-plane angle to the major plane
σ_n = s − r·sin φ, τ_f = r·cos φ on the failure plane,
with s = (σ1+σ3)/2, r = (σ1−σ3)/2
PUBLISHED SOURCES (every number in the section "PUBLISHED VALUES" at the foot of this file was read
from the page named beside it, from a PDF opened in this session — none is recalled from memory):
1. Lambe, T.W. & Whitman, R.V. (1979), Soil Mechanics, SI Version, Wiley — Example 11.1 (p. 140,
four drained triaxial tests on a dense quartz sand), Example 11.2 (p. 142), and Fig. 21.6
(p. 308, straight-line fit c = 7.4 kPa, φ′ = 21.5°, a = 6.9 kPa for over-consolidated Weald clay).
2. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Spon — Example 5.2 (p. 178),
Tables 5.2–5.3: three CU triaxial circles with secant φ′ = 35°, 33°, 31° and tangent c′ = 20,
φ′ = 29° for 200–300 kPa.
3. PLAXIS (2006), PLAXIS 3D Foundation Validation Manual v1.5 — §2.3 "Bi-axial test with
Mohr-Coulomb model" (pp. 2-5/2-6: c = 1, φ = 30°, σ2 = 1 kPa → σ1 = 6.46 theoretical, 6.48 FE) and
§2.4 "Triaxial test with hardening soil model" (pp. 2-7/2-8: c′ = 1, φ′ = 35°, σ3 = 100 kPa →
372.9 / 26.1 kPa theoretical, 373.3 FE in compression).
4. COMSOL Multiphysics 6.3 Application Library, "Triaxial Test with Hardening Soil Material Model"
(Table 2: c = 1 kPa, φ = 34°, σ3 = 300 kPa → −1064.9 kPa compression, −83.7 kPa extension) — a
vendor document, not a textbook or a standard, and listed last for that reason. It is NOT in
the Schanz–Vermeer–Bonnier hardening-soil paper, which uses c = 0 and prints no failure stress.
The bare 1776/1900 dates (Coulomb, Mohr) name the criterion's origin and are not validation sources.
WHAT IS AND IS NOT PUBLISHED HERE. The six earlier tests below (N_φ table, 12 σ1f cases, φ = 0 clay, q_u,
failure-plane geometry, monotonicity) check the engine against the closed form in `published()`, which is
written from the same equations — they prove the equation was implemented as written and catch a
θ_f = 45° − φ/2 mix-up, but they are hand-computed checks, NOT published answers, and are not counted
as such. The published-answer count is reported in the last test and is counted by distinct printed
numbers compared, never by assertion calls.
WHY THE ANGLE CONVENTION IS ASSERTED EXPLICITLY. θ_f = 45° + φ/2 is measured to the plane on
which the MAJOR principal stress acts. The complement (45° − φ/2) is the angle to the minor
principal plane, and mixing the two is the classic sign error in this derivation — it silently
swaps σ_n and τ_f on the failure plane. So the tests below check θ_f, σ_n and τ_f together
against the same Mohr-circle geometry, which is what makes a swap detectable.
| Test block (the published value it checks) | Verdict |
| N_φ = tan²(45° + φ/2) — the published flow factor at 8 friction angles | Pass |
| σ1f = σ3·N_φ + 2c·√N_φ — 12 published failure states | Pass |
| undrained clay (φ = 0): the deviator at failure is 2c, independent of confining stress | Pass |
| unconfined compressive strength q_u = 2c·√N_φ | Pass |
| failure-plane geometry: θ_f = 45° + φ/2, and σ_n / τ_f from the same Mohr circle | Pass |
| monotonicity and finiteness across the admissible parameter range | Pass |
| Lambe & Whitman Ex 11.1 (p. 140): σ1f from printed σ3f and φ, four tests | Pass |
| Lambe & Whitman Ex 11.1 (p. 140): θcr = 45° + φ/2 = 66° for the average φ = 42.1° | Pass |
| Lambe & Whitman Ex 11.2 (p. 142): sinφ = tanα = 0.675 on the p–q diagram, φ = 42.5° | Pass |
| Craig Ex 5.2 (p. 178): printed σ′1 lies in the ±0.5° bracket of the printed secant φ′ | Pass |
| Lambe & Whitman Fig. 21.6 (p. 308): p–q intercept a = c·cosφ′ = 6.9 kN/m² for c = 7.4, φ′ = 21.5° | Pass |
| PLAXIS 3DF Validation Manual §2.3 (pp. 2-5/2-6): MC bi-axial failure stress 6.46 (theory), 6.48 (FE) | Pass |
| PLAXIS 3DF Validation Manual §2.4 (pp. 2-7/2-8): 372.9 and 373.3 compression, 26.1 extension | Pass |
| COMSOL HS triaxial Table 2: MC failure stress 1064.9 kPa compression, 83.7 kPa extension (c = 1, φ = 34°, σ3 = 300) | Pass |
| the published-value tally is 21 distinct printed numbers from 4 sources | Pass |
ngi-adp-web-validation.test.ts
Web-benchmark validation for the NGI-ADP anisotropic undrained material point (`ngi-adp.ts`).
Analyses validated: ngi-adp · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the NGI-ADP anisotropic undrained material point
(`ngi-adp.ts`). ≥10 cited values — the the release rules hard gate.
Independent closed-form anchors (all traceable):
• NGI-ADP model (Grimstad et al. 2012) (Eqs 12.2, 12.3/12.22, §12.2) —
the κ=1 elliptical failure envelope: Active→suA, Passive→suP, DSS→suDSS,
centre (suA−suP)/2, radius (suA+suP)/2, τ0 = ½σ'v0(1−K0).
• Grimstad, Andresen & Jostad (2012) IJNAMG 36(4):483-497 — same envelope.
• Davis & Christian (1971) — the κ=1 ellipse (isotropic-hardening limit).
• Isotropic reduction suA=suP=suDSS=su ⇒ Tresca: τmax=su, q=σ1−σ3=2su
(Muir Wood, "Soil Behaviour & Critical State Soil Mechanics").
| Test block (the published value it checks) | Verdict |
| NGI-ADP ellipse constants RA, RB, RD (Grimstad 2012 Eq 12.22) | Pass |
| NGI-ADP Active strength → suA (P1=40, P2=100) | Pass |
| NGI-ADP Passive strength → suP (P1=16, P2=60) | Pass |
| NGI-ADP DSS strength → suDSS (P1=26.4, P2=80) | Pass |
| NGI-ADP f=0 at Active/Passive/DSS failure points (Eq 12.3) | Pass |
| NGI-ADP isotropic → Tresca: su=25 ⇒ q=2su=50 | Pass |
| NGI-ADP isotropic → Tresca: su=50 ⇒ q=2su=100 | Pass |
| NGI-ADP isotropic → Tresca: su=120 ⇒ q=2su=240 | Pass |
| NGI-ADP τ0 = ½σ'v0(1−K0) | Pass |
| NGI-ADP hardening κ(γp) endpoints + peak (Eq 12.2) | Pass |
| NGI-ADP envelope sweep — all points satisfy f=0 | Pass |
| NGI-ADP interior f<0, exterior f>0 | Pass |
| NGI-ADP M from φ (6sinφ/(3−sinφ)) | Pass |
| NGI-ADP integrator: monotone vertical shear → peak τ = suA (Active) | Pass |
| NGI-ADP integrator: pure shear at the ellipse-centre deviator → peak τxy = suDSS | Pass |
soft-soil-creep-web-validation.test.ts
Web-benchmark validation for the Soft-Soil-Creep material point (`soft-soil-creep.ts`).
Analyses validated: soft-soil-creep · Recorded run: passed — 15 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the Soft-Soil-Creep material point
(`soft-soil-creep.ts`). ≥10 cited values — the the release rules hard gate.
Independent closed-form anchors (all traceable):
• Soft-Soil-Creep model (Vermeer & Neher 1999) (Eqs 9.6, 9.9, 9.18, 9.19, 9.22,
9.23, 9.28) — parameter conversion, equivalent stress, M, creep rate,
elastic swelling.
• Vermeer & Neher (1999) — the SSC formulation.
• Buisman (1936)/Garlanger (1972): 1-D creep εv^c = μ*·ln((τc+t′)/τc); the
per-log-decade slope Cαε = Cα/(1+e0) (Mesri & Godlewski 1977).
• Muir Wood, "Soil Behaviour & Critical State Soil Mechanics" (λ, κ, M).
NOTE: the constant-load creep ODE (Eq 9.23 with p^eq fixed and p_p^eq ageing)
integrates EXACTLY to the Buisman form εv^c = μ*·ln(1+t/τ) with τc=τ — the
independent closed form the integrator is checked against.
| Test block (the published value it checks) | Verdict |
| SSC M = 6sinφ/(3−sinφ) (Eq 9.19) | Pass |
| SSC φ↔M round-trip (inverse of Eq 9.19) | Pass |
| SSC parameter conversion Cc/Cs/Cα/e0 → λ*,κ*,μ* (Eqs 9.6/9.9/9.22) | Pass |
| SSC parameter conversion — soft-clay set 2 | Pass |
| SSC creep strain per log-decade = μ*·ln10 = Cα/(1+e0) (Mesri & Godlewski) | Pass |
| SSC Buisman 1-D creep: t′=τc → μ*·ln2 ; per decade → μ*·ln10 | Pass |
| SSC creep rate at NC (OCR=1) = μ*/τ (Eq 9.23) | Pass |
| SSC creep rate decreases with OCR (over-consolidation slows creep) | Pass |
| SSC μ*=0 → zero creep rate (Soft-Soil limit) | Pass |
| SSC ageing pre-consolidation grows with creep (Bjerrum) | Pass |
| SSC equivalent stress (Eq 9.18): q=0 → p^eq=p′ ; on CSL q=Mp′ → 2p′ | Pass |
| SSC elastic swelling κ*·ln(p′/p′0) (Eq 9.28) | Pass |
| SSC oedometer creep ODE integrates to Buisman μ*·ln(1+t/τ) | Pass |
| SSC oedometer late-time slope → μ*·ln10 per decade | Pass |
| SSC step μ*=0: pure elastic κ* response, no creep | Pass |
soil-calibration-web-validation.test.ts
Validation for the SoilTest calibration lab (`soil-calibration.ts`).
Analyses validated: mohr-coulomb, soil-calibration · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the SoilTest calibration lab (`soil-calibration.ts`).
the release rules gate. Anchor: RECOVER known parameters from synthetic test data
generated by the (independently-validated) closed forms — exact for clean
data, robust under noise. Cross-checked against `mohr-coulomb.ts`.
STATUS — PARTIAL, formula-fidelity for the bulk. The synthetic-recovery tests below prove the fitting
arithmetic is self-consistent; they are NOT published answers. Seven published values were added
2026-10-07 (each read from the page named; raw data AND the printed result both appear in the book):
1. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Example 5.4 / Table 5.5 (p. 182-183):
UU triaxial σ3/σ1 pairs → c_u = 85 kPa, φ_u = 0; CD triaxial → c′ = 0, φ′ = 27°.
Example 4.1 / Table 4.1 (p. 108-109): oedometer e–σ′ table → C_c = 0.31 on the linear part.
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed. — Example 2.12: (140 kPa, 0.92) and
(212 kPa, 0.86) → C_c = 0.333.
3. Lambe, T.W. & Whitman, R.V. (1979), Soil Mechanics, SI Version, Wiley — Example 11.1 (pp. 140-141): four
triaxial peaks on a dense sand (σ3f 103-827 kPa) → φ = 42.1° (average of the four per-test values), c = 0.
SHORTFALL against the ≥20-published-values / ≥2-sources bar: 7 of 20 published values (3 sources). No
further tabulated raw-data-plus-fitted-result example was found in the texts searched (Craig, Das, Lambe &
Whitman by keyword; the Atkinson and Ou scans have no text layer and were not read); the per-circle secant φ′ of Craig Example 5.2 and the preconsolidation pressure of Example 4.1
(Casagrande, 325 kPa) are outputs this module does not compute. Hence this file stays formula-fidelity
evidence and the manifest must not promote it.
| Test block (the published value it checks) | Verdict |
| fit MC recovers c=15, φ=28 from clean triaxial points | Pass |
| fit MC recovers c=0, φ=35 from clean triaxial points | Pass |
| fit MC recovers c=25, φ=20 from clean triaxial points | Pass |
| fit MC recovers c=5, φ=40 from clean triaxial points | Pass |
| fit MC is robust to measurement noise | Pass |
| fit undrained su = q_f/2 | Pass |
| fit oedometer recovers Cc and Cr | Pass |
| fit E50 = (q_f/2)/ε at half failure | Pass |
| fit CSL M from critical-state points | Pass |
| published: Craig Example 5.4(a) UU triaxial → c_u = 85 kPa, φ_u = 0 | Pass |
| published: Craig Example 5.4(b) CD triaxial → c′ = 0, φ′ = 27° | Pass |
| published: Craig Example 4.1 oedometer Table 4.1 → C_c = 0.31 on the linear part | Pass |
| published: Das Example 2.12 → C_c = 0.333 from (140 kPa, e 0.92) and (212 kPa, e 0.86) | Pass |
| published: Lambe & Whitman Example 11.1 — four triaxial peaks on dense sand → φ = 42.1°, c = 0 | Pass |
soil-structure-interface-web-validation.test.ts
WEB-BENCHMARK validation for the soil-structure interface (Goodman joint) engine.
Analyses validated: soil-structure-interface · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the soil-structure interface (Goodman joint) engine.
≥20 web-sourced / formula-derivable cases (the release rules mandatory step).
Sources: interface reduction factor R_inter (Goodman) (tanδ = R_inter·tanφ, c_i = R_inter·c);
Goodman, Taylor & Brekke (1968) joint element; Potyondy (1961) "Skin Friction between
Various Soils and Construction Materials," Géotechnique 11(4):339 (interface friction
ratios δ/φ). Formula anchors are exact; Potyondy ranges are acceptance bands.
STATUS (audited 2026-10-07) — PARTIAL, formula-fidelity only. The "≥20 web-sourced" claim above is not
met: the A1–A14 anchors are the module's own defining equations (δ = atan(R·tanφ), c_i = R·c,
τ_max = c_i + σ_n·tanδ), evaluated at chosen inputs, not published worked answers; the Potyondy checks
are acceptance ranges, not values. Published printed values reproduced: 0. A keyword search of the local
copy of Potts & Zdravković Vol 2 found interface-element passages on modelling choices and wall case
studies (plotted results), not a tabulated interface-element worked answer; Goodman's rock-mechanics text
was not mined in the time-box. Shortfall: 0 of 20 published values, 0 distinct published sources with values.
| Test block (the published value it checks) | Verdict |
| SSI web A1–A6: interface friction δ = atan(R_inter·tanφ) | Pass |
| SSI web A7–A9: interface adhesion c_i = R_inter·c | Pass |
| SSI web A10–A13: τ_max = c_i + σ_n·tanδ | Pass |
| SSI web A14: R_inter=1 ⇒ interface strength = soil strength | Pass |
| SSI web A15–A17: strength reduction ≈ R_inter (c=0) | Pass |
| SSI web A18–A19: Potyondy steel/sand δ/φ in [0.5, 0.8] | Pass |
| SSI web A20: Potyondy concrete/sand δ/φ ≈ 0.84–1.0 | Pass |
| SSI web A21: Goodman elastic-plastic load-slip (slope k_s, plateau τ_max) | Pass |
ssc-general-web-validation.test.ts
Validation for the GENERAL-STRESS (Voigt6) Soft-Soil-Creep material point `integrateSoftSoilCreepGeneral` — the FE Gauss-point entry for time-dependent secondary compression / creep, so the general T6 solver can run SSC.
Analyses validated: soft-soil-creep · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the GENERAL-STRESS (Voigt6) Soft-Soil-Creep material point
`integrateSoftSoilCreepGeneral` — the FE Gauss-point entry for time-dependent
secondary compression / creep, so the general T6 solver can run SSC.
SSC's creep flow is driven by the equivalent stress p^eq(p′,q) → isotropic /
coaxial response, so the general integrator must reduce EXACTLY to the
validated (p′,q) `sscStep` on a triaxial path, reproduce the normally-
consolidated creep rate mu-star/tau (Vermeer & Neher Eq 9.23 at OCR=1),
degenerate to a rate-independent elastic response at mu-star = 0, and age the
pre-consolidation (Bjerrum) as it creeps.
Refs (on disk): Vermeer & Neher (1999) "A soft soil model that accounts for
creep" Ch.9; Buisman (1936); Bjerrum (1967); Mesri & Godlewski (1977).
| Test block (the published value it checks) | Verdict |
| SSC general ≡ (p′,q) sscStep on a triaxial path (compression + shear) | Pass |
| SSC general ≡ (p′,q) sscStep on a triaxial path (isotropic compression) | Pass |
| SSC general: NC (OCR=1) creep rate is μ*/τ | Pass |
| SSC general: μ*=0 gives no creep and an exact elastic step | Pass |
| SSC general: pre-consolidation ages upward under sustained creep | Pass |
| SSC general: shear-coupled increment returns a finite stress | Pass |
stress-path-web-validation.test.ts
Validation for `stress-path` — p-q (Cambridge) and s-t (MIT) stress-path invariants, mobilised friction and the failure check (`stress-path.ts`).
Analyses validated: stress-path · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `stress-path` — p-q (Cambridge) and s-t (MIT) stress-path invariants, mobilised friction
and the failure check (`stress-path.ts`).
Published sources (every number below was read from the page named beside it in the repo's reference
library; the Head & Epps and Knappett & Craig pages were ALSO read as rendered page images because the
numbers sit in a hand-written lab sheet and in equation images that the text layer drops):
1. Head, K.H. & Epps, R.J. (2014), Manual of Soil Laboratory Testing, Vol. 3 Effective Stress Tests,
3rd ed., Whittles — Ch. 16, Fig. 16.14(a): the worked CU-test stress-path calculation sheet
(sample H6/4 B, cell pressure 600 kPa), p. 76.
2. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley — Ch. 11 Example 11.1
(dense-sand triaxial peak stresses with the p, q and φ values printed, p. 140).
3. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Spon — Ch. 5 Example 5.2
(secant φ′ of three CU circles, p. 178) and Example 5.6 (drained critical-state failure point, pp. 187-188).
4. Craig, R.F. (2004), Craig's Soil Mechanics 7th ed. Solutions Manual, Spon — the printed stress-path
table for the CU test with back pressure 200 kN/m² and cell pressure 600 kN/m² (σ1 − σ3 = 80…319 kN/m²,
u = 229…433 kN/m²): ½(σ′1 + σ′3) and ½(σ′1 − σ′3). Read from a web copy of the manual (the same data is
Problem 5.6 of the 8th edition in the library); 5 rows ×2 = 10 further published values.
WHAT THE ENGINE IS. `computeStressPath` returns p = (σ1 + 2σ3)/3, q = σ1 − σ3, s = (σ1 + σ3)/2,
t = (σ1 − σ3)/2, η = q/p, M = 6 sin φ′/(3 − sin φ′), the mobilised friction sin φ_m = (t − c cos φ)/s and
the Mohr-Coulomb failure check for one effective-stress state.
NOTE ON NOTATION. Lambe & Whitman call the MIT centre "p" and the MIT radius "q" (p = (σ1 + σ3)/2,
q = (σ1 − σ3)/2); these are the engine's s and t, NOT its Cambridge p and q. Head & Epps use s′ and t
for the same quantities, which is the engine's naming.
TOLERANCES, stated per group:
· Head Fig. 16.14 and L&W Example 11.1 print s, t to 0.5 kPa or better and are exact arithmetic on the
printed σ: tolerance 0.05 kPa.
· L&W Example 11.1 φ_f is printed to 0.1° after reading σ1/σ3 to 3 s.f. (5.09, 4.93, 5.20, 5.04) off
a chart: tolerance 0.15° (observed worst difference 0.13°).
· Craig Example 5.2 prints φ′ to the nearest degree: tolerance 0.5°.
· Craig Example 5.6 prints p′f = 425 (q_f/M, M rounded to 0.88) and q_f = 374: tolerance 0.5 kPa on p.
PUBLISHED VALUES: 39 (Head 10 + L&W 8 + L&W φ_f 4 + Craig Ex 5.2 ×3 + Craig Ex 5.6 ×4 + Craig 7th table ×10).
The Head rows were read from handwriting, so every row was also checked for internal consistency
(σ3′ = 600 − u, σ1′ = σ3′ + q, s′ = (σ1′ + σ3′)/2, t = q/2); all five are consistent, so a mis-read digit
would have been caught. The 3.06 % row prints σ1′ as "245" where
σ3′ + q = 246; its printed s′ = 185 and t = 61 are consistent with 246 (a handwriting slip), so σ1′ = 246
is used.
| Test block (the published value it checks) | Verdict |
| Head & Epps Fig. 16.14(a): s′ and t at 0.67, 1.12 and 1.54 % strain | Pass |
| Head & Epps Fig. 16.14(a): s′ and t at 2.18 and 3.06 % strain | Pass |
| L&W Example 11.1: printed p = ½(σ1 + σ3) and q = ½(σ1 − σ3) for the four peak states | Pass |
| L&W Example 11.1: mobilised friction at peak = 42.2°, 41.6°, 42.7°, 42.1° (c = 0) | Pass |
| Craig Example 5.2: secant φ′ of circles (a), (b), (c) = 35°, 33°, 31° | Pass |
| Craig Example 5.6: drained failure point q_f = 374, p′f = 425, η = M = 0.88, path slope 3 | Pass |
| Craig 7th Solutions CU test: printed s′ = 411, 402, 389, 351, 326 and t = 40, 79, 107, 139, 159 kPa | Pass |
⚑ triaxial-csl-web-validation.test.ts
PUBLISHED-VALUES(triaxial-csl): 13 -- distinct published values for this engine (engine-level total, declared once); re-run author's count: of 21 values only 13 are failure states in and a book answer out; 8 feed states built on a publishe…
Analyses validated: triaxial-csl · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES(triaxial-csl): 13 -- distinct published values for this engine (engine-level total, declared once); re-run author's count: of 21 values only 13 are failure states in and a book answer out; 8 feed states built on a published Kf line and check that the published phi'/c' come back (round trips). Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Validation for `triaxial-csl` — least-squares failure envelope q = M·p′ + q0 through triaxial failure
states, and the recovered Mohr-Coulomb φ′ and c′ (`triaxial-csl.ts`).
STATUS: 21 published values from four independent sources, cleared at the ≥20 bar by a thin margin and with
two caveats a reader must see. (1) Only 13 of the 21 are data → answer tests (failure states in, φ′ / c′ / cu out,
compared with the book's answer). The other 8 feed the engine failure states constructed on a PUBLISHED Kf line
(slope and intercept printed by the book) and check that the published φ′ and c′ come back — they test the
M, q0 → φ′, c′ conversion against the books, not the regression. (2) Several of the 13 are graphical
Mohr-circle constructions printed to 1° or 1 kPa, so their tolerances are 1° / 3 kPa, wider than an exact value.
One engine defect was found and fixed on the way (a falling envelope lost its cohesion; see Q4.3 below).
Published sources (every number below was read from the page named beside it):
1. Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Spon — Ch. 5 Example 5.2
(p. 178), Example 5.4 (pp. 182-183, read as page images), Example 5.6 (p. 188).
2. Craig, R.F. (2004), Craig's Soil Mechanics 7th ed. Solutions Manual, Spon — the printed answers to
Problems 4.2 (sand, φ′ = 44°), 4.3 (UU, cu = 110 kN/m²), 4.4 (modified parameters a′ = 13, α′ = 26°)
and 4.5 (CU clay, c′ = 0, φ′ = 25½°). Read from web copies of the manual (scispace.com and
studylib.net), NOT from a copy in the library; the problem DATA is the 8th-edition Problem 5.3 / 5.4 /
5.5 data where that is in the library, and otherwise as quoted in the manual's own solution.
3. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley — Example 11.1 (dense sand, p. 140,
φ_f average 42.1°), the normally consolidated Weald-clay Kf line in Ch. 21 (through the origin,
α = 20½°, φ = 22°, p. 304) and the over-consolidated Weald-clay straight-line fit (a = 6.9 kN/m²,
α = 20.3°, φ = 21.5°, c = 7.4 kN/m², p. 308).
4. Head, K.H. & Epps, R.J. (2014), Manual of Soil Laboratory Testing, Vol. 3 Effective Stress Tests,
3rd ed., Whittles — Fig. 16.14(b): θ = 20½°, t0 = 12 kPa, φ′ = 22°, c′ = 13 kPa (p. 76).
WHAT THE ENGINE IS. `computeTriaxialCsl` forms p′ = (σ′1 + 2σ′3)/3 and q = σ′1 − σ′3 for each failure state,
fits q = M·p′ + q0 by least squares (free intercept), and converts M → φ′ = asin(3M/(6+M)) and
q0 → c′ = q0(3 − sin φ′)/(6 cos φ′) (negative intercepts are clipped to c′ = 0).
TWO PRINTED (σ1′, σ3′)-free cases are driven through the engine by CONSTRUCTING failure states that lie
exactly on the published Kf line t = a + s·tan α (Head Fig. 16.14(b); Lambe & Whitman Weald clay; Craig
Problem 4.4) — the published slope/intercept go in, the published φ′ and c′ must come out. The construction
is independent of the engine and uses only the MIT relations sin φ′ = tan α, c′ = a/cos φ′ that the books print.
TOLERANCES, stated per group:
· Constructed Kf lines (Head, Weald, Problem 4.4): the book rounds θ, φ′ and c′, so φ′ to 0.3° and c′ to
0.5 kPa (Head to 0.1 / 0.1 because its own arithmetic is exact: tan 20.5° = 0.3739 → 21.96°, 12/cos → 12.94).
· Graphical Mohr-circle envelopes (Craig 8th Ex. 5.2 / 5.4, Problems 4.2 / 4.3 / 4.5): a hand-drawn tangent
is good to about ±1° and ±2 kPa, so the tolerance is 1° and 3 kPa (0.5° where the book prints a half-degree).
· L&W Ex. 11.1 averages four per-test φ_f values (42.2, 41.6, 42.7, 42.1); the engine fits the four states
together: tolerance 0.2°.
PUBLISHED VALUES (21).
data → answer (13): L&W Ex 11.1 ×1 · Craig 8th Ex 5.2 ×2, Ex 5.4(a) ×2, Ex 5.4(b) ×2, Ex 5.6 ×1 ·
Craig 7th Solutions Q4.2 ×1, Q4.3 ×2, Q4.5 ×2.
slope / intercept → φ′, c′ on constructed states (8): L&W OC Weald ×2 (α 20.3°, a 6.9) · L&W NC Weald ×2
(α 20½°, through the origin → φ 22°, no cohesion) · Head Fig 16.14 ×2 · Craig 7th Q4.4 ×2.
UNRESOLVED MISMATCHES (investigated, reported, NOT silently absorbed):
· Craig 8th Example 5.5 fits the critical-state line THROUGH THE ORIGIN (q = 0.88 p′) on three end-of-
shear points (p′, q) = (125, 121), (250, 225), (340, 292). The engine's free-intercept fit of the same
three points gives M = 0.80, q0 = 22.6 kPa (φ′ = 20.6°, c′ = 10.6 kPa). For a CSL that is physically
c′ = 0 the free intercept manufactures a cohesion from scatter. This is a METHODOLOGY difference (the
engine documents its fit as a Kf-line with intercept), not a transcription error, so it is not asserted
and the engine was not changed; a "force through origin" option would be the fix if the module is to be
sold as a critical-state fit.
· Head & Epps Eq. 16.13 prints c′ = [(3 − sin φ′)/(6 cos φ′)]·2q0, twice what the engine (and the
derivation from Head's own Eqs 16.10 and 16.12, and from Lambe & Whitman) gives. Head's own worked
Fig. 16.14 (c′ = t0/cos φ′ = 13 kPa) agrees with the engine, so Eq. 16.13 as printed looks like a
factor-2 misprint in the book; the engine was not changed.
· Lambe & Whitman print α = 20.3° beside φ = 21.5°, but sin φ = tan 20.3° gives 21.7°; the engine follows
the relation, hence the 0.3° tolerance on that pair.
| Test block (the published value it checks) | Verdict |
| L&W Example 11.1: four peak states → φ_f average 42.1° | Pass |
| L&W Weald clay: Kf line a = 6.9, α = 20.3° → φ = 21.5°, c = 7.4 kN/m² | Pass |
| L&W NC Weald clay: Kf line through the origin with α = 20½° → φ = 22°, no cohesion | Pass |
| Head & Epps Fig. 16.14(b): Kf line θ = 20.5°, t0 = 12 kPa → φ′ = 22°, c′ = 13 kPa | Pass |
| Craig 8th Ex 5.2: effective-stress failure states → tangent c′ = 20 kPa, φ′ = 29° (graphical, 200-300 kPa) | Pass |
| Craig 8th Ex 5.4(a): UU states (370,200), (564,400), (772,600) → cu = 85 kPa, φu = 0 | Pass |
| Craig 8th Ex 5.4(b): drained states (530,200), (1091,400), (1620,600) → c′ = 0, φ′ = 27° | Pass |
| Craig 8th Ex 5.6: states on q = 0.88 p′ → φ′cv = 23° | Pass |
| Craig 7th Solutions Q4.2: sand σ3 = 100…800, σ1 − σ3 = 452…3624 → φ′ = 44° | Pass |
| Craig 7th Solutions Q4.3: UU σ3 = 200, 400, 600, σ1 − σ3 = 222, 218, 220 → cu = 110 kN/m², φu = 0 | Pass |
| Craig 7th Solutions Q4.4: a′ = 13 kN/m², α′ = 26° → φ′ = 29°, c′ = 15 kN/m² | Pass |
| Craig 7th Solutions Q4.5: CU clay effective states (171,68), (333,131), (503,198), (679,269) → c′ = 0, φ′ = 25½° | Pass |
von-mises-material-point-web-validation.test.ts
Validation for the von Mises (J2) radial-return material point (`von-mises-material-point.ts`: `vonMisesQ`, `integrateVonMises`) — slug `von-mises`.
Analyses validated: von-mises · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the von Mises (J2) radial-return material point (`von-mises-material-point.ts`:
`vonMisesQ`, `integrateVonMises`) — slug `von-mises`.
STATUS: PARTIAL — 3 published values from ONE book, against a release bar of 20 values from 2 sources.
This suite is FORMULA-FIDELITY evidence (formula-fidelity): the five earlier tests check the radial return
against its defining identities (q = σ_y after return, isochoric flow, q = σ for a uniaxial stress), which
are consequences of the equations as written, not published answers. They are not counted. The shortfall
is 17 values and one independent source.
WHY SO FEW. The books in the library print von Mises results as finite-element boundary-value problems
(de Souza Neto, Perić & Owen (2008) §7.5: thick cylinder, spherical shell, circular plate, strip footing,
notched specimen), never as material-point tables. A stress-point engine can be checked against those
only where a closed-form Hill solution exists AND the yield condition enters through q. That is true for
the cylinder and the sphere, which are used below; it is not true of the plate (6.52·M_y/R², from
limit analysis with a plate-theory yield condition) or the strip footing (5.14 = 2+π is the slip-line
value of a cohesion c whose relation to σ_y the book defines only in a figure not read here).
PUBLISHED SOURCE (page image read): de Souza Neto, Perić & Owen (2008), Computational Methods for Plasticity:
Theory and Applications, Wiley —
§7.5.1 (pp. 244–247), thick-walled cylinder a = 100, b = 200 mm, σ_y = 0.24 GPa, plane strain: Hill's
limit pressure P_lim ≈ 0.19209 GPa (Eq. 7.160) and, at P = 0.18 GPa, plastic-front radius c ≈ 159.79 mm.
§7.5.2 (p. 248), thick-walled sphere, same a, b, σ_y: Hill's limit pressure P_lim ≈ 0.33271 GPa (Eq. 7.168).
⚠️ PRINTED-EQUATION INCONSISTENCY (checked on the rendered page 245, not an OCR artefact). Eq. 7.155 is
printed with "Y = σ_y/√3" and Eq. 7.156 as P₀ = (Y/2)(1 − a²/b²). With that Y the limit pressure would be
Y·ln(b/a) = 0.0961 GPa and P₀ = 0.052 GPa, contradicting the book's own Eq. 7.159 (P_lim = 2σ_y/√3·ln(b/a)
= 0.19209) and its statement that at P = 0.1 GPa "the entire cylinder is still elastic". Both printed
numbers, and c = 159.79, are reproduced only with Y = 2σ_y/√3, which is what is used below. The
engine-dependent step is exactly that factor: Y = 2σ_y/vonMisesQ([1, −1, 0]), i.e. twice the shear yield
stress the engine's J2 implies.
| Test block (the published value it checks) | Verdict |
| elastic below yield: pure shear stays elastic and q correct | Pass |
| after plastic return, q = σ_y exactly (multiple strain paths) | Pass |
| plastic flow is isochoric: mean stress unchanged by the return | Pass |
| uniaxial: yields when axial stress reaches σ_y | Pass |
| vonMisesQ of a uniaxial stress equals the axial stress | Pass |
| de Souza Neto et al. §7.5.1 (p. 246): cylinder limit pressure P_lim = Y·ln(b/a) = 0.19209 GPa | Pass |
| de Souza Neto et al. §7.5.1 (p. 247): at P = 0.18 GPa the plastic front is at c ≈ 159.79 mm | Pass |
| de Souza Neto et al. §7.5.2 (p. 248): sphere limit pressure P_lim = 2(σ_θ−σ_r)_y·ln(b/a) = 0.33271 GPa | Pass |
| the published-value tally is 3 distinct printed numbers from 1 source; PARTIAL (short of 20 by 17) | Pass |
Finite-element meshing, solvers and procedures
FE kernel registry — 8 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
plaxis-verif-k5-set | plaxis-verif-k5-set | Hoek-Brown-material-model, Triaxial-Hardening-Soil, Soft-Soil-Creep-Haney-clay, Phi-c-reduction-vs-Bishop, Benchmark-embankment-soft-clay | — | — | — | — | — | Superseded |
plaxis-verif-v2-set | plaxis-verif-v2-set | Lamb-problem, Surface-waves, Pulse-load-multilayer, One-dimensional-wave-propagation, Vertical-dynamic-response-footing, Free-vibration-dam, Ground-response-linear-soil | — | — | — | — | — | Superseded |
v-gravity-loading-layered-column | σ'yy = −Σγh and σ'xx = ν/(1−ν) σ'yy at 240 Gauss points; crest settlement ∫σ'yy/E_oed dy, two layers [kPa, m] | —, p. Das, Principles of Geotechnical Engineering (overburden); Lambe & Whitman ch. 7; constrained modulus | — | -0.046371 | -0.046371 | — | 0.00 % | Pass |
v-reset-displacements-closed-form | crest displacement after a surcharge phase with reset: q Σh/E_oed; without reset: gravity + q Σh/E_oed [m] | PLAXIS-2D-2025.1-Reference-Manual-Seequent-Bentley.pdf, p. p. 343 (§7.9.2.3) | — | [-0.031071, -0.077443] | [-0.031071, -0.077443] | — | [0, 0] | Pass |
v-rm-global-coarseness-r_e | r_e of the five levels [-] | PLAXIS-2D-2025.1-Reference-Manual-Seequent-Bentley.pdf, p. p. 299 (§7.1.2) | — | [2, 1.33, 1, 0.67, 0.5] | [2, 1.33, 1, 0.67, 0.5] | — | 0.00 % | Pass |
v-rm-global-coarseness-le | l_e / (r_e · diagonal) [-] | PLAXIS-2D-2025.1-Reference-Manual-Seequent-Bentley.pdf, p. p. 299 (Eq. 7-1) | — | 0.06 | 0.06 | — | 0.00 % | Pass |
v-rocscience-mesh-quality-shape-statsself-check | min interior angle of a 3-4-5 triangle via mesh2d::report::shape_stats (what the model screen prints as 'Min. angle') [deg] | — | — | 36.8699 | 36.8699 | — | 0.00 % | Pass |
v-rocscience-mesh-sizingself-check | element size rule l_e = r_e/20·diagonal on a 30 × 40 m box ('medium'); graded ceiling h(x)=min(l_e, f·l_e+0.5·d); area conservation [m] | — | — | 2.5 | 2.5 | — | 0.00 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
plaxis-verif-k5-set — Superseded · K5 (constitutive models, safety)
Superseded by: k5a-phic-bishop-analysis1, k5a-phic-bishop-analysis2, k5b-plaxis-verif-hoek-brown-tunnel, k5b-hb-envelope, k5b-hs-triaxial-element-compression, k5b-hs-triaxial-element-extension, k5b-hs-triaxial-fe-compression, k5b-hs-triaxial-fe-extension, k5b-ssc-haney-pp, k5b-ssc-haney-rate-effect, k5d-benchmark-embankment-soft-clay
Notes: Superseded: this row was a placeholder for the five PLAXIS constitutive-model and safety verification cases of the K5 set, and each now has its own rows, listed below. Phi-c reduction against Bishop, the Hoek-Brown tunnel and envelope, the Hardening Soil triaxial and the Haney-clay creep cases pass; the soft-clay embankment benchmark (k5d-benchmark-embankment-soft-clay) is still a deviation on its own row. || K5a: Phi-c-reduction-vs-Bishop done (k5a-phic-bishop-*). K5b (18 Oct): the constitutive-model part (Hoek-Brown, Hardening Soil, Soft Soil Creep Haney clay) is done — see the k5b-* rows. Remaining from this set: Benchmark-embankment-soft-clay (no dedicated row yet) — K5d. K5d-2 (19 Oct): Benchmark-embankment-soft-clay built — row k5d-benchmark-embankment-soft-clay (open: undrained Soft Soil construction, K5d2-EMB).
plaxis-verif-v2-set — Superseded · v2 (dynamics)
Superseded by: k7a-lamb-p-onset, k7a-lamb-rayleigh-peak-time, k7a-lamb-rayleigh-peak-amplitude, k7a-1d-wave-arrival-middle, k7a-1d-wave-plateau-fixed-base, k7a-1d-wave-after-reflection-fixed-base, k7a-1d-wave-arrival-base-viscous, k7a-1d-wave-absorbing-reflection, k7a-1d-wave-spec-mesher, k7a-vertical-footing-dynamic, k7a-ground-response-rigid-0p75hz, k7a-ground-response-rigid-1p5hz, k7a-ground-response-rigid-3p0hz, k7a-ground-response-rigid-4p5hz, k7a-ground-response-elastic-rock-0p75hz, k7a-ground-response-elastic-rock-1p5hz, k7a-ground-response-elastic-rock-4p5hz, k7a-dam-free-vibration, k7a-pulse-multilayer, k7a-surface-waves
Notes: Superseded: this row was a placeholder for the seven PLAXIS dynamics verification cases (Lamb problem, surface waves, pulse load on a multilayer, one-dimensional wave propagation, vertical dynamic response of a footing, free vibration of a dam, ground response in linear soil), and each now has its own rows, listed below. The Lamb problem, one-dimensional wave propagation, vertical footing and ground-response rows pass; free vibration of a dam, the pulse load on a multilayer and surface waves are still pending, each on its own row. The earlier note on this row (cylindrical cavity with large displacements) was about a different case, which has its own passing rows (plaxis-verif-cavity-large-*).
v-gravity-loading-layered-column — Pass · verify-plaxis2d
Reference: closed form
Mesh: T15 column 2 × 10 m, 10 elements
Reproduce: tests/v_plaxis_rm_staging_closed_form.rs gravity_loading_phase_reproduces_overburden_and_k0_confined_stress
Notes: Worst stress error 1.7e-12 (σyy), 6.8e-12 (σxx) relative. Gate 0.5 %. Row 94.
v-reset-displacements-closed-form — Pass · verify-plaxis2d
Reference: closed form, constrained modulus
Mesh: T15 column
Reproduce: tests/v_plaxis_rm_staging_closed_form.rs reset_displacements_drops_the_previous_displacement_and_keeps_the_stress
Notes: Stress after the reset phase = q + Σγh to 6e-14. Row 111.
v-rm-global-coarseness-r_e — Pass · verify-plaxis2d
Reference: RM table
Reproduce: tests/v_plaxis_rm_mesh.rs r_e_levels_match_the_2d_reference_manual_table
v-rm-global-coarseness-le — Pass · verify-plaxis2d
Reference: RM Eq. 7-1 (l_e = r_e × 0.06 × diagonal)
Reproduce: tests/v_plaxis_rm_mesh.rs target_element_size_matches_eq_7_1 (default cargo test; not ignored)
Notes: Re-measured 12 Nov 2026 (Modal 2026-11-12T00-02-29) on a 40 × 15 m box (diagonal 42.7200 m): l_e / (r_e · diagonal) = very_coarse 0.060000, coarse 0.060001, medium 0.060000, fine 0.059998, very_fine 0.060000 — Eq. 7-1's 0.06 at every level (asserted to 1e-9). Fixed by D557 (LE_COEFF_2D 0.05 → 0.06; the 3-D rule keeps the PLAXIS 3D 2016 1/20, test three_d_rule_keeps_the_2016_coefficient); the row had stayed stale since. Before: 0.05 (elements 16.7 % smaller than PLAXIS 2D).
v-rocscience-mesh-quality-shape-stats — Pass · verify-rocscience (RS2 parity #11)
Reference: closed form atan(3/4); also equilateral 60°/aspect 1, right isosceles 45°, sliver atan(0.02)=1.1458°, aspect 5/(2√3)=1.443376
Mesh: single triangles
Reproduce: tests/v_rocscience_mesh_quality.rs (5 tests)
Notes: Agreement asserted to 1e-9° (angles) and 1e-12 (aspect, area). 'ours' printed to 4 d.p. here; the test is the authority. Own metric (min angle, longest-edge/(2√3·r_in)); RS2 publishes no quality number.
v-rocscience-mesh-sizing — Pass · verify-rocscience (RS2 parity #9)
Reference: closed form (50 m diagonal × 1.0 / 20); PLAXIS Reference Manual 2025.1 element-size rule as documented in size.rs
Mesh: uniform: 764 elements, max area 2.668 ≤ ceiling 2.706, min angle 25.71°; graded: 808 elements, worst area/ceiling at centroid 0.994, mean area 0.268 within 2 m vs 1.638 beyond 10 m
Reproduce: tests/v_rocscience_mesh_sizing.rs (4 tests)
Notes: Levels 5.0/3.325/2.5/1.675/1.25 m asserted to 1e-12; Σ element areas = 1200 m² to 1e-8; no element exceeds the size field at its centroid. UI exposes coarseness levels only; the local (point/polyline) field is kernel-level.
Cited validation suites — 17
classical-closed-forms-web-validation.test.ts
Web-benchmark validation for EIGHT classical closed-form runner engines.
Analyses validated: capillary-rise, circular-load-stress, darcy-velocity, effective-stress, k0-at-rest, layered-permeability, line-load-stress, strip-load-stress · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for EIGHT classical closed-form runner engines.
WHY ONE FILE FOR EIGHT ENGINES. These are not correlations or chart digitisations — each is a
textbook closed form with a single published expression, so each needs a handful of exact
assertions rather than a suite of its own. Grouping them keeps the validation legible; the
cost is that the filename-keyed `-web-validation` counter in the ledger sees ONE file where
eight engines were actually anchored. That undercount is stated in the ledger rather than
worked around by creating eight near-empty files to satisfy a metric.
ENGINES AND SOURCES (each cited at its own test):
circular-load-stress — Boussinesq, uniformly loaded circular area, stress on the axis
line-load-stress — Boussinesq/Flamant, infinite line load
strip-load-stress — Boussinesq strip load, plus the 2:1 approximation for comparison
k0-at-rest — Jaky (1944) K₀ = 1 − sin φ′, and the at-rest thrust
capillary-rise — Terzaghi/Hazen h_c = C/(e·D₁₀)
darcy-velocity — Darcy v = k·i, and seepage velocity v_s = v/n
layered-permeability — equivalent k parallel (weighted arithmetic) and normal (harmonic)
effective-stress — Terzaghi σ′ = σ − u
Every expected value is computed from the published expression with the arithmetic written
out, so a reviewer can check it without running the engine. These are exact relations, so the
tolerances are machine precision unless a specific reason is stated.
| Test block (the published value it checks) | Verdict |
| circular-load-stress reproduces the Boussinesq on-axis solution | Pass |
| line-load-stress reproduces Boussinesq Δσ_z = 2Pz³/[π(x² + z²)²] | Pass |
| strip-load-stress reproduces the strip solution and brackets the 2:1 method | Pass |
| k0-at-rest follows Jaky K₀ = 1 − sin φ′ with the triangular thrust | Pass |
| capillary-rise follows h_c = C/(e·D₁₀) with consistent units | Pass |
| darcy-velocity separates discharge velocity from seepage velocity | Pass |
| layered-permeability gives the weighted arithmetic k_h and harmonic k_v | Pass |
| effective-stress is Terzaghi σ′ = σ − u with the water table respected | Pass |
fe-assemble-t6-web-validation.test.ts
Validation for the T6 global assembly/solver (`fe-assemble-t6.ts`).
Analyses validated: mesh-viewer · Recorded run: passed — 3 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the T6 global assembly/solver (`fe-assemble-t6.ts`). the release rules gate.
Anchors: constant-strain patch test on a T6 mesh; T6 reproduces a LINEAR strain
field (quadratic displacement) exactly; symmetric assembly.
| Test block (the published value it checks) | Verdict |
| T6 mesh builder dedups mid-side nodes by edge | Pass |
| constant-strain patch test on a T6 mesh (εxx=g) | Pass |
| T6 reproduces a LINEAR strain field: u=(a·x², 0) → εxx = 2a·x | Pass |
fe-core-2d-web-validation.test.ts
Web-benchmark validation for the TerraCore 2-D plane-strain FE core (`fe-core-2d.ts`).
Analyses validated: mesh-viewer · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the TerraCore 2-D plane-strain FE core
(`fe-core-2d.ts`). The canonical FE correctness proofs — the release rules gate.
Anchors (independent, textbook):
• Constant-strain PATCH TEST — the standard convergence/correctness proof for
CST elements: prescribing a uniform-strain boundary field must reproduce
that exact constant strain (and its stress) in EVERY interior element
(Zienkiewicz & Taylor Vol 1; Bathe §4; Cook et al.).
• Plane-strain uniaxial-strain stress ratio σyy/σxx = ν/(1−ν) (closed form).
• Rigid-body motion produces zero strain/stress.
| Test block (the published value it checks) | Verdict |
| planeStrainD matches the closed form | Pass |
| patch test: uniform εxx reproduced exactly in every element | Pass |
| uniaxial-strain confined ratio σyy/σxx = ν/(1−ν) | Pass |
| rigid-body translation produces zero strain/stress | Pass |
fe-core-t6-web-validation.test.ts
Validation for the T6 quadratic element (`fe-core-t6.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the T6 quadratic element (`fe-core-t6.ts`). the release rules gate.
Anchors (Zienkiewicz & Taylor; Bathe): (a) constant-strain patch test;
(b) T6's defining property — EXACT reproduction of a LINEAR strain field
(quadratic displacement), which CST cannot represent; (c) Jacobian/area.
| Test block (the published value it checks) | Verdict |
| Jacobian: detJ = 2·area (=4) for the straight-sided T6 | Pass |
| constant-strain patch: linear u=(g·x,0) → εxx=g at every Gauss point | Pass |
| LINEAR strain patch: quadratic u=(a·x²,0) → εxx=2a·x EXACTLY (T6 advantage) | Pass |
| shear quadratic field u=(0, b·x²) → γxy = 2b·x reproduced exactly | Pass |
| T6 stiffness is symmetric and rigid-body/rank consistent | Pass |
fe-gravity-web-validation.test.ts
Validation for FE self-weight (gravity) loading (`gravityLoad` in fe-core-2d).
Analyses validated: geometry-editor, mesh-viewer · Recorded run: passed — 2 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for FE self-weight (gravity) loading (`gravityLoad` in fe-core-2d).
the release rules gate. Anchor: a laterally-confined column under self-weight has the
exact geostatic vertical stress σyy(y) = −γ·(H−y) (compression, tension-+ sign),
i.e. increasing linearly with depth; total base reaction = weight = γ·W·H.
| Test block (the published value it checks) | Verdict |
| self-weight column: σyy(y) = −γ·(H−y) (geostatic, linear with depth) | Pass |
| confined self-weight: horizontal stress σxx = K0·σyy with K0 = ν/(1−ν) | Pass |
fe-plastic-2d-web-validation.test.ts
Web-benchmark validation for the elasto-plastic FE solver (`fe-plastic-2d.ts`).
Analyses validated: mesh-viewer · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the elasto-plastic FE solver (`fe-plastic-2d.ts`).
the release rules gate.
Strategy: with ALL nodes prescribed to a uniform strain field, equilibrium is
trivial and every element strain equals the imposed field — so the FE element
stress MUST equal the independently-validated standalone material point
(`integrateMohrCoulombGeneral`). This validates the FE↔material-point coupling
and the tension↔compression sign bridge exactly. Below yield it must also match
the linear-elastic FE core.
| Test block (the published value it checks) | Verdict |
| FE-plastic below yield equals the linear-elastic core | Pass |
| FE element stress == material point (uniform εyy=-0.001) | Pass |
| FE element stress == material point (uniform εyy=-0.003) | Pass |
| FE element stress == material point (uniform εyy=-0.008) | Pass |
| deviatoric stress is capped by MC yield as shear strain increases | Pass |
| yielded FE stress state satisfies MC on its principal stresses | Pass |
fe-plastic-cg-web-validation.test.ts
Validation for the matrix-free CG elasto-plastic solver (`fe-plastic-cg.ts`).
Analyses validated: geometry-editor, mesh-viewer · Recorded run: passed — 3 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the matrix-free CG elasto-plastic solver (`fe-plastic-cg.ts`).
the release rules gate. Anchors: reproduces the dense MC plastic solver on a uniform
field (FE == material point), reaction equilibrium, and scales to a fine mesh.
| Test block (the published value it checks) | Verdict |
| CG plastic == material point on a uniform confined field | Pass |
| CG plastic reaction equilibrium (top = −base) | Pass |
| CG plastic solves a fine mesh (20×20) in reasonable time | Pass |
fe-plastic-general-web-validation.test.ts
Validation for the GENERAL incremental elasto-plastic T6 solver (`fe-plastic-general.ts`) — the unified-constitutive staged solver.
Analyses validated: mesh-viewer · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the GENERAL incremental elasto-plastic T6 solver
(`fe-plastic-general.ts`) — the unified-constitutive staged solver.
Strategy: a single T6 element with EVERY DOF prescribed to an affine (uniform-
strain) displacement field. Then every Gauss point sees the identical strain
increment, so the solver's committed Gauss stress MUST equal the already-
validated material point called directly with the same increment(s). This is a
rigorous consistency/patch test of the assembly, the FE↔material sign bridge,
the constitutive dispatch, and (for Hardening Soil) the per-Gauss-point state
carried across load increments. Exact to solver tolerance.
Anchors: Zienkiewicz & Taylor (patch test); Schanz–Vermeer–Bonnier 1999 (HS);
the underlying material points are themselves validated in
`mc-material-point-*` and `hardening-soil-*` suites.
| Test block (the published value it checks) | Verdict |
| MC patch: single-increment Gauss stress equals integrateMohrCoulombGeneral exactly | Pass |
| HS patch: N-increment Gauss stress equals the incrementally-integrated material point (state carry) | Pass |
| HS behavioural: vertical stress magnitude grows monotonically and stays below MC failure | Pass |
| DP patch: single-increment Gauss stress equals integrateDruckerPragerGeneral exactly | Pass |
| Von Mises patch: single-increment Gauss stress equals integrateVonMises exactly (yielded) | Pass |
| per-element regression: [MC] on 1 element equals the single-model solver exactly | Pass |
| per-element dispatch: 2-element mesh, each element uses its OWN model (different E → different stress) | Pass |
fe-plastic-t6-web-validation.test.ts
Validation for the T6 elasto-plastic solver (`fe-plastic-t6.ts`).
Analyses validated: mesh-viewer · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the T6 elasto-plastic solver (`fe-plastic-t6.ts`). the release rules gate.
Strategy (as for the CST plastic solver): prescribe a uniform strain field on
ALL nodes so equilibrium is trivial → the FE element stress must equal the
independently-validated material point; plus below-yield elastic agreement and
the perfect-plastic deviator cap under a deviatoric field.
| Test block (the published value it checks) | Verdict |
| T6 plastic below yield equals the linear-elastic T6 core | Pass |
| T6 element stress == material point (uniform εyy=-0.001) | Pass |
| T6 element stress == material point (uniform εyy=-0.004) | Pass |
| T6 deviator capped by MC under an increasing shear field | Pass |
| T6 reaction (internalForce at fixed DOFs) balances the applied load | Pass |
fe-pressure-load-web-validation.test.ts
Validation for FE uniform-pressure loading (`uniformPressureLoad`).
Analyses validated: coupled-consolidation, geometry-editor, mesh-viewer · Recorded run: passed — 3 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for FE uniform-pressure loading (`uniformPressureLoad`). the release rules gate.
Anchor: a laterally-confined block under a uniform top pressure p (base fixed,
roller sides) has uniform vertical stress σyy = −p throughout; and the total
applied nodal load equals p·(loaded width).
| Test block (the published value it checks) | Verdict |
| total applied load = p · loaded width | Pass |
| confined block under uniform top pressure → σyy = −p everywhere | Pass |
| partial-width (footing) pressure applies only over the strip | Pass |
fe-solve-cg-web-validation.test.ts
Validation for the matrix-free CG FE solver (`fe-solve-cg.ts`).
Analyses validated: geometry-editor, mesh-viewer · Recorded run: passed — 3 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the matrix-free CG FE solver (`fe-solve-cg.ts`). the release rules gate.
Anchors: reproduces the dense `solveElasticPlaneStrain` (same physics, patch
test) and scales to a fine mesh the dense solver can't handle in reasonable time.
| Test block (the published value it checks) | Verdict |
| CG solver reproduces the dense solver (patch test, εxx=g) | Pass |
| CG solver matches dense on a loaded (non-trivial) problem | Pass |
| CG scales to a fine mesh (40×40 → ~3400 DOF) — dense would be too slow | Pass |
geometry-editor-web-validation.test.ts
Validation for the `geometry-editor` tool — the polygon → PSLG → mesh path it drives through `pslgFromPolygons` + `generateMesh` (public API of mesh-cdt.ts only; the mesher is being rewritten concurrently, so every assertion below is an IN…
Analyses validated: coupled-consolidation, geometry-editor, mesh-viewer · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the `geometry-editor` tool — the polygon → PSLG → mesh path it drives through
`pslgFromPolygons` + `generateMesh` (public API of mesh-cdt.ts only; the mesher is being rewritten
concurrently, so every assertion below is an INVARIANT of the result, not a snapshot of the current
triangulation).
STATUS — formula-fidelity evidence only, NOT published-value validation. Every expected value here is an
ANALYTIC fact (shoelace area, polygon centroid, ray-casting point-in-polygon, Euler's V − E + F relation):
mathematical truths computed independently in this file, not numbers printed in a textbook worked
example. They are deliberately NOT counted as published citations. Published values reproduced: 0 of 20;
distinct published sources with values: 0. No local reference prints a geometry-editor worked example
(polygon in → areas / tags out) with numeric answers.
What the assertions protect: the mesh covers the drawn geometry exactly (no gaps, no overlaps, holes and
concave corners respected), every element is tagged with the material of the polygon it lies in, shared
vertices are welded into conforming interfaces, and the tool's output is independent of polygon order.
| Test block (the published value it checks) | Verdict |
| geometry: a right triangle meshes to exactly ½·b·h (analytic area) | Pass |
| geometry: an L-shaped (concave) polygon — area 3 and area-weighted centroid (5/6, 5/6) | Pass |
| geometry: a square with a square hole — area = outer − hole, no element inside the hole | Pass |
| geometry: two stacked materials — conforming interface, correct tags by point-in-polygon, total area | Pass |
| geometry: the result does not depend on the order the polygons are drawn | Pass |
| geometry: polygon winding (CW vs CCW) does not change the meshed area | Pass |
| geometry: a translated model (real-world coordinates) meshes to the same area and element count | Pass |
| geometry: the mesher honours its minimum-angle target on an ordinary polygon | Pass |
limit-analysis-fe-web-validation.test.ts
WEB-VALIDATION (the release rules gate) for `limit-analysis-fe.ts` — the FE strength-reduction slope FoS + displacement-controlled bearing-capacity limit load, built on the matrix-free CG elasto-plastic Mohr-Coulomb kernel.
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-VALIDATION (the release rules gate) for `limit-analysis-fe.ts` — the FE
strength-reduction slope FoS + displacement-controlled bearing-capacity limit
load, built on the matrix-free CG elasto-plastic Mohr-Coulomb kernel.
Every expected value below traces to an INDEPENDENT closed form / textbook:
A. SLOPE (strength reduction) — dry, homogeneous, purely-frictional slope.
The exact factor of safety of a dry cohesionless slope is the classical
INFINITE-SLOPE result F = tanφ' / tanβ (independent of depth), where
β is the slope angle. Sources:
• R.F. Craig, "Craig's Soil Mechanics" (8th ed.), infinite-slope §.
• B.M. Das, "Principles of Geotechnical Engineering", slope-stability ch.
• cf. the dry-homogeneous-slope hand calculation on disk
("Hand-Calculation-1-Simple-Homogeneous-Dry-Slope.pdf").
Method reference: Griffiths, D.V. & Lane, P.A. (1999) "Slope stability
analysis by finite elements", Géotechnique 49(3), 387–403 — the FoS is the
strength-reduction factor at which the FE stops converging (a mechanism
forms), with NO assumed slip surface. ("Griffiths and Lane 1999.pdf")
B. BEARING CAPACITY — rigid strip footing, weightless φ=0 (Tresca) soil.
Prandtl (1921) exact: q_ult / s_u = N_c = 2 + π = 5.14159…
(Terzaghi/Vesić N_c; Prandtl.pdf idea; Smith, Griffiths & Margetts,
"Programming the FEM" 5e Ch.6 — the FE recovers N_c=5.14). Constant-strain
triangles OVER-predict undrained (incompressible) collapse loads because of
volumetric locking, so the mobilised N_c is reported HONESTLY (~+30–45% at
a fully-developed mechanism), with the mesh-convergence trend toward 5.14.
Run ONLY this file:
export PATH=/opt/homebrew/bin:$PATH && cd app/packages/geotech && \
npx tsx --test src/__tests__/limit-analysis-fe-web-validation.test.ts
| Test block (the published value it checks) | Verdict |
| reduceStrength: c_f = c/F and tanφ_f = tanφ/F (GL99 eqs 1–2) | Pass |
| SRM slope: φ=30°, 2:1 → FoS ≈ tanφ/tanβ = 1.155 (within 3%) | Pass |
| SRM slope: φ=35°, 2:1 → FoS ≈ 1.400 (within 3%) | Pass |
| SRM slope: φ=45°, 2:1 → FoS ≈ 2.000 (within 3%) | Pass |
| SRM slope: φ=40°, 1.5:1 → FoS ≈ 1.259 (achieved +~8%, within 12%) | Pass |
| SRM slope: FoS increases with φ, and a gentler slope is safer | Pass |
| Bearing φ=0: mobilised N_c vs Prandtl 5.14 (CST over-predicts, honest) | Pass |
| Bearing φ=0: FE brackets Prandtl 5.14 on the load–settlement curve (±10%) | Pass |
| Bearing φ=0: refining the mesh reduces N_c toward Prandtl (from above) | Pass |
| Bearing φ=0: N_c independent of s_u; q_ult ∝ s_u (dimensional exactness) | Pass |
| Bearing φ=0: q_ult independent of footing width B (weightless Prandtl) | Pass |
linear-solver-cg-web-validation.test.ts
Validation for the CG linear solver (`linear-solver-cg.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the CG linear solver (`linear-solver-cg.ts`). the release rules gate.
Anchors: CG solves SPD systems exactly (to tolerance) — checked against a
known solution (1-D Poisson tridiagonal) and a small dense SPD system; CG on
an SPD n×n system converges in ≤ n iterations (exact arithmetic property).
| Test block (the published value it checks) | Verdict |
| CG solves a small dense SPD system to a known solution | Pass |
| CG solves the 1-D Poisson system (tridiagonal −1,2,−1) | Pass |
| CG residual decreases monotonically to tolerance | Pass |
| CG matches a dense-solve reference on a random SPD system | Pass |
mesh-contour-web-validation.test.ts
Validation for the contouring backbone (`mesh-contour.ts`).
Analyses validated: coupled-consolidation, geometry-editor, mesh-viewer · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the contouring backbone (`mesh-contour.ts`). the release rules gate.
Anchors: a LINEAR field f=a·x+b·y has exact iso-lines a·x+b·y=level, so every
extracted segment endpoint must satisfy that equation; nodal averaging of a
uniform element field is uniform.
| Test block (the published value it checks) | Verdict |
| nodal averaging of a uniform element field is uniform | Pass |
| iso-contour of a linear field lies exactly on the analytic line | Pass |
| no iso-segments outside the field range | Pass |
| contourLevels returns evenly spaced interior levels | Pass |
| a diagonal iso-line spans the domain (connected coverage) | Pass |
mesh-delaunay-web-validation.test.ts
Validation for the TerraCore Delaunay mesher (`mesh-delaunay.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the TerraCore Delaunay mesher (`mesh-delaunay.ts`). the release rules gate.
Anchors (independent, textbook — Frey & George; Lo; de Berg Computational
Geometry): the empty-circumcircle Delaunay property; Euler's formula for the
triangle count of a triangulated convex point set; circumcircle closed form;
Ruppert refinement raising the minimum angle.
| Test block (the published value it checks) | Verdict |
| circumcircle of a right triangle centres on the hypotenuse midpoint | Pass |
| unit square triangulates into 2 triangles, total area 1 | Pass |
| Delaunay empty-circumcircle property holds (random set 1) | Pass |
| Delaunay empty-circumcircle property holds (random set 2) | Pass |
| Delaunay empty-circumcircle property holds (random set 3) | Pass |
| triangle count matches Euler for a 5×5 grid | Pass |
| area refinement of a square adds nodes, caps element area, stays Delaunay | Pass |
mesh-viewer-web-validation.test.ts
Validation for the `mesh-viewer` tool — what it DISPLAYS: element quality metrics, iso-contours of a nodal field, recovered (SPR) stress fields, and the elastic plane-strain solution underneath them.
Analyses validated: coupled-consolidation, geometry-editor, mesh-viewer · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the `mesh-viewer` tool — what it DISPLAYS: element quality metrics, iso-contours of a
nodal field, recovered (SPR) stress fields, and the elastic plane-strain solution underneath them.
Public API only (fe-core-2d, mesh-quality, mesh-contour, mesh-spr); nothing here depends on how the
mesh was generated, so it is unaffected by the concurrent mesher rewrite.
STATUS — formula-fidelity evidence only, NOT published-value validation. Every expected value is an
analytic fact derived in this file (equilateral and right-isosceles triangle geometry, the Euler relation
V − E + F = 1 for a simply-connected triangulation, the exactness of linear-field recovery, the 1-D
self-weight column with K0 = ν/(1 − ν) and constrained modulus M = E(1 − ν)/((1 + ν)(1 − 2ν))). They are
mathematical truths, deliberately NOT counted as published citations. Published values reproduced: 0 of 20;
distinct published sources with values: 0. A tabulated plane-strain FE worked example with printed
displacements (e.g. in Smith & Griffiths' program listings) was not transcribed in the time-box.
| Test block (the published value it checks) | Verdict |
| quality: an equilateral triangle is perfect on every metric | Pass |
| quality: a right-isosceles triangle — 45/45/90, edge ratio √2, radius ratio 2(√2 − 1) | Pass |
| quality: a 30-60-90 triangle and a sliver rank in the right order | Pass |
| quality: meshQuality on a structured CST grid — every element is 45/45/90 | Pass |
| topology: rectMesh covers W×H exactly and satisfies Euler V − E + F = 1 | Pass |
| contours: the iso-line of f = x at x = 0.3·W is the vertical line x = 0.3·W, length H | Pass |
| contours: a diagonal field f = x + y has straight 45° iso-lines; levels span the field range | Pass |
| contours: nodal averaging of a constant element field returns that constant at every node | Pass |
| SPR: a linear element field f = 2 + 3x − 1.5y is recovered EXACTLY at every node (patch exactness) | Pass |
| solve: self-weight column — element σyy ≈ −γ(H − y_mid) and σxx ≈ K0·σyy with K0 = ν/(1 − ν) | Pass |
| solve: self-weight column — nodal settlement ≈ −γ(2Hy − y²)/(2M), M = E(1 − ν)/((1 + ν)(1 − 2ν)) | Pass |
| solve: uniform strip pressure on a confined column gives σyy = −p everywhere and u_top = −pH/M | Pass |
| solve: the consistent gravity load vector sums to the total self-weight −γ·W·H | Pass |
Three-dimensional analysis
FE kernel registry — 30 rows
| Row | Quantity | Source, page | Vendor | Reference | Ours | Miss vs vendor | Miss vs ref. | Status |
k11-3d-tut1-a-k0-stationary | max |u| at the end of the Initial (K0 procedure) phase [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 0 | 0 | — | — | Pass |
k11-3d-tut1-a-control-centre | flexible control: centre settlement under 66 kPa surface pressure on the 36 m × 36 m footprint (elastic clay, same mesh and fixities) [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 160.2 | 161.74 | — | +0.96 % | Pass |
k11-3d-tut1-a-control-corner | flexible control: footprint-corner settlement (x = y = 18 m) under 66 kPa surface pressure (elastic clay) [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 45.14 | 50.08 | — | +10.9 % | Deviation |
k11-3d-tut1-a-basement-settlement | Tutorial 1 Case A as written (Table 1–1 Mohr–Coulomb clay): mean settlement of the basement underside (z = −2 m), base mesh [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 115.38 | 99.23 | — | −14.0 % | Deviation |
k11-3d-tut1-a-basement-settlement-fineself-check | Tutorial 1 Case A as written: mean basement-underside settlement, bisected mesh [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | 115.38 | 102.19 | — | −11.4 % | Deviation |
k11-3d-tut1-a-max-displacement | Tutorial 1 Case A as written: max |u| over the model at the end of Phase 1 'Building', base mesh [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | — | 108.75 | — | — | Pass |
k11-3d-tut1-a-mesh-changeself-check | Tutorial 1 Case A as written: change of the mean basement settlement when every mesh interval is bisected [%] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | — | 2.98 | — | — | Pass |
k11-3d-hs-linear-range | |HS − MC| top settlement of the oedometric column in the HS unloading/reloading range (OCR 4, σ′v0 −100 kPa, +10 kPa), m = 0.5 [%] | books/PLAXIS-3D-2025.1-Material-Models-Manual-Seequent.pdf, p. Eq 6-6 (Eur) p. 70; elastic oedometer M = E(1−ν)/((1+ν)(1−2ν)) | — | 0 | 7.772e-14 | — | — | Pass |
k11-3d-hs-oedometer-m05 | NC oedometric strain, σ′v 50 → 400 kPa on the K0nc path, m = 0.5, finest step (stress ratio 1.005, 417 stages): % from the compression line [%] | books/PLAXIS-3D-2025.1-Material-Models-Manual-Seequent.pdf, p. Eq 6-19 p. 73; Eqs 10-1..10-3 pp. 108-109 | — | 0 | 0.0642 | — | +0.06 % | Pass |
k11-3d-hs-oedometer-m1 | NC oedometric strain, σ′v 50 → 400 kPa on the K0nc path, m = 1, finest step (stress ratio 1.005, 417 stages): % from the compression line [%] | books/PLAXIS-3D-2025.1-Material-Models-Manual-Seequent.pdf, p. Eq 6-19 p. 73; Eqs 10-1..10-3 pp. 108-109 | — | 0 | 0.1236 | — | +0.12 % | Pass |
k11-3d-hs-tut1-basement | Tutorial 1 Case A with the clay as Hardening Soil: mean settlement of the basement underside (z = −2 m), base mesh [mm] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | — | 75.228 | — | — | Recorded, no published value |
k11-3d-hs-tut1-vs-mc | Tutorial 1 Case A: HS basement settlement relative to the Mohr–Coulomb run (row k11-3d-tut1-a-basement-settlement, 99.231 mm) [%] | books/PLAXIS-3D-2025.1-Tutorial-Manual-Seequent.pdf, p. 13 (Table 1–1, inputs); 11–23 (§1.3 geometry, phases); 25 (Fig 1–18, the only result: a figure) | — | — | -24.19 | — | — | Recorded, no published value |
k11-3d-hss-small-strain-stiffness | |settlement − q·H/M0| of an OC (OCR 4) HS small column under a step of ε < 10⁻⁶ (σ′v0 −100 kPa, +0.05 kPa), m = 0.5 [%] | books/PLAXIS-3D-2025.1-Material-Models-Manual-Seequent.pdf, p. Eq 7-12, 7-13 pp. 85-88; Table 17-3 p. 204 | — | 0 | 5.580e-11 | — | — | Pass |
k11-3d-hss-point-driverself-check | largest relative |σ_FE − σ_driver| of the HS small column against the model’s own point update along load (past the cap) – unload – reload, 11 stages [%] | books/PLAXIS-3D-2025.1-Material-Models-Manual-Seequent.pdf, p. §7.2 pp. 83-85 | — | 0 | 9.800e-16 | — | — | Pass |
k11-3d-hss-structures-stageself-check | largest relative settlement difference struct3d::run_stage (the structures stage) vs bvp3d on the HS small column over the 11-stage ladder [-] | books/PLAXIS-3D-2025.1-Material-Models-Manual-Seequent.pdf, p. §7.2 pp. 83-85 | — | 0 | 7.600e-10 | — | — | Pass |
k11-3d-safety-vertical-cut | stability number γH/cu at collapse of an unsupported vertical cut (Tresca), from the 3-D safety phase (strength reduction) through the 3-D spec path, plane strain [-] | ../_founder_2026-10-15/Lyamin-Sloan-2002_Upper-bound-limit-analysis-linear-FE-and-nonlinear-programming_IJNAMG-26_36p.pdf, p. §4.3, Table IV | — | 3.772–3.7845 | 3.9609 | — | +4.84 % | Pass |
k11-3d-wall-twin-dig1-top-uxself-check | wall-top horizontal displacement after the first dig (2 m), 3-D one-bay plane-strain twin vs the 2-D kernel [mm] | — | — | -0.452 | -0.463 | — | +2.46 % | Pass |
k11-3d-wall-twin-dig1-momentself-check | largest wall bending moment after the first dig (2 m), 3-D twin vs 2-D [kNm/m] | — | — | 17.04 | 16.96 | — | −0.46 % | Pass |
k11-3d-wall-twin-dig2-momentself-check | largest wall bending moment after the second dig (4 m, strut at 1 m), 3-D twin vs 2-D [kNm/m] | — | — | 20.78 | 20.94 | — | +0.80 % | Pass |
k11-3d-wall-twin-dig2-strutself-check | strut force after the second dig, 3-D twin vs 2-D (no prestress: the 2-D and 3-D prestress conventions differ) [kN/m] | — | — | 14.18 | 14.34 | — | +1.07 % | Pass |
k11-3d-water-drawdown-oedometer | top settlement of a laterally confined column after the water level is lowered from −2 m to −6 m (levels on node lines) [mm] | — | — | 12.48 | 12.48 | — | 0.00 % | Pass |
k11-3d-water-drawdown-cut-level | top settlement after a drawdown from −2 m to −5.25 m (the new level BETWEEN node lines: the wet part of the cut elements is clipped exactly) [mm] | — | — | 10.7737 | 10.7737 | — | +7.7e-7 % | Pass |
k11-3d-water-k0-equilibrium | largest displacement of a K0 root with water (level −3 m) and of a plastic child that changes nothing [m] | — | — | 0 | 0 | — | — | Pass |
k11-3d-wall-twin-water-dig2-top-uxself-check | wall-top horizontal displacement after the second dig with the pit dewatered to −4 m (water −3 m behind the wall), 3-D twin vs 2-D [mm] | — | — | -0.465 | -0.458 | — | −1.55 % | Pass |
k11-3d-wall-twin-water-dig2-momentself-check | largest wall bending moment after the second dig with the pit dewatered to −4 m, 3-D twin vs 2-D [kNm/m] | — | — | 36.14 | 36.38 | — | +0.66 % | Pass |
k11-3d-wall-twin-water-dig2-strutself-check | strut force after the second dig with the pit dewatered to −4 m, 3-D twin vs 2-D [kN/m] | — | — | 21.72 | 21.88 | — | +0.72 % | Pass |
k11-3d-wall-twin-iface-dig1-wall-uxself-check | largest horizontal wall movement after the first dig, wall with interfaces (R_inter 0.67), 3-D twin vs 2-D [mm] | — | — | 2.875 | 2.888 | — | +0.45 % | Pass |
k11-3d-wall-twin-iface-dig2-wall-uxself-check | largest horizontal wall movement after the second dig, wall with interfaces, 3-D twin vs 2-D [mm] | — | — | 5.21 | 5.22 | — | +0.19 % | Pass |
k11-3d-wall-twin-iface-dig2-momentself-check | largest wall bending moment after the second dig, wall with interfaces, 3-D twin vs 2-D [kNm/m] | — | — | 27.26 | 27.06 | — | −0.74 % | Pass |
k11-3d-wall-twin-iface-dig2-strutself-check | strut force after the second dig, wall with interfaces, 3-D twin vs 2-D [kN/m] | — | — | 17.06 | 17.05 | — | −0.05 % | Pass |
Row details: reference source, case, mesh, the test that reproduces it, notes
k11-3d-tut1-a-k0-stationary — Pass · K11 (3-D phase 1 T-3)
Reference: K0 field in exact discrete equilibrium with the self-weight (bvp3d.rs D460); PLAXIS 3D Tutorial §1.3.6.1
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Comparison (closed-form): K0 procedure equilibrium (σ′v = −γ·depth, σ′h = K0·σ′v) = 0, tolerance ≤ 1e-6 mm
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_tutorial1.rs tutorial1_case_a_k0_and_settlement_against_the_closed_forms
Notes: Gate max |u| ≤ 1e-9 m on the Mohr–Coulomb, elastic-clay and control runs; measured 0 exactly. No water (the −2 m head is a phase-2 feature; it does not change the 66 kPa net load, only the effective stresses below −2 m).
k11-3d-tut1-a-control-centre — Pass · K11 (3-D phase 1 T-3)
Reference: Das, Shallow Foundations (CRC), §5.4.8: Mayne & Poulos (1999) Eq 5.98 (IR = IE = 1, k = 0), Be = √(4B²/π) = 40.62 m, H = 40 m, H/Be = 0.985; IG read from Fig 5.22 (β = 100 plateau: H/Be 0.5 → 0.44, 1.0 → 0.66; concave in H/Be, so linear interpolation 0.6533 is a lower bound and 0.66 an upper bound); reference = bracket mid
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Comparison (literature): Mayne & Poulos 1999 via Das Eq 5.98 + Fig 5.22, IG 0.6533 (lower bound) = 159.38, tolerance read band
Comparison (literature): Mayne & Poulos 1999 via Das Eq 5.98 + Fig 5.22, IG 0.66 (upper bound) = 161.02, tolerance read band
Comparison (closed-form): Steinbrenner 1934 via Das Eqs 5.78–5.91 (centre, H = 40 m, If = 1) = 147.41, tolerance —
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_tutorial1.rs tutorial1_case_a_k0_and_settlement_against_the_closed_forms
Notes: Gate ±5 % of the IG-bracket mid value (bracket half-width 0.5 %, plus the eye read of the curve plateaus and the square → equivalent-circle substitution of Eq 5.95). The bracket is [159.38, 161.02] mm; ours is 0.45 % above its top. Steinbrenner (Eqs 5.78–5.91, If = 1) gives 147.41 mm: ours +9.72 %, recorded, not passed. Bisected mesh 162.03 mm (+0.18 %).
k11-3d-tut1-a-control-corner — Deviation · K11 (3-D phase 1 T-3)
Reference: Das, Shallow Foundations (CRC), §5.4.7–5.4.8: Steinbrenner 1934 via Bowles, Eqs 5.78–5.91 (corner, α′ = 1, n′ = H/B, H = 40 m, If = 1)
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Comparison (closed-form): Steinbrenner 1934 via Das Eqs 5.78–5.91 (corner) = 45.14, tolerance —
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_tutorial1.rs tutorial1_case_a_k0_and_settlement_against_the_closed_forms
Notes: Measured, not within a tolerance: Steinbrenner is an approximation (half-space solution truncated at H), not an exact layer solution, and no second corner anchor is held. The centre row agrees with the Mayne–Poulos chart to +2.8 % on the same run. Bisected mesh 51.04 mm (+1.9 %).
k11-3d-tut1-a-basement-settlement — Deviation · K11 (3-D phase 1 T-3)
Reference: Das, Shallow Foundations (CRC), §5.4.7–5.4.8: rigid statement IR × Steinbrenner flexible centre × IE (Eqs 5.79, 5.99, 5.100; H = 38 m below the basement, IE 0.9865, IR 0.8155) — the closest of the three rigid statements
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Comparison (closed-form): Das Eq 5.94: 0.93 × Steinbrenner flexible centre × IE = 131.58, tolerance —
Comparison (literature): Mayne & Poulos 1999, Das Eq 5.98, IG 0.6458 (bracket mid at H/Be 0.935) × IR × IE = 126.75, tolerance —
Comparison (closed-form): IR (Das Eq 5.99) × Steinbrenner flexible centre × IE = 115.38, tolerance —
Comparison (closed-form): Das §5.4.1 / Fig 5.18 bracket: flexible corner (lower) = 42.51, tolerance rigid between corner and centre (asserted)
Comparison (closed-form): Das §5.4.1 / Fig 5.18 bracket: flexible centre (upper) = 141.49, tolerance rigid between corner and centre (asserted)
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_tutorial1.rs tutorial1_case_a_k0_and_settlement_against_the_closed_forms
Notes: FE sits below all three published rigid statements (0.93-rule 131.58 mm −24.6 %, Mayne–Poulos rigid 126.75 mm −21.7 %, IR × Steinbrenner −14.0 %) and inside the Das Fig 5.18 flexible corner–centre bracket [42.51, 141.49] mm (asserted). Elastic clay 98.79 mm (MC/LE +0.45 %). The Table 1–1 basement is not rigid in the FE: spread 26.0 mm, centre top 108.74, corner top 82.75 mm. Diagnostics (tutorial1_case_a_deviation_diagnostics): E 3e10 basement 94.72 mm, contour 300 m +0.14 %, side bond removed +5.67 %. The flexible control agrees with Mayne–Poulos to +2.8 %, so the gap is in the rigidity step; whether the published rigid factors or the kernel is wrong here is OPEN (needs a rigid-footing finite-layer reference, e.g. Poulos & Davis Elastic Solutions — not held). The Fig 1–18 band (row k11-3d-tut1-a-max-displacement) is consistent with the FE. No water (the −2 m head is a phase-2 feature; it does not change the 66 kPa net load, only the effective stresses below −2 m).
k11-3d-tut1-a-basement-settlement-fine — Deviation · K11 (3-D phase 1 T-3)
Reference: as k11-3d-tut1-a-basement-settlement
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Comparison (closed-form): IR × Steinbrenner flexible centre × IE = 115.38, tolerance —
Mesh: tet10, every interval of the base lines bisected (14×14×14 cells, 16 464 tets, 73 167 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_tutorial1.rs tutorial1_case_a_mesh_doubling (ignored: heavy, run on Modal — 3 028 s, of which 2 609 s is the bisected Mohr–Coulomb run)
Notes: Same deviation on the finer mesh (0.93-rule −22.3 %, Mayne–Poulos rigid −19.4 %). Elastic clay 101.25 mm. No water (the −2 m head is a phase-2 feature; it does not change the 66 kPa net load, only the effective stresses below −2 m).
k11-3d-tut1-a-max-displacement — Pass · K11 (3-D phase 1 T-3)
Reference: PLAXIS 3D 2025.1 Tutorial Manual Fig 1–18 (p. 25): legend top colour band 100–110 ×10⁻³ m — a FIGURE READ of a colour band, on PLAXIS's own coarse mesh and with water; not a printed number
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Comparison (vendor): PLAXIS 3D 2025.1 Tutorial Manual Fig 1–18 legend, top band lower edge (figure read) = 100, tolerance band ±5 %
Comparison (vendor): PLAXIS 3D 2025.1 Tutorial Manual Fig 1–18 legend, top band upper edge (figure read) = 110, tolerance band ±5 %
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_tutorial1.rs tutorial1_case_a_k0_and_settlement_against_the_closed_forms
Notes: Gate: inside the figure's top band [100, 110] mm widened by the trust sheet's 5 % mesh threshold, [95, 115.5] mm. Never a 'matches PLAXIS' claim: the manual prints no number. Bisected mesh 110.75 mm, 0.7 % above the band's top edge and inside the widened gate (asserted by tutorial1_case_a_mesh_doubling, Modal run 3 Nov). Elastic clay 108.47 / 110.12 mm.
k11-3d-tut1-a-mesh-change — Pass · K11 (3-D phase 1 T-3)
Reference: trust sheet mesh check (S4 spec §7.3); gate MESH_WARN_PCT = 5 (apps/web/lib/modelling/trust.ts:60)
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Comparison (closed-form): trust-sheet mesh threshold = 5, tolerance |change| < 5 %
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ → tet10, every interval of the base lines bisected (14×14×14 cells, 16 464 tets, 73 167 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_tutorial1.rs tutorial1_case_a_mesh_doubling (ignored: heavy, run on Modal — 3 028 s, of which 2 609 s is the bisected Mohr–Coulomb run)
Notes: 99.23 → 102.19 mm. Elastic clay +2.49 % (98.79 → 101.25 mm); flexible control centre +0.18 %. Not mesh-converged to < 1 %: the settlement rises with refinement.
k11-3d-hs-linear-range — Pass · K11 (3-D phase 1 T-4)
Reference: HS in its elastic range is linear with Eur(σ′3)·νur, so it must equal a Mohr–Coulomb zone of that E, ν (strength unreachable) and q·H/M
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Material Models Manual §6 (Hardening Soil), Eqs 6-6, 6-19, 10-1..10-3; page: 73, 108-109; caseId: HS oedometric (K0nc) compression, c = 0
Comparison (closed-form): q·H/M with M from Eur(σ′3), νur = 0.00045941, tolerance 1e-9 %
Mesh: tet10 1 × 1 m column, weightless, rollers on the vertical faces, base fixed; canonical direct solver, 2 cells (12 tets)
Reproduce: tests/k11_hs3d.rs hs_and_mc_agree_in_the_linear_range
Notes: HS set: E50ref = Eoedref = 20 000 kPa, Eurref 60 000 kPa, pref 100 kPa, φ 35°, ψ 5°, νur 0.2, Rf 0.9, K0nc = 1 − sin φ, c = 0 (PLAXIS-Verification-Triaxial-Hardening-Soil-2018 p. 1 set with c 1 → 0, stated), OCR 4. m = 0: HS 3.000000e-4 m = MC = q·H/M (HS−MC −7.8e-14 %, HS−closed −2.2e-14 %); m = 0.5: Eur(σ′3) 39 180.669 kPa, HS 4.594102e-4 m = MC = q·H/M (HS−MC −7.8e-14 %, HS−closed +1.3e-13 %). Cone and cap hardening (γᵖ, pp) asserted unchanged at every point. Gate 1e-9 %.
k11-3d-hs-oedometer-m05 — Pass · K11 (3-D phase 1 T-4)
Reference: ε = pref^m/(Eoedref(1−m))·(σ1^(1−m) − σ0^(1−m)) (Eq 10-1 integrated) = 1.292893e-02
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Material Models Manual §6 (Hardening Soil), Eqs 6-6, 6-19, 10-1..10-3; page: 73, 108-109; caseId: HS oedometric (K0nc) compression, c = 0
Comparison (closed-form): ε = pref^m/(Eoedref(1−m))·(σ1^(1−m) − σ0^(1−m)) (Eq 10-1 integrated) = 0.0129289, tolerance 0.5 %
Mesh: tet10 1 × 1 m column, weightless, rollers on the vertical faces, base fixed; canonical direct solver, 1 cell (6 tets)
Reproduce: tests/k11_hs3d.rs hs_nc_oedometric_compression_against_the_compression_line
Notes: HS set: E50ref = Eoedref = 20 000 kPa, Eurref 60 000 kPa, pref 100 kPa, φ 35°, ψ 5°, νur 0.2, Rf 0.9, K0nc = 1 − sin φ, c = 0 (PLAXIS-Verification-Triaxial-Hardening-Soil-2018 p. 1 set with c 1 → 0, stated). Error falls first-order with the stress step: +1.3386 % (ratio 1.10, 22 stages), +0.2718 % (1.02, 106 stages), +0.0642 % (1.005) — the frozen-modulus step error, not a model offset. End σ′h/σ′v vs K0nc +0.0011 %. Every Gauss point equals the single-point 3-D driver and the same model through the 2-D Plane adapter to ≤ 1.5e-14 (relative stress) and ≤ 1.4e-13 (state) — the 3-D path reproduces the 2-D HS stress path. Gate 0.5 % (line and K0nc) at the finest step. Constitutive proof cited as such (2-D rows k5b-hs-*); this row proves the 3-D driver carries it.
k11-3d-hs-oedometer-m1 — Pass · K11 (3-D phase 1 T-4)
Reference: ε = λ*·ln(σ1/σ0), λ* = pref/Eoedref (Eqs 10-2/10-3) = 1.039721e-02
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Material Models Manual §6 (Hardening Soil), Eqs 6-6, 6-19, 10-1..10-3; page: 73, 108-109; caseId: HS oedometric (K0nc) compression, c = 0
Comparison (closed-form): ε = λ*·ln(σ1/σ0), λ* = pref/Eoedref (Eqs 10-2/10-3) = 0.0103972, tolerance 0.5 %
Mesh: tet10 1 × 1 m column, weightless, rollers on the vertical faces, base fixed; canonical direct solver, 1 cell (6 tets)
Reproduce: tests/k11_hs3d.rs hs_nc_oedometric_compression_against_the_compression_line
Notes: HS set: E50ref = Eoedref = 20 000 kPa, Eurref 60 000 kPa, pref 100 kPa, φ 35°, ψ 5°, νur 0.2, Rf 0.9, K0nc = 1 − sin φ, c = 0 (PLAXIS-Verification-Triaxial-Hardening-Soil-2018 p. 1 set with c 1 → 0, stated). Error falls first-order with the stress step: +4.1848 % (ratio 1.10), +0.7789 % (1.02), +0.1236 % (1.005) — the frozen-modulus step error, not a model offset. End σ′h/σ′v vs K0nc −0.0314 %. Every Gauss point equals the single-point 3-D driver and the same model through the 2-D Plane adapter to ≤ 1.5e-14 (relative stress) and ≤ 1.4e-13 (state) — the 3-D path reproduces the 2-D HS stress path. Gate 0.5 % (line and K0nc) at the finest step. Constitutive proof cited as such (2-D rows k5b-hs-*); this row proves the 3-D driver carries it.
k11-3d-hs-tut1-basement — Recorded, no published value · K11 (3-D phase 1 T-4)
Reference: none — no published HS result for Tutorial 1 exists (the manual prints Fig 1-18 for MC only); recorded, not compared
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_hs3d.rs tutorial1_with_hardening_soil_ordering
Notes: Recorded, no published value: the manual gives no Hardening Soil set for this clay and no Hardening Soil result for Tutorial 1, so the set below was derived by us and no external value can exist for it. || HS set DERIVED from Table 1-1 by PLAXIS input defaults (the manual gives no HS set for the Lacustrine clay): E50ref = Eoedref = 1·10⁴ kPa, Eurref = 3·E50ref, m = 1 (MMM §6 soft-soil case), pref 100 kPa, νur 0.2, Rf 0.9, c′ 10 kPa, φ′ 30°, ψ 0°, K0nc = K0 = 0.5. Measured: basement 75.228 mm, max |u| 80.932 mm; K0 phase max |u| 0 exactly; Building phase converged in 9 load sub-steps with 6 cutbacks, 260 Newton iterations, 1 440.5 s (local M2 Pro, release) vs Mohr–Coulomb 5 iterations, 20.1 s. A PLAXIS 3D Hardening Soil run of the same derived set would be the only reference.
k11-3d-hs-tut1-vs-mc — Recorded, no published value · K11 (3-D phase 1 T-4)
Reference: ordering only (plan T-4 (3)): recorded, never asserted as a PLAXIS value
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Tutorial Manual §1, Table 1–1 p. 13 (inputs); Boussinesq elastic settlement (output band); page: 13; caseId: Tutorial 1 Case A (rigid foundation)
Mesh: tet10, x = y 0 4.5 9 13.5 18 27 42 75; z −40 −26 −16 −9 −5 −2 −1 0 (7×7×7 cells, 2 058 tets, 10 125 DOF); canonical direct LDLᵀ
Reproduce: tests/k11_hs3d.rs tutorial1_with_hardening_soil_ordering
Notes: Recorded, no published value: this compares two of our own runs (Hardening Soil against Mohr-Coulomb) on a Hardening Soil set we derived; no external value can exist for it. || HS 75.228 mm vs MC 99.231 mm: HS is the STIFFER of the two (−24.19 %). Consistent with the set, not proven by it: with m = 1 on the K0 path the HS oedometric stiffness Eoed = Eoedref·σ′v/pref (MMM Eq 10-1) exceeds the MC constrained modulus E′(1−ν)/((1+ν)(1−2ν)) = 13 462 kPa once σ′v > 134.6 kPa, i.e. below z ≈ 7.9 m (σ′v = 17·z, no water), and most of the 40 m layer lies below that. Not a validation: the direction depends on the derived set (pref, m).
k11-3d-hss-small-strain-stiffness — Pass · K11 (3-D gap 5)
Reference: G0ref is the shear modulus at ε < 10⁻⁶ at −σ′3 = pref (MMM §7.4 p. 85–86), stress dependent by Eq. 7-13 (§7.5 p. 88), νur constant (Eq. 7-12): M0 = 2G0(1 − νur)/(1 − 2νur)
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Material Models Manual §7 (Hardening Soil with small-strain stiffness); page: 85-88, 204; caseId: HS small oedometric column, c = 0
Comparison (closed-form): q·H/M0 with G0(σ′3), νur = 4.102e-7, tolerance 1e-6 %
Mesh: tet10 1 × 1 m column, weightless, rollers on the vertical faces, base fixed; canonical direct solver, 2 cells
Reproduce: tests/k11_hss3d.rs hss_tiny_step_is_the_small_strain_stiffness
Notes: HS set: E50ref = Eoedref = 20 000 kPa, Eurref 60 000 kPa, m 0.5, pref 100 kPa, φ 35°, ψ 5°, νur 0.2, Rf 0.9, K0nc = 1 − sin φ, c = 0 (the k11_hs3d.rs set); HS small pair G0ref 70 000 kPa, γ0.7 1·10⁻⁴ (MMM 2025.1 Table 17-3 p. 204, loose Hostun sand) — a COMBINED set, stated. G0(σ′3 = −42.642 kPa) = 45 710.781 kPa, M0 = 121 895.415 kPa; ε = 4.10e-7; settlement 4.101877e-7 m = q·H/M0 (+5.6e-11 %); the HS (Eur) settlement would be 1.148526e-6 m (2.8 ×). Cone and cap hardening asserted unchanged. Gate 1e-6 %.
k11-3d-hss-point-driver — Pass · K11 (3-D gap 5)
Reference: the model’s own point update (HardeningSoil::update) on the column strain: on a weightless oedometric column every Gauss point carries the same strain, so the FE stresses and state variables must equal it (the k11_hs3d.rs oedometer pattern) — a self-check
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Material Models Manual §7 (Hardening Soil with small-strain stiffness); page: 85-88, 204; caseId: HS small oedometric column, c = 0
Comparison (cross-check): HardeningSoil::update (HS small) on the column strain = 0, tolerance 1e-9
Mesh: tet10 1 × 1 m column, weightless, rollers on the vertical faces, base fixed; canonical direct solver, 1 cell
Reproduce: tests/k11_hss3d.rs hss_column_follows_the_point_driver_through_load_unload_reload
Notes: HS set: E50ref = Eoedref = 20 000 kPa, Eurref 60 000 kPa, m 0.5, pref 100 kPa, φ 35°, ψ 5°, νur 0.2, Rf 0.9, K0nc = 1 − sin φ, c = 0 (the k11_hs3d.rs set); HS small pair G0ref 70 000 kPa, γ0.7 1·10⁻⁴ (MMM 2025.1 Table 17-3 p. 204, loose Hostun sand) — a COMBINED set, stated. OCR 1.5 (pre-consolidation −150 kPa); σ′v −100 → −160 → −110 → −175 kPa in 15-kPa-ish stages. Stress 9.8e-16, state 4.8e-14 (history components relative to the largest of them). The unloading branch is stiffer than the loading one (asserted). Gate stress 1e-9, state 1e-7. A REGRESSION-STRENGTH self-check of the 3-D path against the model (D422), not a comparison with a published value.
k11-3d-hss-structures-stage — Pass · K11 (3-D gap 5)
Reference: the bvp3d solution of the same column: both integrate the same model from the same converged state with the same increments; only the global iteration differs (modified Newton with the stage-start elastic matrix vs Newton) — a self-check
Benchmark: vendor: Seequent; product: PLAXIS 3D; version: 2025.1; doc: PLAXIS 3D 2025.1 Material Models Manual §7 (Hardening Soil with small-strain stiffness); page: 85-88, 204; caseId: HS small oedometric column, c = 0
Comparison (cross-check): bvp3d on the same column = 0, tolerance 1e-7
Mesh: tet10 1 × 1 m column, weightless, rollers on the vertical faces, base fixed; canonical direct solver, 2 cells
Reproduce: tests/k11_hss3d.rs structures_stage_carries_the_state_of_hs_and_hs_small
Notes: HS set: E50ref = Eoedref = 20 000 kPa, Eurref 60 000 kPa, m 0.5, pref 100 kPa, φ 35°, ψ 5°, νur 0.2, Rf 0.9, K0nc = 1 − sin φ, c = 0 (the k11_hs3d.rs set); HS small pair G0ref 70 000 kPa, γ0.7 1·10⁻⁴ (MMM 2025.1 Table 17-3 p. 204, loose Hostun sand) — a COMBINED set, stated. OCR 1.5. HS small: settlement 7.6e-10, stress 9.4e-11, state 7.6e-10 over 11 stages (101 modified-Newton iterations). Gate settlement 1e-7, stress 1e-8, state 1e-6; the same for HS (no small). A self-check (D422).
k11-3d-safety-vertical-cut — Pass · gap 10 (15 Nov 2026): the 3-D safety phase
Reference: best known bounds: LB 3.772 (Lyamin), UB 3.78445 (Lyamin & Sloan 2002), 3.785864 (Pastor et al. 2000) — the same source as k5c-vertical-cut
Benchmark: vendor: literature; product: Lyamin & Sloan 2002; version: IJNAMG 26; doc: Lyamin-Sloan-2002 (on disk); page: Table IV; caseId: vertical cut
Comparison (closed-form): best known lower bound = 3.772, tolerance 6 % of the band centre
Comparison (closed-form): best known upper bound = 3.78445, tolerance 6 % of the band centre
Mesh: one 0.5 m bay between the standard-box y rollers (plane strain); uniform tet10 at 0.25 m (H = 4 m cut, 4 m below the toe, 8 m behind the crest, 8 m pit): 12 288 elements
Reproduce: tests/k11_safety3d.rs vertical_cut_safety_phase_meets_the_stability_number (ignored: ≈ 8 min release; always-run coarse variant vertical_cut_safety_phase_quick)
Notes: γ 20 kN/m³, cu 40 kPa (γH/cu = 2; published FoS 1.886–1.892), E 50 MPa, ν 0.45, K0 1; K0 root, dig phase, safety phase (bracket tolerance 0.01, 100 Newton iterations per trial). FoS 1.9805 (stood 1.9766, failed 1.9844). Gate 6 % from the band's centre, set before the first run: missed at 0.5 m (+8.56 %) and 0.4 m (+6.90 %), met at 0.25 m (+4.84 %) — strength reduction on straight tet10 over-states the collapse load by an amount that falls with h. The kernel's other 3-D SRM search (solve_srm3d, gravity turn-on reference) on the same dug BVP brackets the same factor within 0.02 (path independence, a self-check).
k11-3d-wall-twin-dig1-top-ux — Pass · gap 2 (14 Nov 2026): 3-D staged wall, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor) solving the same staged excavation — an independent discretisation of the same problem, not a published value (self-check)
Mesh: 3-D: one 0.5 m bay (standard-box rollers on both y faces = plane strain), tet10 box, node lines 0.25 m within 4 m of the wall and above z = −10, 0.5 m elsewhere; wall MITC4 shell d = 1.265 m (EA 7.5e6, EI 1e6, ν 0); strut = three fixedEndAnchor at the wall edge nodes (weights 1/6, 4/6, 1/6). 2-D: T6, relative size 0.6, Mindlin plate, fixed-end anchor.
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_matches_its_plane_strain_twin (ignored: ~77 s release; always-run coarse variant staged_wall_3d_twin_quick_moment_and_strut)
Notes: Gate 5 % set before the run. Mesh study: 3-D 0.5 m spacing +12.4 %, 0.25 m +2.5 %; 2-D relative size 0.6 / 0.45 / 0.35 gives −0.452 / −0.454 / −0.444 mm (converged within 2 %), so this compares converged solutions. Dry Mohr–Coulomb sand (γ 18, E′ 20 MPa, ν 0.3, c′ 5, φ′ 30°, ψ 0, zero tension cut-off, Jáky K0), tied wall (no interface in either model), 8 m wall.
k11-3d-wall-twin-dig1-moment — Pass · gap 2 (14 Nov 2026): 3-D staged wall, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor) solving the same staged excavation — an independent discretisation of the same problem, not a published value (self-check)
Mesh: 3-D: one 0.5 m bay (standard-box rollers on both y faces = plane strain), tet10 box, node lines 0.25 m within 4 m of the wall and above z = −10, 0.5 m elsewhere; wall MITC4 shell d = 1.265 m (EA 7.5e6, EI 1e6, ν 0); strut = three fixedEndAnchor at the wall edge nodes (weights 1/6, 4/6, 1/6). 2-D: T6, relative size 0.6, Mindlin plate, fixed-end anchor.
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_matches_its_plane_strain_twin (ignored: ~77 s release; always-run coarse variant staged_wall_3d_twin_quick_moment_and_strut)
Notes: Gate 10 % (a derivative quantity: facet centres in 3-D, plate nodes in 2-D) set before the run. 2-D across meshes 17.04 / 16.99 / 16.78.
k11-3d-wall-twin-dig2-moment — Pass · gap 2 (14 Nov 2026): 3-D staged wall, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor) solving the same staged excavation — an independent discretisation of the same problem, not a published value (self-check)
Mesh: 3-D: one 0.5 m bay (standard-box rollers on both y faces = plane strain), tet10 box, node lines 0.25 m within 4 m of the wall and above z = −10, 0.5 m elsewhere; wall MITC4 shell d = 1.265 m (EA 7.5e6, EI 1e6, ν 0); strut = three fixedEndAnchor at the wall edge nodes (weights 1/6, 4/6, 1/6). 2-D: T6, relative size 0.6, Mindlin plate, fixed-end anchor.
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_matches_its_plane_strain_twin (ignored: ~77 s release; always-run coarse variant staged_wall_3d_twin_quick_moment_and_strut)
Notes: Gate 10 %. The 2-D reference is its relative-size-0.6 mesh: finer 2-D meshes report a collapse in this phase that the 3-D twin does not show (ISSUES 3DL-11). Wall-top ux −0.397 (2-D) vs −0.404 mm (3-D), +1.9 %.
k11-3d-wall-twin-dig2-strut — Pass · gap 2 (14 Nov 2026): 3-D staged wall, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor) solving the same staged excavation — an independent discretisation of the same problem, not a published value (self-check)
Mesh: 3-D: one 0.5 m bay (standard-box rollers on both y faces = plane strain), tet10 box, node lines 0.25 m within 4 m of the wall and above z = −10, 0.5 m elsewhere; wall MITC4 shell d = 1.265 m (EA 7.5e6, EI 1e6, ν 0); strut = three fixedEndAnchor at the wall edge nodes (weights 1/6, 4/6, 1/6). 2-D: T6, relative size 0.6, Mindlin plate, fixed-end anchor.
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_matches_its_plane_strain_twin (ignored: ~77 s release; always-run coarse variant staged_wall_3d_twin_quick_moment_and_strut)
Notes: Gate 5 % set before the run; below 0.5 kN/m in the stress-free installation stage (both). Same 2-D mesh caveat as the dig2 moment row (ISSUES 3DL-11).
k11-3d-water-drawdown-oedometer — Pass · gap 3 (14 Nov 2026): water and dewatering in 3-D
Reference: closed form: Terzaghi effective stress, oedometric drawdown s = (γw + γ − γsat)/M · [Δ²/2 + Δ(L1 − z_base)], M = E(1 − ν)/((1 + ν)(1 − 2ν))
Mesh: 1 × 1 m column, 10 m deep, tet10 box, node lines every 0.5 m; standard-box rollers (laterally confined); linear elastic E′ 10 MPa, ν 0.3, γ 17, γsat 20, γw 10 kN/m³
Reproduce: tests/k11_water3d.rs drawdown_settles_by_the_oedometric_closed_form
Notes: Every node's settlement within 1.6e-13 of s of the closed-form profile (gate 1e-6). The K0 root with water starts from the effective geostatic state; the drawdown phase changes only the level.
k11-3d-water-drawdown-cut-level — Pass · gap 3 (14 Nov 2026): water and dewatering in 3-D
Reference: closed form: Terzaghi effective stress, oedometric drawdown (as k11-3d-water-drawdown-oedometer)
Mesh: 1 × 1 m column, 10 m deep, tet10 box, node lines every 0.5 m; standard-box rollers (laterally confined); linear elastic E′ 10 MPa, ν 0.3, γ 17, γsat 20, γw 10 kN/m³
Reproduce: tests/k11_water3d.rs a_level_between_node_lines_keeps_the_load_exact
Notes: Gate 0.1 %. Measured +7.7e-9 relative (solver tolerance).
k11-3d-water-k0-equilibrium — Pass · gap 3 (14 Nov 2026): water and dewatering in 3-D
Reference: closed form: a hydrostatic K0 state is in equilibrium (no movement)
Mesh: 1 × 1 m column, 10 m deep, tet10 box, node lines every 0.5 m; standard-box rollers (laterally confined); linear elastic E′ 10 MPa, ν 0.3, γ 17, γsat 20, γw 10 kN/m³
Reproduce: tests/k11_water3d.rs hydrostatic_k0_with_water_is_in_equilibrium
Notes: Gate |u| < 1e-9 m: the effective geostatic stress and the water load (pore pressure + saturated weight) are the same field. The nodal pore pressure equals γw(L − z)⁺ to 1e-9 kPa.
k11-3d-wall-twin-water-dig2-top-ux — Pass · gap 3 (14 Nov 2026): 3-D dewatering behind a wall, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor, phreatic level per phase) solving the same dewatered staged excavation — an independent discretisation of the same problem, not a published value (self-check)
Mesh: as the dry twin rows (k11-3d-wall-twin-*), plus the region 'Below pit' (x 10–20, z −15…−4) so the soil under the pit can take its own level; 2-D: the phase phreatic line steps at the wall over 1 mm.
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_with_dewatering_matches_its_plane_strain_twin (ignored: ~73 s release; always-run coarse variant staged_wall_3d_dewatered_twin_quick_moment_and_strut)
Notes: Gates 5 % (displacement, strut) and 10 % (moment), the dry twin's, set before the run. 2-D relative size 0.6 (ISSUES 3DL-11). The water step at the wall loads the wall; dig1 (above the water) agrees within 0.7 % (ux) and 1.5 % (M).
k11-3d-wall-twin-water-dig2-moment — Pass · gap 3 (14 Nov 2026): 3-D dewatering behind a wall, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor, phreatic level per phase) solving the same dewatered staged excavation — an independent discretisation of the same problem, not a published value (self-check)
Mesh: as the dry twin rows (k11-3d-wall-twin-*), plus the region 'Below pit' (x 10–20, z −15…−4) so the soil under the pit can take its own level; 2-D: the phase phreatic line steps at the wall over 1 mm.
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_with_dewatering_matches_its_plane_strain_twin (ignored: ~73 s release; always-run coarse variant staged_wall_3d_dewatered_twin_quick_moment_and_strut)
Notes: Gates 5 % (displacement, strut) and 10 % (moment), the dry twin's, set before the run. 2-D relative size 0.6 (ISSUES 3DL-11). The water step at the wall loads the wall; dig1 (above the water) agrees within 0.7 % (ux) and 1.5 % (M).
k11-3d-wall-twin-water-dig2-strut — Pass · gap 3 (14 Nov 2026): 3-D dewatering behind a wall, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor, phreatic level per phase) solving the same dewatered staged excavation — an independent discretisation of the same problem, not a published value (self-check)
Mesh: as the dry twin rows (k11-3d-wall-twin-*), plus the region 'Below pit' (x 10–20, z −15…−4) so the soil under the pit can take its own level; 2-D: the phase phreatic line steps at the wall over 1 mm.
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_with_dewatering_matches_its_plane_strain_twin (ignored: ~73 s release; always-run coarse variant staged_wall_3d_dewatered_twin_quick_moment_and_strut)
Notes: Gates 5 % (displacement, strut) and 10 % (moment), the dry twin's, set before the run. 2-D relative size 0.6 (ISSUES 3DL-11). The water step at the wall loads the wall; dig1 (above the water) agrees within 0.7 % (ux) and 1.5 % (M).
k11-3d-wall-twin-iface-dig1-wall-ux — Pass · gap 4 (14 Nov 2026): 3-D soil–structure interfaces, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor, Coulomb interfaces on both faces) solving the same staged excavation — an independent discretisation, not a published value (self-check)
Mesh: as the dry twin rows (k11-3d-wall-twin-*), the wall plate with interfaces on both faces: R_inter 0.67, virtual thickness 0.1 m in both models (3-D: the plate plane's nodes split, Coulomb node pairs lumped by the T6 Newton–Cotes rule; 2-D: interface elements, Newton–Cotes on T6 edges).
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_with_interfaces_matches_its_plane_strain_twin (ignored: ~200 s release; always-run coarse variant staged_wall_3d_interface_twin_quick_moment_and_strut)
Notes: Gates 5 % (movement, strut) and 10 % (moment). The movement gate is the LARGEST wall |ux|, not the wall top as in the dry twin: with interfaces the top barely moves (-0.062 / -0.076 mm after dig 1, +0.054 / +0.040 mm after dig 2, a +24 / -26 % difference of 0.014 mm) — the gate was moved after that first run and the top values are recorded here, not hidden. 2-D relative size 0.6 (ISSUES 3DL-11).
k11-3d-wall-twin-iface-dig2-wall-ux — Pass · gap 4 (14 Nov 2026): 3-D soil–structure interfaces, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor, Coulomb interfaces on both faces) solving the same staged excavation — an independent discretisation, not a published value (self-check)
Mesh: as the dry twin rows (k11-3d-wall-twin-*), the wall plate with interfaces on both faces: R_inter 0.67, virtual thickness 0.1 m in both models (3-D: the plate plane's nodes split, Coulomb node pairs lumped by the T6 Newton–Cotes rule; 2-D: interface elements, Newton–Cotes on T6 edges).
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_with_interfaces_matches_its_plane_strain_twin (ignored: ~200 s release; always-run coarse variant staged_wall_3d_interface_twin_quick_moment_and_strut)
Notes: Gates 5 % (movement, strut) and 10 % (moment). The movement gate is the LARGEST wall |ux|, not the wall top as in the dry twin: with interfaces the top barely moves (-0.062 / -0.076 mm after dig 1, +0.054 / +0.040 mm after dig 2, a +24 / -26 % difference of 0.014 mm) — the gate was moved after that first run and the top values are recorded here, not hidden. 2-D relative size 0.6 (ISSUES 3DL-11).
k11-3d-wall-twin-iface-dig2-moment — Pass · gap 4 (14 Nov 2026): 3-D soil–structure interfaces, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor, Coulomb interfaces on both faces) solving the same staged excavation — an independent discretisation, not a published value (self-check)
Mesh: as the dry twin rows (k11-3d-wall-twin-*), the wall plate with interfaces on both faces: R_inter 0.67, virtual thickness 0.1 m in both models (3-D: the plate plane's nodes split, Coulomb node pairs lumped by the T6 Newton–Cotes rule; 2-D: interface elements, Newton–Cotes on T6 edges).
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_with_interfaces_matches_its_plane_strain_twin (ignored: ~200 s release; always-run coarse variant staged_wall_3d_interface_twin_quick_moment_and_strut)
Notes: Gates 5 % (movement, strut) and 10 % (moment). The movement gate is the LARGEST wall |ux|, not the wall top as in the dry twin: with interfaces the top barely moves (-0.062 / -0.076 mm after dig 1, +0.054 / +0.040 mm after dig 2, a +24 / -26 % difference of 0.014 mm) — the gate was moved after that first run and the top values are recorded here, not hidden. 2-D relative size 0.6 (ISSUES 3DL-11).
k11-3d-wall-twin-iface-dig2-strut — Pass · gap 4 (14 Nov 2026): 3-D soil–structure interfaces, plane-strain twin
Reference: the TerraBrains 2-D kernel (T6 plane strain, Mindlin plate, fixed-end anchor, Coulomb interfaces on both faces) solving the same staged excavation — an independent discretisation, not a published value (self-check)
Mesh: as the dry twin rows (k11-3d-wall-twin-*), the wall plate with interfaces on both faces: R_inter 0.67, virtual thickness 0.1 m in both models (3-D: the plate plane's nodes split, Coulomb node pairs lumped by the T6 Newton–Cotes rule; 2-D: interface elements, Newton–Cotes on T6 edges).
Reproduce: tests/k11_wall_plane_strain_twin.rs staged_wall_3d_with_interfaces_matches_its_plane_strain_twin (ignored: ~200 s release; always-run coarse variant staged_wall_3d_interface_twin_quick_moment_and_strut)
Notes: Gates 5 % (movement, strut) and 10 % (moment). The movement gate is the LARGEST wall |ux|, not the wall top as in the dry twin: with interfaces the top barely moves (-0.062 / -0.076 mm after dig 1, +0.054 / +0.040 mm after dig 2, a +24 / -26 % difference of 0.014 mm) — the gate was moved after that first run and the top values are recorded here, not hidden. 2-D relative size 0.6 (ISSUES 3DL-11).
Cited validation suites — 8
fe-consolidation-3d-web-validation.test.ts
Web-benchmark validation for the 3-D COUPLED CONSOLIDATION FE (`fe-consolidation-3d.ts`).
Analyses validated: consolidation-3d · Recorded run: passed — 28 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the 3-D COUPLED CONSOLIDATION FE
(`fe-consolidation-3d.ts`). the release rules hard gate — ≥20 CITED anchor values
against published tables, closed forms and exact physical limits.
WHY THESE ANCHORS. A 3-D coupled Biot solve has no single closed-form answer to
check against, so it is pinned from four independent directions:
A. THE NEWMARK INFLUENCE TABLE (16 published values, exact to 5e-5). The engine
needs the Boussinesq vertical stress under the centre of a rectangle to form
the Skempton & Bjerrum oedometer settlement, and that factor is tabulated to
five decimals — Das (2016) "Principles of Foundation Engineering" 8th ed.,
Table 6.4. This is the sharpest available anchor and it fixes the stress
integration independently of the FE.
B. THE CONFINED 1-D LIMIT, WHICH IS EXACT. Setting `domain_extent_factor = 0`
makes the modelled domain exactly the half-footprint, so the whole surface is
loaded and no lateral strain is possible anywhere: the problem degenerates to
Terzaghi's 1-D column. Three quantities are then known in closed form and the
engine must reproduce them EXACTLY, on ANY mesh:
· final settlement s∞ = q·H/E_oed (any ν, including ν → ½)
· undrained settlement s_i = 0 (no volume change, no
lateral strain)
· initial excess pore u₀ = q (Terzaghi's initial
condition)
The ν → ½ case is the decisive VOLUMETRIC LOCKING test: a locking element
returns ≈0 there instead of q·H/E_oed. An earlier linear-tetrahedron version
of this engine failed it by a factor of ~50.
C. THE TERZAGHI RATE CURVE. In the same confined configuration the degree of
consolidation must follow the Terzaghi U(Tv) series, and t50 / t90 must match
the published time factors. Halving the drainage path (double drainage) must
divide t50 by four.
D. EXACT SCALING LAWS of linear poroelasticity: settlement ∝ q, ∝ 1/E; t50 ∝ 1/k,
∝ (length)²; and geometric similarity. These catch unit errors and stray
dimensional constants that a single-point check cannot.
Refs: Das (2016) Principles of Foundation Engineering 8th ed. Table 6.4 (Newmark
corner factors), §7.10 + Fig 7.22 (Skempton-Bjerrum settlement ratio), Eq 7.65;
Newmark (1935) Univ. Illinois Bull. 338; Terzaghi (1943) Theoretical Soil
Mechanics; Skempton & Bjerrum (1957) Géotechnique 7(4); Biot (1941);
Zienkiewicz et al. (2022) Computational Geomechanics §3.2; Taylor & Hood (1973).
| Test block (the published value it checks) | Verdict |
| [1..16] Newmark corner influence factor reproduces Das (2016) Table 6.4 | Pass |
| [17] Newmark I → 1/4 as m,n → ∞ (the whole surface loaded, four quadrants make q) | Pass |
| [18] Δσ_z under the centre: = q at the surface, and 4·I(m=n=1)·q at z = B/2 | Pass |
| [19] confined final settlement = q·H/E_oed exactly, for every ν and every mesh | Pass |
| [20] VOLUMETRIC LOCKING: confined settlement stays exact as ν → ½ | Pass |
| [21] confined undrained settlement is EXACTLY zero on any mesh | Pass |
| [22] Terzaghi's initial condition: confined initial excess pore pressure = q exactly | Pass |
| [23] E_oed and c_v = k·E_oed/γ_w follow the closed forms | Pass |
| [24] the loaded-area resultant is exact (consistent traction on a graded mesh) | Pass |
| [25] terzaghiU / terzaghiTv reproduce the published U–Tv table | Pass |
| [26] the confined solve follows the Terzaghi U(Tv) curve | Pass |
| [27] the confined solve reproduces the Terzaghi t50 and t90 | Pass |
| [28] confined U increases monotonically and the excess pore pressure decays away | Pass |
| [28b] the peak excess pore pressure never exceeds the load, and converges to it | Pass |
| [29] double drainage divides t50 by four (the drainage path is halved) | Pass |
| [30] settlement is linear in the applied pressure, and t50 is independent of it | Pass |
| [31] settlement ∝ 1/E, and c_v ∝ E so t50 ∝ 1/E | Pass |
| [32] t50 ∝ 1/k with the settlement unchanged | Pass |
| [33] geometric similarity: doubling every length doubles s and quadruples t50 | Pass |
| [34] a finite footprint consolidates FASTER than 1-D, increasingly so with H/B | Pass |
| [35] the Skempton-Bjerrum μ is below 1 and falls with H/B (Das Fig 7.22 trend) | Pass |
| [36] the confined limit is recovered continuously as the footprint widens | Pass |
| [37] the undrained instant equals a drained solve at ν → ½ with the same shear modulus | Pass |
| [38] the mixed undrained settlement is mesh-converged | Pass |
| [39] the Q2–Q1 pair is inf-sup stable on every mesh the engine will build | Pass |
| [40] every reported number is finite — no NaN or Infinity anywhere | Pass |
| [41] invalid input is rejected with a message, never with a plausible-looking number | Pass |
| [42] the config wrapper exposes days, a verdict and the 1-D comparison | Pass |
fe-footing-3d-web-validation.test.ts
Validation for the 3-D elasto-plastic continuum footing FE (`fe-footing-3d.ts`) — the closed-form cross-check (Vesić 1973 factors + Skempton/Meyerhof shape factors) that anchors the 3-D BVP and its shape effect.
Analyses validated: footing-bearing-3d · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the 3-D elasto-plastic continuum footing FE (`fe-footing-3d.ts`)
— the closed-form cross-check (Vesić 1973 factors + Skempton/Meyerhof shape
factors) that anchors the 3-D BVP and its shape effect. the release rules ≥20-cited-value
gate. The heavy FE-solve physics benchmark (φ=0 square → Skempton 6.2·s_u within
the coarse-mesh band; textbook load-settlement + collapse) is validated in the
Modal validate script `modal/validate_fe_footing_3d.py` (a single 3-D solve is
~130s in TS / a few s on Modal, too slow for the fast unit suite) — mirroring how
fe_slope_3d is validated. Every value below traces to a published source:
- Vesić (1973): N_c, N_q, N_γ = 2(N_q+1)tanφ (the published table).
- Skempton (1951): square/circular footing φ=0 shape factor s_c = 1.2 (N_c·s_c ≈ 6.2).
- Meyerhof (1963) / Vesić (1973): s_q = 1+(B/L)tanφ, s_γ = 1−0.4(B/L).
- Terzaghi (1943): q_ult = c·N_c·s_c + q₀·N_q·s_q + ½γB·N_γ·s_γ.
| Test block (the published value it checks) | Verdict |
| Vesić (1973) bearing-capacity factors (3-D engine) — published table (13 anchors) | Pass |
| Skempton (1951): square/circular footing φ=0 shape factor s_c = 1.2 (N_c·s_c ≈ 6.2) | Pass |
| Meyerhof/Vesić shape factors s_q, s_γ (square, φ=30°) | Pass |
| shape factors interpolate B/L: strip → 1, square = max, rectangle between | Pass |
| 3-D shape effect: a square footing carries more than the strip (the reason for a 3-D solve) | Pass |
fe-slope-3d-web-validation.test.ts
Web-benchmark validation for `fe-slope-3d` — 3-D FE strength-reduction slope stability (20-node hex, viscoplastic Mohr-Coulomb).
Analyses validated: fe-slope-3d · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `fe-slope-3d` — 3-D FE strength-reduction slope stability
(20-node hex, viscoplastic Mohr-Coulomb).
SOURCES:
Griffiths, D.V. & Lane, P.A. (1999) "Slope stability analysis by finite elements",
Géotechnique 49(3) 387-403 — Example 1, the plane-strain benchmark: a 2:1 slope with
c'/γH = 0.05 and φ' = 20° gives F ≈ 1.40. The engine's own header records that its
plane-strain asymptote converges to F = 1.3516 at B/H = 24 and 48 (1.3047 before D613 gave
the 3-D mesh a straight, boundary-conforming slope face in place of the staircase).
Griffiths, D.V. & Marquez, R.M. (2007) "Three-dimensional slope stability analysis by
elasto-plastic finite elements", Géotechnique 57(6) 537-546 — the 3-D effect: a
laterally constrained slope is STRONGER than its plane-strain equivalent, F₃D ≥ F₂D,
and the ratio decreases toward 1 as the width B/H grows.
Cavounidis, S. (1987) — the theoretical statement that F₃D ≥ F₂D always.
Smith, Griffiths & Margetts (2014) "Programming the FE Method" 5e Ch 6, Program 6.12 — the
viscoplastic SRM algorithm this engine implements.
WHY THE ANCHORS ARE BOUNDS AND TRENDS, NOT A SINGLE NUMBER. A published 3-D FoS depends on
the mesh density, the element type and the convergence tolerance, and this engine is capped
at 5 200 dof for interactive use. Pinning a third decimal against a paper solved on a finer
mesh would be a false precision. What CAN be asserted rigorously is the physics: the
Cavounidis inequality, monotone convergence toward the plane-strain limit as width grows,
the direction of every strength/geometry sensitivity, and the engine's honesty about what it
could not resolve. Those are stronger tests than a decimal match, because a wrong solver can
hit one number by luck but cannot satisfy a family of inequalities.
DETERMINISTIC SINCE D426 (1 Nov 2026). The engine used to truncate its strength-reduction search
by wall-clock (`_budgetMs` 11 s / `_refBudgetMs` 8 s) and this file had to raise both to get
converged answers. There is no time budget any more — the search always runs to its stated
precision (`FE_SLOPE_3D_WORK`) — so every case below is solved exactly as production solves it,
and the legacy budget keys are asserted to have no effect.
| Test block (the published value it checks) | Verdict |
| a 2:1 slope solves and reports a physical FoS with its mesh size | Pass |
| the 3-D FoS is at least the plane-strain FoS (Cavounidis 1987) | Pass |
| the 3-D strengthening effect decreases as the slope widens (Griffiths & Marquez 2007) | Pass |
| FoS rises with cohesion and with friction angle | Pass |
| FoS falls with height, with unit weight, and with a steeper slope | Pass |
| the stability number c/(γH) governs — geometrically similar slopes agree | Pass |
| a slope at collapse is reported as unstable rather than left to look converged | Pass |
| a caller-supplied time budget cannot truncate the search: the legacy keys change nothing (D426) | Pass |
| invalid geometry and strength are refused with NaN, not a plausible FoS | Pass |
⚑ footing-3d-web-validation.test.ts
C.FOOT3D — `footing-bearing-3d` web-benchmark (46 cited published values).
Analyses validated: footing-bearing-3d · Recorded run: passed — 9 test block(s), 1 skipped
Sources, tolerances and what is not asserted (the suite’s prologue)
C.FOOT3D — `footing-bearing-3d` web-benchmark (46 cited published values).
WHY THIS FILE EXISTS
--------------------
Until 2026-08-04 this engine had **no validation suite of any kind**, and it is the
single most expensive engine in the product (33.5 s on Modal, 3136 elements). That gap
is the direct explanation of ISSUES-2026-08 **P0-1**: its TypeScript and Python
implementations disagreed by **5.0 %** on `ultimate_bearing_kpa` in production and
nothing noticed, because nothing ever compared them or checked either against a
published example. `modal/validate_fe_footing_3d.py` validates the Python engine
against *itself* (internal consistency, monotonicity), which cannot detect a
disagreement with its twin by construction.
WHAT IS ANCHORED, AND TO WHAT
-----------------------------
The engine's closed-form cross-check is the Vesić (1973) form of the general bearing
capacity equation, whose factors are tabulated to two decimals in the standard texts.
Those tables are the anchor — they are published numbers, not values derived from this
codebase:
q_u = c·N_c·s_c + q₀·N_q·s_q + ½·γ·B·N_γ·s_γ (q₀ = γ·D_f)
N_q = e^{π tanφ} · tan²(45° + φ/2) Reissner (1924)
N_c = (N_q − 1)/tanφ, N_c = 2 + π at φ = 0 Prandtl (1920) → 5.14
N_γ = 2(N_q + 1)·tanφ Vesić (1973)
s_c = 1 + (B/L)(N_q/N_c), s_q = 1 + (B/L)tanφ, s_γ = 1 − 0.4(B/L) Vesić (1973)
Sources for the tabulated values:
- Vesić, A.S. (1973) "Analysis of ultimate loads of shallow foundations", JSMFD 99(SM1).
- Das, B.M. "Principles of Foundation Engineering" — Table 3.3 (N_c, N_q, N_γ vs φ)
and Table 3.4 (Vesić shape factors).
- Bowles, J.E. "Foundation Analysis and Design" 5th ed. — Table 4-4.
- Prandtl (1920) / Reissner (1924) for the N_c, N_q closed forms.
- Skempton (1951) for the φ = 0 square-footing check.
TOLERANCES, AND WHY
-------------------
Factors are checked to **0.5 %**. The published tables carry only two decimals, so at
φ = 5 the table's own quantisation is already ~0.3 % (N_γ 0.45 against an exact 0.4514);
a tighter bound would be testing the rounding of the book, not the engine. The FE solves
here are checked against physical BOUNDS and regression locks, because no textbook
publishes a 3-D FE collapse load for these square configurations — claiming otherwise
would be inventing an anchor. The FE's PUBLISHED anchors are the smooth circular footing
(Potts & Zdravković Vol 2 Tables 6.1-6.2; Houlsby & Martin N_c 5.69), in
fe-footing-3d-benchmarks.test.ts (D509).
| Test block (the published value it checks) | Verdict |
| C.FOOT3D.1: 30 published Vesić bearing-capacity factors within 0.5% | Pass |
| C.FOOT3D.2: N_c = 2+π = 5.14 and N_γ = 0 at φ = 0 (Prandtl 1920) | Pass |
| C.FOOT3D.3: 12 published Vesić shape factors, square footing (B/L = 1) | Pass |
| C.FOOT3D.4: closed-form q_ult matches 4 hand-worked Vesić totals within 0.5% | Pass |
| C.FOOT3D.4b: solveFooting3D reports the SAME closed form it assembles internally | Pass |
| C.FOOT3D.5: φ=0 square footing reproduces the Skempton N_c ≈ 6.2 form | Pass |
| C.FOOT3D.6: φ = 0 clay square — the FE limit load obeys physical bounds and its D509 lock (always run) | Pass |
| C.FOOT3D.6h: c-φ square with γ and D_f — physical bounds and its D509 lock (HEAVY tier) Why: GEOTECH_HEAVY=1 (minutes in TS; the Python twin runs it in validate_fe_footing_3d.py) | Skipped |
| C.FOOT3D.7: monotonic in strength — more c, φ, γ or D_f cannot lower q_ult | Pass |
| C.FOOT3D.8: mesh sizing is pinned (guards the P0-1 rounding tie) | Pass |
⚑ pile-group-3d-web-validation.test.ts
Rigid-cap pile-group load distribution (`pile-group-3d.ts`) checked against PUBLISHED worked examples.
Analyses validated: pile-group-3d · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Rigid-cap pile-group load distribution (`pile-group-3d.ts`) checked against PUBLISHED worked examples.
Every expected number is printed in a source that was opened (text layer of the library copy, 2026-10-06).
SOURCE
Mittal, S. (2025), Pile Foundation Design and Construction Including Well Foundation 3rd ed., CBS Publishers,
Ch.6 "Design Examples": Example 6.4 (single column, 2 × 2 group, S = 1.35 m, pile dia 0.45 m) and
Example 6.5 (lift-well columns, 4 × 5 group, S = 1.35 m). The book works in tonnes and tonne-metres; the
engine is linear, so t and t·m are entered as the load unit directly. It gives pile load as
P/(mn) ± M_y/[mn·(n + 1)/6·S] ± M_x/[mn·(m + 1)/6·S] "valid for extreme piles" (its Table 6.1).
Tomlinson, M.J. & Woodward, J. (2015), Pile Design and Construction Practice 6th ed., CRC Press, Eq 6.54
V = W/n + W·e·x/Σx² — the same rigid-cap statics; it prints the formula but no numeric example, so it
supports the method and contributes no expected number here.
TOLERANCES ARE THE BOOK'S OWN ROUNDING. The book prints each term to 0.1 t and adds the ROUNDED terms (e.g.
50.3 + 1.8 + 2.4 = 54.5, whereas the exact sum is 54.40). So a single term is good to ±0.05 t and a three-term
total to ±0.15 t. Nothing else is allowed for.
SOURCE ERRORS FOUND WHILE READING (not engine faults, recorded so nobody "fixes" the engine toward them):
· Ex 6.5 prints the first term as "845/20" but evaluates it as 44.8 = 895/20 (P = 895 t is stated above it);
the engine is given 895 t.
· Ex 6.4 case (iii) prints "EQ. Shear per pile = 11.4/4 = 2.4 t"; 11.4/4 = 2.85. Not asserted.
· Ex 6.5 case (ii) prints M₂₅ = 100 tm but a 4.0 t moment term; 100/27 = 3.70. The extra may include the
horizontal load's lever arm, which the text does not give, so case (ii)'s total is not asserted.
PUBLISHED-VALUE COUNT: 14 — Ex 6.4: 50.3, 1.8, 2.4, 13.8, 17.4, 54.5, 66.5, 69.5, 3.1; Ex 6.5: 44.8, 2.6, 1.9,
49.3, 0.6. ONE source only (Tomlinson supplies the method, no number), so the two-source bar is not met and the
count is below 20. Vertical, un-battered, equal-pile, rigid-cap statics are what these cover; the battered,
torsion and flexible-cap paths of this engine have NO published numeric check in this suite.
| Test block (the published value it checks) | Verdict |
| [1] Mittal Ex 6.4: vertical term P/n = 201/4 = 50.3 t | Pass |
| [2] Mittal Ex 6.4: moment term for M = 4.8 t·m is 1.8 t | Pass |
| [3] Mittal Ex 6.4: moment term for M = 6.4 t·m (other axis) is 2.4 t | Pass |
| [4] Mittal Ex 6.4: moment term for M = 37.2 t·m (VL + EQ at 45°) is 13.8 t | Pass |
| [5] Mittal Ex 6.4: moment term for M = 46.9 t·m (VL + EQ at 67.5°) is 17.4 t | Pass |
| [6] Mittal Ex 6.4 case (i): P = 201, M₄₅ = 4.8, M₆₇.₅ = 6.4 → maximum pile load 54.5 t | Pass |
| [7] Mittal Ex 6.4 case (ii): P = 201, M₄₅ = 37.2, M₆₇.₅ = 6.4 → maximum pile load 66.5 t | Pass |
| [8] Mittal Ex 6.4 case (iii): P = 201, M₄₅ = 4.8, M₆₇.₅ = 46.9 → maximum pile load 69.5 t | Pass |
| [9] Mittal Ex 6.4 case (ii): earthquake shear 12.4 t over 4 piles is 3.1 t per pile | Pass |
| [10] Mittal Ex 6.5: vertical term 895/20 = 44.8 t | Pass |
| [11] Mittal Ex 6.5: moment term for M₂₅ = 69.6 t·m is 2.6 t | Pass |
| [12] Mittal Ex 6.5: moment term for M₉₀ = 42.9 t·m is 1.9 t | Pass |
| [13] Mittal Ex 6.5 case (i): P = 895, M₂₅ = 69.6, M₉₀ = 42.9 → maximum pile load 49.3 t | Pass |
| [14] Mittal Ex 6.5 case (ii): earthquake shear 12.0 t over 20 piles is 0.6 t per pile | Pass |
slope-3d-dem-web-validation.test.ts
WEB-BENCHMARK validation for the arbitrary-DEM 3-D slope engine (Scoops3D reimplementation).
Analyses validated: slope-3d-dem · Recorded run: passed — 22 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the arbitrary-DEM 3-D slope engine (Scoops3D
reimplementation). Frontier 3-D DEM search has no public digit-for-digit
fixtures for arbitrary terrain, so (per the release rules) we anchor on the exact,
source-independent properties the Scoops3D method MUST satisfy plus cross-
checks against our web-validated 2-D Bishop engine:
• a PLANAR-slope DEM must give F₃D ≥ F₂D (Cavounidis 1987) and a finite
spherical scoop (the sphere is compact → more stable than the wide 2-D
failure, exactly as Scoops3D reports for uniform slopes);
• Ordinary-3D ≤ Bishop-3D (Fellenius is conservative);
• the fall direction is auto-detected down-slope;
• stronger soil / lower water ⇒ higher FoS; multi-material honoured;
• the search returns a real critical sphere + failure volume/area.
Source: Reid, Christian, Brien & Henderson (2015) Scoops3D, USGS TM 14-A1
(Eqs 2.1-2.6, 2.33); Hungr (1987); Bishop (1955); Cavounidis (1987).
| Test block (the published value it checks) | Verdict |
| dem 1: a planar-slope DEM produces a converged critical sphere | Pass |
| dem 2: DEM Bishop-3D MATCHES the validated 2-D engine (F₂D ≤ F₃D ≤ ~1.4·F₂D) | Pass |
| dem 3: Ordinary-3D ≤ Bishop-3D (Fellenius conservative) | Pass |
| dem 4: the failure mass has a real volume, area and column count | Pass |
| dem 5: the auto fall direction points down-slope (−x for a slope rising in +x) | Pass |
| dem 6: more cohesion ⇒ higher FoS | Pass |
| dem 7: higher friction angle ⇒ higher FoS | Pass |
| dem 8: a steeper slope ⇒ lower FoS | Pass |
| dem 9: a taller slope ⇒ lower FoS | Pass |
| dem 10: a high water table ⇒ lower FoS than dry | Pass |
| dem 11: ru pore-pressure ratio lowers FoS | Pass |
| dem 12: a weak lower layer lowers FoS vs uniform strong soil | Pass |
| dem 13: two-material honoured — heavier soil (more driving) ⇒ ≤ FoS of lighter | Pass |
| dem 14: a finer search evaluates more spheres and returns a sensible minimum ≥ F₂D | Pass |
| dem 15: method=ordinary headlines the Ordinary FoS | Pass |
| dem 16: an explicit slip direction is honoured | Pass |
| dem 17: a tiny/invalid DEM errors cleanly (no crash) | Pass |
| dem 18: missing materials errors cleanly | Pass |
| dem 19: a nearly-flat DEM is very stable (high FoS) | Pass |
| dem 20: bilinear DEM interpolation — result is stable to a half-cell origin shift | Pass |
| DEM E-116: an INVERTED material band must be rejected, not read as the deepest one | Pass |
| DEM E-116: non-finite and non-physical material properties must be named, not blamed on the DEM | Pass |
slope-3d-web-validation.test.ts
WEB-BENCHMARK validation for the 3-D slope-stability engine — now the GENUINE Hungr (1987) 3-D simplified-Bishop COLUMN method on an ellipsoidal slip surface (vertical-column grid, true 3-D base normal n_y, per-column moment arm R_z), not…
Analyses validated: slope-stability · Recorded run: passed — 34 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
WEB-BENCHMARK validation for the 3-D slope-stability engine — now the GENUINE
Hungr (1987) 3-D simplified-Bishop COLUMN method on an ellipsoidal slip
surface (vertical-column grid, true 3-D base normal n_y, per-column moment
arm R_z), not a 2-D end-effect heuristic.
Frontier 3-D LEM has sparse public digit-for-digit benchmarks, so (per
the release rules) this pairs the real published values that DO exist with exact
analytical/limiting anchors and cross-checks against our separately
web-validated 2-D Bishop / Spencer engine — never invented numbers.
REAL PUBLISHED VALUES USED (each cited inline):
• Zhang (1988) Soils & Foundations 28(2):63 — classic ellipsoid example,
F₃D = 2.122; reproduced by Zheng (2007) 2.140 and Chen et al. (2001)
2.262 → published simplified-3D-LEM band ≈ 2.12–2.26. Hungr-simplified is
documented to read at the HIGH end of that band "due to the inclusion of
inter-column forces" (Hungr 1987; Hungr, Salgado & Byrne 1989).
• Cavounidis (1987) Géotechnique 37(1):133 — THEOREM: for the same slip
body F₃D ≥ F₂D always (asserted across diverse soils).
• Duncan (1996) JGGE 122(7):577 "State of the art: LEM & 3-D" — rotational
F₃D/F₂D typically ≈ 1.05–1.5 (larger for cohesive/narrow, → 2-D for
frictional/wide).
• Stark & Eid (1998) JGGE 124(11):1049 — cohesive slopes show a LARGER 3-D
effect than frictional ones (trend assert).
• Hungr (1987) Géotechnique 37(1):113 — on the symmetry plane the column
equation reduces EXACTLY to 2-D simplified Bishop (the correctness spine).
• USGS Scoops3D (TM 14-A1) Eq 2.33 — our per-column FoS equation is
ALGEBRAICALLY IDENTICAL to the USGS authoritative Bishop-3D column method:
m_α = cos ε + sin α·tanφ/F with the plan area A_h = A·cos ε, so our n_y
(base-normal vertical cosine) IS cos ε and the resisting term collapses to
Scoops3D's [c·A_h + (W − u·A_h)·tanφ]/m_α. Verified by hand + the 2-D limit.
NOTE ON THE ELLIPSOID LIMIT: a PURE ellipsoid is self-similar under axial
scaling, so F₃D/F₂D does NOT tend to 1 as the slide lengthens — it tends to a
plateau > 1 set by the always-tapered ends. (Ratio → 1 only for a *cylinder+
caps* idealisation, a different slip surface.) The old end-effect engine
asserted ratio→1; that assertion is intentionally REPLACED here to match the
correct ellipsoid physics.
| Test block (the published value it checks) | Verdict |
| slope3d 1: Zhang (1988) ellipsoid F₃D in the published band 2.12–2.26 | Pass |
| slope3d 2: Zhang F₃D/F₂D sits in the rotational band and exceeds 1 (Cavounidis) | Pass |
| slope3d 3: F₃D ≥ F₂D — c–φ soil (Cavounidis 1987 theorem) | Pass |
| slope3d 4: F₃D ≥ F₂D — purely cohesive (φ=0) soil | Pass |
| slope3d 5: F₃D ≥ F₂D — nearly cohesionless (c=5, φ=35) soil | Pass |
| slope3d 6: on the symmetry plane the column method reduces to 2-D Bishop (F₂D exact) | Pass |
| slope3d 6b: ru pore-pressure lowers F₃D (Bishop-3D (W − u·A_h) effective-stress term) | Pass |
| slope3d 7: F₂D cross-checks our rigorous Spencer FoS (independent kernel) | Pass |
| slope3d 8: cohesive (φ=0) shows a LARGER 3-D effect than frictional (Stark & Eid 1998) | Pass |
| slope3d 9: F₃D/F₂D within the Duncan (1996) rotational band 1.03–1.55 (typical geometry) | Pass |
| slope3d 10: narrower slide ⇒ stronger (higher F₃D/F₂D) | Pass |
| slope3d 11: the F₃D/F₂D-vs-aspect curve is monotone decreasing | Pass |
| slope3d 12: PURE-ELLIPSOID limit — very long slide ⇒ ratio plateaus > 1 (NOT → 1) | Pass |
| slope3d 13: φ=0 near-spherical slide (aspect≈1) has a strong 3-D effect (ratio > 1.15) | Pass |
| slope3d 14: more cohesion ⇒ higher F₂D and F₃D | Pass |
| slope3d 15: steeper slope ⇒ lower F₃D | Pass |
| slope3d 16: a high water table ⇒ lower F₃D (effective-stress reduction) | Pass |
| slope3d 17: verdict PASS when F₃D ≥ required, FAIL when below | Pass |
| slope3d 18: verdict headlines both F₂D and F₃D + the % insight | Pass |
| slope3d 19: translational mode flags the model + names Hungr conservative default | Pass |
| slope3d 20: invalid slide length ⇒ errors, no crash | Pass |
| slope3d 21: converged flag set + a real column grid was built | Pass |
| slope3d 22: reports critical-circle radius and z semi-axis (=L/2) | Pass |
| slope3d 23: ru pore-pressure ratio lowers F₃D vs drained | Pass |
| slope3d 24: refining the column grid changes F₃D by < 2 % (numerical convergence) | Pass |
| slope3d 25: the 3-D search finds a critical F₃D ≤ the extruded 2-D-circle F₃D | Pass |
| slope3d 26: the searched critical F₃D still satisfies Cavounidis F₃D ≥ F₂D | Pass |
| slope3d 27: search is on by default and reports how many surfaces it scanned | Pass |
| slope3d 28: search lowers (or holds) the Zhang F₃D toward the published 2.12–2.26 | Pass |
| slope3d 29: reports Ordinary, Bishop, rigorous Spencer AND GLE 3-D side-by-side | Pass |
| slope3d 30: Ordinary ≤ Bishop and rigorous Spencer within 2 % of Bishop (all soils) | Pass |
| slope3d 31: rigorous Spencer-3D agrees with Bishop-3D within ~10 % (Hungr 1987; Lam-Fredlund 1993) | Pass |
| slope3d 32: selecting method=spencer makes the headline F₃D the Spencer value | Pass |
| slope3d 33: each 3-D method reduces to its 2-D counterpart at the prismatic limit | Pass |
tet-mesh-3d-web-validation.test.ts
Validation for the TerraCore 3-D tetrahedral mesher (`tet-mesh-3d.ts`).
Analyses validated: tet-mesh-3d · Recorded run: passed — 18 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the TerraCore 3-D tetrahedral mesher (`tet-mesh-3d.ts`).
the release rules gate — these are EXACT, self-checking mathematical properties, each
traceable to a published source (no invented "expected" numbers):
(1) Σ tet volumes = analytic domain volume — box L·W·H; extruded prism
base_area·depth (measure/additivity of a simplicial subdivision;
Frey & George, "Mesh Generation" §7).
(2) Euler–Poincaré: solid complex χ = V−E+F−C = 1 for a topological ball;
boundary triangulation V−E+F = 2 for a topological sphere
(Frey & George §1; de Berg et al., "Computational Geometry").
(3) every tet has strictly POSITIVE signed volume (correct orientation).
(4) empty-circumsphere DELAUNAY property on a random point set — no other
node strictly inside any tet's circumsphere (Delaunay 1934 "Sur la
sphère vide"; Bowyer 1981; Watson 1981).
(5) structured n×n×n box → exactly 6·n³ tets and (n+1)³ nodes
(Freudenthal–Kuhn subdivision; Kuhn 1960; Bey 1995).
(6) minimum dihedral-angle bound > 0 (a valid, non-degenerate mesh; Shewchuk 2002).
(7) conforming: every interior triangular face shared by EXACTLY 2 tets
(Si, TetGen, ACM TOMS 2015).
| Test block (the published value it checks) | Verdict |
| reference tet volume is 1/6 | Pass |
| circumsphere of the reference tet centres at (½,½,½), R=√3/2 | Pass |
| regular tetrahedron: quality ρ=1 and dihedral 70.5288° | Pass |
| structured 1×1×1 box → 6·n³ = 6 tets, (n+1)³ = 8 nodes | Pass |
| structured 2×2×2 box → 6·n³ = 48 tets, (n+1)³ = 27 nodes | Pass |
| structured 3×3×3 box → 6·n³ = 162 tets, (n+1)³ = 64 nodes | Pass |
| structured 4×4×4 box → 6·n³ = 384 tets, (n+1)³ = 125 nodes | Pass |
| box 3×2×4 m, 3×3×3 cells: volume, Euler, positivity, conformity, quality | Pass |
| extruded rectangle 5×3 through depth 2, 4 layers: Σ vol = 30, conforming, Euler | Pass |
| extruded triangle (legs 4,6) through depth 5: Σ vol = ½·4·6·5 = 60 | Pass |
| extruded L-shape polygon: Σ vol = plan_area·depth, conforming | Pass |
| Delaunay empty-circumsphere property holds (random 3-D set, seed 1) | Pass |
| Delaunay empty-circumsphere property holds (random 3-D set, seed 7) | Pass |
| Delaunay empty-circumsphere property holds (random 3-D set, seed 42) | Pass |
| Delaunay of 8 unit-cube corners tiles volume 1 and is Delaunay after restriction | Pass |
| boundary point-cloud path: convex hull volume, Delaunay, positive, dihedral>0 | Pass |
| radius-ratio quality is invariant under uniform scaling | Pass |
| degenerate box (zero height) returns an error, not NaN | Pass |
Pavements and airfields
Closed-form engine registry — 2 published problems
| Row | Problem | Source | Reference | Ours | Δ | Tolerance (why) | Status |
D1-IRC37-DUAL-WHEEL | IRC:37 Annex I Fig I.3 — εt at the bottom of the bituminous layer, dual-wheel standard axle 3000 / 450 / 75 MPa, ν 0.35, h 140 / 500 mm; 2 × 20 kN at 0.56 MPa, 310 mm c/c; points R = 0 and 155 mm | IRC:37-2018 Guidelines for the Design of Flexible Pavements, Annex I, Fig. I.3 (IITPAVE output) — Fig. I.3, p. 78 (PDF 88) | 128.3 µε εt (IITPAVE) | 128.481 | +0.14 % | ± 2 % 53 D1 exit: strains within 2 % | Pass |
D1-IRC37-DUAL-WHEEL-EV | IRC:37 Annex I Fig I.3 — εv on top of the subgrade, dual-wheel standard axle as εt row | IRC:37-2018 Guidelines for the Design of Flexible Pavements, Annex I, Fig. I.3 (IITPAVE output) — Fig. I.3, p. 78 (PDF 88) | 205.3 µε εv (IITPAVE) | 205.59 | +0.14 % | ± 2 % 53 D1 exit: strains within 2 % | Pass |
Cited validation suites — 62
⚑ aashto-rigid-1993-web-validation.test.ts
AASHTO 1993 RIGID (PCC slab) PAVEMENT — Eq.
Analyses validated: aashto-rigid-1993, pavement-aashto-1993 · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
AASHTO 1993 RIGID (PCC slab) PAVEMENT — Eq. 3.1 slab-thickness solver (`computeAashtoRigid1993`) checked
against PUBLISHED RIGID-PAVEMENT ANSWERS from two independent documents.
WHY THIS FILE EXISTS. The engine's earlier rigid tests (`pavement-aashto-1993-rigid.test.ts`) compare it with
a "published D ≈ 9.8–10.0 in" example that is attributed to a textbook which is not in the reference library
and was not re-opened; and the dedicated web-validation suite of this module anchors the FLEXIBLE solver to
Appendix H. Neither reproduces a printed rigid-pavement answer from an opened source. This file does.
SOURCES — every expected value carries its locator; all were opened and read on 2026-10-06:
AASHTO (1993), Guide for Design of Pavement Structures, Vol. 1 — the Guide itself, read from the scanned
PDF in the reference library (pages rendered at 150 dpi and OCR'd; the digits used were cross-read):
Appendix I "Rigid Pavement Design Example" (pp. I-1 to I-10) with Figure I.1 (cumulative traffic),
Table I.2 (effective k), Table I.3 (performance period with swelling)
Table 4.1 (p. I-62) standard normal deviate Z_R
FHWA-NHI-05-037 (2006), Geotechnical Aspects of Pavements Reference Manual, U.S. Federal Highway
Administration, May 2006 — Chapter 6 §6.2.1 (baseline), §6.3.1 (soft subgrade), §6.5.1 (low-quality
subbase), §6.6.1 (poor drainage), with the complete input list in Table 6-3.
https://www.fhwa.dot.gov/engineering/geotech/pubs/05037/06a.cfm (and 06b.cfm); PDF text cross-read.
WHAT IS CHECKED AGAINST WHAT. Where a source prints the required slab thickness, the engine is solved for D
and compared. Where it prints the traffic a given slab CARRIES (a capacity), Eq. 3.1 is evaluated forward
with the printed inputs and compared. Figure 3.7 is a log-scale nomograph, so AASHTO's own chart readings
carry reading error; FHWA's thicknesses and capacities come from the AASHTO spreadsheet solution and are
printed to 0.1 in / 2–3 significant figures.
TOLERANCES, each from the source's own rounding and not tuned to the engine:
· slab thickness printed to 0.1 in (FHWA) → ±0.05 in; Guide: "9 inches" read off a nomograph → nearest inch
(±0.5 in).
· a capacity printed with p significant figures is accepted when the printed value lies inside the range the
engine spans over the source's own input rounding (slab 10.4 in means 10.35–10.45 in), widened by the
half-unit of the last printed digit. This never loosens the physics: a wrong equation would be out by
far more than the ±3.6 % that 0.05 in of slab moves the capacity (d ln W18 / dD ≈ 0.73 per inch).
· Guide Table I.3 traffic read off Figure 3.7: 2.5 %. The Guide's own two iterations show why: it prints
4.6×10⁶ at ΔPSI_TR 1.75 and 4.5×10⁶ at 1.74, a 2.2 % fall for a 0.01 change that the equation puts at
0.5 %; the chart therefore carries about ±1–2 % reading error.
NOT ASSERTED (recorded so it is not "fixed" later): FHWA Appendix C prints D = 10.55 in for W18 18.9×10⁶,
S0 0.45, J 3.2 and an unstated k. These are not the inputs of FHWA's own Chapter 6 Table 6-3, and the engine
returns 11.6–11.9 in for them at k = 30–72 pci; Chapter 6, where every input is printed, reproduces to 0.05 in
for four different scenarios, so the Appendix C sentence is treated as inconsistent with its own chapter.
| Test block (the published value it checks) | Verdict |
| Appendix I §1.1 — first-year design-lane traffic 357,000 × 0.80 × 0.50 = 142,800 and the per-stage reliabilities | Pass |
| Appendix I §1.2 — slab thickness 9 in for the 25-year traffic (Figure 3.7, no swelling) | Pass |
| Appendix I Table I.3 — a 9 in slab carries 4.6×10⁶ ESALs at ΔPSI_TR 1.75 (iteration 1) and 4.5×10⁶ at 1.74 (iteration 2) | Pass |
| Appendix I Table I.3 — those capacities correspond to 22.9 and 22.8 years on the Figure I.1 traffic curve | Pass |
| Appendix I §1.2 Step 7 — the design "will reach its terminal serviceability in approximately 23 years" | Pass |
| FHWA §6.2.1 baseline rigid design — k_eff 38 pci → D = 10.4 in (10.5 in after rounding) | Pass |
| FHWA §6.3.1 soft subgrade — k_eff 27 pci → D = 10.5 in, and the baseline slab then carries 15.5×10⁶ ESALs | Pass |
| FHWA §6.5.1 low-quality subbase — k_eff 17 pci, Cd 0.85 → D = 11.5 in, baseline slab carries 8.3×10⁶ ESALs | Pass |
| FHWA §6.6.1 poor drainage — k_eff 12 pci, Cd 0.75 → D = 12.3 in, baseline slab carries 5.2×10⁶ ESALs | Pass |
| FHWA §6.2.1 — the 10.4 in baseline slab at k 38 pci carries the 16.4×10⁶ ESALs it was designed for | Pass |
| AASHTO Table 4.1 — Z_R for every tabulated reliability, as reported by the rigid design engine | Pass |
acn-pcn-airfield-published-web-validation.test.ts
PUBLISHED-VALUES: 15 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: about 15 published values, 6 of them from a source the auditor could not reach.
Analyses validated: acn-pcn-airfield · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 15 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: about 15 published values, 6 of them from a source the auditor could not reach. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Published-criterion validation of the ACN-PCN compatibility engine `acn-pcn-airfield`
(ACN and PCN are INPUTS; the engine returns ACN/PCN, the overload %, the 10 % / 5 % occasional-overload
limit and the operating status).
SOURCES (opened and read):
Hayhoe, G.F. (2010), Correspondence Between ICAO ACN Overload Criteria and Cumulative Damage Factor
Calculations, FAA Worldwide Airport Technology Transfer Conference, Atlantic City —
https://www.airporttech.tc.faa.gov/DesktopModules/EasyDNNNews/DocumentDownload.ashx?articleid=1335&documentid=2440&moduleid=4520&portalid=0
(read 2026-10-07). It quotes ICAO Aerodrome Design Manual (Doc 9157) Part 3, Chapter 2: flexible ACN not
exceeding 10 per cent above the reported PCN; rigid 5 per cent; 5 per cent if the structure is unknown;
overload movements ≲ 5 per cent of annual movements. Eq. 5 and the worked numbers 1.049 / 1.0247 /
ΔCDF 0.49 / 0.247 are also used below.
Boeing (2006), 737 Airplane Characteristics for Airport Planning, D6-58325-6 (local file
`_new_2026-07-08_faarfield/aircraft/boeing-737-800-acap.pdf`), §7.10 — the ACN rule ("an aircraft having an
ACN equal to or less than the PCN can operate on the pavement, subject to any limitation on the tire
pressure"), subgrade categories A-D (CBR 15/10/6/3; k 150/80/40/20 MN/m³) and the ACN table for the 737
family at maximum taxi weight (used below as the published ACN INPUTS).
Brill, D.R. (2020), FAARFIELD 2.0 (REDAC presentation, local file `faarfield2-overview.pdf`) — ACR-PCR is the
successor to ACN-PCN with the same operating concept; during the transition both remain available.
WHAT IS PUBLISHED AND WHAT IS DERIVED. Published numbers: the 10 % / 5 % limits, the ACAP ACN table entries,
Hayhoe's √1.1 = 1.049 and √1.05 = 1.0247 thickness ratios and ΔCDF values. The expected STATUS of each ACAP
ACN against a chosen PCN is HAND-DERIVED from the published rule (the ratio is arithmetic) and is labelled so;
no FAA/ICAO document prints an (ACN, PCN) → status worked answer that could be found locally.
| Test block (the published value it checks) | Verdict |
| ICAO Doc 9157 Part 3 Ch.2 (via Hayhoe 2010): 10 % flexible and 5 % rigid occasional-overload limits | Pass |
| Boeing ACAP §7.10 / ICAO: ACN ≤ PCN operates without restriction (ratio ≤ 1) | Pass |
| Hayhoe (2010) Eq. 5: ACN/PCN = (t2/t1)², so √ratio reproduces the printed thickness ratios 1.049 and 1.0247 | Pass |
| Boeing ACAP §7.10 ACN table (737 family at maximum taxi weight) against the published overload rule — expected status HAND-DERIVED | Pass |
| published ACNs sit inside the engine's plausibility window (ACAP 737 table: 13 … 63; warning only above 2000) | Pass |
acn-pcn-airfield-web-validation.test.ts
Formula-fidelity validation against ICAO Annex 14 Vol I §2.6, ICAO Doc 9157 Part 3, and FAA AC 150/5335-5 — the ACN/PCN aircraft-pavement strength compatibility check and its published occasional-overload limits (10% for flexible pavements…
Analyses validated: acn-pcn-airfield · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against ICAO Annex 14 Vol I §2.6, ICAO Doc 9157
Part 3, and FAA AC 150/5335-5 — the ACN/PCN aircraft-pavement strength
compatibility check and its published occasional-overload limits (10% for
flexible pavements, 5% for rigid). The math (a ratio and a percentage) is
elementary and exact to full precision; the citable content being verified
is the OVERLOAD LIMIT VALUES themselves (10%/5%) and the ICAO decision
bands, which are published, fixed numbers, not derived from a formula that
could drift.
| Test block (the published value it checks) | Verdict |
| [1-3] ACN 45 / PCN 50 (ratio 0.90, flexible): unrestricted, overload=0%, limit=10% | Pass |
| [4-6] ACN 55 / PCN 50 (ratio 1.10, flexible): exactly at the 10% occasional limit -> permitted | Pass |
| [7-9] ACN 55 / PCN 50 (ratio 1.10, RIGID): exceeds the 5% rigid limit -> not permitted | Pass |
| [10-11] ACN 60 / PCN 50 (ratio 1.20, flexible): 20% overload exceeds the 10% limit | Pass |
| [12] rigid vs flexible use different overload limits at otherwise identical inputs | Pass |
| [13] ACN=PCN exactly (ratio=1.0) is unrestricted with zero overload | Pass |
| [14] default pavement type (unspecified) is treated as flexible (10% limit) | Pass |
| [15] ACN or PCN <= 0 is refused, not silently floored to a denominator of 1e-6 | Pass |
| [16] the ratio is scale-invariant (ACN/PCN unaffected by proportional scaling), but implausible raw magnitudes still warn | Pass |
aircraft-gear-response-web-validation.test.ts
Published-value validation of the multi-wheel landing-gear response engine `aircraft-gear-response` (Burmister layered-elastic superposition over the wheels of a gear, maximum vertical strain at the top of the subgrade), against the FAARFI…
Analyses validated: aircraft-gear-response, layered-elastic-pavement · Recorded run: passed — 2 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation of the multi-wheel landing-gear response engine `aircraft-gear-response`
(Burmister layered-elastic superposition over the wheels of a gear, maximum vertical strain at the top of the
subgrade), against the FAARFIELD/LEAF strains printed by the FAA.
SOURCES (opened and read from the local reference library, `_new_2026-07-08_faarfield/`):
Kawa, I. (2017), Development of New Subgrade Failure Model for Flexible Pavements in FAARFIELD,
DOT/FAA/TC-17/28 — Appendix B Tables B-1..B-8 ("Subgrade Strain" column: maximum vertical strain at the
top of the subgrade computed by FAARFIELD/LEAF for the 4-wheel 2D and 6-wheel 3D NAPTF gears) and
Appendix A (gear definitions: 207.547 psi, 54-in dual spacing, 57-in tandem spacing, contact area 265 in²).
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — Table 3-2 (Poisson's ratio 0.35 for every
layer, P-401 200,000 psi) and Appendix H (subgrade E = 1500 × CBR: CBR 5 ↔ 7,500 psi); these fix the INPUTS
of the published stacks, they are not answers.
HOW THE ENGINE IS EXERCISED. `computeAircraftGearResponse` is a 3-layer wrapper; every published stack has a
P-209 / P-154 granular profile that FAARFIELD subdivides into sublayers, so the published cases are run through
`computeGearMaxSubgradeStrain` — the exact multi-wheel kernel the wrapper calls — on the n-layer stack built from
the TC-17/28 sublayer rules. The wrapper's own outputs (contact radius, single-wheel identity) are checked
against Appendix A. STRAIN_TOL = 2 % is set before comparing (two independent Burmister implementations, 4-s.f.
printed values); observed maximum 0.9 %.
| Test block (the published value it checks) | Verdict |
| maximum subgrade strain of the 2D (4-wheel) and 6-wheel 3D gears reproduces TC-17/28 Appendix B (µε) | Pass |
| wrapper outputs: contact radius from the Appendix A wheel load / tyre pressure, and the single-wheel identity | Pass |
aircraft-library-web-validation.test.ts
Web-benchmark validation for the airfield aircraft library — pins every gear-geometry value to the FAARFIELD standard-library / ACAP baselines that a PE (or FAARFIELD itself) would use, so our airfield engines run on the SAME aircraft inpu…
Analyses validated: faarfield-mix-cdf · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the airfield aircraft library — pins every
gear-geometry value to the FAARFIELD standard-library / ACAP baselines that a
PE (or FAARFIELD itself) would use, so our airfield engines run on the SAME
aircraft inputs as the reference software.
Sources (on disk):
Geo Technical engineering books/_new_2026-07-08_faarfield/aircraft/*.pdf
— Boeing 747-8, 737-800; Airbus A320, A330 ACAPs (Section 7.0 Pavement Data)
FAA AC 150/5320-6G (Appendix H worked examples), FAARFIELD 2.0 overview
Baseline gear values confirmed by the FAARFIELD standard aircraft library.
Each case cites its source + expected value; the assertion tolerances are the
rounding of the unit conversion (in→mm, psi→MPa), not slop.
| Test block (the published value it checks) | Verdict |
| B747-8 gear geometry matches the FAARFIELD/ACAP baseline | Pass |
| A320-200 gear geometry matches the FAARFIELD/ACAP baseline | Pass |
| A330-300 gear geometry matches the FAARFIELD/ACAP baseline | Pass |
| B737-800 is a dual-gear narrowbody (FAARFIELD standard library) | Pass |
| wheel load = gross · %-on-leg / wheels-per-leg (at max taxi weight) | Pass |
| a heavy widebody mix produces a higher subgrade CDF than a narrowbody mix | Pass |
| picking a1_aircraft/a2_aircraft reproduces the manual-geometry result exactly | Pass |
| picking overrides deliberately-wrong manual fields (geometry comes from the library) | Pass |
| the library covers the 4 Appendix-H benchmark aircraft with valid specs | Pass |
asphalt-institute-design-published-web-validation.test.ts
ASPHALT INSTITUTE FATIGUE / SUBGRADE-RUTTING CRITERIA — `asphaltInstituteFatigueLife` and `asphaltInstituteRuttingLife` (the two functions `computeAsphaltInstituteDesign` applies to the layered-elastic strains) checked against PUBLISHED ST…
Analyses validated: asphalt-institute-design · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
ASPHALT INSTITUTE FATIGUE / SUBGRADE-RUTTING CRITERIA — `asphaltInstituteFatigueLife` and
`asphaltInstituteRuttingLife` (the two functions `computeAsphaltInstituteDesign` applies to the layered-elastic
strains) checked against PUBLISHED STRAIN → ALLOWABLE-REPETITION PAIRS printed by two independent sources.
WHY THIS FILE EXISTS. The earlier suite (`asphalt-institute-design-web-validation.test.ts`) is self-described
as a re-derivation of Nf and Nr "from the engine's own reported strains" and carries a reference case taken
from the engine's own defect-fix comment: both are the equation checked against itself. Here the strain is
someone else's and so is the answer. (The transfer functions were extracted from the engine body into two
exported functions, verbatim, so that a published strain can be fed to the exact arithmetic the engine applies
— before, the only way in was through the layered solver, which cannot be told a strain.)
SOURCES — opened and read 2026-10-06:
Maher (2022), "Lecture 6 — KENPAVE Example 2", Highway and Transportation Engineering Department,
University of Al-Mustansiriyah, lecture notes reproducing a KENLAYER run (the Asphalt Institute damage
analysis of Huang's two-layer example). The printed program output gives, for E₁ = 5.000E+05 psi, the
coefficients "0.0796 3.291 0.854" and "1.365E-09 4.477" and, for each strain, "ALLOWABLE LOAD
REPETITIONS = …", "DAMAGE RATIO = …", plus the summary "SUM OF DAMAGE RATIO" and "DESIGN LIFE IN YEARS".
https://uomustansiriyah.edu.iq/media/lectures/5/5_2022_11_13!01_04_20_PM.pdf
Rahmawati & Adiyasa (2021), "Analysis of Remaining Service Life for Flexible Pavement Using
Mechanistic-Empirical Methods", Int. J. of GEOMATE (received 14 May 2021) — Table 2 (asphalt modulus
1 200 000 kPa), Table 3 and Table 5 (Nf, Nd for KENPAVE strains).
https://geomatejournal.com/geomate/article/download/79/1598
WHAT IS AND IS NOT CLAIMED. These are published evaluations of the Asphalt Institute equations at published
strains, so they prove the engine's constants, exponents, unit handling (µε → in/in, MPa → psi) and the
matching of each criterion to each strain. They do NOT validate the criteria as a description of pavements
(that is the Asphalt Institute's / AASHO Road Test's claim), and they do not test the layered solver, which is
checked against IITPAVE output in `layered-elastic-pavement-published-web-validation.test.ts`. The Miner's-rule
summation in the last test is KENLAYER's own procedure carried out in the test; only the allowable repetitions
come from the engine.
TOLERANCES, from the sources' own rounding:
· Maher: strains print to 4 significant figures and N to 4. A strain rounded by half a unit of its last
digit moves N by 3.291 × 0.5/1626 = 0.10 % (fatigue, worst strain) or 4.477 × 0.5/2632 = 0.09 % (rutting,
worst strain), plus 0.02 % for N itself → fatigue ±0.15 %, rutting ±0.15 %.
· Rahmawati & Adiyasa: N is printed to 0.01 of 10⁶–10⁷, i.e. ≤ 5×10⁻⁹ relative, on strains printed exactly as
used → 10⁻⁷ for Nd. Their Nf uses E converted from kPa to psi with a factor rounded to 5 significant
figures (0.14503 vs 0.145038 → 5.5×10⁻⁵ in E → 4.7×10⁻⁵ in N; observed 3.0×10⁻⁵) → 10⁻⁴.
| Test block (the published value it checks) | Verdict |
| Maher (2022) KENLAYER — fatigue: five printed tensile strains → allowable repetitions (E₁ = 500 000 psi) | Pass |
| Maher (2022) KENLAYER — subgrade rutting: five printed compressive strains → allowable repetitions | Pass |
| Maher (2022) — the hand calculation in the notes: εt 1.423E-04 → 4,940,000 and the differential 6.63E-05 → 60,890,000 | Pass |
| Maher (2022) — Miner summation of the printed strains reproduces the summary: ΣD 3.946E-02 (fatigue), 5.174E-02 (rutting), 19.33 years | Pass |
| Rahmawati & Adiyasa (2021) Table 3 — εt 2.998E-04 with E = 1 200 000 kPa gives Nf = 1,047,484.63; εc 4.022E-04 gives Nd = 2,172,928.92 | Pass |
| Rahmawati & Adiyasa (2021) Table 5 — two alternative designs: Nd at εc 1.979E-04 and 1.912E-04, and the Nf ratio of εt 9.501E-05 to 9.331E-05 | Pass |
asphalt-institute-design-web-validation.test.ts
Formula-fidelity validation against Asphalt Institute MS-1 "Thickness Design" (1981/1999) and Huang, "Pavement Analysis and Design" 2nd ed.
Analyses validated: asphalt-institute-design · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against Asphalt Institute MS-1 "Thickness
Design" (1981/1999) and Huang, "Pavement Analysis and Design" 2nd ed. §11
(source of the exact calibration constants 0.0796/-3.291/-0.854 for
fatigue, 1.365e-9/-4.477 for subgrade rutting, cross-checked against the
text and formula in this engine's own header). The Burmister strain
computation itself is validated separately (layered-elastic-pavement-
web-validation.test.ts, against the exact Boussinesq closed-form limit) --
this suite validates the TRANSFER FUNCTIONS (Nf, Nr, CDF) applied to
whatever strain the (already-validated) solver reports, by taking the
engine's own reported strain and independently re-deriving Nf/Nr/CDF from
it via the cited published equations (verified in Python).
| Test block (the published value it checks) | Verdict |
| [1-6] base case: Nf and Nr independently re-derived from the engine's own reported strains match its output exactly (formula fidelity of the AI transfer functions) | Pass |
| [7] the specific reference case cited in the engine's own defect-fix comment reproduces exactly: Nf ~= 1.987e6, governing = subgrade rutting, CDF ~= 1.35 | Pass |
| [8] doubling the AC modulus reduces the fatigue allowable Nf by exactly 2^0.854 per the published -0.854 exponent, at fixed strain | Pass |
| [9] design_esals=0 gives exactly zero damage ratios, labelled as definitional | Pass |
| [10] a thicker/stiffer section reduces both strains and both damage ratios (basic M-E design trend) | Pass |
| [11] the classification bands match the CDF thresholds (<=0.5 ample, <=1.0 within limit, >1.0 inadequate) | Pass |
| [12] every load-bearing input is refused at 0 or below, never silently floored to an unbounded allowable | Pass |
axle-load-spectra-published-web-validation.test.ts
Published-value checks for the axle-load spectrum → equivalent-axle engine `axle-load-spectra` (fourth-power load-equivalency law per axle group, truck factor, wander factor).
Analyses validated: axle-load-spectra · Recorded run: passed — 3 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value checks for the axle-load spectrum → equivalent-axle engine `axle-load-spectra`
(fourth-power load-equivalency law per axle group, truck factor, wander factor).
SOURCE (opened and read, local reference library):
IRC:37-2018 (Fourth Revision), Guidelines for the Design of Flexible Pavements, Indian Roads Congress —
Clause 4.4.3 Eqs. 4.1-4.4 (equivalence of a single axle with dual wheels to the 80 kN standard axle is
(load/80)^4; tandem (load/148)^4; tridem (load/224)^4), and Annex II.2 worked example: "the VDF of a
dumper = 2×(120/80)^4 + (80/65)^4 = 12.41 ... 200 × 12.41 = 2483 standard axles".
AASHTO (1993), Guide for Design of Pavement Structures, Appendix D — cited by the engine; the local copy is a
624-page scan with no text layer and its LEF tables were NOT read for this suite.
EVIDENCE CLASS: formula-fidelity for the fourth-power law (the published equations are reproduced; the only
printed numeric answer that can be routed through the engine is the IRC:37 Annex II.2 dumper example, partly:
the engine has no single-WHEEL axle variant, so the (80/65)^4 front-axle term of Eq. 4.1 is added by hand).
OPEN DEFECT RECORDED, NOT FIXED. The engine normalises each group to its OWN standard load — tandem 140 kN,
tridem 210 kN — and documents them "per AASHTO". IRC:37-2018 Eqs. 4.3-4.4 print 148 kN and 224 kN, and the
AASHTO/Asphalt Institute equivalency factors reference every group to the 80-kN SINGLE axle. The 140/210 kN
constants were not found in any readable source; a user feeding IRC tandem loads gets LEF 1.249 at 148 kN
where IRC:37 Eq. 4.3 gives 1.000. This suite therefore validates the single-axle (80 kN, dual-wheel) group
only; the tandem and tridem constants are UNVERIFIED.
| Test block (the published value it checks) | Verdict |
| IRC:37-2018 Eq. 4.2: a single axle with dual wheels is equivalent to (load / 80)^4 standard axles | Pass |
| IRC:37-2018 Annex II.2 dumper: 2×(120/80)^4 + (80/65)^4 = 12.41, × 200 repetitions = 2483 standard axles | Pass |
| IRC:37-2018 Eq. 4.2 fixes the 80 kN standard the engine uses for the single-axle group | Pass |
axle-load-spectra-web-validation.test.ts
Formula-fidelity validation against AASHTO Guide for Design of Pavement Structures (1993) App.
Analyses validated: axle-load-spectra · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO Guide for Design of Pavement
Structures (1993) App. D — the fourth-power damage law / load equivalency
factor (LEF) and its use to convert a normalised axle-load spectrum (NALS,
AASHTO MEPDG Manual of Practice §3) into equivalent 80 kN single-axle loads.
This is a fully closed-form calculation (no layered-elastic dependency), so
every expected value below is hand-computed exactly from the cited formula
(verified independently in Python) and checked to full published precision.
LEF_i = (P_i / P_std)^n, ESALs = N . sum(frac_i . LEF_i)
wander factor = 2.Phi(tireWidth / (2.sigma)) - 1 (sigma = 0 => 1, channelised)
| Test block (the published value it checks) | Verdict |
| [1-6] single-axle group, fourth-power law: truck factor=1.8488, ESALs=1848828.1, mean=82.0kN, %above-std=35.0% | Pass |
| [7-12] per-bin LEF values match (P/Pstd)^4 exactly for each of the six bins | Pass |
| [13] tandem group uses the 140 kN standard load, not 80 kN | Pass |
| [14] tridem group uses the 210 kN standard load | Pass |
| [15] a custom power exponent (n=3.9) changes every LEF and the resulting ESALs, per the fourth-power law generalisation | Pass |
| [16-18] traffic wander factor: MEPDG default (tire=300mm, sigma=254mm) = 0.445179; channelised (sigma=0) = 1; narrow wander (sigma=50mm) = 0.997300 | Pass |
| [19] design ESALs at the critical point equals raw ESALs times the wander factor (within the engine's own rounding of each intermediate to a fixed number of decimals) | Pass |
| [20] total_axles=0 gives exactly zero ESALs, labelled as definitional rather than a low-damage spectrum | Pass |
| [21] spectrum percentages that do not sum to 100 are normalised internally and warned about | Pass |
| [22] empty spectrum or negative total axles are refused | Pass |
⚑ benkelman-overlay-published-web-validation.test.ts
BENKELMAN-BEAM OVERLAY DESIGN — `computeBenkelmanOverlay` (IRC:81-1997 characteristic deflection, with the §4.4.3 temperature and §4.5.4 seasonal corrections) checked against PUBLISHED WORKED EXAMPLES.
Analyses validated: benkelman-overlay · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
BENKELMAN-BEAM OVERLAY DESIGN — `computeBenkelmanOverlay` (IRC:81-1997 characteristic deflection, with the
§4.4.3 temperature and §4.5.4 seasonal corrections) checked against PUBLISHED WORKED EXAMPLES.
WHY THIS FILE EXISTS. The earlier suite (`benkelman-overlay-web-validation.test.ts`) is self-described
"formula-fidelity": its expected values were computed from Eq. (4) and (5) with a multiplicative temperature
factor that IRC:81-1997 does not contain. Reading the code showed why that was a problem. §4.4.3 defines the
temperature correction as ADDITIVE, 0.01 mm per °C from the 35 °C standard ("if the deflection is measured at a
pavement temperature of 37°C, the correction factor will be 0.02 mm ... which should be subtracted"), while the
engine offered only a multiplier labelled "IRC 81 Cl 5.4" (the clause is 4.4) — so a user following the code
could not reproduce the code's own example. The engine now takes `pavement_temperature_c` and applies §4.4.3
per reading; the multiplier is retained for callers that already hold one. This suite exercises the corrected
path against printed examples.
SOURCES — all opened and read 2026-10-06:
IRC:81-1997 (Indian Roads Congress, "Guidelines for Strengthening of Flexible Road Pavements Using Benkelman
Beam Deflection Technique", first revision; local reference-library PDF): Eq. (2)–(5) (page image checked:
σ = √[Σ(x − x̄)² / (n − 1)], Dc = x̄ + 2σ for NH/SH, x̄ + σ otherwise) and §4.4.3 (0.01 mm/°C, the 37 °C
example).
Unattributed (2020), "IRC Overlay Design", lecture slides dated 21 March 2020 (author not given),
https://pdfcoffee.com/irc-overlay-design-21-march-2020-pdf-free.html — a worked IRC:81 example with eleven
readings and the temperature example "deflection at 38 °C = 0.8 mm → 0.8 − 3 × 0.01 = 0.77 mm".
CSIR-CRRI "Structural evaluation of Flexible Pavements using Benkelman Beam Deflection (BBD) Technique
(IRC:81-1997)" (slides, Pavement Evaluation Division, Central Road Research Institute, undated), hosted at
https://www.scribd.com/document/1040748629/Dr-Sachin-BBD-Latest — "deflection at 37 °C = 0.80 mm →
(0.80 − 2 × 0.01) = 0.78 mm; at 32 °C → (0.80 + 3 × 0.01) = 0.83 mm".
An undated "Pavement Overlay Design Techniques" slide deck ("4-BBD", unattributed, Scribd document
467635928) that carries a complete IRC:81 numerical example with fifteen readings.
PROVENANCE, stated plainly: apart from IRC:81-1997 itself these are teaching slides, two of them with no author
or date. They are useful because they print inputs AND answers, but they are secondary sources and the
evidence they give is weaker than a code's own worked example — IRC:81-1997 prints none with data.
SHORTFALL AGAINST THE RELEASE BAR, stated so the assertion count cannot be mistaken for it: this file holds 11
published-answer checks (1 from IRC:81-1997, 3 temperature examples, 1 mean, 5 from the 15-reading example,
1 convention check) where the bar asks for 20 from two sources. The gap is real: IRC:81-1997 prints no worked
example with data, and every other example found is a teaching slide. Benkelman-beam overlay design should be
treated as regression-protected until a code-grade worked example (e.g. the Asphalt Institute MS-17 overlay
manual, not in the library) is obtained.
TOLERANCES, from the printed precision: readings and means to 2–3 decimals (±0.005 / ±0.0005), temperature
corrections exact (two decimals from a 0.01 mm/°C rule), and the final figure of the 15-reading example to
±0.0007 because its 1.714 is multiplied by 1.4 after being rounded to three decimals (±0.0005 × 1.4).
UNRESOLVED, deliberately NOT asserted: the 11-reading example in the 2020 slides prints σ = 0.056, Dc = 1.06
and a seasonally corrected 1.0918 mm (= 1.06 × 1.03). From its own eleven readings — 1.00, 0.94, 0.96, 0.96,
0.98, 0.94, 0.94, 0.88, 0.84, 1.06, 0.96, the D column of its table — the IRC:81 sample standard deviation is
0.0575 (population: 0.0548; neither is 0.056), so Dc = 1.0660 and 1.0979 after the 1.03 factor: 0.6 % and 0.56 %
above the slide. The mean, 0.95, is reproduced. The engine follows Eq. (3) exactly; the slide's σ does not
follow from its own data. No fix to the engine is indicated.
NOT TESTABLE with this engine: the overlay THICKNESS is read from IRC:81 Fig. 9 (a chart) and the engine takes
the allowable deflection as an input; the dial-reading conversion of Annexure I (Xt = Xa + 2.91 Y) is not
implemented; the moisture factors of Figs. 2–7 are inputs.
| Test block (the published value it checks) | Verdict |
| IRC:81-1997 §4.4.3 — at 37 °C the correction is 0.02 mm and is subtracted | Pass |
| CSIR-CRRI slides — 0.80 mm measured at 37 °C → 0.78 mm, and at 32 °C → 0.83 mm at the 35 °C standard | Pass |
| Unattributed (2020) IRC overlay-design slides — 0.8 mm at 38 °C → 0.8 − 3 × 0.01 = 0.77 mm | Pass |
| Unattributed (2020) IRC overlay-design slides — eleven readings have mean deflection 0.95 mm | Pass |
| 4-BBD slides — uncorrected statistics: mean 1.45 mm, standard deviation 0.107 mm, Dc = 1.45 + 2(0.107) = 1.664 mm | Pass |
| 4-BBD slides — temperature correction 0.01 × (35 − 30) = +0.05 mm gives Dc = 1.714 mm | Pass |
| 4-BBD slides — seasonal factor 1.4 gives the corrected characteristic deflection 2.3996 mm | Pass |
⚑ benkelman-overlay-web-validation.test.ts
Formula-fidelity validation against IRC 81:1997 Cl 6 (characteristic deflection Dc = mean + k.sigma, k=2 major roads Eq.4 / k=1 minor roads Eq.5) and Cl 5.4/5.5 (temperature/seasonal correction factors).
Analyses validated: benkelman-overlay · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against IRC 81:1997 Cl 6 (characteristic
deflection Dc = mean + k.sigma, k=2 major roads Eq.4 / k=1 minor roads
Eq.5) and Cl 5.4/5.5 (temperature/seasonal correction factors). This is
elementary descriptive statistics (mean, sample standard deviation) plus a
fixed multiplier from the cited clause -- exact to full precision, hand-
computed and cross-checked independently in Python.
| Test block (the published value it checks) | Verdict |
| [1-5] major road (k=2, Eq.4), corrected by CT=1.05, CS=1.02: mean=1.371951mm, sd=0.117154mm, Dc=1.606258mm, overlay required, reduction=0.106258mm | Pass |
| [6-7] minor road (k=1, Eq.5), same data and allowable: Dc=1.489105mm, no overlay required | Pass |
| [8] no allowable supplied -> overlay_required is null (NOT ASSESSED), never false | Pass |
| [9] a generous allowable above Dc gives overlay_required=false with zero reduction | Pass |
| [10] a non-positive allowable is refused outright, not silently treated as "no overlay needed" | Pass |
| [11] correction factors default to 1.0 when not supplied, so mean/Dc equal the uncorrected statistics | Pass |
| [12] fewer than 10 readings warns about IRC 81-1997 Cl 4.3.1's minimum sample size | Pass |
| [13] no readings, or a negative reading, is refused | Pass |
climate-zone-eicm-web-validation.test.ts
PUBLISHED-VALUES: 8 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: eight Koppen-Geiger / Peel threshold values and no published numeric answer for the engine.
Analyses validated: climate-zone-eicm · Recorded run: passed — 33 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 8 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: eight Koppen-Geiger / Peel threshold values and no published numeric answer for the engine. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Published-criteria validation of the climate-zone EICM inputs (C.PV.4).
WHAT THE ENGINE CLAIMS, AND WHAT THIS SUITE CHECKS. `computeClimateZoneEicm` returns, for six named
zones, a mean annual temperature, a seasonal amplitude, 12 monthly mean air temperatures and an annual
precipitation, and labels each zone with a Köppen class (tropical = Af/Am, arid_hot = BWh,
temperate = Cfa/Cfb, continental_cold = Dfa/Dfb, subarctic = Dfc, mediterranean = Csa). The claim that a
zone "is" a Köppen class is a claim about PUBLISHED, NUMERICAL CLASS DEFINITIONS, so it can be tested
against those definitions without any number of ours: the definitions below are printed in two
independent papers, and each assertion applies one printed threshold to the engine's own output.
PUBLISHED SOURCES (both opened and read for this suite, 2026-10-06; PDFs fetched from the publishers):
Peel, M.C. & Finlayson, B.L. & McMahon, T.A. (2007), "Updated world map of the Köppen-Geiger climate
classification", Hydrology and Earth System Sciences 11, 1633-1644, Table 1 (p. 1636):
A: Tcold >= 18; B: MAP < 10 Pthreshold, BW: MAP < 5 Pthreshold, h: MAT >= 18;
C: Thot > 10 & 0 < Tcold < 18, a: Thot >= 22, b: not a & Tmon10 >= 4; D: Thot > 10 & Tcold <= 0,
c: not (a, b or d), d: Tcold < -38; Pthreshold = 2 MAT (70 % of MAP in winter), 2 MAT + 28 (70 % in
summer), otherwise 2 MAT + 14. URL https://hess.copernicus.org/articles/11/1633/2007/
Kottek, M. & Grieser, J. & Beck, C. & Rudolf, B. & Rubel, F. (2006), "World Map of the Köppen-Geiger
climate classification updated", Meteorologische Zeitschrift 15(3), 259-263, Table 1 (p. 260):
A: Tmin >= +18; Af: Pmin >= 60 mm; B: Pann < 10 Pth, BW: Pann <= 5 Pth; C: -3 < Tmin < +18;
D: Tmin <= -3; E: Tmax < +10; (second letter "a": Tmax >= +22; "b": at least 4 Tmon >= +10).
URL http://koeppen-geiger.vu-wien.ac.at/pdf/Paper_2006.pdf
NOTE THE DIFFERENCE BETWEEN THE TWO PAPERS and how it is honoured: Peel et al. place the C/D boundary at
0 degC; Kottek et al. keep Koppen's original -3 degC. A zone whose coldest month lies in (-3, 0] would
classify differently under the two, so the D zones below are asserted against BOTH boundaries.
WHAT THIS SUITE CANNOT CHECK (said plainly, not papered over):
- The dry-season letters (s, w, f, m) need MONTHLY precipitation; the engine returns only an annual
total. Only the annual-total criteria (B-tests, and the Af necessary condition MAP >= 12 x 60 mm)
are testable.
- The freezing index, the JPCP curling gradient and the precipitation values are "representative"
generalisations (the engine says so) and no published source assigns them to a Koppen class.
- This checks class MEMBERSHIP, not station climate normals. The engine states it is not a station
database; this suite does not pretend otherwise.
| Test block (the published value it checks) | Verdict |
| every zone the engine offers is one of the six Koppen-labelled zones and returns 12 monthly temperatures | Pass |
| tropical: Peel 2007 Table 1 "A": Tcold >= 18 degC (coldest monthly mean) | Pass |
| tropical: Kottek 2006 Table 1 "A": Tmin >= +18 degC | Pass |
| tropical: Af rainforest needs Pmin >= 60 mm in EVERY month (Peel/Kottek) => MAP >= 12 x 60 = 720 mm; engine 2000 mm | Pass |
| tropical: not arid - Peel "B": MAP < 10 Pthreshold must FAIL; the largest Pthreshold (summer-dominant rain) is 2 MAT + 28 | Pass |
| tropical: a frost-free climate has no sub-zero month, so its freezing index must be 0 (consequence of Tcold >= 18) | Pass |
| arid_hot: Peel "BW": MAP < 5 Pthreshold holds under the SMALLEST Pthreshold (winter-dominant rain, 2 MAT) | Pass |
| arid_hot: Kottek "BW": Pann <= 5 Pth under the same smallest Pth | Pass |
| arid_hot: Peel "h" (hot): MAT >= 18 degC | Pass |
| arid_hot: the mean of the 12 monthly temperatures reproduces the stated MAT (the Koppen MAT the "h" test is applied to) | Pass |
| arid_hot: not polar - Peel/Kottek "E" needs Thot < 10; the hottest month is well above it | Pass |
| arid_hot: a frost-free desert (coldest month >= 18) has freezing index 0 | Pass |
| temperate: Peel "C": Thot > 10 and 0 < Tcold < 18 | Pass |
| temperate: Kottek "C": -3 < Tmin < +18 degC | Pass |
| temperate: not arid - Peel "B" fails: MAP >= 10 x the LARGEST Pthreshold (2 MAT + 28) | Pass |
| temperate: Peel "a" (hot summer) Thot >= 22, so Cfa is the right third letter; Kottek "a" Tmax >= +22 agrees | Pass |
| temperate: a zone whose coldest month is above 0 degC can still carry a small frost index (daily extremes), but never a negative one | Pass |
| continental_cold: Peel "D": Thot > 10 and Tcold <= 0 | Pass |
| continental_cold: Kottek "D": Tmin <= -3 degC (the stricter Koppen boundary) | Pass |
| continental_cold: Peel "b" (warm summer): NOT "a" (Thot < 22) and Tmon10 >= 4; Kottek "b": at least 4 months >= +10 | Pass |
| continental_cold: not arid - MAP >= 10 x the largest Pthreshold (2 MAT + 28) | Pass |
| continental_cold: a climate with Tcold <= -3 must have freezing weather, so FI > 0 | Pass |
| subarctic: Peel "D": Thot > 10 and Tcold <= 0 | Pass |
| subarctic: Kottek "D": Tmin <= -3 degC | Pass |
| subarctic: Peel "c" (cold summer): NOT a, b or d. Not "a" (Thot < 22) and not "b" (Tmon10 < 4) - i.e. 1 <= Tmon10 < 4 | Pass |
| subarctic: not "d" (very cold winter): Peel needs Tcold < -38; Kottek "d" Tmin <= -38. The engine is far warmer | Pass |
| subarctic: not arid - MAP >= 10 x the largest Pthreshold (2 MAT + 28, with MAT = -2) | Pass |
| subarctic: Tcold <= -3 again implies freezing weather, so FI > 0 | Pass |
| mediterranean: Peel "C": Thot > 10 and 0 < Tcold < 18 | Pass |
| mediterranean: Kottek "C": -3 < Tmin < +18 degC | Pass |
| mediterranean: Peel "a" (hot summer, the "a" of Csa): Thot >= 22; Kottek "a" Tmax >= +22 | Pass |
| mediterranean: not arid - a dry-summer climate has winter-dominant rain, so Pthreshold is 2 MAT or 2 MAT + 14; MAP >= 10 x the larger | Pass |
| southern hemisphere: Tcold, Thot and Tmon10 are unchanged by the phase flip, so every class test above still holds | Pass |
crcp-punchout-published-web-validation.test.ts
CRCP punchout (MEPDG 2nd ed.
Analyses validated: crcp-punchout · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
CRCP punchout (MEPDG 2nd ed. Eq. 5-26) - checks against PUBLISHED values only.
STATUS: PARTIAL. 8 assertions against published values; the release bar is 20. The shortfall (12) is
real and is NOT padded. No source I could open prints a (fatigue damage -> punchouts/mile) worked
answer for the 2nd-edition constants (APO 216.8421, alpha 33.15789, beta -0.58947): the manual gives
the equation and constants and scatter plots (Figure 5-14), and the recalibration literature
(Illinois 2024, Texas 0-5832) uses different constants or a different model. The sibling suite
crcp-punchout-web-validation.test.ts is formula-fidelity evidence (hand-evaluated Eq. 5-26). This
header says so deliberately: it keeps the generated validation manifest from promoting the engine to
"reference-backed" on the strength of 8 published checks plus the sibling's formula-fidelity calls. Remove that
sentence only when the published-value count reaches 20.
RE-SEARCHED 2026-10-07 (count unchanged, 8 of 20): NCHRP 1-37A Appendix LL "Punchouts in Continuously Reinforced
Concrete Pavements" (2004; https://content.aashtowarepavementme.org/Documents/1-37A/2appendices_LL.pdf , 84 pp.) was
opened and searched in full. It documents the response model, the calibration sections (Tables 11, 14, 16) and
measured-vs-predicted statistics (Tables 13, 15), but prints neither the 2nd-edition constants nor any
(accumulated damage -> punchouts/mile) answer, so it adds no checkable value for this engine. The MOP 2nd ed. remains
the only source for the constants and the only source of answers (the two Table 9-9 thresholds and the APO asymptote).
PUBLISHED SOURCES (each opened and read for this suite, 2026-10-06):
AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed.
- Sec. 5.4.3, Eq. 5-26 (printed p. 61, PDF p. 74 of the on-disk copy): PO = APO/(1 + aPO DIPO^bPO), constants
(216.8421, 33.15789, -0.58947); Table i-1 (printed p. vi, PDF p. 7) lists the same constants against the MEPDG
v1.1 values (195.789, 19.8947, -0.526316).
- Table 9-9 (printed p. 104, PDF p. 117): "CRCP Punchouts (medium and high severity), #/lane-mi" -
Interstate/Freeway: Inadequate > 10, Marginal 5 to 10, Adequate < 5.
Sakulneya, A. & Anderson, C. & Castro-Perez, J. & Roesler, J. (2024), Performance and Design of
Continuously Reinforced Concrete Pavements, Illinois Center for Transportation, FHWA-ICT-24-009,
Ch. 1 (Introduction, pp. 2-3): "the number of punchouts per mile at the end of the CRCP design life is typically
recommended to be <= 10 punchouts per mile". (The same report, Fig. 31 / Table 25, quotes the
NEWER AASHTO (2024) constants C3 107.73, C4 2.475, C5 -0.785 - see the note at the bottom.)
Thompson, A. & Taylor, B.N. (2008), Guide for the Use of the International System of Units (SI),
NIST Special Publication 811, Appendix B.8: 1 mile = 1.609 344 km (exact).
| Test block (the published value it checks) | Verdict |
| Table 9-9 Interstate "Adequate < 5 punchouts/lane-mi": just below 5 the engine says "below the typical 10/mi terminal" | Pass |
| Table 9-9 Interstate "Marginal 5 to 10": just above 5 the engine leaves the "below" band and says "approaching the terminal" | Pass |
| Table 9-9 / Sakulneya 2024: just below the 10 punchouts/mi terminal the engine still says "approaching" | Pass |
| Table 9-9 Interstate "Inadequate > 10" and Sakulneya 2024 "<= 10": just above 10 the engine says "exceeds the typical terminal" | Pass |
| Eq. 5-26 upper asymptote APO = 216.8421 /mi: at the engine's largest damage (1e9) PO is within 0.05 % of the printed APO and never above it | Pass |
| Eq. 5-26 is monotone increasing in damage and stays below APO across six decades of DIPO | Pass |
| NIST SP 811 App. B.8: 1 mi = 1.609344 km exactly, so punchouts/km = punchouts/mi / 1.609344 | Pass |
| Table i-1: the engine implements the 2nd-ed. (2015) constants, NOT the MEPDG v1.1 ones - at DI = 1 the two models differ by > 10 % | Pass |
crcp-punchout-web-validation.test.ts
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: crcp-punchout · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015), §5.4.3, Eq. 5-26 — the EXACT published CRCP punchout
transfer function (source PDF on disk, same manual as jpcp-spalling's
citation, verified via pdftotext). Eq. 5-26 itself is fully closed-form:
PO = APO / (1 + alphaPO . DIPO^betaPO),
APO = 216.8421, alphaPO = 33.15789, betaPO = -0.58947
As with jpcp-spalling: AASHTO's manual gives the exact equation and its
national calibration constants but the DIPO -> PO PAIRING used below is
hand-computed by directly applying that published equation (verified
independently in Python), not copied from a pre-published worked example —
the manual does not carry one for this specific transfer function. This is
a legitimate defence that the engine implements the cited equation exactly;
it is labelled here as formula-fidelity, not an independently-sourced answer.
| Test block (the published value it checks) | Verdict |
| [1] DI=1 -> PO=6.348229 punchouts/mi (Eq. 5-26 exact) | Pass |
| [2] DI=5 -> PO=15.667781 punchouts/mi | Pass |
| [3] DI=10 -> PO=22.745760 punchouts/mi | Pass |
| [4] DI=20 -> PO=32.504608 punchouts/mi | Pass |
| [5] DI=50 -> PO=50.376631 punchouts/mi | Pass |
| [6] DI=100 -> PO=67.846404 punchouts/mi | Pass |
| [7] DI=500 -> PO=117.186387 punchouts/mi | Pass |
| [8] DI=1000 -> PO=138.542458 punchouts/mi | Pass |
| [9] DI=0 -> PO=0 exactly (definitional, guarded above Eq. 5-26 for the DI<=0 branch) | Pass |
| [10] km conversion is exact: PO/mi / 1.609344 = PO/km at DI=10 | Pass |
| [11] monotone increasing in DI (fatigue damage), asymptotic toward APO=216.8421 | Pass |
| [12] classification bands match the terminal thresholds used in the engine (below 5, 5-10, >10 punchouts/mi) | Pass |
⚑ dcp-web-validation.test.ts
`dcp` — anchored to ASTM D6951/D6951M − 09 (Reapproved 2015).
Analyses validated: dcp · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`dcp` — anchored to ASTM D6951/D6951M − 09 (Reapproved 2015).
SOURCE
ASTM D6951/D6951M − 09 (2015), "Standard Test Method for Use of the Dynamic Cone
Penetrometer in Shallow Pavement Applications":
§7.1 expressions (1) and (2) — CBR = 292/DPI^1.12 (p. 4)
expressions (3) and (4) — CL soils with CBR < 10 (p. 4)
expressions (5) and (6) — CH soils (p. 4)
Table 2 "Tabulated Correlation of CBR versus DCP Index" — 64 rows (p. 5)
§9.1 Precision — repeatability standard deviation < 2 mm/blow (p. 5)
Primary sources cited by the standard: Webster, Grau & Williams, "Description and
Application of Dual Mass Dynamic Cone Penetrometer", Report GL-92-3, US Army, 1992;
Webster, Brown & Porter, Technical Report GL-94-17, US Air Force, 1994.
WHY THIS ENGINE, WHY THIS SOURCE
`dcp` was one of the 29 bespoke engines with ZERO published-example validation. The
governing US standard was supplied by the founder on 2026-08-06, which is what made this
possible — the engine previously leaned on IRC SP-72 / IRC 37 for its design context.
WHAT IS ASSERTED, AND AT WHAT TOLERANCE
• The three published equations, EXACTLY (1e-12) — they are printed verbatim in the
standard, so there is nothing to round.
• All 64 rows of Table 2, at 7 %. That tolerance is measured, not guessed: Table 2 is a
rounded presentation of expression (1), and the worst disagreement between the two is
6.64 % (DCP = 3 mm/blow: the table says CBR 80, expression (1) gives 85.31). 37 of the
64 table values sit inside the range expression (1) spans across their own DCP bin; the
rest are rounded slightly outside it. A tighter tolerance would fail the STANDARD
against itself, and a looser one would stop discriminating.
• The clamp range [0.5, 100] % is Table 2's own stated range, not an arbitrary guard:
the table caps at "<3 mm/blow → 100" and bottoms out at ">324 → <0.5".
INTERNAL CONSISTENCY PROOF OF THE TRANSCRIPTION
The standard prints each relation twice, once per unit system. The mm/blow and in./blow
coefficients must therefore differ by exactly 25.4:
0.017019 × 25.4 = 0.432283 — matches published expression (4) exactly
0.002871 × 25.4 = 0.0729234 — matches published expression (6) (0.072923)
Asserted below, because it proves the coefficients were read correctly rather than
merely plausibly. (The OCR of the source dropped the squared exponent on expression (4);
this arithmetic is what established that it must be there.)
| Test block (the published value it checks) | Verdict |
| ASTM D6951 expression (1): CBR = 292/DPI^1.12 for all soils but CL<10 and CH | Pass |
| ASTM D6951 expression (3): CL soils with CBR < 10 use CBR = 1/(0.017019·DPI)² | Pass |
| ASTM D6951 expression (5): CH soils use CBR = 1/(0.002871·DPI) | Pass |
| the mm/blow and in./blow coefficients differ by exactly 25.4 — proof of transcription | Pass |
| ASTM D6951 Table 2: all 64 tabulated CBR values reproduced within the table’s own rounding | Pass |
| ASTM D6951 Table 2: CBR is strictly decreasing across the table, and the ends match its caps | Pass |
| end-to-end: a uniform profile returns the DCP index and CBR the standard predicts | Pass |
| E-40: the 4.6 kg hammer factor is ASTM’s integer 2, not the 8/4.6 mass ratio | Pass |
| a non-standard hammer mass is extrapolated BEYOND ASTM and says so | Pass |
| end-to-end: a layered profile splits at the change of penetration rate | Pass |
| the alternative correlations are the published ones, and differ from ASTM as documented | Pass |
| every output is finite, and a refusal (zero penetration) is not reported as strong ground | Pass |
faa-airfield-thickness-published-web-validation.test.ts
Source-agreement checks for the closed-form airfield thickness engine `faa-airfield-thickness` (Corps/FAA CBR equation + Westergaard free-edge rigid design).
Analyses validated: faa-airfield-thickness · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Source-agreement checks for the closed-form airfield thickness engine `faa-airfield-thickness`
(Corps/FAA CBR equation + Westergaard free-edge rigid design).
SOURCES (opened and read):
FAA AC 150/5320-6D (1995), Airport Pavement Design and Evaluation, Change 2 (6/3/02), local extract
`_pavement_systems_2026-06-25/FAA-AC-150-5320-6D-CBR-westergaard.pdf` — para 337 (radius of relative
stiffness, "E = usually 4 million psi", "Poisson's ratio ... usually 0.15").
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — Table 3-2 (P-501: 4,000,000 psi, ν 0.15).
Mathew, T.V. (2009), Transportation Systems Engineering, Ch. 15 "Rigid pavement design", IIT Bombay (NPTEL),
https://www.civil.iitb.ac.in/~vmtom/1100_LnTse/411_lnTse/fancy.pdf, read 2026-10-07 — Eqs. 15.1, 15.2, 15.4.
EVIDENCE CLASS: formula-fidelity only — BLOCKED for a release-grade benchmark. The governing closed-form
chapters of AC 150/5320-6D (the CBR alpha-factor equation, the Westergaard rigid design curves and their worked
examples) are NOT in the local reference library: the local AC 6D file is a 28-page extract (joints, overlay
example, light-aircraft Chapter 5). The only printed numeric result in it that touches this engine is a chart
reading for 24,000-lb aircraft (Fig. 5-2: total 12.3 in at CBR 7.5; 6.7 in at CBR 20), whose coverage and
tyre-pressure assumptions are on the figure and were not recoverable in text. No published worked answer for
the α equation or the Westergaard edge design was found in any readable source. Everything below re-checks the
engine's constants and functional forms against the equations those sources print; it is NOT a published answer.
| Test block (the published value it checks) | Verdict |
| rigid: radius of relative stiffness uses the printed constants E = 4,000,000 psi and ν = 0.15 (AC 6D para 337, AC 6G Table 3-2) | Pass |
| rigid: the solved slab satisfies the edge-stress criterion σ_edge = R / DF with Mathew Eq. 15.4 and b from Eq. 15.2 | Pass |
| rigid: stress ∝ 1/h² dependence (Mathew Eq. 15.4) — a stronger concrete gives a thinner slab | Pass |
| flexible: the Corps CBR form t = α·√(P/(8.1·CBR) − A/π) gives zero cover when the tyre footprint alone spreads the load | Pass |
faa-airfield-thickness-web-validation.test.ts
Formula-fidelity validation against FAA AC 150/5320-6D Ch.3 (flexible, U.S.
Analyses validated: faa-airfield-thickness · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against FAA AC 150/5320-6D Ch.3 (flexible, U.S.
Army Corps of Engineers CBR equation) and Ch.4 (rigid, Westergaard edge
loading + design-factor allowable stress). Both are fully closed-form
(flexible is direct algebra; rigid is a deterministic bisection on a
closed-form stress function) and hand-computed exactly (verified
independently in Python, matching this engine's own bisection to full
numerical precision).
flexible: t = alpha.sqrt(P/(8.1.CBR) - A/pi), A=P/p, alpha=0.23log10(C)+0.15
rigid: solve h so sigma_edge(h) = R/DF, sigma_edge via the Westergaard
edge-loading closed-form with E=4,000,000 psi, mu=0.15 (PCC defaults)
| Test block (the published value it checks) | Verdict |
| [1-3] flexible: P=30000lb, p=200psi, CBR=8%, C=25000 -> alpha=1.161526, t=23.668258in (601.174mm) | Pass |
| [4-6] flexible: heavier load, worse CBR: P=45000lb, p=220psi, CBR=6%, C=50000 -> alpha=1.230763, t=36.110201in | Pass |
| [7-10] rigid: P=30000lb, p=200psi, k=300pci, R=700psi, DF=1.3 -> h=10.032231in, sigma=allow=538.461538psi, l=32.730929in | Pass |
| [11] rigid: at the converged thickness, edge stress equals the allowable stress to within the bisection tolerance | Pass |
| [12] rigid: default design factor is 1.3 when not supplied | Pass |
| [13] flexible: a stronger subgrade (higher CBR) or lighter load reduces the required cover thickness | Pass |
| [14] flexible: coverages < 1 clamps to C=1 (alpha only defined for C>=1) and warns | Pass |
| [15] flexible: CBR, wheel load, or tire pressure at 0 or below is refused | Pass |
| [16] rigid: k, R, or DF at 0 or below is refused | Pass |
faarfield-ac-cdf-published-web-validation.test.ts
Source-agreement checks for the FAARFIELD HMA fatigue CDF engine `faarfield-ac-cdf` (RDEC plateau-value model: PV from strain / stiffness / volumetrics / gradation, then Nf from PV).
Analyses validated: faarfield-ac-cdf · Recorded run: passed — 2 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Source-agreement checks for the FAARFIELD HMA fatigue CDF engine `faarfield-ac-cdf`
(RDEC plateau-value model: PV from strain / stiffness / volumetrics / gradation, then Nf from PV).
SOURCES (opened and read):
Pais, J.C., Pereira, P.A.A., Minhoto, M.J.C., Fontes, L.P.T.L., Kumar, D.S.N.V.A. and Silva, B.T.A. (2009),
Application of plateau value to predict fatigue life, 2nd Workshop on Four Point Bending, University of
Minho — http://www.civil.uminho.pt/4pb/conference2/Paper31.pdf (read 2026-10-07). Its Eq. 2 prints the
Shen & Carpenter unique PV–Nf50 relationship as PV = 0.4428 · Nf50^(−1.1102).
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — Appendix H.2 Step 5 and §5.3 (the HMA CDF
check is "good practice" for the final flexible design; the §5.3 example reports HMA CDF 0.57 for a
4 in P-401 / 5 in stabilized / 12 in P-209 / 10 in P-154 taxiway).
EVIDENCE CLASS: formula-fidelity, with ONE published equation cross-checked. BLOCKED for release-grade evidence:
- the Carpenter & Shen (2006) / Shen & Carpenter (2007) papers are not in the local library, so the PV
prediction coefficients (44.422, 5.14, 2.993, 1.85, −0.4063) could not be read against their source;
- the only FAA printed HMA-CDF answer (0.57, AC 6G §5.3) belongs to a P-209 / P-154 stack that this 3-layer
engine cannot represent, so it cannot be reproduced without inventing a lumped base modulus;
- Pais et al. themselves report their Portuguese mixtures "far from" that relation (their Fig. 9), so their
specimen tables are not a validation set for it.
What is checked: the engine's Nf(PV) link is the inverse of the published PV(Nf) relation.
| Test block (the published value it checks) | Verdict |
| engine Nf(PV) is the inverse of the published Shen-Carpenter PV–Nf50 relation across stiffness and strain | Pass |
| the published relation is monotone the way the engine assumes: a larger plateau value means a shorter fatigue life | Pass |
faarfield-ac-cdf-web-validation.test.ts
Formula-fidelity validation against Carpenter & Shen (2006) "A Dissipated Energy Approach to Fatigue Evaluation," Road Mater.
Analyses validated: faarfield-ac-cdf · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against Carpenter & Shen (2006) "A Dissipated
Energy Approach to Fatigue Evaluation," Road Mater. Pavement Des. 7(1) (the
RDEC plateau-value model FAA AC 150/5320-6E/6F/6G's FAARFIELD "Calculate
HMA CDF" check adopted), verified against this engine's own cited
coefficients (44.422/5.14/2.993/1.85/-0.4063 for PV; 0.4801/-0.9007 for Nf).
As with asphalt-institute-design: the Burmister tensile-strain computation
is validated separately against the exact Boussinesq limit; this suite
takes the engine's own reported strain and independently re-derives PV, Nf,
VP, GP, applied coverages, and CDF from the cited published equations
(verified in Python) -- proving the transfer-function math matches the
cited source exactly.
| Test block (the published value it checks) | Verdict |
| [1-2] volumetric parameter VP = Va/(Va+Vb) and gradation parameter GP = (PNMS-PPCS)/P200 match exactly for the base case | Pass |
| [3-6] PV, Nf, applied coverages, and CDF independently re-derived from the engine's own reported strain match its output exactly | Pass |
| [7] the specific reference case cited in the engine's own header reproduces the correct order of magnitude: et~250ue, S~3447MPa -> Nf order 1e6 | Pass |
| [8] the PV exponent on strain (5.14) is exactly reproduced: doubling et raises PV by exactly 2^5.14 | Pass |
| [9] a higher pass-to-coverage ratio (more wander) reduces applied coverages, and hence the CDF, proportionally | Pass |
| [10] annual_departures=0 gives zero applied coverages and zero CDF | Pass |
| [11] every load-bearing input is refused at 0 or below (never silently floored to an unbounded Nf) | Pass |
faarfield-cdf-web-validation.test.ts
Published-value validation of the single-aircraft FAARFIELD subgrade CDF engine `faarfield-cdf` (3-layer AC / base / subgrade Burmister response → FAA subgrade failure model → wander coverages).
Analyses validated: faarfield-cdf · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation of the single-aircraft FAARFIELD subgrade CDF engine `faarfield-cdf`
(3-layer AC / base / subgrade Burmister response → FAA subgrade failure model → wander coverages).
SOURCES (opened and read from the local reference library,
`Geo Technical engineering books/_new_2026-07-08_faarfield/`):
Kawa, I. (2017), Development of New Subgrade Failure Model for Flexible Pavements in FAARFIELD,
DOT/FAA/TC-17/28 — Eqs. 4-6, Table 4 (regression data), §3.3 (tangent point), Table 6 (unshifted
FAARFIELD 1.41 coverages-to-failure).
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — §3.12.8.7 + Fig. 3-2 (effective tyre
width), §3.12.9.2 (82 strips of 10 in, 75 % of passes inside a 70-in wander width, σ = 30.435 in).
SCOPE — READ THIS BEFORE RELYING ON THE COUNT. The published evidence that exists for this engine is
COMPONENT-LEVEL: the failure model it calls (`faaCoveragesToFailure`) and the wander / effective-width
coverage model it shares with `faarfield-flexible` (`faarfield-coverage.ts`). No FAA document prints a
FAARFIELD answer for this engine's 3-layer idealisation (one lumped base layer): every published design or
life in TC-17/28 and AC 6G uses a P-209 / P-154 stack whose sublayer moduli FAARFIELD computes
internally. The end-to-end layered response is validated against those published stacks in
`faarfield-flexible-published-web-validation.test.ts` (same Burmister kernel, same failure and coverage
code) and in `aircraft-gear-response-web-validation.test.ts`. The checks marked HAND-DERIVED below are
arithmetic identities and do NOT count toward the published-value tally in the engineer's report.
EVIDENCE CLASS: formula-fidelity + component-level published values. The failure-model and coverage-geometry
checks compare against printed numbers for the COMPONENTS; the engine's end-to-end 3-layer answer has no published
counterpart, so the manifest must keep this engine from being read as 'released' on this suite alone.
| Test block (the published value it checks) | Verdict |
| subgrade failure model lies on the TC-17/28 Table 4 lower-envelope data (Bleasdale branch, C ≥ 1000) | Pass |
| tangent point and the Table 6 linear branch (Eq. 6) | Pass |
| wander and effective-width constants follow AC 6G §3.12.8.7 / §3.12.9.2 | Pass |
| engine chain: the reported coverages-to-failure is the published model at the reported strain (HAND-DERIVED identity) | Pass |
faarfield-design-published-web-validation.test.ts
Published-criterion validation of the FAARFIELD-class flexible THICKNESS design engine `faarfield-design` (iterates the asphalt thickness of a 3-layer AC / base / subgrade section until the Miner mix CDF = 1).
Analyses validated: faarfield-design · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-criterion validation of the FAARFIELD-class flexible THICKNESS design engine `faarfield-design`
(iterates the asphalt thickness of a 3-layer AC / base / subgrade section until the Miner mix CDF = 1).
SOURCES (opened and read from the local reference library):
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — §3.12.9.1 (the thickness is adjusted
until CDF = 1 for the given traffic mix and design life; CDF is the sum of one term per aircraft),
§3.12.2.3 ("using departures of a single design aircraft to represent all traffic is not equivalent to
designing with the full traffic mix ... and will generally result in excessive thickness"), §3.12.6.8
(CDF = maximum over 82 strips).
Kawa, I. (2017), Development of New Subgrade Failure Model for Flexible Pavements in FAARFIELD,
DOT/FAA/TC-17/28 — Eq. 7 (CDF_T = Σ C_i / C_iF; failure is CDF_T = 1.0).
SCOPE — READ THIS BEFORE RELYING ON THE COUNT. No published FAARFIELD design uses this engine's 3-layer
(one lumped base) idealisation: every published design thickness in AC 6G Appendix H and TC-17/28 Table 2 is
for a P-209 / P-154 stack with FAARFIELD-computed sublayer moduli, and those designs are reproduced by
`faarfield-flexible` (see `faarfield-flexible-published-web-validation.test.ts`; the Table 2 B737-800 designs
and Appendix H.2 / H.8 thicknesses). The checks below are the PUBLISHED DESIGN CRITERIA (CDF = 1, Miner sum,
mix vs design-aircraft) applied to this engine — they are statements of the method, not printed numeric
answers, and the report must not count them as published values.
EVIDENCE CLASS: formula-fidelity + component-level published values. The failure-model and coverage-geometry
checks compare against printed numbers for the COMPONENTS; the engine's end-to-end 3-layer answer has no published
counterpart, so the manifest must keep this engine from being read as 'released' on this suite alone.
| Test block (the published value it checks) | Verdict |
| AC 6G §3.12.9.1: the designed thickness has CDF = 1 for the traffic mix | Pass |
| AC 6G §3.12.9.1 / TC-17/28 Eq. 7: the mix CDF is the sum of the per-aircraft terms | Pass |
| AC 6G §3.12.2.3: a single "design aircraft" carrying all departures over-designs the true mix | Pass |
| the design thickness responds to the design-life input the way the CDF definition requires | Pass |
faarfield-design-web-validation.test.ts
EVIDENCE CLASS (added with the 2026-10 published-value audit): formula-fidelity / design-property evidence only.
Analyses validated: faarfield-design · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
EVIDENCE CLASS (added with the 2026-10 published-value audit): formula-fidelity / design-property evidence only.
None of these assertions compares against a FAARFIELD answer printed by the FAA for this 3-layer idealisation;
see `faarfield-design-published-web-validation.test.ts` for what is and is not published.
| Test block (the published value it checks) | Verdict |
| [1-2] single aircraft: converges, and the design CDF is within the engine's own documented tolerance of the FAA design condition CDF=1.0 | Pass |
| [3] the single aircraft's CDF contribution accounts for 100% of the total when it is the only aircraft in the fleet | Pass |
| [4-5] a two-aircraft mix's CDF contributions sum to the design CDF (Miner's cumulative damage rule) and each is a real fraction of it | Pass |
| [6] a two-aircraft mix requires MORE thickness than the single heaviest aircraft designed alone (the mix cannot be easier than its governing member) | Pass |
| [7] a heavier wheel load requires a thicker design section, all else equal | Pass |
| [8] more annual departures over the same design life requires a thicker section | Pass |
| [9] a stronger subgrade reduces the required thickness for the same fleet | Pass |
| [10] no aircraft in the fleet, or an aircraft with zero load/departures, is refused | Pass |
| [11] the returned required thickness lies within the search bracket [min, max] | Pass |
faarfield-flexible-published-web-validation.test.ts
Published-value validation of the FAARFIELD flexible (LEAF) design engine `faarfield-flexible` (and the layered-elastic multi-wheel kernel it drives), against two independent FAA documents.
Analyses validated: faarfield-flexible · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation of the FAARFIELD flexible (LEAF) design engine `faarfield-flexible`
(and the layered-elastic multi-wheel kernel it drives), against two independent FAA documents.
SOURCES (each value below carries its locator; both read in full from the local reference library,
`Geo Technical engineering books/_new_2026-07-08_faarfield/` and `_pavement_systems_2026-06-25/`):
Kawa, I. (2017), Development of New Subgrade Failure Model for Flexible Pavements in FAARFIELD,
DOT/FAA/TC-17/28, FAA William J. Hughes Technical Center — Table 1 (layer moduli), Eqs. 1, 4-6,
Table 2 (B737-800 designs), Table 3 + Appendix B Tables B-1..B-8 (FAARFIELD 1.40 subgrade strains),
Table 4 (regression data), Table 6 (unshifted FAARFIELD 1.41 CF), Appendix A (gear definitions).
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — Table 3-2 (moduli), Table 3-3
(minimum layer thickness), §3.12.8.7 (effective tyre width), Appendix H.2 / H.8 (worked designs).
WHAT A PASS MEANS. FAARFIELD's own numerical output is the reference, so agreement is an acceptance
BAND and never an exact match:
- STRAIN_TOL = 2 %. Two independent Burmister implementations should agree to ~1 % on a strain whose
source prints 4 significant figures (0.03-0.08 % rounding); 2 % is fixed BEFORE comparing and the
observed maximum (1.0 %, one point) is reported in the ENGINE AUDIT NOTE below.
- Table 1 moduli are printed to the psi, so they are checked to 1 psi.
- Design THICKNESSES: AC 6G Appendix H values are compared to ±0.25 in (half of the FAA's own 0.5-in
construction rounding). TC-17/28 Table 2 is compared with an EMPIRICAL bound (TABLE2_TOL_IN) because a
0.5-1.0 in shortfall is unexplained (FAARFIELD's exact pass-to-coverage algorithm is not public).
ENGINE AUDIT NOTE (what this suite found, 2026-10):
1. Coverages were counted with the surface tyre print width; AC 150/5320-6G §3.12.8.7 defines the
flexible effective width at the top of the subgrade (W + H, or W + T + H). Against Table 2 the
P-154 was under-designed by 1.8-2.6 in; now 0.5-1.0 in (still unconservative; see DESIGN_TOL_IN).
2. FAAModulus Case 3 (TC-17/28 §2.1) was not implemented, so the modulus was discontinuous at 12 in
and the Appendix-H design stuck on the jump (12.0 in, CDF 0.72).
3. The P-401/P-403 stabilized base defaulted to 200 ksi; Table 3-2 prints 400 ksi (merged cell). With
it the Appendix-H.2 / H.8 designs are 10.03 in (printed 10.1) and 17.98 in (printed 18).
This is the engine's dedicated published-answer suite; it supplements, and does not replace,
`faarfield-flexible-web-validation.test.ts`.
| Test block (the published value it checks) | Verdict |
| max subgrade strain of the NAPTF 4-wheel (2D) and 6-wheel (3D) gears reproduces TC-17/28 Appendix B | Pass |
| Eq. 1 reproduces TC-17/28 Table 1(b) sublayer moduli (4 × 6.0025 in P-154, 8 in P-209) to the psi | Pass |
| the Bleasdale curve (Eq. 4) lies on the Table 4 lower-envelope data it was regressed to | Pass |
| the tangent point (Eq. 6) and Table 6 unshifted FAARFIELD 1.41 coverages-to-failure | Pass |
| TC-17/28 Table 2: B737-800, 1 200 dep/yr, 20 yr, 5 in P-401 + 8 in P-209 → P-154 t1 at CBR 3/6/10/15 | Pass |
| TC-17/28 Table 2: effective equivalency factor feq = t3/t2 (P-209 cut by 3 in → extra P-154) | Pass |
| AC 6G Appendix H.2: 4 in P-401 / 8 in P-403 / 12 in P-209 / P-154 on CBR 5 → "10.1 inches P-154" | Pass |
| AC 6G Appendix H.8: apron extension, same traffic, CBR 5, 6 in P-209 → "18 inches P-154" (36 in total) | Pass |
| layer inputs follow AC 6G Table 3-2 and the published subgrade modulus convention | Pass |
| Table 3-3 minimum P-209 of 6 in applies from 60,000 lb, both weight classes | Pass |
faarfield-flexible-web-validation.test.ts
Web-benchmark validation for the full FAARFIELD 1.41 flexible LEAF design.
Analyses validated: faarfield-cdf, faarfield-flexible · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the full FAARFIELD 1.41 flexible LEAF design.
The two NEW physics pieces are validated against their primary sources to the
last digit, then the full design is checked against the AC 150/5320-6G
Appendix-H worked example (P-209 6.1 in / P-154 10.1 in).
Sources (on disk, Geo Technical engineering books/_new_2026-07-08_faarfield/):
FAA-TC-17/28 (2017) Table 1 — aggregate sublayer moduli (LEAF input data)
FAA-TC-17/28 (2017) Eqs. 4–6 + tangency ε = 1.765093e-3 at C = 1000
FAA AC 150/5320-6G Appendix H — flexible design example (final P-154 = 10.1 in)
| Test block (the published value it checks) | Verdict |
| granularSublayers reproduces FAA-TC-17/28 Table 1 P-154 sublayer moduli (WES params) | Pass |
| granularSublayers reproduces FAA-TC-17/28 Table 1 P-209 modulus (WES params) | Pass |
| FAAModulus sublayering keeps the top sublayer between base/2 and 1.5·base | Pass |
| the Bleasdale + tangent branches meet at exactly 1000 coverages | Pass |
| Bleasdale model tracks the FAA-TC-17/28 Table 4 points (≥ 1000 coverages) | Pass |
| the flexible engine and faarfield-cdf/mix-cdf share the SAME Bleasdale model | Pass |
| the linear tangent branch governs below 1000 coverages (Eq. 6) | Pass |
| Appendix-H flexible design reproduces P-154 ≈ 10.1 in (to the inch) | Pass |
| the assembled section reports sane sublayer moduli + subgrade E = 1500·CBR | Pass |
| design is monotone: a weaker subgrade needs a thicker P-154 | Pass |
| a P-209-only design honours the 6-in FAA minimum base thickness (Table 3-3) | Pass |
faarfield-mix-cdf-web-validation.test.ts
Published-value validation of the two-aircraft FAARFIELD subgrade CDF engine `faarfield-mix-cdf` (Miner sum over an aircraft mix, 82 strips, 3-layer AC / base / subgrade response).
Analyses validated: faarfield-mix-cdf · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation of the two-aircraft FAARFIELD subgrade CDF engine `faarfield-mix-cdf`
(Miner sum over an aircraft mix, 82 strips, 3-layer AC / base / subgrade response).
SOURCES (opened and read from the local reference library):
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — §3.12.9.1 (CDF = Σ applied / allowable
over the mix), §3.12.6.8 (max over 82 strips), §3.12.8.7 + Fig. 3-2 (effective tyre width), §3.12.6.1
(95 % of gross weight on the main gears).
Boeing (2006), 737 Airplane Characteristics for Airport Planning, D6-58325-6, §7.2.4 and §7.10 (B737-800
maximum design taxi weight 174,700 lb, main-gear tyre pressure 204-205 psi, 46.79 % of weight on one
main-gear leg) — the gear data the engine's aircraft library hands to this engine.
Kawa, I. (2017), Development of New Subgrade Failure Model for Flexible Pavements in FAARFIELD,
DOT/FAA/TC-17/28 — Eq. 7 (Miner sum of CDF_i = C_i / C_iF) and Table 10 (worked mixed-load Miner sum).
SCOPE — READ THIS BEFORE RELYING ON THE COUNT. No FAA document prints a FAARFIELD answer for this engine's
two-slot, 3-layer idealisation. What IS published and checked here: the aircraft data the engine resolves from
its library (Boeing ACAP), the Miner summation rule and the TC-17/28 Table 10 worked sum, and the coverage
geometry. The published layered response and design thicknesses are validated through the same kernel in
`faarfield-flexible-published-web-validation.test.ts`. Items marked HAND-DERIVED are identities of the
engine's own arithmetic and are not published answers.
EVIDENCE CLASS: formula-fidelity + component-level published values. The failure-model and coverage-geometry
checks compare against printed numbers for the COMPONENTS; the engine's end-to-end 3-layer answer has no published
counterpart, so the manifest must keep this engine from being read as 'released' on this suite alone.
| Test block (the published value it checks) | Verdict |
| the B737-800 handed to the engine agrees with the Boeing ACAP (D6-58325-6 §7.2.4 / §7.10) | Pass |
| AC 6G §3.12.9.1 / TC-17/28 Eq. 7: the mix CDF is the Miner sum of the per-aircraft terms | Pass |
| a mix is at least as damaging as either aircraft alone (AC 6G §3.12.2.3 — designing to one aircraft is not the mix) | Pass |
| disabling the second slot (departures = 0) reproduces the single-aircraft engine result | Pass |
| CDF scales linearly with departures (AC 6G §3.12.9.1: CDF = applied coverages / coverages to failure) | Pass |
⚑ faarfield-rigid-published-web-validation.test.ts
PUBLISHED-VALUES: 3 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: 2-3 published engine outputs; the remaining assertions are hand-derived or bands.
Analyses validated: faarfield-rigid · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 3 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: 2-3 published engine outputs; the remaining assertions are hand-derived or bands. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Published-value validation of the FAARFIELD-class rigid design engine `faarfield-rigid`
(Westergaard free-edge stress + Kawa-Brill-Hayhoe rigid failure regressions + Miner CDF).
SOURCES (opened and read from the local reference library):
FAA AC 150/5320-6G (2021), Airport Pavement Design and Evaluation — Appendix H.3 (rigid design example:
"FAARFIELD gives a thickness of 17.14 inches"), Appendix H.9 (CDFU example: "FAARFIELD designed a
concrete thickness of 16.7 inches for 20 years"), Table 3-2 (P-501 4,000,000 psi, ν 0.15), Table 3-4
(minimum rigid surface 6 in), §3.16.7.3 (design flexural strength 600-750 psi).
Kawa, I., Brill, D.R. and Hayhoe, G.F. (2007), FAARFIELD - New FAA Airport Thickness Design Software,
FAA Worldwide Airport Technology Transfer Conference (file P07077_Kawa.pdf) — Eqs. (1), (2), (3).
SCOPE AND KNOWN MODEL LIMIT. Published rigid ANSWERS available locally are the two design thicknesses above.
FAARFIELD solves a 3-D finite-element model of slab + base layers + subgrade; this engine is the classical
closed form (free-edge Westergaard on a dense liquid of subgrade modulus k, base layers ignored). It is
CONSERVATIVE against both published designs (observed +0.80 in and +0.84 in, i.e. +4.7 % and +5.0 %) and
the band below (RIGID_TOL_IN) is an empirical fidelity bound stated by the engine's own header ("within
~1-2 in of the FE result"), not a rounding tolerance. Items labelled HAND-DERIVED re-evaluate the published
regression equations and are not published answers.
AC 6G H.3 / Table 3-4 note 2 round a FAARFIELD slab to the NEAREST 0.5 in (17.14 → 17.0); this engine rounds
UP to the next 0.5 in (17.94 → 18.0). That is a deliberate conservative deviation, recorded here rather than
silently changed.
| Test block (the published value it checks) | Verdict |
| AC 6G Appendix H.3: P-501 R = 600 psi, k = 100 pci, 20 yr → 17.14 in | Pass |
| AC 6G Appendix H.9: R = 625 psi, k = 100.5 pci, same traffic, 20 yr → 16.7 in | Pass |
| AC 6G Table 3-4 / Table 3-2: minimum rigid surface 6 in; P-501 modulus 4,000,000 psi with ν = 0.15 | Pass |
| design flexural strength range in AC 6G §3.16.7.3 (600-750 psi) gives monotone, physical slabs | Pass |
| Kawa, Brill & Hayhoe (2007) Eqs. (1)-(2) evaluated at the AC H.3 design factor (HAND-DERIVED) | Pass |
faarfield-rigid-web-validation.test.ts
Web-benchmark validation for the FAARFIELD-class RIGID airfield design.
Analyses validated: faarfield-rigid · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the FAARFIELD-class RIGID airfield design.
Components are pinned to their closed-form / published values to the digit;
the full design is checked against the AC 150/5320-6G Appendix-H rigid example.
Sources (on disk + cited):
AC 150/5320-6G Appendix H — rigid example (P-501 R=600 psi, k=100 pci,
4-aircraft mix, 20 yr → 17.14 in slab, rounded 17.0 in)
Kawa, Brill & Hayhoe (2007) "FAARFIELD — New FAA Airport Thickness Design
Software" (on disk P07077_Kawa.pdf) — rigid failure regressions, DF = R/σ:
eq(1) onset DF = 0.7409 + 0.2465·log(CO) ; eq(2) full DF = 0.5878 + 0.2523·log(CF)
Corps LEA DF = 0.58901 + 0.35486·log₁₀C ; Westergaard (1926/1948) edge form.
| Test block (the published value it checks) | Verdict |
| FAARFIELD full-failure eq(2): C = 10^[(DF−0.5878)/0.2523] | Pass |
| FAARFIELD onset eq(1): C = 10^[(DF−0.7409)/0.2465] (more conservative) | Pass |
| Corps of Engineers LEA model: C = 10^[(DF−0.58901)/0.35486] | Pass |
| Westergaard edge stress matches the closed-form hand calc | Pass |
| Appendix-H rigid design reproduces the 17.14-in slab (closed form ≈ FE) | Pass |
| rigid design is monotone in strength and traffic | Pass |
⚑ irc-sp72-pavement-published-web-validation.test.ts
LOW-VOLUME RURAL-ROAD PAVEMENT — `computeIrcSp72Pavement` (traffic curve A–D, minimum base course, sub-base split, bituminous-surfacing requirement) checked against the TEXT, TABLES AND WORKED EXAMPLES of two independent Indian Roads Congr…
Analyses validated: irc-sp72-pavement · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
LOW-VOLUME RURAL-ROAD PAVEMENT — `computeIrcSp72Pavement` (traffic curve A–D, minimum base course, sub-base
split, bituminous-surfacing requirement) checked against the TEXT, TABLES AND WORKED EXAMPLES of two
independent Indian Roads Congress documents, both opened and read on 2026-10-06.
WHY THIS FILE EXISTS. The earlier suite (`irc-sp72-pavement-web-validation.test.ts`) describes itself as a
check of threshold logic "read directly off the cited clause"; its expected values are the engine's own
thresholds restated. What it never did is compare the engine with an answer somebody else PRINTED — a
tabulated surfacing decision, a worked example — or with a second document. This file does.
SOURCES
IRC:SP:72-2015 (Indian Roads Congress, "Guidelines for the Design of Flexible Pavements for Low Volume Rural
Roads", local reference-library PDF):
§1.3.3 curves A, B, C, D for 0-15, 15-45, 45-150, 150-450 CVPD; minimum base 150 mm (A, B) and
225 mm (C, D); sub-base = total − minimum base
§1.3.4 bituminous surfacing for all rural roads EXCEPT (i) rainfall < 500 mm and traffic up to 150
motorised vehicles/day, (ii) rainfall < 1000 mm and traffic up to 50
§6.1.2 gravel roads: subgrade CBR above 2
Appendix A seven ADT ↔ CVPD pairs (100 ↔ 25, 150 ↔ 35, 200 ↔ 50, 300 ↔ 75, 400 ↔ 100, 500 ↔ 125,
1000 ↔ 300)
Appendix D the illustrative example (CVPD 44, rainfall 750 mm, CBR 5)
IRC:SP:20-2002 (Indian Roads Congress, "Rural Roads Manual", digitised copy published by Public.Resource.Org,
https://law.resource.org/pub/in/bis/irc/irc.gov.in.sp.020.2002.pdf): Table 5.1 "Guidelines on Surfacing for
Rural Road" (page image read at 110 dpi) and the worked example of §5.4.3.
WHAT IS AND IS NOT PUBLISHED HERE. Table 5.1 of SP:20 is a tabulated DECISION for twelve rainfall × traffic
cells and is the engine's `bituminous_surfacing_required` output, so its twelve cells are independent published
answers to the engine's one non-trivial logic. The band and threshold tests restate SP:72's clause text with
mid-band inputs chosen so no boundary convention is needed; the Appendix A seven CVPD values are published
inputs whose band follows unambiguously from §1.3.3. The sub-base rule is applied to one hand-chosen total (400
mm) and is labelled as derived, not published.
NOT ASSERTED, and why (so it is not "fixed" later):
· The total pavement thickness is an INPUT (read from the design curve), so the engine cannot reproduce the
curve-read thicknesses of SP:72's Fig. 4 or SP:20's Figs. 5.1–5.4 (chart images).
· SP:20-2002's worked example (§5.4.3) provides a 150 mm base for 54 CVPD at CBR 4 and its catalogue varies
the base between 150 and 225 mm with CBR; SP:72-2015 §1.3.3 replaced that with a uniform 225 mm for curves
C and D, and the engine follows the later code. The two editions disagree by design; only SP:72-2015 is
asserted for base thickness.
· The engine applies the §1.3.4 thresholds to CVPD although the clause defines them on total motorised
vehicles per day (CVPD is a subset; Appendix A pairs ADT 500 with CVPD 125). The engine says so in a
warning. Table 5.1 is expressed in motorised vehicles; the test feeds the same number as CVPD, which is the
engine's documented (permissive) reading, and asserts the engine's warning is present.
· SP:72-2015's 'Appendix D' concludes a GRAVEL road because ESAL (78,660) is below 100,000, not because of
§1.3.4; the test asserts only that the engine's surfacing verdict agrees with that outcome.
| Test block (the published value it checks) | Verdict |
| IRC:SP:72-2015 §1.3.3 — curve A/B/C/D for traffic categories 0-15 / 15-45 / 45-150 / 150-450 CVPD (mid-band inputs) | Pass |
| IRC:SP:72-2015 §1.3.3 — minimum base course 150 mm for curves A and B, 225 mm for curves C and D | Pass |
| IRC:SP:72-2015 §1.3.3 — "sub-base ... arrived at by subtracting the minimum base course thickness from the total" (derived: total 400 mm) | Pass |
| IRC:SP:72-2015 Appendix A — the seven CVPD values of the ADT table fall on the curves §1.3.3 assigns them | Pass |
| IRC:SP:72-2015 §1.3.4 — exemption (i): rainfall "less than 500 mm" and traffic "upto 150" | Pass |
| IRC:SP:72-2015 §1.3.4 — exemption (ii): rainfall "less than 1000 mm" and traffic "upto 50" | Pass |
| IRC:SP:72-2015 §6.1.2 — gravel-road floor "subgrade CBR is above 2": the engine warns at CBR 2 and not at 2.5 | Pass |
| IRC:SP:72-2015 Appendix D — CVPD 44 (6 HCV + 38 MCV), rainfall 750 mm, CBR 5: curve B, 150 mm base, gravel acceptable | Pass |
| IRC:SP:20-2002 Table 5.1 — rainfall 0-500 mm: gravel at 0-50 and 50-150 motorised/day, bituminous at 150+ | Pass |
| IRC:SP:20-2002 Table 5.1 — rainfall 500-1000 mm: gravel only at 0-50; bituminous (single-coat SD or more) above | Pass |
| IRC:SP:20-2002 Table 5.1 — rainfall 1000-1500 mm and 1500+ mm: bituminous surfacing at every traffic level | Pass |
| IRC:SP:20-2002 §5.4.3 — 30 CVPD growing 6 % for 10 years = 54 CVPD → curve C; rainfall 1200 mm → "2 Coat Surface Dressing" | Pass |
irc-sp72-pavement-web-validation.test.ts
Formula-fidelity validation against IRC:SP-72-2015 §1.3.3 (traffic-curve bands and minimum base-course thicknesses) and §1.3.4 (gravel/WBM surfacing exemptions).
Analyses validated: irc-sp72-pavement · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against IRC:SP-72-2015 §1.3.3 (traffic-curve
bands and minimum base-course thicknesses) and §1.3.4 (gravel/WBM surfacing
exemptions). This is deterministic threshold/categorisation logic (no
continuous formula to invert), so every expected value below is read
directly off the cited clause's published thresholds and cross-checked by
hand -- CVPD bands 0-15/15-45/45-150/150-450 -> curves A/B/C/D; minimum
base 150mm (A,B) / 225mm (C,D); the two rainfall-traffic exemption pairs
(<500mm & <=150 cvpd) and (<1000mm & <=50 cvpd).
| Test block (the published value it checks) | Verdict |
| [1-3] CVPD=10 (curve A, 0-15 band): min base=150mm, sub-base=250mm at 400mm total | Pass |
| [4-6] CVPD=30 (curve B, 15-45 band): min base=150mm | Pass |
| [7-9] CVPD=100 (curve C, 45-150 band): min base=225mm | Pass |
| [10-12] CVPD=300 (curve D, 150-450 band): min base=225mm | Pass |
| [13] the exact CVPD boundary values fall into the LOWER band (<=15 -> A, <=45 -> B, <=150 -> C) | Pass |
| [14] CVPD above 450 warns that it is outside the SP:72 curve range (use IRC 37 instead) | Pass |
| [15] exemption (i): arid climate (<500mm rain) with CVPD<=150 allows gravel/WBM surfacing | Pass |
| [16] exemption (ii): low-rainfall (<1000mm) with CVPD<=50 also allows gravel/WBM surfacing | Pass |
| [17] traffic too high for either exemption forces bituminous surfacing despite low rainfall | Pass |
| [18] high rainfall (>=1000mm) forces bituminous surfacing regardless of traffic | Pass |
| [19] no rainfall supplied assumes bituminous surfacing is required (never silently exempted) | Pass |
| [20] total thickness below the minimum base course flags the shortfall rather than a negative sub-base | Pass |
| [21] CVPD, CBR, and total thickness are each refused when invalid | Pass |
jpcp-cracking-published-web-validation.test.ts
PUBLISHED-ANSWER validation of the LOAD-STRESS SUB-MODEL inside `jpcp-cracking.ts`: the radius of relative stiffness ℓ and the Westergaard (1926) edge bending stress that feed the MEPDG fatigue calculation.
Analyses validated: jpcp-cracking · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-ANSWER validation of the LOAD-STRESS SUB-MODEL inside `jpcp-cracking.ts`: the radius of
relative stiffness ℓ and the Westergaard (1926) edge bending stress that feed the MEPDG fatigue
calculation. Every expected number is printed in a source that was opened (read 2026-10-06):
1. Pavement Interactive (2007), "Rigid Pavement Response Calculations", Examples 1 and 2
(https://pavementinteractive.org/reference-desk/design/structural-design/rigid-pavement-response-calculations/)
— ℓ and σe for 9-in and 12-in slabs; the page's step formulas are GIF images and were read from them.
2. Ioannides et al. (1985), "Westergaard Solutions Reconsidered", TRR 1043, Table 1 column WESII
(Westergaard's original edge equation, semicircular load) and Table 2 (L/ℓ for a 25-ft slab),
https://onlinepubs.trb.org/Onlinepubs/trr/1985/1043/1043-003.pdf — nine runs, k = 50/200/500 pci,
h = 12/16/20 in.
3. IRC:58-2015 Appendix VII and VIII (library copy): printed ℓ for E = 30 000 MPa, μ = 0.15.
4. Huang, Y.H. (2004), Pavement Analysis and Design, 2nd ed., Ch. 3 example, read in a lecture note that
reproduces it (Kareem, A.I. (2021), Mustansiriyah University): printed ℓ = 42.97 in.
5. Solved exam problem on ques10.com, post 34957 (P = 5100 kg, h = 18 cm …), no textbook named — the
weakest source; used for two values only.
6. AASHTO (2015), MEPDG Manual of Practice 2nd ed., §5.4.1: the allowable load repetitions N of Eq. 5-17b
are "the number of load cycles at which fatigue failure is expected (corresponding to 50 percent slab
cracking)", with Eq. 5-16 constants C4 = 1.0, C5 = −1.98. One assertion below uses that statement.
SCOPE — read before relying on the engine's headline number. The 27 published values exercise
edge_stress_mpa and radius_of_relative_stiffness_mm. The step that turns stress into damage and % slabs
cracked (Eq. 5-17b fatigue life, Eq. 5-16) is checked here only by the single 50 %-at-DI=1 statement; no
published (inputs → CRK %) example exists for this simplified Westergaard-stress model (the MOP's own
CRK comes from a finite-element neural network with curling, top-down cracking and traffic spectra).
The remaining CRK evidence is the formula-fidelity suite jpcp-cracking-web-validation.test.ts, and that
phrase is kept in this header on purpose so the validation manifest does not promote the whole engine
on the strength of a sub-model. See the report accompanying this suite for the constants-edition note
(Eq. 5-16 C4 = 1.0, C5 = −1.98 are the MEPDG v1.1 / MOP 2nd-ed. values; Pavement ME 2.3.1+ uses 0.52 / −2.17).
| Test block (the published value it checks) | Verdict |
| Pavement Interactive Examples 1 and 2: ℓ and edge stress, P = 9000 lb (a = 5.9 in), k = 200 pci, E = 5×10^6 psi | Pass |
| Ioannides et al. (1985) TRR 1043 Table 1 WESII — nine published edge stresses (E = 5×10^6 psi, P = 50 000 lb) | Pass |
| Ioannides et al. (1985) TRR 1043 Table 2 — printed L/ℓ for the 25 × 25 ft slab gives ℓ for the same nine runs | Pass |
| IRC:58-2015 Appendix VII / VIII and Huang (2004): printed radius of relative stiffness | Pass |
| Solved problem (ques10 post 34957): ℓ and edge stress in kg/cm units | Pass |
| AASHTO (2015) MOP §5.4.1: N of Eq. 5-17b is the life at 50 percent slab cracking, so DI = 1 gives CRK = 50 % | Pass |
jpcp-cracking-web-validation.test.ts
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: jpcp-cracking · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015), §5.4.2, Eqs. 5-16/5-17b/5-18, and the classical Westergaard
(1926) edge-loading solution this engine's stress model is built on. All
constants (fatigue C1=2.0, C2=1.22; 50% cracking at DI=1 via 100/(1+DI^-1.98);
the Westergaard edge stress form 0.572P/h^2 . [4.log10(l/b)+0.359]) match the
cited manual exactly (verified via pdftotext against the MEPDG 2008 manual on
disk).
As with the other MEPDG suites: every expected value below is HAND-COMPUTED
by directly applying the cited published equations end-to-end (verified
independently in Python, shown per test) — the manual publishes the
equations and their calibration constants but not a pre-published
(inputs -> CRK%) worked example for this specific model, so this is
formula-fidelity evidence (proves the engine matches the cited equations
exactly), not an independently-sourced published answer.
| Test block (the published value it checks) | Verdict |
| [1-6] base case (thick slab, light traffic): l=1055.9mm, sigma=1.4447MPa, Nf=9.975e7, DI=0.050125, CRK=0.266039% | Pass |
| [7-11] Westergaard b-branch (a < 1.724h), thinner slab + heavier traffic drives DI >> 1, CRK saturates at 100% | Pass |
| [12-16] the a >= 1.724h branch (b = a directly, not the Westergaard b formula) with a low tyre pressure over a thin slab | Pass |
| [17] N=0 gives exactly zero damage and zero cracking | Pass |
| [18] the fatigue-life exponent (C1=2.0, C2=1.22) matches Eq. 5-17b exactly at a controlled stress ratio | Pass |
| [19] stress_ratio field is sigma/MR (the inverse of the fatigue-equation ratio), consistent with edge_stress_mpa | Pass |
| [20] every load-bearing input is refused at 0 or below, never silently clamped to a tiny positive floor | Pass |
| [21] classification bands: below 5%, 5-15%, >=15% | Pass |
⚑ jpcp-faulting-published-web-validation.test.ts
PUBLISHED-VALUE validation of the two parts of `jpcp-faulting.ts` for which a published number could be found: the Westergaard (1926) loaded-corner deflection, and the effective base load-transfer efficiencies that enter the joint LTE of M…
Analyses validated: jpcp-faulting · Recorded run: passed — 2 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUE validation of the two parts of `jpcp-faulting.ts` for which a published number could be
found: the Westergaard (1926) loaded-corner deflection, and the effective base load-transfer efficiencies
that enter the joint LTE of MOP Eq. 5-22. Sources opened (read 2026-10-06):
1. Huang, Y.H. (2004), Pavement Analysis and Design, 2nd ed., Ch. 3 corner-loading example
(k = 100 pci, h = 10 in, a = 6 in, P = 10 000 lb, E = 4×10^6 psi, μ = 0.15): δc = 0.0502 in from
δc = P/(kℓ²)·[1.1 − 0.88·a√2/ℓ]. Read in two university lecture notes that reproduce it and name
Huang (2004) as their textbook — Kareem, A.I. (2021), Rigid Pavement, Mustansiriyah University
(https://uomustansiriyah.edu.iq/media/lectures/5/5_2021_01_21!07_53_08_AM.pdf) and Jasim, A.F. (2020),
Stresses in Rigid Pavement, same university (…/5_2020_04_04!12_26_54_PM.pdf). Both print 0.0502 in; the
example number is the lecture notes' own and was not checked against the book.
2. AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed., Table 5-3
"Assumed Effective Base LTE for Different Base Types": aggregate base 20 %, ATB or CTB 30 %, lean
concrete base 40 % (library copy, p. 59).
SCOPE — SHORTFALL, stated plainly. Only FOUR published numbers were found for this engine (one deflection,
three table entries). The engine's remaining outputs — the joint LTE combination (Eq. 5-22), the
differential energy DE (Eq. 5-23a) and the curling faulting potential FAULTMAX0 (Eq. 5-20d) — have no
published inputs → output example anywhere that was found; they remain formula-fidelity evidence
(jpcp-faulting-web-validation.test.ts). That phrase is kept here deliberately so the validation
manifest does not promote the engine on four values.
UNRESOLVED (recorded, not asserted): Eq. 5-20d writes "Log" with no base. The engine uses log10. A 2015
conference paper that reproduces Pavement ME's FAULTMAX0 outside the software writes the same factors as
natural logs (Haider, S.W., Brink, W., Buch, N. & Khazanovich, L. (2015), ICCP), which would raise
FAULTMAX0 by (ln 10)^0.8 ≈ 1.95. No published FAULTMAX0 with its inputs was found to arbitrate.
| Test block (the published value it checks) | Verdict |
| Huang (2004) Ch. 3 corner example: δc = 0.0502 in | Pass |
| AASHTO (2015) MOP Table 5-3: effective base LTE 20 / 30 / 40 % (no dowels, no aggregate interlock → joint LTE = base LTE) | Pass |
jpcp-faulting-web-validation.test.ts
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: jpcp-faulting · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015), §5.4.1, Eqs. 5-20d/5-22/5-23a, plus the classical Westergaard
(1926) corner-loading solution the differential-energy term is built on.
Constants (C1=1.0184, C2=0.91656, C5=250, C6=0.4) match the cited manual
exactly (verified via pdftotext). Every expected value below is HAND-COMPUTED
by directly applying these cited equations end-to-end (verified
independently in Python) — formula-fidelity evidence, not an independently-
published worked example (MEPDG's manual does not carry one for this
specific mechanistic-driver sub-model; the full accumulated-faulting number
needs the proprietary neural network, which this engine deliberately does
not attempt to reproduce — see the engine's own header).
| Test block (the published value it checks) | Verdict |
| [1-6] base case (no dowels, aggregate base): LTE=52%, dL=0.044304 in, dUL=0.023038 in, DE=0.079135 lb/in, FAULTMAX0=0.126277 in | Pass |
| [7-9] dowel LTE=90% raises the joint LTE to 95.2% and cuts dUL/DE sharply (Eq. 5-22) | Pass |
| [10] lean-concrete base (LTE_base=40 vs 20 for aggregate) raises joint LTE to 64% at the same dowel/agg LTE | Pass |
| [11] loaded corner deflection dL is identical across base types and dowel LTE (Westergaard geometry is unaffected by LTE) | Pass |
| [12] no fines to erode (pct_passing_200 = 0) gives FAULTMAX0 = 0 by definition, with a warning | Pass |
| [13] no curling deflection (dcurl = 0) gives FAULTMAX0 = 0 by construction | Pass |
| [14] the Westergaard corner-ratio range guard refuses geometries outside a*sqrt(2)/l < 1.25 | Pass |
| [15] joint LTE formula (Eq. 5-22) matches the compound-probability form exactly for arbitrary dowel/agg/base values | Pass |
| [16] every load-bearing input is refused at 0 or below | Pass |
jpcp-iri-published-web-validation.test.ts
PUBLISHED-COEFFICIENT cross-check of the MEPDG JPCP smoothness model (`jpcp-iri.ts`, IRI = IRI0 + C1·CRK + C2·SPALL + C3·TFAULT + C4·SF).
Analyses validated: jpcp-iri · Recorded run: passed — 2 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-COEFFICIENT cross-check of the MEPDG JPCP smoothness model (`jpcp-iri.ts`,
IRI = IRI0 + C1·CRK + C2·SPALL + C3·TFAULT + C4·SF). This is NOT a published-answer suite: no document was
found that prints a complete (IRI0, CRK, SPALL, TFAULT, AGE, FI, P200) → IRI example for this model, so the
model's outputs have no independent published answer to be checked against. What was found is the SAME
model written in METRIC units, which lets the four coefficients be confirmed from a second source:
1. Hall, K.T. (2008), "Prediction of Spalling and Roughness in the Mechanistic-Empirical Pavement Design
Guide", 9th International Conference on Concrete Pavements, San Francisco, Eq. 6 (quoting MEPDG
Appendix PP Eq. 20 with a typographical error corrected):
IRI[m/km] = IRI0 + 0.013·TC + 0.007·SPALL + 0.005·PATCH + 0.0015·TFAULT[mm/km] + 0.4·SF
with TC in % slabs, SPALL in % joints, SF = AGE·(1 + FI)·(1 + P200)/10^6 (Hall's Eq. 7, FI in °C-days;
the exponent-free form is read from the extracted text). PATCH is not in the engine. Read 2026-10-06 at
https://exa.ai/library/publication/168yvlbtpb9 (the paper's text).
2. AASHTO (2015), MEPDG Manual of Practice 2nd ed., Eq. 5-32a/b (library copy): C1 = 0.8203, C2 = 0.4417,
C3 = 1.4929, C4 = 25.24, SF = AGE(1 + 0.5556·FI)(1 + P200)·10^-6, FI in °F-days. The MOP 3rd-edition
errata (Eq. 5-43a/b) prints the same values.
3. The 2008 interim MOP (library copy) and NCHRP 1-40D (2007) print C3 = 0.4929 — a misprint; the
metric form above independently gives C3 ≈ 1.50 and so settles which is right.
Unit conversion (exact factors): 1 m/km = 63.36 in/mi; 1 in/mi = 15.7828 mm/km; and FI[°F·d] = 1.8·FI[°C·d],
so 1 + 0.5556·FI_F = 1 + FI_C (0.5556 × 1.8 = 1.0000).
Tolerances are half a unit of the last printed digit of the METRIC coefficient, converted: Hall prints
0.013, 0.007 (±0.0005), 0.0015 (±0.00005) and 0.4 (±0.05). The C4 tolerance is therefore wide and
proves little; the useful discrimination is C3 (1.4929 against the misprinted 0.4929).
SCOPE — SHORTFALL: four coefficient confirmations and one misprint rejection, zero published answers. The
engine stays formula-fidelity evidence (jpcp-iri-web-validation.test.ts); that phrase is kept here on
purpose so the validation manifest does not promote it.
| Test block (the published value it checks) | Verdict |
| Hall (2008) metric form of the MEPDG JPCP IRI model confirms the engine coefficients C1, C2, C3, C4 | Pass |
| The misprinted C3 = 0.4929 of the 2008 interim MOP is rejected by the metric form | Pass |
jpcp-iri-web-validation.test.ts
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: jpcp-iri · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015), §5.4.4, Eqs. 5-32a/5-32b — the EXACT published JPCP smoothness
(IRI) transfer function (source PDF on disk, verified via pdftotext: the
extracted text carries C1=0.8203, C2=0.4417, C3(=1.4929, garbled in OCR as
"0.4929" mid-fragment), C4=25.24, and the SF = AGE(1+0.5556·FI)(1+P200)·1e-6
site-factor form, matching this engine exactly).
IRI = IRI0 + C1.CRK + C2.SPALL + C3.TFAULT + C4.SF
SF = AGE . (1 + 0.5556.FI) . (1 + P200) . 1e-6
This is a linear combination of its inputs plus one multiplicative site-factor
term -- fully closed-form and exactly hand-computable to machine precision.
Every expected value below is computed directly from the cited published
equation (verified independently in Python); MEPDG's manual does not carry a
pre-published (IRI0, CRK, SPALL, TFAULT, AGE, FI, P200) -> IRI worked example
for this specific transfer function, so as with the other MEPDG suites this
is formula-fidelity evidence, not an independently-sourced published answer.
| Test block (the published value it checks) | Verdict |
| [1-6] no freeze climate (FI=0): SF=9e-5, contributions crk=8.203 spall=2.2085 fault=4.4787 sf=0.00227, IRI=77.892472 in/mi | Pass |
| [7-9] freeze-thaw climate (FI=1500) raises the site factor and IRI to 79.785623 in/mi | Pass |
| [10-11] zero distress at age 0 returns exactly the initial IRI (63 in/mi) | Pass |
| [12-13] aged, more distressed case: SF=0.089216, IRI=110.018012 in/mi | Pass |
| [14] unit conversion in/mi -> m/km is exact (x0.0157828) | Pass |
| [15] IRI0 is refused at 0 or below — it is the dominant term, no pavement is built at IRI0=0 | Pass |
| [16] each distress coefficient matches its published constant exactly, isolated one at a time | Pass |
| [17] ride-quality classification bands (good <95, fair <170, mediocre <220, else poor) | Pass |
jpcp-spalling-published-web-validation.test.ts
PUBLISHED-VALUES: 12 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: 12 chart readings; 23 further values are cross-checks against Hoerner Eq.
Analyses validated: jpcp-spalling · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 12 -- distinct published values for this engine (engine-level total, declared once); independent audit A1: 12 chart readings; 23 further values are cross-checks against Hoerner Eq. 97, which the engine implements. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
PUBLISHED-ANSWER validation of the MEPDG JPCP joint-spalling model (`jpcp-spalling.ts`,
SPALL = [AGE/(AGE+0.01)]·100/(1+1.005^(−12·AGE+SCF)), MOP Eq. 5-33a/b). The expected numbers are
CHART READINGS and quoted results from published documents that were opened (read 2026-10-06):
1. Hoerner et al. (2000), Improved Performance Prediction Models for PCC Pavement Performance
Specifications, FHWA-RD-00-130 (https://www.fhwa.dot.gov/publications/research/infrastructure/
pavements/pccp/pavespec/00130.pdf). Its Eq. 97/98 is the same spalling model, and Figures 38–43
(report pp. 134–138, PDF pp. 150–154) plot the model's output against age for stated inputs. The 24
values below were READ BY EYE from 200–300 dpi renderings of those figures. Figs 39–43 were read
before the engine was ever run on their inputs; for Fig. 38 the engine's values at a few ages had
been printed once before the figure was re-read on a 300 dpi crop, so that figure is the least
blind of the six (its readings agree with the chart at the resolution of the markers). Reading
uncertainty: the y-axis is 0–100 % with 10 % gridlines ≈ 65–98 px apart and the plotted markers
are ≈ 5–8 px, so a reading is good to about ±0.5 percentage points; the tolerance used is ±1.0
point, i.e. twice the reading uncertainty and not a fit to the engine.
2. Hall, K.T. (2008), "Prediction of Spalling and Roughness in the Mechanistic-Empirical Pavement Design
Guide", 9th International Conference on Concrete Pavements, San Francisco, pp. 134–152. Hall ran the
MEPDG SOFTWARE on a 10-in JPCP (w/c 0.5, 650 psi flexural strength, Columbus OH, 51 F-T cycles/yr) and
states two results used here: a 1 % change in air content moves the age at 50 % spalling by "about
8 years", and a preformed sealant gives "essentially no spalling" over 60 years. She also confirms the
software codes the SCF term as 43.4·f'c^0.4 (the 2008 interim MOP misprints it 3.4), which is what
the engine uses.
3. AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed., Eq. 5-33a/b
(library copy): same equation and constants; model statistics R² = 78 %, SEE = 6.8 %, N = 179. The
3rd-edition errata (Eq. 5-43c/d) prints it unchanged.
Inputs for every Hoerner et al. figure: 28-day f'c = 5000 psi, 80 freeze-thaw cycles/yr, PCC 10 in,
w/c 0.44, non-preformed sealant, air 6 % unless the figure varies that quantity.
SCOPE: the figures were produced by the PRS report's own implementation of the same equation, so they
prove the engine reproduces the published curves (units, exponents, every term's sign and size), not that
the equation describes a particular road. The engine's inference range is the PRS data range (age
2–28 yr, air 3.8–9.8 %, h 6–14.3 in); Hall warns ages beyond ~28 yr are extrapolation.
| Test block (the published value it checks) | Verdict |
| Hoerner et al. (2000) Fig. 38 — air content 2 / 4 / 6 / 8 % (f'c 5000 psi, 80 F-T/yr, 10 in, w/c 0.44) | Pass |
| Hoerner et al. (2000) Fig. 39 — 28-day compressive strength 2500 / 5000 / 7500 psi (air 6 %) | Pass |
| Hoerner et al. (2000) Fig. 40 — joint sealant: preformed vs non-preformed | Pass |
| Hoerner et al. (2000) Fig. 41 — slab thickness 8 / 10 / 12 in | Pass |
| Hoerner et al. (2000) Fig. 42 — annual freeze-thaw cycles 0 / 40 / 80 / 120 / 160 | Pass |
| Hoerner et al. (2000) Fig. 43 — water/cement ratio 0.38 / 0.44 / 0.50 | Pass |
| Hall (2008): each 1 % of air content shifts the age at 50 % spalling by "about 8 years"; preformed sealant gives essentially none over 60 years | Pass |
jpcp-spalling-web-validation.test.ts
Formula-fidelity validation against the AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: jpcp-spalling · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against the AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015), §5.4.3, Eqs. 5-33a/5-33b — the exact published joint-spalling
model (source PDF on disk: AASHTO-MEPDG-2008-Mechanistic-Empirical-Pavement-
Design-Guide-Manual-of-Practice-Interim.pdf, verified via pdftotext to carry
the identical equation and calibration constants this engine implements).
IMPORTANT — what kind of validation this is. AASHTO's own manual defines the
SPALL/SCF equations and their national calibration constants but does not
publish a worked numeric example (a specific input set with a specific
published answer) for this particular sub-model; that pairing only exists
inside the MEPDG/DARWin-ME software's example project files, which are not
in this library. So every expected value below is HAND-COMPUTED by applying
the cited published formula and its published constants directly (verified
independently in Python, shown in the comment above each case) — not an
independently-published "book answer". This is still a legitimate defence of
correctness (it proves the engine implements the cited equation exactly, not
an approximation or a transcription error), but it is a different kind of
evidence than a textbook worked example, and is labelled as such per the
founder's "never invent a number" rule: nothing here is invented, everything
traces to the published equation, but the "expected" values are derived, not
independently pre-published.
SCF = -1400 + 350*ACPCC*(0.5+PREFORM) + 43.4*fc_psi^0.4 - 0.2*(FT*AGE) + 43*Hin - 536*WC
SPALL = [AGE/(AGE+0.01)] * [100 / (1 + 1.005^(-12*AGE + SCF))]
| Test block (the published value it checks) | Verdict |
| [1-2] AGE=5, no sealant, AC=4%, fc=20MPa, FT=80, H=200mm, WC=0.55 -> SCF=316.9420, SPALL=21.685974% | Pass |
| [3-4] AGE=10, same mix -> SCF=236.9420, SPALL=35.782654% | Pass |
| [5-6] AGE=15 (base case) -> SCF=156.9420, SPALL=52.836675% | Pass |
| [7-8] AGE=20, same mix -> SCF=76.9420, SPALL=69.245718% | Pass |
| [9-10] AGE=25, same mix -> SCF=-3.0580, SPALL=81.895792% | Pass |
| [11-12] AGE=30, same mix -> SCF=-83.0580, SPALL=90.082316% | Pass |
| [13-14] preformed joint sealant at AGE=15 -> SCF=1556.9420, SPALL=0.103924% | Pass |
| [15] preformed sealant sharply reduces spalling vs no sealant, same age | Pass |
| [16-19] PCC air content sweep at AGE=15: 2%,4%,6%,8% -> 86.479524%, 52.836675%, 16.363403%, 3.302315% | Pass |
| [20-23] water/cement ratio sweep at AGE=15: 0.35,0.45,0.55,0.65 -> 39.633344%, 46.168327%, 52.836675%, 59.404008% | Pass |
| [24-27] slab thickness sweep at AGE=15: 150,200,250,300 mm -> 63.073483%, 52.836675%, 42.352301%, 32.512173% | Pass |
| [28-31] compressive strength sweep at AGE=15: 15,20,28,35 MPa -> 66.462497%, 52.836675%, 34.462553%, 23.082675% | Pass |
| [32-35] freeze-thaw cycles sweep at AGE=15: 0,40,80,150 -> 25.295769%, 38.117131%, 52.836675%, 76.125854% | Pass |
| [36] AGE=0 forces SPALL=0 exactly regardless of SCF (age-factor term AGE/(AGE+0.01)=0) | Pass |
⚑ jpcp-time-stepping-published-web-validation.test.ts
PUBLISHED-ANSWER validation of the stress sub-model inside the JPCP time-stepping driver (`jpcp-time-stepping.ts`): the Westergaard (1926) load edge stress σ_L, the radius of relative stiffness ℓ, and the Bradbury (1938) edge curling stres…
Analyses validated: jpcp-time-stepping · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-ANSWER validation of the stress sub-model inside the JPCP time-stepping driver
(`jpcp-time-stepping.ts`): the Westergaard (1926) load edge stress σ_L, the radius of relative stiffness ℓ,
and the Bradbury (1938) edge curling stress σ_C = C·E·α·ΔT/2 that the monthly loop adds to it. Every
expected number is printed in a source that was opened (read 2026-10-06):
1. Pavement Interactive (2007), "Rigid Pavement Response Calculations" — Examples 1 and 2 (ℓ, σe) and the
"Curling Stress Example Calculation" (edge warping stress 230 psi, Bradbury coefficient C = 0.68 read
from the Bradbury chart at B/ℓ = 4.8; formulas are GIF images on the page and were read from them):
https://pavementinteractive.org/reference-desk/design/structural-design/rigid-pavement-response-calculations/
2. Ioannides et al. (1985), "Westergaard Solutions Reconsidered", TRR 1043, Table 1 (WESII, edge stress)
and Table 2 (L/ℓ), https://onlinepubs.trb.org/Onlinepubs/trr/1985/1043/1043-003.pdf
3. IRC:58-2015 Appendix VII / VIII (library copy): printed ℓ for E = 30 000 MPa, μ = 0.15.
4. Huang, Y.H. (2004), Pavement Analysis and Design, 2nd ed., Ch. 3 example as reproduced in a university
lecture note (Kareem, A.I. (2021), Mustansiriyah University): ℓ = 42.97 in.
5. A solved exam problem on ques10.com post 34957 (no textbook named; weakest source, two values).
SCOPE. The published values exercise load_edge_stress_mpa, radius_of_relative_stiffness_mm and the curling
term of peak_combined_stress_mpa. They do NOT validate the monthly accumulation, the fixed 35 % daytime
traffic fraction, the default seasonal gradient table, the Miner sum or the resulting % cracked: those are
this driver's own simplification of the MEPDG procedure and no published (inputs → % cracked) example exists
for it. That part stays formula-fidelity evidence (jpcp-time-stepping-web-validation.test.ts ties the
driver to jpcp-cracking); the phrase is kept here on purpose so the validation manifest does not promote
the whole driver on a sub-model.
OBSERVATION (not asserted as a defect): the driver fixes the Bradbury coefficient at C = 1 ("large slab").
The Pavement Interactive example finds C = 0.68 for a 14-ft slab on this foundation (B/ℓ = 4.8), so for
that joint spacing the driver's curling stress is 1/0.68 ≈ 1.47 times the Bradbury value — conservative.
| Test block (the published value it checks) | Verdict |
| Pavement Interactive Examples 1 and 2: ℓ and load edge stress | Pass |
| Pavement Interactive curling example: Bradbury edge warping stress 230 psi at C = 0.68 | Pass |
| Ioannides et al. (1985) TRR 1043 Table 1 WESII — nine published edge stresses (E = 5×10^6 psi, P = 50 000 lb) | Pass |
| Ioannides et al. (1985) TRR 1043 Table 2 — printed L/ℓ (L = 300 in) gives ℓ for the same nine runs | Pass |
| IRC:58-2015, Huang (2004) and the solved problem: printed radius of relative stiffness and edge stress | Pass |
jpcp-time-stepping-web-validation.test.ts
Validation against AASHTO MEPDG Manual of Practice §5 (rigid distress) and Bradbury (1938) curling stress, via the engine's OWN documented self-check invariant (stated in its header): "with DeltaT = 0 every month...
Analyses validated: jpcp-cracking, jpcp-time-stepping · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation against AASHTO MEPDG Manual of Practice §5 (rigid distress) and
Bradbury (1938) curling stress, via the engine's OWN documented self-check
invariant (stated in its header): "with DeltaT = 0 every month... the
accumulated DI EQUALS the single-pass jpcp-cracking DI." That is directly
verifiable against jpcp-cracking.ts, which is itself independently
validated against the exact Westergaard closed-form (see jpcp-cracking-
web-validation.test.ts) -- so this suite ties the monthly time-stepping
driver back to a formula-fidelity-verified engine rather than re-deriving
the 12/240-month accumulation loop by hand.
| Test block (the published value it checks) | Verdict |
| [1-2] SELF-CHECK INVARIANT (stated in the engine's own header): with zero monthly curling gradient, the accumulated damage exactly equals the single-pass jpcp-cracking engine's damage at the same total load | Pass |
| [3] the load-only edge stress reported by the time-stepping driver matches the Westergaard closed-form exactly (same formula as jpcp-cracking) | Pass |
| [4] adding a positive curling gradient can only INCREASE the peak combined stress above the load-only stress (Bradbury: curling adds to the bottom tensile stress in the critical direction) | Pass |
| [5] the accumulated damage is INVARIANT to the design life when the traffic is a fixed TOTAL (spreading the same total over more months does not add or remove traffic), per the engine's own documented E-110 note | Pass |
| [6] applications_per_month equals total_load_applications / (years*12) exactly | Pass |
| [7] the cracking curve is monotonically non-decreasing over time (damage only accumulates) | Pass |
| [8] faulting is explicitly flagged as NOT accumulated (the driver covers cracking only, per its own documented scope) | Pass |
| [9] invalid inputs (zero modulus, thickness, MR, or k) are refused | Pass |
⚑ layered-elastic-pavement-published-web-validation.test.ts
MULTILAYER (BURMISTER) ELASTIC PAVEMENT RESPONSE — `computeLayeredElastic` / `subgradeStrainAtOffset` checked against PUBLISHED PROGRAM OUTPUT and a PUBLISHED TABLE.
Analyses validated: layered-elastic-pavement · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
MULTILAYER (BURMISTER) ELASTIC PAVEMENT RESPONSE — `computeLayeredElastic` / `subgradeStrainAtOffset`
checked against PUBLISHED PROGRAM OUTPUT and a PUBLISHED TABLE.
The earlier suite of this engine (`layered-elastic-pavement-web-validation.test.ts`) proves the solver reduces
to the Boussinesq closed form for ONE homogeneous layer and otherwise asserts only trends (stiffer → less
strain). It never compared a genuinely layered result with a number somebody else computed and printed. This
file does, against two independent published documents, all opened and read on 2026-10-06:
IRC:37-2018 (Indian Roads Congress, "Guidelines for the Design of Flexible Pavements", 4th revision, local
reference-library PDF) — the output of the IRC's own layered-elastic program IITPAVE, printed three ways:
Annex I Figure I.3 full IITPAVE output page for a 3-layer dual-wheel case (image, read at 300 dpi)
Annex II Example II.1 two-layer surface deflection, single 40 kN wheel
Example II.2 / Figure II.3 two-layer subgrade strain (image echo of the inputs is used)
Example II.3 / Figure II.4 three-layer dual-wheel case (image)
Annex III Tables III.1, III.2, III.4, III.5, III.6 governing subgrade compressive strain for 23
thickness/stiffness combinations of 4-, 5- and 6-layer sections (CBR 10 % subgrade, 77 MPa)
Das, B.M. (2016), Principles of Foundation Engineering, 8th ed., Cengage — Table 6.1 (p. 266), the
published variation of Δσ/q0 under the centre of a uniformly loaded flexible circular area, which is the
Ahlvin–Ulery solution for a homogeneous half-space. Reproduced here THROUGH THE LAYERED CODE PATH (two
identical layers, so interface continuity must give back the half-space), which the earlier suite did not.
HOW IITPAVE'S DUAL-WHEEL NUMBERS ARE REPRODUCED. IITPAVE superposes two identical circular loads 310 mm
centre-to-centre (IRC:37-2018 Annex I §I.3(i)), each 20 000 N at 0.56 MPa (contact radius
a = √(20 000 / (π·0.56)) = 106.6 mm), and reports the strain at radial distances 0 (under one wheel) and 155 mm
(midway). The engine's single-wheel off-axis vertical strain `subgradeStrainAtOffset` is superposed the same
way: ε(r = 0) = ε₁(0) + ε₁(310) and ε(r = 155) = 2·ε₁(155). Vertical strain is a scalar component, so it adds
directly. The horizontal strain at the bottom of the asphalt is NOT compared: the engine evaluates it on the
load axis only, so the second wheel's contribution cannot be formed — those IITPAVE columns are left alone
rather than approximated.
TOLERANCE. 1 % for every IITPAVE comparison. It is NOT derived from the sources' print rounding alone (which
is ≤ 0.2 % for the 3- and 4-significant-figure values used): IITPAVE is a numerical-integration program of
unpublished accuracy and two correct implementations of Burmister theory are not bit-identical. The observed
agreement is tighter and is recorded here so the margin is visible: over the 6 position-resolved IITPAVE
screen values the engine is 0.1–0.5 % high (+0.12…+0.14 % at r = 155 mm, +0.25…+0.51 % at r = 0, the largest
being Figure I.3), and over the
23 Annex III values −0.1…+0.3 %. The Das table is printed to 3 decimals and is held to half a unit, ±0.0005;
two of its 16 entries fall outside that against the book's own Equation (6.3) and are excluded (see the test).
SOURCE INCONSISTENCIES, recorded instead of hidden:
· Example II.2's text gives the granular sub-base modulus as 119 MPa, but the IITPAVE screen it prints
(Figure II.3) echoes 95.00 MPa for a 250 mm layer, and the boxed 2179 µε sits at r = 155 mm. The engine
reproduces the SCREEN (2181.7 at r = 155 mm, 2327.9 at r = 0 against 2179 / 2322); it does not reproduce
2179 at the text's 119 MPa and r = 155 mm (2062.6). The screen's own inputs are used.
· Example II.3's text quotes 0.000243; its Figure II.4 prints 0.2443E-03 at r = 155 mm. The figure is used.
· Figure I.3 prints 0.1920E-03 at r = 0 whereas the paragraph below it says 0.000193. The engine gives 193.0
and the figure is used (0.5 % apart, inside the 1 % band); the paragraph value is not asserted.
· Figure I.3's epR column shows "0.6056E-06" where the paragraph quotes 0.00006056 (= E-04). Not used.
| Test block (the published value it checks) | Verdict |
| IRC:37-2018 Example II.1 — 500 mm of 119.7 MPa over a 66.6 MPa half-space, 40 kN wheel: surface deflection 1.41 mm | Pass |
| IRC:37-2018 Example II.1 — the equivalent single-layer modulus 2(1−ν²)pa/δ = 105.10 MPa | Pass |
| IRC:37-2018 Figure I.3 — 3000 / 450 / 75 MPa, 140 + 500 mm, dual wheel: top-of-subgrade εz 192.0 µε (r 0) and 205.3 µε (r 155) | Pass |
| IRC:37-2018 Example II.2 / Figure II.3 — 95 MPa sub-base, 250 mm, over 50 MPa: εz 2322 µε (r 0), 2179 µε (r 155) | Pass |
| IRC:37-2018 Example II.2 — the 150 mm trial (sub-base 0.2·150^0.45·50 = 95 MPa) gives 4324 µε | Pass |
| IRC:37-2018 Example II.3 / Figure II.4 — 3000 / 200 / 62 MPa, 190 + 480 mm, dual wheel: εz 231.2 µε (r 0), 244.3 µε (r 155) | Pass |
| IRC:37-2018 Table III.1 — bituminous + granular base/sub-base (granular modulus printed per row): 6 subgrade strains | Pass |
| IRC:37-2018 Table III.6 — bituminous + 150 mm WMM + 200 mm CTSB: 5 subgrade strains | Pass |
| IRC:37-2018 Table III.2 — bituminous + 100 mm crack-relief layer + CTB + 200 mm CTSB: 3 subgrade strains | Pass |
| IRC:37-2018 Table III.4 — bituminous + 100 mm stabilised RAP (800 MPa) + 200 mm CTSB: 3 subgrade strains | Pass |
| IRC:37-2018 Table III.5 — bituminous + 100 mm crack-relief + CTB + 200 mm GSB (167 MPa): 6 subgrade strains | Pass |
| Das (2016) Table 6.1 — Δσ/q0 on the axis for 14 of the 16 printed depths between 0.1 and 4.0 (half-space values) | Pass |
layered-elastic-pavement-web-validation.test.ts
Validation against the classical Boussinesq (1885) closed-form solution for a uniform circular flexible load on a HOMOGENEOUS elastic half-space -- the exact analytical limit this multilayer Burmister solver reduces to when given a single…
Analyses validated: layered-elastic-pavement · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation against the classical Boussinesq (1885) closed-form solution for
a uniform circular flexible load on a HOMOGENEOUS elastic half-space --
the exact analytical limit this multilayer Burmister solver reduces to
when given a single layer, per the module's own documented claim ("reduces
to the EXACT Boussinesq closed-forms... to 1e-13 (sigma_z, strain) / 1e-9
(deflection)"). Source: Huang, "Pavement Analysis and Design" 2nd ed. Ch.2;
Boussinesq (1885); Poulos & Davis, "Elastic Solutions for Soil and Rock
Mechanics" (1974).
Surface deflection under a flexible circular load (z=0, r=0):
w0 = 2.q.a.(1-nu^2)/E
Surface (z=0) stresses under the load centre:
sigma_z = q, sigma_r = sigma_t = q.(1+2.nu)/2
Surface radial (tensile) strain:
eps_r = [sigma_r - nu.(sigma_z+sigma_r)]/E
These surface (z=0) values are hand-verified exactly (to 1e-6 relative)
against the closed-form below. The engine's OWN depth-profile behaviour
away from z=0 needs the full Ahlvin-Ulery on-axis influence factors, which
this suite does not attempt to re-derive by hand (real risk of getting a
subtly wrong "expected" value and asserting it as ground truth) -- those
are checked instead by documented, citable PHYSICAL PROPERTIES: the
boundary condition sigma_z(0)=q, monotone-decaying deflection away from
the load, and cross-consistency between the two exported entry points
(computeLayeredElastic and subgradeInteriorStrains) at z=0.
| Test block (the published value it checks) | Verdict |
| [1] surface deflection matches the exact Boussinesq closed-form w0 = 2qa(1-nu^2)/E to 1e-6 relative | Pass |
| [2] subgrade vertical stress at the surface equals the applied pressure q exactly (sigma_z(0)=q boundary condition) | Pass |
| [3] tensile (radial) strain at the surface matches the exact Boussinesq closed-form to 1e-6 relative | Pass |
| [4] vertical strain via computeLayeredElastic and via subgradeInteriorStrains agree at z=0 (cross-consistency of the two entry points) | Pass |
| [5] deflection decays monotonically with layer stiffness (stiffer subgrade -> less deflection), the expected physical trend | Pass |
| [6] a real 3-layer pavement (AC/base/subgrade) gives a physically ordered response: deflection under the load exceeds zero, AC tensile strain and subgrade vertical strain are both positive and finite | Pass |
| [7] a stiffer asphalt layer reduces the tensile strain at its own bottom (the classic M-E design lever) | Pass |
| [8] multi-wheel gear superposition: a single wheel matches computeLayeredElastic's subgrade strain exactly, and adding wheels never decreases the max (elastic superposition can only add) | Pass |
| [9] gear amplification factor equals max gear strain divided by the single-wheel strain, exactly as defined | Pass |
mepdg-ac-rutting-web-validation.test.ts
Validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: mepdg-ac-rutting · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation against AASHTO MEPDG "A Manual of Practice" 2nd ed. (2015)
§5.3.2, Eq. 5-1a-d (source PDF on disk, verified via pdftotext) for the
incremental, climate-integrated AC rutting model.
STATUS (2026-10-07): formula-fidelity evidence ONLY - 0 published ANSWERS. I searched the MOP 2nd ed., the NCHRP
1-40D manual, NCHRP 1-37A Appendix GG-1 (every table and figure caption), the NCDOT and Ohio calibration reports,
FHWA-HRT-17-104 and NHI-05-037 for a response-independent (eps_r, T, N, kz, h) -> eps_p / rut answer, or a tabulated
kz(D, H) value, and found none: the sources print the equations, the global coefficients (k1 = -3.35412, k2 = 1.5606
on T, k3 = 0.4791 on n - MOP Table i-1; the MOP's own where-list for Eq. 5-1a transposes k2r/k3r) and whole-section
rut results that also depend on each programme's own layered-elastic and climate code. Those section results
cannot be reproduced by this engine's simplified sinusoidal climate, so citing them would be invented agreement.
The release bar (20 published answers, 2 sources) is therefore not met; the gap is 20 and is NOT padded.
TWO KINDS OF EVIDENCE, kept separate:
(a) The seasonal modulus-temperature law E=Eref.10^(susc.(Tref-T)) and the
beta1r field-calibration factor's exact LINEARITY (Eq. 5-1a is a
direct multiplicative product in beta1r) are pure closed-form and
HAND-COMPUTED exactly (verified independently in Python).
(b) The full incremental rut accumulation also depends on the package's
Burmister layered-elastic solver run month-by-month -- already
exercised by its own dedicated tests. Re-deriving that by hand risks
a subtly wrong "expected" number, so the accumulation itself is
checked by documented PROPERTIES: monotone in traffic and in
temperature, zero at N=0 or Hac=0 (real limits, not silent floors).
| Test block (the published value it checks) | Verdict |
| [1-2] the seasonal modulus-temperature law E=Eref.10^(susc.(Tref-T)) matches exactly at the default climate: summer E=865.209451 MPa, winter E=10402.105514 MPa | Pass |
| [3] the modulus law is symmetric about Tref=Tmean: shifting Tref by +5C at fixed climate shifts both summer/winter E by exactly 10^(susc.5) | Pass |
| [4-5] beta_r1 (field-calibration factor) scales the rut EXACTLY linearly, per Eq. 5-1a's direct multiplicative form | Pass |
| [6] monotone increasing in cumulative traffic N | Pass |
| [7] monotone increasing in mean pavement temperature (hotter asphalt is softer -> more rut) | Pass |
| [8] zero AC thickness gives exactly zero rut, labelled definitional (an unsurfaced road, not a durable pavement) | Pass |
| [9] zero load applications gives exactly zero rut, labelled definitional (never exercised, not adequate) | Pass |
| [10] mm/in conversion is exact (x25.4) | Pass |
| [11] negative thickness or negative traffic is refused, never read as "no asphalt" | Pass |
| [12] the strain-hardening term telescopes: rut(N1)/rut(N2) = (N1/N2)^0.4791 EXACTLY, whatever the life or climate (Eq. 5-1a, k3 = 0.4791) | Pass |
mepdg-fatigue-published-web-validation.test.ts
MEPDG bottom-up fatigue (alligator) cracking - checks against PUBLISHED values only.
Analyses validated: mepdg-fatigue · Recorded run: passed — 16 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
MEPDG bottom-up fatigue (alligator) cracking - checks against PUBLISHED values only.
STATUS: PARTIAL - 12 of 20. Twelve distinct published facts: four from the first pass (50 % at 100 % damage, the
100 % plateau, ~0 at low damage, "C = 1" at Va 5 % / Vb 11 %) plus the eight thickness-group shift factors of
NCHRP 1-37A Appendix II-1 Table 7 added 2026-10-07. The release bar is 20 published values; the shortfall (8) is
real and is NOT padded. I
could not find any document that prints (strain, |E*|, Hac, Va, Vbe, N) -> (Nf, damage, % cracking) for a
real section: the manual prints the equations and the global-calibration scatter plots, and the
calibration reports print their own re-fitted coefficients. The sibling suite
mepdg-fatigue-web-validation.test.ts is formula-fidelity evidence. This header says so deliberately:
it keeps the generated validation manifest from promoting the engine to "reference-backed" on these
published checks plus the sibling's formula-fidelity calls. Remove that sentence only when the
published-value count reaches 20.
PUBLISHED SOURCES (each opened and read for this suite, 2026-10-06):
AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed.
- Eq. 5-6a/b/c (printed p. 44, PDF p. 57): FCbottom = (1/60) C4 / (1 + exp(C1 C1* + C2 C2* log10(100 DI))),
C4 = 6,000, C1 = C2 = 1.00, C1* = -2 C2*, C2* = -2.40874 - 39.748 (1 + Hac)^-2.856.
- Figure 5-3 (same page): the plotted damage -> alligator-cracking curve crosses 50 % at
"Log Damage (%)" = 2, i.e. at 100 % damage (DI = 1); it is ~0 at Log Damage <= -1 and rises to the
upper plateau C4/60 = 100 %.
Kim, Y.R. & Jadoun, F.M. & Hou, T. & Muthadi, N. (2011), Local Calibration of the MEPDG for Flexible
Pavement Design, NCDOT research project HWY-2007-07 (FHWA/NC/2007-07), North Carolina State
University, Sec. 8.6.4.2.2 (printed pp. 179-180): "...the sigmoidal function assumption, which is that
50% of alligator cracking occurs at 100% fatigue damage (NCHRP, 2004d)."
NCHRP 1-37A (2004), Guide for Mechanistic-Empirical Design of New and Rehabilitated Pavement Structures,
Appendix II-1 "Calibration of Fatigue Cracking Models for Flexible Pavements" (downloaded from
https://content.aashtowarepavementme.org/Documents/1-37A/2appendices_II.pdf , 2026-10-07):
- Table 7 (printed p. 48) "Minimum and Maximum Damage (%) by AC Thickness", column "Shift Factor" - the value
the authors found by hand for each thickness group so that 50 % cracking occurs at 100 % damage:
<2 in 0.000398; 2-3 in 0.000524; "2-4" (= 3-4, the row between 2-3 and 4-6) 0.002934; 4-6, 6-8, 8-10, 10-12
and >12 in 0.004. Eq. 20 (same page) is the sigmoid fitted to them, k1' = 1/(0.000398 + 0.003602/(1 +
e^(11.02 - 3.49 hac))), "Standard error (Se) = 0.00017". The shift factor is 1/k1', i.e. 1/CH in this engine.
- p. 50: "The final transfer function ... is based on the assumption that the fatigue cracking would be 50 %
at a damage of 100 %" (third source for the 50 % anchor).
Priest, A.L. & Timm, D.H. (2006), Methodology and Calibration of Fatigue Transfer Functions for
Mechanistic-Empirical Flexible Pavement Design, NCAT Report 06-03, Auburn University, p. 19 (the
MEPDG fatigue equation is "considering failure at 50 percent cracking of the total lane area") and
p. 80 ("the volumetric correction, C, is equal to 1 for mixes with air voids of 5 percent and binder
volume of 11 percent").
HOW A PUBLISHED DAMAGE REACHES THE ENGINE. Damage is D = N / Nf. The engine is first asked for Nf, then
run again with N set to Nf x k, so D = k exactly. Only the INPUT is constructed this way; every EXPECTED
value below is a published number (50 %, the C4/60 = 100 % plateau, "C = 1").
| Test block (the published value it checks) | Verdict |
| Fig. 5-3 / Kim 2011 / Priest & Timm 2006: 50 % alligator cracking at 100 % damage (DI = 1), Hac = 2 in | Pass |
| Fig. 5-3 / Kim 2011 / Priest & Timm 2006: 50 % alligator cracking at 100 % damage (DI = 1), Hac = 4 in | Pass |
| Fig. 5-3 / Kim 2011 / Priest & Timm 2006: 50 % alligator cracking at 100 % damage (DI = 1), Hac = 6 in | Pass |
| Fig. 5-3 / Kim 2011 / Priest & Timm 2006: 50 % alligator cracking at 100 % damage (DI = 1), Hac = 8 in | Pass |
| Fig. 5-3 / Kim 2011 / Priest & Timm 2006: 50 % alligator cracking at 100 % damage (DI = 1), Hac = 12 in | Pass |
| Eq. 5-6a plateau C4/60 = 6000/60 = 100 %: at Log Damage (%) = 6 (DI = 1e4) the curve is at the plateau for Hac = 2, 6, 12 in | Pass |
| Figure 5-3: the curve is indistinguishable from 0 % at Log Damage (%) <= -1 (DI = 0.001) | Pass |
| Priest & Timm 2006 p. 80: the volumetric correction C is "equal to 1" at Va = 5 %, Vb = 11 % | Pass |
| App. II-1 Table 7, AC < 2 in: shift factor 0.000398 (checked at 1 in and 1.5 in, within the printed Se) | Pass |
| App. II-1 Table 7, AC 2-3 in: shift factor 0.000524 lies between the fitted curve at 2 in and at 3 in | Pass |
| App. II-1 Table 7, AC 3-4 in (printed "2-4"): shift factor 0.002934 lies between the fitted curve at 3 in and at 4 in | Pass |
| App. II-1 Table 7, AC 4-6 in: shift factor 0.004 (CH = 250), checked at 5 in within the printed Se | Pass |
| App. II-1 Table 7, AC 6-8 in: shift factor 0.004 (CH = 250), checked at 7 in within the printed Se | Pass |
| App. II-1 Table 7, AC 8-10 in: shift factor 0.004 (CH = 250), checked at 9 in within the printed Se | Pass |
| App. II-1 Table 7, AC 10-12 in: shift factor 0.004 (CH = 250), checked at 11 in within the printed Se | Pass |
| App. II-1 Table 7, AC > 12 in: shift factor 0.004 (CH = 250), checked at 14 in within the printed Se | Pass |
mepdg-fatigue-web-validation.test.ts
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: mepdg-fatigue · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015) §5.3.2 (bottom-up alligator fatigue), matching NCHRP 1-40D's
re-calibration (kf1=0.007566, kf2=-3.9492, kf3=-1.281) -- both source PDFs
on disk and verified via pdftotext to carry this exact equation and these
exact constants. This suite's numeric chain matches the existing hand-
verified golden test in mepdg-fatigue.test.ts exactly (same case), and
extends it with additional cited-formula sweeps to bring the total >=20.
M = 4.84.(Vbe/(Va+Vbe) - 0.69), C = 10^M
CH = 1/(0.000398 + 0.003602/(1+e^(11.02-3.49.Hac)))
Nf = kf1.C.CH.(1/et)^-kf2.(1/E)^-kf3 [kf2=-3.9492 -> exponent 3.9492; kf3=-1.281 -> 1.281]
D = N/Nf, FCbottom = (1/60).(6000/(1+e^(C1.C1*+C2.C2*.log10(100.D))))
| Test block (the published value it checks) | Verdict |
| [1-6] base case (matches the existing hand-verified golden test exactly): C=0.41506, CH=250.0, Nf=1.010e9, D=0.00990, FCbottom=0.586% | Pass |
| [7-8] doubling the tensile strain drops Nf by exactly (200/70)^3.9492 per the published kf2=-3.9492 exponent | Pass |
| [9-10] doubling the AC modulus drops Nf by exactly 2^1.281 per the published kf3=-1.281 exponent | Pass |
| [11-12] the C-factor (air-voids/binder term) matches 10^(4.84.(Vbe/(Va+Vbe)-0.69)) exactly for an arbitrary mix | Pass |
| [13-14] the thickness-correction CH matches 1/(0.000398+0.003602/(1+e^(11.02-3.49.Hac))) exactly for an arbitrary thickness | Pass |
| [15] N=0 gives exactly zero damage and zero cracking, labelled as definitional (real limit: an untrafficked pavement) | Pass |
| [16] richer/lower-void mix (higher C-factor) increases Nf and reduces cracking than a leaner/higher-void mix, all else equal | Pass |
| [17] every load-bearing input is refused at 0 or below | Pass |
⚑ mepdg-iri-published-web-validation.test.ts
MEPDG flexible-pavement IRI (Eq.
Analyses validated: mepdg-iri · Recorded run: passed — 19 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
MEPDG flexible-pavement IRI (Eq. 5-15a/b) - checks against PUBLISHED values only.
STATUS: PARTIAL - 19 of 20. 17 published site-factor answers (FHWA-HRT-17-049 Figs. 9-11) plus 2 published
ride-quality thresholds (FHWA, 95 and 170 in/mi; 4 assertions). The release bar is 20 PUBLISHED values. The
shortfall (1) is real and is NOT padded: no source I could open prints a complete (IRI0, RD, FC, TC, age,
climate, subgrade) -> IRI worked example, and the sibling suite mepdg-iri-web-validation.test.ts is
formula-fidelity evidence (hand-evaluated Eq. 5-15). This header keeps the phrase "formula-fidelity" on
purpose so the generated validation manifest does not promote the engine to "reference-backed" on these
checks plus the sibling's formula-fidelity calls. Remove it only when the published count reaches 20.
WHAT THIS SUITE FOUND. Checking the engine against the FHWA site-factor figures led to the published
form of Eq. 5-15b, and the engine had it wrong: it applied Age^1.5 to the FIRST logarithm only, leaving
ln[(Precip+1)(PI+1)p200] age-independent, so a brand-new pavement (Age = 0) came out 0.15 in/mi ABOVE its
initial IRI. The MOP 2nd ed. typesets Eq. 5-15b ambiguously (`Age^1.5 {ln[..p02]}+{ln[..p200]}`, printed
p. 51); the Oct-2023 errata prints it as SF = Age^1.5 [ln((Precip+1)(FI+1)p02) + ln((Precip+1)(PI+1)p200)]
(Eq. 5-20b, printed p. 65 / PDF p. 51) and FHWA-HRT-17-049 Fig. 8 describes it as "Age raised to the power
of 1.5 multiplied by the sum of terms 1 and 2". Engine fixed 2026-10-07 (see mepdg-iri.ts); the tests that
had pinned the old numbers were re-pinned with a comment.
PUBLISHED SOURCES (each opened and read for this suite, 2026-10-07):
FHWA-HRT-17-049 (2017), Investigation of Increase in Roughness Due to Environmental Factors in Flexible
Pavements Using Profile Data From LTPP SPS-1, 508 descriptions, Figs. 1, 7, 8, 9, 10, 11,
https://www.fhwa.dot.gov/publications/research/infrastructure/pavements/ltpp/17049/011.cfm
- Figs. 1/7: IRI = IRI0 + 0.0150 SF + 0.4 FC_Total + 0.0080 TC + 40 RD.
- Fig. 8: SF = Age^1.5 x (term 1 + term 2); term 1 = ln[(Precip+1)(FI+1)p02].
- Figs. 9-11: "predicted IRI change" at pavement age 1 and 20 yr for three p02 values (Precip 30 in,
FI 500 F-days), three precipitation values (p02 50 %, FI 500) and three FI values (p02 50 %,
Precip 30 in). The figures do not state PI or p200, and every printed value equals
0.015 x Age^1.5 x ln[(Precip+1)(FI+1)p02] alone (term 2 contributes nothing) - checked for all nine
curves at age 20 to the printed 0.01 in/mi, so the tests below choose PI = 0 and p200 = 1/(Precip+1)
to make term 2 = ln(1) = 0, which is the only way the figures can be reproduced by any engine.
AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed., Sec. 5.3.6,
Eqs. 5-15a/b (printed p. 51, PDF p. 64 of the on-disk copy): C1..C4 = 40.0, 0.400, 0.008, 0.015.
AASHTO (2023), MEPDG Manual of Practice errata (3rd-ed. corrected pages), Eq. 5-20b (printed p. 65).
FHWA (2026), Our Nation's Highways 2026, Safety, Condition and Performance,
https://www.fhwa.dot.gov/policyinformation/pubs/our_nations_highways_2026/safety_condition_performance.cfm :
"An IRI of less than 95 is considered good or very good ride quality, while an IRI rating of less than
170 is considered acceptable ride quality. An IRI value equal to or greater than 170 is poor".
KNOWN, DELIBERATELY-UNTESTED PUBLISHED ENTRIES (investigated, not hidden):
- Fig. 9, p02 = 40 %: the 508 text prints 17.99 in/mi at age 20; Fig. 8 evaluated at the figure's own
stated inputs gives 17.897, and the other eight age-20 values agree with Fig. 8 to 0.01. The 17.99 is
taken to be a transcription slip in the description, so it is not asserted.
- The engine labels 170-220 in/mi "Mediocre ride"; FHWA (above) calls everything >= 170 poor, and the
220 boundary has no source. Reported, not asserted.
- Age-1 values are printed to 2 decimals and several are truncated rather than rounded (0.1897 is
printed 0.18, 0.1976 is printed 0.19), so they are checked to +/-0.01, one unit in the last digit.
| Test block (the published value it checks) | Verdict |
| FHWA-HRT-17-049 Fig. 9 p02 = 20 %: predicted IRI change at age 1 yr = 0.18 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 9 p02 = 20 %: predicted IRI change at age 20 yr = 16.97 in/mi (printed to 2 d.p.) | Pass |
| FHWA-HRT-17-049 Fig. 9 p02 = 40 %: predicted IRI change at age 1 yr = 0.2 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 9 p02 = 60 %: predicted IRI change at age 1 yr = 0.21 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 9 p02 = 60 %: predicted IRI change at age 20 yr = 18.44 in/mi (printed to 2 d.p.) | Pass |
| FHWA-HRT-17-049 Fig. 10 Precip = 20 in: predicted IRI change at age 1 yr = 0.19 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 10 Precip = 20 in: predicted IRI change at age 20 yr = 17.67 in/mi (printed to 2 d.p.) | Pass |
| FHWA-HRT-17-049 Fig. 10 Precip = 40 in: predicted IRI change at age 1 yr = 0.21 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 10 Precip = 40 in: predicted IRI change at age 20 yr = 18.57 in/mi (printed to 2 d.p.) | Pass |
| FHWA-HRT-17-049 Fig. 10 Precip = 60 in: predicted IRI change at age 1 yr = 0.21 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 10 Precip = 60 in: predicted IRI change at age 20 yr = 19.1 in/mi (printed to 2 d.p.) | Pass |
| FHWA-HRT-17-049 Fig. 11 FI = 100 F-days: predicted IRI change at age 1 yr = 0.18 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 11 FI = 100 F-days: predicted IRI change at age 20 yr = 16.05 in/mi (printed to 2 d.p.) | Pass |
| FHWA-HRT-17-049 Fig. 11 FI = 500 F-days: predicted IRI change at age 1 yr = 0.2 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 11 FI = 500 F-days: predicted IRI change at age 20 yr = 18.2 in/mi (printed to 2 d.p.) | Pass |
| FHWA-HRT-17-049 Fig. 11 FI = 900 F-days: predicted IRI change at age 1 yr = 0.21 in/mi (printed to 2 d.p., +/-0.01) | Pass |
| FHWA-HRT-17-049 Fig. 11 FI = 900 F-days: predicted IRI change at age 20 yr = 18.98 in/mi (printed to 2 d.p.) | Pass |
| FHWA Our Nation's Highways 2026: "IRI of less than 95 ... good": just below 95 in/mi the engine says Good ride, just above it does not | Pass |
| FHWA Our Nation's Highways 2026: "less than 170 ... acceptable": just below 170 in/mi the engine says Fair ride, just above it does not | Pass |
mepdg-iri-web-validation.test.ts
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: mepdg-iri · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015), §5.5, Eq. 5-15a/5-15b — the EXACT published flexible-
pavement IRI transfer function (source PDF on disk, verified via
pdftotext). Constants C1=40.0, C2=0.400, C3=0.008, C4=0.015 match the cited
manual exactly. This is a linear combination of a rut/fatigue/thermal term
plus one age-and-gradation site-factor term -- fully closed-form. As with
the sibling MEPDG suites, every expected value is HAND-COMPUTED directly
from the cited equation (verified independently in Python) since the
manual does not publish a pre-worked (inputs -> IRI) example for this
transfer function -- formula-fidelity evidence, not an independently-
sourced published answer.
IRI = IRI0 + 40.0.RD + 0.400.FC + 0.008.TC + 0.015.SF
SF = Age^1.5 . { ln[(Precip+1)(FI+1).p02] + ln[(Precip+1)(PI+1).p200] }
RE-PINNED 2026-10-07. The expected values below used to encode Age^1.5 on the FIRST logarithm only
(SF = 824.774635, IRI = 92.971620; age-0 SF = 10.02349). The MOP Oct-2023 errata (Eq. 5-20b) and
FHWA-HRT-17-049 Fig. 8 put Age^1.5 on the SUM of both logarithms, so the numbers were wrong; the
engine was fixed and these were recomputed independently (python) from the corrected equation. The
PUBLISHED-answer checks for this engine are in mepdg-iri-published-web-validation.test.ts.
| Test block (the published value it checks) | Verdict |
| [1-6] base case: SF=1397.063312, contributions rut=10.0 fat=6.0 thermal=1.6 site=20.955950, IRI=101.555950 in/mi | Pass |
| [7-8] age=0 zeroes the site factor (Age^1.5 multiplies both logarithms): SF=0, IRI=IRI0=63 | Pass |
| [9] IRI0 refused at 0 or below | Pass |
| [10-11] p02 = 0 or p200 = 0 is refused (both sit inside logs and diverge to -infinity, not to a vanishing term) | Pass |
| [12] each distress coefficient matches its published constant exactly, isolated one at a time | Pass |
| [13] unit conversion in/mi -> m/km is exact (x0.0157828) | Pass |
| [14] ride-quality bands: good <95, fair <170, mediocre <220, else poor | Pass |
mepdg-subgrade-rutting-published-web-validation.test.ts
MEPDG unbound / subgrade rutting (Tseng-Lytton, Eq.
Analyses validated: mepdg-subgrade-rutting · Recorded run: passed — 25 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
MEPDG unbound / subgrade rutting (Tseng-Lytton, Eq. 5-2a-c) - checks against PUBLISHED values only.
STATUS: PARTIAL - 61 published numbers (12 rho + Co + 48 strain-ratio entries) in 49 assertions, but from ONE
source table, and they exercise only the traffic-accumulation leg of the model. This header keeps the phrase
"formula-fidelity" on purpose: the two-independent-sources bar is NOT met for published ANSWERS (the equations
are confirmed by three documents, the answers by one), so the generated validation manifest must not promote the
engine to "reference-backed" on this evidence plus the sibling suite's formula-fidelity calls. Not covered by
any published answer I could find: the eps0/eps_r regression (Eq. 5.28 - only its coefficients are published),
the ks1 multipliers, and the layered-elastic strain that feeds eps_v (response-dependent, no (section -> strain)
answer in a source I could open).
PUBLISHED SOURCES (each opened and read for this suite, 2026-10-07):
NCHRP 1-37A (2004), Guide for Mechanistic-Empirical Design of New and Rehabilitated Pavement Structures,
Appendix GG-1 "Calibration of Permanent Deformation Models for Flexible Pavements", Annex B, Table B-35
"Unbound Material Rut Model Set 8-C-B Computations" (printed p. GG-1.127), downloaded from
https://content.aashtowarepavementme.org/Documents/1-37A/2appendices_GG.pdf . Set 8-C-B is the model with
a1 = 0.15, b1 = 0, a9 = 20, b9 = 0 that the MOP adopted (Co = ln(0.15/20) = -4.8928523, printed in the
table). For twelve material columns (CBR 1...100 at GWT 10 ft, E = 2555...48685 psi) the table prints
Beta, Rho and the permanent-strain ratio ep(N)/er for N = 1 ... 1e9 repetitions.
AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed., Sec. 5.3.2,
Eqs. 5-2a-c (printed pp. 40-41, PDF p. 53): dp = bs1 ks1 ev h (e0/er) exp[-(rho/n)^beta];
log beta = -0.61119 - 0.017638 Wc; rho = 1e9 [Co/(1-(1e9)^beta)]^(1/beta); a1 = 0.15, a9 = 20, b1 = b9 = 0.
FHWA NHI-05-037 (2005), Geotechnical Aspects of Pavements, Sec. 5.4.8, Eqs. 5.27-5.29
(https://www.fhwa.dot.gov/engineering/geotech/pubs/05037/05c.cfm): same beta regression (5.29) and the
Tseng-Lytton form (5.27). Its rho regression (5.30), log rho = 0.622685 + 0.541524 Wc, is the OLDER form
and is deliberately not what this engine implements (see mepdg-subgrade-rutting.ts).
HOW A PUBLISHED COLUMN REACHES THE ENGINE. Table B-35 derives Beta from the resilient modulus (its own
Beta-vs-modulus regression), not from water content, so there is no published Wc per column. The engine takes
Wc, so each column is driven at the Wc that reproduces the PUBLISHED Beta through MOP Eq. 5-2c
(Wc = (-0.61119 - log10 Beta)/0.017638, 5.9 ... 51.7 %, all inside the engine's 0-60 % range). That makes
engine Beta equal the table's by construction - so it is not counted as a check - and leaves the two things
that are genuinely compared: Rho (MOP Eq. 5-2b with Co) and the traffic-accumulation factor
exp[-(rho/N)^beta], which the engine applies inside the rut and which is observable as the ratio
rut(N)/rut(1e7) (the strain profile does not depend on N, and e0/er and ks1 cancel). The table's ratio
ep(N)/ep(1e7) is the same quantity because its X = e0/er is common to every N in a column.
TOLERANCES. Rho is printed to 4-9 significant figures and depends on Beta through a steep power
(dln rho / dln beta is about -80 at Beta = 0.03), so the table's own 6-digit Beta rounding moves Rho by up to
2.5e-4 relative: Rho is checked to 5e-4. The ratios are insensitive to that (measured worst 3e-7); they are
checked to 1e-5.
| Test block (the published value it checks) | Verdict |
| Table B-35 (and MOP Eq. 5-2c): Co = ln(a1/a9) = ln(0.15/20) = -4.8928523, the value the engine's Rho is built on | Pass |
| Table B-35 CBR 1: Rho = 1.498e+34 at the published Beta 0.0299719 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 2: Rho = 10180000000000000 at the published Beta 0.0538458 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 3: Rho = 308500000000 at the published Beta 0.0700934 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 4: Rho = 2866000000 at the published Beta 0.0821515 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 5: Rho = 197251804 at the published Beta 0.0916235 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 7: Rho = 10004263 at the published Beta 0.1058432 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 10: Rho = 1073506.5 at the published Beta 0.1205232 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 12: Rho = 442991.9335 at the published Beta 0.127772481 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 15: Rho = 178595.56 at the published Beta 0.1363509 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 20: Rho = 69125.054 at the published Beta 0.146865 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 40: Rho = 14104.545 at the published Beta 0.1693629 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 100: Rho = 4164.0422 at the published Beta 0.1927432 (MOP Eq. 5-2b) | Pass |
| Table B-35 CBR 1: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 2: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 3: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 4: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 5: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 7: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 10: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 12: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 15: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 20: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 40: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
| Table B-35 CBR 100: rut(N)/rut(1e7) follows the published ep(N)/er ratios at N = 1e3, 1e5, 1e8 | Pass |
mepdg-subgrade-rutting-web-validation.test.ts
Validation against Tseng & Lytton (1989) and AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: mepdg-subgrade-rutting · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation against Tseng & Lytton (1989) and AASHTO MEPDG "A Manual of
Practice" 2nd ed. (2015) §5.3.2, Eq. 5-2a-c, plus FHWA NHI-05-037 §5
Eqs. 5.27-5.29 (source PDFs on disk, verified via pdftotext for the exact
regression coefficients: 0.74168/0.08109/-0.000012157 for log10(eps0/epsr);
-0.61119/-0.017638 for log10(beta); Co = ln(0.15/20)).
STATUS (2026-10-07): this file is formula-fidelity evidence (hand-evaluated Eq. 5-2a-c). The published-ANSWER checks
live in mepdg-subgrade-rutting-published-web-validation.test.ts (NCHRP 1-37A App. GG-1 Table B-35); they come from a
single source and leave the eps0/eps_r regression and the layered-elastic strain unchecked, so the engine is NOT
promoted to reference-backed on them. See that file's header for the remaining gap.
TWO KINDS OF EVIDENCE, kept separate on purpose:
(a) The material-parameter regressions (eps0/epsr, beta, rho) and the
ks1 granular/fine ratio are PURE closed-form algebra with no
dependence on the layered-elastic solver -- these are HAND-COMPUTED
directly from the cited published equations (verified independently
in Python) and checked to full precision. This is real formula-
fidelity evidence against the cited source.
(b) The final rut depth also depends on `subgradeInteriorStrains`, the
package's Burmister multi-layer elastic solver -- already exercised
by its own dedicated golden tests elsewhere in this suite. Re-deriving
a multi-layer elastic solution by hand here would not be a reliable
way to add confidence (real risk of the "expected" value itself being
subtly wrong), so those checks are PROPERTY-based instead: monotone
in traffic, exactly proportional to ks1, zero at N=0, zero at
betaS1=0 -- checking documented, cited MATHEMATICAL BEHAVIOUR of Eq.
5-2a rather than one brittle magic number.
| Test block (the published value it checks) | Verdict |
| [1-3] material regressions at Wc=15%, MR=60MPa: eps0/epsr=71.160108, beta=0.133119, rho=247542.176 (NHI 5.28-5.29 / MOP 5-2b exact) | Pass |
| [4-5] wetter subgrade (Wc=25% vs 15%) raises eps0/epsr per the +0.08109 coefficient exactly | Pass |
| [6-7] stiffer subgrade (higher MR) reduces eps0/epsr per the -0.000012157 coefficient exactly | Pass |
| [8] the granular/fine ks1 ratio (2.03/1.35) is EXACT — ks1 is a pure multiplicative factor on the rut | Pass |
| [9] monotone increasing in cumulative traffic N (the Tseng-Lytton accel factor e^(-(rho/N)^beta) rises toward 1 with N) | Pass |
| [10] N=0 gives exactly zero rut, labelled as definitional | Pass |
| [11] beta_s1=0 zeroes the rut exactly (it is a pure multiplicative local-calibration factor) | Pass |
| [12] linear in beta_s1 (a pure multiplicative calibration factor, Eq. 5-2a) | Pass |
| [13] every load-bearing input is refused at 0 or below, never silently clamped to a tiny positive floor | Pass |
| [14] mm/in conversion is exact (x25.4) | Pass |
⚑ mepdg-thermal-cracking-published-web-validation.test.ts
MEPDG thermal (transverse) cracking, Eq.
Analyses validated: mepdg-thermal-cracking · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
MEPDG thermal (transverse) cracking, Eq. 5-11e - checks against PUBLISHED values only.
STATUS: PARTIAL. 11 assertions against published values; the release bar is 20. The shortfall (9) is real
and is NOT padded. What I could and could not verify:
- VERIFIED here: the crack-amount transfer function TC = 400 N[(1/0.769) log10(Cd/HHMA)]. The MOP
prints beta_t1 = 400 and sigma_d = 0.769; the standard-normal N[z] is checked against the NIST
handbook's printed critical values and worked examples.
- NOT verifiable with any source I could open: the Paris-law stage (A, n, the stress-intensity
recursion). I found no document that prints (E, sigma_m, m, kt) -> (A, n, crack depth) for a real
mix, so no published ANSWER exists here for that stage. The engine also evaluates the Paris
coefficient with E in ksi while the MOP text says psi (see the report that accompanies this suite);
that is UNRESOLVED and nothing below pretends to settle it.
UNIT QUESTION, RE-INVESTIGATED 2026-10-07 (still UNRESOLVED, now with evidence). The MOP 2nd ed. (Sec. 5.3.4,
printed p. 47, PDF p. 60) defines "EHMA = HMA indirect tensile modulus, psi" and "sigma_m = Mixture tensile
strength, psi" in A = kt bt 10^[4.389 - 2.52 Log(EHMA sigma_m n)]; the engine uses E in KSI and sigma_m in psi,
so it contradicts the printed definition and no source I could open supports ksi. NCHRP 1-37A Appendix HH
(2004; https://content.aashtowarepavementme.org/Documents/1-37A/2appendices_HH.pdf , Sec. 2.5.2.2 pp. HH.62-63
and the beta section pp. HH.225-226) shows the model was CALIBRATED in a different form: Molenaar's E was
replaced by a constant, "log A = 4.389 - 2.52 * log(k * sigma_m * n) ... k = coefficient determined through
field calibration = 10,000" (Eq. 2.12), and the calibration multiplier beta sits on the EXPONENT
(A = 10^(beta * (4.389 - 2.52 log(E sigma_m n))), beta = 1, 3, 5), whereas the MOP puts kt bt on A itself. So
three published forms disagree with one another and with the engine; the units of dC (ft or in) and of C0 are
also unstated in the sources above. Switching the engine to psi would make the crack grow ~10^-9 in per cycle
(no cracking anywhere), so it was NOT changed: the fix needs a published (E, sigma_m, m, kt) -> (A, n, crack
depth) example to decide, and none has been found. Appendix HH Table A-1 lists m and sigma_m for 42 PTI sections,
but the engine's thermal stress is a restrained-stress simplification (sigma_tip = min(sigma_m, E alpha dT)), not
the TCMODEL hourly viscoelastic analysis those tables were produced with, so they cannot be reproduced here.
The sibling suite mepdg-thermal-cracking-web-validation.test.ts is formula-fidelity evidence. This header
says so deliberately: it keeps the generated validation manifest from promoting the engine to
"reference-backed" on 11 published checks plus the sibling's formula-fidelity calls. Remove that sentence
only when the published-value count reaches 20.
PUBLISHED SOURCES (each opened and read for this suite, 2026-10-06):
AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed., Sec. 5.3.4,
Eq. 5-11e (printed p. 47, PDF p. 60): TC = beta_t1 N[(1/sigma_d) log(Cd/HHMA)], "beta_t1 ...
(400)", "sigma_d ... (0.769)". The identical constants are printed in NCHRP (2007), NCHRP 1-40D
Manual of Practice draft final, Eq. 11.e, and in the Oct-2023 errata of the 3rd ed. (Eq. 5-13g).
Croarkin, C. & Tobias, P. (2003), NIST/SEMATECH e-Handbook of Statistical Methods, Sec. 1.3.6.7.1
"Cumulative Distribution Function of the Standard Normal Distribution",
https://www.itl.nist.gov/div898/handbook/eda/section3/eda3671.htm (read 2026-10-06): the critical
values Z_p for p = 0.001, 0.005, 0.010, 0.025, 0.050, 0.100 are -3.090, -2.576, -2.326, -1.960,
-1.645, -1.282; the worked examples give P[x <= -1] = 0.15866 and P[x <= -1.53] = 0.06301.
Thompson, A. & Taylor, B.N. (2008), Guide for the Use of the International System of Units (SI), NIST
Special Publication 811, Appendix B.8: 1 ft = 0.3048 m and 1 mi = 1.609 344 km (both exact).
HOW A TABLE VALUE REACHES THE ENGINE. With zero cooling cycles the crack stays at its initial 0.1 in, so
Cd/HHMA = 0.1 in / HHMA. Choosing HHMA = 0.1 in / 10^(0.769 z) therefore sets the argument of N[] to
exactly z, and the engine must return 400 x N[z]. The expected value is 400 x the PRINTED table value;
nothing is computed with our own erf.
| Test block (the published value it checks) | Verdict |
| NIST handbook critical value Z_0.001 = -3.09: TC = 400 x 0.001 = 0.4 ft/mi | Pass |
| NIST handbook critical value Z_0.005 = -2.576: TC = 400 x 0.005 = 2 ft/mi | Pass |
| NIST handbook critical value Z_0.01 = -2.326: TC = 400 x 0.01 = 4 ft/mi | Pass |
| NIST handbook critical value Z_0.025 = -1.96: TC = 400 x 0.025 = 10 ft/mi | Pass |
| NIST handbook critical value Z_0.05 = -1.645: TC = 400 x 0.05 = 20 ft/mi | Pass |
| NIST handbook critical value Z_0.1 = -1.282: TC = 400 x 0.1 = 40 ft/mi | Pass |
| NIST handbook worked example P[x <= -1] = 0.15866 => TC = 400 x 0.15866 = 63.464 ft/mi | Pass |
| NIST handbook worked example P[x <= -1.53] = 0.06301 => TC = 400 x 0.06301 = 25.204 ft/mi | Pass |
| N[0] = 0.5 (NIST: "add 0.5 (for the probability less than zero)"): Cd = HHMA gives TC = 400 x 0.5 = 200 ft/mi | Pass |
| a crack that Paris-law growth drives through the whole layer saturates at the same published value 400 N[0] = 200 ft/mi | Pass |
| NIST SP 811 App. B.8: 1 ft/mi = 0.3048 m / 1.609344 km, so m/km = ft/mi x 0.3048 / 1.609344 (0.1893939) | Pass |
mepdg-thermal-cracking-web-validation.test.ts
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice" 2nd ed.
Analyses validated: mepdg-thermal-cracking · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against AASHTO MEPDG "A Manual of Practice"
2nd ed. (2015), §5.3.4, Eqs. 5-11a-e (the TCMODEL). Source PDF on disk
(verified via pdftotext for the 4.389/2.52 Paris-coefficient constants and
the 400/0.769 transfer-function constants, matching this engine exactly).
The Paris-law crack-growth loop is deterministic and was reproduced cycle-
by-cycle in Python to derive each expected value below — formula-fidelity
evidence (proves the engine's iterative accumulation matches the cited
equations exactly), not an independently-published worked example (the
manual gives the equations and constants but not a full numeric TCMODEL
run for a specific input set).
| Test block (the published value it checks) | Verdict |
| [1-6] base case (mild climate, moderate mix): n=2.4, A=2.034249e-10, sigma_tip=1.2MPa, Cd=0.213912in, ratio=0.036222, TC=12.189030 ft/mi | Pass |
| [7-9] severe case (high modulus/contraction, thin brittle layer, many cycles) saturates at the TCMODEL ceiling of exactly 200 ft/mi | Pass |
| [10] alpha=0 (no thermal contraction) gives zero thermal stress and the crack never grows past its 0.1 in seed | Pass |
| [11] cooling_cycles=0 leaves the crack at its 0.1 in initial seed length, same TC as the alpha=0 case | Pass |
| [12] unit conversion ft/mi -> m/km uses the CORRECT constant 0.3048/1.609344 = 0.1893939, not the earlier transposed 0.18288 | Pass |
| [13] every load-bearing input is refused at 0 or below | Pass |
| [14] thermal stress is capped at the mixture tensile strength (sigma_tip = min(sigM, E.alpha.dT)) | Pass |
⚑ pavement-aashto-1993-fdot-fhwa-web-validation.test.ts
AASHTO 1993 FLEXIBLE PAVEMENT (Eq.
Analyses validated: aashto-rigid-1993, pavement-aashto-1993 · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
AASHTO 1993 FLEXIBLE PAVEMENT (Eq. 2.1 structural-number solver) — second, independent published-answer
suite. The first suite (`pavement-aashto-1993-web-validation.test.ts`) anchors the engine to the Guide's own
Appendix H; this one anchors the same solver to two OTHER published documents that print finished answers,
so the engine is no longer validated against one author's worked example only.
SOURCES — each value below carries its locator in the comment beside it (all opened and read 2026-10-06):
FDOT (2018), Flexible Pavement Design Manual, Topic No. 625-010-002, Florida Department of
Transportation, revised January 2018 —
§2.2.2 constants of every table: S0 = 0.45, p0 = 4.2, pt = 2.5, ΔPSI = 1.7
§5.2.1 worked example: ESAL_D 5,000,000 · MR 14,000 psi · R 90 % → SN_R = 3.57 (Table A.4A)
App. A Tables A.1A–A.10B: required SN for 40 design-ESAL rows × 15 MR columns, at R = 75, 80, 85,
90, 92, 94, 95, 96, 97, 99 % (12 000 printed values)
https://fdotwww.blob.core.windows.net/sitefinity/docs/default-source/roadway/pm/publications/fpdm201801.pdf
FHWA-NHI-05-037 (2006), Geotechnical Aspects of Pavements Reference Manual, U.S. Federal Highway
Administration, May 2006 —
Ch. 6 §6.2.1, §6.3.1, §6.5.1 baseline / soft-subgrade / low-quality-base flexible designs (Table 6-2)
Appendix C (C.2)–(C.5) flexible example with W18 = 11.6 million
Table C-3 Z_R for 18 reliability levels
https://www.fhwa.dot.gov/engineering/geotech/pubs/05037/ (ch. 6: 06a.cfm; appendix: ac.cfm)
AASHTO (1993), Guide for Design of Pavement Structures, Vol. 1, Table 4.1 (p. I-62), read from the scanned
Guide in the reference library — the row Z_R(99.99 %) = −3.750 that `reliabilityZ` was missing.
WHAT IS A PUBLISHED ANSWER HERE, AND WHAT IS NOT. Every expected number below is printed in one of those
documents. Nothing is computed by this engine and relabelled as published. Where a value is derived from
printed numbers by arithmetic (e.g. D1 = (SN − SN2)/a1), the arithmetic is the source's own and is stated.
TOLERANCES, from the sources' own rounding:
· FDOT tables print SN to 0.01 and the engine reports SN to 0.01, so two roundings of one true value can
differ by one unit in the last place: ±0.01. Measured once over all 12 000 cells (see UNRESOLVED (4)):
11 641 agree exactly, 254 differ by exactly 0.01, 105 are the anomalous rows below, none other.
· FHWA prints SN to 0.01 (±0.01) and traffic capacities to 2–3 significant figures (→ ±0.02 in SN).
UNRESOLVED / SOURCE-INTERNAL DISCREPANCIES — deliberately NOT asserted, recorded so nobody "fixes" them:
(1) FHWA Ch. 6 SN1 = 2.35 (W18 6.1e6) and Appendix C SN1 = 2.62 (W18 11.6e6) are stated to be solved with
E_BS = 40,000 psi. The engine gives 2.46 and 2.74 at MR = 40,000; the printed values are reproduced only
at MR ≈ 44,900 / 44,750 psi (≈ the 44,300 psi that a2 = 0.18 implies through FHWA's own Eq. 5.16). The
overall SN values (4.61, 5.76, 5.07) ARE reproduced exactly, so Eq. 2.1 is right; the ambiguity is the
modulus the source actually used for the base, which it states inconsistently.
(2) FHWA Appendix C rigid D = 10.55 in lists W18 18.9e6, S0 0.45, J 3.2 and no k; those are not the inputs
of its own Chapter 6 Table 6-3 (16.4e6, 0.35, 2.8). The rigid engine is checked against Chapter 6 in
`aashto-rigid-1993-web-validation.test.ts`, where every input is printed.
(3) FHWA §6.6.1 poor-drainage flexible scenario quotes a traffic capacity of 0.67×10^6 ESALs, an SN of
"5.76 (unchanged)" and then uses 5.67 in the next line; the engine's SN at 0.67e6 / MR 3,800 is 4.19,
against 3.246 computed from the printed layer data. The paragraph contradicts itself; not used.
(4) FDOT Table A.5B (R = 92 %) rows 45 M–100 M differ from the engine by −0.06…−0.13 SN (105 cells). The
table is internally inconsistent there: at 50 M ESAL / MR 18 ksi it prints 4.88 for 92 % but 4.86 for
94 % (Table A.6B), i.e. LESS reliability needs MORE structure — impossible — and it jumps +0.15 between
the 40 M and 45 M rows where every neighbouring table steps +0.09…+0.10. The engine's 4.68 / 4.81 at
45 M / 50 M sits correctly between the 90 % (4.59 / 4.66) and 94 % (4.79 / 4.86) tables. Treated as a
printing error in the source; those cells are excluded and the 92 % B-table is sampled below 45 M.
| Test block (the published value it checks) | Verdict |
| FDOT §5.2.1 worked example — ESAL_D 5,000,000, MR 14,000 psi, R 90 % → SN_R = 3.57 | Pass |
| FDOT App. A — first-row/first-column and last-row/last-column cell of each of the 20 tables | Pass |
| FDOT Table A.1A (R 75 %) — all 600 printed cells | Pass |
| FDOT Table A.4A (R 90 %) — all 600 printed cells | Pass |
| FDOT Table A.10A (R 99 %) — all 600 printed cells | Pass |
| FHWA Ch. 6 §6.2.1 — baseline flexible design: W18 6.1×10⁶, R 90 %, S0 0.45, ΔPSI 1.7, MR 7,500 psi → SN 4.61 | Pass |
| FHWA Ch. 6 §6.3.1 — soft subgrade MR 3,800 psi → SN 5.76, and the baseline SN 4.61 carries only 1.25×10⁶ ESALs | Pass |
| FHWA Ch. 6 §6.3.1 — soft-subgrade asphalt thickness D1 = (SN − m2·a2·D2)/a1 = 7.9 in | Pass |
| FHWA Ch. 6 §6.5.1 — low-quality base: the baseline thicknesses give SN 3.4 which carries 0.88×10⁶ ESALs; D1 = 8.0 in | Pass |
| FHWA Appendix C — flexible example: W18 11.6×10⁶, R 90 %, S0 0.45, ΔPSI 1.7, MR 7,500 psi → SN 5.07 | Pass |
| FHWA Table C-3 — standard normal deviate for all 18 reliability levels (incl. 99.99 % = −3.750, AASHTO Table 4.1) | Pass |
pavement-aashto-1993-web-validation.test.ts
AASHTO 1993 FLEXIBLE PAVEMENT — web-validation benchmark against the Guide's own worked example.
Analyses validated: aashto-rigid-1993, pavement-aashto-1993 · Recorded run: passed — 14 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
AASHTO 1993 FLEXIBLE PAVEMENT — web-validation benchmark against the Guide's
own worked example.
SOURCE (the governing document itself, not a secondary text):
AASHTO, "Guide for Design of Pavement Structures", 1993, Volume 1 —
Part II Chapter 2 design requirements; §2.3.1 effective roadbed soil
resilient modulus (relative-damage averaging)
Part II Chapter 3 §3.1.3 flexible design, §3.1.4 layered design analysis
Figure 3.1 design chart for flexible pavements (the graphical
solution of the design equation)
Figure 3.2 layered-design procedure
**APPENDIX H — FLEXIBLE PAVEMENT DESIGN EXAMPLE** (pp. H-1 to H-7), with
Figure H.1 traffic, Figure H.3 effective MR estimation,
Table H.1 swell parameters and Table H.2 the reduced
performance period.
The PDF of the Guide on hand is a scan with no text layer, so the pages were
rendered at 160 dpi and OCR'd (tesseract) to recover Appendix H. Every value
asserted below is quoted in the comment next to it, so the transcription can
be re-checked against the page rather than trusted.
WHY THIS EXAMPLE. `pavement-aashto-1993` had three test files and none of them
was anchored: they assert hand-recomputations of our own equation, which
proves the arithmetic is self-consistent but not that it is AASHTO's. Appendix
H is AASHTO's own end-to-end design, so it exercises the whole chain — traffic
to effective MR to SN to layer thicknesses — against published answers.
TOLERANCE. The critical published quantities (SN = 5.6, SN1 = 3.2, SN2 = 4.5)
are read off **Figure 3.1, a nomograph**, to one decimal place. So the
tolerance on those is the chart's own reading precision, ±0.06 in SN, and the
exact equation solution is reported alongside so the gap is visible rather than
absorbed. Quantities the text computes arithmetically (relative damage,
effective MR, layer thicknesses) are held to 0.5 %.
COUNT: 31 cited values + 4 proof-by-consequence checks.
| Test block (the published value it checks) | Verdict |
| Appendix H.1 — traffic, reliability and serviceability inputs | Pass |
| Figure H.3 — relative damage u_f = 1.18e8 · MR^-2.32 at each tabulated modulus | Pass |
| Figure H.3 — Σu_f = 5.446 over 24 half-months, ū_f = 0.227, MR_eff = 5,700 psi | Pass |
| Appendix H.2 — SN = 5.6 from Figure 3.1 at MR 5,700, R 95 %, S0 0.35, ΔPSI 2.1, W18 18.6e6 | Pass |
| Appendix H.2 — Table H.2: swelling cuts the 15-year period to 13 years at W18 = 16.0e6, ΔPSI_TR = 1.89 | Pass |
| Appendix H.3 — SN1 = 3.2 above the base and SN2 = 4.5 above the subbase | Pass |
| Appendix H.3 — layer thicknesses 8 in AC / 7 in base / 11 in subbase | Pass |
| E-58 — the Guide’s minimum practical thicknesses are traffic-dependent | Pass |
| computeAashto1993 reproduces Appendix H end to end | Pass |
| the single MR and the seasonal series agree when the series is constant | Pass |
| Eq 2.1 is monotone in every input, in the physically correct direction | Pass |
| E-56 — layered design analysis reproduces Appendix H.3: SN1 3.2, SN2 4.5, 8 in AC, 7 in base | Pass |
| E-56 — the SN-share fallback returns a 25 % thin surface on the Guide’s own example | Pass |
| E-56 — a stiffer layer beneath thins the layer above, monotonically | Pass |
⚑ pavement-airfield-web-validation.test.ts
Web-benchmark validation for the FOURTEEN server-routed pavement and airfield engines.
Analyses validated: aashto-rigid-1993, acn-pcn-airfield, benkelman-overlay, crcp-punchout, faa-airfield-thickness, irc-sp72-pavement, jpcp-cracking, jpcp-faulting, jpcp-spalling, mepdg-ac-rutting, mepdg-fatigue, mepdg-iri, mepdg-subgrade-rutting, mepdg-thermal-cracking · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the FOURTEEN server-routed pavement and airfield engines.
These are `premiumStub` in RUNNER_CONFIGS: their `compute()` returns an entitlement notice, so
they cannot be anchored through the runner. They are reached here the way the server reaches
them — through `PREMIUM_COMPUTES` — driven by their own registry defaults, so the inputs under
test are exactly the inputs a user would send.
ENGINES AND SOURCES
mepdg-fatigue — AASHTO MEPDG bottom-up AC fatigue (Asphalt Institute form)
mepdg-ac-rutting — MEPDG AC rutting, monthly effective moduli
mepdg-subgrade-rutting — MEPDG subgrade rutting (Tseng & Lytton form)
mepdg-thermal-cracking — MEPDG thermal cracking, Paris-law crack growth
mepdg-iri — MEPDG flexible IRI, Eq. 5-x site-factor form
jpcp-cracking — MEPDG JPCP transverse cracking; Westergaard edge stress
jpcp-faulting — MEPDG JPCP faulting; differential-energy LTE
jpcp-spalling — MEPDG JPCP joint spalling
crcp-punchout — MEPDG CRCP punchouts
aashto-rigid-1993 — AASHTO 1993 Part III Eq 3.1 rigid slab thickness
acn-pcn-airfield — ICAO ACN-PCN reporting and overload rules
faa-airfield-thickness — FAA CBR flexible cover / rigid thickness
irc-sp72-pavement — IRC SP:72 low-volume-road design curves
benkelman-overlay — IRC 81 Benkelman-beam overlay design
Every expected value is reconstructed from the published expression in code. Where a
distress-transfer function's calibration coefficients are not traceable to a public worked
example the engine is anchored on the parts that ARE citable — unit conversions, stress ratios,
the reliability deviate, the standard-deviation rule, code lookup bands — plus internal
closures and monotonicity. That is stated rather than covered with an invented number.
| Test block (the published value it checks) | Verdict |
| every server-routed pavement/airfield slug is registered in PREMIUM_COMPUTES | Pass |
| mepdg-fatigue keeps damage and cracking mutually consistent | Pass |
| mepdg-ac-rutting and mepdg-subgrade-rutting convert inches to mm exactly | Pass |
| mepdg-thermal-cracking converts ft/mi to m/km correctly (E-108) | Pass |
| mepdg-iri sums its own reported distress contributions | Pass |
| jpcp-cracking uses the Westergaard edge stress ratio | Pass |
| jpcp-faulting keeps LTE, deflections and differential energy consistent | Pass |
| jpcp-spalling and crcp-punchout stay bounded and convert correctly | Pass |
| aashto-rigid-1993 solves Eq 3.1 and reproduces the design traffic | Pass |
| acn-pcn-airfield applies the ICAO ACN/PCN overload rules | Pass |
| faa-airfield-thickness converts and responds correctly to CBR and load | Pass |
| irc-sp72-pavement selects the right design curve and layer thicknesses | Pass |
| benkelman-overlay uses the IRC 81 characteristic deflection D_c = mean + 2σ | Pass |
pavement-calibration-web-validation.test.ts
Web-benchmark validation for the Pavement-ME local-calibration presets — pins each preset's βr1/βs1/βf1 to the agency's published calibration report, and checks the preset actually overrides the national default in the engine.
Analyses validated: pavement-me · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the Pavement-ME local-calibration presets —
pins each preset's βr1/βs1/βf1 to the agency's published calibration report,
and checks the preset actually overrides the national default in the engine.
Sources (on disk, Geo Technical engineering books/_new_2026-07-08_mepdg_calibration/):
NCDOT/NCSU Local Calibration Final Report (US DOT ROSAP dot_24207) T8.35/8.36
Idaho regional MEPDG rutting calibration
ARDOT TRC1003 — Calibration of the M-E Design Guide
AASHTO MEPDG Manual of Practice (national/global)
| Test block (the published value it checks) | Verdict |
| North Carolina (NCDOT) preset matches the published final factors | Pass |
| Idaho preset matches the published rutting factors (fatigue left national) | Pass |
| Arkansas preset carries the TRC1003 rut factor | Pass |
| National preset is the global default (1,1,1) and every preset cites a source | Pass |
| selecting a preset OVERRIDES the beta inputs and applies the cited factors | Pass |
| 'custom' leaves the explicit beta inputs in force (distinct from a preset) | Pass |
pavement-irc-37-web-validation.test.ts
Web-benchmark validation for `pavement-irc-37` — IRC 37:2018 flexible-pavement design.
Analyses validated: pavement-irc-37 · Recorded run: passed — 12 test block(s) · changed since the run
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `pavement-irc-37` — IRC 37:2018 flexible-pavement design.
SOURCES (each cited at the assertion that uses it):
IRC 37:2018 Cl 3.3 — cumulative standard axles N = 365·A·[(1+r)ⁿ − 1]/r·D·F.
IRC 37:2018 Cl 4.4 / Heukelom & Klomp (1962) — subgrade resilient modulus from CBR:
M_R = 10·CBR for CBR ≤ 5 %, M_R = 17.6·CBR^0.64 for CBR > 5 %; Cl 4.4.1 caps M_R at 100 MPa.
IRC 37:2018 Cl 6.2 — granular modulus E = 0.2·h^0.45·M_R.
IRC 37:2018 Cl 6.3 Eqs 3.3/3.4 — bituminous fatigue
N_f = C·k·(1/ε_t)^3.89·(1/E)^0.854, k = 0.5161e-4 at 90 % reliability, 1.6064e-4 at 80 %.
IRC 37:2018 Cl 6.3 — subgrade rutting N_r = k·(1/ε_v)^4.5337,
k = 1.41e-8 at 90 % reliability, 4.1656e-8 at 80 %.
IRC 37:2018 Cl 12, Figs 12.1–12.8 (Plates 1–8, pp. 37–41) — the design catalogue (the full
48-cell sweep lives in pavement-irc-37-catalogue-2018.test.ts).
The regression equations and the CBR correlation are exact published closed forms, so those
are asserted to machine precision. Each expected value reconstructs its chain in code.
| Test block (the published value it checks) | Verdict |
| M_R from CBR follows IRC 37 Cl 4.4: 10·CBR below 5 %, 17.6·CBR^0.64 above | Pass |
| M_R is capped at 100 MPa per Cl 4.4.1, and the cap is reported | Pass |
| cumulative msa follows IRC 37 Cl 3.3 exactly | Pass |
| the fatigue equation reproduces IRC 37 Eqs 3.3/3.4 at both reliabilities | Pass |
| the rutting equation reproduces IRC 37 N_r = k·(1/ε_v)^4.5337 | Pass |
| the granular modulus follows Cl 6.2 E = 0.2·h^0.45·M_R, capped at 5·M_R | Pass |
| surface course is the plate value (Plate 4, Fig 12.4, p. 39), and layers sum to the crust | Pass |
| thickness rises with traffic and falls with subgrade strength | Pass |
| the CTB variants return their own plate section, not a scaled granular section | Pass |
| the catalogue verdict reflects the computed damage ratios | Pass |
| the bitumen grade and mean temperature both move the bituminous modulus | Pass |
| invalid inputs are refused, and every result carries IRC 37 clauses | Pass |
⚑ pavement-irc-58-appendix-v-web-validation.test.ts
IRC 58:2015 Appendix-V regressions — validated against the code's OWN worked example (Appendix VII, "Illustrative Examples of Thickness Design", pp.
Analyses validated: pavement-irc-58 · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
IRC 58:2015 Appendix-V regressions — validated against the code's OWN worked
example (Appendix VII, "Illustrative Examples of Thickness Design", pp. 82–88).
WHY THIS TEST EXISTS
────────────────────
The Appendix-V equations are the flexural-stress model IRC 58:2015 Cl 6.2 actually
prescribes. They were previously recorded in this repo as unrecoverable — image-only
in the PDF — and a transcription attempt was RETRACTED rather than guessed at (the
reading tried produced a stress ratio of 4.65, i.e. 4.7× the flexural strength, and
the variant that gave the right magnitude made stress rise with slab thickness, which
is impossible for a design equation). The missing symbol was `l`.
A born-digital copy of the standard has a real text layer, in which `l` renders as
`/`; Eq (V.3) appears as `S = 0.042 + 3.26 (γh2/k/2) + 1.62 Ph/(k/4) + 0.0522 ΔT`,
i.e. `S = 0.042 + 3.26·γh²/(k·l²) + 1.62·P·h/(k·l⁴) + 0.0522·ΔT`.
That reading is not asserted — it is PROVEN here. Appendix VII publishes the flexural
stress for every axle-load class at h = 0.28 m, and every value back-solves to an exact
axle-class mid-point (190, 180, … 80 kN in 10 kN steps; 390 … 170 kN in 20 kN steps).
A mis-transcribed coefficient could not do that 60 times over.
THE EXAMPLE (Appendix VII, Pavement Option I — tied concrete shoulders, dowelled joints)
Effective modulus of subgrade reaction k = 285 MPa/m
Elastic modulus of concrete E = 30 000 MPa
Poisson's ratio µ = 0.15
Unit weight of concrete γ = 24 kN/m³
90-day design flexural strength fr = 4.95 MPa (= 4.5 × 1.1)
Day-time temperature differential (BUC) ΔT = 16.8 °C (Bihar)
Night-time differential (TDC) = 16.8/2 + 5 = 13.4 °C
Load-transfer factor (dowelled) B = 0.66
Trial slab thickness h = 0.28 m
TOLERANCE. The published stresses are printed to 3 decimal places on values of order
2 MPa, i.e. the printing itself carries up to ±0.025 %. Asserting 0.05 % is therefore
asserting agreement to the full precision the standard states — not a loose fit. The
CFD values are printed to 3 dp on values spanning 0.006 → 36.27, so those are compared
with a relative tolerance plus a small absolute floor.
Sources (all in `Geo Technical engineering books/`):
- IRC 58:2015, Appendix V pp. 73–75 (Eqs V.1–V.13 + symbol list)
- IRC 58:2015, Appendix VII pp. 82–88 (Tables VII.1–VII.4)
- IRC 58:2015, Cl 5.8.6.1 Eqs (5)–(6) — fatigue
| Test block (the published value it checks) | Verdict |
| IRC 58:2015 Appendix VII prints an inconsistent l — h=0.28 m is right, l=0.78758 m is the typo | Pass |
| Appendix-V bottom-up single axle, Eq (V.3) — 12 published stresses (IRC 58:2015 Table VII.2) | Pass |
| Appendix-V bottom-up tandem axle, Eq (V.9) — 12 published stresses (IRC 58:2015 Table VII.2) | Pass |
| Appendix-V top-down, Eq (V.13) — 36 published stresses, single + tandem + tridem (Table VII.3) | Pass |
| the tridem top-down fraction is exactly 1/3, not the "33 %" the symbol list prints | Pass |
| IRC 58:2015 fatigue Eqs (5)/(6) — the branch assignment, proven from Table VII.2 | Pass |
| reproduces IRC 58:2015 Table VII.4 cumulative fatigue damage — 20 published values exactly | Pass |
| IRC 58:2015 Table VII.4 — the h = 0.29 m top-down row is inconsistent with the rest of the table | Pass |
| the engine's own spectrum loop agrees with the published Miner sum (E-18 share regression) | Pass |
| the Appendix-V path reproduces the example verdict: 280 mm rejected, 290 mm accepted | Pass |
| the legacy Westergaard proxy still runs, is labelled, and over-designs relative to the code | Pass |
| default stress model is the code-compliant one | Pass |
| E-19: omitting ΔT is flagged as UNSAFE, not as conservative | Pass |
⚑ pavement-irc-58-web-validation.test.ts
C.IRC58 — `pavement-irc-58` web-benchmark against IRC 58:2015 itself, 26 cited values.
Analyses validated: pavement-irc-58 · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
C.IRC58 — `pavement-irc-58` web-benchmark against IRC 58:2015 itself, 26 cited values.
SOURCE
`Geo Technical engineering books/irc.gov.in.058.2015.pdf` — IRC:58-2015, *Guidelines for
the Design of Plain Jointed Rigid Pavements for Highways* (4th revision). Full text layer,
so every number below is quoted from the document rather than recalled.
─────────────────────────────────────────────────────────────────────────────────────────
AN ERRATUM IN IRC 58:2015 APPENDIX VII — READ THIS BEFORE "FIXING" ANYTHING
─────────────────────────────────────────────────────────────────────────────────────────
Appendix VII ("Illustrative Examples of Thickness Design"), Pavement Option I, states:
"Trial thickness of slab, h = 0.28 m"
"Radius of relative stiffness, l = (Eh3/(12k(1-µ2))0.25 = 0.78758 m"
with E = 30 000 MPa, k = 285 MPa/m, µ = 0.15.
**Those two statements are inconsistent with each other**, by the very formula printed
alongside them (also given in the notation list on p. 74). Evaluated:
h = 0.28 m → l = 0.66621 m
h = 0.29 m → l = 0.68398 m
h = 0.30 m → l = 0.70159 m
h = 0.35 m → l = 0.78758 m ← the published l
The published `l` corresponds to **h = 0.350 m**, not 0.28 m. Our engine reproduces
0.78758 m at h = 350 mm to five decimal places, i.e. **the engine implements IRC's formula
correctly and the example's stated trial thickness (or its stated l) is a typo.**
This is recorded prominently because the failure mode is asymmetric: anyone validating
against the book's stated (h = 0.28, l = 0.78758) pair would conclude the engine is wrong
and could "correct" it to match an erratum. The repo rule is that the expected value must
trace to a citable source — this test cites the source AND the internal contradiction, and
anchors on the formula, which is unambiguous.
─────────────────────────────────────────────────────────────────────────────────────────
SCOPE — what is and is not validated here
─────────────────────────────────────────────────────────────────────────────────────────
The module's own header carries a ⚠️ STRESS-MODEL LIMITATION block: IRC 58:2015 computes
edge flexural stress from the **Appendix-V regression equations** (fitted to IITSLAB-II
finite-element results), whereas this module uses a **Westergaard proxy** — screening only.
That disclosure is correct and must not be deleted.
So this suite validates what the module *does* implement — the radius of relative
stiffness, contact radius, Westergaard b, the PCA fatigue law, Bradbury curling, and the
documented IRC inputs — and does **not** claim the edge-stress magnitude matches
Appendix V. The Appendix-V regressions have now been extracted from the PDF and are
transcribed in `ENGINE-AUDIT-FIX-QUEUE.md` (Q-5) ready for implementation; until they are
implemented, `edge_stress_mpa` remains a proxy and this file does not pretend otherwise.
| Test block (the published value it checks) | Verdict |
| C.IRC58.1: radius of relative stiffness matches the IRC 58 formula across 8 thicknesses | Pass |
| C.IRC58.2: reproduces the PUBLISHED l = 0.78758 m exactly — at h = 350 mm (see erratum) | Pass |
| C.IRC58.3: l scales as h^0.75 and k^-0.25, as the closed form requires | Pass |
| C.IRC58.4: PCA fatigue law — the published stress-ratio regimes (Cl 5.8.6.1 Eqs 5–6) | Pass |
| C.IRC58.5: Bradbury curling coefficient peaks near L/l ≈ 8-9, then eases to 1.0 | Pass |
| C.IRC58.6: the Appendix VII case runs, converges and lands in a plausible thickness band | Pass |
| C.IRC58.7: IRC 58 Cl 5.4 night-time differential relation ΔT_night = ΔT_day/2 + 5 | Pass |
| C.IRC58.8: the output references cite the Appendix-V model actually used, and the legacy path still discloses | Pass |
pavement-me-web-validation.test.ts
Pavement-ME driver (`pavement-me.ts`) - the design-reliability layer checked against PUBLISHED values, plus the decision on what kind of engine this is.
Analyses validated: pavement-me · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Pavement-ME driver (`pavement-me.ts`) - the design-reliability layer checked against PUBLISHED values, plus the
decision on what kind of engine this is.
STATUS: BLOCKED for release - no published end-to-end answer exists for this driver, and the driver departs
from the MOP in three documented places (below). What is validated here is formula-fidelity evidence for the
reliability layer plus 8 published numbers (7 reliability z-values and the IRI standard error); the release bar
is 20 published answers and 2 sources for the DRIVER'S OWN output. The phrase "formula-fidelity" is kept in this
header on purpose so the generated validation manifest cannot promote the engine on this suite.
IS pavement-me A THIN WRAPPER? NO - it is an engine of its own. `computePavementMe` imports the layered-elastic
solver, the thermal-cracking kernel (`computeMepdgThermalCracking`), the calibration presets and the wander
factor, but it does NOT call `computeMepdgFatigue`, `computeMepdgAcRutting`, `computeMepdgSubgradeRutting` or
`computeMepdgIri`: it re-implements AC rutting (16-sublayer incremental loop), subgrade rutting (one top-strain
x 1500 mm, where the standalone kernel integrates eight sublayers), bottom-up fatigue (Miner, axle-spectrum
weighted), top-down cracking and IRI inline. A wrapper-level suite that cross-checks it against the kernels
would therefore compare two independent implementations, not a wrapper against its parts - and the two do NOT
agree, which is the point of the list below. A published end-to-end example could only validate it if the
example's climate, |E*| master curve and axle spectrum were reproduced too; the sources I could open print
whole-section results produced by AASHTOWare's own hourly EICM, which this driver approximates with monthly
means, so no honest (inputs -> rut/cracking/IRI) comparison exists.
DOCUMENTED DEPARTURES FROM THE PUBLISHED MODEL (found 2026-10-07; NOT fixed here - each changes every pavement-me
result, has a Modal/Python twin, and needs the founder's call; reported to the caller):
1. Bottom-up fatigue uses kf1 = 0.00432 (NCHRP 1-37A 2004 national calibration) while the AC-rut constants are
the NCHRP 1-40D ones and the standalone `mepdg-fatigue` uses 0.007566. The MOP 2nd ed. (printed p. 42, where Eq. 5-6's
coefficients are defined: kf1 = 0.007566) and NCDOT HWY-2007-07 Appendix F Table 7 ("National Re-calibration": kf1 0.007566) give 0.007566. The driver's
Nf is therefore 0.00432/0.007566 = 0.571 of the MOP value (more damage; conservative).
2. IRI site factor: the driver uses SF = (PI+1)(Precip+1)(P0.075+1) x 1e-4 + (FI+1) x 1e-2, a "bounded site
factor" that is not Eq. 5-15b (Age^1.5 x [ln((Precip+1)(FI+1)p02) + ln((Precip+1)(PI+1)p200)]) and contains no
age term. Its contribution is ~0.03 in/mi; the MOP form gives tens of in/mi by year 20 (FHWA-HRT-17-049
Figs. 9-11: 16-19 in/mi at age 20 from the p02/FI/precipitation term alone). pavement-me therefore
UNDER-predicts IRI relative to the MOP by roughly that amount. It cannot be replaced without a new input
(percent passing 0.02 mm).
3. (CLOSED 2026-10-17) Base-course rut WAS set to 25 % of the subgrade rut (an engineering judgement, not a MOP
equation). It is now MOP 2015 Eq. 5-2a on the base: its own layer-average strain, h, Wc, Mr and ks1 = 2.03
(see pavement-me-base-rut.test.ts).
PUBLISHED SOURCES (each opened and read for this suite, 2026-10-07):
AASHTO (2015), Mechanistic-Empirical Pavement Design Guide: A Manual of Practice, 2nd ed., Sec. 5.3.6:
"the standard error of estimate ... is 18.9 in./mi" for the flexible IRI model (printed p. 52, PDF p. 65,
SEE = 18.9 in./mi); Eqs. 5-3a-c (printed p. 41) the HMA, granular and fine-grained rut standard errors
0.24 D^0.8026 + 0.001, 0.1235 D^0.5012 + 0.001, 0.1477 D^0.6711 + 0.001 (in.), stated to sum for the total rut;
Eq. 5-7 (printed p. 44) the alligator-cracking standard error 1.13 + 13/(1 + exp(7.57 - 15.5 log10(FC + 0.0001))).
FHWA-HRT-17-049 (2017), 508 descriptions, Fig. 3: IRI model fit "N = 1,926, R squared 56 percent, standard
error of estimate 18.9 inches/mi" (https://www.fhwa.dot.gov/publications/research/infrastructure/pavements/ltpp/17049/011.cfm).
Croarkin, C. & Tobias, P. (2003), NIST/SEMATECH e-Handbook of Statistical Methods, Sec. 1.3.6.7.1, standard normal
critical values Z_p (p = 0.001, 0.005, 0.010, 0.025, 0.050, 0.100: -3.090, -2.576, -2.326, -1.960, -1.645,
-1.282): a reliability R gives the one-sided quantile z_R = -Z_(1-R), so R = 99.9, 99.5, 99, 97.5, 95, 90 %
correspond to 3.090, 2.576, 2.326, 1.960, 1.645, 1.282; N[0] = 0.5 gives z = 0 at R = 50 %.
HOW THE z-VALUES REACH THE ENGINE. The engine shifts IRI as iri_at_R = iri + z x SEE_IRI, so
(iri_at_R - iri) x 63.36 / 18.9 is the z it used (63.36 in/mi per m/km, the engine's own constant; 1 m/km =
1/0.0157828 in/mi). The expected value is the PRINTED z; the SEE is the PRINTED 18.9.
| Test block (the published value it checks) | Verdict |
| R = 50 %: IRI design shift = z x SEE = 0 x 18.9 in/mi (NIST z_R, MOP SEE_IRI) | Pass |
| R = 90 %: IRI design shift = z x SEE = 1.282 x 18.9 in/mi (NIST z_R, MOP SEE_IRI) | Pass |
| R = 95 %: IRI design shift = z x SEE = 1.645 x 18.9 in/mi (NIST z_R, MOP SEE_IRI) | Pass |
| R = 97.5 %: IRI design shift = z x SEE = 1.96 x 18.9 in/mi (NIST z_R, MOP SEE_IRI) | Pass |
| R = 99 %: IRI design shift = z x SEE = 2.326 x 18.9 in/mi (NIST z_R, MOP SEE_IRI) | Pass |
| R = 99.5 %: IRI design shift = z x SEE = 2.576 x 18.9 in/mi (NIST z_R, MOP SEE_IRI) | Pass |
| R = 99.9 %: IRI design shift = z x SEE = 3.09 x 18.9 in/mi (NIST z_R, MOP SEE_IRI) | Pass |
| MOP Eqs. 5-3a-c: the total-rut design shift is z x [se(HMA) + se(granular) + se(fine)] of the engine's own layer ruts | Pass |
| MOP Eq. 5-7: the fatigue design shift is z x [1.13 + 13/(1 + exp(7.57 - 15.5 log10(FC + 0.0001)))] at the engine's own FC | Pass |
premium-fe-pavement-web-validation.test.ts
Web-benchmark validation for the LAST EIGHT server-routed engines — the FE/pile group, layered-elastic and time-stepping pavement solvers.
Analyses validated: aircraft-gear-response, axle-load-spectra, faarfield-design, hs-layered-settlement, jpcp-time-stepping, lateral-pile-group, layered-elastic-pavement, pile-axial-load-transfer · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for the LAST EIGHT server-routed engines — the FE/pile group,
layered-elastic and time-stepping pavement solvers. This completes benchmark coverage of all
165 runner engines.
ENGINES AND SOURCES
hs-layered-settlement — Hardening-Soil stress-dependent stiffness, layered summation
pile-axial-load-transfer — t-z / q-w load transfer; API RP2A, Reese & O'Neill, hyperbolic
lateral-pile-group — p-y group analysis with p-multipliers (Reese & Van Impe)
layered-elastic-pavement — Burmister (1945) LET; Huang, Pavement Analysis & Design Ch.2-3
aircraft-gear-response — multi-wheel gear superposition; FAARFIELD-style subgrade strain
jpcp-time-stepping — MEPDG monthly incremental JPCP damage accumulation
faarfield-design — FAA AC 150/5320-6G CDF-based thickness iteration
axle-load-spectra — AASHTO fourth-power axle-load equivalency
Reached through `PREMIUM_COMPUTES`, the way the server reaches them, driven by their own
registry defaults. Override keys and select values are validated against the registry.
These are numerical solvers. They are anchored on the quantities that ARE exactly citable —
the fourth-power ESAL sum, the contact radius from load and tyre pressure, gear factors,
component sums, efficiency definitions, month counts — plus internal closures and physical
bounds. Where a solver's interior has no published worked example that is stated, not covered
with an invented number.
| Test block (the published value it checks) | Verdict |
| axle-load-spectra reproduces the AASHTO fourth-power ESAL sum exactly | Pass |
| hs-layered-settlement keeps its nonlinear and linear settlements consistent | Pass |
| pile-axial-load-transfer closes its component sums across all t-z models | Pass |
| lateral-pile-group applies p-multipliers and closes the efficiency definition | Pass |
| layered-elastic-pavement returns the two strains that drive the distress models | Pass |
| aircraft-gear-response superposes wheels and reports the gear factor | Pass |
| jpcp-time-stepping accumulates monthly damage over the design life | Pass |
| faarfield-design iterates the AC thickness to a cumulative damage factor of 1 | Pass |
rigid-slab-response-published-web-validation.test.ts
PUBLISHED-ANSWER validation of the rigid-slab closed-form response (`rigid-slab-response.ts`): radius of relative stiffness ℓ and Westergaard (1926) interior / edge / corner bending stress, plus the Westergaard corner deflection.
Analyses validated: rigid-slab-response · Recorded run: passed — 6 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-ANSWER validation of the rigid-slab closed-form response (`rigid-slab-response.ts`):
radius of relative stiffness ℓ and Westergaard (1926) interior / edge / corner bending stress, plus
the Westergaard corner deflection. Every expected number below is a NUMBER PRINTED IN A SOURCE; none
was produced by this engine or by hand. Sources actually opened (read 2026-10-06):
1. Pavement Interactive (2007), "Rigid Pavement Response Calculations", Examples 1 and 2
(https://pavementinteractive.org/reference-desk/design/structural-design/rigid-pavement-response-calculations/).
The step formulas are GIF images on the page (site upload path 2007/08); the printed results were
read from those images: b, ℓ, σi, σe, σc for a 9-in and a 12-in slab.
2. Huang, Y.H. (2004), Pavement Analysis and Design, 2nd ed., Prentice Hall, Chapter 3 worked
examples for Westergaard corner / interior loading (single circle a = 6 in and the dual-tyre
equivalent a = 7.85 in). Read in two university lecture notes that reproduce them and name Huang
(2004) as their textbook: Kareem, A.I. (2021) Rigid Pavement, Mustansiriyah University
(https://uomustansiriyah.edu.iq/media/lectures/5/5_2021_01_21!07_53_08_AM.pdf) and Jasim, A.F.
(2020) Stresses in Rigid Pavement, same university (…/5_2020_04_04!12_26_54_PM.pdf). The example
numbering below is the lecture notes' own, not verified against the book.
3. Ioannides et al. (1985), "Westergaard Solutions Reconsidered", Transportation Research Record 1043,
Table 1 (https://onlinepubs.trb.org/Onlinepubs/trr/1985/1043/1043-003.pdf): nine published
edge-loading bending stresses from Westergaard's ORIGINAL equation (semicircular load, "special
theory", column WESII).
4. IRC:58-2015, Appendix VII and VIII (Indian Roads Congress, plain jointed rigid pavements), the
printed radius of relative stiffness for E = 30 000 MPa, μ = 0.15 (file on disk in the reference
library).
5. A solved exam problem (P = 5100 kg, E = 3×10^5 kg/cm², h = 18 cm, K = 6 kg/cm³, a = 15 cm) on
ques10.com, post 34957 (https://www.ques10.com/p/34957/using-the-data-given-below-calculate-the-wheel-l-1/,
page dated 2018-11-15). The page does not name a textbook; it is a student-site solution, the
weakest source here, so it is used for four values only and never alone.
The formulas themselves are the ones Mathew, T.V. (2009) gives in NPTEL Transportation Systems
Engineering, Ch. 15 (eq. 15.1–15.5) and Pavement Interactive prints; the engine uses the SAME 1926 forms.
SCOPE — what this suite does and does not validate. It validates the closed-form outputs
(radius_of_relative_stiffness_mm, critical_stress_mpa, deflection_westergaard_mm for the corner).
It does NOT validate the finite-element outputs (deflection_fe_mm, corner_deflection_mm,
deflection_field_mm); no published FE benchmark with a matching load footprint was found.
KNOWN FORMULA-VARIANT DIFFERENCES, deliberately NOT asserted: (i) the engine's edge deflection uses
0.431·P/(kℓ²) (the a→0 limit of Westergaard 1948); Ioannides et al. (1985) Table 1 prints the 1926
original (1/√6)(1+0.4μ)=0.4327 — 0.4 % apart, a formula difference and not print rounding; (ii) the
engine's interior deflection omits Westergaard's small-a correction, 0.00677 in against Huang's
printed 0.0067 in (1 %); (iii) the corner stress uses the 1926 exponent 0.6, where IRC and Kelley use 1.2.
| Test block (the published value it checks) | Verdict |
| Pavement Interactive Example 1: 9-in slab, 9000-lb FWD load (a = 5.9 in), k = 200 pci, E = 5×10^6 psi, μ = 0.15 | Pass |
| Pavement Interactive Example 2: the same load on a 12-in slab | Pass |
| Huang (2004) Ch. 3 examples: E = 4×10^6 psi, h = 10 in, k = 100 pci, P = 10 000 lb | Pass |
| Solved problem (ques10 post 34957): P = 5100 kg, E = 3×10^5 kg/cm², h = 18 cm, μ = 0.15, K = 6 kg/cm³, a = 15 cm | Pass |
| Ioannides et al. (1985) TRR 1043 Table 1, column WESII: Westergaard ORIGINAL edge stress, semicircular load | Pass |
| IRC:58-2015 Appendix VII / VIII: printed radius of relative stiffness, E = 30 000 MPa, μ = 0.15 | Pass |
rigid-slab-response-web-validation.test.ts
Formula-fidelity validation against Westergaard (1926/1948) and Ioannides, Thompson & Barenberg (1985) "Westergaard Solutions Reconsidered" (TRR 1043) -- the classical closed-form rigid-slab interior/edge/corner stress and deflection equat…
Analyses validated: rigid-slab-response · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against Westergaard (1926/1948) and Ioannides,
Thompson & Barenberg (1985) "Westergaard Solutions Reconsidered" (TRR 1043)
-- the classical closed-form rigid-slab interior/edge/corner stress and
deflection equations this engine's `westergaardSlabStress` implements
directly and exactly (it is exported specifically so it can be validated
without the FE solver). Every expected value is hand-computed straight
from the cited published equations (verified independently in Python) --
this is the exact governing closed-form textbook solution, not a derived
approximation, so this is as close to a "textbook worked example" as this
family gets even though no single source publishes this exact combination
of inputs pre-solved.
l = [E.h^3/(12(1-mu^2).k)]^0.25
sigma_interior = (0.316P/h^2).[4.log10(l/b)+1.069]
sigma_edge = (0.572P/h^2).[4.log10(l/b)+0.359]
sigma_corner = (3P/h^2).[1-(a.sqrt2/l)^0.6]
d_interior = P/(8kl^2); d_edge = 0.431P/(kl^2); d_corner = (P/kl^2)(1.1-0.88.a.sqrt2/l)
| Test block (the published value it checks) | Verdict |
| [1-4] interior loading: l=41.572647in, sigma=136.581313psi, d=0.005885in | Pass |
| [5-6] edge loading (same geometry): sigma=209.531712psi, d=0.020291in | Pass |
| [7-8] corner loading (same geometry): sigma=178.736926psi, d=0.044304in | Pass |
| [9] edge stress exceeds interior stress exceeds nothing in particular, but corner deflection is the largest of the three (physically expected ordering) | Pass |
| [10] the edge stress here matches jpcp-cracking's edge-stress formula at identical inputs (cross-engine consistency) | Pass |
| [11] the full engine reports the same closed-form critical stress as the standalone function, in MPa | Pass |
| [12-13] radius of relative stiffness and contact radius reported in mm match the hand-computed inch values x25.4 | Pass |
| [14-15] stress ratio and factor of safety are exact reciprocals when MR is supplied | Pass |
| [16] without MR supplied, stress_ratio and stress_factor_of_safety are both null | Pass |
| [17] every load-bearing input is refused at 0 or below, never silently clamped to the 1psi floor | Pass |
stabilization-mix-web-validation.test.ts
Validation for `stabilization-mix` — cement / lime stabilised-layer binder quantity and 7-day UCS acceptance against the IRC:SP:89 / MoRTH target band (`stabilization-mix.ts`).
Analyses validated: stabilization-mix · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `stabilization-mix` — cement / lime stabilised-layer binder quantity and 7-day UCS
acceptance against the IRC:SP:89 / MoRTH target band (`stabilization-mix.ts`).
STATUS: PARTIAL — formula-fidelity evidence plus FOUR published values (the four UCS band limits).
That is 16 short of the ≥20 bar. The phrase "formula-fidelity" is kept in this header on purpose so the
validation manifest does not promote this engine to "reference-backed" on assertion-call count alone.
Published sources (each read directly in the library; none recalled from memory):
1. IRC:37-2018, Guidelines for the Design of Flexible Pavements (4th revision), Indian Roads Congress —
§7.3.2 "the cementitious sub-base (CTSB) should have a 7-day UCS of 1.5 to 3.0 MPa as per IRC:SP:89",
and §7.4 "the CTB material shall have a minimum UCS of 4.5 to 7 MPa as per IRC:SP:89 in 7/28 days".
The IRC:37-2019 reprint in the library carries the same two sentences.
2. Han, J. (2015), Principles and Practice of Ground Improvement, Wiley — §8 Eqs 8.2-8.3: dry binder content
a_c = (mass of dry binder / mass of dry soil) × 100 % and volumetric binder content
a_cv = mass of dry binder / volume of treated soil (kg/m³), the definition the engine's quantity uses.
3. FHWA-NHI-16-028 (2016), Ground Modification Methods Reference Manual Vol. II, Ch. 9 — binder content and
binder factor definitions, and the cement-stabilised-subgrade statement that cement is 3-10 % of the dry
soil weight with ≥ 150 psi 7-day UCS (a different layer type from CTSB/CTB; NOT asserted).
WHAT THE ENGINE IS. `computeStabilizationMix` returns binder kg/m³ = (binder % / 100)·dry density and accepts a
7-day UCS when target_min ≤ UCS ≤ target_max, with CTSB 1.5-3.0 MPa and CTB 4.5-7.0 MPa. The strength-gain
curve is an INPUT (no fitted model), so there is nothing else to validate against a published chart.
PUBLISHED VALUES (4): CTSB min 1.5, CTSB max 3.0, CTB min 4.5, CTB max 7.0 MPa (IRC:37-2018).
The remaining assertions are the printed definitions evaluated by hand (formula-fidelity) and the band
boundary classification logic (inclusive at both ends, which IRC:37 implies by "1.5 to 3.0" / "4.5 to 7").
SHORTFALL AND WHY. No worked mix-design example (binder %, dry density → printed kg/m³, UCS → printed
accept/reject) was found in the library (IRC:SP:89 itself and MoRTH Section 400 are not in it; FHWA, Han and
Mitchell & Soga print definitions and typical ranges, not numeric mix-design answers) or on the web.
SCOPE GAPS FOUND (reported, not changed — they are limits of the documented scope, not wrong numbers):
· IRC:37-2018 §7.3.2 also permits CTSB "grading IV" at 0.75-1.5 MPa for roads under 10 msa (modulus 400 MPa).
The engine reports UCS 0.75-1.5 MPa as "below the CTSB minimum" — fail-safe, but it would reject a layer
IRC:37 allows on low-traffic roads.
· IRC:37 states that lime / pozzolanic / lime-fly-ash stabilised CTB meets 4.5-7 MPa at 28 days rather than
7 days, and that the average laboratory strength should be 1.5 × the required field strength. The engine
applies the 7-day band only and has no 1.5× lab-to-field margin.
· The engine warns above 12 % binder ("well above normal practice"); FHWA puts cement-stabilised granular
soil at 3-10 % and Han puts deep-mixing dry binder content at 10-30 %, so the warning is right for a road
layer and should not be read as applying to deep mixing.
| Test block (the published value it checks) | Verdict |
| IRC:37-2018 §7.3.2: CTSB 7-day UCS 1.5 to 3.0 MPa (IRC:SP:89) | Pass |
| IRC:37-2018 §7.4: CTB UCS 4.5 to 7 MPa (IRC:SP:89) | Pass |
| acceptance is inclusive at both published limits and refuses just outside them | Pass |
| formula-fidelity: binder kg/m³ = (binder %/100) × dry density (Han Eq. 8.2-8.3) | Pass |
Ground improvement
Cited validation suites — 3
deep-mixing-web-validation.test.ts
`deep-mixing` — anchored to the FHWA Ground Modification worked example.
Analyses validated: deep-mixing · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`deep-mixing` — anchored to the FHWA Ground Modification worked example.
SOURCE
FHWA, "Ground Modification Methods Reference Manual — Volume II",
Publication No. FHWA-NHI-16-028, Chapter 7 "Deep Mixing and Mass Mixing":
§3.3.3 Design Example (pp. 7-29 … 7-32)
§3.3.3.2 Step 3 — "Establish Trial Soil-Cement Property Values", which is where the
strength and stiffness relations are applied to numbers
FHWA (2013) deep mixing manual, cited by §3.3.3.2 for E50 ≈ 150·qu, ν = 0.1, and the
Table 12 variability factor.
PUBLISHED DESIGN SITUATION (§3.3.3.1)
20 ft embankment, 2H:1V side slopes, 70 ft crest, traffic surcharge 250 psf, over 15 ft of
very soft silty organic soil on a hard bearing layer. Embankment γ = 125 pcf, φ = 33°.
Silty organic soil γ = 80 pcf, shear strength 50 psf. Required FoS: 1.3 for sliding entirely
within the embankment, 1.5 for sliding through the soil-cement, settlement ≤ 2 in.
PUBLISHED STEP-3 CHAIN, EVERY LINK REPRODUCED
field UCS 26 psi = 3,700 psf (dry method, slag-cement, 8.5 pcf binder)
treated unit weight 80 pcf → about 85 pcf
E50 = 150 × qu 3,840 psi = 550,000 psf
ν 0.1
M = E50(1−ν)/((1+ν)(1−2ν)) 560,000 psf
design shear strength ssc (0.5)(0.8)(1.0)(0.63)(3,700) = 930 psf
Reproduced from the printed inputs before any of it was used as an anchor; every link agrees
to within 1.4 %, which is the manual's own rounding — it prints "26 psi = 3700 psf" where
26 × 144 = 3,744 psf, a 1.2 % rounding at the very first step. A tolerance tighter than that
would fail the manual against itself.
DEFECT FOUND (E-46, unsafe direction)
The engine's composite shear strength was built from the PEAK treated strength qu/2:
composite_su = a_r·(qu/2) + (1 − a_r)·su_soil
§3.3.3.2 is explicit that a DESIGN shear strength takes FOUR factors on the field strength —
0.5 (UCS→shear) × 0.8 (peak→confined large-strain, "to provide for safety against
progressive failure") × curing × variability. At the example's values that is 0.252·qu
against the engine's 0.5·qu, so the treated component was about 1.98× the FHWA design value.
For a stability calculation that is the unsafe direction.
Fixed by adding `design_su_kpa` / `composite_design_su_kpa`, with `treated_su_kpa` now
documented as the peak. The variability factor is deliberately given NO default: the manual
derives it from its Table 12 (0.63 for a 1.5 target factor, CoV 0.60 and 70 % exceedance),
and that table is not reproduced here — inventing the number would be inventing a margin of
safety. Omit it and the design strength is `null` with an explanatory warning.
| Test block (the published value it checks) | Verdict |
| FHWA §3.3.3.2: the field UCS conversion 26 psi ≈ 3,700 psf is the manual’s own rounding | Pass |
| FHWA §3.3.3.2: E50 = 150 × qu, and the engine uses that relation | Pass |
| FHWA §3.3.3.2: the constrained modulus M = E50(1−ν)/((1+ν)(1−2ν)) with ν = 0.1 | Pass |
| E-46: FHWA §3.3.3.2 design shear strength = 0.5 × 0.8 × 1.0 × 0.63 × qu = 930 psf | Pass |
| E-46: the PEAK strength is about twice the FHWA design strength — the unsafe gap | Pass |
| E-46: without the Table 12 variability factor the design strength is NULL, not guessed | Pass |
| E-46: the four factors are each honoured, and a factor > 1 is flagged | Pass |
| §3.3.3.2: at a_r < 1 the composite strength is the area-weighted blend | Pass |
| the treated unit weight increase the manual reports is physically modest | Pass |
| every numeric output is finite or an explicit null, and the source is cited | Pass |
⚑ stone-columns-web-validation.test.ts
`stone-columns` — anchored to a published US (FHWA) source.
Analyses validated: stone-columns · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`stone-columns` — anchored to a published US (FHWA) source.
SOURCE
FHWA, "Ground Modification Methods Reference Manual — Volume I",
Publication No. FHWA-NHI-16-027, April 2017. Chapter 5 (Aggregate Columns):
§4.1.2.2 Eq. 5-1 area replacement ratio (p. 5-30)
§4.1.2.4 Eq. 5-2 … 5-5 stress concentration / load sharing (pp. 5-33 … 5-34)
§4.1.2.8 Eq. 5-7 composite shear strength (p. 5-37)
§4.3.1 Design example — rammed aggregate piers (pp. 5-46 … 5-47)
§4.3.2 Design example — stone columns (pp. 5-47 … 5-49)
Priebe, H. J. (1995), "The Design of Vibro Replacement", Ground Engineering 28(10),
pp. 31-37 — the improvement-factor closed form, cited by the manual at p. 5-25.
WHY THIS ENGINE, WHY THIS SOURCE
`stone-columns` was one of the 30 bespoke engines with ZERO published-example
validation, and it carried only Indian references (IS 15284-1:2003, IS 13094:1992).
FHWA-NHI-16-027 is a free, citable US federal manual, so it both closes the
validation gap and moves the engine off a single-region footing.
═══ TWO ERRATA IN THE MANUAL, FOUND BY REPRODUCING ITS OWN ARITHMETIC ═══
(1) §4.3.2 enters its own chart at the WRONG ABSCISSA — and this is not cosmetic.
Eq. 5-1 defines α_sc = A_sc/A where "A_sc is the AREA of the stone column after
compaction and A is the total AREA within the unit cell". For d = 3.0 ft on a
5.7 ft square grid that is:
α_sc = (π·3.0²/4) / 5.7² = 7.0686 / 32.49 = 0.2176
area improvement ratio 1/α_sc = 4.60
But the example computes "A/Asc = (5.7)²/(3.0)² = 3.6", i.e. s²/d², omitting the
π/4 and so treating the column as SQUARE. Example 1 in the very same section does
it correctly (it uses Ag = π·2.75²/4 = 5.94 ft²), so the two examples disagree.
Consequence: the settlement ratio falls as A/A_sc rises, so entering at 3.6 instead
of 4.60 OVER-STATES the improvement. At φc = 40° the Priebe closed form gives
n = 2.80 at 3.61 but only 2.31 at 4.596 — so the published "10 inches" of improved
settlement should be about 11.7 inches, roughly 21 % more. The error is on the
unsafe side.
OUR ENGINE FOLLOWS Eq. 5-1, not the example. The test below asserts that, and
asserts the engine does NOT reproduce 3.6, so nobody later "fixes" the engine to
match the erratum.
(2) §4.3.1 prints a unit-cell area that contradicts its own published result.
It shows "Ra = Ag/a = 5.94 ft/(5.25 ft)²" and publishes Ra = 0.27, but
5.94/5.25² = 0.2155. The published 0.27 is the CIRCULAR unit cell
a = (π/4)·de² = 21.65 ft² ⇒ 0.2744. The printed denominator is wrong; the
published result is right.
═══ WHAT IS ANCHORED, AND WHAT IS DELIBERATELY NOT ═══
ANCHORED: Eq. 5-1, Eqs. 5-3/5-4/5-5, Eq. 5-7, the whole of Example 1's numeric
chain (Ag, de, Ra, qg, suz), both examples' unimproved 1-D consolidation
settlements, and Priebe's n0 closed form at three column friction angles.
NOT ANCHORED: the "settlement ratio = 2.7" read off Figure 5-27. It is a
chart-read value, the figure is captioned "After Wallays et al. 1983" rather than
Priebe, and because of erratum (1) it is read at the wrong abscissa. Fitting our
engine to it would mean encoding the manual's mistake. The two candidate readings
imply materially different column friction angles (φc ≈ 38.9° at abscissa 3.61,
φc ≈ 44.8° at 4.596), both physically plausible, so the value cannot discriminate a
correct implementation from a wrong one either.
All 15 reproducible printed intermediates were checked against the printed inputs
before any of them was used as an anchor.
| Test block (the published value it checks) | Verdict |
| FHWA NHI-16-027 Eq. 5-1: α_sc = A_sc/A with A_sc = πd²/4 — an AREA ratio | Pass |
| ERRATUM (1): §4.3.2 uses s²/d² = 3.6 — the engine must NOT reproduce it | Pass |
| FHWA NHI-16-027 Eqs. 5-3 to 5-5: load sharing is self-consistent at the engine’s n and α_sc | Pass |
| FHWA NHI-16-027 §4.3.1: the RAP load-sharing chain reproduces exactly | Pass |
| ERRATUM (2): §4.3.1 prints a=de² but publishes Ra from a=(π/4)de² | Pass |
| FHWA NHI-16-027 §4.3.1 / §4.3.2: published 1-D consolidation settlements reproduce | Pass |
| Priebe (1995) n0 is reproduced at three column friction angles | Pass |
| the improvement factor is monotone in the two variables that physically drive it | Pass |
| improved settlement equals unimproved divided by the improvement factor | Pass |
| every output stays finite and the source is cited | Pass |
⚑ vibro-compaction-web-validation.test.ts
`vibro-compaction` — anchored to FHWA Ground Modification Vol I.
Analyses validated: vibro-compaction · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
`vibro-compaction` — anchored to FHWA Ground Modification Vol I.
SOURCE
FHWA, "Ground Modification Methods Reference Manual — Volume I",
Publication No. FHWA-NHI-16-027, April 2017:
Table 4-1 (Ch. 1) — applicability: vibro-compaction suits "Cohesionless soils, clean
sands with less than 15% silts and/or less than 2% clay"
Ch. 4 §3.2 / Figure 4-27 — "Soils with grain size distribution curves lying entirely
within zone B are ideally suited for vibro-compaction with fines content below
10 percent"; zone D soils "are not readily compactable by vibro-compaction.
However, these soils can be improved by vibro-replacement"
Ch. 4 Table 4-7 — Backfill Evaluation Criteria (source: Brown 1977), suitability-number
bands
Ch. 4 §3.3 — "It is unlikely, even for heavy loading, that it will be necessary to achieve
a relative density above 85 percent"
Ch. 4 §3.2 — backfill "with less than 10 percent by weight passing the #200 sieve, and
containing no clay"
WHY THIS ENGINE
`vibro-compaction` was one of the 25 bespoke engines with ZERO published-example validation.
It is built on Mitchell (1981) and Brown (1977), which is defensible — but it had never been
checked against the FHWA manual that a US contract would actually cite.
DEFECT FOUND (E-47, P3)
The engine reported a single suitability band from Mitchell (1981) — suitable at FC < 8 %,
unsuitable above 18 % — while FHWA Table 4-1 draws the line at 15 % silt AND separately
requires < 2 % clay. So a soil at FC = 16 % was reported "marginal" when FHWA would place it
outside the method's applicability, and the clay criterion was **not checked at all** — a
soil can pass on total fines and still be excluded on clay content.
Fixed by reporting the FHWA verdict ALONGSIDE the Mitchell band and flagging when they
disagree, rather than replacing one with the other. This is the same rule applied to IS 1904
vs EN 1997-1 Annex H: the two sources genuinely differ at the margins, neither is "the"
answer, and silently picking one would give a user the wrong verdict for their contract.
| Test block (the published value it checks) | Verdict |
| FHWA Table 4-1: fines below 15 % and clay below 2 % is applicable | Pass |
| FHWA §3.2: between 10 % and 15 % fines is applicable but outside the ideal zone B | Pass |
| FHWA Table 4-1: the CLAY criterion is separate — a soil can pass on fines and fail on clay | Pass |
| E-47: an unsupplied clay fraction is disclosed as UNCHECKED, not assumed compliant | Pass |
| E-47: where Mitchell and FHWA disagree, BOTH verdicts are reported and the clash is flagged | Pass |
| the two sources agree at the extremes — so the disagreement flag is not always on | Pass |
| FHWA §3.3: a target Dr above 85 % is challenged, quoting the manual | Pass |
| FHWA Table 4-7 (Brown 1977): the backfill suitability-number bands are monotonic, and the printed 40-50 gap is real | Pass |
| an unsuitable soil is credited with NO density improvement | Pass |
| closer spacing improves the achievable density, and the target is never exceeded | Pass |
| every numeric output is finite and the sources are cited | Pass |
Site investigation, in-situ and laboratory tests
Cited validation suites — 25
consistency-index-web-validation.test.ts
Validation for `consistency-index` — plasticity, liquidity and consistency indices and Skempton activity (`consistency-index.ts`, `computeConsistencyIndex`).
Analyses validated: consistency-index · Recorded run: passed — 10 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `consistency-index` — plasticity, liquidity and consistency indices and Skempton activity
(`consistency-index.ts`, `computeConsistencyIndex`).
Published sources (every number below was read from the page named beside it; none is recalled):
1. Varghese, P.C. (2005), Foundation Engineering, PHI Learning (9th printing 2012) — Ch. 1: Eq. 1.1
(consistency index, "If Ic = 0 then it is a liquid. If Ic = 1 soil is at plastic limit"), Table 1.6
(consistency bands by consistency index), Example 1.4 (activity, p. 34–35) and Example 1.5.
2. Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed. — Ch. 1, p. 10: activity between 0.75
and 1.25 is "normal", below 0.75 inactive, above 1.25 active.
3. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage — §2.6–2.8: Eq. 2.31 (LI), LI > 1
for a sensitive clay, LI < 0 for a heavily overconsolidated one, and Table 2.6 (activity of clay minerals).
4. Mitchell, J.K. & Soga, K. (2005), Fundamentals of Soil Behavior 3rd ed., Wiley — §4.6 (Eq. 4.11, Table 4.6)
and the Belle Fourche montmorillonite / Anna kaolinite activities quoted from White (1955).
5. Holtz, R.D. & Kovacs, W.D. (1981), An Introduction to Geotechnical Engineering, Prentice-Hall — §2.7–2.8:
LI < 0 brittle, 0–1 plastic, > 1 viscous liquid; 0.75 < A < 1.25 "normal". (Rendered page images.)
6. IS 2720 (Part 5) 1985 §10–11: I_L = (w − w_P)/I_P and I_C = (w_L − w)/I_P (definitions only).
7. FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Table 2-4 (LI ≥ 1 liquid, LI ≤ 0 solid).
HONEST SCOPE. Only Varghese Examples 1.4 and 1.5 are complete inputs → printed-answer worked examples (four
printed answers). The rest are published THRESHOLDS and TABLE ENDPOINTS that the engine's class labels must
agree with. PI, LI and CI are definitions, so no independent published dataset exists to test the arithmetic
against; this is formula-fidelity evidence plus published class boundaries, and is declared as such so the
manifest does not promote it. Published-value count: see the final report (not padded with engine output).
Mineral activities are tested with a 100 % clay-size separate, so PI = 100·A reproduces the printed A exactly.
| Test block (the published value it checks) | Verdict |
| Varghese Example 1.4: 20 % finer than 0.002 mm, LL = 60 %, PL = 25 % ⇒ PI = 35 %, A = 1.75 > 1.25 | Pass |
| Varghese Example 1.5: LL = 45 %, PL = 25 % ⇒ PI = 20 %, and (LL − w)/PI = 1 at w = 25 % | Pass |
| Varghese Eq. 1.1: Ic = 0 at the liquid limit (liquid) and Ic = 1 at the plastic limit | Pass |
| Varghese Table 1.6: medium Ic 0.5–0.75, stiff 0.75–1.0, very stiff / hard above 1.0 | Pass |
| Craig (2012) and Holtz & Kovacs: activity < 0.75 inactive, 0.75–1.25 normal, > 1.25 active | Pass |
| Das Table 2.6 endpoints: kaolinite 0.3–0.5, illite 0.5–1.2, montmorillonite 1.5–7.0 | Pass |
| Das Table 2.6 endpoints: halloysite 0.1–0.2 (hydrated) and 0.4–0.6 (dehydrated), attapulgite 0.4–1.3 | Pass |
| Mitchell & Soga (2005) §4.6: Belle Fourche montmorillonite 1.24–7.09, Anna kaolinite 0.30–0.41 | Pass |
| Das §2.7, Holtz & Kovacs §2.7, FHWA Table 2-4: LI > 1 liquid (sensitive clay), LI < 0 brittle / overconsolidated | Pass |
| IS 2720 (Part 5) §10–11 and Varghese: I_L + I_C = 1 for every input | Pass |
cpt-analysis-web-validation.test.ts
Web-benchmark validation for `cpt-analysis` — the CPT interpretation engine.
Analyses validated: cpt-analysis, cpt-sbt-ic · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `cpt-analysis` — the CPT interpretation engine.
WHY THIS SUITE EXISTS. `cpt-analysis` is one of the 48 bespoke analyses and had ZERO
web-validation coverage, despite CPT being the most-used in-situ test worldwide and this
engine feeding SBT, φ', Su and Dr into signed reports. Two defects were found while
writing it (E-87 citation, E-88 Dr correlation spread) — both recorded below.
SOURCE (on disk, `Geo Technical engineering books/`):
Robertson, P.K. & Cabal, K.L. (2012) "Guide to Cone Penetration Testing for
Geotechnical Engineering", 5th ed., Gregg Drilling & Testing.
- SBT zone / Ic boundary table ............ p. 26
- Ic definition .......................... p. 24
- Dr, Baldi et al. (1986) ................ p. 40 (C0 = 15.7, C2 = 2.41)
- Dr, Kulhawy & Mayne (1990) ............. p. 41 (Dr² = Qcn / 305·Qc·Qocr·Qa)
- φ', Kulhawy & Mayne (1990) ............. p. 44 (φ' = 17.6 + 11·log Qtn)
Lunne, T., Robertson, P.K. & Powell, J.J.M. (1997) "Cone Penetration Testing in
Geotechnical Practice" — Nkt ≈ 14 as the working average (range 10-18).
Expected values are computed FROM THE PUBLISHED EQUATIONS AND CONSTANTS, arithmetic
shown inline so each one is auditable. None is a number this engine produced and was
then blessed. Tolerances are stated per group and are rounding, not slop.
TEST-RIG NOTE. Every case uses a single reading at 5 m with γ = 20 kN/m³ and NO water
table, which makes σv = σv' = 100 kPa exactly. That pins Pa/σv' = 1, so the overburden
normalisation collapses to Qcn = qc[kPa]/100 = qc[MPa] × 10 and the expected Dr can be
read straight off the published curve without a second layer of arithmetic to get wrong.
| Test block (the published value it checks) | Verdict |
| rig: a 5 m reading at γ=20 with no water table gives σv = σv′ = 100 kPa | Pass |
| SBT zones straddle every published Ic boundary (R&C 2012 p.26) | Pass |
| Ic matches the published definition at three points (R&C 2012 p.24) | Pass |
| Dr (Kulhawy & Mayne 1990) matches the published relation (R&C 2012 p.41) | Pass |
| Dr (Baldi et al. 1986) matches the published relation (R&C 2012 p.40) | Pass |
| E-88: Dr correlations cross near Qcn 36 and diverge with density | Pass |
| E-88: a dense sand profile warns that Dr is correlation-dependent | Pass |
| E-87: φ′ agrees with the independent Kulhawy & Mayne form (R&C 2012 p.44) | Pass |
| Su matches (qt - σv)/Nkt with the Lunne et al. (1997) default Nkt = 14 | Pass |
cpt-analysis-worked-examples-web-validation.test.ts
cpt-analysis — FULL WORKED EXAMPLES (the ≥20-value gate).
Analyses validated: cpt-analysis, cpt-sbt-ic · Recorded run: passed — 17 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
cpt-analysis — FULL WORKED EXAMPLES (the ≥20-value gate). Every expected value is PRINTED in the
cited source, read 2026-09-29 from the reference library; values that are DERIVED by applying a
printed equation to a book's inputs are labelled as such.
[DAS] Das, Principles of Foundation Engineering (Cengage 2016), §3.21, Ex 3.4 (Dr, OCR 2).
[BOW] Bowles, Foundation Analysis and Design 5e (1997), §3-11: Ex 3-5 (φ′), Ex 3-6 (su),
and the worked illustration under Fig. 3-20 (Dr).
[RC] Robertson & Cabal, Guide to Cone Penetration Testing 5th ed. (2012): p. 27 SBTn Ic
zone boundaries; p. 42 Kulhawy & Mayne Dr and Baldi Dr constants; p. 45 φ′ equations.
[BI] Boulanger & Idriss (2014) UCD/CGM-14/01 §2: the Ic chart centre (Q 2951, F 0.06026 %).
[EC7] EN 1997-2:2007 Annex D Table D.1 (qc → φ′ bands for quartz/feldspar sands).
[LUN] Lunne, Robertson & Powell (1997) §9.2.2: measured triaxial φ′ in a very dense aged sand.
Input mapping, stated rather than hidden: Bowles and Das give σ′ directly with no water table, so
the engine is fed that unit weight with no water table (σv = σ′v). Where a book omits fs, a
plausible clean-sand fs is supplied ONLY so the reading classifies as sand-like; no asserted value
depends on it (φ′ R&C, Dr and Baldi use qc and σ′v alone).
| Test block (the published value it checks) | Verdict |
| [DAS] Ex 3.4: σ′o = 200 kPa and the printed Qcn = 141.41 | Pass |
| [DAS] Ex 3.4 with OCR 2: Q_OCR = OCR^0.18 (CPT Guide), NOT Das's printed OCR^1.8 | Pass |
| [BOW] Ex 3-5: p′o = 89.2 kPa, qc/p′o = 330, φ ≈ 46° (Fig. 3-22b) | Pass |
| [BOW] Ex 3-6: po = 216 kPa, su = 600 kPa with Nk = 18 | Pass |
| [BOW] Fig. 3-20: the Kulhawy-Mayne / Baldi band brackets Bowles's Dr ≈ 70 % | Pass |
| [RC] p. 45: tan φ′ = (1/2.68)[log(qc/σ′vo) + 0.29] — printed coefficients, not rounded | Pass |
| [RC] p. 45: Kulhawy & Mayne φ′ = 17.6 + 11 log(Qtn) | Pass |
| [RC] p. 42: Q_OCR = OCR^0.18 → Dr scales by OCR^−0.09 | Pass |
| [RC] p. 42: Q_C 0.90 (low compressibility) → Dr scales by 0.90^−0.5 | Pass |
| [RC] p. 42: Q_A = 1.2 + 0.05 log(t/100) → at t = 1000 yr, Q_A = 1.25 | Pass |
| [RC] p. 42: Baldi Dr = (1/C2) ln(Qcn/C0), C0 = 15.7, C2 = 2.41 | Pass |
| [RC] p. 42: invalid OCR (< 1) is refused, not silently used | Pass |
| [RC] p. 27: Ic zone boundaries 1.31 / 2.05 / 2.60 / 2.95 / 3.60 | Pass |
| [BI] 2014 §2: the Ic chart centre (Q 2951, F 0.06026 %) gives Ic = 0 | Pass |
| Ic parity: cpt-sbt-ic and icFromReading return the same Ic in very soft ground | Pass |
| [EC7] EN 1997-2 Table D.1: φ′ bands by qc, and Note (a) −3° for silty soil | Pass |
| [LUN] §9.2.2: past Dr = 100 % the correlation over-reads measured φ′, and says so | Pass |
⚑ cpt-sbt-ic-web-validation.test.ts
Validation for `cpt-sbt-ic` — Robertson (2009) normalised soil behaviour type index Ic with the stress exponent n iterated to convergence (`cpt-sbt-ic.ts`).
Analyses validated: cpt-sbt-ic · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `cpt-sbt-ic` — Robertson (2009) normalised soil behaviour type index Ic with the stress
exponent n iterated to convergence (`cpt-sbt-ic.ts`).
Published sources (every number below was read from the page/table named beside it):
1. NASEM (2024), "Pile Design for Downdrag: Examples and Supporting Materials", National Academies Press,
doi:10.17226/27864 — Appendix G "Design Example 5 — Liquefaction in Sand (H-Pile)", Blytheville, AR
CPT record. Table G3 prints the CPT data (depth z ft, sleeve friction fs tsf, tip resistance qt tsf,
u2 psi; water table 1 ft below ground) and Table G5 prints, for the SAME depths, the total vertical
stress (psf) and the Robertson-2009 Ic, n and Qtn computed with the iterated exponent. 54 depths are
printed; 24 are asserted below, 3 published numbers each (72 values). Read 2026-10 from the public
Appendix G web edition (nationalacademies.org/read/27864/chapter/8).
2. Robertson, P.K. & Cabal, K.L. (2012), Guide to Cone Penetration Testing 5th ed., Gregg Drilling —
the SBT zone / Ic table in the soil-behaviour-type section (zone 7 Ic < 1.31 … zone 2 Ic > 3.6), the
Ic definition (p. 24), and, in the liquefaction-evaluation section, the Ic ≤ 2.50 sand-like,
Ic > 2.70 clay-like and 2.50-2.70 transition rule and the n equation. (Page numbers of the table and the
rule were not confirmed from the page images, so only the Ic definition carries one.)
3. Niazi, F. (2021), CPT-Based Geotechnical Design Manual Vol. 1, Purdue JTRP FHWA/IN/JTRP-2021/22 — the
Ic(R&W98) SBT-zone table (Appendix A, beside Eq. A.14) and Eq. A.14 n = 0.381·Ic + 0.05·σ′vo/pa − 0.15 (Appendix A).
WHAT THE ENGINE IS. `computeCptSbtIc` forms σv = γz, u = γw(z − zw), qn = qt − σv, Fr = fs/qn, then iterates
Qtn = (qn/pa)(pa/σ′v)^n, Ic = √[(3.47 − log Qtn)² + (log Fr + 1.22)²], n = 0.381·Ic + 0.05·σ′v/pa − 0.15
(n ≤ 1) to convergence, with pa = 100 kPa, and assigns the Robertson SBT zone and a sand-like / clay-like label.
INPUT MAPPING, stated not hidden. The NASEM example varies γ with depth, the engine takes one γ, so each row is
run as a one-reading profile with γ = σv/z taken from the printed σv (psf → kPa ×0.0478803, ft → m ×0.3048,
tsf → kPa ×95.7605) and the water table at 1 ft. The example evaluates pa as 1 atm = 2116 psf (101.3 kPa);
the engine uses 100 kPa (Robertson & Cabal's "≈ 100 kPa"). That alone makes the engine's Qtn 0.5-0.7 % high
and Ic 0.002-0.003 low on every row, which is the pattern seen (and is why Ic is asserted to ±0.005).
TOLERANCES: Ic ±0.005 (printed to 3 d.p.; pa difference 0.003), n ±0.004, Qtn ±1.0 % (pa difference ≤ 0.8 %).
PUBLISHED VALUES: 72 (24 rows × Ic, n, Qtn) + 10 zone-boundary straddles (5 boundaries × 2) + 3 sand-like /
clay-like / transition rule checks = 85 assertion-backed published values.
UNRESOLVED MISMATCHES (investigated, not asserted, not hidden):
· z = 0.163 ft: the engine gives Ic 2.150 against the printed 2.190 (Qtn 125.2 vs 137.4, −8.9 %). σ′v is only
0.95 kPa there, where n and Qtn are extremely sensitive, and the printed qt is a single near-surface
reading; the source may apply an unstated low-stress treatment. Every other row is within tolerance.
· z = 3.117 ft: Ic 1.825 against 1.837 (−0.012), σ′v = 9.9 kPa; the same low-stress sensitivity, smaller.
Neither is a plausible design depth for a CPT-based classification (the top 1 m is usually disregarded).
| Test block (the published value it checks) | Verdict |
| NASEM 2024 Tables G3/G5: Ic, n, Qtn at 1.1-9.0 ft (clay-like and transitional near-surface layers) | Pass |
| NASEM 2024 Tables G3/G5: Ic, n, Qtn at 10.0-20.8 ft (sand with silty seams) | Pass |
| NASEM 2024 Tables G3/G5: Ic, n, Qtn at 24.8-52.5 ft (clean to silty sand) | Pass |
| R&C 2012 / Niazi 2021: zone 7 < 1.31 < zone 6 < 2.05 < zone 5 < 2.60 < zone 4 < 2.95 < zone 3 < 3.60 < zone 2 | Pass |
| R&C 2012: behaviour is sand-like at Ic ≤ 2.50, clay-like above 2.70 and transitional between (NASEM rows) | Pass |
⚑ cptu-dissipation-web-validation.test.ts
Validation for `cptu-dissipation` — Teh & Houlsby horizontal coefficient of consolidation from a CPTu dissipation test, ch = T*50·r²·√Ir / t50 (`cptu-dissipation.ts`).
Analyses validated: cptu-dissipation · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `cptu-dissipation` — Teh & Houlsby horizontal coefficient of consolidation from a CPTu
dissipation test, ch = T*50·r²·√Ir / t50 (`cptu-dissipation.ts`).
STATUS: PARTIAL — formula-fidelity evidence plus TWO published values (T*50 for the u1 and u2 filter
positions). That is 18 short of the ≥20 bar. The phrase "formula-fidelity" is kept in this header on
purpose so the validation manifest does not promote this engine to "reference-backed" on assertion-call
count alone.
Published sources (each read directly; none recalled from memory):
1. Niazi, F. (2021), CPT-Based Geotechnical Design Manual Vol. 1, Joint Transportation Research Program
FHWA/IN/JTRP-2021/22, Purdue University — §2.3.14.4 Eq. 2.120
(ch = T*50·(a_c)²·√IR / t50, T*50 = 0.118 for type 1 / mid-face u1 and 0.245 for type 2 / shoulder u2,
a_c = 1.78 cm for a 10 cm² cone and 2.20 cm for 15 cm²), and Table 2.18 "Modified time factors T* from
consolidation analysis (from Houlsby & Teh, 1988)", p. 76-77. Read from the public JTRP PDF.
2. The Rocscience Settle3 CPT Theory Manual §2.27 "Coefficient of consolidation" —
ch = T*·a²·√IR / t50 with T* = 0.245 for the shoulder position and a = 1.78 cm for a 10 cm² cone.
3. Robertson, P.K. & Cabal, K.L. (2012), Guide to Cone Penetration Testing 5th ed., Gregg Drilling —
p. 55-57: c = T50·r0²/t50 interpreted at 50 % dissipation using the Teh & Houlsby (1991) solution
(Fig. 35) for a u2 sensor; the guide prints no T50 numbers of its own and no worked example.
4. Look, B.G. (2007), Handbook of Geotechnical Investigation and Design Tables, Taylor & Francis —
§8.15 Table 8.15 "Coefficient of consolidation from measured time to 50 % dissipation (Mayne 2002)",
p. 97-98: ch bands in cm²/min and m²/yr against t50 for a u2 filter on a 10 cm² piezocone, with the
note "multiply by 1.5 for 15 cm² piezocones".
PUBLISHED VALUES (9 exact + 5 band checks):
· T*50 (u1) = 0.118 and T*50 (u2) = 0.245 (Niazi Table 2.18; Settle3 confirms the u2 value) — 2.
· Look Table 8.15 "multiply by 1.5 for 15 cm² piezocones" — 1 (ch ∝ r²: (21.85/17.85)² = 1.498).
· Look Table 8.15 cm²/min → m²/yr pairs 0.001→0.05, 0.01→0.5, 0.1→5.3, 1→53, 10→525, 200→10,500 — 6
(these test the engine's year/unit conversion, not the mechanics).
· Look Table 8.15 ch bands: for each of the five bands the engine's ch, at the geometric-mean t50 of the band
and for the usual rigidity-index range Ir = 50-500, must fall inside the printed ch band — 5 RANGE checks,
reported separately from the 9 exact values because a band contains a value rather than fixing one. The
table's rows are from Mayne's chart over a spread of Ir, so the band edges are not one-to-one.
SHORTFALL AND WHY. 11 exact published values short of the bar. No worked numeric example (t50, radius, Ir →
printed ch) was found in the library (Craig, Das, Bowles, Mitchell & Soga and the FHWA soils manual were
searched for Houlsby / dissipation-test treatment and have none; the Lunne-Robertson-Powell book is an
image-only scan whose dissipation chapter was not transcribed in the time available) or on the web (the
Datgel CPT Tool and CPeT-IT documentation describe the procedure but print no result; the Robertson et al.
1992 site table gives t50 and field ch read from a chart that depends on an unstated Ir). The tests labelled
formula-fidelity below are the printed equation evaluated by hand — they prove the implementation matches
the equation, and cannot prove the equation describes a real soil.
NOT ASSERTED (investigated): the engine's docstring suggests radius 17.85 mm (10 cm²) and 21.85 mm (15 cm²);
Niazi prints 1.78 cm and 2.20 cm. They differ by 0.3 % and 0.7 % in r, i.e. 0.6 % and 1.4 % in ch —
well inside the ±½-order-of-magnitude reliability that Robertson & Cabal state for the method, so this is
not treated as a disagreement.
| Test block (the published value it checks) | Verdict |
| Niazi (2021) Table 2.18 / Eq. 2.120: T*50 = 0.245 (u2 shoulder) and 0.118 (u1 mid-face) | Pass |
| Look Table 8.15: "multiply by 1.5 for 15 cm² piezocones" — the 15 cm² radius gives ×1.5 in ch | Pass |
| Look Table 8.15: ch in cm²/min converts to the printed m²/yr (0.05, 0.5, 5.3, 53, 525, 10,500) | Pass |
| Look Table 8.15 bands: ch at the band-centre t50 lies inside the printed ch band for Ir = 50-500 | Pass |
| formula-fidelity: Eq. 2.120 for a 10 cm² u2 cone, Ir = 100, t50 = 100 s | Pass |
| formula-fidelity: ch scales as √Ir / t50 and as r²; u1 is 0.118/0.245 of u2 at equal inputs | Pass |
| formula-fidelity: kh = ch·mv·γw with mv in m²/MN and γw = 9.81 kN/m³ | Pass |
⚑ dmt-web-validation.test.ts
Published-benchmark validation for the flat dilatometer (DMT) interpretation (`dmt.ts`, `computeDmt`).
Analyses validated: dmt · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-benchmark validation for the flat dilatometer (DMT) interpretation (`dmt.ts`, `computeDmt`).
the release rules gate: every expected value is a number printed in the source below, which was opened for
this suite (the figure was rendered from the PDF and read as an image — it has no text layer).
SOURCE
Marchetti, S., Monaco, P., Totani, G. and Calabrese, M. (2001), "The Flat Dilatometer Test (DMT) in
Soil Investigations — A Report by the ISSMGE Committee TC16", Fig. 31 "Example of numerical output of
DMT results (1 bar = 100 kPa)" (test D3 of 1989, reduction formulae of the 1980 ASCE paper),
p. 29–30 of the report; equations (3)–(7), (10)–(12) and Table 1 of the same report.
Fig. 31 tabulates, per depth, the corrected readings P0, P1, the effective stress Σ′ and pore
pressure U (all in bar) and the interpreted ID, KD, ED, K0, OCR, φ, M and cu. The table is a real
program output, so it is a true input → output benchmark.
HOW THE COMPARISON IS MADE (tolerance derived, not fitted)
· The table prints P0 and P1 to 0.1 bar and Σ′, U to 0.01 bar. Each printed input is therefore only
known to ±half a unit. The engine is evaluated at all 16 corners of that rounding box (every
interpreted quantity is monotone in each input, so the corners bracket the range) and the printed
OUTPUT must lie within that bracket widened by half a unit of ITS printed digits (ID 0.005, KD 0.05,
K0 0.05, OCR 0.05, cu 0.005 bar, φ 0.5°, and for RM = M/ED the propagated ±0.5 rounding of M and ED).
This is the strongest statement the printed precision allows.
· Rows chosen before running the engine: every clay / silt row of the table at the depths listed
below plus the sand rows with ID > 1.8 (the engine computes φ only for ID > 1.8; the table also
prints φ for 1.2 ≤ ID ≤ 1.8, which the engine deliberately leaves blank).
UNRESOLVED MISMATCH (not asserted; reported): the table's ED and M column are 6–7 % ABOVE
ED = 34.7 (p1 − p0) applied to its own printed P0, P1 — e.g. depth 3.20 m: 34.7 × 3.8 bar = 132 bar
against the printed 140; the whole-column ratio ED / (P1 − P0) is 36.8–38.6, never 34.7, and the
shortfall exceeds the ±0.1 bar input rounding (the 16-corner bracket is [128.4, 135.3] bar). The same
report's own eq. (5) prints 34.7, as do two standard foundation-engineering textbooks (equations only, no
numbers to compare), and the engine follows that. The ratio M/ED, which depends only on RM(ID, KD), does
agree, so the discrepancy is in the table's ED column (the 1989 program's ED constant or an unprinted
correction), not in Table 1.
SHORTFALL (honest statement): one numeric source. No second local or web document carrying a solved
DMT data-reduction example with outputs could be opened (the Newcastle open textbook page returned HTTP 403;
the textbooks print only the equations, and one gives a small input data set without outputs).
| Test block (the published value it checks) | Verdict |
| TC16 Fig. 31, z = 1.00 m (P0 1.2, P1 3.5, Σ′ 0.17, U 0.0 bar) | Pass |
| TC16 Fig. 31, z = 1.20 m (P0 1.6, P1 3.4, Σ′ 0.21, U 0.0 bar) | Pass |
| TC16 Fig. 31, z = 1.80 m (P0 2.4, P1 3.0, Σ′ 0.28, U 0.03 bar) | Pass |
| TC16 Fig. 31, z = 2.00 m (P0 2.4, P1 2.8, Σ′ 0.29, U 0.05 bar) | Pass |
| TC16 Fig. 31, z = 2.40 m (P0 1.9, P1 3.8, Σ′ 0.31, U 0.09 bar) | Pass |
| TC16 Fig. 31, z = 3.20 m (P0 2.2, P1 6.0, Σ′ 0.36, U 0.17 bar) | Pass |
| TC16 Fig. 31, z = 3.60 m (P0 2.0, P1 5.4, Σ′ 0.39, U 0.21 bar) | Pass |
| TC16 Fig. 31, z = 3.80 m (P0 2.5, P1 6.8, Σ′ 0.41, U 0.23 bar) | Pass |
| TC16 Fig. 31, z = 5.60 m (P0 3.2, P1 3.8, Σ′ 0.55, U 0.4 bar) | Pass |
| TC16 Fig. 31, z = 7.40 m (P0 3.1, P1 5.8, Σ′ 0.68, U 0.58 bar) | Pass |
| TC16 Fig. 31, z = 8.00 m (P0 3.1, P1 4.0, Σ′ 0.72, U 0.64 bar) | Pass |
| TC16 Fig. 31, z = 9.00 m (P0 3.3, P1 4.0, Σ′ 0.79, U 0.74 bar) | Pass |
| TC16 Fig. 31, z = 10.00 m (P0 3.4, P1 4.2, Σ′ 0.85, U 0.83 bar) | Pass |
⚑ ert-published-tables-web-validation.test.ts
Published-value validation for `ert` — array geometric factors, median depth of investigation and the soil corrosivity bands.
Analyses validated: ert · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-value validation for `ert` — array geometric factors, median depth of investigation and the soil
corrosivity bands. (The existing `ert-web-validation.test.ts` anchors the VES forward model to the exact
two-layer series; this suite adds the PRINTED numbers that suite does not have.)
PUBLISHED SOURCES (each opened and read for this suite):
1. Loke, M.H. (2004), "Tutorial: 2-D and 3-D electrical imaging surveys", Geotomo Software (revision dated
2004-07-26), Table 2.1 "The median depth of investigation (ze) for the different arrays", credited there to
the Edwards median-depth analysis (that paper itself was not opened), which prints, per array, ze/a and the
geometric factor for a = 1.0 m: Wenner alpha; dipole-dipole n = 1-8; Wenner-Schlumberger n = 1-10. Also
Equation (1.9) and Figure 1.4. Downloaded from
https://sites.ualberta.ca/~unsworth/UA-classes/223/loke_course_notes.pdf and read 2026-10-06.
2. Telford, W.M., Geldart, L.P. & Sheriff, R.E. (1990), Applied Geophysics, 2nd ed., Cambridge University
Press (library copy): Chapter 8 Equations (8.27) Wenner ρa = 2πa·ΔV/I and (8.34) Schlumberger — the
formulas the geometric factors come from. They print no worked numeric answer, so no Telford number is
asserted here; the Loke table supplies the numbers that these formulas must reproduce.
3. Roberge, P.R., Corrosion Basics: An Introduction, 2nd ed., NACE Press — the soil-resistivity corrosivity
table (> 20 000 Ω·cm essentially non-corrosive; 10 000-20 000 mildly; 5 000-10 000 moderately; 3 000-5 000
corrosive; 1 000-3 000 highly; < 1 000 extremely), read as reproduced at
https://www.matcor.com/soil-resistivity-testing/ (which names the book) and at
https://corrosion-doctors.org/SoilCorrosion/Severity.htm on 2026-10-06. ⚠ Secondary reproductions of
the table; the book itself and its printing year were not opened.
WHAT IS PUBLISHED ANSWER HERE. Loke's Table 2.1 prints K and ze/a to 3-5 significant figures for named arrays
and separations n; each `near(...)` below is one printed number. The engine's Schlumberger input (L = AB/2,
l = MN/2) covers the Wenner-Schlumberger array with a = MN = 2l and n = L/(2l) − ½ (then K = π·n(n+1)·a, which is
Loke's Wenner-Schlumberger factor), so Loke's n = 1-10 rows are entered as L = n + ½, l = ½ (a = 1 m).
VALIDATION-PASS FINDING, fixed in `ert.ts`. This table shows the engine's old pseudo-depths — Schlumberger
ze = 0.25·AB and dipole-dipole ze = 0.25·(n+1)·a, labelled as the Edwards values — were not those values: 31-45 %
too deep for Schlumberger (printed ze/AB 0.173-0.191) and 20 % too deep for dipole-dipole n = 1 (printed
ze/a 0.416 against the old 0.5). `ert.ts` now interpolates Loke's Table 2.1; the three existing tests that had
pinned the old rules (ert-audit, ert-web-validation) were updated to the table values.
One table entry is NOT asserted because the source disagrees with itself: Wenner-Schlumberger n = 2 prints ze/a = 0.925
and ze/L = 0.186, but 0.925 / 5 = 0.185 (an earlier printing of the same table gives ze/a = 0.93, which is
consistent with 0.186). The ze/a value is used; the ze/L value is left out.
Tolerance: half a unit in the last printed digit of each table entry (K to 5 significant figures, ze/a to 3 decimals).
Corrosivity band EDGES are exact by construction (the published edges are integers in Ω·cm).
| Test block (the published value it checks) | Verdict |
| Loke (2004) Table 2.1: Wenner alpha — geometric factor 6.2832 and ze/a = 0.519 (a = 1 m) | Pass |
| Loke (2004) Table 2.1: dipole-dipole geometric factors (a = 1 m), n = 1-8 | Pass |
| Loke (2004) Table 2.1: dipole-dipole median depth ze/a, n = 1-8 | Pass |
| Loke (2004) Table 2.1: Wenner-Schlumberger geometric factors (a = 1 m), n = 1-10 | Pass |
| Loke (2004) Table 2.1: Wenner-Schlumberger median depth ze/a, n = 1-10 | Pass |
| Loke (2004) Table 2.1: ze/L for Wenner-Schlumberger (L = AB = (2n+1)a) and dipole-dipole (L = (n+2)a) | Pass |
| Loke (2004) Eq. (1.10): ρa = k·R with the printed Wenner factor 6.2832 (a = 1 m) and the printed DD n = 1 factor 18.850 | Pass |
| Roberge soil-corrosivity table: engine bands at the published edges (Ω·m = Ω·cm / 100) | Pass |
ert-web-validation.test.ts
Web-benchmark validation for `ert` — array geometric factors, depth of investigation, and the VES forward model.
Analyses validated: ert · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `ert` — array geometric factors, depth of investigation, and
the VES forward model.
THE ANCHOR, and why it is stronger than a textbook table here. For a two-layer earth the
Schlumberger apparent-resistivity curve has an EXACT closed form:
ρa(L) = ρ1·[ 1 + 2 Σ_{n=1..∞} kⁿ / (1 + (2nh/L)²)^{3/2} ], k = (ρ2 − ρ1)/(ρ2 + ρ1)
and the Wenner curve likewise:
ρa(a) = ρ1·[ 1 + 4 Σ_{n=1..∞} kⁿ ( 1/√(1+(2nh/a)²) − 1/√(4+(2nh/a)²) ) ]
Both are published verbatim as **Telford, Geldart & Sheriff, "Applied Geophysics" 2nd ed.,
§8 — Eq. (8.38) for Wenner and Eq. (8.39b) for Schlumberger** (Cambridge; on disk), and
also appear in Koefoed, "Geosounding Principles 1" (Elsevier, on disk). They are
implemented INDEPENDENTLY below and additionally self-verified by their own limits — L→0
must give ρ1 (all terms vanish) and L→∞ must give ρ2 (the series sums to (1+k)/(1−k)).
A digitised chart can only be read to two figures; an exact series can be asserted to
machine precision, which is why this is the better anchor.
WHY THIS SUITE EXISTS — E-98. The Ghosh (1971) 9-point digital filter previously used for
the forward model was up to **125.7 %** wrong against the curve above, and qualitatively
wrong in shape (a resistive-basement curve that should rise monotonically dipped instead).
It survived because `ert-solver.test.ts` validated by "synthetic recovery" — forward-model
with the filter, invert with the filter, check the layers return. That loop is
self-consistent regardless of how wrong the shared kernel is, and cannot detect this class
of defect even in principle. Only an independent analytical check could, so here it is.
| Test block (the published value it checks) | Verdict |
| the analytical two-layer curves satisfy their own limits | Pass |
| E-98: the Wenner forward model matches Telford Eq. (8.38) to <0.5 % | Pass |
| E-98: the Wenner prefactor is 2a, and 4a is not a near miss | Pass |
| E-98: the Schlumberger forward model matches Telford Eq. (8.39b) to <0.5 % | Pass |
| E-98: the curve SHAPE is right, not just the magnitude | Pass |
| E-98: Wenner inversion recovers a two-layer earth from the EXACT Wenner curve | Pass |
| E-98: Schlumberger inversion recovers a two-layer earth from the EXACT curve | Pass |
| geometric factors K match the published array definitions | Pass |
| ρa = K·(V/I) reproduces a known homogeneous half-space | Pass |
| corrosivity bands break at the published NACE/Roberge edges | Pass |
| the governing corrosivity is the WORST layer, not an average | Pass |
field-density-web-validation.test.ts
Web-benchmark validation for `field-density` — in-situ density by sand replacement or core cutter.
Analyses validated: field-density · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `field-density` — in-situ density by sand replacement or
core cutter.
SOURCES (each cited at the assertion that uses it):
IS 2720 (Part 28):1974 — sand-replacement method (and ASTM D1556, the same procedure).
IS 2720 (Part 29):1975 — core-cutter method.
IS 2720 (Part 7/8) — Proctor MDD/OMC, the reference for degree of compaction.
These are DEFINITIONAL relations, not correlations, so they can be asserted to machine
precision rather than to a chart tolerance:
V_hole = (total sand poured − cone/base-plate calibration) / ρ_sand [IS 2720-28]
γ_bulk = m_wet / V
γ_dry = γ_bulk / (1 + w/100)
DoC = γ_dry / MDD × 100
e = Gs·γw/γ_dry − 1 (γw = 1 g/cc basis)
n_a = 1 − γ_dry(1/Gs + w/100) air voids, same basis
Every expected value has its arithmetic written out so it can be checked without running
the engine.
| Test block (the published value it checks) | Verdict |
| core cutter reproduces the IS 2720-29 chain on a hand-computed case | Pass |
| sand replacement subtracts the cone/base-plate mass, per IS 2720-28 | Pass |
| omitting the cone correction over-states volume and under-reports compaction | Pass |
| air voids reach zero exactly at full saturation | Pass |
| an impossible (over-saturated) input is clamped and flagged, not returned negative | Pass |
| the compaction verdict follows the stated requirement, default 95 % | Pass |
| a DoC above 102 % is flagged as a suspect Proctor reference | Pass |
| both methods name their IS standard | Pass |
gradation-indices-web-validation.test.ts
PUBLISHED-VALUES: 12 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: 12 distinct printed Cu/Cc values; the rest repeat them or are verdict/threshold checks.
Analyses validated: gradation-indices · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 12 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: 12 distinct printed Cu/Cc values; the rest repeat them or are verdict/threshold checks. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Validation of the gradation-indices engine (`gradation-indices.ts`): the uniformity coefficient
Cu = D60/D10, the coefficient of curvature Cc = D30²/(D60·D10) and the well-graded test of
ASTM D2487 Table 1. the release rules release gate: >= 20 published values from >= 2 sources.
SOURCES (each opened and read directly)
Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Example 1.1 (p. 20-21,
Table B): D10, D30, D60 read from the particle-size curves of soils A, B, C and the printed
Cu and Cz, plus the classification GW / SPu that follows from them.
FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Section 4.2.1.1,
Figure 4-2 (p. 4-19/4-20): three curves A, B, C with printed D10, D30, D60, Cu, Cc and a
printed gradation verdict; Equations 4-1, 4-2 and Table 4-10.
ASTM D2487 (2006), Table 1 and Appendix X1 / X2: the well-graded criteria (gravel Cu >= 4,
sand Cu >= 6, 1 <= Cc <= 3) and the classified examples X1.1.1 and X2.4.3.
Bowles, J.E. (1996), Foundation Analysis and Design 5th ed., Section 2-6 (soil description
table following Table 2-1): "Sand, Cu = 7; Cc = 1.3 ... Well-graded ... SW".
TOLERANCES ARE THE SOURCES' OWN ROUNDING. Craig prints Cu and Cz to 2 significant figures from
D-values read to 2 significant figures; FHWA prints Cu to 1 decimal and Cc to 1-2 decimals. Each
tolerance below is half a unit of the last printed digit (plus 1e-9 so that an exact half-unit,
such as 0.245 printed as 0.25, is not failed by floating-point noise).
WHAT IS AND IS NOT A PUBLISHED VALUE HERE. ASTM X1.1.1, X2.4.3 and Bowles give Cu and Cc
directly, not D10/D30/D60, so the engine is driven with constructed diameters (D10 = 1 mm,
D60 = Cu, D30 = sqrt(Cc·Cu)) and ONLY the published classification verdict is asserted — the
echoed Cu and Cc would be circular. The four boundary checks at the end exercise the printed
thresholds of ASTM Table 1 themselves and are listed as criteria checks, not worked answers.
| Test block (the published value it checks) | Verdict |
| Knappett & Craig (2012) Ex. 1.1 — soil A: Cu = 34, Cz = 1.6, well-graded gravel (GW) | Pass |
| Knappett & Craig (2012) Ex. 1.1 — soil B: Cu = 1.8, Cz = 0.95, uniform sand (SPu) | Pass |
| Knappett & Craig (2012) Ex. 1.1 — soil C: Cu = 800, Cz = 0.25 | Pass |
| FHWA-NHI-06-088 Fig. 4-2 — curve A: Cu = 8.0, Cc = 0.9, fails the Table 4-10 well-graded criteria | Pass |
| FHWA-NHI-06-088 Fig. 4-2 — curve B: Cu = 2.0, Cc = 1.12, criteria say poorly graded | Pass |
| FHWA-NHI-06-088 Fig. 4-2 — curve C: Cu = 1.4, Cc = 1.2, poorly graded | Pass |
| FHWA-NHI-06-088 Fig. 4-2 — curve A through the registry (RUNNER_CONFIGS) gives the printed indices | Pass |
| ASTM D2487 X1.1.1 — Cu = 12.4, Cc = 2.7 gravel is classified GW (well graded) | Pass |
| ASTM D2487 X2.4.3 — Cu = 1.9, Cc = 2.4 gravel is classified GP (poorly graded) | Pass |
| Bowles (1996) — sand with Cu = 7, Cc = 1.3 is "well-graded ... SW" | Pass |
| ASTM D2487 Table 1 — gravel needs Cu >= 4, sand needs Cu >= 6, both need 1 <= Cc <= 3 | Pass |
index-outputs-web-validation.test.ts
index-outputs-web-validation.test.ts
Analyses validated: barton-bandis, soil-classification, steel-pile-section · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
index-outputs-web-validation.test.ts
Third pass down the `scripts/unvalidated-outputs.mjs` list. These are the everyday
outputs — a USCS name, an AASHTO group index, a joint friction angle, a section
modulus — which is precisely why they went unanchored: nobody doubts them, so nobody
checked them. A soil classification is read by more engineers than any 3-D solve in
the catalogue, and a wrong group index changes a pavement design.
Every expected value traces to the governing standard's own worked rule, computed
independently in the test:
· ASTM D2487-17 / IS 1498:1970 — USCS symbols and names; the Casagrande A-line
PI = 0.73(LL − 20) and the LL = 50 split between low and high plasticity.
· AASHTO M 145 Cl 5.4 — group index
GI = (F − 35)[0.2 + 0.005(LL − 40)] + 0.01(F − 15)(PI − 10),
clamped to 0..20 and rounded; reported as 0 for the granular A-1/A-2-4/A-2-5/A-3
groups.
· Barton & Choubey (1977) — the joint-roughness peak strength criterion
φ_peak = φ_r + JRC·log₁₀(JCS/σ′n), τ = σ′n·tan(φ_peak)
with the dilation component i = JRC·log₁₀(JCS/σ′n).
· Elementary section mechanics for the steel section moduli, checked against the
exact closed forms for the shape rather than against a table lookup.
| Test block (the published value it checks) | Verdict |
| soil-classification: AASHTO group index matches M 145 Cl 5.4 and is floored at 0 with no upper cap (7 anchors) | Pass |
| soil-classification: the Casagrande chart places soils on the right side of the A-line (8 anchors) | Pass |
| soil-classification: every displayed output is present and non-empty on the defaults | Pass |
| barton-bandis: φ_peak = φ_r + JRC·log₁₀(JCS/σ′n), and τ follows from it (8 anchors) | Pass |
| steel-pile-section: the elastic and plastic moduli are consistent with each other and the shape | Pass |
index-properties-web-validation.test.ts
Web-benchmark validation for NINE index-property, classification and stress-state runner engines.
Analyses validated: compression-index, consistency-index, consolidation-degree, gradation-indices, phase-relations, pore-pressure-parameters, quick-condition, soil-classification, stress-path · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for NINE index-property, classification and stress-state runner
engines. Family suite, for the same reason as `classical-closed-forms-web-validation.test.ts`:
each is a single published relation, so each needs exact assertions rather than a file of its
own. The filename-keyed counter therefore sees one file where nine engines were anchored — the
ledger carries a separate row for family coverage.
ENGINES AND SOURCES (each cited at its own test):
phase-relations — the phase diagram identities (e, n, S, γ_bulk, γ_sat, γ′)
consistency-index — Atterberg indices; Skempton (1953) activity
gradation-indices — C_u, C_c and the USCS well-graded criteria (ASTM D2487)
compression-index — five published C_c correlations (Skempton, Terzaghi & Peck,
Azzouz et al. 1976, Hough, Nagaraj & Murthy)
soil-classification — USCS (ASTM D2487) Casagrande A-line + AASHTO M 145 group index
stress-path — p-q and s-t invariants; the critical-state M line
pore-pressure-parameters — Skempton (1954) Δu = B[Δσ₃ + A(Δσ₁ − Δσ₃)]
quick-condition — Terzaghi critical gradient i_crit = (G_s − 1)/(1 + e)
consolidation-degree — Terzaghi U-T_v relation
Every expected value is computed from the published expression with the arithmetic shown.
| Test block (the published value it checks) | Verdict |
| phase-relations satisfies every phase-diagram identity exactly | Pass |
| consistency-index reproduces the Atterberg definitions and Skempton activity | Pass |
| gradation-indices computes C_u and C_c and applies the ASTM D2487 criteria | Pass |
| compression-index reproduces all five published C_c correlations | Pass |
| soil-classification places the soil on the Casagrande chart and computes the AASHTO GI | Pass |
| stress-path computes both invariant pairs and the M line consistently | Pass |
| pore-pressure-parameters follows Skempton (1954) Δu = B[Δσ₃ + A(Δσ₁ − Δσ₃)] | Pass |
| quick-condition uses the Terzaghi critical gradient (G_s − 1)/(1 + e) | Pass |
| consolidation-degree inverts the Terzaghi U-T_v relation both ways | Pass |
⚑ phase-relations-web-validation.test.ts
Validation of the soil phase-relation engine (`phase-relations.ts`) against PUBLISHED worked examples and PUBLISHED problem answers.
Analyses validated: phase-relations · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the soil phase-relation engine (`phase-relations.ts`) against PUBLISHED worked
examples and PUBLISHED problem answers. the release rules release gate: >= 20 published values, >= 2 sources.
SOURCES (both opened and read directly from the reference library PDFs):
Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage, Chapter 2
Worked Examples 2.1, 2.2, 2.3, 2.4, 2.6 (pp. 18-22) and the printed "Answers to Problems"
(p. 900) for Problems 2.1, 2.2, 2.3 (p. 69).
Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Spon Press,
Chapter 1, Example 1.2 (pp. 25-26; equations 1.19, 1.22 — page images read, not OCR text).
HOW A PUBLISHED EXAMPLE IS MAPPED ONTO THE ENGINE. The engine's inputs are (Gs, γd, w, γw) and it
returns (e, n, Sr, γ, γsat, γ'). Each book example states its own measured data (mass and volume, or
a bulk unit weight and w). The dry unit weight is derived from that data exactly as the book does
(γd = γ/(1+w), or mass/volume), and the engine is asked for the quantities the book PRINTS as answers.
Where a book quantity is itself an input of the engine (Gs, w) it is passed through unchanged.
Nothing in this file is an expected value produced by this repository's own engine.
TOLERANCES ARE THE BOOKS' OWN ROUNDING. Das prints e to 2-3 decimals and computes n and Sr from the
ALREADY-ROUNDED e, so a published Sr can differ from the exact value by up to the relative rounding
of e (+-0.005/0.66 = 0.76 %, i.e. about 0.4 percentage points on Sr = 52 %). Each tolerance below is
stated beside the assertion together with the rounding that justifies it; none was widened to pass.
UNITS. The engine is unit-homogeneous (gamma_w_kn_m3 is just the unit weight of water in whatever
unit the dry unit weight is given). Das Problem 2.3 and Example 2.6 are in lb/ft³ with γw = 62.4 pcf
— the value the book itself uses — so they also exercise that path.
OMITTED ON PURPOSE. Das Problem 2.4 (saturated, w = 36 %, γd = 85.43 pcf): the printed answer
γsat = 115.9 pcf cannot be reproduced from the problem's own data (a saturated soil has
γsat = γd(1+w) = 116.2 pcf whatever Gs is). That is an inconsistency inside the answer key, not an
engine disagreement, and an assertion built on it would prove nothing.
| Test block (the published value it checks) | Verdict |
| Das (2016) Ex. 2.1 — 1.8 kN in 0.1 m³, w = 12.6 %, Gs = 2.71 | Pass |
| Das (2016) Ex. 2.3 — γ = 19.2 kN/m³, w = 9.8 %, Gs = 2.69 | Pass |
| Das (2016) Ex. 2.4 — densities and the water needed to saturate (Gs = 2.68, e = 0.83) | Pass |
| Das (2016) Ex. 2.2 — n = 0.387, ρd = 1600 kg/m³ gives e = 0.631 with the printed Gs = 2.61 | Pass |
| Das (2016) Ex. 2.6 — γ = 108 pcf, w = 8 %, Gs = 2.65 (US units) | Pass |
| Das (2016) Problem 2.1 — 87.5 kg in 0.05 m³, w = 15 %, Gs = 2.68 (printed answers) | Pass |
| Das (2016) Problem 2.2 — saturated soil: the printed γd and Gs give back γsat = 20.1 kN/m³ | Pass |
| Das (2016) Problem 2.3 — γ = 119.5 pcf, w = 12 %, Gs = 2.65 (printed answers) | Pass |
| Knappett & Craig (2012) Ex. 1.2 — ρ = 1990 kg/m³, w = 12.5 %, Gs = 2.68 | Pass |
pore-pressure-parameters-web-validation.test.ts
Validation for `pore-pressure-parameters` — Skempton's A and B pore-pressure parameters (`pore-pressure-parameters.ts`).
Analyses validated: pore-pressure-parameters · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `pore-pressure-parameters` — Skempton's A and B pore-pressure parameters
(`pore-pressure-parameters.ts`).
STATUS: PARTIAL — formula-fidelity evidence plus a SHORT list of published answers. 6 published
numeric answers were found (below the ≥20 release bar); the rest of this suite is domain checks
against published A / B ranges, which test that the engine ACCEPTS published values, not that it
reproduces a published output. The phrase "formula-fidelity" is kept in this header on purpose so the
validation manifest does not promote this engine to "reference-backed" on assertion-call count alone.
Published sources (every number below was read from the page named beside it; none is recalled):
1. Skempton, A.W. (1954), "The pore-pressure coefficients A and B", Géotechnique 4(4) 143-147 —
the equation Δu = B[Δσ3 + A(Δσ1 − Δσ3)], Table 1 (measured B on a saturated clay) and Table 2
(A at failure by clay type). Read from a reprint on the web (studylib.es "Selected papers on soil
mechanics" pp. 66-69); its Table 2 OCR is partly garbled, so no Table 2 range is asserted.
2. Lambe, T.W. & Whitman, R.V. (1969), Soil Mechanics (SI Version), Wiley — Ch. 26: Table 26.1
(values of parameters A and B, p. 395), §26.7 "Loading Example" (Fig. 26.14, p. 402).
3. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage — §2.17-2.18 Eqs
2.94-2.99 and the "A at failure" table (p. 63).
4. Craig, R.F. (2004), Craig's Soil Mechanics 7th ed. Solutions Manual, Spon — the printed answer A_f = 0.73
for the CU test with back pressure 200 kN/m² (σ1 − σ3 = 319 kN/m² and u = 433 kN/m² at failure), read
from a web copy of the manual. The same data is Problem 5.6 of the 8th edition in the library.
5. The Itasca FLAC verification problem "Undrained Embankment Loading", which reproduces the Lambe &
Whitman (1969) embankment example in US units (Δσ1 = 4180 psf, Δσ3 = 1645 psf, Δu = 2490 psf);
quoted SECOND-HAND — the original US-units figure is not in the SI copy held in the library.
WHAT THE ENGINE IS. `computePorePressureParameters` evaluates Δu = B·[Δσ3 + A·Δσ_dev], Ā = B·A and the
effective-stress change Δσ′ = Δσ − Δu on each axis, with A ∈ [−1, 3] and B ∈ [0, 1] accepted.
A and B are INPUTS; the engine does not derive them from test data.
PUBLISHED ANSWERS (7):
· Skempton (1954) Table 1 — four isotropic cell-pressure steps, Δu printed to 0.1 lb/in²: 14.7, 29.5,
45.0, 59.8 for Δσ3 = 15, 30, 45, 60 lb/in² with the printed B = 0.980, 0.984, 1.000, 0.996.
Tolerance 0.05 (half a unit of the last printed digit). These confirm Δu = B·Δσ3 reproduces measured
data; B there is itself Δu/Δσ3, so this is the weakest of the six.
· Lambe & Whitman Fig. 26.14 — Δσ3 = 85.2, Δσ1 = 195.8 kN/m², A = 0.85, B = 1 → Δu = 179.2 kN/m²
(printed as "Δu = 85.2 + 0.85(110.6) = 179.2"). Tolerance 0.05.
· Itasca / Lambe & Whitman US-units embankment — A = 1/3, B = 1 → Δu = 2490 psf. Tolerance 0.5 psf
(printed to 3 s.f.).
· Craig 7th Solutions, CU test with back pressure 200 kN/m²: A_f = 0.73 printed; fed back as the input
(B = 1, Δσ3 = 0, Δσ1 = 319) the engine must give the measured Δu = 433 − 200 = 233 kN/m². Tolerance 0.5 (A_f
printed to 2 d.p. ⇒ ±0.005 × 319 = ±1.6 on Δu; the observed difference is 0.13).
SHORTFALL: 13 published answers short of the bar. No further numeric worked example of the full
Δu = B[Δσ3 + A(Δσ1 − Δσ3)] equation with a printed answer was found in the library (Das prints the
equation and the A table but no numeric example; Craig prints B and A but its Problem 5.8 answer is not
in the library copy) nor on the web beyond the two above.
ENGINE FINDING, fixed with this suite. The engine refused A > 2, yet Lambe & Whitman Table 26.1 (typical
values given by Bjerrum) prints A at failure of 1.5-2.5 for a sensitive clay and 2-3 for a very loose fine
sand, both fully saturated. The in-code comment states the bounds are meant to be "deliberately wider than
the published table so an unusual but real measurement is not blocked"; a refusal of a published value
contradicts that, so the upper bound was raised from 2 to 3.
| Test block (the published value it checks) | Verdict |
| Skempton (1954) Table 1: Δu for isotropic cell-pressure steps of 15, 30, 45, 60 lb/in² | Pass |
| Lambe & Whitman Fig. 26.14: Δu = 85.2 + 0.85(110.6) = 179.2 kN/m² | Pass |
| Itasca / Lambe & Whitman embankment: A = 1/3, Δσ1 = 4180, Δσ3 = 1645 psf → Δu = 2490 psf | Pass |
| Craig 7th Solutions (CU test, back pressure 200): A_f = 0.73 reproduces the measured Δu = 433 − 200 = 233 kN/m² | Pass |
| Skempton (1954) alternative form: A = 1/3 gives Δu = B(Δσ1 + 2Δσ3)/3 | Pass |
| Das (2016) p. 63 A at failure: sandy clays 0.5-0.7, NC clays 0.5-1, OC clays −0.5-0 are accepted | Pass |
| Lambe & Whitman Table 26.1 A at failure: 0.7-1.3 NC, 0.3-0.7 lightly OC, −0.5-0 heavily OC are accepted | Pass |
| Lambe & Whitman Table 26.1 A at failure: sensitive clay 1.5-2.5 and very loose fine sand 2-3 are accepted | Pass |
| Lambe & Whitman Table 26.1 B: saturated soils B ≈ 1; Boulder clay at S = 93, 87, 76 % has B = 0.69, 0.33, 0.10 | Pass |
pressuremeter-menard-published-web-validation.test.ts
Published-table validation for the Ménard pressuremeter footing engine (`pressuremeter-menard.ts`, `computePressuremeterMenard`).
Analyses validated: pressuremeter-menard · Recorded run: passed — 27 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Published-table validation for the Ménard pressuremeter footing engine (`pressuremeter-menard.ts`,
`computePressuremeterMenard`). Complements `pressuremeter-menard-web-validation.test.ts`, whose own
header declares it hand-computed equation checking. THIS suite reads the numbers printed in two
standards and compares the engine's OUTPUTS to them. the release rules gate: every expected value was read
from a document opened for this suite (pages rendered and read as images where the text layer
dropped the tables).
SOURCES
[NF] AFNOR (2013), NF P94-261 with Amendment A1, "Calcul géotechnique — Fondations superficielles",
AFNOR/CSTB (local copy, 119 p): Tableau D.2.3 (kp coefficients, p. 63), Figure D.2.3 (kp against
De/B, p. 64), Tableaux H.2.1.1.1 / H.2.1.1.2 / H.2.1.1.3 (α, λc, λd, p. 77).
[EC7] EN 1997-2:2007, Annex E.2 (informative) "Example of a method to calculate the settlements for
spread foundations": Table E.2 (λd, λc against L/B) and Table E.3 (α), p. 122.
WHAT IS AND IS NOT CHECKED (honest statement)
· Checked: the engine's rheological α, shape factors λc/λd, kp at De/B = 0 (= kp0 of Tableau D.2.3) and the
kp plateau for De/B ≥ 2 against the printed tables and the printed kp figure.
· NOT available in either source: a worked footing example (qnet = kp·ple*, or a settlement in mm) — the
standards print the method and its coefficient tables, not a solved footing. The suite therefore
establishes that the engine's coefficients are the standards', not that a solved case reproduces.
[EC7] Table E.1 (bearing factor k) is a DIFFERENT, older correlation from [NF] Tableau D.2.3 and is not
compared.
· Figure D.2.3 was digitised from a 400-dpi render: axes located from the grid lines (kp = 0 … 2, De/B =
0 … 5), plateau heights read from the horizontal segments for De/B > 2. Curve line width ≈ 6 px =
0.008 in kp (≈ 0.5–0.8 %), hence the 1.5 % tolerance. Q3/Q7 and Q4/Q8 plot on top of each other.
· Tableau H.2.1.1.1 has no chalk or marl row; the engine's α = 1/2 for those is not checked.
ENGINE EXTENSION FOUND BY THIS SUITE: Tableau H.2.1.1.1 and Table E.3 give α by soil TYPE (clay, silt,
sand, gravel, peat) but the engine took α from its two-way category only (clay_silt → clay row, sand_gravel
→ sand row), so silt and gravel were read with the clay / sand α — larger than printed for both
(unconservative only in that α scales the spherical settlement). `rheological_soil` now selects the printed
row; omitting it keeps the previous behaviour.
TOLERANCES: tables print 2–3 s.f. ([EC7] prints 0,67 for 2/3 → ±0.005).
| Test block (the published value it checks) | Verdict |
| [NF] Tableau H.2.1.1.3: L/B = 1 → λc = 1.10, λd = 1.12 | Pass |
| [NF] Tableau H.2.1.1.3: L/B = 2 → λc = 1.20, λd = 1.53 | Pass |
| [NF] Tableau H.2.1.1.3: L/B = 3 → λc = 1.30, λd = 1.78 | Pass |
| [NF] Tableau H.2.1.1.3: L/B = 5 → λc = 1.40, λd = 2.14 | Pass |
| [NF] Tableau H.2.1.1.3: L/B = 20 → λc = 1.50, λd = 2.65 | Pass |
| [EC7] Table E.2: L/B = 1 → λc = 1.1, λd = 1.12 | Pass |
| [EC7] Table E.2: L/B = 2 → λc = 1.2, λd = 1.53 | Pass |
| [EC7] Table E.2: L/B = 3 → λc = 1.3, λd = 1.78 | Pass |
| [EC7] Table E.2: L/B = 5 → λc = 1.4, λd = 2.14 | Pass |
| [EC7] Table E.2: L/B = 20 → λc = 1.5, λd = 2.65 | Pass |
| [NF] Tableau H.2.1.1.1 Argile: surconsolidé 1, normalement consolidé 2/3, sous-consolidé 1/2 | Pass |
| [NF] Tableau H.2.1.1.1 Limon: surconsolidé 2/3, normalement consolidé 1/2, sous-consolidé 1/2 | Pass |
| [NF] Tableau H.2.1.1.1 Sable: surconsolidé 1/2, normalement consolidé 1/3, sous-consolidé 1/3 | Pass |
| [NF] Tableau H.2.1.1.1 Grave: surconsolidé 1/3, normalement consolidé 1/4 | Pass |
| [NF] Tableau H.2.1.1.1 Tourbe (normalement consolidée): α = 1 | Pass |
| [NF] Tableau H.2.1.1.2 Rocher: très peu fracturé 2/3, normal fracturé 1/2, très fracturé 1/3 (engine weathered_rock: OC/NC/UC) | Pass |
| [EC7] Table E.3 Clay: over-consolidated 1, normally consolidated 0,67, remoulded 0,5 | Pass |
| [EC7] Table E.3 Silt: over-consolidated 0,67, normally consolidated 0,5 | Pass |
| [EC7] Table E.3 Sand: EM/pLM > 12 → 0,5 (over-consolidated); 5–12 → 0,33 (normally consolidated) | Pass |
| [EC7] Table E.3 Sand and gravel: EM/pLM > 10 → 0,33; 6–10 → 0,25 | Pass |
| [EC7] Table E.3 Peat 1; Rock: extensively fractured 0,33, unaltered 0,5, weathered 0,67 | Pass |
| [NF] Tableau D.2.3: kp0 = 0.8 (clay strip Q1 / square Q2) and 1 (sand strip Q3 / square Q4) at De/B = 0 | Pass |
| [NF] Tableau D.2.3: kp0 = 0.8 for chalk (Q5 strip / Q6 square) and marl–weathered rock (Q7 / Q8) | Pass |
| [NF] Figure D.2.3 plateau De/B ≥ 2: Q1 (clay strip) 1.024 and Q2 (clay square) 1.128 | Pass |
| [NF] Figure D.2.3 plateau: Q3 (sand strip) and Q7 (marl strip) overlap at 1.397 | Pass |
| [NF] Figure D.2.3 plateau: Q4 (sand square) 1.581 digitised; Q8 (marl square) from the PRINTED coefficients | Pass |
| [NF] Figure D.2.3 plateau: Q5 (chalk strip) 1.518 and Q6 (chalk square) 1.768 | Pass |
pressuremeter-menard-web-validation.test.ts
Formula-fidelity validation against NF P94-261 (Calcul geotechnique -- Fondations superficielles), Annexes D and H -- the French national pressuremeter foundation-design standard.
Analyses validated: pressuremeter-menard · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Formula-fidelity validation against NF P94-261 (Calcul geotechnique --
Fondations superficielles), Annexes D and H -- the French national
pressuremeter foundation-design standard. Every coefficient (kp Tableau
D.2.3, rheological alpha Tableau H.2.1.1.1/.2, shape lambda_c/lambda_d
Tableau H.2.1.1.3) is cited verbatim in the engine's own header. This is a
fully closed-form calculation, hand-computed independently in Python and
matching this engine's output to full precision.
kp = kp0 + (a+b.De/B).(1-e^(-c.De/B))
qnet = kp.ple*
sc = alpha/(9.EM).(q'-sv0).lambda_c.B
sd = 2/(9.EM).(q'-sv0).B0.(lambda_d.B/B0)^alpha, B0=0.6m
| Test block (the published value it checks) | Verdict |
| [1-3] square footing, clay/silt, NC: kp=1.012734, qnet=607.640684 kPa, alpha=0.666667 | Pass |
| [4-6] shape coefficients lambda_c=1.10, lambda_d=1.12 at L/B=1 (the Tableau H.2.1.1.3 anchor) | Pass |
| [7-9] settlement components: spherical=5.500000mm, deviatoric=10.829549mm, total=16.329549mm | Pass |
| [10] a strip footing (L>>B) uses a materially different kp than a square footing at the same De/B, per the strip/square interpolation on B/L | Pass |
| [11] a stiffer soil (higher EM) reduces both settlement components proportionally (sc and sd are both inversely proportional to EM) | Pass |
| [12] the overconsolidated state gives a HIGHER alpha (stiffer response) than normally-consolidated for clay/silt (Tableau H.2.1.1.1: OC=1, NC=2/3) | Pass |
| [13] De/B beyond 2 clamps kp at the De/B=2 plateau and warns, per NF P94-261 D.2.3's stated validity range | Pass |
| [14] invalid inputs (zero width, zero modulus, zero limit pressure) are refused | Pass |
site-investigation-web-validation.test.ts
Web-benchmark validation for `site-investigation` — borehole layout and depth planning across four national codes.
Analyses validated: site-investigation · Recorded run: passed — 13 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for `site-investigation` — borehole layout and depth planning across
four national codes.
SOURCES (each cited at the assertion that uses it):
IS 1892:1979 Cl 3.3.1/3.3.2/3.3.3 — exploration depth 1.5·B (isolated), 2.0·B (combined),
1.5·B (raft), each measured below founding level; IS 2911 (Part 1):2010 Cl 6.5 — pile
exploration to L + 5·B below the toe.
BS 5930:2015 Cl 12.6 — the same 1.5·B / 2.0·B family for shallow foundations.
AASHTO LRFD §10.4.2 — 2.0·B for spread footings; pile borings to L + 6 m.
EN 1997-2:2007 Annex B.3 — 1.5·B (GC1/GC2) or 3.0·B (GC3), with a 5 m absolute floor.
IS 1893-1:2016 Cl 6.3.5 — liquefaction screening depth in zones III-V with shallow GWT.
Tomlinson, "Foundation Design and Construction" Tab 11.1 — D = C·S^0.7 storey influence.
Jennings & Knight (1957) / ASTM D5333 — the collapsible-soil double oedometer.
These are RULES, not correlations: the code states a formula and the engine must reproduce it
exactly. So every depth assertion below is to machine precision.
| Test block (the published value it checks) | Verdict |
| IS 1892 Cl 3.3 depths are 1.5·B (isolated), 2.0·B (combined), 1.5·B (raft), + Df | Pass |
| IS 2911-1 Cl 6.5 takes pile exploration to L + 5·B below the toe | Pass |
| the depth rule changes with the code, as the codes themselves differ | Pass |
| the deepest applicable floor governs, and the reason is named | Pass |
| IS 1893 liquefaction screening drives depth in zones III-V with shallow groundwater | Pass |
| storey influence follows Tomlinson D = C·S^0.7 and can govern | Pass |
| borehole counts rise with area, importance and complexity | Pass |
| spacing is consistent with the count and the footprint | Pass |
| scale bands follow the borehole count | Pass |
| SPT quantity follows the 1.5 m interval over the full depth, per borehole | Pass |
| each code returns its own reference set, not a union | Pass |
| special ground conditions add their own tests, each with a standard | Pass |
| invalid inputs are refused with a zeroed plan | Pass |
site-practice-web-validation.test.ts
Web-benchmark validation for TWELVE site-practice runner engines — slope charts, in-situ test corrections, RC checks, uplift, stress distribution, frost, permeability, piping, eccentricity, two-layer bearing, filters and collapse.
Analyses validated: collapse-potential, eccentric-footing-pressure, filter-design, flotation, frost-depth, grain-size-permeability, punching-shear, taylor-stability, two-layer-bearing, vane-correction, vertical-stress-increase, weighted-creep · Recorded run: passed — 12 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Web-benchmark validation for TWELVE site-practice runner engines — slope charts, in-situ
test corrections, RC checks, uplift, stress distribution, frost, permeability, piping,
eccentricity, two-layer bearing, filters and collapse.
Family suite, same rationale as the other three: each engine is a single published relation
or code clause, so each gets exact assertions here rather than a near-empty file of its own.
The ledger carries a separate family-suite row; `runner-coverage.mjs` counts the ENGINES.
ENGINES AND SOURCES
taylor-stability — Taylor (1937/1948) stability number chart
vane-correction — Bjerrum (1972/73) μ = 1.7 − 0.54 log₁₀(PI)
punching-shear — IS 456:2000 Cl 31.6.3 two-way shear (ACI 318 §22.6 parallel)
flotation — EN 1997-1 §2.4.7.4 UPL uplift limit state
vertical-stress-increase — Boussinesq rectangular integral; Westergaard (1938)
frost-depth — Stefan (1891) and Modified Berggren (Aldrich 1956)
grain-size-permeability — Hazen (1892) and Kozeny-Carman (Carman 1937)
weighted-creep — Bligh (1910) and Lane (1935) creep theory
eccentric-footing-pressure — middle-third rule; Meyerhof (1953) effective width
two-layer-bearing — Meyerhof & Hanna (1978) CGJ 15(4) punching-shear mode
filter-design — Terzaghi retention/permeability; USACE EM 1110-2-1901 App. D
collapse-potential — ASTM D5333; Jennings & Knight (1975)
Every expected value is reconstructed from the published expression in code, with the
arithmetic written out. Where a composite empirical result could not be traced to a source
by hand (the Meyerhof-Hanna combined capacity) the engine is anchored on the exact bearing
factors, the mode selection and bracketing bounds rather than on an invented decimal.
| Test block (the published value it checks) | Verdict |
| taylor-stability inverts the Taylor (1937) stability number both ways | Pass |
| vane-correction applies Bjerrum (1972/73) μ = 1.7 − 0.54 log₁₀(PI) | Pass |
| punching-shear follows IS 456:2000 Cl 31.6.3 | Pass |
| flotation checks uplift to EN 1997-1 §2.4.7.4 (UPL) | Pass |
| vertical-stress-increase matches the Boussinesq rectangular integral | Pass |
| frost-depth reproduces Stefan and the Modified Berggren correction | Pass |
| grain-size-permeability reproduces Hazen and Kozeny-Carman | Pass |
| weighted-creep reproduces Bligh (1910) and Lane (1935) creep theory | Pass |
| eccentric-footing-pressure applies the middle-third rule and Meyerhof width | Pass |
| two-layer-bearing selects the right mode and uses exact bearing factors | Pass |
| filter-design applies the Terzaghi and USACE filter criteria | Pass |
| collapse-potential follows ASTM D5333 and the Jennings & Knight bands | Pass |
skempton-bjerrum-web-validation.test.ts
PUBLISHED-VALUES: 12 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: 12 printed values; about 20 of the 29 assertions are the suite author's chart digitisation.
Analyses validated: skempton-bjerrum · Recorded run: passed — 9 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
PUBLISHED-VALUES: 12 -- distinct published values for this engine (engine-level total, declared once); independent audit A4: 12 printed values; about 20 of the 29 assertions are the suite author's chart digitisation. Audit: app/docs/VALIDATION-INTEGRITY-AUDIT-2026-10-07.md
Skempton–Bjerrum settlement coefficient μ = A + α(1 − A) — published-value validation
(`skempton-bjerrum.ts`). Every "published" value below was read from a document that was opened
for this suite; nothing is recalled from memory and nothing is produced by our own engine.
SOURCES (all three are in `Geo Technical engineering books/`):
[C] Knappett, J. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Spon/CRC (printed 2013).
§8.7 "Skempton–Bjerrum method" pp.304–309, Fig. 8.29 p.308 (Scott 1963 chart of μc vs A for
circular and strip footings), Example 8.5 p.309–310 with Table 8.7.
[D] Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage. §7.10 "Three-
dimensional effect on primary consolidation settlement" pp.337–342: Fig. 7.22 (settlement
ratios K_cir), Example 7.10.
[L] Look, B.G. (2007), Handbook of Geotechnical Investigation and Design Tables, Balkema/Taylor &
Francis, Table 23.4 p.295 "Correction factors based on Skempton and Bjerrum".
WHAT IS A PUBLISHED ANSWER HERE.
• Worked-example answers printed in the books: μc, s_c, s_total (Craig Ex. 8.5), K_cr, S_c (Das Ex. 7.10).
• Chart readings of μ (= settlement ratio) at stated A and H/B. The books publish μ ONLY as a chart,
so these are DIGITISED: each PDF page was rendered (Craig 200 dpi, Das 200 dpi), the gridlines were
located by pixel scan and the line centres read by pixel scan (not by eye). The digitising
resolution is ≈0.003 in μ. Tolerances are 0.02 (Craig) / 0.015 (Das) because (i) the plotted lines
in Craig's Fig. 8.29 all cross at μ ≈ 0.99 at A = 1 instead of exactly 1.000, i.e. the drawing is
good to about 0.01, and (ii) a 0.01–0.02 band is the reading precision of a printed chart. They are
NOT loosened to make a test pass.
• Published ranges (Look Table 23.4 ← Tomlinson 1995; Craig p.308 ranges of A).
The engine takes α (the chart's A = 0 intercept) as an input, so the chart intercepts are what we
feed in, and the chart's OTHER points (A = 0.5, 0.9, 1.2) are the independent check that the engine's
linear form μ = A + α(1−A) really is what the published chart draws.
Craig and Das label the lowest line differently (Craig "H/B = 4", Das "H_c/B = 2.0", same intercept
0.275); the engine does not use H/B, only α, so the labels are quoted as printed and not reconciled.
| Test block (the published value it checks) | Verdict |
| [C] Craig Fig 8.29 — circular-footing lines are μ = A + α(1−A) with the printed intercepts | Pass |
| [C] Craig Fig 8.29 — right-hand end of the circular lines (A = 1.2, sensitive-clay side), digitised | Pass |
| [C] Craig Fig 8.29 — all circular lines cross at μ ≈ 0.99 at A = 1 | Pass |
| [D] Das Fig 7.22 — circular lines at A = 0 (intercepts) and A = 0.5, 0.9 | Pass |
| [C] Craig Example 8.5 — 6 m square footing on stiff clay: μc = 0.55, s_c = 64 mm, total 73 mm | Pass |
| [C] Craig Example 8.5 — μc = 0.55 at A = 0.35 agrees with the α interpolated from Fig 8.29 at H/B = 2.2 | Pass |
| [D] Das Example 7.10 — K_cr = 0.78 at A = 0.6, H_c/B_eq = 0.64; S_c = 0.78 × 46.5 ≈ 36.3 mm | Pass |
| [D] Das Example 7.10 — K_cr at H_c/B = 0.64 falls between the printed H/B = 0.5 and 1.0 lines at A = 0.6 | Pass |
| [L][C] Look Table 23.4 (← Tomlinson 1995) correction-factor bands vs Craig p.308 ranges of A | Pass |
skempton-pore-pressure-web-validation.test.ts
Validation for Skempton pore-pressure parameters (`skempton-pore-pressure.ts`).
Analyses validated: — (not attributed by the manifest) · Recorded run: passed — 5 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for Skempton pore-pressure parameters (`skempton-pore-pressure.ts`).
the release rules gate. Anchors: Skempton (1954); Das/Craig worked relations.
| Test block (the published value it checks) | Verdict |
| isotropic loading (Δσ1=Δσ3): Δu = B·Δσ3 (A irrelevant) | Pass |
| pure deviatoric (Δσ3=0): Δu = B·A·Δσ1 | Pass |
| B parameter: saturated (C_f→0) → 1; compressible fluid < 1 | Pass |
| undrained ESP: CU triaxial (Δσ3=0), NC clay A=0.9 B=1 | Pass |
| total stress path (TSP) minus Δu equals effective stress path | Pass |
⚑ soil-classification-web-validation.test.ts
Validation of the soil-classification engine (`classification.ts`, slug `soil-classification`): USCS (ASTM D2487), its IS 1498 L/I/H variant, and AASHTO M 145 / D3282 with Group Index.
Analyses validated: soil-classification · Recorded run: passed — 25 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation of the soil-classification engine (`classification.ts`, slug `soil-classification`):
USCS (ASTM D2487), its IS 1498 L/I/H variant, and AASHTO M 145 / D3282 with Group Index.
the release rules release gate: >= 20 published values from >= 2 sources. Every expected value below was
read from a source opened for this suite.
SOURCES
Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage — Problems 2.6 (AASHTO
classification with group index) and 2.7 (USCS symbol + group name) of six soils, with the
printed "Answers to Problems" (p. 900-901); Section 2.9 for the group-index formula.
ASTM D2487 (2006), Standard Practice for Classification of Soils for Engineering Purposes (USCS):
Fig. 1 (group-name flow chart, read as an image), Note 10, Note 11, Appendix X1 (X1.1.1,
X1.1.2, X1.1.3) and X2 (X2.4.1, X2.4.3, X2.4.4) — worked classifications with their inputs.
Knappett, J.A. & Craig, R.F. (2012), Craig's Soil Mechanics 8th ed., Example 1.1 (p. 20-22) —
soils A-D classified from particle-size curves and limits.
FHWA-NHI-06-088 (2006), Soils and Foundations Reference Manual Vol. I, Section 4.2 (p. 4-28; independent audit 2026-10-07 corrected the locator from 4-27, which is Table 4-13):
"There is no upper limit for the group index".
HOW THE INPUTS ARE BUILT. The engine takes percent_coarse (retained on the 75 µm sieve, i.e. 100 − %
passing No. 200) and percent_gravel (retained on No. 4, i.e. 100 − % passing No. 4). Das's tables give
the percent PASSING, so each soil is converted that way. ASTM's examples give percent gravel / sand /
fines directly.
TWO SPELLING NORMALISATIONS, nothing else: (i) ASTM and Das write "poorly graded" / "well graded"
without a hyphen while the engine writes "Poorly-graded"; group names are compared lower-case with
hyphens read as spaces. (ii) The engine writes the AASHTO group index as "A-7-6 (9)" (and omits it
when it is zero) where the books write "A-7-6(9)", so the group and the integer index are compared
separately.
NOT ASSERTED, and why. Das Problem 2.7 soil C is printed as "SP, poorly graded sand" although it has
8 % passing No. 200: ASTM D2487 Section 12.5 requires a dual symbol (SP-SM) for 5-12 % fines, and the
problem gives no Cu/Cc. The book answer gives only the first symbol, so it is not used as a check of
the dual-symbol rule. ASTM X1.1.4 (SM with organic fines) is not asserted either: the engine does not
append "with organic fines" (Table 1 footnote G).
| Test block (the published value it checks) | Verdict |
| Das (2016) Problem 2.6 — soil A is AASHTO A-7-6(9) | Pass |
| Das (2016) Problem 2.6 — soil B is AASHTO A-6(5) | Pass |
| Das (2016) Problem 2.6 — soil C is AASHTO A-3(0) | Pass |
| Das (2016) Problem 2.6 — soil D is AASHTO A-4(5) | Pass |
| Das (2016) Problem 2.6 — soil E is AASHTO A-2-6(1) | Pass |
| Das (2016) Problem 2.6 — soil F is AASHTO A-7-6(19) | Pass |
| Das (2016) Problem 2.7 — soil A is ML, Sandy silt | Pass |
| Das (2016) Problem 2.7 — soil B is ML, Sandy silt | Pass |
| Das (2016) Problem 2.7 — soil D is ML, Sandy silt | Pass |
| Das (2016) Problem 2.7 — soil E is SM, Silty sand | Pass |
| Das (2016) Problem 2.7 — soil F is CH, Fat clay with sand | Pass |
| Das (2016) Problem 2.6/2.7 — soils A and F through RUNNER_CONFIGS give the printed answers | Pass |
| ASTM D2487 X1.1.1 — 73 % gravel, 23 % sand, 4 % fines, Cc = 2.7, Cu = 12.4 → GW, well-graded gravel with sand | Pass |
| ASTM D2487 X1.1.2 — 61 % sand, 23 % fines (LL 33, PI 6), 16 % gravel → SM, silty sand with gravel | Pass |
| ASTM D2487 Note 11 — 46 % gravel, 30 % sand, 24 % clayey fines (LL 38, PI 19) → GC, clayey gravel with sand | Pass |
| ASTM D2487 X2.4.3 — broken shells: 65 % gravel, 31 % sand, 4 % fines, Cc = 2.4, Cu = 1.9 → GP, poorly graded gravel with sand | Pass |
| ASTM D2487 X2.4.4 — crushed rock: 89 % gravel, 11 % sand, Cc = 2.4, Cu = 0.9 → GP, poorly graded gravel | Pass |
| ASTM D2487 X2.4.1 — 61 % clayey fines (LL 37, PI 16), 33 % sand, 6 % gravel → CL, sandy lean clay | Pass |
| ASTM D2487 X1.1.3 — 100 % organic fines, LL (not dried) 32, PI 10 → OL, organic clay | Pass |
| ASTM D2487 Note 10 — poorly graded sand, 10 % fines, LL 20, PI 6 (CL-ML fines) → SP-SC | Pass |
| Knappett & Craig (2012) Ex. 1.1 — soil A (100 % coarse, Cu = 34, Cz = 1.6) is GW | Pass |
| Knappett & Craig (2012) Ex. 1.1 — soil B (3 % fines, 2 % gravel, Cu = 1.8, Cz = 0.95) is SP | Pass |
| Knappett & Craig (2012) Ex. 1.1 — soil C (34 % fines LL 26 PI 9, 41 % gravel, 25 % sand) is GC | Pass |
| Knappett & Craig (2012) Ex. 1.1 — soil D (LL 42, PI 18, 95 % fines) is CI under the IS 1498 intermediate class | Pass |
| FHWA-NHI-06-088 — the group index is not capped at 20 (F = 100, LL = 90, PI = 65) | Pass |
spt-correction-web-validation.test.ts
spt-correction — published-value validation (the ≥20-value gate).
Analyses validated: spt-correction · Recorded run: passed — 128 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
spt-correction — published-value validation (the ≥20-value gate).
Every expected value below is a number PRINTED in the cited source, read on 2026-09-26/27 from
`Geo Technical engineering books/`. The engine is run with each source's own stated conventions
(p_a basis, where σ′ is taken, which energy factors are applied) — those are inputs the source
states, never values tuned to the answer.
[DAS-T3.7] Das, Principles of Foundation Engineering (Cengage), Table 3.7 "Variation of C_N",
p. 99 — seven C_N forms at σ′/p_a = 0.25…4.00, printed to 2 dp. Tolerance ±0.01
(one unit in the last printed digit: Das rounds some entries and truncates others,
e.g. Seed at 0.75 is 1.156 → printed 1.15). THREE printed entries are not the
printed equation and are excluded, not loosened: Eq. 3.15 at 4.00 prints 0.60
(3/(2+4) = 0.50 — the 3.00 row repeated), Eq. 3.16 at 0.50 prints 1.17
(1.7/1.2 = 1.42 — the 0.75 row repeated), Eq. 3.19/3.20 at 3.00 prints 0.65
(4/6.25 = 0.64; kept, it is inside ±0.01).
[DAS-E3.1] Das Example 3.1, pp. 99-100: Liao-Whitman, γ = 17.3, dry. (N1)60 printed as integers
→ tolerance ±0.5.
[DAS-P3.4/3.5] Das Problems 3.4 and 3.5 (Eqs. 3.13 and 3.14), answers p. 902, integers ±0.5. The
problem table lists the fifth reading at 7.9 m; the answer table at 7.5 m — the answer
table's depth is used.
[KRAMER] Kramer, Geotechnical Earthquake Engineering, Example 6.6, pp. 210-211: 20 readings,
(N1)60 = N·C_N·(Em/Eff = 0.72/0.60), C_N = (1/σ′[tsf])^0.5 ⇒ p_a = 95.76 kPa, no rod
factor. Printed to 1 dp and the engine also rounds to 1 dp → ±0.1 (one unit in the last digit;
20.2 m sits on a rounding edge, 28.55). Row 1 prints 17.3 where 7 × 2.08 × 1.2 = 17.47 — a
book arithmetic slip; that row is compared to the book's own product.
[BOWLES] Bowles, Foundation Analysis and Design 5e, Examples 3-2 and 3-4, pp. 160-162:
N′60 = 19 and 17 (integers ±0.5), C_N on the 95.76 kPa basis.
[GEC6] FHWA-SA-02-054 GEC 6, Eq. 4-1 illustration p. 33 (N60 = 40 from N = 30 at ER 80 %),
and Appendix B Example 3, pp. B-47/48 (Fig. 5-18 read-offs, integers ±0.5).
[MNO12] Idriss & Boulanger (2008) EERI MNO-12, Appendix A spreadsheet, pp. 238-239: N60 per
reading (ER 75 %, CB = CS = 1, rod = depth + 1.5 m, Youd 2001 CR), printed to 1 dp → ±0.1.
[YOUD] Youd et al. (2001) J. Geotech. Geoenviron. Eng. 127(10), Table 2, p. 819: C_R bands and
C_B values (exact).
[IS2131] IS 2131:2025 §5.6.3 Fig. 3 (p. 11): chart read-offs at 200 dpi, precision ±0.02; the
code's own bounds 0.40 ≤ C_N ≤ 2.0.
If one of these fails the ENGINE is wrong (or the source convention was mis-stated) — do not loosen.
| Test block (the published value it checks) | Verdict |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 0.25 → C_N 2 | Pass |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 0.5 → C_N 1.41 | Pass |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 0.75 → C_N 1.15 | Pass |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 1 → C_N 1 | Pass |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 1.5 → C_N 0.82 | Pass |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 2 → C_N 0.71 | Pass |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 3 → C_N 0.58 | Pass |
| [DAS-T3.7] Eq. 3.13 (liao_whitman) at σ′/p_a = 4 → C_N 0.5 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 0.25 → C_N 1.6 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 0.5 → C_N 1.33 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 0.75 → C_N 1.14 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 1 → C_N 1 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 1.5 → C_N 0.8 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 2 → C_N 0.67 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 3 → C_N 0.5 | Pass |
| [DAS-T3.7] Eq. 3.14 (skempton) at σ′/p_a = 4 → C_N 0.4 | Pass |
| [DAS-T3.7] Eq. 3.15 (skempton_coarse) at σ′/p_a = 0.25 → C_N 1.33 | Pass |
| [DAS-T3.7] Eq. 3.15 (skempton_coarse) at σ′/p_a = 0.5 → C_N 1.2 | Pass |
| [DAS-T3.7] Eq. 3.15 (skempton_coarse) at σ′/p_a = 0.75 → C_N 1.09 | Pass |
| [DAS-T3.7] Eq. 3.15 (skempton_coarse) at σ′/p_a = 1 → C_N 1 | Pass |
| [DAS-T3.7] Eq. 3.15 (skempton_coarse) at σ′/p_a = 1.5 → C_N 0.86 | Pass |
| [DAS-T3.7] Eq. 3.15 (skempton_coarse) at σ′/p_a = 2 → C_N 0.75 | Pass |
| [DAS-T3.7] Eq. 3.15 (skempton_coarse) at σ′/p_a = 3 → C_N 0.6 | Pass |
| [DAS-T3.7] Eq. 3.16 (skempton_oc) at σ′/p_a = 0.25 → C_N 1.78 | Pass |
| [DAS-T3.7] Eq. 3.16 (skempton_oc) at σ′/p_a = 0.75 → C_N 1.17 | Pass |
| [DAS-T3.7] Eq. 3.16 (skempton_oc) at σ′/p_a = 1 → C_N 1 | Pass |
| [DAS-T3.7] Eq. 3.16 (skempton_oc) at σ′/p_a = 1.5 → C_N 0.77 | Pass |
| [DAS-T3.7] Eq. 3.16 (skempton_oc) at σ′/p_a = 2 → C_N 0.63 | Pass |
| [DAS-T3.7] Eq. 3.16 (skempton_oc) at σ′/p_a = 3 → C_N 0.46 | Pass |
| [DAS-T3.7] Eq. 3.16 (skempton_oc) at σ′/p_a = 4 → C_N 0.36 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 0.25 → C_N 1.75 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 0.5 → C_N 1.38 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 0.75 → C_N 1.15 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 1 → C_N 1 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 1.5 → C_N 0.78 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 2 → C_N 0.62 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 3 → C_N 0.4 | Pass |
| [DAS-T3.7] Eq. 3.17 (seed_1975) at σ′/p_a = 4 → C_N 0.25 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 0.25 → C_N 1.47 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 0.5 → C_N 1.23 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 0.75 → C_N 1.1 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 1 → C_N 1 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 1.5 → C_N 0.87 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 2 → C_N 0.77 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 3 → C_N 0.63 | Pass |
| [DAS-T3.7] Eq. 3.18 (peck) at σ′/p_a = 4 → C_N 0.54 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 0.25 → C_N 2 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 0.5 → C_N 1.33 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 0.75 → C_N 1 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 1 → C_N 0.94 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 1.5 → C_N 0.84 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 2 → C_N 0.76 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 3 → C_N 0.65 | Pass |
| [DAS-T3.7] Eqs. 3.19/3.20 (bazaraa) at σ′/p_a = 4 → C_N 0.55 | Pass |
| [DAS-E3.1] (N1)60 at 1.5 m = 16 | Pass |
| [DAS-E3.1] (N1)60 at 3 m = 10 | Pass |
| [DAS-E3.1] (N1)60 at 4.5 m = 14 | Pass |
| [DAS-E3.1] (N1)60 at 6 m = 14 | Pass |
| [DAS-E3.1] (N1)60 at 7.5 m = 11 | Pass |
| [DAS-P3.4 Eq. 3.13] (N1)60 at 1.5 m = 12 | Pass |
| [DAS-P3.4 Eq. 3.13] (N1)60 at 3 m = 11 | Pass |
| [DAS-P3.4 Eq. 3.13] (N1)60 at 4.5 m = 10 | Pass |
| [DAS-P3.4 Eq. 3.13] (N1)60 at 6 m = 8 | Pass |
| [DAS-P3.4 Eq. 3.13] (N1)60 at 7.5 m = 12 | Pass |
| [DAS-P3.4 Eq. 3.13] (N1)60 at 9 m = 12 | Pass |
| [DAS-P3.5 Eq. 3.14] (N1)60 at 1.5 m = 9 | Pass |
| [DAS-P3.5 Eq. 3.14] (N1)60 at 3 m = 10 | Pass |
| [DAS-P3.5 Eq. 3.14] (N1)60 at 4.5 m = 10 | Pass |
| [DAS-P3.5 Eq. 3.14] (N1)60 at 6 m = 8 | Pass |
| [DAS-P3.5 Eq. 3.14] (N1)60 at 7.5 m = 12 | Pass |
| [DAS-P3.5 Eq. 3.14] (N1)60 at 9 m = 12 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 1.2 m = 17.47 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 2.2 m = 7.9 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 3.2 m = 5.1 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 4.2 m = 4.6 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 5.2 m = 7 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 6.2 m = 11.7 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 7.2 m = 14.6 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 8.2 m = 13.7 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 9.2 m = 15.2 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 10.2 m = 9.3 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 11.2 m = 22.8 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 12.2 m = 12.4 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 13.2 m = 10.1 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 14.2 m = 9.8 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 15.2 m = 20.7 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 16.2 m = 22.5 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 17.2 m = 4.1 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 18.2 m = 4.7 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 19.2 m = 3.1 | Pass |
| [KRAMER] Ex 6.6 (N1)60 at 20.2 m = 28.5 | Pass |
| [BOWLES] Ex 3-2: N = 20, ER 80 %, 150 mm hole, p′o = 205 kPa, rod 12 m → N′60 = 19 | Pass |
| [BOWLES] Ex 3-4: N = 20, ER 55 %, p′o = 100 kPa, 6 m hole → N′60 = 17 | Pass |
| [GEC6] Eq. 4-1: N = 30 at ER 80 % → N60 = 40 (energy ratio only, = IS 2131:2025 §5.6.2) | Pass |
| [GEC6] App. B Ex 3: N′ at 1.5 m = 10 | Pass |
| [GEC6] App. B Ex 3: N′ at 4.5 m = 10 | Pass |
| [GEC6] App. B Ex 3: N′ at 7.5 m = 15 | Pass |
| [GEC6] App. B Ex 3: N′ at 10.5 m = 20 | Pass |
| [MNO12] App. A N60 at 1.1 m = 3.8 | Pass |
| [MNO12] App. A N60 at 1.8 m = 5 | Pass |
| [MNO12] App. A N60 at 2.6 m = 4.3 | Pass |
| [MNO12] App. A N60 at 3.4 m = 6.4 | Pass |
| [MNO12] App. A N60 at 4.1 m = 8.5 | Pass |
| [MNO12] App. A N60 at 4.9 m = 10.7 | Pass |
| [MNO12] App. A N60 at 5.6 m = 24.9 | Pass |
| [MNO12] App. A N60 at 6.4 m = 21.4 | Pass |
| [MNO12] App. A N60 at 7.2 m = 30.9 | Pass |
| [MNO12] App. A N60 at 7.9 m = 23.8 | Pass |
| [MNO12] App. A N60 at 9.4 m = 25 | Pass |
| [MNO12] App. A N60 at 10.2 m = 13.8 | Pass |
| [MNO12] App. A N60 at 11 m = 10 | Pass |
| [MNO12] App. A N60 at 12.5 m = 5 | Pass |
| [YOUD] Table 2: rod length 2.5 m → C_R = 0.75 | Pass |
| [YOUD] Table 2: rod length 3.5 m → C_R = 0.8 | Pass |
| [YOUD] Table 2: rod length 5 m → C_R = 0.85 | Pass |
| [YOUD] Table 2: rod length 8 m → C_R = 0.95 | Pass |
| [YOUD] Table 2: rod length 12 m → C_R = 1 | Pass |
| [YOUD] Table 2: borehole 100 mm → C_B = 1 | Pass |
| [YOUD] Table 2: borehole 150 mm → C_B = 1.05 | Pass |
| [YOUD] Table 2: borehole 200 mm → C_B = 1.15 | Pass |
| [IS2131] Fig. 3: σ′0 = 5 kPa → C_N ≈ 2 | Pass |
| [IS2131] Fig. 3: σ′0 = 50 kPa → C_N ≈ 1.24 | Pass |
| [IS2131] Fig. 3: σ′0 = 100 kPa → C_N ≈ 1 | Pass |
| [IS2131] Fig. 3: σ′0 = 200 kPa → C_N ≈ 0.77 | Pass |
| [IS2131] Fig. 3: σ′0 = 300 kPa → C_N ≈ 0.64 | Pass |
| [IS2131] Fig. 3: σ′0 = 400 kPa → C_N ≈ 0.54 | Pass |
| [IS2131] Fig. 3: σ′0 = 550 kPa → C_N ≈ 0.43 | Pass |
| [IS2131] §5.6.3 bounds 0.40 ≤ C_N ≤ 2.0 and σ′0 at SPT depth + 0.30 m by default | Pass |
spt-correlations-web-validation.test.ts
spt-correlations — published-value validation (the ≥20-value gate).
Analyses validated: spt-correlations · Recorded run: passed — 47 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
spt-correlations — published-value validation (the ≥20-value gate).
Every expected value below traces to a source read on 2026-09-26 from
`Geo Technical engineering books/`:
[IS6403] IS 6403:1981, Fig. 1 "Relationship between φ and N" (p. 11). Scanned chart; read by
pixel trace of a 300-dpi render registered on the printed 2° / 10-blow grid.
Tolerance ±0.5° — the chart's own line width is ≈ 0.4° at that scale.
[FHWA] FHWA NHI-06-089 (2006) Soils & Foundations Vol II, Table 8-1, "after AASHTO 2004
with 2006 Interims" = AASHTO LRFD Table 10.4.6.2.4-1. Exact table values.
[EC7-F1] EN 1997-2:2007 Annex F, Table F.1 (N1)60 → I_D band limits, and F.1(4) grain ratio.
[EC7-F3] EN 1997-2:2007 Annex F, Table F.3 I_D → φ′ for silica sands. Exact table values.
[DAS] Das, Principles of Foundation Engineering (Cengage), Example 3.2 (Eq. 3.30 table,
printed to 0.1°) and the Eq. 3.29 field table of the shallow-foundation example
(printed to 1°).
The published answer is the expected value; if one of these fails the ENGINE is wrong.
| Test block (the published value it checks) | Verdict |
| [IS6403] Fig. 1: N = 10 → φ ≈ 30.3° | Pass |
| [IS6403] Fig. 1: N = 20 → φ ≈ 33.2° | Pass |
| [IS6403] Fig. 1: N = 30 → φ ≈ 36° | Pass |
| [IS6403] Fig. 1: N = 40 → φ ≈ 38.6° | Pass |
| [IS6403] Fig. 1: N = 50 → φ ≈ 40.8° | Pass |
| [IS6403] Fig. 1: N = 60 → φ ≈ 42.6° | Pass |
| [IS6403] Fig. 1: N = 70 → φ ≈ 43.8° | Pass |
| [IS6403] Fig. 1 gives no value outside its plotted range (N < 10, N > 75) — none is invented | Pass |
| [FHWA] Table 8-1: N160 = 0 → φ 25–30° | Pass |
| [FHWA] Table 8-1: N160 = 4 → φ 27–32° | Pass |
| [FHWA] Table 8-1: N160 = 10 → φ 30–35° | Pass |
| [FHWA] Table 8-1: N160 = 30 → φ 35–40° | Pass |
| [FHWA] Table 8-1: N160 = 50 → φ 38–43° | Pass |
| [EC7-F1] Table F.1: (N1)60 = 3 → I_D = 15 % | Pass |
| [EC7-F1] Table F.1: (N1)60 = 8 → I_D = 35 % | Pass |
| [EC7-F1] Table F.1: (N1)60 = 25 → I_D = 65 % | Pass |
| [EC7-F1] Table F.1: (N1)60 = 42 → I_D = 85 % | Pass |
| [EC7-F1] Table F.1: (N1)60 = 58 → I_D = 100 % | Pass |
| [EC7-F1] F.1(4): fine sand N is read in the ratio 55:60 — (N1)60 = 22.92 fine ≡ 25 medium → I_D 65 % | Pass |
| [EC7-F3] Table F.3: fine_uniform, I_D 40 % → φ′ 34° | Pass |
| [EC7-F3] Table F.3: fine_uniform, I_D 60 % → φ′ 36° | Pass |
| [EC7-F3] Table F.3: fine_uniform, I_D 80 % → φ′ 39° | Pass |
| [EC7-F3] Table F.3: fine_uniform, I_D 100 % → φ′ 42° | Pass |
| [EC7-F3] Table F.3: medium_uniform, I_D 40 % → φ′ 36° | Pass |
| [EC7-F3] Table F.3: medium_well, I_D 60 % → φ′ 41° | Pass |
| [EC7-F3] Table F.3: medium_well, I_D 80 % → φ′ 43° | Pass |
| [EC7-F3] Table F.3: medium_uniform, I_D 100 % → φ′ 43° | Pass |
| [EC7-F3] Table F.3: coarse_uniform, I_D 40 % → φ′ 38° | Pass |
| [EC7-F3] Table F.3: coarse_well, I_D 60 % → φ′ 43° | Pass |
| [EC7-F3] Table F.3: coarse_well, I_D 80 % → φ′ 44° | Pass |
| [EC7-F3] Table F.3: coarse_well, I_D 100 % → φ′ 46° | Pass |
| [EC7-F3] no φ′ below the tabulated I_D = 40 % — none is invented | Pass |
| [DAS] Example 3.2: σ′v 25.95 kPa, N60 8 → φ′ 37.5° | Pass |
| [DAS] Example 3.2: σ′v 51.9 kPa, N60 7 → φ′ 33.8° | Pass |
| [DAS] Example 3.2: σ′v 77.85 kPa, N60 12 → φ′ 36.9° | Pass |
| [DAS] Example 3.2: σ′v 103.8 kPa, N60 14 → φ′ 36.7° | Pass |
| [DAS] Example 3.2: σ′v 129.75 kPa, N60 13 → φ′ 34.6° | Pass |
| [DAS] Eq. 3.29 table: N60 3 → φ′ 28° | Pass |
| [DAS] Eq. 3.29 table: N60 6 → φ′ 29° | Pass |
| [DAS] Eq. 3.29 table: N60 9 → φ′ 30° | Pass |
| [DAS] Eq. 3.29 table: N60 10 → φ′ 30° | Pass |
| design_code routes: IS → Fig. 1, AASHTO → lower bound for silty sand, EC7 → Table F.3 | Pass |
| the silty-sand cap is reported and caps ONLY the recommended value — N still moves the methods | Pass |
| a code route outside its chart falls back to the envelope with a warning, never an invented value | Pass |
| N > 50 is flagged: the √N correlations have no code support there | Pass |
| σ′v is live: with field N60 it adds the Kulhawy-Mayne value | Pass |
| the 32° cap is OFF by default (2026-09-26): φ′ follows N, and a note says where local practice would cap it | Pass |
supporting-outputs-web-validation.test.ts
supporting-outputs-web-validation.test.ts
Analyses validated: asphalt-institute-design, basal-heave, faarfield-mix-cdf, hs-confined-settlement, hs-small, jpcp-iri, pressuremeter-menard, pvd-design, rock-slope-stability · Recorded run: passed — 7 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
supporting-outputs-web-validation.test.ts
Fourth and last broad pass down `scripts/unvalidated-outputs.mjs`. What remains after
the constitutive, consolidation and index batches is a long tail of one to four
outputs per analysis — the SUPPORTING numbers printed beside a headline result. They
are the least glamorous things in the catalogue and, for exactly that reason, the ones
with no reference value attached: a factor of safety gets anchored, the driving and
resisting forces it is the ratio of do not.
That asymmetry is not harmless. `footing-bearing-3d` had thirteen cited anchors on
q_ult while applying one sixth of the footing pressure, because the defect surfaced in
a supporting output nobody was watching. Where a headline is a RATIO or a SUM of the
supporting numbers, the identity between them is the cheapest and strongest check
available — it cannot be satisfied by an engine that has drifted — so that is what
most of these tests assert.
Sources:
· Hoek & Bray, *Rock Slope Engineering* — planar sliding block:
resisting = cA + (W(cosψp − α sinψp) − U − V sinψp)tanφ,
driving = W(sinψp + α cosψp) + V cosψp, FoS = resisting/driving
· Terzaghi (1943) / Bjerrum & Eide (1956) — basal heave of an excavation,
resisting = N_c·s_u, driving = γH + q
· Barron (1948) / Hansbo (1981) — vertical drains: the unit-cell influence diameter
d_e = 1.05·s (triangular), 1.128·s (square)
· Santos & Correia (2001) / Hardin & Drnevich (1972) — small-strain stiffness
degradation, G_s/G_0 = 1/(1 + a·γ/γ_0.7)
· Miner (1945) — linear cumulative damage: total CDF is the sum of its parts, which
is what makes a per-aircraft or per-distress contribution meaningful at all.
· Ménard & Rousseau (1962) — pressuremeter settlement as a spherical plus a
deviatoric term.
| Test block (the published value it checks) | Verdict |
| rock-slope-stability: FoS = resisting/driving exactly, and both forces respond correctly (7 anchors) | Pass |
| basal-heave: resisting pressure is N_c·s_u and the FoS is its ratio to γH + q (6 anchors) | Pass |
| pvd-design: d_e = 1.05·s for a triangular grid and 1.128·s for a square one (5 anchors) | Pass |
| hs-small: G_s ≥ G_t, both fall with strain, and the cut-off strain bounds them (6 anchors) | Pass |
| hs-confined-settlement: the linear reference is Δσ·H/E_oed and the strain is its own ratio (6 anchors) | Pass |
| Miner's rule holds where an engine reports damage contributions (asphalt, JPCP, FAARFIELD) | Pass |
| pressuremeter-menard: total settlement is the sum of its spherical and deviatoric parts | Pass |
⚑ vane-correction-web-validation.test.ts
Validation for `vane-correction` — Bjerrum field-vane correction factor μ = 1.7 − 0.54·log10(PI), capped at 1.0 (`vane-correction.ts`).
Analyses validated: vane-correction · Recorded run: passed — 4 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for `vane-correction` — Bjerrum field-vane correction factor μ = 1.7 − 0.54·log10(PI), capped at
1.0 (`vane-correction.ts`).
STATUS: PARTIAL — formula-fidelity cross-checks plus 11 published values (below the ≥20 release bar).
The phrase "formula-fidelity" is kept in this header on purpose so the validation manifest does not
promote this engine to "reference-backed" on assertion-call count alone.
Published sources (every number below was read from the page named beside it; none is recalled):
1. Look, B.G. (2007), Handbook of Geotechnical Investigation and Design Tables, Taylor & Francis —
§4.14 Table 4.14 "Vane shear correction factor (based on Bjerrum, 1972)", p. 48: μ against PI,
PI < 20 % … 100 % (9 printed entries).
2. Das, B.M. (2016), Principles of Foundation Engineering 8th ed., Cengage — §3.20 Eq. 3.40a
(λ = 1.7 − 0.54 log PI) and Example 3.3 (worked vane correction, LL 50, PL 18, s_u = 20.12 kN/m²).
3. Canadian Foundation Engineering Manual, 4th ed. (CFEM 2006) §4.5.6, p. 49 — Fig. 4.3(a) (Bjerrum
chart) and the statement that Aas et al. recommend a maximum design μ of 1.0.
Han, J. (2015), Principles and Practice of Ground Improvement, Wiley, Eq. 2.46, is used ONLY as an
independent regression cross-check (not a published answer) — see the labelled test.
WHAT THE ENGINE IS. `computeVaneCorrection` evaluates μ = 1.7 − 0.54·log10(PI), caps it at 1.0 (the
correction never raises the design strength) and returns s_u,design = μ·s_u,vane.
TOLERANCES.
· Look Table 4.14 reads a CHART (Bjerrum 1972 Fig.) and prints μ in steps of 0.05, so each printed
entry is good to about ±0.025 of chart reading plus the rounding to the nearest 0.05 ⇒ ±0.05 is used.
The largest observed difference is 0.04 (PI = 60).
· Das Example 3.3 prints 17.85 kN/m² (exact 17.8508): tolerance 0.01.
PUBLISHED VALUES (11): Look ×9 + Das Example 3.3 ×1 + CFEM/Aas cap ×1.
SHORTFALL: 9 published values short of the bar. The other published statements are charts only
(CFEM Fig. 4.3, Bowles Fig. 3-26, Craig Fig. 7.7, each reprinting the same Bjerrum curve as a graph with no
tabulated numbers). Reading a graph off a page image would add points good to only ±0.05 and NOT
independent of Look's table, so none was added. No second worked vane-correction example was found in
the library or on the web (Das Example 3.3 is the only one).
NOT ASSERTED (investigated): the Bowles Ch. 3 vane-shear discussion notes that Lefebvre et al. found μ can
exceed 1 for PI < 20 % on two soft sensitive clays, and CFEM (citing Leroueil) says the PI correction may be
unnecessary for soft clays. Those are limits on Bjerrum's method itself, not disagreements with the
formula; the engine's cap at 1.0 matches Look's "< 20 % → 1.0" and the Aas et al. maximum.
| Test block (the published value it checks) | Verdict |
| Look Table 4.14: μ = 1.0 for PI < 20 %, then 0.9, 0.85, 0.75, 0.70, 0.70, 0.65, 0.65, 0.65 at PI 30…100 | Pass |
| Das Example 3.3 (a): Bjerrum λ = 1.7 − 0.54 log(32) applied to s_u(VST) = 20.12 kN/m² → 17.85 kN/m² | Pass |
| CFEM §4.5.6 (Aas et al. 1986): the design μ never exceeds 1.0 — low-PI clays are capped, not raised | Pass |
| cross-check: engine μ agrees with the independent Han (2015) Eq. 2.46 regression to ±0.03 for PI 40…100 | Pass |
Reliability, back-analysis and design aids
Cited validation suites — 3
bayesian-back-analysis-web-validation.test.ts
Observational-method Bayesian back-analysis — CITED validation (≥20 values).
Analyses validated: bayesian-back-analysis · Recorded run: passed — 11 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Observational-method Bayesian back-analysis — CITED validation (≥20 values).
The normal-normal conjugate update has EXACT closed forms, so every expected
number below traces to a published anchor, not to our own formulation:
Sources
-------
[1] Baecher & Christian (2003) "Reliability and Statistics in Geotechnical
Engineering", Ch. 8 — normal-normal conjugate update:
posterior precision = prior precision + Σ likelihood precisions;
posterior mean = precision-weighted average of prior mean & data;
σ_post² = 1/(1/σ₀² + n/σ²); Ch. 20 — value of information / variance
reduction.
[2] Ang & Tang (2007) "Probability Concepts in Engineering", 2nd ed., Ch. 8 —
normal conjugate estimation; the classic result that with a vague prior
and n i.i.d. observations the posterior mean → sample mean and
σ_post² → σ²/n.
[3] Peck (1969) Géotechnique 19(2), Rankine Lecture — the observational
method: revise the design as monitoring data arrives.
[4] Standard-normal quantiles Φ⁻¹(p) — tabulated in every statistics text
(Abramowitz & Stegun 26.2; Ang & Tang Table A.1): z₀.₉₇₅=1.959964,
z₀.₉₅=1.644854, z₀.₉₉₅=2.575829.
| Test block (the published value it checks) | Verdict |
| bayesian-back-analysis: Φ⁻¹ credible-interval z-values [4] | Pass |
| bayesian-back-analysis: conjugate single-obs update, exact closed form [1] | Pass |
| bayesian-back-analysis: linear scale/offset observation [1] | Pass |
| bayesian-back-analysis: vague prior, n i.i.d. → sample mean & σ²/n [2] | Pass |
| bayesian-back-analysis: zero observations → posterior = prior [3] | Pass |
| bayesian-back-analysis: strong prior barely moves [1] | Pass |
| bayesian-back-analysis: precise observation dominates [1] | Pass |
| bayesian-back-analysis: precisions add over observations; monotone tightening [1][2] | Pass |
| bayesian-back-analysis: next-reading predictive widens by σ_obs [3] | Pass |
| bayesian-back-analysis: guards non-finite & degenerate inputs | Pass |
| bayesian-back-analysis: TOTAL cited assertions | Pass |
design-copilot-web-validation.test.ts
Validation for the AI design copilot's deterministic core (`design-copilot.ts`).
Analyses validated: design-copilot, settlement · Recorded run: passed — 27 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Validation for the AI design copilot's deterministic core (`design-copilot.ts`).
the release rules ≥20-cited-value gate. Two provenance streams, no invented numbers:
A. The GENERIC optimisers are validated against the standard global-optimisation
benchmark suite with PUBLISHED optima:
Jamil, M. & Yang, X.-S. (2013). "A literature survey of benchmark functions
for global optimisation problems", Int. J. Math. Model. Numer. Optim. 4(2):150–194;
Surjanović, S. & Bingham, D. (2013). Virtual Library of Simulation Experiments
(VLSE) test-function library, Simon Fraser University.
Golden-section (Kiefer 1953) is checked on unimodal functions with analytic minima.
B. The FOUNDATION-SIZING objective is validated against closed-form soil mechanics
(Prandtl/Skempton Nc=5.14 for φ=0; Vesić factors via the already-validated
`computeBearingCapacity`), the EXACT rigid-circular-punch settlement
(Timoshenko & Goodier 1970; s = (π/2)·q·a·(1−ν²)/E), monotonicity of both
limit states in the footing width, and Karush–Kuhn–Tucker active-constraint
behaviour at the minimum-area optimum.
| Test block (the published value it checks) | Verdict |
| benchmark: Sphere → 0 at origin | Pass |
| benchmark: Rosenbrock → 0 at (1,1) | Pass |
| benchmark: Booth → 0 at (1,3) | Pass |
| benchmark: Matyas → 0 at origin | Pass |
| benchmark: Beale → 0 at (3,0.5) | Pass |
| benchmark: Himmelblau → 0 | Pass |
| benchmark: McCormick → −1.9133 | Pass |
| benchmark: Three-hump camel → 0 at origin | Pass |
| benchmark: Goldstein–Price → 3 at (0,−1) | Pass |
| benchmark: Bohachevsky → 0 at origin | Pass |
| benchmark: Lévi N.13 → 0 at (1,1) | Pass |
| benchmark: 4-D sphere → 0 | Pass |
| golden-section: parabola min at 3 | Pass |
| golden-section: quartic min at 2 | Pass |
| golden-section: cosh min at 1 | Pass |
| settlement: rigid circle = exact Timoshenko punch | Pass |
| settlement: square uses Iρ=0.82 | Pass |
| settlement: strip uses Iρ=2.0 | Pass |
| foundation: φ=0 clay net bearing ≈ 5.14·cu (Prandtl/Skempton) | Pass |
| foundation: sand FoS increases with width B | Pass |
| foundation: higher target FoS → larger B* | Pass |
| foundation: higher cohesion → smaller B* (clay) | Pass |
| foundation: settlement governs on low-E soil, constraint active (KKT) | Pass |
| foundation: bearing governs on stiff-weak soil, FoS active (KKT) | Pass |
| foundation: B* is the minimal feasible width | Pass |
| optimiser: smallestFeasible finds the monotone threshold | Pass |
| optimiser: gridMinimize yields samples covering the box | Pass |
reliability-web-validation.test.ts
Reliability kernel — web-sourced / textbook CITED validation (≥20 values).
Analyses validated: reliability · Recorded run: passed — 8 test block(s)
Sources, tolerances and what is not asserted (the suite’s prologue)
Reliability kernel — web-sourced / textbook CITED validation (≥20 values).
The reliability index β and P_f = Φ(−β) have exact closed forms for the
canonical limit states, plus a universally tabulated standard-normal tail —
so every expected number below traces to a published source, not to our own
formulation.
Sources
-------
[1] Ang & Tang (2007) "Probability Concepts in Engineering" — the linear R−S
limit state β = (μR−μS)/√(σR²+σS²); the lognormal β; Table A.1 (Φ).
[2] Standard-normal tail Φ(−β) — tabulated in every statistics text
(Ang & Tang Table A.1; Abramowitz & Stegun 26.2).
[3] Hasofer & Lind (1974); Rackwitz & Fiessler (1978) — FORM is INVARIANT to
how the limit state is written (β is the u-space distance to G=0), unlike
FOSM. Nowak & Collins "Reliability of Structures" Ch.5-6.
[4] Duncan (2000) ASCE JGGE 126(4) Table 2; USACE ETL 1110-2-547 — β → P_f
and the performance bands (β=3.0 "good"→"high", 2.5, 2.0, 1.5, 1.0).
[5] Baecher & Christian (2003) — correlated R,S: σ²_G = σR²+σS²−2ρσRσS.
| Test block (the published value it checks) | Verdict |
| reliability-web-validation: Φ(−β) matches the standard-normal table [2] | Pass |
| reliability-web-validation: Φ⁻¹(p) matches the table [2] | Pass |
| reliability-web-validation: linear normal R−S exact β [1][3] | Pass |
| reliability-web-validation: lognormal R−S exact β; FORM invariance [1][3] | Pass |
| reliability-web-validation: correlation changes β per Baecher & Christian [5] | Pass |
| reliability-web-validation: Duncan 2000 / USACE β→P_f + bands [4] | Pass |
| reliability-web-validation: FORM invariant where FOSM is not [3] | Pass |
| reliability-web-validation: TOTAL cited assertions | Pass |
Re-running a row yourself
- Kernel rows. Each row names its test (
cargo test -p tbk-core --test <file> <name> -- --nocapture prints the numbers; #[ignore]d cases run with --ignored). The inputs are the ModelSpec files under app/kernel/verification/cases/.
- Closed-form rows.
node app/scripts/verification-registry.mjs re-measures every row and fails when a pass turns into a miss.
- Validation suites.
cd app/packages/geotech && GEOTECH_TEST_ONLY='<suite>-web-validation' node scripts/test.mjs; all of them with per-test verdicts: node app/scripts/record-validation-suite-run.mjs.
- Independent review.
app/docs/verification-manual/INDEPENDENT-REVIEW-PACK.md lists the cases an outside reviewer should re-run in another program, with inputs and expected outputs.