Crate embeddenator_vsa 

Embeddenator VSA - Vector Symbolic Architecture Core

This crate provides the foundational Vector Symbolic Architecture (VSA) operations for sparse ternary representations used in Embeddenator.

Overview

VSA is a computational framework for representing and manipulating high-dimensional vectors through algebraic operations:

• Bundle (⊕): Superposition of multiple vectors
• Bind (⊙): Compositional binding of associations
• Similarity: Cosine similarity for pattern retrieval

Core Types

• SparseVec: Sparse ternary vector representation
• PackedTritVec: Memory-efficient packed trit storage
• Codebook: Mapping between symbols and vectors

Example

use embeddenator_vsa::{SparseVec, ReversibleVSAConfig};

// Create random sparse vectors
let a = SparseVec::random();
let b = SparseVec::random();

// Bundle operation (superposition)
let bundled = a.bundle(&b);

// Compute similarity
let similarity = a.cosine(&b);
assert!(similarity >= -1.0 && similarity <= 1.0);

Re-exports

pub use codebook::BalancedTernaryWord;

pub use codebook::Codebook;

pub use codebook::ProjectionConfig;

pub use codebook::ProjectionResult;

pub use codebook::SemanticOutlier;

pub use codebook::WordMetadata;

pub use dimensional::DifferentialEncoder;

pub use dimensional::DifferentialEncoding;

pub use dimensional::DimensionalConfig;

pub use dimensional::HyperVec;

pub use dimensional::Trit as DimTrit;

pub use dimensional::TritDepthConfig;

pub use dimensional::Tryte;

pub use simd_cosine::cosine_scalar;

pub use ternary::CorrectionEntry;

pub use ternary::ParityTrit;

pub use ternary::Trit;

pub use ternary::Tryte3;

pub use ternary::Word6;

pub use ternary_vec::PackedTritVec;

pub use vsa::ReversibleVSAConfig;

pub use vsa::SparseVec;

pub use vsa::SparsityScaling;

pub use vsa::VsaConfig;

pub use vsa::VsaConfigSchema;

pub use vsa::DIM;

Modules

codebook

Codebook - Differential Encoding Base Model

dimensional

Dimensional Configuration - Variable Precision Hyperdimensional Substrate

simd_cosine

SIMD-accelerated cosine similarity for sparse ternary vectors

ternary

Foundational Balanced Ternary Primitives

ternary_vec

Packed ternary vector representation.

vsa

Vector Symbolic Architecture (VSA) Implementation

Enums

VsaError

Unified error type for VSA operations