Simulation.Aivika.Dynamics.Agent

Tested with: GHC 7.6.3

This module introduces basic entities for the agent-based modeling.

WARNING: the module is not well tested. This caution is related mainly to managing the nested states.

At the same time, the timer and timeout handlers seem to be well tested as they are just light-weight wrappers creating the event handlers that are already processed by the event queue.

Documentation

data Agent

Represents an agent.

Instances

Eq Agent

data AgentState

Represents the agent state.

Instances

Eq AgentState

newAgent :: EventQueue -> Simulation Agent

Create an agent bound with the specified event queue.

newState :: Agent -> Simulation AgentState

Create a new state.

newSubstate :: AgentState -> Simulation AgentState

Create a child state.

agentQueue :: Agent -> EventQueue

Return the bound event queue.

agentState :: Agent -> Dynamics (Maybe AgentState)

Return the selected downmost active state.

agentStateChanged :: Agent -> Signal (Maybe AgentState)

Return a signal that notifies about every change of the state.

agentStateChanged_ :: Agent -> Signal ()

Return a signal that notifies about every change of the state.

activateState :: AgentState -> Dynamics ()

Select the next downmost active state. The activation is repeated while there is the transition state defined by setStateTransition.

initState :: AgentState -> Dynamics ()

Deprecated: Rewrite using the setStateTransition function instead.

Activate the child state during the direct activation of the parent state. This call is ignored in other cases.

stateAgent :: AgentState -> Agent

Return the corresponded agent.

stateParent :: AgentState -> Maybe AgentState

Return the parent state or Nothing.

addTimeout :: AgentState -> Double -> Dynamics () -> Dynamics ()

Add to the state a timeout handler that will be actuated in the specified time period, while the state remains active.

addTimer :: AgentState -> Dynamics Double -> Dynamics () -> Dynamics ()

Add to the state a timer handler that will be actuated in the specified time period and then repeated again many times, while the state remains active.

stateActivation :: AgentState -> Dynamics () -> Simulation ()

Deprecated: Use the setStateActivation function instead

Set the activation computation for the specified state.

stateDeactivation :: AgentState -> Dynamics () -> Simulation ()

Deprecated: Use the setStateDeactivation function instead

Set the deactivation computation for the specified state.

setStateActivation :: AgentState -> Dynamics () -> Simulation ()

Set the activation computation for the specified state.

setStateDeactivation :: AgentState -> Dynamics () -> Simulation ()

Set the deactivation computation for the specified state.

setStateTransition :: AgentState -> Dynamics (Maybe AgentState) -> Simulation ()

Set the transition state which will be next and which is used only when activating the state directly with help of activateState. If the state was activated intermediately, when activating directly another state, then this computation is not used.