Struct WaveletCompression 

pub struct WaveletCompression {
    pub original_length: usize,
    pub nonzero_count: usize,
    pub sparse_indices: Vec<usize>,
    pub sparse_values: Vec<f64>,
    pub threshold: f64,
}

Wavelet-based signal compression using coefficient thresholding.

Implements sparse representation, zero-tree coding concept, and compression ratio estimation.

Fields

original_length: usize

Original signal length.

nonzero_count: usize

Number of non-zero coefficients after compression.

sparse_indices: Vec<usize>

Compressed coefficient vector (zero-tree encoded as sparse indices+values).

sparse_values: Vec<f64>

Coefficient values at sparse indices.

threshold: f64

Threshold used for compression.

Implementations

impl WaveletCompression

pub fn compress(signal: &[f64], retain_fraction: f64) -> Self

Compress a signal by retaining only DWT coefficients above retain_fraction.

retain_fraction is the fraction of energy to preserve (e.g., 0.99 retains 99% of signal energy).

pub fn decompress(&self) -> Vec<f64>

Reconstruct signal from compressed sparse representation.

Fills a full coefficient vector from the sparse representation and applies the inverse DWT.

pub fn compression_ratio(&self) -> f64

Compute compression ratio = original_length / nonzero_count.

Returns 1.0 if no compression occurred.

pub fn reconstruction_error(&self, original: &[f64]) -> f64

Compute the root-mean-square error between original and reconstructed signal.

pub fn psnr(&self, original: &[f64]) -> f64

Compute the peak signal-to-noise ratio (PSNR) in dB.

Uses the formula PSNR = 20 log10(max_val / RMSE).

Trait Implementations

impl Clone for WaveletCompression

fn clone(&self) -> WaveletCompression

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WaveletCompression

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

Formats the value using the given formatter.