Enum SeedPurpose 

#[repr(u8)]
pub enum SeedPurpose {
    Init = 0,
    Selection = 1,
    Crossover = 2,
    Mutation = 3,
    Replacement = 4,
    Trial = 5,
    Other = 6,
    LocalSearch = 7,
    EdaSampling = 8,
    Representative = 9,
    Transposition = 10,
    CmaSampling = 11,
}

Tag identifying which evolutionary operation a sub-stream is for.

Mixing the purpose into the seed means that, within a single generation, selection and mutation draw from non-overlapping PRNG streams — critical for reproducing trial-level determinism across refactors that reorder operator calls.

Variants

Init = 0

Initial population sampling.

Selection = 1

Parent selection.

Crossover = 2

Recombination / crossover.

Mutation = 3

Mutation.

Replacement = 4

Replacement / survivor selection.

Trial = 5

Differential-evolution trial-vector construction.

Other = 6

Catch-all for strategy-specific stochastic steps.

Isolation caveat

Unlike the named purposes (each owning a distinct operator role), Other is a shared bucket used by many unrelated strategies (evolutionary programming, ES, NEAT, NAS, and the swarm family: SALP/WOA/GWO/ABC/PSO/BAT). Two different strategies both passing Other get the same domain constant, so their cross-strategy isolation relies entirely on each call site passing a distinct base (and/or generation) — typically a fresh rng.next_u64(). If two Other call sites ever share the same (base, generation), their streams alias. Prefer a dedicated named variant for any operator that needs guaranteed isolation within a fixed (base, generation).

Note: this variant’s constant 0x9E37_79B9_7F4A_7C15 coincides with the φ64 golden-ratio multiplier applied to generation in seed_stream. No concrete collision exists today (no purpose uses constant 0, and the generation term is multiplied), but it is a latent footgun — do not assume the Other domain is independent of the generation axis.

LocalSearch = 7

Local-search refinement (memetic algorithms).

Used by crate::local_search searchers so a memetic wrapper’s per-individual refinement draws from a stream independent of the inner strategy’s selection/mutation/crossover/replacement streams.

EdaSampling = 8

Model sampling in estimation-of-distribution (EDA) strategies.

Used by crate::algorithms::eda so each generation draws its new population from an independent per-generation stream, isolated from every other operator purpose.

Representative = 9

Representative selection in cooperative co-evolution (CCGA).

Used by crate::coevolution so the Random and Archive representative-selection policies draw their opposing-population representatives from a stream independent of either sub-strategy’s selection/mutation/crossover/replacement streams.

Transposition = 10

Transposition operators (gene expression programming).

Used by crate::algorithms::gep so IS/RIS transposition draws from a stream independent of the point-mutation (Mutation) and crossover (Crossover) streams within the same generation.

CmaSampling = 11

Multivariate-Gaussian sampling in covariance-matrix strategies.

Used by crate::algorithms::cma_es and crate::algorithms::cmsa_es so each generation draws its N(m, σ²C) offspring (and, for CMSA-ES, the per-individual log-normal σ mutations) from a stream independent of every other operator purpose.

Trait Implementations

impl Clone for SeedPurpose

fn clone(&self) -> SeedPurpose

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SeedPurpose

impl Debug for SeedPurpose

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

Formats the value using the given formatter.

impl Eq for SeedPurpose

impl Hash for SeedPurpose

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SeedPurpose

fn eq(&self, other: &SeedPurpose) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SeedPurpose