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.

47 parameters

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.

51 parameters

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.

50 parameters

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.

49 parameters

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.

49 parameters

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:

Measured anchor curve — four points, no smoothing 0.2 0.4 0.6 0.8 1.0 10 15 20 25 30 35 Measured angle of repose (°) Particle friction μ 15.66° 23.54° 29.16° 32.71°
S3 route, 5 friction values × 3 seeds, damping 0.2, wall friction = particle friction.
Particle friction μMeasured angle of repose
0.315.66°
0.523.54°
0.729.16°
0.932.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

OutputWhere you see it
Angle of reposePile angle template, computed on the result card — plus the inverse solve above
Shear stress–displacement curveDirect shear, analysis card
Deviator stress–axial strain, c / φ / dilatancy angleTriaxial, strength-envelope fitting across runs
Lift force curveBox lift, analysis card
Displacement field and runout extentSlope, result view

Read the per-template calibration workflows →

What happens between your click and the chart

Every template run follows the same five steps, and each step is one you can inspect:

Fill the panel Pick a scenario, fill the fields Schema validation Units, ranges and cross-field rules Isolated YADE process Runs the generated command stream .dres result file One schema-typed file per run Analysis cards Curves and fields on result cards