Struct BanditParameter 

pub struct BanditParameter {
    pub name: String,
    /* private fields */
}

A single tunable parameter, discretized into arms and tuned by Thompson sampling over each arm’s Beta posterior.

Fields

name: String

Human-readable parameter name (e.g. "mutation_rate").

Implementations

impl BanditParameter

pub fn new(name: impl Into<String>, values: Vec<f64>) -> Self

Create a parameter with the given candidate values and a uniform prior.

pub fn with_prior( name: impl Into<String>, values: Vec<f64>, prior: BetaPosterior, ) -> Self

Create a parameter with the given candidate values and a shared Beta prior.

pub fn select<R: Rng>(&mut self, rng: &mut R) -> f64

Thompson-sample an arm and return its parameter value.

Draws one probability from each arm’s Beta posterior and selects the arm with the highest draw. The draw is used only to choose the arm; the returned value is the arm’s concrete parameter value.

pub fn observe(&mut self, improved: bool)

Credit the most recently selected arm with an improvement outcome.

pub fn arms(&self) -> &[BanditArm]

The arms of this parameter.

pub fn values(&self) -> Vec<f64>

Candidate values, in arm order.

pub fn posterior_means(&self) -> Vec<f64>

Posterior mean of P(improvement) for each arm, in arm order.

pub fn selection_counts(&self) -> Vec<u64>

Selection (pull) count for each arm, in arm order.

pub fn selected_value(&self) -> Option<f64>

Value chosen at the most recent select, if any.

pub fn selected_index(&self) -> Option<usize>

Arm index chosen at the most recent select, if any.

pub fn best_index(&self) -> usize

Index of the arm with the highest posterior mean of P(improvement).

pub fn best_value(&self) -> f64

Value of the arm with the highest posterior mean of P(improvement).

pub fn total_observations(&self) -> f64

Total number of improvement events credited across all arms.

Trait Implementations

impl Clone for BanditParameter

fn clone(&self) -> BanditParameter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BanditParameter

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

Formats the value using the given formatter.