Struct SnapshotTable 

pub struct SnapshotTable {
    pub snapshots: Vec<Snapshot>,
    pub diffs: Vec<DiffEntry>,
    pub compressed: HashMap<String, Vec<(f64, usize)>>,
}

Time-indexed table of simulation snapshots with optional RLE compression and differential storage.

Fields

snapshots: Vec<Snapshot>

Stored snapshots ordered by insertion time.

diffs: Vec<DiffEntry>

Differential entries for fields that change sparsely between snapshots.

compressed: HashMap<String, Vec<(f64, usize)>>

RLE-compressed versions of field arrays, keyed by "field@time_idx".

Implementations

impl SnapshotTable

pub fn new() -> Self

Create an empty table.

pub fn insert(&mut self, snap: Snapshot)

Insert a snapshot; snapshots are kept in ascending time order.

pub fn query_time_range(&self, t_lo: f64, t_hi: f64) -> Vec<&Snapshot>

Return all snapshots whose time falls in \[t_lo, t_hi\].

pub fn nearest(&self, t: f64) -> Option<&Snapshot>

Retrieve a single snapshot whose time is closest to t.

pub fn compress_field(&mut self, snap_idx: usize, field: &str)

Compress a named field of the snapshot at index snap_idx using RLE.

The compressed data is stored internally under the key "field@snap_idx".

pub fn decompress_field(&self, snap_idx: usize, field: &str) -> Option<Vec<f64>>

Decompress a previously compressed field, returning the flat Vecf64`.

Returns None if the field was not compressed.

pub fn compute_diff(&mut self, field: &str, snap_idx: usize) -> usize

Compute the differential between consecutive snapshots for a named field and store the result in self.diffs.

Returns the number of changed elements.

pub fn apply_diff(base: &mut [f64], diff: &DiffEntry)

Apply a stored diff to a base field array, returning the updated array.

base is modified in-place by overwriting the changed indices.

pub fn len(&self) -> usize

Return the number of snapshots.

pub fn is_empty(&self) -> bool

Return true if the table is empty.

Trait Implementations

impl Debug for SnapshotTable

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

Formats the value using the given formatter.

impl Default for SnapshotTable

fn default() -> SnapshotTable

Returns the “default value” for a type.