[ library(graph_algorithms) | Reference Manual | Alphabetic Index ]
# shortest_paths(+Graph, +DistanceArg, +SourceNode, -Paths)

Computes one shortest path from a single source to every reachable node
*Graph*
- a graph structure
*DistanceArg*
- which argument of EdgeData to use as distance: integer
*SourceNode*
- source node number (integer)
*Paths*
- array of Length-EdgeList structures

## Description

Computes one shortest path from the single source node SourceNode
to every node which is reachable from it. In case of multiple
shortest paths with the same length, an arbitrary one is returned.

DistanceArg refers to the graph's EdgeData information that was
specified when the graph was constructed. If EdgeData is a simple
number, then DistanceArg should be 0 and EdgeData will be taken
as the length of the edge. If EdgeData is a compound data structure,
DistanceArg should be a number between 1 and the arity of that
structure and determines which argument of the EdgeData structure
will be interpreted as the edge's length. Important: the distance
information in EdgeData must be a non-negative number, and the
numeric type (integer, float, etc) must be the same in all edges.

If DistanceArg is given as -1, then any EdgeData is ignored and
the length of every edge is assumed to be equal to 1.

SourceNode is the common starting point for the computed paths.

The results are returned as an array ranging over all node numbers.
For unreachable nodes the array element is uninstantiated.
For reachable nodes, the element contains a Length-EdgeList structure
where Length is the length of the shortest path and EdgeList is that
path (or one of them) in reverse order, i.e. starting with the edge
reaching the target and ending with the edge starting from SourceNode.

### Modes and Determinism

- shortest_paths(+, +, +, -) is det

## Examples

?- sample_graph(G), shortest_paths(G, 0, 1, P).
P = [](2 - [e(2, 1, 1), e(1, 2, 1)], 1 - [e(1, 2, 1)], ...)

## See Also

single_pair_shortest_path / 5, all_short_paths_as_edges / 6, all_short_paths_as_graph / 6, single_pair_short_path / 6, single_pair_all_short_paths_as_graph / 7, possible_path / 7