Struct LineCountHistogram 

pub struct LineCountHistogram {
    pub buckets: Vec<u32>,
    pub probabilities: Vec<f64>,
    pub n: usize,
}

Bucket histogram for counts such as lines-per-JE, fan-out, and active lifetime.

Fields

buckets: Vec<u32>

probabilities: Vec<f64>

n: usize

Implementations

impl LineCountHistogram

pub fn build(values: &[u32], buckets: &[u32]) -> (Self, usize)

Build a histogram on the given inclusive-lower-bound bucket grid.

The bucket grid must be sorted ascending. Values >= buckets.last() fall into the last bucket. Values < buckets[0] are dropped (count returned for diagnostic use).

pub fn pool(&self, other: &Self) -> Option<Self>

Sum bucket counts of self and other (same bucket grid) and renormalise. Returns None if grids mismatch.

pub fn median_bucket(&self) -> u32

Median bucket — the smallest buckets[i] whose cumulative probability >= 0.5.

pub fn sample_bucket<R: Rng>(&self, rng: &mut R) -> u32

Sample a count from the histogram. Picks a bucket weighted by probability mass, then samples uniformly within the bucket (between buckets[i] inclusive and buckets[i+1] exclusive — for the last bucket, returns buckets[i]).

Trait Implementations

impl Clone for LineCountHistogram

fn clone(&self) -> LineCountHistogram

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LineCountHistogram

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

Formats the value using the given formatter.

impl Default for LineCountHistogram

fn default() -> LineCountHistogram

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LineCountHistogram

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LineCountHistogram

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LineCountHistogram