org.volante.abm.agent

Class DefaultSocialInnovationAgent

java.lang.Object

org.volante.abm.agent.AbstractAgent

org.volante.abm.agent.DefaultAgent

org.volante.abm.agent.DefaultSocialInnovationAgent

All Implemented Interfaces:

de.cesr.more.basic.agent.MoreNetworkAgent<SocialAgent,de.cesr.more.basic.edge.MoreEdge<SocialAgent>>, de.cesr.more.basic.agent.MoreObservingNetworkAgent<Agent>, de.cesr.more.measures.node.MoreNodeMeasureSupport, de.cesr.more.rs.building.MoreMilieuAgent, Agent, GeoAgent, InnovationAgent, SocialAgent, SocialInnovationAgent

Direct Known Subclasses:

BoundedSocialInnovationAgent

public class DefaultSocialInnovationAgent
extends DefaultAgent
implements SocialInnovationAgent, GeoAgent

Nested Class Summary

Nested classes/interfaces inherited from interface de.cesr.more.basic.agent.MoreObservingNetworkAgent

de.cesr.more.basic.agent.MoreObservingNetworkAgent.NetworkObservation, de.cesr.more.basic.agent.MoreObservingNetworkAgent.NetworkObservations

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	initialAdoptionObservationPerformed
protected Map<Innovation,InnovationStatus>	innovations
protected de.cesr.more.measures.node.MNodeMeasures	measures
static int	numberAdoptions
static int	numberAgents

Fields inherited from class org.volante.abm.agent.DefaultAgent

givingIn, givingUp, production, type

Fields inherited from class org.volante.abm.agent.AbstractAgent

cells, currentCompetitiveness, id, productivity, region

Fields inherited from interface org.volante.abm.agent.Agent

NOT_MANAGED, NOT_MANAGED_COMPETITION, NOT_MANAGED_ID

Constructor Summary

Constructors

Constructor and Description
DefaultSocialInnovationAgent()
DefaultSocialInnovationAgent(PotentialAgent type, String id, ModelData data, Region r, ProductionModel prod, double givingUp, double givingIn) Mainly used for testing purposes
DefaultSocialInnovationAgent(String id, ModelData data)

Method Summary

Modifier and Type	Method and Description
void	addToGeography() Preliminary!
void	considerAdoption(Innovation innovation) Checks whether this agent is in InnovationStates.AWARE or mode InnovationStates.TRIAL and raises a warning otherwise.
void	considerInnovationsNextStep() Checks each registered innovation for its status in order to consider taking the next status.
void	considerRejection(Innovation innovation) Does nothing
void	considerTrial(Innovation innovation) Checks whether the share of social network partners that currently apply the given innovation multiplied by the innocation's adoption factor is equal to or greater than a random number ]0,1[.
void	die() Called to remove the agent instance from the system.
String	getAgentId()
Set<Innovation>	getInnovationsAwareOf() Unmodifiable set of innovations this agent is aware of.
int	getMilieuGroup()
de.cesr.more.basic.agent.MoreAgentNetworkComp<SocialAgent,de.cesr.more.basic.edge.MoreEdge<SocialAgent>>	getNetworkComp()
Number	getNetworkMeasureObject(de.cesr.more.basic.network.MoreNetwork<? extends de.cesr.more.measures.node.MoreNodeMeasureSupport,?> network, de.cesr.more.measures.MMeasureDescription key)
InnovationState	getState(Innovation innovation)
protected void	initialAdoptionObservation()
void	makeAdopted(Innovation innovation) Sets InnovationStates.ADOPTED and increases adoption counter.
void	makeAware(Innovation innovation) Make this agent aware of the given innovation, i.e.
void	makeTrial(Innovation innovation) Sets InnovationStates.TRIAL, performs the innovation and makes social network partners aware.
void	perceiveSocialNetwork() Perceive social network regarding each innovation the agent is aware of.
protected void	perceiveSocialNetwork(Innovation i) Observe and set the share of social network partners that adopted the given Innovation.
void	receiveNotification(de.cesr.more.basic.agent.MoreObservingNetworkAgent.NetworkObservation observation, Agent object)
void	rejectInnovation(Innovation innovation) Rejects the given innovation.
void	removeInnovation(Innovation innvoation)
void	setNetworkComp(de.cesr.more.basic.agent.MoreAgentNetworkComp<SocialAgent,de.cesr.more.basic.edge.MoreEdge<SocialAgent>> netComp)
void	setNetworkMeasureObject(de.cesr.more.basic.network.MoreNetwork<? extends de.cesr.more.measures.node.MoreNodeMeasureSupport,?> network, de.cesr.more.measures.MMeasureDescription key, Number value)
String	toString()

