fr.cnes.sirius.patrius.math.genetics

Class ElitisticListPopulation

java.lang.Object

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

fr.cnes.sirius.patrius.math.genetics.ElitisticListPopulation

All Implemented Interfaces:

Population, Iterable<Chromosome>

public class ElitisticListPopulation
extends ListPopulation

Population of chromosomes which uses elitism (certain percentage of the best chromosomes is directly copied to the next generation).

Since:

2.0

Version:

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

Constructor Summary

Constructors

Constructor and Description
ElitisticListPopulation(int populationLimit, double elitismRateIn) Creates a new ElitisticListPopulation instance and initializes its inner chromosome list.
ElitisticListPopulation(List<Chromosome> chromosomes, int populationLimit, double elitismRateIn) Creates a new ElitisticListPopulation instance.

Method Summary

Modifier and Type	Method and Description
double	getElitismRate() Access the elitism rate.
Population	nextGeneration() Start the population for the next generation.
void	setElitismRate(double elitismRateIn) Sets the elitism rate, i.e. how many best chromosomes will be directly transferred to the next generation [in %].

Methods inherited from class fr.cnes.sirius.patrius.math.genetics.ListPopulation

addChromosome, addChromosomes, getChromosomeList, getChromosomes, getFittestChromosome, getPopulationLimit, getPopulationSize, iterator, setPopulationLimit, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

ElitisticListPopulation

public ElitisticListPopulation(List<Chromosome> chromosomes,
                               int populationLimit,
                               double elitismRateIn)

Creates a new ElitisticListPopulation instance.

Parameters:

chromosomes - list of chromosomes in the population

populationLimit - maximal size of the population

elitismRateIn - how many best chromosomes will be directly transferred to the next generation [in %]

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

OutOfRangeException - if the elitism rate is outside the [0, 1] range

ElitisticListPopulation

public ElitisticListPopulation(int populationLimit,
                               double elitismRateIn)

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

Parameters:

populationLimit - maximal size of the population

elitismRateIn - how many best chromosomes will be directly transferred to the next generation [in %]

Throws:

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

OutOfRangeException - if the elitism rate is outside the [0, 1] range

Method Detail

nextGeneration

public Population nextGeneration()

Start the population for the next generation. The elitismRate percents of the best chromosomes are directly copied to the next generation.

Returns:

the beginnings of the next generation.

setElitismRate

public void setElitismRate(double elitismRateIn)

Sets the elitism rate, i.e. how many best chromosomes will be directly transferred to the next generation [in %].

Parameters:

elitismRateIn - how many best chromosomes will be directly transferred to the next generation [in %]

Throws:

OutOfRangeException - if the elitism rate is outside the [0, 1] range

getElitismRate

public double getElitismRate()

Access the elitism rate.

Returns:

the elitism rate