Struct rand_distr::Normal

pub struct Normal<F>
where
    F: Float,
    StandardNormal: Distribution<F>,
{ /* private fields */ }

The normal distribution N(mean, std_dev**2).

This uses the ZIGNOR variant of the Ziggurat method, see StandardNormal for more details.

Note that StandardNormal is an optimised implementation for mean 0, and standard deviation 1.

Example

use rand_distr::{Normal, Distribution};

// mean 2, standard deviation 3
let normal = Normal::new(2.0, 3.0).unwrap();
let v = normal.sample(&mut rand::thread_rng());
println!("{} is from a N(2, 9) distribution", v)

Implementations

impl<F> Normal<F>

where F: Float, StandardNormal: Distribution<F>,

pub fn new(mean: F, std_dev: F) -> Result<Normal<F>, Error>

Construct, from mean and standard deviation

Parameters:

• mean (μ, unrestricted)
• standard deviation (σ, must be finite)

pub fn from_mean_cv(mean: F, cv: F) -> Result<Normal<F>, Error>

Construct, from mean and coefficient of variation

Parameters:

• mean (μ, unrestricted)
• coefficient of variation (cv = abs(σ / μ))

pub fn from_zscore(&self, zscore: F) -> F

Sample from a z-score

This may be useful for generating correlated samples x1 and x2 from two different distributions, as follows.

let mut rng = thread_rng();
let z = StandardNormal.sample(&mut rng);
let x1 = Normal::new(0.0, 1.0).unwrap().from_zscore(z);
let x2 = Normal::new(2.0, -3.0).unwrap().from_zscore(z);

pub fn mean(&self) -> F

Returns the mean (μ) of the distribution.

pub fn std_dev(&self) -> F

Returns the standard deviation (σ) of the distribution.

Trait Implementations

impl<F> Clone for Normal<F>

where F: Float + Clone, StandardNormal: Distribution<F>,

fn clone(&self) -> Normal<F>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F> Debug for Normal<F>

where F: Float + Debug, StandardNormal: Distribution<F>,

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

Formats the value using the given formatter.

impl<'de, F> Deserialize<'de> for Normal<F>

where F: Float + Deserialize<'de>, StandardNormal: Distribution<F>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<F> Distribution<F> for Normal<F>

where F: Float, StandardNormal: Distribution<F>,

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> F

Generate a random value of T, using rng as the source of randomness.

fn sample_iter<R>(self, rng: R) -> DistIter<Self, R, T>

where R: Rng, Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness.

fn map<F, S>(self, func: F) -> DistMap<Self, F, T, S>

where F: Fn(T) -> S, Self: Sized,

Create a distribution of values of ‘S’ by mapping the output of Self through the closure F

impl<F> PartialEq for Normal<F>

where F: Float + PartialEq, StandardNormal: Distribution<F>,

fn eq(&self, other: &Normal<F>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<F> Serialize for Normal<F>

where F: Float + Serialize, StandardNormal: Distribution<F>,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<F> Copy for Normal<F>

where F: Float + Copy, StandardNormal: Distribution<F>,

impl<F> StructuralPartialEq for Normal<F>

where F: Float, StandardNormal: Distribution<F>,