Struct Sampler

pub struct Sampler { /* private fields */ }

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));

Implementations

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 duplicate 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, Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness.

fn map<F, S>(self, func: F) -> DistMap<Self, F, T, S>

where F: Fn(T) -> S, Self: Sized,

Create a distribution of values of ‘S’ by mapping the output of Self through the closure F