Enum Distribution 

pub enum Distribution {
    Fixed(f64),
    Weighted(HashMap<OrderedFloat, f64>),
}

Represents a distribution of read fractions in a workload.

Variants

Fixed(f64)

A single fixed read fraction (e.g. 0.5 means 50% reads).

Weighted(HashMap<OrderedFloat, f64>)

A weighted distribution over multiple read fractions. Maps read_fraction -> weight (not yet normalized).

Implementations

impl Distribution

pub fn fixed(read_fraction: f64) -> Result<Self>

Create a fixed distribution with a single read fraction.

Errors

Returns an error if read_fraction is not in [0.0, 1.0].

pub fn weighted(weights: &[(f64, f64)]) -> Result<Self>

Create a weighted distribution from pairs of (read_fraction, weight). Validates but does not normalize; call Distribution::canonicalize for normalization.

Errors

Returns an error if any fraction is not in [0.0, 1.0], any weight is negative, or the weights slice is empty.

pub fn fractions(&self) -> Vec<f64>

Return the distinct read fractions in this distribution.

pub fn canonicalize(&self) -> Result<Canonical>

Canonicalize this distribution into a map of read_fraction -> probability where probabilities sum to 1.0. Zero-weight entries are excluded.

Errors

Returns an error if the total weight is zero (for weighted distributions).

Trait Implementations

impl Clone for Distribution

fn clone(&self) -> Distribution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Distribution

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

Formats the value using the given formatter.

impl PartialEq for Distribution

fn eq(&self, other: &Distribution) -> 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 TryFrom<f64> for Distribution

Convenience conversions so callers can pass a plain f64.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: f64) -> Result<Self>

Performs the conversion.

impl TryFrom<i32> for Distribution

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: i32) -> Result<Self>

Performs the conversion.

impl StructuralPartialEq for Distribution