Struct rand_distr::Zipf

source ·
pub struct Zipf<F>where
    F: Float,
    Standard: Distribution<F>,
{ /* private fields */ }
Expand description

Samples integers according to the Zipf distribution.

The samples follow Zipf’s law: The frequency of each sample from a finite set of size n is inversely proportional to a power of its frequency rank (with exponent s).

For large n, this converges to the Zeta distribution.

For s = 0, this becomes a uniform distribution.

Example

use rand::prelude::*;
use rand_distr::Zipf;

let val: f64 = thread_rng().sample(Zipf::new(10, 1.5).unwrap());
println!("{}", val);

Implementation details

Implemented via rejection sampling, due to Jason Crease1.

Implementations

Construct a new Zipf distribution for a set with n elements and a frequency rank exponent s.

For large n, rounding may occur to fit the number into the float type.

Trait Implementations

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Generate a random value of T, using rng as the source of randomness.
Create an iterator that generates random values of T, using rng as the source of randomness. Read more
Create a distribution of values of ‘S’ by mapping the output of Self through the closure F Read more
This method tests for self and other values to be equal, and is used by ==. Read more
This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

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

The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.