Struct statrs::distribution::Laplace

source · [−]

pub struct Laplace { /* private fields */ }

Expand description

Implements the Laplace distribution.

Examples

use statrs::distribution::{Laplace, Continuous};
use statrs::statistics::Mode;

let n = Laplace::new(0.0, 1.0).unwrap();
assert_eq!(n.mode().unwrap(), 0.0);
assert_eq!(n.pdf(1.0), 0.18393972058572117);

Implementations

source

impl Laplace

source

pub fn new(location: f64, scale: f64) -> Result<Laplace>

Constructs a new laplace distribution with the given location and scale.

Errors

Returns an error if location or scale are NaN or scale <= 0.0

Examples

use statrs::distribution::Laplace;

let mut result = Laplace::new(0.0, 1.0);
assert!(result.is_ok());

result = Laplace::new(0.0, -1.0);
assert!(result.is_err());

source

pub fn location(&self) -> f64

Returns the location of the laplace distribution

Examples

use statrs::distribution::Laplace;

let n = Laplace::new(0.0, 1.0).unwrap();
assert_eq!(n.location(), 0.0);

source

pub fn scale(&self) -> f64

Returns the scale of the laplace distribution

Examples

use statrs::distribution::Laplace;

let n = Laplace::new(0.0, 1.0).unwrap();
assert_eq!(n.scale(), 1.0);

Trait Implementations

source

impl Clone for Laplace

source

fn clone(&self) -> Laplace

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Continuous<f64, f64> for Laplace

source

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

Calculates the probability density function for the laplace distribution at x

Formula

(1 / 2b) * exp(-|x - μ| / b)

where μ is the location and b is the scale

source

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

Calculates the log probability density function for the laplace distribution at x

Formula

ln((1 / 2b) * exp(-|x - μ| / b))

where μ is the location and b is the scale

source

impl ContinuousCDF<f64, f64> for Laplace

source

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

Calculates the cumulative distribution function for the laplace distribution at x

Formula

(1 / 2) * (1 + signum(x - μ)) - signum(x - μ) * exp(-|x - μ| / b)

where μ is the location, b is the scale

source

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

Calculates the inverse cumulative distribution function for the laplace distribution at p

Formula

if p <= 1/2

μ + b * ln(2p)

if p >= 1/2

μ - b * ln(2 - 2p)

where μ is the location, b is the scale

source

impl Debug for Laplace

source

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

Formats the value using the given formatter. Read more

source

impl Distribution<f64> for Laplace

source

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

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

source

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

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

source

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

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

source

impl Distribution<f64> for Laplace

source

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

Returns the mode of the laplace distribution

Formula

μ

where μ is the location

source

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

Returns the variance of the laplace distribution

Formula

2*b^2

where b is the scale

source

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

Returns the entropy of the laplace distribution

Formula

ln(2be)

where b is the scale

source

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

Returns the skewness of the laplace distribution

Formula

source

fn std_dev(&self) -> Option<T>

Returns the standard deviation, if it exists. Read more

source

impl Max<f64> for Laplace

source

fn max(&self) -> f64

Returns the maximum value in the domain of the laplace distribution representable by a double precision float

Formula

INF

source

impl Median<f64> for Laplace

source

fn median(&self) -> f64

Returns the median of the laplace distribution

Formula

μ

where μ is the location

source

impl Min<f64> for Laplace

source

fn min(&self) -> f64

Returns the minimum value in the domain of the laplace distribution representable by a double precision float

Formula

NEG_INF

source

impl Mode<Option<f64>> for Laplace

source

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

Returns the mode of the laplace distribution

Formula

μ

where μ is the location

source

impl PartialEq<Laplace> for Laplace

source

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

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

source

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

This method tests for !=.

source

impl Copy for Laplace

source

impl StructuralPartialEq for Laplace

Auto Trait Implementations

impl RefUnwindSafe for Laplace

impl Send for Laplace

impl Sync for Laplace

impl Unpin for Laplace

impl UnwindSafe for Laplace

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T> Same<T> for T

type Output = T

Should always be Self

source

impl<T> Scalar for T where
T: Copy + PartialEq<T> + Debug + Any,

source

pub fn inlined_clone(&self) -> T

Performance hack: Clone doesn’t get inlined for Copy types in debug mode, so make it inline anyway.

source

fn is<T>() -> bool where
T: Scalar,

Tests if Self the same as the type T Read more

source

impl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,

source

pub fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more

source

pub fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).

source

pub fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.

source

pub fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

pub fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

pub fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

source

Struct statrs::distribution::Laplace

Implementations

impl Laplace

pub fn new(location: f64, scale: f64) -> Result<Laplace>

pub fn location(&self) -> f64

pub fn scale(&self) -> f64

Trait Implementations

impl Clone for Laplace

fn clone(&self) -> Laplace

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

impl Continuous<f64, f64> for Laplace

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

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

impl ContinuousCDF<f64, f64> for Laplace

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

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

impl Debug for Laplace

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

impl Distribution<f64> for Laplace

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

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

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

impl Distribution<f64> for Laplace

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

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

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

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

fn std_dev(&self) -> Option<T>

impl Max<f64> for Laplace

fn max(&self) -> f64

impl Median<f64> for Laplace

fn median(&self) -> f64

impl Min<f64> for Laplace

fn min(&self) -> f64

impl Mode<Option<f64>> for Laplace

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

impl PartialEq<Laplace> for Laplace

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

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

impl Copy for Laplace

impl StructuralPartialEq for Laplace

Auto Trait Implementations

impl RefUnwindSafe for Laplace

impl Send for Laplace

impl Sync for Laplace

impl Unpin for Laplace

impl UnwindSafe for Laplace

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

pub fn into(self) -> U

impl<T> Same<T> for T

type Output = T

impl<T> Scalar for T where T: Copy + PartialEq<T> + Debug + Any,

pub fn inlined_clone(&self) -> T

fn is<T>() -> bool where T: Scalar,

impl<SS, SP> SupersetOf<SS> for SP where SS: SubsetOf<SP>,

pub fn to_subset(&self) -> Option<SS>

pub fn is_in_subset(&self) -> bool

pub fn to_subset_unchecked(&self) -> SS

pub fn from_subset(element: &SS) -> SP

impl<T> ToOwned for T where T: Clone,

type Owned = T

pub fn to_owned(&self) -> T

pub fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for T where V: MultiLane<T>,

pub fn vzip(self) -> V

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

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

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> Scalar for T where
T: Copy + PartialEq<T> + Debug + Any,

fn is<T>() -> bool where
T: Scalar,

impl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,

impl<T> ToOwned for T where
T: Clone,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,