antbox-state 0.1.0

The logical state of the `antbox` cellular automaton / artificial life toy.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use antbox_cellauto::{Cell, ConwaysLife, Generation};
use antbox_geom::Bounds;
use clap::Args;
use derive_more::{From, Into};
use derive_new::new;
use rand::distr::Distribution;
use rand::rngs::StdRng;
use rand::{Rng, SeedableRng as _};

use crate::State;

/// A [Distribution] for generating a [State]
#[derive(Args, Copy, Clone, Debug, From, Into, new)]
pub struct GenParams {
    #[clap(long, default_value = "0", help_heading = "Generation Parameters")]
    seed: u64,
    #[clap(long, default_value = "0.7", help_heading = "Generation Parameters")]
    cell_prob: f64,
    #[clap(long, default_value = "70x40", help_heading = "Generation Parameters")]
    grid_size: Bounds,
}

impl GenParams {
    /// Generate the initial state from the parameters
    pub fn generate_state(self) -> State {
        let mut rng = StdRng::seed_from_u64(self.seed);
        self.sample(&mut rng)
    }
}

impl Distribution<State> for GenParams {
    fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> State {
        State::new(0, self.sample(rng))
    }
}

impl Distribution<ConwaysLife> for GenParams {
    fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> ConwaysLife {
        let g: Generation = self.sample(rng);
        ConwaysLife::new(g)
    }
}

impl Distribution<Generation> for GenParams {
    fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> Generation {
        let area = self.grid_size.area();
        let mut cells = Vec::with_capacity(area);
        for _ in 0..area {
            cells.push(self.sample(rng));
        }

        Generation::new(self.grid_size, cells)
    }
}

impl Distribution<Cell> for GenParams {
    fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> Cell {
        Cell::from(rng.random_bool(self.cell_prob))
    }
}