org.volante.abm.institutions.innovation

Class Innovation

java.lang.Object

org.volante.abm.institutions.innovation.Innovation

All Implemented Interfaces:

Initialisable

Direct Known Subclasses:

InnovationTest.TestInnovation, ProductivityInnovation, RepeatingCapitalLevelInnovation, VariableCapitalLevelInnovation

public abstract class Innovation
extends Object
implements Initialisable

NOTE: Subclasses should call Initialisable.initialise(ModelData, RunInfo, Region) in order to register this innovation at the InnovationRegistry.

Field Summary

Fields

Modifier and Type	Field and Description
protected double	adoptionThreshold Factor in the decision of adoption.
protected String	affectedAFTs Comma-separated list of AFT IDs that are allowed to adopt.
protected Set<String>	affectedAftSet
protected String	identifier Identifier must be given since every innovation is registered at the innovation registry with its identifier during initialisation.
protected int	lifeSpan At the end of the lifespan, this innovation outdates itself at all InnovationAgents.
protected ModelData	modelData
protected Region	region
protected RunInfo	rInfo
protected double	trialThreshold Threshold in the decision of trial.

Constructor Summary

Constructors

Constructor and Description
Innovation(String identifier)

Method Summary

Modifier and Type	Method and Description
double	getAdoptionNoise()
double	getAdoptionThreshold(Agent agent) Factor in the decision of adoption.
Set<String>	getAffectedAFTs()
String	getIdentifier() Innovation's ID
int	getLifeSpan()
double	getTrialNoise()
double	getTrialThreshold(Agent agent) Factor in the decision of trial.
abstract InnovationBo	getWaitingBo(SocialAgent agent)
void	initialise(ModelData data, RunInfo info, Region r) Assign model data, run info, and region.
void	outdate(InnovationAgent agent) This method is called by InnovativeInstitutions (because they are rather aware of affected agents) once this innovation's lifespan is exceeded.
abstract void	perform(InnovationAgent agent) Let this innovation take effect for the given agent.
void	setAffectedAFTs(String affectedAFTs) Deprecated.
abstract void	unperform(InnovationAgent agent) Undo the effect of this innovation for the given agent.

Methods inherited from class java.lang.Object

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

Field Detail

identifier

protected String identifier

Identifier must be given since every innovation is registered at the innovation registry with its identifier during initialisation.

trialThreshold

protected double trialThreshold

Threshold in the decision of trial. Default is 0.5

adoptionThreshold

protected double adoptionThreshold

Factor in the decision of adoption. Default is 0.5

lifeSpan

protected int lifeSpan

At the end of the lifespan, this innovation outdates itself at all InnovationAgents.

affectedAFTs

protected String affectedAFTs

Comma-separated list of AFT IDs that are allowed to adopt.

affectedAftSet

protected Set<String> affectedAftSet

region

protected Region region

rInfo

protected RunInfo rInfo

modelData

protected ModelData modelData

Constructor Detail

Innovation

public Innovation(String identifier)

Method Detail

getTrialThreshold

public double getTrialThreshold(Agent agent)

Factor in the decision of trial. Values > 1 cause the trial to be likelier, values < 1 cause to adoption to be less likely.

Parameters:

agent -

Returns:

trial factor independent from given agent

getAdoptionThreshold

public double getAdoptionThreshold(Agent agent)

Factor in the decision of adoption. Values > 1 cause the adoption to be likelier, values < 1 cause to adoption to be less likely.

Parameters:

agent -

Returns:

adoption factor independent from given agent

getTrialNoise

public double getTrialNoise()

getAdoptionNoise

public double getAdoptionNoise()

getWaitingBo

public abstract InnovationBo getWaitingBo(SocialAgent agent)

perform

public abstract void perform(InnovationAgent agent)

Let this innovation take effect for the given agent.

Parameters:

agent -

unperform

public abstract void unperform(InnovationAgent agent)

Undo the effect of this innovation for the given agent.

Parameters:

agent -

outdate

public void outdate(InnovationAgent agent)

This method is called by InnovativeInstitutions (because they are rather aware of affected agents) once this innovation's lifespan is exceeded. Removed the innovation from InnovationAgents to prevent further spreading. For some innovations, this method may call unperform(InnovationAgent).

Parameters:

agent -

initialise

public void initialise(ModelData data,
                       RunInfo info,
                       Region r)
                throws Exception

Assign model data, run info, and region. Register this innovation at the region's InnovationRegistry.

Specified by:

initialise in interface Initialisable

Parameters:

data - model data

info - run information

r - region the initialisable object belongs to

Throws:

Exception

See Also:

Initialisable.initialise(org.volante.abm.data.ModelData, org.volante.abm.schedule.RunInfo, org.volante.abm.data.Region)

setAffectedAFTs

public void setAffectedAFTs(String affectedAFTs)

Deprecated.

Interface required for testing purposes.

Parameters:

affectedAFTs -

getAffectedAFTs

public Set<String> getAffectedAFTs()

Returns:

set of affected AFTs

getLifeSpan

public int getLifeSpan()

getIdentifier

public String getIdentifier()

Innovation's ID

Returns:

innovation's ID