Struct SparseVector 

pub struct SparseVector {
    pub values: HashMap<usize, f32>,
    pub dimensions: usize,
    pub metadata: Option<HashMap<String, String>>,
}

Sparse vector representation using a hash map for efficient storage

Fields

values: HashMap<usize, f32>

Non-zero values indexed by their position

dimensions: usize

Total dimensions of the vector

metadata: Option<HashMap<String, String>>

Optional metadata

Implementations

impl SparseVector

pub fn new( indices: Vec<usize>, values: Vec<f32>, dimensions: usize, ) -> Result<Self, VectorError>

Create a new sparse vector from indices and values

pub fn from_dense(dense: &Vector) -> Self

Create sparse vector from dense vector

pub fn to_dense(&self) -> Vector

Convert to dense vector

pub fn get(&self, index: usize) -> f32

Get value at index

pub fn set(&mut self, index: usize, value: f32) -> Result<(), VectorError>

Set value at index

pub fn nnz(&self) -> usize

Get number of non-zero elements

pub fn sparsity(&self) -> f32

Sparsity ratio (percentage of zero elements)

pub fn dot(&self, other: &SparseVector) -> Result<f32, VectorError>

Dot product with another sparse vector

pub fn cosine_similarity( &self, other: &SparseVector, ) -> Result<f32, VectorError>

Compute cosine similarity with another sparse vector

pub fn l2_norm(&self) -> f32

Compute L2 norm

pub fn l1_norm(&self) -> f32

Compute L1 norm

pub fn add(&self, other: &SparseVector) -> Result<SparseVector, VectorError>

Add another sparse vector

pub fn subtract( &self, other: &SparseVector, ) -> Result<SparseVector, VectorError>

Subtract another sparse vector

pub fn scale(&self, scalar: f32) -> SparseVector

Scale by scalar

pub fn normalize(&self) -> SparseVector

Normalize to unit length

Trait Implementations

impl Clone for SparseVector

fn clone(&self) -> SparseVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SparseVector

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SparseVector

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SparseVector

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

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 SparseVector