Struct Exp1

pub struct Exp1;

The standard exponential distribution Exp(1).

This is equivalent to Exp::new(1.0) or sampling with -rng.gen::<f64>().ln(), but faster.

See Exp for the general exponential distribution.

Plot

The following plot illustrates the exponential distribution with λ = 1.

Example

use rand::prelude::*;
use rand_distr::Exp1;

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

Notes

Implemented via the ZIGNOR variant¹ of the Ziggurat method. The exact description in the paper was adjusted to use tables for the exponential distribution rather than normal.

---

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

Trait Implementations

impl Clone for Exp1

fn clone(&self) -> Exp1

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Exp1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Exp1

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Distribution<f32> for Exp1

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

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 Distribution<f64> for Exp1

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

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 Serialize for Exp1

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Exp1