APPENDIX A

Output Files and Formats

Quick reference to solver output files and their intended uses.

FILE EXPECTED USE
energy.csv Kinetic, potential and total energy per timestep
contact_stats.csv Contact statistics (contact number, overlap)
body_forces.csv Geometry force and torque with measurement enabled
aggregated_summary.csv Aggregated summary of particle variables
particles_NNNNNN.bin Particle state at each saved moment (DEM2 format)
checkpoint_final.bin Complete final simulation state
*.stl Surface geometry (input and output of Sketch Modeler)
*.brixdemproject BrixDEM Main Project File
run.log Solver execution log, saved by console

Files .csv open in any spreadsheet or analysis tool. The snapshots particles_NNNNNN.bin and checkpoint_final.bin are automatically loaded by the tab 3D particles - it is not necessary to open them manually.

Detail of major CSVs (columns and units)

FILE MAIN COLUMNS UNITS
energy.csv step, time, KE, PE, TE s; J
body_forces.csv Fx, Fy, Fz, F mag, Tx, Ty, Tz, T mag, omega, P mech N; N·m; rad/s; W
contact_stats.csv step, time, n contacts, coordination (min/med/max), overlap —; %
mixing.csv time, Lacey index, concentration CV s; dimensionless
aggregated_summary.csv mean/max. velocity, ω, force, diameter, residence per step m/s; rad/s; N; m; s

When to use each format

FORMAT WHEN TO USE
CSV Time series and statistics for spreadsheet, graphs and reports; always readable
.bin (DEM2) Complete particle state at an instant; used by 3D Particles tab and to reprocess/render
checkpoint_final.bin Resume or extend a simulation from the final state
STL Surface geometry - Sketch Modeler input and export

A.4 Liquid bridge and breakage outputs

Outputs may record film/bridge volumes, mean free liquid by material, and impact, compressive-force, energy/damage and fragment-age scalars. Availability depends on recording options and file version; missing means not recorded, not zero. See Chapters 10 and 16.