NAME

Algorithm::MasterMind::Generational_Partitions - Skeleton class for generational population based algorithms, such as EDAs or EAs.

SYNOPSIS

    use Algorithm::MasterMind::Generational_Partitions;
    my $secret_code = 'EAFC';
    my $population_size = 200;
    my @alphabet = qw( A B C D E F );
    my $solver = new Algorithm::MasterMind::Generational_Partitions { alphabet => \@alphabet,
						length => length( $secret_code ),
						  pop_size => $population_size};
  
    #The rest, same as the other solvers

DESCRIPTION

Uses Algorithm::Evolutionary instance of EDAs to solve MM; as there are two different fitness functions you can use; probably fitness_orig works better.

INTERFACE

initialize

Performs bookkeeping, and assigns flags depending on the initialization values

new ( $options )

This function, and all the rest, are directly inherited from base

issue_next()

Issues the next combination

feedback()

Obtain the result to the last combination played

guesses()

Total number of guesses

evaluated()

Total number of combinations checked to issue result

number_of_rules ()

Returns the number of rules in the algorithm

rules()

Returns the rules (combinations, blacks, whites played so far) y a reference to array

matches( $string )

Returns a hash with the number of matches, and whether it matches every rule with the number of blacks and whites it obtains with each of them

fitness( $individual )

Computes fitness summing the number of correct black and whites plus the number of rules the combination meets times the length

fitness_orig( $individual )

Fitness proposed in the Applied and Soft Computing paper, difference between the number of blacks/whites obtained by rules against the secret code and by the combination against the combination in the rule.

SEE ALSO

Other solvers: Algorithm::MasterMind::Sequential and Algorithm::MasterMind::Random. Don't work as well, really.

AUTHOR

JJ Merelo <jj@merelo.net>

LICENCE AND COPYRIGHT

Copyright (c) 2009, JJ Merelo <jj@merelo.net>. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

DISCLAIMER OF WARRANTY

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.