Struct ReversibleVSAEncoder 

pub struct ReversibleVSAEncoder { /* private fields */ }

Reversible encoder using position-aware VSA binding

Implementations

impl ReversibleVSAEncoder

pub fn new() -> Self

Create a new reversible encoder

pub fn with_dim(dim: usize) -> Self

Create a new reversible encoder with custom dimensionality

pub fn encode(&mut self, data: &[u8]) -> SparseVec

Encode data into a holographic representation

Returns a single SparseVec that contains all the data holographically.

pub fn encode_chunked( &mut self, data: &[u8], chunk_size: usize, ) -> Vec<SparseVec>

Encode data in chunks for better accuracy with large files

Returns a vector of SparseVecs, one per chunk.

Panics

Panics if chunk_size is 0.

pub fn decode(&self, encoded: &SparseVec, length: usize) -> Vec<u8>

Decode data from a holographic representation

Uses bind + similarity search to retrieve each byte.

pub fn decode_chunked( &self, chunks: &[SparseVec], chunk_size: usize, total_length: usize, ) -> Vec<u8>

Decode chunked data

Panics

Panics if chunk_size is 0.

pub fn get_byte_vectors(&self) -> &[SparseVec]

Get reference to byte vectors (for GPU acceleration)

Returns slice of 256 basis vectors, one per byte value.

pub fn get_position_vector_ref(&self, pos: usize) -> &SparseVec

Get position vector for a given position (for GPU acceleration)

Returns reference to position basis vector. Uses modulo if position exceeds pre-allocated vectors.

Note: Call ensure_positions(max_pos) first if you need exact position vectors without modulo wrapping.

pub fn ensure_positions(&mut self, max_pos: usize)

Ensure position vectors exist up to (and including) the given position

Panics

Panics if max_pos >= MAX_POSITIONS (65536).

Example

let mut encoder = ReversibleVSAEncoder::new();
encoder.ensure_positions(1000); // OK
// encoder.ensure_positions(100000); // Would panic

pub fn try_ensure_positions(&mut self, max_pos: usize) -> Result<(), String>

Ensure position vectors exist up to the given position, returning error on invalid input

This is a non-panicking alternative to ensure_positions.

Returns

Returns Ok(()) if positions are allocated successfully, or Err if max_pos >= MAX_POSITIONS.

pub fn test_accuracy(&mut self, data: &[u8]) -> f64

Compute reconstruction accuracy (for testing)

pub fn test_accuracy_chunked(&mut self, data: &[u8], chunk_size: usize) -> f64

Compute chunked reconstruction accuracy

Trait Implementations

impl Default for ReversibleVSAEncoder

fn default() -> Self

Returns the “default value” for a type.