Struct FeatureView 

pub struct FeatureView<'a> { /* private fields */ }

Named view over a flat feature vector.

Provides ergonomic access to features by name, scale, and channel without changing the underlying storage format.

let result = z.compute_all_features(&src, &dst)?;
let view = FeatureView::new(result.features(), 4)?;
let ssim_mean_s0_y = view.ssim_mean(0, 1);
let ssim_max_s2_x = view.ssim_max(0, 2).unwrap();

Implementations

impl<'a> FeatureView<'a>

pub fn new(features: &'a [f64], n_scales: usize) -> Option<Self>

Create a view over a feature vector.

Automatically detects the tier (peaks/extended) from length. Returns None if the length doesn’t match any valid layout. Peaks are always present (basic-only 156-element vectors are no longer generated).

pub fn n_scales(&self) -> usize

Number of scales in this feature vector.

pub fn has_peaks(&self) -> bool

Whether peak features (max/L8) are present.

pub fn has_masked(&self) -> bool

Whether masked features are present.

pub fn ssim_mean(&self, scale: usize, ch: usize) -> f64

SSIM error, mean pooling.

pub fn ssim_4th(&self, scale: usize, ch: usize) -> f64

SSIM error, L4 norm.

pub fn ssim_2nd(&self, scale: usize, ch: usize) -> f64

SSIM error, L2 norm.

pub fn art_mean(&self, scale: usize, ch: usize) -> f64

Edge artifact (ringing), mean pooling.

pub fn art_4th(&self, scale: usize, ch: usize) -> f64

Edge artifact, L4 norm.

pub fn art_2nd(&self, scale: usize, ch: usize) -> f64

Edge artifact, L2 norm.

pub fn det_mean(&self, scale: usize, ch: usize) -> f64

Edge detail lost (blur), mean pooling.

pub fn det_4th(&self, scale: usize, ch: usize) -> f64

Edge detail lost, L4 norm.

pub fn det_2nd(&self, scale: usize, ch: usize) -> f64

Edge detail lost, L2 norm.

pub fn mse(&self, scale: usize, ch: usize) -> f64

Mean squared error.

pub fn hf_energy_loss(&self, scale: usize, ch: usize) -> f64

High-frequency energy loss ratio.

pub fn hf_mag_loss(&self, scale: usize, ch: usize) -> f64

High-frequency magnitude loss ratio.

pub fn hf_energy_gain(&self, scale: usize, ch: usize) -> f64

High-frequency energy gain ratio.

pub fn ssim_max(&self, scale: usize, ch: usize) -> Option<f64>

SSIM error, pixel-wise max.

pub fn art_max(&self, scale: usize, ch: usize) -> Option<f64>

Edge artifact, pixel-wise max.

pub fn det_max(&self, scale: usize, ch: usize) -> Option<f64>

Edge detail lost, pixel-wise max.

pub fn ssim_l8(&self, scale: usize, ch: usize) -> Option<f64>

SSIM error, L8 norm (Σd⁸/N)^(1/8).

pub fn art_l8(&self, scale: usize, ch: usize) -> Option<f64>

Edge artifact, L8 norm.

pub fn det_l8(&self, scale: usize, ch: usize) -> Option<f64>

Edge detail lost, L8 norm.

pub fn masked_ssim_mean(&self, scale: usize, ch: usize) -> Option<f64>

Masked SSIM error, mean pooling.

pub fn masked_ssim_4th(&self, scale: usize, ch: usize) -> Option<f64>

Masked SSIM error, L4 norm.

pub fn masked_ssim_2nd(&self, scale: usize, ch: usize) -> Option<f64>

Masked SSIM error, L2 norm.

pub fn masked_art_4th(&self, scale: usize, ch: usize) -> Option<f64>

Masked edge artifact, L4 norm.

pub fn masked_det_4th(&self, scale: usize, ch: usize) -> Option<f64>

Masked edge detail lost, L4 norm.

pub fn masked_mse(&self, scale: usize, ch: usize) -> Option<f64>

Masked MSE.

pub fn scored_features(&self) -> &[f64]

Get the scored features slice (first N features, WEIGHTS-compatible).

pub fn peak_features(&self) -> Option<&[f64]>

Get the peak features slice, if present.

pub fn masked_features(&self) -> Option<&[f64]>

Get the masked features slice, if present.

Trait Implementations

impl<'a> Clone for FeatureView<'a>

fn clone(&self) -> FeatureView<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for FeatureView<'a>

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

Formats the value using the given formatter.