Struct BenchConfig 

pub struct BenchConfig {
    pub min_samples: usize,
    pub max_samples: usize,
    pub short_circuit_samples: usize,
    pub speed_factor: f64,
    pub adaptive: bool,
}

Controls how many samples autotune collects per candidate and when candidates are dropped.

Only max_samples and adaptive mean anything to the fixed-count pass; the rest describe elimination, which only the adaptive scheduler performs. Each field says so, because a knob that silently does nothing on the strategy actually running is worse than no knob at all — and adaptive is native-only, so on wasm that is every run.

Fields

min_samples: usize

Samples every surviving candidate gets before any elimination happens.

Adaptive only: the fixed-count pass eliminates nothing, so every candidate gets max_samples regardless.

max_samples: usize

Upper bound on samples collected for a single candidate.

Read by both strategies: the ceiling for the adaptive scheduler, and the flat count for the fixed pass, which has no elimination to spend a smaller budget on.

short_circuit_samples: usize

Samples that must independently land under the time limit to short circuit.

A short circuit decision is written to the persistent cache and reused on later runs, so it is confirmed rather than taken from a single possibly-lucky sample.

Adaptive only: the fixed pass has the whole sample set in hand before it tests the limit, so it has nothing to confirm.

speed_factor: f64

How many times slower than the current best a candidate may be before elimination.

Adaptive only. Values below 1.0 are read as 1.0, which eliminates every candidate slower than the leader that the survivor floor allows.

adaptive: bool

Whether to use the adaptive round robin benchmark instead of a fixed sample count.

Ignored on wasm, which cannot resolve samples between rounds and so always takes the fixed-count pass.

Implementations

impl BenchConfig

Every knob is read through an accessor that clamps it into its usable range, so a config file can hold a nonsensical value without any single call site having to remember the repair.

pub fn samples(&self) -> (usize, usize)

The sample budget, clamped so the range is always usable.

pub fn short_circuit_samples(&self) -> usize

How many samples must land under the limit, clamped so a short circuit always needs one.

pub fn speed_factor(&self) -> f64

The elimination threshold, clamped so it can never sit below the leader’s own time.

Trait Implementations

impl Clone for BenchConfig

fn clone(&self) -> BenchConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BenchConfig

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

Formats the value using the given formatter.

impl Default for BenchConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BenchConfig

where BenchConfig: 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 BenchConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.