Struct GradientHistogram 

pub struct GradientHistogram {
    pub buckets: Vec<f32>,
    pub counts: Vec<usize>,
    pub total_values: usize,
    /* private fields */
}

Bucket-based gradient histogram builder.

The bucket edges are linearly spaced between [min, max] (inclusive endpoints stored as the first and last element of buckets). Values outside [min, max] are clamped into the first/last bucket.

Fields

buckets: Vec<f32>

Bucket edges (length = num_buckets + 1).

counts: Vec<usize>

Count per bucket (length = num_buckets).

total_values: usize

Total number of values added.

Implementations

impl GradientHistogram

pub fn new(num_buckets: usize, min: f32, max: f32) -> Self

Create a new histogram with linearly spaced edges in [min, max].

Panics if num_buckets == 0 or min >= max.

pub fn add_value(&mut self, val: f32)

Add a single value to the histogram.

pub fn add_values(&mut self, vals: &[f32])

Add multiple values.

pub fn mean(&self) -> f32

Compute the mean of all inserted values.

Returns 0.0 if no values have been added.

pub fn std_dev(&self) -> f32

Compute the sample standard deviation of all inserted values.

Returns 0.0 if fewer than 2 values have been added.

pub fn percentile(&self, p: f32) -> f32

Approximate the p-th percentile (0.0–100.0) via bucket interpolation.

Returns the lower bucket edge when counts are insufficient for interpolation.

pub fn to_ascii_bars(&self) -> String

Render a compact horizontal bar chart (one line per bucket).

Trait Implementations

impl Clone for GradientHistogram

fn clone(&self) -> GradientHistogram

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GradientHistogram

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

Formats the value using the given formatter.