Struct SpectralEncoder 

pub struct SpectralEncoder { /* private fields */ }

Spectral holographic encoder using DCT.

Encodes 2D tensor data into holographic fragments using DCT (Discrete Cosine Transform). Produces “SV03” format fragments that can be progressively decoded.

Features

• DCT-based frequency domain encoding
• Configurable fragment count for progressive reconstruction
• Essential coefficient ratio for quality control

Implementations

impl SpectralEncoder

pub fn new(num_fragments: u16) -> Self

Create encoder with specified number of fragments.

pub fn with_essential_ratio(self, ratio: f32) -> Self

Set the ratio of coefficients considered essential (replicated in all fragments).

pub fn encode_2d( &self, data: &[f32], width: usize, height: usize, ) -> Result<Vec<HoloFragment>>

Encode 2D tensor to holographic fragments (V3 format).

V3 format stores DCT coefficients in raster order with NO indices:

• Fragment k: coefficients at positions k, k+F, k+2F, … in raster order
• DC coefficient (position 0) goes to fragment 0 (most important)
• Total size: N×4 bytes (same as original, compresses well with Zstd)

Magic: 0x53563033 (“SV03”) identifies V3 format.

pub fn encode_1d(&self, data: &[f32]) -> Result<Vec<HoloFragment>>

Encode 1D tensor.