aima.core.environment.map

Class MapAgent

java.lang.Object

aima.core.agent.impl.AbstractAgent

aima.core.search.framework.ProblemSolvingAgent

aima.core.environment.map.MapAgent

All Implemented Interfaces:

Agent, EnvironmentObject

public class MapAgent
extends ProblemSolvingAgent

Variant of SimpleMapAgent which works correctly also for A* and other best-first search implementations. It can be extended also for scenarios, in which the agent faces unforeseen events. When using informed search and more then one goal, make sure, that a heuristic function factory is provided!

Author:

Ruediger Lunde

Field Summary

Fields

Modifier and Type	Field and Description
protected int	currGoalIdx
protected java.util.List<java.lang.String>	goals
protected Map	map
protected EnvironmentViewNotifier	notifier
protected DynamicState	state

Fields inherited from class aima.core.search.framework.ProblemSolvingAgent

plan

Fields inherited from class aima.core.agent.impl.AbstractAgent

program

Constructor Summary

Constructors

Constructor and Description
MapAgent(Map map, SearchForActions search, java.util.List<java.lang.String> goals)
MapAgent(Map map, SearchForActions search, java.util.List<java.lang.String> goals, EnvironmentViewNotifier notifier)
MapAgent(Map map, SearchForActions search, java.util.List<java.lang.String> goals, EnvironmentViewNotifier notifier, HeuristicFunctionFactory hfFactory)
MapAgent(Map map, SearchForActions search, java.lang.String goal)
MapAgent(Map map, SearchForActions search, java.lang.String goal, EnvironmentViewNotifier notifier)

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	formulateGoal() Primitive operation, responsible for goal generation.
protected Problem	formulateProblem(java.lang.Object goal) Primitive operation, responsible for search problem generation.
protected void	notifyViewOfMetrics()
protected java.util.List<Action>	search(Problem problem) Primitive operation, responsible for the generation of an action list (plan) for the given search problem.
protected State	updateState(Percept p) Primitive operation, responsible for updating the state of the agent with respect to latest feedback from the world.

Methods inherited from class aima.core.search.framework.ProblemSolvingAgent

execute, tryWithAnotherGoal

Methods inherited from class aima.core.agent.impl.AbstractAgent

isAlive, setAlive

Methods inherited from class java.lang.Object

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

Field Detail

map

protected final Map map

state

protected final DynamicState state

goals

protected final java.util.List<java.lang.String> goals

currGoalIdx

protected int currGoalIdx

notifier

protected EnvironmentViewNotifier notifier

Constructor Detail

MapAgent

public MapAgent(Map map,
                SearchForActions search,
                java.lang.String goal)

MapAgent

public MapAgent(Map map,
                SearchForActions search,
                java.lang.String goal,
                EnvironmentViewNotifier notifier)

MapAgent

public MapAgent(Map map,
                SearchForActions search,
                java.util.List<java.lang.String> goals)

MapAgent

public MapAgent(Map map,
                SearchForActions search,
                java.util.List<java.lang.String> goals,
                EnvironmentViewNotifier notifier)

MapAgent

public MapAgent(Map map,
                SearchForActions search,
                java.util.List<java.lang.String> goals,
                EnvironmentViewNotifier notifier,
                HeuristicFunctionFactory hfFactory)

Method Detail

updateState

protected State updateState(Percept p)

Description copied from class: ProblemSolvingAgent

Primitive operation, responsible for updating the state of the agent with respect to latest feedback from the world. In this version, implementations have access to the agent's current goal and plan, so they can modify them if needed. For example, if the plan didn't work because the model of the world proved to be wrong, implementations could update the model and also clear the plan.

Specified by:

updateState in class ProblemSolvingAgent

formulateGoal

protected java.lang.Object formulateGoal()

Description copied from class: ProblemSolvingAgent

Primitive operation, responsible for goal generation. In this version, implementations are allowed to return null to indicate that the agent has finished the job an should die. Implementations can access the current goal (which is a possibly modified version of the last formulated goal). This might be useful in situations in which plan execution has failed.

Specified by:

formulateGoal in class ProblemSolvingAgent

formulateProblem

protected Problem formulateProblem(java.lang.Object goal)

Description copied from class: ProblemSolvingAgent

Primitive operation, responsible for search problem generation.

Specified by:

formulateProblem in class ProblemSolvingAgent

search

protected java.util.List<Action> search(Problem problem)

Description copied from class: ProblemSolvingAgent

Primitive operation, responsible for the generation of an action list (plan) for the given search problem.

Specified by:

search in class ProblemSolvingAgent

notifyViewOfMetrics

protected void notifyViewOfMetrics()