Struct CalibrationKnob 

pub struct CalibrationKnob {
    pub path: String,
    pub current: KnobValue,
    pub bounds: KnobBounds,
    pub max_step: f64,
}

One tunable engine parameter.

Fields

path: String

Config-tree path the knob writes (e.g. "fraud.fraud_rate"). Must match the path the orchestrator’s config-patcher understands — same format as crate::enhancement::ConfigPatch::path.

current: KnobValue

Current value.

bounds: KnobBounds

Allowable bounds.

max_step: f64

Maximum step size (numeric magnitude) the loop may propose per iteration. Patches with |Δ| > max_step are clipped to ±max_step. Use this to prevent the optimizer from making a giant jump on a single noisy gradient.

Implementations

impl CalibrationKnob

pub fn new_f64( path: impl Into<String>, current: f64, min: f64, max: f64, max_step: f64, ) -> Self

Convenience constructor for an f64 knob.

pub fn new_usize( path: impl Into<String>, current: usize, min: usize, max: usize, max_step: f64, ) -> Self

Convenience constructor for a usize knob.

pub fn clip(&self, proposed: KnobValue) -> (KnobValue, KnobClipResult)

Clip proposed to the knob’s bounds AND step budget. Returns the final value + a KnobClipResult describing whether any clipping happened. Does NOT mutate self.

pub fn apply(&mut self, proposed: KnobValue) -> KnobClipResult

Apply a clipped value to the knob (mutates self.current). Returns the same KnobClipResult Self::clip returns.

Trait Implementations

impl Clone for CalibrationKnob

fn clone(&self) -> CalibrationKnob

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CalibrationKnob

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

Formats the value using the given formatter.