Struct DiVector 

pub struct DiVector { /* private fields */ }

Two-sided per-dimension attribution accumulator.

Implementations

impl DiVector

pub fn zeros(dim: usize) -> Self

Build a zeroed DiVector with dim dimensions.

Examples

use anomstream_core::domain::DiVector;
let v = DiVector::zeros(4);
assert_eq!(v.dim(), 4);
assert_eq!(v.total(), 0.0);

pub fn from_arrays(high: Vec<f64>, low: Vec<f64>) -> RcfResult<Self>

Build a DiVector from explicit high / low vectors. Useful for tests and downstream code that wants to pipe a ready-made attribution back into a triage helper (e.g. anomstream_triage::AlertClusterer).

Errors

Returns RcfError::DimensionMismatch when high.len() != low.len().

pub fn dim(&self) -> usize

Dimensionality.

pub fn high(&self) -> &[f64]

Read-only view of the upper-side contributions.

pub fn low(&self) -> &[f64]

Read-only view of the lower-side contributions.

pub fn total(&self) -> f64

Sum of all high[d] and low[d] entries.

pub fn per_dim_total(&self, d: usize) -> f64

Per-dimension total: high[d] + low[d].

Panics

Panics when d >= self.dim() — call sites size-check first.

pub fn argmax(&self) -> Option<usize>

Index of the dimension with the largest high[d] + low[d]. Returns None for an empty vector.

pub fn add_high(&mut self, d: usize, value: f64) -> RcfResult<()>

Add value to the upper-side contribution for dimension d.

Errors

Returns RcfError::OutOfBounds when d >= self.dim().

pub fn add_low(&mut self, d: usize, value: f64) -> RcfResult<()>

Add value to the lower-side contribution for dimension d.

Errors

Returns RcfError::OutOfBounds when d >= self.dim().

pub fn accumulate(&mut self, other: &Self) -> RcfResult<()>

Element-wise add other into self.

Errors

Returns RcfError::DimensionMismatch when dimensions differ.

pub fn scale(&mut self, divisor: f64) -> RcfResult<()>

Divide every component by divisor in place. Used by the forest layer to convert a sum of per-tree attributions into a mean.

Errors

Returns RcfError::InvalidConfig when divisor is zero or non-finite.

Trait Implementations

impl Clone for DiVector

fn clone(&self) -> DiVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiVector

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DiVector

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DiVector

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DiVector