traffic3.manager

Class TrafficManager

java.lang.Object

traffic3.manager.TrafficManager

public class TrafficManager
extends java.lang.Object

The traffic manager maintains information about traffic simulator objects.

Constructor Summary

Constructors

Constructor and Description
TrafficManager() Construct a new TrafficManager.

Method Summary

Modifier and Type	Method and Description
void	cacheInformation(StandardWorldModel world) Compute pre-cached information about the world.
void	clear() Remove all objects from this manager.
TrafficArea	findArea(double x, double y) Find the area that contains a point.
java.util.Collection<TrafficAgent>	getAgents() Get all TrafficAgents.
java.util.Collection<TrafficArea>	getAreas() Get all TrafficAreas.
java.util.Collection<TrafficBlockade>	getBlockades() Get all TrafficBlockades.
java.util.Collection<TrafficAgent>	getNearbyAgents(TrafficAgent agent) Get all agents in the same area or a neighbouring area as an agent.
java.util.Collection<TrafficArea>	getNeighbours(TrafficArea area) Get the neighbouring areas to a TrafficArea.
TrafficAgent	getTrafficAgent(Human h) Get the TrafficAgent that wraps a given human.
TrafficArea	getTrafficArea(Area a) Get the TrafficArea that wraps a given Area.
TrafficBlockade	getTrafficBlockade(Blockade b) Get the TrafficBlockade that wraps a given Blockade.
void	register(TrafficAgent agent) Register a new TrafficAgent.
void	register(TrafficArea area) Register a new TrafficArea.
void	register(TrafficBlockade block) Register a new TrafficBlockade.
void	remove(Blockade block) Remove a blockade.
void	remove(TrafficBlockade block) Remove a blockade.

Methods inherited from class java.lang.Object

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

Constructor Detail

TrafficManager

public TrafficManager()

Construct a new TrafficManager.

Method Detail

findArea

public TrafficArea findArea(double x,
                            double y)

Find the area that contains a point.

Parameters:

x - The X coordinate.

y - The Y coordinate.

Returns:

The TrafficArea that contains the given point, or null if no such area is found.

getNeighbours

public java.util.Collection<TrafficArea> getNeighbours(TrafficArea area)

Get the neighbouring areas to a TrafficArea.

Parameters:

area - The area to look up.

Returns:

All TrafficAreas that share an edge with the given area.

getNearbyAgents

public java.util.Collection<TrafficAgent> getNearbyAgents(TrafficAgent agent)

Get all agents in the same area or a neighbouring area as an agent.

Parameters:

agent - The agent to look up.

Returns:

All agents (except the input agent) that are in the same or a neighbouring area.

clear

public void clear()

Remove all objects from this manager.

register

public void register(TrafficArea area)

Register a new TrafficArea.

Parameters:

area - The TrafficArea to register.

register

public void register(TrafficAgent agent)

Register a new TrafficAgent.

Parameters:

agent - The TrafficAgent to register.

register

public void register(TrafficBlockade block)

Register a new TrafficBlockade.

Parameters:

block - The TrafficBlockade to register.

remove

public void remove(TrafficBlockade block)

Remove a blockade.

Parameters:

block - The TrafficBlockade to remove.

remove

public void remove(Blockade block)

Remove a blockade.

Parameters:

block - The Blockade to remove.

getAgents

public java.util.Collection<TrafficAgent> getAgents()

Get all TrafficAgents.

Returns:

All TrafficAgents.

getAreas

public java.util.Collection<TrafficArea> getAreas()

Get all TrafficAreas.

Returns:

All TrafficAreas.

getBlockades

public java.util.Collection<TrafficBlockade> getBlockades()

Get all TrafficBlockades.

Returns:

All TrafficBlockades.

cacheInformation

public void cacheInformation(StandardWorldModel world)

Compute pre-cached information about the world. TrafficArea and TrafficAgent objects must have already been registered with register(TrafficArea) and register(TrafficAgent).

Parameters:

world - The world model.

getTrafficArea

public TrafficArea getTrafficArea(Area a)

Get the TrafficArea that wraps a given Area.

Parameters:

a - The area to look up.

Returns:

The TrafficArea that wraps the given area or null if no such TrafficArea exists.

getTrafficBlockade

public TrafficBlockade getTrafficBlockade(Blockade b)

Get the TrafficBlockade that wraps a given Blockade.

Parameters:

b - The blockade to look up.

Returns:

The TrafficBlockade that wraps the given blockade or null if no such TrafficBlockade exists.

getTrafficAgent

public TrafficAgent getTrafficAgent(Human h)

Get the TrafficAgent that wraps a given human.

Parameters:

h - The human to look up.

Returns:

The TrafficAgent that wraps the given human or null if no such TrafficAgent exists.