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.
