kgal-core/kgal.panmictic/PanmicticPopulation

PanmicticPopulation

interface PanmicticPopulation<V, F> : Population<V, F>

PanmicticPopulation - specific Population of PanmicticGA based on Array of Chromosome.

V - value of Chromosome

F - fitness value of Chromosome

This population supports:

elitism, see PanmicticConfig.elitism
dynamic change size, see PanmicticEvolveScope.resize. Changing size usually used if the evolutionary strategy involves increasing the population size, see buffer.

Structure of population with PanmicticGA.elitism = 2, size = 9 and buffer = 7:

| EC | EC | C | C | C | C | C | C | C | size ? | ? | ? | ? | ? | ? | ? | maxSize

EC - elite active chromosome

C - active chromosome

? - free space with generated not active chromosome (Be accurate these chromosome can be not evaluated, that's why they '?').

Creates with population functions.

See also

Properties

val <V, F> Population<V, F>.best: Chromosome<V, F>?

The best Chromosome in Population by fitness.

abstract val buffer: Int

The amount of reserved space in a population. Can be immutable for PanmicticPopulation see PanmicticEvolveScope.resize. Usually used if the evolutionary strategy involves increasing the population size.

abstract var factory: PopulationFactory<V, F>

PopulationFactory for this population. Creates new Chromosome.

val Population<*, *>.indices: IntRange

Return indices range for Population

abstract val initialized: Boolean

True if population is initialized and ready to evolve.

val Population<*, *>.lastIndex: Int

abstract val maxSize: Int

Maximum population size: size + buffer

abstract val name: String

Name of population, default value = DEFAULT_POPULATION_NAME

abstract override val size: Int

Current size of population. Can be immutable for PanmicticPopulation see PanmicticEvolveScope.resize.

val <V, F> Population<V, F>.worst: Chromosome<V, F>?

The worst Chromosome in Population by fitness.

Functions

abstract override fun clone(newName: String): PanmicticPopulation<V, F>

Override clone method to return PanmicticPopulation

inline fun <V, F> Population<V, F>.cloneOf(index: Int): Chromosome<V, F>

Return clone of Chromosome with index in Population

abstract fun copyOf(): Array<Chromosome<V, F>>

Creates array with chromosomes copied from Population.

inline fun <V, F> Population<V, F>.copyOfRange(fromIndex: Int, toIndex: Int): Array<Chromosome<V, F>>

Creates copy of Population as an array by range

abstract operator fun get(index: Int): Chromosome<V, F>

Get Chromosome by index

abstract fun get(): Array<Chromosome<V, F>>

Get population as an array.

inline fun Population<*, *>.isEmpty(): Boolean

Returns true if the population is empty (contains no chromosomes), false otherwise.

abstract operator fun iterator(): Iterator<Chromosome<V, F>>

randomWithIndices

inline fun <V, F> Population<V, F>.randomWithIndices(count: Int, random: Random): Pair<Array<Chromosome<V, F>>, IntArray>

Creates Array with randomly selected chromosomes from source array

inline fun <V, F> Population<V, F>.reset(random: Random, start: Int = 0, end: Int = size)

Reset population with factory.

abstract fun resize(newSize: Int? = null, newBuffer: Int? = null)

Set new sizes of population.

abstract operator fun set(index: Int, chromosome: Chromosome<V, F>)

Set Chromosome with index

abstract fun set(population: Array<Chromosome<V, F>>)

Set new population.

abstract fun sort(ascending: Boolean = false): Array<Chromosome<V, F>>

Sort population (Chromosome is Comparable) in descending order by default.