Struct ParticleDataset 

pub struct ParticleDataset {
    pub ids: Vec<u64>,
    pub positions: Vec<[f64; 3]>,
    pub velocities: Vec<[f64; 3]>,
    pub masses: Vec<f64>,
    pub radii: Vec<f64>,
    pub properties: HashMap<String, Vec<f64>>,
    pub time: f64,
    pub step: u64,
}

A single-frame snapshot of a particle simulation.

Each particle is identified by a unique integer id and carries: position, velocity, mass, radius, and an optional property bag.

Fields

ids: Vec<u64>

Particle IDs (parallel arrays with positions, velocities, etc.).

positions: Vec<[f64; 3]>

Particle positions — [x, y, z] for each particle.

velocities: Vec<[f64; 3]>

Particle velocities — [vx, vy, vz] for each particle.

masses: Vec<f64>

Particle masses.

radii: Vec<f64>

Particle radii.

properties: HashMap<String, Vec<f64>>

Named scalar/vector properties per particle (e.g. "temperature").

time: f64

Simulation time associated with this snapshot.

step: u64

Simulation step index.

Implementations

impl ParticleDataset

pub fn new() -> Self

Create an empty dataset at time 0.

pub fn with_time(time: f64, step: u64) -> Self

Create a dataset with the given time and step.

pub fn len(&self) -> usize

Return the number of particles in this dataset.

pub fn is_empty(&self) -> bool

Return true if the dataset contains no particles.

pub fn add_particle( &mut self, id: u64, position: [f64; 3], velocity: [f64; 3], mass: f64, radius: f64, ) -> usize

Add a single particle, returning its index.

pub fn add_property(&mut self, name: impl Into<String>, values: Vec<f64>)

Add a named scalar property array.

values must have the same length as the current particle count (or be empty, which will be zero-extended later).

pub fn position(&self, i: usize) -> [f64; 3]

Return the position of particle at index i.

pub fn velocity(&self, i: usize) -> [f64; 3]

Return the velocity of particle at index i.

pub fn bounding_box(&self) -> Option<([f64; 3], [f64; 3])>

Compute the axis-aligned bounding box as (min, max).

Returns None if the dataset is empty.

pub fn centroid(&self) -> [f64; 3]

Compute the mean position (centroid) of all particles.

pub fn kinetic_energy(&self) -> f64

Compute the total kinetic energy (0.5 * m * v²).

pub fn max_speed(&self) -> f64

Return the maximum speed among all particles.

pub fn merge(&mut self, other: &ParticleDataset)

Merge another dataset into this one (append particles).

pub fn filter<F>(&self, pred: F) -> ParticleDataset

where F: Fn(usize) -> bool,

Filter particles by a predicate on their index, returning a new dataset.

Trait Implementations

impl Clone for ParticleDataset

fn clone(&self) -> ParticleDataset

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ParticleDataset

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

Formats the value using the given formatter.

impl Default for ParticleDataset

fn default() -> ParticleDataset

Returns the “default value” for a type.