cz.cuni.amis.pathfinding.map
Interface IPFKnownMapView<NODE>

All Superinterfaces:

IPFMapView<NODE>

All Known Implementing Classes:

IPFKnownMapView.DefaultView

public interface IPFKnownMapView<NODE>
extends IPFMapView<NODE>

This interface provides additional information about the map algorithms are going to work with. In its implementation you may provide custom view on the map as needed for your search (for instance you need to forbid some nodes / edges or change the general cost of nodes / edges in order to change how your agent is going to plan the path).

Generally, you will use IPFKnownMap interface to define the map in general and then use this IPFKnownMapView interface to specify a specific needs you need to impose over the map as is "forbidding" some nodes or "imposing additional costs onto the nodes".

See also IPFMapView

Author:

Jimmy

Nested Class Summary

static class

IPFKnownMapView.DefaultView<NODE> Default view does not impose any specific view on the map...

Method Summary

Collection<NODE>

getExtraNodes(Collection<NODE> mapNodes) This method may return new nodes which are not present in standard 'map' (as returned by IPFKnownMap.getNodes()).

Methods inherited from interface cz.cuni.amis.pathfinding.map.IPFMapView

getArcExtraCost, getExtraNeighbors, getNodeExtraCost, isArcOpened, isNodeOpened

Method Detail

getExtraNodes

Collection<NODE> getExtraNodes(Collection<NODE> mapNodes)

This method may return new nodes which are not present in standard 'map' (as returned by IPFKnownMap.getNodes()). Such nodes are then exclusively accessible to your particular agent, that is, this methods is adding nodes that can be accessed by the agent but are not part of your general map description.

Returned collection must not contain multiple references to a single node.

Returned collection must not contain any node from "mapNodes".

Parameters:

mapNodes - "nodes" of map as returned by IPFKnownMap.getNodes(), may return null