movement
Class MapBasedMovement

java.lang.Object
  movement.MovementModel
      movement.MapBasedMovement

Direct Known Subclasses:

MapRouteMovement, ShortestPathMapBasedMovement

public class MapBasedMovement
extends MovementModel

Map based movement model which gives out Paths that use the roads of a SimMap.

Field Summary

static java.lang.String	FILE_S map file -setting id ("mapFile")
protected MapNode	lastMapNode node where the last path ended or node next to intial placement
static java.lang.String	MAP_BASE_MOVEMENT_NS map based movent model's settings namespace ("MapBasedMovement")
static java.lang.String	MAP_SELECT_S Per node group setting for selecting map node types that are OK for this node group to traverse trough.
static java.lang.String	NROF_FILES_S number of map files -setting id ("nrofMapFiles")

Fields inherited from class movement.MovementModel

DEF_SPEEDS, DEF_WAIT_TIMES, MOVEMENT_MODEL_NS, rng, RNG_SEED, SPEED, WAIT_TIME, WORLD_SIZE

Constructor Summary

protected	MapBasedMovement(MapBasedMovement mbm) Copyconstructor.
	MapBasedMovement(Settings settings) Creates a new MapBasedMovement based on a Settings object's settings.
	MapBasedMovement(Settings settings, SimMap newMap, int nrofMaps) Creates a new MapBasedMovement based on a Settings object's settings but with different SimMap

Method Summary

Coord	getInitialLocation() Returns a (random) coordinate that is between two adjacent MapNodes
SimMap	getMap() Returns the SimMap this movement model uses
protected int[]	getOkMapNodeTypes() Returns map node types that are OK for this movement model in an array or null if all values are considered ok
Path	getPath() Returns a new path by this movement model or null if no new path could be constructed at the moment (node should wait where it is).
MapBasedMovement	replicate() Creates a replicate of the movement model.
protected MapNode	selectRandomOkNode(java.util.List<MapNode> nodes) Selects and returns a random node that is OK from a list of nodes.

Methods inherited from class movement.MovementModel

generateSpeed, generateWaitTime, getMaxX, getMaxY, isActive, nextPathAvailable, reset, toString

Methods inherited from class java.lang.Object

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

Field Detail

lastMapNode

protected MapNode lastMapNode

node where the last path ended or node next to intial placement

MAP_BASE_MOVEMENT_NS

public static final java.lang.String MAP_BASE_MOVEMENT_NS

map based movent model's settings namespace ("MapBasedMovement")

See Also:

Constant Field Values

NROF_FILES_S

public static final java.lang.String NROF_FILES_S

number of map files -setting id ("nrofMapFiles")

See Also:

Constant Field Values

FILE_S

public static final java.lang.String FILE_S

map file -setting id ("mapFile")

See Also:

Constant Field Values

MAP_SELECT_S

public static final java.lang.String MAP_SELECT_S

Per node group setting for selecting map node types that are OK for this node group to traverse trough. Value must be a comma separated list of integers in range of [1,31]. Values reference to map file indexes (see FILE_S). If setting is not defined, all map nodes are considered OK.

See Also:

Constant Field Values

Constructor Detail

MapBasedMovement

public MapBasedMovement(Settings settings)

Creates a new MapBasedMovement based on a Settings object's settings.

Parameters:

settings - The Settings object where the settings are read from

MapBasedMovement

public MapBasedMovement(Settings settings,
                        SimMap newMap,
                        int nrofMaps)

Creates a new MapBasedMovement based on a Settings object's settings but with different SimMap

Parameters:

settings - The Settings object where the settings are read from

newMap - The SimMap to use

nrofMaps - How many map "files" are in the map

MapBasedMovement

protected MapBasedMovement(MapBasedMovement mbm)

Copyconstructor.

Parameters:

mbm - The MapBasedMovement object to base the new object to

Method Detail

getInitialLocation

public Coord getInitialLocation()

Returns a (random) coordinate that is between two adjacent MapNodes

Specified by:

getInitialLocation in class MovementModel

Returns:

The initial coordinates for a node

getOkMapNodeTypes

protected int[] getOkMapNodeTypes()

Returns map node types that are OK for this movement model in an array or null if all values are considered ok

Returns:

map node types that are OK for this movement model in an array

getPath

public Path getPath()

Description copied from class: MovementModel

Returns a new path by this movement model or null if no new path could be constructed at the moment (node should wait where it is). A new path should not be requested before the destination of the previous path has been reached.

Specified by:

getPath in class MovementModel

Returns:

A new path or null

selectRandomOkNode

protected MapNode selectRandomOkNode(java.util.List<MapNode> nodes)

Selects and returns a random node that is OK from a list of nodes. Whether node is OK, is determined by the okMapNodeTypes list. If okMapNodeTypes are defined, the given list must contain at least one OK node to prevent infinite looping.

Parameters:

nodes - The list of nodes to choose from.

Returns:

A random node from the list (that is OK if ok list is defined)

getMap

public SimMap getMap()

Returns the SimMap this movement model uses

Returns:

The SimMap this movement model uses

replicate

public MapBasedMovement replicate()

Description copied from class: MovementModel

Creates a replicate of the movement model.

Specified by:

replicate in class MovementModel

Returns:

A new movement model with the same settings as this model