Struct rv::dist::Exponential

pub struct Exponential { /* fields omitted */ }

Exponential distribution, Exp(λ) over x in [0, ∞).

Examples

Compute 50% confidence interval

use rv::prelude::*;

let expon = Exponential::new(1.5).unwrap();
let interval: (f64, f64) = expon.interval(0.5);  // (0.19, 0.92)

Methods

impl Exponential

pub fn set_rate(&mut self, val: f64) -> &mut Self

λ > 0, rate or inverse scale

impl Exponential

pub fn new(rate: f64) -> Result<Self, ExponentialError>

Create a new exponential distribution

Arguments

• rate: λ > 0, rate or inverse scale

pub fn new_unchecked(rate: f64) -> Self

Creates a new Exponential without checking whether the parameter is valid.

pub fn rate(&self) -> f64

Get the rate parameter

Example

let expon = Exponential::new(1.3).unwrap();
assert_eq!(expon.rate(), 1.3);

Trait Implementations

impl Cdf<f32> for Exponential

fn cdf(&self, x: &f32) -> f64

The value of the Cumulative Density Function at x

fn sf(&self, x: &X) -> f64

Survival function, 1 - CDF(x)

impl Cdf<f64> for Exponential

fn cdf(&self, x: &f64) -> f64

The value of the Cumulative Density Function at x

fn sf(&self, x: &X) -> f64

Survival function, 1 - CDF(x)

impl Clone for Exponential

fn clone(&self) -> Exponential

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ContinuousDistr<f32> for Exponential

fn pdf(&self, x: &X) -> f64

The value of the Probability Density Function (PDF) at x

fn ln_pdf(&self, x: &X) -> f64

The value of the log Probability Density Function (PDF) at x

impl ContinuousDistr<f64> for Exponential

fn pdf(&self, x: &X) -> f64

The value of the Probability Density Function (PDF) at x

fn ln_pdf(&self, x: &X) -> f64

The value of the log Probability Density Function (PDF) at x

impl Debug for Exponential

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

Formats the value using the given formatter.

impl Display for Exponential

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

Formats the value using the given formatter.

impl Entropy for Exponential

fn entropy(&self) -> f64

The entropy, H(X)

impl<'_> From<&'_ Exponential> for String

fn from(expon: &Exponential) -> String

Performs the conversion.

impl InverseCdf<f32> for Exponential

fn invcdf(&self, p: f64) -> f32

The value of the x at the given probability in the CDF

fn quantile(&self, p: f64) -> X

Alias for invcdf

fn interval(&self, p: f64) -> (X, X)

Interval containing p proportion for the probability

impl InverseCdf<f64> for Exponential

fn invcdf(&self, p: f64) -> f64

The value of the x at the given probability in the CDF

fn quantile(&self, p: f64) -> X

Alias for invcdf

fn interval(&self, p: f64) -> (X, X)

Interval containing p proportion for the probability

impl KlDivergence for Exponential

fn kl(&self, other: &Self) -> f64

The KL divergence, KL(P|Q) between this distribution, P, and another, Q

fn kl_sym(&self, other: &Self) -> f64

Symmetrised divergence, KL(P|Q) + KL(Q|P)

impl Kurtosis for Exponential

fn kurtosis(&self) -> Option<f64>

impl Mean<f32> for Exponential

fn mean(&self) -> Option<f32>

Returns None if the mean is undefined

impl Mean<f64> for Exponential

fn mean(&self) -> Option<f64>

Returns None if the mean is undefined

impl Median<f32> for Exponential

fn median(&self) -> Option<f32>

Returns None if the median is undefined

impl Median<f64> for Exponential

fn median(&self) -> Option<f64>

Returns None if the median is undefined

impl Mode<f32> for Exponential

fn mode(&self) -> Option<f32>

Returns None if the mode is undefined or is not a single value

impl Mode<f64> for Exponential

fn mode(&self) -> Option<f64>

Returns None if the mode is undefined or is not a single value

impl PartialEq<Exponential> for Exponential

fn eq(&self, other: &Exponential) -> bool

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

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

This method tests for !=.

impl PartialOrd<Exponential> for Exponential

fn partial_cmp(&self, other: &Exponential) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Exponential) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Exponential) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Exponential) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Exponential) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Rv<f32> for Exponential

fn ln_f(&self, x: &f32) -> f64

Probability function

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

Single draw from the Rv

fn sample<R: Rng>(&self, n: usize, rng: &mut R) -> Vec<f32>

Multiple draws of the Rv

fn f(&self, x: &X) -> f64

Probability function

impl Rv<f64> for Exponential

fn ln_f(&self, x: &f64) -> f64

Probability function

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

Single draw from the Rv

fn sample<R: Rng>(&self, n: usize, rng: &mut R) -> Vec<f64>

Multiple draws of the Rv

fn f(&self, x: &X) -> f64

Probability function

impl Skewness for Exponential

fn skewness(&self) -> Option<f64>

impl StructuralPartialEq for Exponential

impl Support<f32> for Exponential

fn supports(&self, x: &f32) -> bool

Returns true if x is in the support of the Rv

impl Support<f64> for Exponential

fn supports(&self, x: &f64) -> bool

Returns true if x is in the support of the Rv

impl Variance<f32> for Exponential

fn variance(&self) -> Option<f32>

Returns None if the variance is undefined

impl Variance<f64> for Exponential

fn variance(&self) -> Option<f64>

Returns None if the variance is undefined