Struct Bucket 

pub struct Bucket {
    pub index: usize,
    pub label: Cow<'static, str>,
    pub lo: f64,
    pub hi: f64,
}

One bucket on a Breakdown.

A bucket carries everything the per-image orchestrator and the summarizer need to slice a single A-axis cell: the inclusive [lo, hi] range used to test annotation membership, the label rendered in the summary table, and the index position on the crate::Accumulated A-axis where the cell’s outputs land.

Inclusivity. [lo, hi] is closed on both ends, mirroring pycocotools’ cocoeval.py:251 predicate not (area < lo or area > hi) (quirk D6 strict). An annotation whose key sits exactly on a boundary lands in both adjacent buckets. This is not the half-open convention Range<f64> would imply — buckets are not a partition, they are an overlap-tolerant cover.

Fields

index: usize

A-axis position. 0 is conventionally the all bucket on area-keyed Breakdowns.

label: Cow<'static, str>

Label rendered by the summarizer (e.g. "all", "small", "medium", "large" for area; "easy", "hard" for a future CrowdPose breakdown).

lo: f64

Lower bound (inclusive — quirks D6/D7).

hi: f64

Upper bound (inclusive — quirks D6/D7). Use AREA_UNBOUNDED (1e10) for “no upper bound”; pycocotools uses exactly that value for the all and large buckets.

Implementations

impl Bucket

pub const fn from_static( index: usize, label: &'static str, lo: f64, hi: f64, ) -> Self

const-friendly constructor for compile-time string labels.

pub fn new( index: usize, label: impl Into<Cow<'static, str>>, lo: f64, hi: f64, ) -> Self

Constructor for owned-string labels (e.g., labels built at runtime from a config file).

pub fn contains(&self, key: f64) -> bool

true when key falls inside [lo, hi] (closed on both ends — quirks D6/D7).

pub fn to_area_range(&self) -> AreaRange

Lift this bucket into the AreaRange shape the per-image orchestrator consumes.

pub fn to_area_rng(&self) -> AreaRng

Lift this bucket into the AreaRng shape the summarizer consumes.

Trait Implementations

impl Clone for Bucket

fn clone(&self) -> Bucket

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Bucket

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

Formats the value using the given formatter.

impl PartialEq for Bucket

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