fr.cnes.sirius.patrius.math.genetics

Class ListPopulation

java.lang.Object

fr.cnes.sirius.patrius.math.genetics.ListPopulation

All Implemented Interfaces:

Population, Iterable<Chromosome>

Direct Known Subclasses:

ElitisticListPopulation

public abstract class ListPopulation
extends Object
implements Population

Population of chromosomes represented by a List.

Since:

2.0

Version:

$Id: ListPopulation.java 18108 2017-10-04 06:45:27Z bignon $

Constructor Summary

Constructors

Constructor and Description
ListPopulation(int populationLimitIn) Creates a new ListPopulation instance and initializes its inner chromosome list.
ListPopulation(List<Chromosome> chromosomesIn, int populationLimitIn) Creates a new ListPopulation instance.

Method Summary

Modifier and Type	Method and Description
void	addChromosome(Chromosome chromosome) Add the given chromosome to the population.
void	addChromosomes(Collection<Chromosome> chromosomeColl) Add a Collection of chromosomes to this Population.
protected List<Chromosome>	getChromosomeList() Access the list of chromosomes.
List<Chromosome>	getChromosomes() Returns an unmodifiable list of the chromosomes in this population.
Chromosome	getFittestChromosome() Access the fittest chromosome in this population.
int	getPopulationLimit() Access the maximum population size.
int	getPopulationSize() Access the current population size.
Iterator<Chromosome>	iterator() Returns an iterator over the unmodifiable list of chromosomes.
void	setPopulationLimit(int populationLimitIn) Sets the maximal population size.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface fr.cnes.sirius.patrius.math.genetics.Population

nextGeneration

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

ListPopulation

public ListPopulation(int populationLimitIn)

Creates a new ListPopulation instance and initializes its inner chromosome list.

Parameters:

populationLimitIn - maximal size of the population

Throws:

NotPositiveException - if the population limit is not a positive number (< 1)

ListPopulation

public ListPopulation(List<Chromosome> chromosomesIn,
                      int populationLimitIn)

Creates a new ListPopulation instance.

Note: the chromosomes of the specified list are added to the population.

Parameters:

chromosomesIn - list of chromosomes to be added to the population

populationLimitIn - maximal size of the population

Throws:

NullArgumentException - if the list of chromosomes is null

NotPositiveException - if the population limit is not a positive number (< 1)

NumberIsTooLargeException - if the list of chromosomes exceeds the population limit

Method Detail

addChromosomes

public void addChromosomes(Collection<Chromosome> chromosomeColl)

Add a Collection of chromosomes to this Population.

Parameters:

chromosomeColl - a Collection of chromosomes

Throws:

NumberIsTooLargeException - if the population would exceed the population limit when adding this chromosome

Since:

3.1

getChromosomes

public List<Chromosome> getChromosomes()

Returns an unmodifiable list of the chromosomes in this population.

Returns:

the unmodifiable list of chromosomes

getChromosomeList

protected List<Chromosome> getChromosomeList()

Access the list of chromosomes.

Returns:

the list of chromosomes

Since:

3.1

addChromosome

public void addChromosome(Chromosome chromosome)

Add the given chromosome to the population.

Specified by:

addChromosome in interface Population

Parameters:

chromosome - the chromosome to add.

Throws:

NumberIsTooLargeException - if the population would exceed the populationLimit after adding this chromosome

getFittestChromosome

public Chromosome getFittestChromosome()

Access the fittest chromosome in this population.

Specified by:

getFittestChromosome in interface Population

Returns:

the fittest chromosome.

getPopulationLimit

public int getPopulationLimit()

Access the maximum population size.

Specified by:

getPopulationLimit in interface Population

Returns:

the maximum population size.

setPopulationLimit

public void setPopulationLimit(int populationLimitIn)

Sets the maximal population size.

Parameters:

populationLimitIn - maximal population size.

Throws:

NotPositiveException - if the population limit is not a positive number (< 1)

NumberIsTooSmallException - if the new population size is smaller than the current number of chromosomes in the population

getPopulationSize

public int getPopulationSize()

Access the current population size.

Specified by:

getPopulationSize in interface Population

Returns:

the current population size.

toString

public String toString()

Overrides:

toString in class Object

iterator

public Iterator<Chromosome> iterator()

Returns an iterator over the unmodifiable list of chromosomes.

Any call to Iterator.remove() will result in a UnsupportedOperationException.

Specified by:

iterator in interface Iterable<Chromosome>

Returns:

chromosome iterator