NAME

Algorithm::Evolutionary::Run - Class for setting up an experiment with algorithms and population

SYNOPSIS

use Algorithm::Evolutionary::Run;

my $algorithm = new Algorithm::Evolutionary::Run 'conf.yaml';
#or
my $conf = {
  'fitness' => {
    'class' => 'MMDP'
  },
  'crossover' => {
    'priority' => '3',
    'points' => '2'
   },
  'max_generations' => '1000',
  'mutation' => {
    'priority' => '2',
    'rate' => '0.1'
  },
  'length' => '120',
  'max_fitness' => '20',
  'pop_size' => '1024',
  'selection_rate' => '0.1'
};

my $algorithm = new Algorithm::Evolutionary::Run $conf;

#Run it to the end
$algorithm->run();

#Print results
$algorithm->results();

#A single step
$algorithm->step();

DESCRIPTION

This is a no-fuss class to have everything needed to run an algorithm in a single place, although for the time being it's reduced to fitness functions in the A::E::F namespace, and binary strings. Mostly for demo purposes, but can be an example of class for other stuff.

METHODS

new( $algorithm_description )

Creates the whole stuff needed to run an algorithm. Can be called from a hash with t options, as per the example. All of them are compulsory. See also the examples subdir for examples of the YAML conf file.

population_size( $new_size )

Resets the population size to the $new_size. It does not do anything to the actual population, just resests the number. You should do a reset_population afterwards.

reset_population()

Resets population, creating a new one; resets fitness counter to 0

step()

Runs a single step of the algorithm, that is, a single generation

run()

Applies the different operators in the order that they appear; returns the population as a ref-to-array.

random_member()

Returns a random guy from the population

results()

Returns results in a hash that contains the best, total time so far and the number of evaluations.

evaluated_population()

Returns the portion of population that has been evaluated (all but the new ones)

compute_average_distance( $individual )

Computes the average hamming distance to the population

compute_min_distance( $individual )

Computes the average hamming distance to the population

Copyright

This file is released under the GPL. See the LICENSE file included in this distribution,
or go to http://www.fsf.org/licenses/gpl.txt

CVS Info: $Date: 2010/03/16 18:39:40 $ 
$Header: /cvsroot/opeal/Algorithm-Evolutionary/lib/Algorithm/Evolutionary/Run.pm,v 3.2 2010/03/16 18:39:40 jmerelo Exp $ 
$Author: jmerelo $ 
$Revision: 3.2 $
$Name $