Struct ConservationMetrics 

pub struct ConservationMetrics {
    pub magnitude: f32,
    pub energy: f32,
    pub information: f32,
}

Conservation metrics for a set of embeddings with attention weights.

Fields

magnitude: f32

Total weighted magnitude: Σᵢ aᵢ ‖eᵢ‖

energy: f32

Attention energy: ½Σᵢⱼ aᵢaⱼ cos(eᵢ, eⱼ)

information: f32

Shannon entropy: -Σᵢ aᵢ log(aᵢ)

Implementations

impl ConservationMetrics

pub fn compute(embeddings: &[&[f32]], attention: &[f32]) -> Self

Compute conservation metrics for a set of embeddings and attention weights.

Arguments

• embeddings - Slice of embedding slices
• attention - Attention weights for each embedding (must sum to 1)

Returns

ConservationMetrics with magnitude, energy, and information.

pub fn from_vecs(embeddings: &[Vec<f32>], attention: &[f32]) -> Self

Compute metrics from owned vectors.

pub fn is_conserved(&self, other: &Self, tolerance: f32) -> bool

Check if conservation is preserved within tolerance.

Arguments

• other - Metrics after an operation
• tolerance - Maximum allowed difference

Returns

True if magnitude and energy are conserved within tolerance.

pub fn is_fully_conserved(&self, other: &Self, tolerance: f32) -> bool

Check if all three metrics are conserved.

pub fn violation(&self, other: &Self) -> ConservationViolation

Compute the conservation violation (distance from conservation).

pub fn uniform(embeddings: &[&[f32]]) -> Self

Create metrics for a uniform attention distribution.

pub fn max_entropy(n: usize) -> f32

Maximum possible entropy for n items.

pub fn normalized_entropy(&self, n: usize) -> f32

Normalized entropy (0 = concentrated, 1 = uniform).

Trait Implementations

impl Clone for ConservationMetrics

fn clone(&self) -> ConservationMetrics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConservationMetrics

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

Formats the value using the given formatter.

impl Default for ConservationMetrics

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for ConservationMetrics

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

impl StructuralPartialEq for ConservationMetrics