Struct EnergyWindow 

pub struct EnergyWindow {
    pub window_s: f64,
    pub samples: usize,
    pub energy_j: f64,
    pub mean_power_w: f64,
    pub max_power_w: f64,
    pub sw_power_cap_frac: Option<f64>,
    pub hw_power_brake_frac: Option<f64>,
}

2026-09-26: The energy integral over one measured window.

Fields

window_s: f64

2026-09-26: Window length the joules span, seconds.

samples: usize

2026-09-26: Readings the integral stood on.

energy_j: f64

2026-09-26: Σ P_i · dt_i: each reading held forward to the next, the first back-filled to the window start, the last held to the window end, so Σ dt_i is exactly window_s.

mean_power_w: f64

max_power_w: f64

sw_power_cap_frac: Option<f64>

2026-09-26: Of the readings that reported the SW power cap flag, the fraction (by count, not time) with it asserted; None when none reported it.

hw_power_brake_frac: Option<f64>

2026-09-26: Same, for the HW power brake.

Implementations

impl EnergyWindow

pub fn above_idle_j(&self, idle: &EnergyWindow) -> f64

2026-09-26: Joules above what the box would have drawn idle for the same duration: energy_j − idle.mean_power_w × window_s. Negative when the window drew less than the baseline; not clamped.

pub fn sum(windows: &[EnergyWindow]) -> Option<EnergyWindow>

2026-09-26: Several windows as one: joules, seconds and samples add, the mean is re-derived, the max is the largest max, and each flag fraction is weighted by the sample counts of the windows that report it. None for no windows.

pub fn metrics( &self, prefix: &str, tokens: usize, idle: Option<&EnergyWindow>, m: &mut BTreeMap<String, f64>, )

2026-09-26: The record keys for one window, under prefix ("c{C}_" from the concurrency sweep, "" from decode-floor). tokens is the caller’s count of output tokens delivered inside this window; it is written beside the joules, and J/token is derived from the pair.

pub fn one_line(&self, idle: Option<&EnergyWindow>) -> String

2026-09-26: One log line: joules, seconds, mean and max watts, samples, above-idle joules when a baseline is given, the SW cap fraction, and the HW brake fraction when it is above zero.

Trait Implementations

impl Clone for EnergyWindow

fn clone(&self) -> EnergyWindow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EnergyWindow

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

Formats the value using the given formatter.

impl Default for EnergyWindow

fn default() -> EnergyWindow

Returns the “default value” for a type.

impl PartialEq for EnergyWindow

fn eq(&self, other: &EnergyWindow) -> 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 Copy for EnergyWindow

impl StructuralPartialEq for EnergyWindow