Struct RandomSampler 

pub struct RandomSampler { /* private fields */ }

Yields a uniformly shuffled permutation of indices every epoch.

Uses the inside-out Fisher-Yates algorithm with fastrand (wyrand): a single-multiply PRNG that is ~30% faster than Xoshiro256++ for this workload. The inside-out variant builds and shuffles in a single forward pass — no pre-fill, and random accesses stay within the already-written prefix [0..i] for better cache behaviour.

Implementations

impl RandomSampler

pub fn new(seed: u64) -> Self

Deterministic seed. Use this for reproducible experiments.

pub fn from_entropy() -> Self

Seed from OS entropy. Use this when reproducibility is not required.

Trait Implementations

impl Debug for RandomSampler

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

Formats the value using the given formatter.

impl Sampler for RandomSampler

fn indices(&mut self, dataset_len: usize) -> Vec<usize>

Return the index sequence for one epoch over a dataset of dataset_len items.

fn len(&self, dataset_len: usize) -> usize

Number of indices indices returns for a dataset of dataset_len items, without advancing the sampler.