Struct ResidencyReport 

pub struct ResidencyReport {
    pub total_bytes: usize,
    pub peak_bytes: usize,
    pub peak_op_index: usize,
    pub eviction_candidates: Vec<LiveRange>,
}

Structured report on a graph’s residency profile.

Fields

total_bytes: usize

Total bytes of storage summed over every reachable op’s output. Not the peak — this is cumulative if nothing were freed.

peak_bytes: usize

Maximum bytes live simultaneously at any point during a single-device execution of the graph. The minimum VRAM (or “primary device”) required to run without spilling.

peak_op_index: usize

Op position (index in topo order) where the peak occurs.

eviction_candidates: Vec<LiveRange>

Per-tensor live range, sorted by bytes * inactive_gap descending (biggest “wasted residency” candidates first). insert_residency_evictions consumes this list.

Implementations

impl ResidencyReport

pub fn fits_in(&self, budget: usize) -> bool

Does this graph fit in a given byte budget?

pub fn overage(&self, budget: usize) -> usize

Byte overage relative to a budget. Zero when the graph fits.

Trait Implementations

impl Clone for ResidencyReport

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResidencyReport

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

Formats the value using the given formatter.