Struct StandardNormal

pub struct StandardNormal;

The standard Normal distribution N(0, 1).

This is equivalent to Normal::new(0.0, 1.0), but faster.

See Normal for the general Normal distribution.

Plot

The following diagram shows the standard Normal distribution.

Example

use rand::prelude::*;
use rand_distr::StandardNormal;

let val: f64 = rand::rng().sample(StandardNormal);
println!("{}", val);

Notes

Implemented via the ZIGNOR variant¹ of the Ziggurat method.

---

1. Jurgen A. Doornik (2005). An Improved Ziggurat Method to Generate Normal Random Samples. Nuffield College, Oxford ↩

Trait Implementations

impl Clone for StandardNormal

fn clone(&self) -> StandardNormal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StandardNormal

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StandardNormal

fn deserialize<__D>( __deserializer: __D, ) -> Result<StandardNormal, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Distribution<f32> for StandardNormal

fn sample<R>(&self, rng: &mut R) -> f32

where R: Rng + ?Sized,

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

fn sample_iter<R>(self, rng: R) -> Iter<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) -> Map<Self, F, T, S>

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

Map sampled values to type S

impl Distribution<f64> for StandardNormal

fn sample<R>(&self, rng: &mut R) -> f64

where R: Rng + ?Sized,

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

fn sample_iter<R>(self, rng: R) -> Iter<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) -> Map<Self, F, T, S>

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

Map sampled values to type S

impl Serialize for StandardNormal

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for StandardNormal