mddem_print 0.1.3

Output systems for MDDEM: thermo, VTP visualization, dump files, restart files
Documentation

mddem_print

Output systems for MDDEM simulations: thermo logging, VTP visualization, granular temperature, dump files, and restart files.

Output Types

  • Thermo — LAMMPS-style periodic console output: step, atom count, kinetic energy, neighbor count, wall time, steps/s.
  • VTP — ParaView-compatible .vtp files with per-atom positions, velocity magnitudes, and ghost/collision flags. Visualize with ParaView's Point Gaussian representation.
  • Dump — Per-atom data in CSV (text) or binary format. Fields: tag, type, x, y, z, vx, vy, vz, fx, fy, fz, radius.
  • Restart — Full simulation state in bincode or JSON format. Generic serialization — any registered AtomData extension (e.g., DemAtom, ContactHistoryStore) is automatically saved and restored.

Note: Granular temperature output (GranularTempPlugin) has moved to the dem_granular crate and is included in GranularDefaultPlugins.

Configuration

[vtp]
interval = 1000        # Write VTP every N steps (0 = disabled)

[dump]
interval = 5000        # Write dump every N steps (0 = disabled)
format = "text"        # "text" (CSV) or "binary"

[restart]
interval = 10000       # Write restart every N steps (0 = disabled)
format = "bincode"     # "bincode" or "json"
read = false           # Read restart file on startup

Per-stage overrides are supported in multi-stage [[run]] configs via dump_interval, restart_interval, and vtp_interval.

Usage

PrintPlugin is included in CorePlugins and registers all output systems automatically.

Part of the MDDEM workspace.