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: Option<usize>,
    pub max_generations: Option<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: Option<usize>

Population size for the population-based strategies (GA, BRKGA).

None runs each strategy with the size it is tuned for – 2D GA and BRKGA 30, 3D GA 100, 3D BRKGA 50; Some(n) runs it with n, at least 2. The other strategies have no population and do not read it.

max_generations: Option<u32>

Generation budget for the population-based strategies (GA, BRKGA).

None runs each strategy with the budget it is tuned for – 2D GA and BRKGA 50, 3D GA 500, 3D BRKGA 100; Some(n) allows n generations (0 evaluates the first population only). A run also ends on the time limit, on cancellation and when the best layout stops improving.

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, GDRR, ALNS – 2D and 3D). None seeds from system entropy (non-deterministic).

A seeded run draws every random choice from the seed, so the same request with the same seed returns the same layout when the run ends on its own budget – the generation or iteration count, convergence, or the target utilization. A run cut short by the clock is not reproduced: how far a search gets before time_limit_ms (or a cancellation) stops it depends on the machine and its load. In 2D a search keeps a time budget of its own even when time_limit_ms is 0 (15 s for GA and BRKGA, 10 s for SA, GDRR and ALNS), so a large 2D request can reach it.

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], a population_size set below 2.

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 (see Config::seed).

pub fn with_population_size(self, size: usize) -> Self

Sets the population size of the population-based strategies, in place of each strategy’s own (see Config::population_size).

pub fn with_max_generations(self, generations: u32) -> Self

Sets the generation budget of the population-based strategies, in place of each strategy’s own (see Config::max_generations).

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.