org.dishevelled.evolve
Interface EvolutionaryAlgorithm<I>

Type Parameters:

I - individual type

All Known Implementing Classes:

EvolutionaryAlgorithmImpl

public interface EvolutionaryAlgorithm<I>

An evolutionary algorithm function.

Version:

$Revision: 1059 $ $Date: 2012-01-03 14:03:02 -0600 (Tue, 03 Jan 2012) $

Author:

Michael Heuer

Method Summary

void	addEvolutionaryAlgorithmListener(EvolutionaryAlgorithmListener<I> l) Add the specified evolutionary algorithm listener.
Collection<I>	evolve(Collection<I> individuals, ExitStrategy<I> exitStrategy, Recombination<I> recombination, Mutation<I> mutation, Fitness<I> fitness, Selection<I> selection) Evolve the specified population of individuals, using all of the specified exit strategy, recombination, mutation, fitness, and selection functions.
int	getEvolutionaryAlgorithmListenerCount() Return the number of evolutionary algorithm listeners registered to this evolutionary algorithm.
EvolutionaryAlgorithmListener<I>[]	getEvolutionaryAlgorithmListeners() Return an array of evolutionary algorithm listeners registered to this evolutionary algorithm.
void	removeEvolutionaryAlgorithmListener(EvolutionaryAlgorithmListener<I> l) Remove the specified evolutionary algorithm listener.

Method Detail

evolve

Collection<I> evolve(Collection<I> individuals,
                     ExitStrategy<I> exitStrategy,
                     Recombination<I> recombination,
                     Mutation<I> mutation,
                     Fitness<I> fitness,
                     Selection<I> selection)

Evolve the specified population of individuals, using all of the specified exit strategy, recombination, mutation, fitness, and selection functions.

Parameters:

individuals - population of individuals, must not be null and must contain at least one individual

exitStrategy - exit strategy function, must not be null

recombination - recombination function, must not be null

mutation - mutation function, must not be null

fitness - fitness function, must not be null

selection - selection function, must not be null

Returns:

evolved population of individuals that passes the conditions of the specified exit strategy

addEvolutionaryAlgorithmListener

void addEvolutionaryAlgorithmListener(EvolutionaryAlgorithmListener<I> l)

Add the specified evolutionary algorithm listener.

Parameters:

l - evolutionary algorithm listener to add

removeEvolutionaryAlgorithmListener

void removeEvolutionaryAlgorithmListener(EvolutionaryAlgorithmListener<I> l)

Remove the specified evolutionary algorithm listener.

Parameters:

l - evolutionary algorithm listener to remove

getEvolutionaryAlgorithmListenerCount

int getEvolutionaryAlgorithmListenerCount()

Return the number of evolutionary algorithm listeners registered to this evolutionary algorithm.

Returns:

the number of evolutionary algorithm listeners registered to this evolutionary algorithm

getEvolutionaryAlgorithmListeners

EvolutionaryAlgorithmListener<I>[] getEvolutionaryAlgorithmListeners()

Return an array of evolutionary algorithm listeners registered to this evolutionary algorithm.

Returns:

an array of evolutionary algorithm listeners registered to this evolutionary algorithm