Struct SparseFactor 

pub struct SparseFactor {
    pub variables: Vec<String>,
    pub cardinalities: Vec<usize>,
    pub entries: Vec<(Vec<usize>, f64)>,
    pub default_value: f64,
}

Sparse factor representation using coordinate format.

Efficient for factors where most entries are zero or near-zero.

Fields

variables: Vec<String>

Variable names

cardinalities: Vec<usize>

Cardinalities for each variable

entries: Vec<(Vec<usize>, f64)>

Non-zero entries: (indices, value)

default_value: f64

Default value for entries not in sparse representation

Implementations

impl SparseFactor

pub fn new(variables: Vec<String>, cardinalities: Vec<usize>) -> Self

Create a new sparse factor.

pub fn from_dense(factor: &Factor, threshold: f64) -> Self

Create from a dense factor with sparsity threshold.

Values below threshold are treated as zero.

pub fn to_dense(&self) -> Result<Factor>

Convert to dense factor.

pub fn get(&self, indices: &[usize]) -> f64

Get value at indices.

pub fn set(&mut self, indices: Vec<usize>, value: f64)

Set value at indices.

pub fn sparsity(&self) -> f64

Get sparsity ratio (fraction of non-default entries).

pub fn memory_savings(&self) -> f64

Memory savings compared to dense representation.

Trait Implementations

impl Clone for SparseFactor

fn clone(&self) -> SparseFactor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SparseFactor

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

Formats the value using the given formatter.