Struct GroundingProjector 

pub struct GroundingProjector { /* private fields */ }

Orthogonal grounding projector G = A(AᵀA)⁻¹Aᵀ.

Projects LLM output vectors onto the subspace spanned by evidence embeddings. The residual (I - G)x is the hallucination component.

Implementations

impl GroundingProjector

pub fn from_evidence(evidence: &[&[f32]], dim: usize) -> Option<Self>

Build a grounding projector from evidence embeddings.

evidence is a slice of embedding vectors, each of length dim. Returns None if evidence is empty or AᵀA is singular.

pub fn project_grounded(&self, x: &[f32]) -> Vec<f32>

Project vector onto evidence subspace (grounded component).

Returns G·x — the part of x supported by evidence.

pub fn project_hallucinated(&self, x: &[f32]) -> Vec<f32>

Project vector onto hallucination subspace.

Returns (I - G)·x — the part of x not supported by evidence.

pub fn hallucination_score(&self, x: &[f32]) -> f32

Compute hallucination score for a vector.

Returns ‖(I - G)·x‖ / ‖x‖ ∈ [0, 1]. 0 = fully grounded, 1 = fully hallucinated.

pub fn decompose(&self, x: &[f32]) -> GroundingDecomposition

Decompose a vector into grounded and hallucinated components with scores.

pub fn dim(&self) -> usize

Dimension of the embedding space.

pub fn rank(&self) -> usize

Rank of the evidence subspace.

pub fn verify_idempotent(&self, tolerance: f32) -> bool

Verify G² ≈ G (idempotent — defining property of projection).

pub fn verify_symmetric(&self, tolerance: f32) -> bool

Verify Gᵀ = G (symmetric — orthogonal projection).

Trait Implementations

impl Clone for GroundingProjector

fn clone(&self) -> GroundingProjector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GroundingProjector

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

Formats the value using the given formatter.