Struct set_genome::GenomeRng

pub struct GenomeRng { /* fields omitted */ }

This struct serves as the randomness source for all operations.

Implementations

impl GenomeRng

pub fn new(seed: u64, std_dev: f64, cap: f64) -> Self

Creates a GenomeRng.

seed is specified for reproducibility of experiments. std_dev configures the standard deviation of the normal distribution from which the weight perturbations are sampled. cap specifies the upper and lower bound of values returned from GenomeRng::weight_perturbation.

use set_genome::GenomeRng;
let genome_rng = GenomeRng::new(42, 0.1, 1.0);

pub fn gamble(&mut self, chance: f64) -> bool

Returns true chance percent of the time.

// a coin flip
if genome_rng.gamble(0.5) {
    println!("heads")
} else {
    println!("tails")
}

// the following always happens, gambling with 100% chance to succeed
assert!(genome_rng.gamble(1.0), "I should always win!");

pub fn weight_perturbation(&mut self, weight: f64) -> f64

Returns the weight altered by some random value.

let mut genome_rng = GenomeRng::new(42, 0.1, 1.0);
// random_weight will probably be some small value,
// definitely not bigger than 1.0 or smaller than -1.0.
let random_weight = genome_rng.weight_perturbation(0.0);

Trait Implementations

impl Debug for GenomeRng

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

Formats the value using the given formatter.

impl RngCore for GenomeRng

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

fn fill_bytes(&mut self, dest: &mut [u8])

Fill dest with random data.

fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>

Fill dest entirely with random data.