Struct SparseEmbed 

pub struct SparseEmbed {
    pub indices: Vec<u32>,
    pub values: Vec<f32>,
    pub vocab_id: String,
}

A sparse embedding over a fixed vocabulary.

indices MUST be strictly ascending; values MUST have the same length as indices. Both invariants are checked by Self::new and enforced on deserialise in a future CBOR round-trip test. vocab_id pins the model family so two adapters with different vocabs never fuse posting lists; compare as a string (e.g. "bert-base-uncased@30522").

Fields

indices: Vec<u32>

Token IDs in the vocabulary, strictly ascending.

values: Vec<f32>

Non-zero weights, aligned with indices.

vocab_id: String

Vocabulary identifier.

Implementations

impl SparseEmbed

pub fn new( indices: Vec<u32>, values: Vec<f32>, vocab_id: impl Into<String>, ) -> Result<Self, SparseError>

Construct a SparseEmbed. Panics (debug) / errors (release) if the invariants are violated. indices is taken as-is; if the caller is unsure whether it is sorted, use Self::from_unsorted instead.

Errors

• SparseError::Config if indices.len() != values.len() or indices contains duplicates / non-ascending entries.

pub fn from_unsorted( pairs: impl IntoIterator<Item = (u32, f32)>, vocab_id: impl Into<String>, ) -> Self

Construct from an unsorted (index, value) pair list. Duplicate indices are kept as the maximum value (SPLADE’s own pooling rule). Useful from ONNX-side decoders that produce vectors in token-emission order.

pub const fn nnz(&self) -> usize

Number of non-zero entries.

pub fn dot(&self, other: &Self) -> Option<f32>

Dot product with another sparse embedding (must share vocab_id). Returns None if the vocab_ids differ.

Trait Implementations

impl Clone for SparseEmbed

fn clone(&self) -> SparseEmbed

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SparseEmbed

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SparseEmbed

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SparseEmbed

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

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 SparseEmbed