Struct Estimate 

pub struct Estimate<T: PartialOrd + Copy> {
    pub point: T,
    pub lower: T,
    pub upper: T,
}

A physical measurement: point estimate ± 95 % confidence interval.

Invariant: lower ≤ point ≤ upper

Eq and Hash are intentionally NOT derived for Estimate<f64>. Floating-point equality is physically meaningless for measurements. Use Estimate::is_consistent_with for physically meaningful comparison.

Fields

point: T

Best single-value estimate (e.g. mean or median of samples).

lower: T

Lower bound of the 95 % confidence interval.

upper: T

Upper bound of the 95 % confidence interval.

Implementations

impl<T: PartialOrd + Copy + Display> Estimate<T>

pub fn new(point: T, lower: T, upper: T) -> Result<Self, EstimateError>

Constructs a new estimate, enforcing lower ≤ point ≤ upper.

Errors

Returns EstimateError::InvalidBounds if the invariant is violated.

pub fn exact(value: T) -> Self

Creates an exact estimate with zero uncertainty. Use for quantities known with mathematical certainty (e.g. counting).

impl Estimate<f64>

pub fn is_consistent_with(&self, other: &Self) -> bool

Two estimates are physically consistent if their confidence intervals overlap.

This is the correct notion of “agreement” between two uncertain measurements.

pub fn relative_uncertainty(&self) -> f64

Relative uncertainty: (upper − lower) / |point|.

Returns f64::INFINITY when |point| is below machine epsilon (cannot compute a meaningful relative uncertainty for a near-zero quantity).

pub fn with_extra_uncertainty(&self, factor: f64) -> Self

Returns a widened copy with interval expanded by factor (≥ 1.0).

Useful when composing multiple uncertain quantities conservatively.

Trait Implementations

impl<T: Clone + PartialOrd + Copy> Clone for Estimate<T>

fn clone(&self) -> Estimate<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + PartialOrd + Copy> Debug for Estimate<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Estimate<T>

where T: Deserialize<'de> + PartialOrd + Copy,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: PartialOrd + Copy + Display> Display for Estimate<T>

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

Formats the value using the given formatter.

impl<T: PartialEq + PartialOrd + Copy> PartialEq for Estimate<T>

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

where T: Serialize + PartialOrd + Copy,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Copy + PartialOrd + Copy> Copy for Estimate<T>

impl<T: PartialOrd + Copy> StructuralPartialEq for Estimate<T>