Methods inherited from class org.volante.abm.agent.DefaultAgent

canTakeOver, considerGivingUp, getGivingIn, getGivingUp, getProductionFunction, getProductionModel, getType, infoString, setGivingIn, setGivingUp, setProductionFunction, supply, updateSupply

Methods inherited from class org.volante.abm.agent.AbstractAgent

addCell, getAge, getCells, getCompetitiveness, getHomeCell, getID, getRegion, giveUp, removeCell, setAge, setId, setRegion, tickEndUpdate, tickStartUpdate, toRemove, updateCompetitiveness

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.volante.abm.agent.InnovationAgent

getProductionModel

Methods inherited from interface org.volante.abm.agent.Agent

addCell, canTakeOver, considerGivingUp, getAge, getCells, getCompetitiveness, getGivingIn, getGivingUp, getHomeCell, getID, getRegion, getType, infoString, removeCell, setAge, setGivingIn, setGivingUp, setRegion, supply, tickEndUpdate, tickStartUpdate, toRemove, updateCompetitiveness, updateSupply

Field Detail

numberAdoptions

public static int numberAdoptions

numberAgents

public static int numberAgents

innovations

protected Map<Innovation,InnovationStatus> innovations

measures

protected de.cesr.more.measures.node.MNodeMeasures measures

initialAdoptionObservationPerformed

protected boolean initialAdoptionObservationPerformed

Constructor Detail

DefaultSocialInnovationAgent

public DefaultSocialInnovationAgent()

DefaultSocialInnovationAgent

public DefaultSocialInnovationAgent(String id,
                                    ModelData data)

Parameters:

id - agent id

data - model data

DefaultSocialInnovationAgent

public DefaultSocialInnovationAgent(PotentialAgent type,
                                    String id,
                                    ModelData data,
                                    Region r,
                                    ProductionModel prod,
                                    double givingUp,
                                    double givingIn)

Mainly used for testing purposes

Parameters:

type - potential agent

id - agent id

data - model data

r - region

prod - production model

givingUp - giving up threshold

givingIn - giving in threshold

Method Detail

receiveNotification

public void receiveNotification(de.cesr.more.basic.agent.MoreObservingNetworkAgent.NetworkObservation observation,
                                Agent object)

Specified by:

receiveNotification in interface de.cesr.more.basic.agent.MoreObservingNetworkAgent<Agent>

Overrides:

receiveNotification in class DefaultAgent

See Also:

DefaultAgent.receiveNotification(de.cesr.more.basic.agent.MoreObservingNetworkAgent.NetworkObservation, org.volante.abm.agent.Agent)

initialAdoptionObservation

protected void initialAdoptionObservation()

perceiveSocialNetwork

public void perceiveSocialNetwork()

Perceive social network regarding each innovation the agent is aware of.

Specified by:

perceiveSocialNetwork in interface SocialAgent

See Also:

SocialAgent.perceiveSocialNetwork()

perceiveSocialNetwork

protected void perceiveSocialNetwork(Innovation i)

Observe and set the share of social network partners that adopted the given Innovation. Considers only incoming relations.

Parameters:

i - innovation to consider

considerInnovationsNextStep

public void considerInnovationsNextStep()

Description copied from interface: InnovationAgent

Checks each registered innovation for its status in order to consider taking the next status. Calls InnovationAgent.considerTrial(Innovation), InnovationAgent.considerAdoption(Innovation), or InnovationAgent.considerRejection(Innovation) as appropriate. This method is usually called by the schedule.

Specified by:

considerInnovationsNextStep in interface InnovationAgent

See Also:

InnovationAgent.considerInnovationsNextStep()

makeAware

public void makeAware(Innovation innovation)

Description copied from interface: InnovationAgent

Make this agent aware of the given innovation, i.e. set the innovation status to InnovationStates.AWARE.

Specified by:

makeAware in interface InnovationAgent

See Also:

InnovationAgent.makeAware(org.volante.abm.institutions.innovation.Innovation)

considerTrial

public void considerTrial(Innovation innovation)

Checks whether the share of social network partners that currently apply the given innovation multiplied by the innocation's adoption factor is equal to or greater than a random number ]0,1[. Checks whether this agent is in InnovationStates.AWARE mode and raises a warning otherwise.

Specified by:

considerTrial in interface InnovationAgent

Parameters:

innovation -

makeTrial

public void makeTrial(Innovation innovation)

Sets InnovationStates.TRIAL, performs the innovation and makes social network partners aware.

Specified by:

makeTrial in interface InnovationAgent

Parameters:

innovation -

considerAdoption

public void considerAdoption(Innovation innovation)

