petri 0.0.4

Evolutionary computing toolkit
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


use genomes::Sequence;

use rand::Rng;

/// Operator for selecting genomes out of a population
pub trait SelectOperator<G, O>
where
    G: Sequence,
    O: Clone + Ord,
{
    // TODO(will): make this operate in place
    // TODO(will): have this return meaningful data about its operation
    /// Select k genomes from a population
    fn select<R: Rng>(
        &self,
        population: &Vec<(O, G)>,
        k: usize,
        rng: &mut R,
    ) -> Vec<G>;
}

/// Operator for mutating a genome
pub trait MutateOperator<G>
where
    G: Sequence,
{
    // TODO(will), make operator work in place
    // TODO(will): Make this return "number of mutations(usize)"
    /// Mutate an indiviudal
    fn mutate<R: Rng>(&self, indv: &G, rng: &mut R) -> G;
}

/// Operator for crossing two genomes to crate offspring
pub trait CrossoverOperator<G>
where
    G: Sequence,
{
    // TODO(will): make this operator work in place
    // TODO(will): Make this return meaningful information after doing above
    /// Cross two genomes to produce two children
    fn crossover<R: Rng>(&self, g1: &G, g2: &G, rng: &mut R) -> (G, G);
}