Struct Confidence 

pub struct Confidence(/* private fields */);

A confidence score guaranteed to be in the range [0.0, 1.0].

This is a “witness type” - its existence proves the value is valid. Once you have a Confidence, you never need to check bounds again.

Construction

• Confidence::new: Returns None if out of range (strict parsing)
• Confidence::saturating: Clamps to [0, 1] (lenient, never fails)
• Confidence::try_from: Returns Err if out of range

Zero-Cost Abstraction

Confidence is #[repr(transparent)], meaning it has the exact same memory layout as f64. There is no runtime overhead.

Example

use anno::types::Confidence;

// Strict: fail on invalid input
assert!(Confidence::new(0.5).is_some());
assert!(Confidence::new(1.5).is_none());

// Lenient: clamp to valid range
let conf = Confidence::saturating(1.5);
assert_eq!(conf.get(), 1.0);

// Use with Entity - convert to f64 with .get()
use anno::{Entity, EntityType};
let entity = Entity::new("test", EntityType::Person, 0, 4, conf.get());

Implementations

impl Confidence

pub const MIN: Confidence

The minimum valid confidence value.

pub const MAX: Confidence

The maximum valid confidence value.

pub const CERTAIN: Confidence

A “perfect” confidence of 1.0 (deterministic/regex-based extraction).

pub const UNCERTAIN: Confidence

A “no information” confidence of 0.5 (maximum entropy).

pub fn new(value: f64) -> Option<Confidence>

Create a confidence score, returning None if out of range.

Use this when invalid values should be handled explicitly.

pub fn saturating(value: f64) -> Confidence

Create a confidence score, clamping to [0.0, 1.0].

Use this when you want lenient handling of out-of-range values. NaN is treated as 0.0.

pub fn from_percent(percent: f64) -> Option<Confidence>

Create a confidence score from a percentage (0-100).

pub const fn get(self) -> f64

Get the inner value (guaranteed to be in [0.0, 1.0]).

pub fn as_percent(self) -> f64

Convert to percentage (0-100).

pub fn is_high(self) -> bool

Check if this is “high confidence” (>= 0.9).

pub fn is_low(self) -> bool

Check if this is “low confidence” (< 0.5).

pub fn lerp(self, other: Confidence, t: f64) -> Confidence

Linear interpolation between two confidence values.

t = 0.0 returns self, t = 1.0 returns other.

pub fn combine(self, other: Confidence) -> Confidence

Combine two confidence scores (geometric mean).

Geometric mean penalizes low scores more than arithmetic mean, which is appropriate for independent confidence estimates.

Trait Implementations

impl Clone for Confidence

fn clone(&self) -> Confidence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Confidence

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

Formats the value using the given formatter.

impl Default for Confidence

fn default() -> Confidence

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Confidence

fn deserialize<__D>( __deserializer: __D, ) -> Result<Confidence, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Confidence

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

Formats the value using the given formatter.

impl From<Score> for Confidence

fn from(score: Score) -> Confidence

Converts to this type from the input type.

impl PartialEq<f64> for Confidence

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for Confidence

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<f64> for Confidence

fn partial_cmp(&self, other: &f64) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd for Confidence

fn partial_cmp(&self, other: &Confidence) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Confidence

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<f64> for Confidence

type Error = ConfidenceError

The type returned in the event of a conversion error.

fn try_from( value: f64, ) -> Result<Confidence, <Confidence as TryFrom<f64>>::Error>

Performs the conversion.

impl Copy for Confidence

impl StructuralPartialEq for Confidence