Struct HyperVec 

pub struct HyperVec {
    pub config: DimensionalConfig,
    pub dimensions: BTreeMap<usize, Tryte>,
}

A hyperdimensional vector with configurable dimensional depth

Fields

config: DimensionalConfig

Configuration for this vector

dimensions: BTreeMap<usize, Tryte>

Sparse storage: dimension index -> tryte value Only non-zero dimensions are stored

Implementations

impl HyperVec

pub fn new(config: DimensionalConfig) -> Self

Create a new zero vector

pub fn from_dense(config: DimensionalConfig, values: &[i64]) -> Self

Create from dense representation

pub fn get(&self, dim: usize) -> i64

Get value at dimension (returns 0 for unset dimensions)

pub fn set(&mut self, dim: usize, value: i64)

Set value at dimension

pub fn nnz(&self) -> usize

Number of non-zero dimensions (sparsity count)

pub fn sparsity(&self) -> f64

Current sparsity ratio

pub fn bundle(&self, other: &HyperVec) -> HyperVec

Bundle operation (⊕): Superposition via majority voting

Algebraic properties:

• Associative: (A ⊕ B) ⊕ C = A ⊕ (B ⊕ C)
• Commutative: A ⊕ B = B ⊕ A
• Preserves similarity to inputs

pub fn bind(&self, other: &HyperVec) -> HyperVec

Bind operation (⊙): Composition via trit-wise multiplication

Algebraic properties:

• Self-inverse: A ⊙ A ≈ I (identity, up to sparsity)
• Distributes over bundle: A ⊙ (B ⊕ C) = (A ⊙ B) ⊕ (A ⊙ C)
• Creates quasi-orthogonal result

pub fn permute(&self, shift: usize) -> HyperVec

Permute operation (ρ): Cyclic index shift for sequence encoding

Algebraic properties:

• ρ^n(A) cycles through orthogonal representations
• Preserves sparsity and magnitude
• Enables positional encoding

pub fn inverse_permute(&self, shift: usize) -> HyperVec

Inverse permute (ρ⁻¹): Reverse cyclic shift

pub fn cosine(&self, other: &HyperVec) -> f64

Cosine similarity: Normalized dot product

Returns value in [-1, 1]:

• 1.0: Identical vectors
• 0.0: Orthogonal vectors
• -1.0: Opposite vectors

pub fn thin(&self, target_nnz: usize) -> HyperVec

Thin to target sparsity (Context-Dependent Thinning)

Reduces vector density while preserving signal structure

pub fn expand_precision(&mut self, dim: usize, new_depth: u8)

Expand precision at specific dimension (adaptive depth)

pub fn pack(&self) -> Vec<u8>

Pack to bytes for storage/transmission

pub fn unpack(config: DimensionalConfig, bytes: &[u8]) -> Option<Self>

Unpack from bytes

Trait Implementations

impl Clone for HyperVec

fn clone(&self) -> HyperVec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HyperVec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HyperVec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HyperVec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.