Package org.evoludo.simulator.modules

Class CLabour

Object

Module

Continuous

CLabour

All Implemented Interfaces:

Runnable, IBS.HasIBS, IBS.HasIBS.MCPairs, MilestoneListener, Features, Features.Pairs, Features.Payoffs, HasDistribution, HasDistribution.Strategy, HasHistogram, HasHistogram.Degree, HasHistogram.Fitness, HasHistogram.Strategy, HasMean, HasMean.Fitness, HasMean.Traits, HasPop2D, HasPop2D.Fitness, HasPop2D.Traits, HasPop3D, HasPop3D.Fitness, HasPop3D.Traits, CLOProvider

public class CLabour
extends Continuous
implements Features.Payoffs, IBS.HasIBS.MCPairs, HasPop2D.Traits, HasPop3D.Traits, HasMean.Traits, HasHistogram.Strategy, HasDistribution.Strategy, HasPop2D.Fitness, HasPop3D.Fitness, HasMean.Fitness, HasHistogram.Fitness, HasHistogram.Degree

The module for the evolution of two behavioural traits. This module is designed for the study of specialization and division of labour.

Author:

Christoph Hauert

See Also:

• "Henriques G. J. B., Ito K., Hauert C., Doebeli M. (2021) <em>On the importance of evolving phenotype distributions on evolutionary diversification.</em> PLoS Comput. Biol. 17(2): e1008733. <a href='https://doi.org/10.1371/journal.pcbi.1008733'>doi: 10.1371/journal.pcbi.1008733</a>"

Nested Class Summary

Nested classes/interfaces inherited from class Continuous

Continuous.Benefits, Continuous.Costs, Continuous.Traits2Payoff

Nested classes/interfaces inherited from interface Features

Features.Groups, Features.Multispecies, Features.Pairs, Features.Payoffs, Features.Static

Nested classes/interfaces inherited from interface HasDistribution

HasDistribution.Strategy

Nested classes/interfaces inherited from interface HasHistogram

HasHistogram.Degree, HasHistogram.Fitness, HasHistogram.StatisticsProbability, HasHistogram.StatisticsStationary, HasHistogram.StatisticsTime, HasHistogram.Strategy

Nested classes/interfaces inherited from interface HasMean

HasMean.Fitness, HasMean.Traits

Nested classes/interfaces inherited from interface HasPop2D

HasPop2D.Fitness, HasPop2D.Traits

Nested classes/interfaces inherited from interface HasPop3D

HasPop3D.Fitness, HasPop3D.Traits

Nested classes/interfaces inherited from interface IBS.HasIBS

IBS.HasIBS.CGroups, IBS.HasIBS.CPairs, IBS.HasIBS.DGroups, IBS.HasIBS.DPairs, IBS.HasIBS.MCGroups, IBS.HasIBS.MCPairs

Field Summary

Fields

Modifier and Type	Field	Description
protected double[]	you	Temporary storage for the traits of the opponent.

Fields inherited from class Continuous

cloBenefits, cloCosts, cloTraitRange, cxMaxMonoScore, cxMaxScore, cxMinMonoScore, cxMinScore, extremalScoresSet, MINMAX_ITER, MINMAX_STEPS, mutation, population, species, traitMax, traitMin, traits2payoff

Fields inherited from class Module

active, cloDeathRate, cloGeometry, cloNGroup, cloNPopulation, cloPhase2DAxes, cloTraitColors, cloTraitDisable, cloTraitNames, competition, deathRate, defaultColor, engine, ibs, ID, interaction, logger, map2fitness, markers, model, nActive, name, nGroup, nPopulation, nTraits, opponent, playerUpdate, structure, traitColor, traitName, trajectoryColor, VACANT

Constructor Summary

Constructors

Constructor	Description
CLabour(EvoLudo engine)	Constructs a new EvoLudo module for the evolution of two behavioural traits.

Method Summary

Modifier and Type	Method	Description
String	getAuthors()	Returns a string with information about the authors of the module.
String	getKey()	Returns identifier of the active module.
String	getTitle()	Returns title of active module, e.g.
void	load()	Load new module and perform basic initializations.
double	pairScores(double[] me, double[] groupTraits, int len, double[] groupPayoffs)	Calculate the payoff/score for modules with interactions in pairs and multiple continuous traits.
void	unload()	Unload module and free all resources.

Methods inherited from class Continuous

