Struct PsoConfig 

pub struct PsoConfig {
    pub pop_size: usize,
    pub genome_dim: usize,
    pub bounds: Bounds,
    pub inertia: f32,
    pub c1: f32,
    pub c2: f32,
    pub v_max: f32,
    pub variant: PsoVariant,
}

Static configuration for a ParticleSwarm run.

Fields

pop_size: usize

Number of particles in the swarm.

genome_dim: usize

Genome (position) dimensionality.

bounds: Bounds

Search-space bounds for initialization and position clamping.

inertia: f32

Inertia weight (only used by PsoVariant::Inertia).

c1: f32

Cognitive coefficient (personal-best pull).

c2: f32

Social coefficient (global-best pull).

v_max: f32

Per-dimension velocity clamp. Classical PSO literature recommends ~half the search-space extent.

variant: PsoVariant

Variant.

Implementations

impl PsoConfig

pub fn default_for(pop_size: usize, genome_dim: usize) -> Self

Default configuration matching Shi & Eberhart’s canonical settings (ω = 0.7298, c1 = c2 = 1.49618) — the constriction-equivalent values so Inertia and Constriction variants agree in behaviour under the same default.

The default variant is PsoVariant::Inertia. To switch to the constriction form, set variant = PsoVariant::Constriction and update c1 and c2 so that c1 + c2 > 4 (the Clerc & Kennedy requirement — the default c1 = c2 = 1.49618 gives φ ≈ 2.99, which violates this); a canonical choice is c1 = c2 = 2.05.

pub fn constriction_chi(&self) -> f32

Computes the constriction factor χ = 2 / |2 − φ − √(φ² − 4φ)| where φ = c1 + c2.

Clerc & Kennedy (2002) require φ > 4 for the closed form to be real-valued. If φ ≤ 4 the discriminant is clamped to zero and χ falls back to 1.0 (no contraction) so the strategy remains numerically well-defined. A debug_assert! fires in debug builds when this fallback is triggered; it is silent in release builds.

Trait Implementations

impl Clone for PsoConfig

fn clone(&self) -> PsoConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PsoConfig

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

Formats the value using the given formatter.

impl Validate for PsoConfig

fn validate(&self) -> Result<(), ConfigError>

Returns Ok(()) when every invariant holds, or the first ConfigError otherwise.

fn validate_all(&self) -> Result<(), Vec<ConfigError>>

Returns every violated invariant rather than just the first.