Struct DetRng 

pub struct DetRng { /* private fields */ }

Deterministic pseudo-random generator keyed by simulation coordinates.

Two constructions with identical (seed, tick, system, salt) inputs yield identical sequences on any machine and thread count - unlike a thread-local RNG, whose per-agent draws depend on Rayon’s run-to-run work-stealing decisions. The sequence is the canonical splitmix64 stream over the derived seed.

Implementations

impl DetRng

pub fn from_context(context: RunContext, salt: u64) -> Self

Creates a generator keyed by the deterministic run context and a caller-chosen salt.

Use a salt that identifies the logical draw site — an entity’s raw id, an agent index, or a (chunk, row) encoding — so distinct agents get independent streams within the same system and tick.

pub fn from_seed(seed: u64) -> Self

Creates a generator from a raw seed.

pub fn next_u64(&mut self) -> u64

Returns the next pseudo-random u64 in the stream.

pub fn next_f64(&mut self) -> f64

Returns a uniformly distributed f64 in [0, 1).

pub fn next_f32(&mut self) -> f32

Returns a uniformly distributed f32 in [0, 1).

pub fn next_below(&mut self, upper: u64) -> u64

Returns a value in [0, upper) via fixed-point scaling.

Returns 0 when upper == 0. The scaling introduces a bias of at most upper / 2^64, negligible for simulation-scale ranges.

pub fn next_index(&mut self, upper: usize) -> usize

Returns a usize index in [0, upper); 0 when upper == 0.

Trait Implementations

impl Clone for DetRng

fn clone(&self) -> DetRng

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DetRng

impl Debug for DetRng

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

Formats the value using the given formatter.