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 field | Unit | Definition and interpretation | Population / availability |
|---|---|---|---|
| Info / IDs | — | Discrete type, particle, material and injection identifiers. Averaging or interpolating IDs has no physical meaning. | Available metadata. |
| Position X, Y, Z / radius | m | Recorded coordinates and represented radius. Z means height only when the case uses Z as vertical. | Particle geometry snapshots. |
| Velocity X, Y, Z / magnitude | m/s | Signed components and |v|; magnitude has no sign. | Velocity snapshots. |
| Angular velocity X, Y, Z / magnitude | rad/s | Components of ω and its magnitude; not angles. | Rotation snapshots. |
| Mass | kg | Recorded individual mass, not total system mass. | Available mass field. |
| Force X, Y, Z / magnitude | N | Components and magnitude of the recorded resultant; opposing contacts can cancel. | Force snapshots. |
| Torque X, Y, Z / magnitude | N·m | Components and magnitude of recorded torque. | Torque snapshots. |
| Total kinetic energy | J | Kinetic 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 time | s | t − 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 energy | J | Σ½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 force | N | ΣFn,c+, scalar sum of compression excluding cohesive attraction; differs from resultant force. | Recorded individual diagnostic; clump treated as one body. |
| Fragment age | s | t − 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 energy | J/kg | Wevent/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.
