Struct BinomialSampler 

pub struct BinomialSampler { /* private fields */ }

Enables sampling a Z according to the binomial distribution Bin(n, p).

Attributes:

• distr: defines the binomial distribution with parameters n and p to sample from
• rng: defines the ThreadRng that’s used to sample from distr

Examples

use qfall_math::utils::sample::binomial::BinomialSampler;
let n = 2;
let p = 0.5;

let mut bin_sampler = BinomialSampler::init(n, p).unwrap();

let sample = bin_sampler.sample();

assert!(0 <= sample);
assert!(sample <= n);

Implementations

impl BinomialSampler

pub fn init(n: impl Into<Z>, p: impl Into<Q>) -> Result<Self, MathError>

Initializes the BinomialSampler with

• distr as the binomial distribution with n tries and success probability p for each try, and
• rng as a fresh ThreadRng.

Parameters:

• n: specifies the number of tries
• p: specifies the success probability

Returns a BinomialSampler or a MathError if n < 0, p ∉ (0,1), or n does not fit into an i64.

Examples

use qfall_math::utils::sample::binomial::BinomialSampler;
let n = 2;
let p = 0.5;

let mut bin_sampler = BinomialSampler::init(n, p).unwrap();

Errors and Failures

• Returns a MathError of type InvalidIntegerInput if n < 0.
• Returns a MathError of type InvalidInterval if p ∉ (0,1).
• Returns a MathError of type ConversionError if n does not fit into an i64.

pub fn sample(&mut self) -> Z

Samples a Z according to the binomial distribution Bin(n, p).

Examples

use qfall_math::utils::sample::binomial::BinomialSampler;
let n = 2;
let p = 0.5;

let mut bin_sampler = BinomialSampler::init(n, p).unwrap();

let sample = bin_sampler.sample();

assert!(0 <= sample);
assert!(sample <= n);