Checks whether this agent is in InnovationStates.AWARE or mode InnovationStates.TRIAL and raises a warning otherwise. Adoption is steered by probability (applying Innovation.getAdoptionThreshold(Agent).

Specified by:

considerAdoption in interface InnovationAgent

See Also:

InnovationAgent.considerAdoption(org.volante.abm.institutions.innovation.Innovation)

makeAdopted

public void makeAdopted(Innovation innovation)

Sets InnovationStates.ADOPTED and increases adoption counter.

Specified by:

makeAdopted in interface InnovationAgent

Parameters:

innovation -

considerRejection

public void considerRejection(Innovation innovation)

Does nothing

Specified by:

considerRejection in interface InnovationAgent

Parameters:

innovation -

rejectInnovation

public void rejectInnovation(Innovation innovation)

Description copied from interface: InnovationAgent

Rejects the given innovation. Sets the innovation's state to InnovationStates.REJECTED.

Specified by:

rejectInnovation in interface InnovationAgent

Parameters:

innovation -

addToGeography

public void addToGeography()

Preliminary!

Specified by:

addToGeography in interface GeoAgent

See Also:

GeoAgent.addToGeography()

toString

public String toString()

Overrides:

toString in class AbstractAgent

See Also:

AbstractAgent.toString()

die

public void die()

Description copied from interface: Agent

Called to remove the agent instance from the system.

Specified by:

die in interface Agent

Overrides:

die in class AbstractAgent

See Also:

AbstractAgent.die()

setNetworkComp

public void setNetworkComp(de.cesr.more.basic.agent.MoreAgentNetworkComp<SocialAgent,de.cesr.more.basic.edge.MoreEdge<SocialAgent>> netComp)

Specified by:

setNetworkComp in interface de.cesr.more.basic.agent.MoreNetworkAgent<SocialAgent,de.cesr.more.basic.edge.MoreEdge<SocialAgent>>

See Also:

MoreNetworkAgent.setNetworkComp(de.cesr.more.basic.agent.MoreAgentNetworkComp)

getNetworkComp

public de.cesr.more.basic.agent.MoreAgentNetworkComp<SocialAgent,de.cesr.more.basic.edge.MoreEdge<SocialAgent>> getNetworkComp()

Specified by:

getNetworkComp in interface de.cesr.more.basic.agent.MoreNetworkAgent<SocialAgent,de.cesr.more.basic.edge.MoreEdge<SocialAgent>>

See Also:

MoreNetworkAgent.getNetworkComp()

setNetworkMeasureObject

public void setNetworkMeasureObject(de.cesr.more.basic.network.MoreNetwork<? extends de.cesr.more.measures.node.MoreNodeMeasureSupport,?> network,
                                    de.cesr.more.measures.MMeasureDescription key,
                                    Number value)

Specified by:

setNetworkMeasureObject in interface de.cesr.more.measures.node.MoreNodeMeasureSupport

See Also:

MoreNodeMeasureSupport.setNetworkMeasureObject(de.cesr.more.basic.network.MoreNetwork, de.cesr.more.measures.MMeasureDescription, java.lang.Number)

getNetworkMeasureObject

public Number getNetworkMeasureObject(de.cesr.more.basic.network.MoreNetwork<? extends de.cesr.more.measures.node.MoreNodeMeasureSupport,?> network,
                                      de.cesr.more.measures.MMeasureDescription key)

Specified by:

getNetworkMeasureObject in interface de.cesr.more.measures.node.MoreNodeMeasureSupport

See Also:

MoreNodeMeasureSupport.getNetworkMeasureObject(de.cesr.more.basic.network.MoreNetwork, de.cesr.more.measures.MMeasureDescription)

getState

public InnovationState getState(Innovation innovation)

Specified by:

getState in interface InnovationAgent

Returns:

the given innovation's current state

See Also:

InnovationAgent.getState(org.volante.abm.institutions.innovation.Innovation)

getMilieuGroup

public int getMilieuGroup()

Specified by:

getMilieuGroup in interface de.cesr.more.rs.building.MoreMilieuAgent

See Also:

MoreMilieuAgent.getMilieuGroup()

getAgentId

public String getAgentId()

Specified by:

getAgentId in interface de.cesr.more.rs.building.MoreMilieuAgent

See Also:

MoreMilieuAgent.getAgentId()

removeInnovation

public void removeInnovation(Innovation innvoation)

Specified by:

removeInnovation in interface InnovationAgent

See Also:

InnovationAgent.removeInnovation(org.volante.abm.institutions.innovation.Innovation)

getInnovationsAwareOf

public Set<Innovation> getInnovationsAwareOf()

Unmodifiable set of innovations this agent is aware of.

Specified by:

getInnovationsAwareOf in interface InnovationAgent

Returns:

set of innovations

See Also:

InnovationAgent.getInnovationsAwareOf()