Struct GainSchedule 

pub struct GainSchedule {
    pub scale_log2: i32,
    pub out_descale_log2: i32,
    pub mul_vref_v: f64,
    pub quantized: AnalogNetlist,
    pub per_net_scale_log2: Vec<i32>,
}

The per-program gain schedule: one block scale for every net, the exact ADC descale, the REALIZABLE multiplier reference, and the weight-quantized twin of the netlist (weights snapped to the target’s unit elements — what the silicon actually programs).

Fields

scale_log2: i32

The block scale exponent: volt = 2^scale_log2 · math on every net.

out_descale_log2: i32

The output descale exponent (math = 2^out_descale_log2 · volt); always -scale_log2.

mul_vref_v: f64

The multiplier normalization reference in volts. When the graph carries a Mul, this is a member of the target’s mul_vref_options_v equal to the block scale — chosen FROM the realizable set, never approximated into it.

quantized: AnalogNetlist

The netlist with every programmed weight snapped to the target’s unit-element grid — the configuration the fabric actually realizes (PHYSICAL weights, which under a per-net schedule include the exact power-of-two rescale between operand and cell scales). The snap error is a budget term (ErrorSource::WeightQuant), never silently absorbed.

per_net_scale_log2: Vec<i32>

Per-cell scale exponents (volt_i = 2^{per_net_scale_log2[i]} · math_i). Uniform schedules carry scale_log2 everywhere; a per-net schedule (O4) lets internal nets diverge while inputs and the output stay on scale_log2, so the converter grid is untouched. The independent range checker judges per-cell scales natively.

Implementations

impl GainSchedule

pub fn realized_math_cells(&self) -> Vec<AnalogCell>

The REALIZED math dataflow: each physical weight mapped back to the math domain by the exact power-of-two rescale (w_math_realized = w_phys · 2^{e_operand − e_cell}). Under a uniform schedule this is the quantized netlist verbatim. Certificates and budgets judge THIS — the dataflow the silicon actually computes.

Trait Implementations

impl Clone for GainSchedule

fn clone(&self) -> GainSchedule

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GainSchedule

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

Formats the value using the given formatter.

impl PartialEq for GainSchedule

fn eq(&self, other: &GainSchedule) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GainSchedule