Struct ParticleDiffWriter 

pub struct ParticleDiffWriter {
    pub pos_threshold: f64,
    pub vel_threshold: f64,
    pub deltas: Vec<(u64, Vec<ParticleDelta>)>,
    /* private fields */
}

Writes only the changes between consecutive particle frames (delta encoding).

This format is useful for large simulations where only a small fraction of particles move significantly each frame, enabling compact storage.

Fields

pos_threshold: f64

Threshold below which position changes are considered zero.

vel_threshold: f64

Threshold below which velocity changes are considered zero.

deltas: Vec<(u64, Vec<ParticleDelta>)>

Accumulated delta frames.

Implementations

impl ParticleDiffWriter

pub fn new() -> Self

Create a diff writer with default thresholds (1e-9 for position, 1e-9 for velocity).

pub fn with_thresholds(pos_threshold: f64, vel_threshold: f64) -> Self

Create with custom thresholds.

pub fn write_frame(&mut self, current: &ParticleDataset) -> usize

Process a new frame, computing and storing the delta vs the previous frame.

Returns the number of changed particles in this frame.

pub fn total_deltas(&self) -> usize

Total number of delta records across all frames.

pub fn to_bytes(&self) -> Vec<u8>

Serialise all delta frames to a compact binary format.

pub fn reconstruct(&self, through_step: u64) -> ParticleDataset

Reconstruct a full dataset from delta frames up to step.

Trait Implementations

impl Debug for ParticleDiffWriter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ParticleDiffWriter

fn default() -> ParticleDiffWriter

Returns the “default value” for a type.