Struct Config 

pub struct Config {
    pub strategy: Strategy,
    pub spacing: f64,
    pub margin: f64,
    pub time_limit_ms: u64,
    pub target_utilization: Option<f64>,
    pub threads: usize,
    pub population_size: usize,
    pub max_generations: u32,
    pub crossover_rate: f64,
    pub mutation_rate: f64,
    pub elite_count: usize,
    pub seed: Option<u64>,
}

Common configuration for solvers.

Fields

strategy: Strategy

Optimization strategy.

spacing: f64

Minimum distance between any two placed geometries. It does not apply between a geometry and the boundary — that is margin.

margin: f64

Minimum distance between any placed geometry and the boundary edge.

time_limit_ms: u64

Maximum computation time in milliseconds (0 = unlimited).

The search strategies check it between individual placements, so a solve returns within the limit plus the time of the greedy bottom-left pass it is compared against. The layout returned is the best one found in that time.

target_utilization: Option<f64>

Target utilization (0.0 - 1.0). Solver stops if reached.

threads: usize

Number of threads to use (0 = auto).

population_size: usize

Population size for GA.

max_generations: u32

Number of generations for GA.

crossover_rate: f64

Crossover rate for GA (0.0 - 1.0).

mutation_rate: f64

Mutation rate for GA (0.0 - 1.0).

elite_count: usize

Elite count for GA.

seed: Option<u64>

Optional RNG seed for reproducible runs of the stochastic strategies (GA, BRKGA, SA). None seeds from system entropy (non-deterministic).

Implementations

impl Config

pub fn new() -> Self

Creates a new configuration with default values.

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

Checks the fields a caller sets against their ranges – the builders store what they are given, and every solver calls this before it runs.

Errors

ConfigError naming the first field out of range: spacing or margin negative or not finite, crossover_rate/mutation_rate or target_utilization outside [0, 1].

pub fn with_strategy(self, strategy: Strategy) -> Self

Sets the optimization strategy.

pub fn with_spacing(self, spacing: f64) -> Self

Sets the spacing between geometries.

pub fn with_margin(self, margin: f64) -> Self

Sets the margin from boundary edges.

pub fn with_time_limit(self, ms: u64) -> Self

Sets the time limit in milliseconds.

pub fn with_target_utilization(self, util: f64) -> Self

Sets the target utilization.

pub fn with_seed(self, seed: u64) -> Self

Sets the RNG seed for reproducible stochastic runs (GA, BRKGA, SA).

Trait Implementations

impl Clone for Config

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.