Interface ShortestPathSingleSource.IResult
-
- All Superinterfaces:
ShortestPathSingleSource.Result<Integer,Integer>
- Enclosing interface:
- ShortestPathSingleSource
public static interface ShortestPathSingleSource.IResult extends ShortestPathSingleSource.Result<Integer,Integer>
A result object for theShortestPathSingleSource
problem forIntGraph
.- Author:
- Barak Ugav
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description int
backtrackEdge(int target)
Get the last edge on the shortest path from the source to the given target.default Integer
backtrackEdge(Integer target)
Deprecated.Please usebacktrackEdge(int)
instead to avoid un/boxing.double
distance(int target)
Get the distance to a target vertex.default double
distance(Integer target)
Deprecated.Please usedistance(int)
instead to avoid un/boxing.IPath
getPath(int target)
Get shortest path to a target vertex.default IPath
getPath(Integer target)
Deprecated.Please usegetPath(int)
instead to avoid un/boxing.IntGraph
graph()
Get the graph on which the shortest paths were computed on.default IntGraph
shortestPathTree()
Get the shortest path tree.default IntGraph
shortestPathTree(boolean directed)
Get the shortest path tree, optionally directed or undirected.default Integer
source()
Deprecated.Please usesourceInt()
instead to avoid un/boxing.int
sourceInt()
Get the source vertex from which all shortest paths were computed from.
-
-
-
Method Detail
-
distance
double distance(int target)
Get the distance to a target vertex.- Parameters:
target
- a target vertex in the graph- Returns:
- the sum of the shortest path edges from the source to the target, or
Double.POSITIVE_INFINITY
if no such path found. - Throws:
NoSuchVertexException
- iftarget
is not a vertex in the graph
-
distance
@Deprecated default double distance(Integer target)
Deprecated.Please usedistance(int)
instead to avoid un/boxing.Get the distance to a target vertex.- Specified by:
distance
in interfaceShortestPathSingleSource.Result<Integer,Integer>
- Parameters:
target
- a target vertex in the graph- Returns:
- the sum of the shortest path edges from the source to the target, or
Double.POSITIVE_INFINITY
if no such path found
-
getPath
IPath getPath(int target)
Get shortest path to a target vertex.- Parameters:
target
- a target vertex in the graph- Returns:
- the shortest path from the source to the target or
null
if no such path found - Throws:
NoSuchVertexException
- iftarget
is not a vertex in the graph
-
getPath
@Deprecated default IPath getPath(Integer target)
Deprecated.Please usegetPath(int)
instead to avoid un/boxing.Get shortest path to a target vertex.- Specified by:
getPath
in interfaceShortestPathSingleSource.Result<Integer,Integer>
- Parameters:
target
- a target vertex in the graph- Returns:
- the shortest path from the source to the target or
null
if no such path found.
-
backtrackEdge
int backtrackEdge(int target)
Get the last edge on the shortest path from the source to the given target.The backtrack edge is an in-edge of the given target vertex. The set of all backtrack edges of all vertices define the shortest path tree of the source, and each shortest path can be constructed from them.
- Parameters:
target
- a target vertex in the graph- Returns:
- the backtrack edge, the last edge on the shortest path from the source to th given target, or
-1
if there is no path to the target or the target is the source
-
backtrackEdge
@Deprecated default Integer backtrackEdge(Integer target)
Deprecated.Please usebacktrackEdge(int)
instead to avoid un/boxing.Get the last edge on the shortest path from the source to the given target.The backtrack edge is an in-edge of the given target vertex. The set of all backtrack edges of all vertices define the shortest path tree of the source, and each shortest path can be constructed from them.
- Specified by:
backtrackEdge
in interfaceShortestPathSingleSource.Result<Integer,Integer>
- Parameters:
target
- a target vertex in the graph- Returns:
- the backtrack edge, the last edge on the shortest path from the source to th given target, or
null
if there is no path to the target or the target is the source
-
shortestPathTree
default IntGraph shortestPathTree()
Description copied from interface:ShortestPathSingleSource.Result
Get the shortest path tree.The shortest path tree is constructed from the vertices and edges used by any shortest path. It contains only the vertices reachable from the source, and for each vertex other than the source the graph will contains the edge that was used to reach it (see
ShortestPathSingleSource.Result.backtrackEdge(Object)
). If there are \(k\) reachable vertices, the graph will contain \(k-1\) edges.The returned graph will be directed if the original graph is directed. In such case, the tree is directed from the source to the other vertices. To control the directionality of the returned graph, use
ShortestPathSingleSource.Result.shortestPathTree(boolean)
.- Specified by:
shortestPathTree
in interfaceShortestPathSingleSource.Result<Integer,Integer>
- Returns:
- undirected shortest path tree
-
shortestPathTree
default IntGraph shortestPathTree(boolean directed)
Description copied from interface:ShortestPathSingleSource.Result
Get the shortest path tree, optionally directed or undirected.The shortest path tree is constructed from the vertices and edges used by any shortest path. It contains only the vertices reachable from the source, and for each vertex other than the source the graph will contains the edge that was used to reach it (see
ShortestPathSingleSource.Result.backtrackEdge(Object)
). If there are \(k\) reachable vertices, the graph will contain \(k-1\) edges.- Specified by:
shortestPathTree
in interfaceShortestPathSingleSource.Result<Integer,Integer>
- Parameters:
directed
- iftrue
the returned tree will be directed. If the original graph was undirected and a directed tree is created, the edges in the tree will be directed from the source towards the other vertices- Returns:
- un/directed shortest path tree
-
sourceInt
int sourceInt()
Get the source vertex from which all shortest paths were computed from.- Returns:
- the source vertex
-
source
@Deprecated default Integer source()
Deprecated.Please usesourceInt()
instead to avoid un/boxing.Get the source vertex from which all shortest paths were computed from.- Specified by:
source
in interfaceShortestPathSingleSource.Result<Integer,Integer>
- Returns:
- the source vertex
-
graph
IntGraph graph()
Description copied from interface:ShortestPathSingleSource.Result
Get the graph on which the shortest paths were computed on.- Specified by:
graph
in interfaceShortestPathSingleSource.Result<Integer,Integer>
- Returns:
- the graph on which the shortest paths were computed on.
-
-