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

Package class diagram package IPFKnownMapView
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


Copyright © 2014 AMIS research group, Faculty of Mathematics and Physics, Charles University in Prague, Czech Republic. All Rights Reserved.