Struct StackPolicy 

pub struct StackPolicy {

    pub mode: Mode,
    pub timing: Timing,
    pub require_validation: bool,
    pub tolerance: Tolerance,
    pub warmups: usize,
    pub samples: usize,
    pub max_candidates: usize,
    pub budget: Duration,
    pub min_speedup: f64,
    pub max_relative_mad: f64,
    pub workspace_limit: Option<u64>,
    pub capacity: usize,
    pub max_parallel_tunes: usize,
    pub ttl: Duration,
    pub regression_pairs: usize,
    pub regression_ratio: f64,
}

Immutable limits shared by operator, graph and application selection. Defaults are selection rules, not measured performance guarantees.

Fields

mode: Mode

Explore, cache-only or reference-only operation; defaults to Explore.

timing: Timing

Completed timing scope; defaults to EndToEnd.

require_validation: bool

Require numerical validation before promoting a choice; defaults to true.

tolerance: Tolerance

Numerical limits and combined reference/candidate readback quota.

warmups: usize

Positive warmup count in 1..=100; default 2.

samples: usize

Odd sample count. Each non-reference sample is paired with a fresh reference measurement.

max_candidates: usize

Positive candidate trial limit up to 4096; default 32.

budget: Duration

A soft deadline checked BETWEEN completed trials; running kernels are never interrupted.

min_speedup: f64

Required reciprocal median timing ratio for promotion; finite and at least 1. Default 1.05 is a threshold, not an observed speedup.

max_relative_mad: f64

Maximum median absolute deviation of paired ratios divided by their median.

workspace_limit: Option<u64>

Optional candidate scratch-byte ceiling. Unknown estimates do not fit an enabled limit, including for the declared reference. Default None.

capacity: usize

Maximum retained keys in 1..=65536; default 1024.

max_parallel_tunes: usize

Maximum simultaneous trials in 1..=256; default 1, also per-device serialized.

ttl: Duration

Nonzero cache lifetime; default seven days. Future-dated entries expire.

regression_pairs: usize

Odd nonzero regression window in 3..=101; default 7.

regression_ratio: f64

Median selected/reference threshold above 1; default 1.15.

Implementations

impl StackPolicy

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

Reject invalid counts, bounds, nonfinite numerical limits or zero durations. Returns FailureKind::InvalidInput without starting a trial or touching disk.

pub fn accuracy_key(&self) -> String

Mode is intentionally excluded: an offline Explore cache is usable by CacheOnly.

Trait Implementations

impl Clone for StackPolicy

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 StackPolicy

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

Formats the value using the given formatter.

impl Default for StackPolicy

fn default() -> Self

Returns the “default value” for a type.