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

1 Pick a template standard scenarios 2 Set parameters generated panels 3 Run pre-run estimate 4 Inspect (.dres) result cards 5 Export portable case folder
1 · pile-angle

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.

2 · direct-shear

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.

3 · triaxial

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.

4 · box-lift

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.

5 · slope

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.