Impedance obsolete Dijkstra

*network-functions obsolete: dijkstra *

Starting from GeoDMS version 7.115, a new set of dijkstra functions replace the ones described below. 
The documentation of the old versions is still available for backward compatibility, 
the old functions will become obsolete in future versions.

syntax

• dijkstra(impedance: LinkSet->Measure, F1: LinkSet->NodeSet, F2: LinkSet->NodeSet, startNodes: startNode->NodeSet)

definition

The dijkstra(impedance, F1, F2, startNodes) function results in the minimum impedance for each node with which a route is available from any of the given startNodes through a network that is defined by the dual link to node relations: F1 and F2. For this, the dijkstra algorithm is applied.

To apply the dijkstra function, first configure a nodeset (based on the origin and destination points) and a linkset (usually based on the segments in an arc set, usually with roads).

The dijkstra function requires four arguments:

1. impedance: a data-item with the impedance of the links in the linkset;
2. F1: relation to the first node of a link set;
3. F2: relation to the last node of a link set;
4. nr_destnode: relation to the destination node in the destination domain unit.

description

The function results in an impedance for the nodes in the nodeset.

Use the lookup function to relate these impedances to a set of destinations (see example).

The dijkstra function result also contains a subitem] named traceback which indicates for each node which link brings it back one step further back towards the nearest start-node. This traceback item can be used to calculate a flow. Use the trace_back function for this purpose.

The dijkstra function is used to apply the dijkstra algorithm in a undirected graph. All links can be traversed in both directions. Use the dijkstra_directed function for directed graphs.

applies to

• data item impedance with float32 or float64 value-type
• data items F1, F2 and nr_destnode with unit32 value type

conditions

The domain units of attributes impedance, F1 and F2 must match.

example

attribute<meter> dist_nodeset (nodeset) := dijkstra(dist ,F1 ,F2, DestNode_rel);  
// replace this obsolete syntax for the new dijkstra functions to:   
   // dijkstra_s(  
   //    'bidirectional;startPoint(Node_rel);node:TraceBack'  
   //   , LinkSet/length, Network/F1, Network/F2, destnoder_rel  
   // )  
  
attribute<meter> distance (origin) := dist_nodeset[network/OrgNode_rel];

domain linkset, nr of rows = 19

domain destination, nr of rows = 4

domain nodeset, nr of rows = 21

domain origin, nr of rows = 5