Struct VsaOps 

pub struct VsaOps { /* private fields */ }

VSA operations handler.

Provides ternary VSA operations with automatic CPU/GPU dispatch.

Implementations

impl VsaOps

pub fn new(config: VsaConfig) -> VsaOps

Create new VSA operations handler.

pub fn random(&self, dim: usize, seed: u32) -> Result<PackedTritVec, VsaError>

Generate a random ternary vector.

Arguments

• dim - Vector dimension
• seed - Random seed for reproducibility

pub fn bind( &self, a: &PackedTritVec, b: &PackedTritVec, ) -> Result<PackedTritVec, VsaError>

Bind two ternary vectors (association).

Bind is the composition operation, creating associations between vectors. It is commutative and associative.

pub fn unbind( &self, bound: &PackedTritVec, key: &PackedTritVec, ) -> Result<PackedTritVec, VsaError>

Unbind two ternary vectors (inverse association).

If bound = bind(a, b), then unbind(bound, b) recovers a.

pub fn bundle( &self, vectors: &[PackedTritVec], ) -> Result<PackedTritVec, VsaError>

Bundle multiple vectors (superposition).

Combines vectors via majority voting at each dimension. The result is similar to all input vectors.

pub fn cosine_similarity( &self, a: &PackedTritVec, b: &PackedTritVec, ) -> Result<f32, VsaError>

Compute cosine similarity between two vectors.

Returns a value in [-1, 1].

pub fn dot(&self, a: &PackedTritVec, b: &PackedTritVec) -> Result<i32, VsaError>

Compute dot product between two vectors.

pub fn hamming_distance( &self, a: &PackedTritVec, b: &PackedTritVec, ) -> Result<usize, VsaError>

Compute Hamming distance between two vectors.

Returns the number of positions where the vectors differ.

pub fn from_i8(&self, values: &[i8]) -> Result<PackedTritVec, VsaError>

Convert i8 slice to PackedTritVec.

pub fn to_i8(&self, packed: &PackedTritVec) -> Vec<i8>

Convert PackedTritVec to i8 Vec.

Trait Implementations

impl Clone for VsaOps

fn clone(&self) -> VsaOps

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VsaOps

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

Formats the value using the given formatter.