Struct RankingModel 

pub struct RankingModel<T: Clone + Debug + Eq + Hash + Display + Send + Sync + 'static> {
    pub data: ComparisonMatrix<T>,
    pub scores: Option<HashMap<T, f64>>,
    /* private fields */
}

Main ASAP ranking model for inferring scores from pairwise comparisons

Fields

data: ComparisonMatrix<T>

scores: Option<HashMap<T, f64>>

Implementations

impl<T: Clone + Debug + Eq + Hash + Display + Send + Sync + 'static> RankingModel<T>

pub fn new(items: &[T]) -> Self

Create a new RankingModel with the given items

pub fn new_with_options( items: &[T], approximate: bool, selective_eig: bool, ) -> Self

Create a new RankingModel with custom options

pub fn add_comparison( &mut self, comparison: Comparison<T>, ) -> Result<(), AsapError<T>>

Add a pairwise comparison result

pub fn add_item(&mut self, item: T) -> Result<(), AsapError<T>>

pub fn remove_item(&mut self, item: &T) -> Result<(), AsapError<T>>

pub fn get_ordering(&mut self) -> Result<Vec<T>, AsapError<T>>

Get the items ordered by their inferred scores (highest to lowest)

pub fn get_scores(&mut self) -> Result<HashMap<T, f64>, AsapError<T>>

Get the inferred scores for all items

pub fn suggest_comparisons( &self, max: usize, ) -> Result<Vec<(T, T)>, AsapError<T>>

Suggest the most informative comparisons to perform next

pub fn ranking_confidence(&self) -> Result<f64, AsapError<T>>

Confidence metric calibrated for Bradley-Terry MLE.

Measures two things:

1. Coverage (50% weight): fraction of items with >= MIN_COMPARISONS_PER_ITEM comparisons. BT needs ~5-10 per item, not N² total.
2. Discrimination (50% weight): whether scores are spread out enough to distinguish items. Uses coefficient of variation of the BT strengths.

pub fn is_sufficiently_confident( &self, threshold: f64, ) -> Result<bool, AsapError<T>>

Check if the current ranking has sufficient confidence (threshold: 0.0 to 1.0)

impl<T: Clone + Debug + Eq + Hash + Display + Send + Sync + 'static + Serialize + DeserializeOwned> RankingModel<T>

pub fn to_json(&self) -> Result<String, AsapError<T>>

pub fn from_json(json: &str) -> Result<Self, AsapError<T>>

pub fn save_to_file(&self, path: &str) -> Result<(), AsapError<T>>

pub fn load_from_file(path: &str) -> Result<Self, AsapError<T>>

Trait Implementations

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

where T: Clone + Debug + Eq + Hash + Display + Send + Sync + 'static + DeserializeOwned,

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 RankingModel<T>

where T: Clone + Debug + Eq + Hash + Display + Send + Sync + 'static + Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.