Case workflows
Each template is the shortest path from parameters to a calibration conclusion: pick it, adjust the knobs, read the pre-run estimate, run, then read the result cards.
The shared workflow
Pile angle
Input: Particle size distribution, friction parameters, filling mode.
Output: Angle of repose.
Why this one: The cheapest calibration case — fewest particles, shortest runtime. Wrong friction shows up in the first step, which is why it opens the calibration workflow.
Direct shear
Input: Graded normal stress, shear rate, particle and wall parameters.
Output: Shear stress–displacement curve, then cohesion c and friction angle φ.
Why this one: Multiple normal-stress levels give the shear envelope — one of the two standard geotechnical calibration curves.
Triaxial
Input: Graded confining stress, loading rate, particle and wall parameters.
Output: Deviator stress–axial strain with volumetric strain, fitted to c, φ and the dilatancy angle.
Why this one: One curve yields the full parameter set. The estimate bar states particle count and expected runtime before you commit — and shows what a larger grain diameter buys you.
Box lift
Input: Particle bed parameters, lift velocity.
Output: Lift force curve.
Why this one: The EDEM Calibration Kit standard case — if your team already has EDEM calibration data, this curve is the most direct cross-validation channel.
Slope
Input: Slope geometry, material parameters, trigger conditions.
Output: Displacement and velocity fields, runout extent.
Why this one: Comparing mitigation schemes and assessing impact range; the result cards give cross-section and top views.
Fibre reinforcement (advanced)
The templates share a fibre-reinforcement option: fibre chains added to the particle system, for reinforced soil and fibre-modified materials. Fibres significantly lower the stable time step — when the gate is on, the estimate bar names the fibre gate and quantifies what switching it off would save, instead of just reporting "too slow".
Result files
Every run produces a versioned .dres result file (particle trajectories,
time series, metadata) with a versioned format contract: old results still open in new
versions. Copy the whole case folder to a colleague — it opens on double-click.
Full documentation
User manual (HTML) · Capability map — both generated from the code base and shipped with the package.