Package fr.univ_artois.lgi2a.similar.microkernel.dynamicstate

Interface IPublicLocalDynamicState

All Known Subinterfaces:

IModifiablePublicLocalDynamicState

All Known Implementing Classes:

ConsistentPublicLocalDynamicState, TransitoryPublicLocalDynamicState

public interface IPublicLocalDynamicState

The parent interface of any public dynamic state of a level of the simulation.

Correspondence with theory

An instance of this interface models the public local dynamic state δ(t, l) of a level "l" at a time "t", or the public local dynamic state δ(]t,t′[, l) of a level "l" during a transitory period "]t,t′[".

Author:

Yoann Kubera

Method Summary

Modifier and Type	Method	Description
LevelIdentifier	getLevel()	Gets the level for which the public local dynamic state is defined.
Set<ILocalStateOfAgent>	getPublicLocalStateOfAgents()	Gets the public local state of the agents lying in the level of this dynamic state.
ILocalStateOfEnvironment	getPublicLocalStateOfEnvironment()	Gets the public local state of the environment contained in this public local dynamic state.
Set<IInfluence>	getRegularInfluencesOfStateDynamics()	Gets the non-system influences contained in the state dynamics.
Set<IInfluence>	getStateDynamics()	Gets the state dynamics of this public local dynamic state, i.e. the influences that are still active (being performed) when the level was in this state.
Set<IInfluence>	getSystemInfluencesOfStateDynamics()	Gets the system influences contained in the state dynamics.

Method Detail

getLevel

LevelIdentifier getLevel()

Gets the level for which the public local dynamic state is defined.

It returns the identifier of "l" in the notation δ(t, l) or δ(]t,t′[, l).

Returns:

The level for which the public local dynamic state is defined.

getPublicLocalStateOfEnvironment

ILocalStateOfEnvironment getPublicLocalStateOfEnvironment()

Gets the public local state of the environment contained in this public local dynamic state.

It returns the value φ_ω(t, getLevel( )) or φ_ω(]t,t′, getLevel( )).

Returns:

The public local state of the environment contained in this public local dynamic state.

getPublicLocalStateOfAgents

Set<ILocalStateOfAgent> getPublicLocalStateOfAgents()

Gets the public local state of the agents lying in the level of this dynamic state.

It returns the values φ_a(t, getLevel( )) (resp. φ_a(]t,t′, getLevel( ))) for each agent lying in the level identified by getLevel( ) at the time "t" (resp. during the transitory period ]t,t′[).

This method has to ensure that two consecutive iterations over this set always return its items in the same order.

Returns:

The public local state of the agents lying in the level of this dynamic state.

getStateDynamics

Set<IInfluence> getStateDynamics()

Gets the state dynamics of this public local dynamic state, i.e. the influences that are still active (being performed) when the level was in this state.

It returns the value γ(t, getLevel( )) or γ(]t,t′[, getLevel( )).

This method has to ensure that two consecutive iterations over this set always return its items in the same order.

Returns:

The state dynamics of this public local dynamic state.

getSystemInfluencesOfStateDynamics

Set<IInfluence> getSystemInfluencesOfStateDynamics()

Gets the system influences contained in the state dynamics.

This method has to ensure that two consecutive iterations over this set always return its items in the same order.

Returns:

The system influences of the value returned by the getStateDynamics() method.

getRegularInfluencesOfStateDynamics

Set<IInfluence> getRegularInfluencesOfStateDynamics()

Gets the non-system influences contained in the state dynamics.

This method has to ensure that two consecutive iterations over this set always return its items in the same order.

Returns:

The non-system influences of the value returned by the getStateDynamics() method.