Enum SearchStrategy 

pub enum SearchStrategy {
    Grid,
    Random {
        budget: usize,
        seed: u64,
        max_wall_secs: Option<u64>,
    },
    Bayesian {
        budget: usize,
        warmup: usize,
        gamma: f64,
        seed: u64,
        max_wall_secs: Option<u64>,
    },
}

Which enumeration to use over the SearchSpace.

Variants

Grid

Exhaustive Cartesian-product enumeration. Cost scales with the grid cardinality — see SearchSpace::grid_cardinality.

Random

Uniform random sampling for budget trials.

Fields

budget: usize

seed: u64

max_wall_secs: Option<u64>

Optional wall-time cap in seconds. When set, the tuner stops proposing new trials once cumulative elapsed time exceeds this limit. Already-running trials are not interrupted. None = unlimited (legacy behavior).

Bayesian

Sequential Bayesian-ish search. After warmup uniform random trials, subsequent trials pick each knob’s value by the ratio of per-value probabilities between the top-gamma-fraction trials (“good”) and the bottom 1 − gamma (“bad”). This is an axis-parallel TPE-lite acquisition: independent across knobs, Laplace-smoothed, reproducible under a fixed seed.

Trades a constant-factor more code for meaningful sample efficiency versus uniform random — typical win on our default space is ~30% fewer trials to reach the random-search ceiling.

Fields

budget: usize

warmup: usize

Initial uniform random trials before the acquisition kicks in. Must be ≥ 2 so the “good” / “bad” split is non-degenerate.

gamma: f64

Fraction of past trials treated as “good” when fitting the acquisition. 0.25 is the TPE default; smaller = more exploit, larger = more explore.

seed: u64

max_wall_secs: Option<u64>

Optional wall-time cap in seconds. Same semantics as Self::Random::max_wall_secs.

Trait Implementations

impl Clone for SearchStrategy

fn clone(&self) -> SearchStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchStrategy

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

Formats the value using the given formatter.