Struct Selection 

pub struct Selection<T> {
    pub item: T,
    pub score: f64,
    pub precision: f64,
    pub index: usize,
    pub considered: usize,
    pub passed: usize,
    pub reason: Option<String>,
}

A selection result from an objective function

Fields

item: T

The selected item

score: f64

Score of the selection

precision: f64

Precision (inverse variance) of the score estimate. Default 1.0 (fully trusted).

The effective ranking score is score * precision. When precision is 1.0 (the default), ranking is identical to raw score ordering (ADR-059).

index: usize

Index in the original candidates

considered: usize

Number of candidates considered

passed: usize

Number of candidates that passed threshold

reason: Option<String>

Reason for selection

Implementations

impl<T> Selection<T>

pub fn new(item: T, score: f64, index: usize) -> Self

Create a new selection

pub fn with_precision(self, precision: f64) -> Self

Set the precision (reliability estimate for the score).

Values in (0, 1] are typical; 1.0 means fully trusted (the default).

pub fn with_considered(self, n: usize) -> Self

Set the considered count

pub fn with_passed(self, n: usize) -> Self

Set the passed count

pub fn with_reason(self, reason: impl Into<String>) -> Self

Set the reason

pub fn map<U, F: FnOnce(T) -> U>(self, f: F) -> Selection<U>

Map the selected value

Trait Implementations

impl<T: Clone> Clone for Selection<T>

fn clone(&self) -> Selection<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Selection<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Selection<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for Selection<T>

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.