Struct histogram_sampler::Sampler

pub struct Sampler { /* fields omitted */ }

Used to sample values according to a histogram distribution.

See crate-level docs for details.

Use like:

let original_data = vec![
    (bin, count),
];
let sampler = Sampler::from_bins(original_data, 10 /* bin width */);

let mut rng = rand::thread_rng();
use rand::distributions::Distribution;
println!("{}", sampler.sample(&mut rng));

Methods

impl Sampler

pub fn nvalues(&self) -> usize

Report the number of distinct values that can be produced.

Produced samples are guaranteed to be in the range 0..self.nvalues().

pub fn from_bins<I>(iter: I, bin_width: usize) -> Self where
    I: IntoIterator<Item = (usize, usize)>, 

Create a new Sampler from the given input histogram where the bin width is bin_width.

Trait Implementations

impl Clone for Sampler

fn clone(&self) -> Sampler

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Sampler

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

Formats the value using the given formatter.

impl Distribution<usize> for Sampler

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

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

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.