add, check, collectCLO, getMaxMonoPayoff, getMaxPayoff, getMinMonoPayoff, getMinPayoff, getMutation, getTraitMax, getTraitMin, setExtremalScores, setTraitRange

Methods inherited from class Module

createGeometry, createIBSPop, createModel, getActiveTraits, getCompetitionGeometry, getDeathRate, getGeometry, getIBSPopulation, getID, getInteractionGeometry, getMap2Fitness, getMarkers, getMeanColors, getModelTypes, getNActive, getName, getNGroup, getNPopulation, getNRoles, getNSpecies, getNTraits, getOpponent, getPlayerUpdate, getSpecies, getSpecies, getTraitColor, getTraitColors, getTraitName, getTraitNames, getTrajectoryColor, getVacant, init, processColorMap, reset, run, setActiveTraits, setDeathRate, setGeometries, setIBSPopulation, setModel, setName, setNGroup, setNPopulation, setNTraits, setOpponent, setTraitColors, setTraitNames, setTrajectoryColor

Methods inherited from class Object

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

Methods inherited from interface CLOProvider

adjustCLO

Methods inherited from interface Features

isMultispecies, isStatic

Methods inherited from interface Features.Pairs

isPairwise

Methods inherited from interface Features.Payoffs

getMap2Fitness, getMaxMonoPayoff, getMaxPayoff, getMinMonoPayoff, getMinPayoff, isNeutral

Methods inherited from interface HasDistribution

getNTraits, getTraitName

Methods inherited from interface HasHistogram

getCustomLevels, getNTraits, getTraitColors

Methods inherited from interface IBS.HasIBS

createIBS

Methods inherited from interface MilestoneListener

modelDidInit, modelDidReset, modelLoaded, modelRelaxed, modelRunning, modelSettings, modelStopped, modelUnloaded, moduleLoaded, moduleRestored, moduleUnloaded

Field Details

you

protected double[] you

Temporary storage for the traits of the opponent.

Constructor Details

CLabour

public CLabour(EvoLudo engine)

Constructs a new EvoLudo module for the evolution of two behavioural traits.

Parameters:

engine - the manager of modules and pacemaker for running the model

Method Details

load

public void load()

Description copied from class: Module

Load new module and perform basic initializations.

Overrides:

load in class Continuous

See Also:

• EvoLudo.loadModule(String)
• MilestoneListener.moduleLoaded()

unload

public void unload()

Description copied from class: Module

Unload module and free all resources.

Overrides:

unload in class Continuous

See Also:

• EvoLudo.unloadModule()
• MilestoneListener.moduleUnloaded()

getKey

public String getKey()

Description copied from class: Module

Returns identifier of the active module. For example, 2x2 games in TBT return "2x2". This corresponds to the argument for the --module option to load a particular module. The default is to use the class name.

Overrides:

getKey in class Module

Returns:

the identifying key of this module

getAuthors

public String getAuthors()

Description copied from class: Module

Returns a string with information about the authors of the module.

Overrides:

getAuthors in class Module

Returns:

the names of the authors

getTitle

public String getTitle()

Description copied from interface: Features

Returns title of active module, e.g. 2x2 games in TBT returns "2x2 Games".

Specified by:

getTitle in interface Features

Returns:

the title of active module

pairScores

public double pairScores(double[] me,
 double[] groupTraits,
 int len,
 double[] groupPayoffs)

Description copied from interface: IBS.HasIBS.MCPairs

Calculate the payoff/score for modules with interactions in pairs and multiple continuous traits. The focal individual has traits me and the traits of its len interaction partners are given in group. The traits they are arranged in the usual manner, i.e. first all traits of the first group member then all traits by the second group member etc. for a total of len*nTraits entries. The payoffs/scores for each of the len opponent traits must be stored and returned in the array payoffs.

Note:

Only the first len entries in group are guaranteed to exist and have meaningful values. The population structure may restrict the size of the interaction group. len≤nGroup always holds.

Important:

must be overridden and implemented in subclasses that define game interactions between pairs of individuals (nGroup=2, pairwise=true), otherwise see IBS.HasIBS.CGroups.groupScores(double, double[], int, double[]).

Specified by:

pairScores in interface IBS.HasIBS.MCPairs

Parameters:

me - the trait of the focal individual

groupTraits - the traits of the group members

len - the number of memebrs in the group

groupPayoffs - the array for returning the payoffs/scores for each group member

Returns:

the total (accumulated) payoff/score for the focal individual