Struct Uncertain 

pub struct Uncertain<T>
where
    T: ProbabilisticType,
{ /* private fields */ }

A type representing a value with inherent uncertainty, modeled as a probability distribution.

Implementations

impl Uncertain<bool>

pub fn point(value: bool) -> Uncertain<bool>

Creates a new Uncertain<bool> instance representing a point distribution.

Arguments

• value - The boolean value of the point distribution.

pub fn bernoulli(p: f64) -> Uncertain<bool>

Creates a new Uncertain<bool> instance representing a Bernoulli distribution.

Arguments

• p - The probability of success (true) for the Bernoulli distribution.

pub fn to_bool( &self, threshold: f64, confidence: f64, epsilon: f64, max_samples: usize, ) -> Result<bool, UncertainError>

Converts the uncertain boolean distribution to a single boolean value based on statistical hypothesis testing.

This method uses Sequential Probability Ratio Test (SPRT) to determine if the underlying probability of true exceeds a given threshold.

Arguments

• threshold - The probability threshold to test against.
• confidence - The desired confidence level (e.g., 0.95 for 95% confidence).
• epsilon - The indifference region, defining how close the probability can be to the threshold and still be considered uncertain.
• max_samples - The maximum number of samples to take during the SPRT.

Returns

Ok(bool) if a decision can be made, or Err(UncertainError) if the test fails or cannot conclude.

pub fn probability_exceeds( &self, threshold: f64, confidence: f64, epsilon: f64, max_samples: usize, ) -> Result<bool, UncertainError>

Determines if the probability of the uncertain boolean being true exceeds a given threshold.

This method is an alias for to_bool and also uses Sequential Probability Ratio Test (SPRT).

Arguments

• threshold - The probability threshold to test against.
• confidence - The desired confidence level.
• epsilon - The indifference region.
• max_samples - The maximum number of samples to take.

Returns

Ok(bool) indicating whether the probability exceeds the threshold, or Err(UncertainError).

pub fn implicit_conditional(&self) -> Result<bool, UncertainError>

Evaluates an implicit conditional, typically checking if the probability of true exceeds 0.5.

This is a convenience method that calls probability_exceeds with default parameters: threshold = 0.5, confidence = 0.95, epsilon = 0.05, max_samples = 1000.

pub fn estimate_probability( &self, num_samples: usize, ) -> Result<f64, UncertainError>

Estimates the probability that this condition is true by taking multiple samples.

impl Uncertain<f64>

pub fn point(value: f64) -> Uncertain<f64>

pub fn normal(mean: f64, std_dev: f64) -> Uncertain<f64>

pub fn uniform(low: f64, high: f64) -> Uncertain<f64>

pub fn from_samples(samples: &[f64]) -> Uncertain<f64>

pub fn estimate_probability_exceeds( &self, threshold: f64, num_samples: usize, ) -> Result<f64, UncertainError>

pub fn map<F>(&self, func: F) -> Uncertain<f64>

where F: Fn(f64) -> f64 + Send + Sync + 'static,

pub fn map_to_bool<F>(&self, func: F) -> Uncertain<bool>

where F: Fn(f64) -> bool + Send + Sync + 'static,

impl Uncertain<f64>

pub fn greater_than(&self, threshold: f64) -> Uncertain<bool>

pub fn less_than(&self, threshold: f64) -> Uncertain<bool>

pub fn equals(&self, threshold: f64) -> Uncertain<bool>

pub fn gt_uncertain(&self, other: &Uncertain<f64>) -> Uncertain<bool>

pub fn lt_uncertain(&self, other: &Uncertain<f64>) -> Uncertain<bool>

pub fn eq_uncertain(&self, other: &Uncertain<f64>) -> Uncertain<bool>

pub fn approx_eq(&self, target: f64, tolerance: f64) -> Uncertain<bool>

Check if value is approximately equal within tolerance

pub fn within_range(&self, min: f64, max: f64) -> Uncertain<bool>

