Skip navigation links

Oracle® Spatial Java API Reference
11g Release 1 (11.1)

B28401-02


Package oracle.spatial.network.lod

Provides support for the Load-On-Demand (LOD) approach of network analysis in the Oracle Spatial network data model, which is documented in Oracle Spatial Topology and Network Data Models.

See:
          Description

Interface Summary
CachedNetworkIO This interface defines methods related to cached network input and output.
CachedNetworkIOWM This interface defines methods related to work space change.
CachingHandler This interface defines the methods supported by a caching handler.
HeuristicCostFunction This interface defines the heuristic cost function from one node to another node.
KShortestPaths This interface defines methods supported by a k-shortest path algorithm.
LinkCostCalculator This interface defines the method supported by a link cost calculator.
LinkLevelSelector A LinkLevelSelector selects the link level for the next node to expend on.
LODAnalysisInfo This interface defines methods related to analysis information.
LODGoalNode This interface defines the methods to check whether a given node is a goal node for network analysis.
LODNetworkConstraint This interface defines a general network constraint for network analysis.
LODUserDataIO This interface defines methods to read and write user defined data from and to the database.
LogicalBasicNetwork This interface defines methods supported by a logical network.
LogicalHeavyPath A LogicalHeavyPath is a logical path with detailed node and link information.
LogicalLink This interface defines a standalone link.
LogicalNetLink A LogicalNetLink defines a network link, which is a LogicalLink with reference to the LogicalNetNode objects of the start and end nodes.
LogicalNetNode A LogicalNetNode is a LogicalNode with reference to adjacent node and link objects.
LogicalNode This interface defines a standalone node.
LogicalPartition This interface defines methods supported by a logical network partition.
LogicalPath A LogicalPath is defined by an array of link IDs, array of node IDs, and the cost of traversing through this path.
LogicalSubNetwork A LogicalSubNetwork is a LogicalNetwork that maintains connections to external nodes.
LogicalSubPath LogicalSubPath represents a portition of a LogicalPath, with the start and/or end points located on links of the the containing path.
MinimumSpanningTree This interface defines methods supported by a minimum-spanning-tree algorithm.
NetworkIO This interface defines methods to read/write network information from/to a datasource.
NodeCostCalculator This interface defines the methods supported by a node cost calculator.
PartitionBlobTranslator This interface defines the methods supported by a partition blob translator.
ShortestPath This interface defines methods supported by a shortest path algorithm.
SpatialBasicNetwork A SpatialNetwork is a LogicalNetwork with geometry information.
SpatialHeavyPath A SpatialHeavyPath is a LogicalHeavyPath with geometry information.
SpatialLink A SpatialLink is a LogicalLink with geometry information.
SpatialNetLink A SpatialNetLink is a LogicalNetLink with geometry information.
SpatialNetNode A SpatialNetNode is a LogicalNetNode with geometry information.
SpatialNode A SpatialNode is a LogicalNode with geometry information.
SpatialPartition A SpatialPartition is a LogicalPartition with geometry information.
SpatialPath A SpatialPath is a LogicalPath with geometry information.
SpatialSubNetwork A SpatialSubNetwork is a LogicalSubNetwork with geometry information.
SpatialSubPath A SpatialSubPath is a LogicalSubPath with geometry information.
TSP This interface defines methods supported by traveling salesman problem algorithm.

 

Class Summary
AStar This class implements A* shortest path algorithm.
DummyLinkCostCalculator This implementation of LinkCostCalculator always returns 0 for link cost.
DummyLinkLevelSelector This implementation of LinkLevelSelector always returns the fixed link level specified in the constructor.
DummyNodeCostCalculator This implementation of NodeCostCalculator always returns 0 for node cost.
DynamicLinkLevelSelector This implementation of LinkLevelSelector dynamically assigns link level to the next node according to the attributes of the current node and the location of the next node.
EuclideanCostFunction This class implements the A* heuristic cost function as the 2D euclidean distance between the current node and the goal node.
GeodeticCostFunction This class implements the AStar heuristic cost as the 2D geodetic distance in meters between the current node and the goal node.
LeveledNetworkCache An instance of this class contains the cache for all link leveles of a network.
LODNetworkFactory This class handles network element creation for Oracle Spatial Network Data Model.
LODNetworkManager This class is the entry point of all functionalities provides by the lod package.
LODNetworkWrapper This is the wrapper class containing LOD related java stored procedures used by SDO_NET package.
LRUCachingHandler This class implements the Least Recently Used (LRU) caching handler.
NetworkAnalyst This class is the single entry point to all the network analysis operations supported by NDM LOD.
NetworkUpdate An instance of this class contains the network update information for a network.
OrderedLongSet Ordered Long Set
PartitionUpdate A PartitionUpdate object contains the update information to a partition.
PointOnNet This class defines the properties of a point on a network.
TSPLK This class implements the Lin-Kernighan heuristic for the Traveling-Salesman-Problem.
TspPath A TspPath consists of a LogicalSubPath and an array of points on the TSP tour.
YenDeviation This class implements Yen's Deviation Algorithm for finding the k shortest loopless paths.

 

Enum Summary
TSP.TourFlag Enumeration whose values indicate whether a tsp tour is open or closed, and if open, whether the tour have fixed start and/or end node IDs.

 

Exception Summary
LinkNotFoundException Thrown when a link(s) cannot be found.
LODNetworkException Base exception class for Load-On-Demand network analysis.
MethodNotSupportedException Thrown when an unsupported or invalid method is called.
NodeNotFoundException Thrown when a node(s) cannot be found.

 

Package oracle.spatial.network.lod Description

Provides support for the Load-On-Demand (LOD) approach of network analysis in the Oracle Spatial network data model, which is documented in Oracle Spatial Topology and Network Data Models.

This package provides methods to
- read network information,
- perform network analysis, and
- store analysis results,
- configure the load-on-demand settings, such as cache size, caching policy, load network from the node/link tables or from the blobs, etc.,

LODNetworkManager is the entry point for all the functionalities provided by this package.
To read network information, first obtain a NetworIO object from the NetworkManager, and then call various network IO methods provided by NetworkIO. For example,

  NetworkIO networkIO    = LODNetworkManager.getCachedNetworkIO(myConnection, "MYNETWORK", "MYNETWORK");
  int numberOfPartitions = networkIO.readNumberOfPartitions(1);
  int numberOfNodes      = networkIO.readNumberOfNodes(1);
  LogicalPartition part  = networkIO.readLogicalPartition(1, 1, true, true);

To analyze a network, first obtain a NetworkAnalyst object from the NetworkManager, and then call the various network analysis functions provided by the network analyst. For example,

  NetworkAnalyst analyst = LODNetworkManager.getNetworkAnalyst(networkIO);
  LogicalSubPath path = analyst.shortestPathDijkstra(
                          new PointOnNet(2000), new PointOnNet(6700), null);
  LogicalSubPath[] paths = analyst.nearestNeighbors(
                             new PointOnNet(2000), 10, null, null);

To configure load-on-demand settings, create/edit your LOD configuration xml file, obtain the ConfigManager object from the NetworkManager, and then call the loadConfig method to load the configuration. For example,

  InputStream in = Class.getSystemResourceAsStream("lodconfig.xml");
  LODNetworkManager.getConfigManager().loadConfig(in);

Skip navigation links

Oracle® Spatial Java API Reference
11g Release 1 (11.1)

B28401-02


Copyright © 2007, 2008, Oracle. All Rights Reserved.