Struct Consensus 

pub struct Consensus {
    pub votes: Vec<Option<usize>>,
    pub modal_step: Option<usize>,
    pub support: usize,
}

What N references agree on about one suspect run.

Two absences are distinct and both are honest: references == 0 (nothing was asked) and every reference converging (asked, and the suspect looks normal to all of them) both leave Consensus::modal_step as None. Consensus::references tells them apart.

Fields

votes: Vec<Option<usize>>

One entry per reference, in input order: the suspect-side step that reference localized the fork to (amberfork_model::DiffResult::fork_step_observed), or None where that reference converged with the suspect.

Kept per-reference rather than pre-summed so a caller can see the shape of the disagreement — a 6/4 split at adjacent steps and a 6/4 split at opposite ends of the run are very different situations that one modal number hides.

modal_step: Option<usize>

The step the plurality of forking references named, or None when none forked.

support: usize

How many references voted for Consensus::modal_step. 0 exactly when it is None.

Implementations

impl Consensus

pub fn references(&self) -> usize

How many references were consulted.

pub fn forked(&self) -> usize

How many references forked at all. The denominator that makes support a rate: references that converged never voted, so counting them against the modal step would understate agreement among the ones that actually saw a divergence.

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

Share of forking references backing the modal step, in [0, 1]; None when no reference forked (a rate with a zero denominator is not zero, it is undefined).

Trait Implementations

impl Clone for Consensus

fn clone(&self) -> Consensus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Consensus

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

Formats the value using the given formatter.

impl Eq for Consensus

impl PartialEq for Consensus

fn eq(&self, other: &Consensus) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Consensus