Check if value is within a range

impl Uncertain<f64>

pub fn sample_with_index( &self, sample_index: u64, ) -> Result<f64, UncertainError>

pub fn sample(&self) -> Result<f64, UncertainError>

pub fn take_samples(&self, n: usize) -> Result<Vec<f64>, UncertainError>

impl Uncertain<bool>

pub fn sample_with_index( &self, sample_index: u64, ) -> Result<bool, UncertainError>

pub fn sample(&self) -> Result<bool, UncertainError>

pub fn take_samples(&self, n: usize) -> Result<Vec<bool>, UncertainError>

impl Uncertain<f64>

pub fn expected_value(&self, num_samples: usize) -> Result<f64, UncertainError>

Estimates the expected value (mean) of the uncertain f64 value by taking multiple samples.

pub fn standard_deviation( &self, num_samples: usize, ) -> Result<f64, UncertainError>

Estimates the standard deviation of the uncertain f64 value by taking multiple samples.

impl<T> Uncertain<T>

where T: ProbabilisticType,

pub fn conditional( condition: Uncertain<bool>, if_true: Uncertain<T>, if_false: Uncertain<T>, ) -> Uncertain<T>

impl<T> Uncertain<T>

where T: ProbabilisticType + Copy,

pub fn id(&self) -> usize

pub fn value(&self) -> T

Trait Implementations

impl Add for Uncertain<f64>

type Output = Uncertain<f64>

The resulting type after applying the + operator.

fn add(self, rhs: Uncertain<f64>) -> <Uncertain<f64> as Add>::Output

Performs the + operation.

impl BitAnd for Uncertain<bool>

type Output = Uncertain<bool>

The resulting type after applying the & operator.

fn bitand(self, rhs: Uncertain<bool>) -> <Uncertain<bool> as BitAnd>::Output

Performs the & operation.

impl BitOr for Uncertain<bool>

type Output = Uncertain<bool>

The resulting type after applying the | operator.

fn bitor(self, rhs: Uncertain<bool>) -> <Uncertain<bool> as BitOr>::Output

Performs the | operation.

impl BitXor for Uncertain<bool>

type Output = Uncertain<bool>

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Uncertain<bool>) -> <Uncertain<bool> as BitXor>::Output

Performs the ^ operation.

impl<T> Clone for Uncertain<T>

where T: Clone + ProbabilisticType,

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Uncertain<T>

where T: Debug + ProbabilisticType,

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

Formats the value using the given formatter.

impl Default for Uncertain<bool>

fn default() -> Uncertain<bool>

Returns the “default value” for a type.

impl Default for Uncertain<f64>

fn default() -> Uncertain<f64>

Returns the “default value” for a type.

impl Div for Uncertain<f64>

type Output = Uncertain<f64>

The resulting type after applying the / operator.

fn div(self, rhs: Uncertain<f64>) -> <Uncertain<f64> as Div>::Output

Performs the / operation.

impl Mul for Uncertain<f64>

type Output = Uncertain<f64>

The resulting type after applying the * operator.

fn mul(self, rhs: Uncertain<f64>) -> <Uncertain<f64> as Mul>::Output

Performs the * operation.

impl Neg for Uncertain<f64>

type Output = Uncertain<f64>

The resulting type after applying the - operator.

fn neg(self) -> <Uncertain<f64> as Neg>::Output

Performs the unary - operation.

impl Not for Uncertain<bool>

type Output = Uncertain<bool>

The resulting type after applying the ! operator.

fn not(self) -> <Uncertain<bool> as Not>::Output

Performs the unary ! operation.

impl<T> PartialEq for Uncertain<T>

where T: ProbabilisticType + PartialEq,

fn eq(&self, other: &Uncertain<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 Sub for Uncertain<f64>

type Output = Uncertain<f64>

The resulting type after applying the - operator.

fn sub(self, rhs: Uncertain<f64>) -> <Uncertain<f64> as Sub>::Output

Performs the - operation.