# Struct rand_distr::LogNormal

source · ```
pub struct LogNormal<F>where
F: Float,
StandardNormal: Distribution<F>,{ /* private fields */ }
```

## Expand description

The log-normal distribution `ln N(mean, std_dev**2)`

.

If `X`

is log-normal distributed, then `ln(X)`

is `N(mean, std_dev**2)`

distributed.

## Example

```
use rand_distr::{LogNormal, Distribution};
// mean 2, standard deviation 3
let log_normal = LogNormal::new(2.0, 3.0).unwrap();
let v = log_normal.sample(&mut rand::thread_rng());
println!("{} is from an ln N(2, 9) distribution", v)
```

## Implementations§

source§### impl<F> LogNormal<F>where
F: Float,
StandardNormal: Distribution<F>,

### impl<F> LogNormal<F>where F: Float, StandardNormal: Distribution<F>,

source#### pub fn new(mu: F, sigma: F) -> Result<LogNormal<F>, Error>

#### pub fn new(mu: F, sigma: F) -> Result<LogNormal<F>, Error>

Construct, from (log-space) mean and standard deviation

Parameters are the “standard” log-space measures (these are the mean and standard deviation of the logarithm of samples):

`mu`

(`μ`

, unrestricted) is the mean of the underlying distribution`sigma`

(`σ`

, must be finite) is the standard deviation of the underlying Normal distribution

source#### pub fn from_mean_cv(mean: F, cv: F) -> Result<LogNormal<F>, Error>

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

Construct, from (linear-space) mean and coefficient of variation

Parameters are linear-space measures:

- mean (
`μ > 0`

) is the (real) mean of the distribution - coefficient of variation (
`cv = σ / μ`

, requiring`cv ≥ 0`

) is a standardized measure of dispersion

As a special exception, `μ = 0, cv = 0`

is allowed (samples are `-inf`

).

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

#### 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 = LogNormal::from_mean_cv(3.0, 1.0).unwrap().from_zscore(z);
let x2 = LogNormal::from_mean_cv(2.0, 4.0).unwrap().from_zscore(z);
```

## Trait Implementations§

source§### impl<F> Clone for LogNormal<F>where
F: Float + Clone,
StandardNormal: Distribution<F>,

### impl<F> Clone for LogNormal<F>where F: Float + Clone, StandardNormal: Distribution<F>,

source§### impl<F> Debug for LogNormal<F>where
F: Float + Debug,
StandardNormal: Distribution<F>,

### impl<F> Debug for LogNormal<F>where F: Float + Debug, StandardNormal: Distribution<F>,

source§### impl<'de, F> Deserialize<'de> for LogNormal<F>where
F: Float + Deserialize<'de>,
StandardNormal: Distribution<F>,

### impl<'de, F> Deserialize<'de> for LogNormal<F>where F: Float + Deserialize<'de>, StandardNormal: Distribution<F>,

source§#### fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,

#### fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

source§### impl<F> Distribution<F> for LogNormal<F>where
F: Float,
StandardNormal: Distribution<F>,

### impl<F> Distribution<F> for LogNormal<F>where F: Float, StandardNormal: Distribution<F>,

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

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

Generate a random value of

`T`

, using `rng`

as the source of randomness.source§### impl<F> PartialEq<LogNormal<F>> for LogNormal<F>where
F: Float + PartialEq,
StandardNormal: Distribution<F>,

### impl<F> PartialEq<LogNormal<F>> for LogNormal<F>where F: Float + PartialEq, StandardNormal: Distribution<F>,

source§### impl<F> Serialize for LogNormal<F>where
F: Float + Serialize,
StandardNormal: Distribution<F>,

### impl<F> Serialize for LogNormal<F>where F: Float + Serialize, StandardNormal: Distribution<F>,

### impl<F> Copy for LogNormal<F>where F: Float + Copy, StandardNormal: Distribution<F>,

### impl<F> StructuralPartialEq for LogNormal<F>where F: Float, StandardNormal: Distribution<F>,

## Auto Trait Implementations§

### impl<F> RefUnwindSafe for LogNormal<F>where F: RefUnwindSafe,

### impl<F> Send for LogNormal<F>where F: Send,

### impl<F> Sync for LogNormal<F>where F: Sync,

### impl<F> Unpin for LogNormal<F>where F: Unpin,

### impl<F> UnwindSafe for LogNormal<F>where F: UnwindSafe,

## Blanket Implementations§

source§### impl<T> BorrowMut<T> for Twhere
T: ?Sized,

### impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§#### fn borrow_mut(&mut self) -> &mut T

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

Mutably borrows from an owned value. Read more