Enum Distribution 

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

A distribution over read fractions.

Build one with Distribution::fixed or Distribution::weighted, which validate their inputs. The variants are public for pattern matching; values built directly are validated again whenever they are used.

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 not finite, the slice is empty, or all weights are 0.

Repeated fractions have their weights added together.

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

The distinct read fractions in this distribution, sorted.

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 any fraction is outside [0, 1], any weight is negative or not finite, or the total weight is not positive.

Trait Implementations

impl Clone for Distribution

fn clone(&self) -> Self

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: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Distribution

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.