Struct easy_ml::distributions::Gaussian

pub struct Gaussian<T: Numeric + Real> {
    pub mean: T,
    pub variance: T,
}

A Gaussian probability density function of a normally distributed random variable with expected value / mean μ, and variance σ².

See: https://en.wikipedia.org/wiki/Gaussian_function

Fields

mean: T

The mean is the expected value of this gaussian.

variance: T

The variance is a measure of the spread of values around the mean, high variance means one standard deviation encompasses a larger spread of values from the mean.

Methods

impl<T: Numeric + Real> Gaussian<T>

pub fn new(mean: T, variance: T) -> Gaussian<T>

impl<T: Numeric + Real> Gaussian<T> where
    &'a T: NumericRef<T> + RealRef<T>, 

pub fn map(&self, x: &T) -> T

Computes g(x) for some x, the probability density of a normally distributed random variable x, or in other words how likely x is to be drawn from this normal distribution.

g(x) is largest for x equal to this distribution's mean and g(x) will tend towards zero as x is further from this distribution's mean, at a rate corresponding to this distribution's variance.

pub fn draw<I>(&self, source: &mut I, max_samples: usize) -> Option<Vec<T>> where
    I: Iterator<Item = T>, 

Given a source of random variables in the uniformly distributed range [0, 1] inclusive, draws max_samples of independent random numbers according to this Gaussian distribution's mean and variance using the Box-Muller transform:

https://en.wikipedia.org/wiki/Box%E2%80%93Muller_transform

The source of random variables must provide at least as many values as max_samples if max_samples is even, and one more than max_samples if max_samples is odd. If fewer are provided None is returned.

As all randomness is provided to this method, this code is deterministic and will always compute the same samples given the same random source of numbers.

Example of generating and feeding random numbers