public class InterPopulationExchange extends Exchanger
InterPopulationExchange has a topology which is similar to the one used by IslandExchange. Every few generations, a subpopulation will send some number of individuals to other subpopulations. Since all subpopulations evolve at the same generational speed, this is a synchronous procedure (IslandExchange instead is asynchronous by default, though you can change it to synchronous).
Individuals are sent from a subpopulation prior to breeding. They are stored in a waiting area until after all subpopulations have bred; thereafter they are added into the new subpopulation. This means that the subpopulation order doesn't matter. Also note that it means that some individuals will be created during breeding, and immediately killed to make way for the migrants. A little wasteful, we know, but it's simpler that way.
Parameters
base.chatty boolean, default = true |
Should we be verbose or silent about our exchanges? |
Note: For each subpopulation in your population, there must be one exch.subpop... declaration set.
base.subpop.n.select classname, inherits and != ec.SelectionMethod |
The selection method used by subpopulation #n for picking migrants to emigrate to other subpopulations. If not set, uses the default parameter below. |
base.select classname, inherits and != ec.SelectionMethod |
server: Default parameter: the selection method used by a given subpopulation for picking migrants to emigrate to other subpopulations. |
base.subpop.n.select-to-die classname, inherits and != ec.SelectionMethod (Default is random selection) |
The selection method used by subpopulation #n for picking individuals to be replaced by migrants. If not set, uses the default parameter below. |
base.select-to-die classname, inherits and != ec.SelectionMethod (Default is random selection) |
server: Default parameter: the selection method used by a given subpopulation for picking individuals to be replaced by migrants. |
base.subpop.n.mod int >= 1 |
The number of generations that subpopulation #n waits between sending emigrants. If not set, uses the default parameter below. |
base.mod int >= 1 |
server: Default parameter: the number of generations that a given subpopulation waits between sending emigrants. |
base.subpop.n.start int >= 0 |
The generation when subpopulation #n begins sending emigrants. If not set, uses the default parameter below. |
base.start int >= 0 |
server: Default parameter: the generation when a given subpopulation begins sending emigrants. |
base.subpop.n.size int >= 0 |
The number of emigrants sent at one time by generation #n. If not set, uses the default parameter below. |
base.subpop.n.num-dest int >= 0 |
The number of destination subpopulations for this subpopulation. |
base.subpop.n.dest.m int >= 0 |
Subpopulation #n's destination #m is this subpopulation. |
Parameter bases
base.subpop.n.select | selection method for subpopulation #n's migrants |
Modifier and Type | Field and Description |
---|---|
Parameter |
base
My parameter base -- I need to keep this in order to help the server
reinitialize contacts
|
boolean |
chatty |
static java.lang.String |
P_CHATTY
Whether or not we're chatty
|
static java.lang.String |
P_DEST
The prefix for destinations
|
static java.lang.String |
P_DEST_FOR_SUBPOP
The number of destinations from current island
|
static java.lang.String |
P_MODULO
The parameter for the modulo (how many generations should pass between consecutive sendings of individuals
|
static java.lang.String |
P_OFFSET
How many generations to pass at the beginning of the evolution before the first
emigration from the current subpopulation
|
static java.lang.String |
P_SELECT_METHOD
The selection method for sending individuals to other islands
|
static java.lang.String |
P_SELECT_TO_DIE_METHOD
The selection method for deciding individuals to be replaced by immigrants
|
static java.lang.String |
P_SIZE
The number of emigrants to be sent
|
static java.lang.String |
P_SUBPOP
The subpopulation delimiter
|
Constructor and Description |
---|
InterPopulationExchange() |
Modifier and Type | Method and Description |
---|---|
void |
closeContacts(EvolutionState state,
int result)
Closes contacts with other processes, if that's what you're doing.
|
void |
initializeContacts(EvolutionState state)
Initializes contacts with other processes, if that's what you're doing.
|
Population |
postBreedingExchangePopulation(EvolutionState state)
Performs exchanges after the population has been bred but before it has been evaluated,
once every generation (or pseudogeneration).
|
Population |
preBreedingExchangePopulation(EvolutionState state)
Performs exchanges after the population has been evaluated but before it has been bred,
once every generation (or pseudogeneration).
|
void |
reinitializeContacts(EvolutionState state)
Initializes contacts with other processes, if that's what you're doing.
|
java.lang.String |
runComplete(EvolutionState state)
Called after preBreedingExchangePopulation(...) to evaluate whether or not
the exchanger wishes the run to shut down (with ec.EvolutionState.R_FAILURE).
|
void |
setup(EvolutionState state,
Parameter _base)
Sets up the object by reading it from the parameters stored
in state, built off of the parameter base base.
|
public static final java.lang.String P_SUBPOP
public static final java.lang.String P_MODULO
public static final java.lang.String P_SIZE
public static final java.lang.String P_OFFSET
public static final java.lang.String P_DEST_FOR_SUBPOP
public static final java.lang.String P_DEST
public static final java.lang.String P_SELECT_METHOD
public static final java.lang.String P_SELECT_TO_DIE_METHOD
public static final java.lang.String P_CHATTY
public Parameter base
public boolean chatty
public void setup(EvolutionState state, Parameter _base)
Setup
public void initializeContacts(EvolutionState state)
initializeContacts
in class Exchanger
public void reinitializeContacts(EvolutionState state)
reinitializeContacts
in class Exchanger
public Population preBreedingExchangePopulation(EvolutionState state)
Exchanger
preBreedingExchangePopulation
in class Exchanger
public Population postBreedingExchangePopulation(EvolutionState state)
Exchanger
postBreedingExchangePopulation
in class Exchanger
public java.lang.String runComplete(EvolutionState state)
runComplete
in class Exchanger
public void closeContacts(EvolutionState state, int result)
closeContacts
in class Exchanger