Struct SeedSequence 

pub struct SeedSequence { /* private fields */ }

SeedSequence — deterministic entropy expansion and child spawning.

Equivalent to numpy.random.SeedSequence. Construct from an entropy: u64; call generate_state for n_words 32-bit seed words, or spawn to create n independent child sequences whose state is reproducibly derived from this one.

Implementations

impl SeedSequence

pub fn new(entropy: u64) -> Self

Create a SeedSequence from a single entropy value.

pub fn with_spawn_key(entropy: u64, spawn_key: Vec<u64>) -> Self

Create a SeedSequence with an explicit spawn-key path.

The spawn key disambiguates children of the same parent. Normally users construct via new and let spawn populate the key automatically.

pub fn entropy(&self) -> u64

The entropy this sequence was created with.

pub fn spawn_key(&self) -> &[u64]

The spawn-key path of this sequence (empty for the root).

pub fn generate_state(&self, n_words: usize) -> Vec<u32>

Generate n_words 32-bit seed words from this sequence.

The output is a deterministic function of (entropy, spawn_key) only — calling generate_state repeatedly returns the same words. Different sequences produce statistically independent outputs.

pub fn generate_u64(&self) -> u64

Generate a single u64 derived from this sequence — convenient for seeding a BitGenerator via BitGenerator::seed_from_u64.

pub fn seed<B: BitGenerator>(&self) -> B

Seed a fresh BitGenerator deterministically from this sequence.

pub fn spawn(&mut self, n: usize) -> Vec<SeedSequence>

Create n independent child sequences.

Each child has the same entropy as the parent but a different spawn_key, so their generate_state outputs do not overlap. Mutates self’s spawn counter so successive calls yield fresh children.

Trait Implementations

impl Clone for SeedSequence

fn clone(&self) -> SeedSequence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SeedSequence

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

Formats the value using the given formatter.