Module simulation_log 

Simulation logging, telemetry, and replay utilities.

Provides structured logging of per-step simulation data (energy, timing, body counts), filtering, compression, metrics, snapshotting, and a ring-buffer streaming log.

Structs

DeltaTimestamps

Delta-encoded timestamp sequence (stores differences between consecutive values rather than absolute values).

EnergyMonitor

Tracks kinetic and potential energy; detects anomalous jumps.

LogCompression

Compression statistics for a log field.

LogFilter

Filters a slice of SimLogEntry by time range or custom field predicates.

PerformanceLog

Accumulates per-step timing data.

ReplayLog

Reads back a log and supports time-series reconstruction and interpolation.

RleRun

Run-length encoded representation of a sequence of f64 values.

SimLogEntry

A single logged snapshot of simulation state at one timestep.

SimLogger

Append-only simulation logger with CSV and JSON serialisation.

SimMetrics

Computes statistical summaries over a named field in a log.

SimSnapshot

A full serialisable snapshot of the simulation state.

SnapshotVersion

Version identifier for snapshot format.

StepTiming

Timing (in seconds) for the major phases of one simulation step.

TelemetryStream

Streaming telemetry log that keeps the last capacity entries in memory while also accumulating all entries for bulk export.

Functions

rle_decode

Decode a run-length encoded sequence back to flat values.

rle_encode

Run-length encode a sequence of f64 values.