Struct Evolution 

pub struct Evolution<T: Individual> {
    pub metrics: Metrics,
    /* private fields */
}

This is the struct that does the evolution magic. It has the methods needed to start and iterate through the evolution.

Example:

// You can start the evolution with the `start` method:
evolution.start();

// and iterate through the evolution with the `next` method:
evolution.next();

// or you can run it until the stop condition is met with the `run` method:
evolution.run();

Fields

metrics: Metrics

Implementations

impl<T: Individual> Evolution<T>

pub fn new( title: String, config: EvolutionConfig<T>, fitness: Box<dyn Fitness<T>>, selection: Box<dyn Selection<T>>, crossover: Box<dyn Crossover<T>>, mutation: Box<dyn Mutation<T>>, elitism: u32, stop_condition: Arc<dyn Fn(f64, u32, u32) -> bool + Send + Sync>, ) -> Self

pub fn start(&mut self)

Starts the evolution, generating the initial population and calculating the fitness of each individual.

pub fn next(&mut self)

This method runs one generation of the evolution. It selects the mating pool, crossover, mutate and calculates the fitness of the new population.

pub fn run(&mut self)

This method runs the evolution, generation over generation, until the stop condition is met.

pub fn population_digest(&self)

pub fn time_digest(&self)

Prints total time and the time spent in each step of the evolution. In the following format:

------------ Time Digest ------------
Total time: X.XXXXs
Selection time: X.XXXXs (XX.XX%)
Crossover time: X.XXXXs (XX.XX%)
Mutation time: X.XXXXs (XX.XX%)
Fitness time: X.XXXXs (XX.XX%)
---------------------------------------

pub fn current_best(&self) -> &T

Returns the best individual of the current population.

pub fn current_population(&self) -> Vec<T>

Returns a copy of the current population sorted by fitness.

pub fn reached_stop_condition(&self) -> bool

Returns if the stop condition was already met for this evolution object.

pub fn current_best_fitness(&self) -> f64

pub fn current_fitness_average(&self) -> f64

pub fn plot_chart( &self, path: impl Into<String>, test_name: impl Into<String>, ) -> Result<(), Box<dyn Error>>