Struct DeviceEncodeThroughput 

pub struct DeviceEncodeThroughput {
    pub n_rows: usize,
    pub encode_secs: f64,
    pub rows_per_sec: f64,
    pub path: EncodePath,
    pub decision: EncodeDeploymentDecision,
}

Measured throughput of the device-resident exact per-row certified encode (sae_certified_encode_batch) — the literal “batched exact per-row GPU encode” of #988, timed end to end (routing + amortized warm start + basin Newton + Kantorovich certificate + lowest-error assignment/fallback), NOT a component solve like gam_gpu::encode_throughput::measure_resident_solve_throughput (which times only the resident normal-equations inner cell).

The point of this struct is Self::decision: the #988 surrogate question (“is the exact encode fast enough at 10⁹ rows, or must we distill a certified amortized surrogate?”) is answered by this measurement and only this one. The decision is keyed on EncodeDeploymentDecision::from_device_measurement with engaged = (path == EncodePath::Device), so it inherits that type’s anti-green-wash contract: a CPU-emulator run (path == Cpu) can NEVER declare the surrogate unneeded — it is honestly EncodeDeploymentDecision::Undetermined (blocked on hardware), no matter how fast the CPU rate is. Only a real device launch of the exact-encode kernel can move the decision to Met/Unmet.

Fields

n_rows: usize

Rows encoded in the timed batch.

encode_secs: f64

Wall-clock seconds for the full exact encode of the batch.

rows_per_sec: f64

n_rows / encode_secs (0.0 for a degenerate / non-positive time).

path: EncodePath

Which path actually ran the encode — the #1026/#1551 honesty flag.

decision: EncodeDeploymentDecision

The #988 surrogate decision keyed on THIS exact-encode measurement. Met/Unmet only when path == EncodePath::Device; a CPU-emulator run is Undetermined { NoDeviceEncodeKernel-adjacent } — a fast CPU number is never a device pass.

Implementations

impl DeviceEncodeThroughput

pub fn device_engaged(&self) -> bool

true iff the exact-encode kernel actually ran on a CUDA device — the only state in which Self::decision is a real Met/Unmet.

Trait Implementations

impl Clone for DeviceEncodeThroughput

fn clone(&self) -> DeviceEncodeThroughput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DeviceEncodeThroughput

impl Debug for DeviceEncodeThroughput

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

Formats the value using the given formatter.