Struct FallbackTelemetry 

pub struct FallbackTelemetry {
    pub n_rows: usize,
    pub n_atoms: usize,
    pub amortized_certified: usize,
    pub newton_rescued: usize,
    pub multistart_fallback: usize,
}

The honest cost breakdown of the encode tax (reviewer condition #3). Every (row, atom) encode lands in exactly one of three tiers, in ascending cost:

1. amortized-certified — the one-mat-vec distilled predictor’s start already satisfies the Kantorovich h ≤ ½ certificate. Cheapest.
2. Newton-rescued — the amortized start is uncertified, but the certified IFT-warm-start Newton encode lands a certified root. Middling.
3. multi-start fallback — neither certifies, so the row rides the exact multi-start solve. This is the true cost MULTIPLIER at scale, and its fraction GROWS with atom similarity / co-activation interference (the per-row joint (t, a) landscape multiplies basins that no per-atom certificate covers). Reporting it is what keeps the encode-tax story honest — an SAE’s one-matmul encode has no analogue of this tail.

The tiers partition the (row, atom) grid: amortized_certified + newton_rescued + multistart_fallback == n_rows · n_atoms.

Fields

n_rows: usize

n_atoms: usize

amortized_certified: usize

(row, atom) encodes certified by the cheap amortized predictor.

newton_rescued: usize

(row, atom) encodes the amortized predictor missed but the certified Newton warm-start rescued.

multistart_fallback: usize

(row, atom) encodes neither tier certified — routed to the exact multi-start solve.

Implementations

impl FallbackTelemetry

pub fn total(&self) -> usize

Total (row, atom) encodes accounted for.

pub fn amortized_fraction(&self) -> f64

Fraction of encodes the cheap amortized predictor certified outright.

pub fn newton_fraction(&self) -> f64

Fraction of encodes rescued by the certified Newton warm-start.

pub fn multistart_fraction(&self) -> f64

Fraction of encodes that fell through to the exact multi-start solve — the encode-tax cost multiplier.

pub fn accumulate(&mut self, other: &FallbackTelemetry)

Fold another atom’s tallies into this one (n_rows is shared across atoms; n_atoms and the tier counts accumulate). Lets a caller aggregate the per-atom telemetry of EncodeAtlas::encode_atom_with_fallback_telemetry into one dictionary-wide breakdown.

Trait Implementations

impl Clone for FallbackTelemetry

fn clone(&self) -> FallbackTelemetry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FallbackTelemetry

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

Formats the value using the given formatter.

impl Default for FallbackTelemetry

fn default() -> FallbackTelemetry

Returns the “default value” for a type.