Struct SearchConfig 

pub struct SearchConfig {

    pub waypoint_count: WaypointCount,
    pub time_weight: f64,
    pub fuel_weight: f64,
    pub land_weight: f64,
    pub particles_space: usize,
    pub particles_time: usize,
    pub iter_space: usize,
    pub iter_time: usize,
    pub inertia: f64,
    pub cognitive_coeff: f64,
    pub social_coeff: f64,
    pub path_kick_probability: f64,
    pub path_kick_gamma_0_fraction: f64,
    pub path_kick_gamma_min_fraction: f64,
    pub seed: Option<u64>,
    pub step_distance_fraction: f64,
    pub bake_step_deg: f64,
    pub sdf_resolution_deg: f64,
    pub range_k: usize,
    pub k_mcr: usize,
    pub topology: Topology,
}

Inputs to the sailing-search PSO.

Fields

waypoint_count: WaypointCount

How many waypoints the path has (endpoints included).

time_weight: f64

fitness = -(time*time_weight + fuel*fuel_weight + land_metres*land_weight). land_weight = 0 disables the soft landmass-avoidance penalty.

fuel_weight: f64

See Self::time_weight.

land_weight: f64

See Self::time_weight.

particles_space: usize

Outer-PSO particle count (route shape).

particles_time: usize

Inner time-PSO particle count (per-waypoint timing).

iter_space: usize

Outer-PSO iteration count.

iter_time: usize

Inner time-PSO iteration count.

inertia: f64

inertia weights prior velocity; cognitive_coeff pulls toward pbest; social_coeff toward gbest. Shared by outer (space) and inner (time) PSOs.

cognitive_coeff: f64

See Self::inertia.

social_coeff: f64

See Self::inertia.

path_kick_probability: f64

Path-shape kick lets the search jump into tacking topologies that gradient-style PSO can’t reach. path_kick_probability is per-particle, per-iteration; the two gammas are initial and floor magnitudes as fractions of the route’s straight-line length, cosine-decayed across iterations.

path_kick_gamma_0_fraction: f64

See Self::path_kick_probability.

path_kick_gamma_min_fraction: f64

See Self::path_kick_probability.

seed: Option<u64>

None (default) draws fresh OS entropy; Some(s) makes the run reproducible.

step_distance_fraction: f64

Wind / landmass integration substep, as a fraction of the route bbox diagonal. Default 0.01.

bake_step_deg: f64

Wind-grid cell size (degrees) when baking the search grid. Default 0.25°. Grown automatically if the map would overflow the per-axis cell cap.

sdf_resolution_deg: f64

Landmass SDF cell size (degrees). Default 0.5°. Each distinct value pays a one-shot ~sub-second build.

range_k: usize

Inner time-PSO lookup-table samples along the departure-time axis. Default 8. Must be ≥ 2.

k_mcr: usize

Inner time-PSO lookup-table samples along the mcr_01 throttle axis. Default 8. Must be ≥ 2.

topology: Topology

Round-trips through TOML / JSON as the lowercase variant name.

Implementations

impl SearchConfig

pub fn to_search_settings(&self) -> SearchSettings

pub fn validate(&self) -> Result<(), ValidationError>

Reject configs that would crash the PSO or produce nonsense output. Cheap; a 30-second search that crashes on iter 0 because particles_space = 0 is strictly worse than a 1 ms reject at submit time.

Errors

Returns the first field that violates a rule.

Trait Implementations

impl Clone for SearchConfig

fn clone(&self) -> SearchConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchConfig

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

Formats the value using the given formatter.

impl Default for SearchConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SearchConfig

where SearchConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SearchConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for SearchConfig