Struct FragmentationStats 

pub struct FragmentationStats {
    pub total_capacity: usize,
    pub reachable_edges: usize,
    pub dead_entries: usize,
    pub wasted_capacity: usize,
}

Fields

total_capacity: usize

Total reserved capacity (primary rows plus overflow chunks).

reachable_edges: usize

Number of live edges.

dead_entries: usize

Number of dead entries awaiting collection (primary tombstones plus overflow dead entries).

wasted_capacity: usize

Reserved capacity minus live edges (row gaps plus tombstone slots).

Implementations

impl FragmentationStats

pub fn with_dead_info( total_capacity: usize, reachable_edges: usize, dead_entries: usize, wasted_capacity: usize, ) -> FragmentationStats

Compute detailed fragmentation stats from edge counts.

pub fn fragmentation_ratio(&self) -> f32

Fragmentation ratio: wasted_capacity / total_capacity.

• 0.0 = no fragmentation (perfect packing)
• 0.5 = 50% wasted space
• 1.0 = all reserved capacity is waste

Observation metric for dashboards; collection triggers use the per-vertex reclaimable counts instead.

pub fn measured_bytes_per_edge(used_bytes: usize, edges: u64) -> usize

Measured bytes per edge with no fallback.

Empty tables report zero; degenerate zero measurements report zero. Callers handle zero explicitly instead of relying on estimates.

Trait Implementations

impl Clone for FragmentationStats

fn clone(&self) -> FragmentationStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FragmentationStats

impl Debug for FragmentationStats

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

Formats the value using the given formatter.