Package fr.univ_artois.lgi2a.similar.extendedkernel.agents

Interface IAgtPerceptionModel

All Known Implementing Classes:

AbstractAgtPerceptionModel, EmptyAgtPerceptionModel

public interface IAgtPerceptionModel

Models the perception process used by an agent to produce perceived data from a specific level.

Author:

Yoann Kubera

Method Summary

Modifier and Type	Method	Description
LevelIdentifier	getLevel()	Gets the level from which the perception is made.
IPerceivedData	perceive(SimulationTimeStamp timeLowerBound, SimulationTimeStamp timeUpperBound, Map<LevelIdentifier,ILocalStateOfAgent> publicLocalStates, ILocalStateOfAgent privateLocalState, IPublicDynamicStateMap dynamicStates)	Creates the data perceived by an agent located in the level identified by getLevel().

Method Detail

getLevel

LevelIdentifier getLevel()

Gets the level from which the perception is made.

Returns:

The level from which the perception is made.

perceive

IPerceivedData perceive(SimulationTimeStamp timeLowerBound,
                        SimulationTimeStamp timeUpperBound,
                        Map<LevelIdentifier,ILocalStateOfAgent> publicLocalStates,
                        ILocalStateOfAgent privateLocalState,
                        IPublicDynamicStateMap dynamicStates)

Creates the data perceived by an agent located in the level identified by getLevel().

This method corresponds to the application perception_{a, ]t,t+dtl[, l} of this agent.

Parameters:

timeLowerBound - Is the lower bound of the transitory period of the level identified by level from which the perception is made by this agent (i.e. "t" in the notations).

timeUpperBound - Is the upper bound of the transitory period of the level identified by level from which the perception is made by this agent (i.e. t+dt_l in the notations).

publicLocalStates - All the public local states of the agent.

privateLocalState - The private local state of the agent in the level from which perception is made (i.e. φ_a^-( t, level ) in the notations).

dynamicStates - The dynamic state of the various levels that can be perceived from the level level. This value has previously been disambiguated by a heuristic defined in the simulation engine.

Returns:

The data being perceived by the agent from the level identified by level, for the transitory period ]timeLowerBound, timeUpperBound[.