Struct UncertainBox 

pub struct UncertainBox {
    pub box_embedding: BoxEmbedding,
    pub source_trust: f32,
}

An uncertainty-aware box embedding (UKGE-style).

Based on UKGE (Chen et al., 2021), box volume represents confidence:

• Small box = high confidence (precise, trusted fact)
• Large box = low confidence (vague, uncertain, or dubious claim)

This enables conflict detection: if two high-confidence boxes are disjoint, they represent contradictory claims.

Example

use anno::backends::box_embeddings::{BoxEmbedding, UncertainBox};

// High-confidence claim: "Trump is in NY" (small, precise box)
let claim_a = UncertainBox::new(
    BoxEmbedding::new(vec![0.0, 0.0], vec![0.1, 0.1]), // Small = high confidence
    0.95, // Source trust
);

// Contradictory claim: "Trump is in FL" (also high confidence, but disjoint)
let claim_b = UncertainBox::new(
    BoxEmbedding::new(vec![5.0, 5.0], vec![5.1, 5.1]), // Disjoint from claim_a
    0.90,
);

// Should detect conflict
assert!(claim_a.detect_conflict(&claim_b).is_some());

Fields

box_embedding: BoxEmbedding

The underlying box embedding

source_trust: f32

Source trustworthiness (0.0-1.0)

Implementations

impl UncertainBox

pub fn new(box_embedding: BoxEmbedding, source_trust: f32) -> Self

Create a new uncertainty-aware box.

Confidence is derived from box volume (smaller = higher confidence).

pub fn confidence(&self) -> f32

Get confidence derived from box volume.

Smaller boxes = higher confidence. This is a heuristic: confidence ≈ 1.0 / (1.0 + volume)

pub fn detect_conflict(&self, other: &Self) -> Option<Conflict>

Detect conflict with another uncertain box.

Returns Some(Conflict) if both boxes are high-confidence but disjoint, indicating contradictory claims.

Trait Implementations

impl Clone for UncertainBox

fn clone(&self) -> UncertainBox

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UncertainBox

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

Formats the value using the given formatter.

impl PartialEq for UncertainBox

fn eq(&self, other: &UncertainBox) -> 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 StructuralPartialEq for UncertainBox