Struct rand_distr::Hypergeometric

pub struct Hypergeometric { /* fields omitted */ }

The hypergeometric distribution Hypergeometric(N, K, n).

This is the distribution of successes in samples of size n drawn without replacement from a population of size N containing K success states. It has the density function: f(k) = binomial(K, k) * binomial(N-K, n-k) / binomial(N, n), where binomial(a, b) = a! / (b! * (a - b)!).

The binomial distribution is the analagous distribution for sampling with replacement. It is a good approximation when the population size is much larger than the sample size.

Example

use rand_distr::{Distribution, Hypergeometric};

let hypergeo = Hypergeometric::new(60, 24, 7).unwrap();
let v = hypergeo.sample(&mut rand::thread_rng());
println!("{} is from a hypergeometric distribution", v);

Implementations

impl Hypergeometric

pub fn new(
    total_population_size: u64,
    population_with_feature: u64,
    sample_size: u64
) -> Result<Self, Error>

Constructs a new Hypergeometric with the shape parameters N = total_population_size, K = population_with_feature, n = sample_size.

Trait Implementations

impl Clone for Hypergeometric

pub fn clone(&self) -> Hypergeometric

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Hypergeometric

impl Debug for Hypergeometric

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

Formats the value using the given formatter.

impl Distribution<u64> for Hypergeometric

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

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

pub 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.