Struct EncodeQualityMetrics 

pub struct EncodeQualityMetrics {
    pub n_rows: usize,
    pub certified_rows: usize,
    pub fallback_rate: f64,
    pub support_agreement: f64,
    pub max_coord_abs_err: f64,
    pub max_reconstruction_abs_err: f64,
    pub reconstruction_ev: f64,
}

Correctness of an encode result, measured against the production CPU encode (a per-row reference) and the reconstruction it implies.

Every field is a quantity a “batched exact per-row encode” claim has to stand on: it must AGREE with the production per-row encode (support + coordinates), it must RECONSTRUCT the targets (explained variance), and it must be honest about how many rows it could not certify (fallback rate).

Fields

n_rows: usize

Rows compared.

certified_rows: usize

Rows the encode-under-test certified (h ≤ ½, exact-into-the-ball).

fallback_rate: f64

Fraction of rows the encode-under-test could NOT certify and flagged for the multi-start fallback (1 - certified_rows/n_rows). This is the “fallback rate”.

support_agreement: f64

Fraction of rows whose certificate flag AGREES with the per-row reference encode. For a correct batched encode this is 1.0 (the batch is just the per-row encode fanned out).

max_coord_abs_err: f64

Largest absolute latent-coordinate difference between the encode-under-test and the per-row reference encode, over all rows and coordinate dims. A correct batched encode matches the per-row encode to round-off (≈ 0).

max_reconstruction_abs_err: f64

Largest absolute element-wise reconstruction residual |x̂ − x| over the whole batch (the “amplitude”/reconstruction error in raw output units).

reconstruction_ev: f64

Reconstruction explained variance 1 − ‖X − X̂‖²_F / ‖X − X̄‖²_F, with each output column centered by its own mean X̄. 1.0 is a perfect on-manifold reconstruction; 0.0 is no better than the per-column mean.

Trait Implementations

impl Clone for EncodeQualityMetrics

fn clone(&self) -> EncodeQualityMetrics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EncodeQualityMetrics

impl Debug for EncodeQualityMetrics

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

Formats the value using the given formatter.