 All Implemented Interfaces:
Splittable<SelectionOperator>
,SelectionOperator
This implementation supports a constant temperature T, as well as two cooling schedules: linear cooling and exponential cooling. In both cases, at the start of the evolutionary algorithm, the temperature T is initialized to a t0. In linear cooling, at the end of each generation, T is updated according to: T = T  r. In exponential cooling, at the end of each generation, T is updated according to: T = r * T. In both cases, if T ever falls below some tMin, it is reset to tMin.
Unlike many other fitness proportional related selection operators, Boltzmann selection is applicable even if fitness values can be negative.
The runtime to select M population members from a population of size N is O(N + M lg N), assuming the bias function has a constant runtime.

Constructor Summary
ConstructorDescriptionBoltzmannSelection
(double t) Construct a Boltzmann selection operator with a constant temperature.BoltzmannSelection
(double t0, double tMin, double r, boolean linearCooling) Construct a Boltzmann selection operator, with either a linear cooling schedule or an exponential cooling schedule. 
Method Summary
Modifier and TypeMethodDescriptionvoid
init
(int generations) Perform any initialization necessary for the selection operator at the start of the run of the evolutionary algorithm.final void
select
(PopulationFitnessVector.Double fitnesses, int[] selected) Selects a set of members of the population based on fitness.final void
select
(PopulationFitnessVector.Integer fitnesses, int[] selected) Selects a set of members of the population based on fitness.split()
Generates a functionally identical copy of this object, for use in multithreaded implementations of search algorithms.

Constructor Details

BoltzmannSelection
public BoltzmannSelection(double t) Construct a Boltzmann selection operator with a constant temperature. Parameters:
t
 The temperature, which must be positive. Throws:
IllegalArgumentException
 if t is not positive

BoltzmannSelection
public BoltzmannSelection(double t0, double tMin, double r, boolean linearCooling) Construct a Boltzmann selection operator, with either a linear cooling schedule or an exponential cooling schedule. Parameters:
t0
 The initial temperature, which must be positive.tMin
 The minimum temperature. If an update would decrease temperature below tMin, it is set to tMin. Must be positive and no greater than t0.r
 The update value, which must be positive for linear cooling, and must be in (0.0, 1.0) for exponential cooling.linearCooling
 If true, uses a linear cooling schedule, and if false it uses an exponential cooling schedule. Throws:
IllegalArgumentException
 if tMin is not positive or if t0 is less than tMin or if linear cooling with nonpositive r or if exponential cooling with r not in (0,0, 1.0).


Method Details

init
public void init(int generations) Description copied from interface:SelectionOperator
Perform any initialization necessary for the selection operator at the start of the run of the evolutionary algorithm. This method is called by the evolutionary algorithm at the start of a run (i.e., whenever an EA's optimize or reoptimize methods are called. The default implementation of this method does nothing, which is appropriate for most selection operators since the behavior of most standard selection operators is doesn't change during runs. However, some selection operators may adjust behavior during the run, such as Boltzmann selection which adjusts a temperature parameter. The init method enables reinitializing such parameters at the start of runs. Parameters:
generations
 The number of generations for the run of the evolutionary algorithm about to commence.

split
Description copied from interface:Splittable
Generates a functionally identical copy of this object, for use in multithreaded implementations of search algorithms. The state of the object that is returned may or may not be identical to that of the original. Thus, this is a distinct concept from the functionality of theCopyable
interface. Classes that implement this interface must ensure that the object returned performs the same functionality, and that it does not share any state data that would be either unsafe or inefficient for concurrent access by multiple threads. The split method is allowed to simply return the this reference, provided that it is both safe and efficient for multiple threads to share a single copy of the Splittable object. The intention is to provide a multithreaded search with the capability to provide spawned threads with their own distinct search operators. Such multithreaded algorithms can call the split method for each thread it spawns to generate a functionally identical copy of the operator, but with independent state. Specified by:
split
in interfaceSplittable<SelectionOperator>
 Overrides:
split
in classBiasedFitnessProportionalSelection
 Returns:
 A functionally identical copy of the object, or a reference to this if it is both safe and efficient for multiple threads to share a single instance of this Splittable object.

select
Description copied from interface:SelectionOperator
Selects a set of members of the population based on fitness. Implementations should ensure that the array of indexes of population members is in a random order. For some selection operators, this required behavior is met by definition (e.g., the common fitness proportionate selection will have this behavior as is). But other selection operators may require randomizing the array of indexes after selection. For example, the obvious implementation of stochastic universal sampling will likely have all copies of an individual population member ordered together, and thus will require a shuffling of the array before returning. Specified by:
select
in interfaceSelectionOperator
 Parameters:
fitnesses
 A vector of fitnesses of the members of the population.selected
 An array for the result. The selection operator should select selected.length members of the population based on fitnesses, populating selected with the indexes of the chosen members. Note that selected.length may be different than the fitnesses.size().

select
Description copied from interface:SelectionOperator
Selects a set of members of the population based on fitness. Implementations should ensure that the array of indexes of population members is in a random order. For some selection operators, this required behavior is met by definition (e.g., the common fitness proportionate selection will have this behavior as is). But other selection operators may require randomizing the array of indexes after selection. For example, the obvious implementation of stochastic universal sampling will likely have all copies of an individual population member ordered together, and thus will require a shuffling of the array before returning. Specified by:
select
in interfaceSelectionOperator
 Parameters:
fitnesses
 A vector of fitnesses of the members of the population.selected
 An array for the result. The selection operator should select selected.length members of the population based on fitnesses, populating selected with the indexes of the chosen members. Note that selected.length may be different than the fitnesses.size().
