Templates
Each template is a complete scenario: a parameter panel (47–51 parameters, units and validated ranges included), 13 preset groups across the set, 7 analysis cards, and one-click export of the YADE command stream.
Pile angle
Particles fall from a slump cylinder and form a cone; the angle of repose is measured. The most common calibration case.
Answers: Angle of repose for a given micro-parameter set.
Use it for: First calibration step — fewest particles, shortest runtime; wrong friction shows up immediately. Ships the one inverse solve: back out particle friction from a target angle.
Direct shear
The lower half of the split box is fixed and the upper half shears along x; outputs a shear stress–displacement curve.
Answers: Shear stress–displacement behaviour under graded normal stress.
Use it for: Multiple normal-stress levels give the shear envelope — one of the two standard geotechnical calibration curves.
Triaxial
Cylindrical specimen under constant confining stress with axial loading; outputs deviator stress–axial strain and fits c, φ, dilatancy angle.
Answers: Deviator stress–axial strain with volumetric strain; c, φ and dilatancy angle.
Use it for: One curve yields the full parameter set. The estimate bar states particle count and expected runtime before you commit.
Box lift
The box is lifted out of a pile of material; outputs a lift force curve. The standard case of the EDEM Calibration Kit.
Answers: Lift force as the box leaves the bed.
Use it for: If your team already has EDEM calibration data, this curve is the most direct cross-validation channel.
Slope
The slope body fails and slides under gravity; outputs a displacement field and the runout extent.
Answers: Displacement and velocity fields, runout extent.
Use it for: Comparing mitigation schemes and assessing impact range; result cards give cross-section and top views.
The inverse solve, with its caveats on the panel
The pile-angle template ships 1 inverse solve: given a target angle of
repose, it reads particle friction contact.mu_pp off a measured anchor curve.
The curve is measured, not assumed — 4 friction values × 3 seeds, recorded
with the run that produced it:
| Particle friction μ | Measured angle of repose |
|---|---|
| 0.3 | 15.66° |
| 0.5 | 23.54° |
| 0.7 | 29.16° |
| 0.9 | 32.71° |
And the caveats are stated where you will actually see them — on the template panel:
- This is a curve inversion, not an analytical solution — the calibrated interval is μ ≥ 0.3.
- The model has no rolling friction, so the absolute angle sits about 10° below real sand and the inverted μ comes out high.
- The curve was measured at damping 0.2 with wall friction equal to particle friction (the template defaults); change either and it no longer applies — damping 0.4 alone raises the angle by about 6° at the same μ.
How a template is built
A template starts as a schema: every parameter is declared with its unit, its valid range, and whether it is a core knob or an advanced one. The UI is generated from that schema — the panel you see is a projection of what the solver actually consumes, not a hand-built form that can drift from it.
Declared units
A parameter declared in kPa is displayed in kPa and converted to SI exactly once, at the boundary — the panel and the contract cannot disagree.
Validated ranges
Ranges are part of the schema, and cross-field rules (a value that is fine alone but breaks a combination) are checked in the same place the UI checks them.
Presets
13 preset groups across the five templates — measured starting points, not defaults-of-last-resort.
Case recipes
8 ready-to-run recipes ship in code: 1-D compression, a settling column, cylindrical pile arrays, geometric slopes, layered excavation, true triaxial loading, mining subsidence and a tectonic sandbox.
What you get from a run
| Output | Where you see it |
|---|---|
| Angle of repose | Pile angle template, computed on the result card — plus the inverse solve above |
| Shear stress–displacement curve | Direct shear, analysis card |
| Deviator stress–axial strain, c / φ / dilatancy angle | Triaxial, strength-envelope fitting across runs |
| Lift force curve | Box lift, analysis card |
| Displacement field and runout extent | Slope, result view |
What happens between your click and the chart
Every template run follows the same five steps, and each step is one you can inspect: