APPENDIX B

Particle scalar variables

Definition, units, population and availability of individual fields.

Use this dictionary for particle colouring and individual-field interpretation. Units appear in the GUI selector. An available option does not ensure that an older file contains the field: unavailable does not mean zero. Global plots and aggregations are explained in Chapter 16; total liquid volumes are global inventories rather than particle scalars.

GUI fieldUnitDefinition and interpretationPopulation / availability
Info / IDs—Discrete type, particle, material and injection identifiers. Averaging or interpolating IDs has no physical meaning.Available metadata.
Position X, Y, Z / radiusmRecorded coordinates and represented radius. Z means height only when the case uses Z as vertical.Particle geometry snapshots.
Velocity X, Y, Z / magnitudem/sSigned components and |v|; magnitude has no sign.Velocity snapshots.
Angular velocity X, Y, Z / magnituderad/sComponents of ω and its magnitude; not angles.Rotation snapshots.
MasskgRecorded individual mass, not total system mass.Available mass field.
Force X, Y, Z / magnitudeNComponents and magnitude of the recorded resultant; opposing contacts can cancel.Force snapshots.
Torque X, Y, Z / magnitudeN·mComponents and magnitude of recorded torque.Torque snapshots.
Total kinetic energyJKinetic energy of the represented body/particle, including rotation according to available data; “total” does not mean a domain sum.Compatible mass, velocity, inertia/rotation or energy fields.
Residence timest − recorded birth with valid births.bin; in older results, t − first observed ID time. For aggregated plots, check the basis in 16.2. Not predicted time until discharge.Available temporal ID history.
Free liquid content%100ρlVfilm,i/mdry,i. Excludes bridges; can fall during bridge formation without losing total liquid.Enabled liquid-bridge pair and recorded individual content; missing fields cannot be reconstructed.
Impact energyJΣ½meff,cvn,c² for retained compressive contacts at the sampled step, including unloading. Not event work or dissipated energy.Recorded individual diagnostic at particle cadence.
Compression forceNΣFn,c+, scalar sum of compression excluding cohesive attraction; differs from resultant force.Recorded individual diagnostic; clump treated as one body.
Fragment agest − tbirth; does not inherit feed residence time.Resolved fragments with valid genealogy only; originals have no value.
Relative damage%100 × clamp(1−Ecurrent/Einitial,0,1), model resistance reduction, not probability.Breakable bodies with positive initial energy and saved breakage state.
Event specific energyJ/kgWevent/m; resets on event closure and does not sum earlier events.Available event work and positive mass.
Original / fragment—0 = original; 1 = replacement fragment. A category, not a fragmented-mass fraction.Recorded births.bin genealogy covering the time.
Fragment generation—Original 0; child = parent generation + 1. Does not imply size or mass.Valid genealogy; increments at each repeated fracture.

Impact and compression diagnostics count clumps as single bodies; constituent spheres can receive their body colour. For basic quantities, respect the entity represented in the file: do not sum repeated clump-sphere data as independent bodies. Colour scales compare values at the displayed time; use fixed limits across cases and check recording cadence before interpreting peaks.