Class DijkstraShortestPath<V,E>

java.lang.Object
org.jgrapht.alg.shortestpath.BaseShortestPathAlgorithm<V,E>
org.jgrapht.alg.shortestpath.DijkstraShortestPath<V,E>
Type Parameters:
V - the graph vertex type
E - the graph edge type
All Implemented Interfaces:
ShortestPathAlgorithm<V,E>

public final class DijkstraShortestPath<V,E> extends BaseShortestPathAlgorithm<V,E>
An implementation of Dijkstra's shortest path algorithm using a pairing heap by default. A custom heap implementation can by specified during the construction time.
  • Field Details

    • radius

      private final double radius
    • heapSupplier

      private final Supplier<org.jheaps.AddressableHeap<Double,Pair<V,E>>> heapSupplier
  • Constructor Details

    • DijkstraShortestPath

      public DijkstraShortestPath(Graph<V,E> graph)
      Constructs a new instance of the algorithm for a given graph. The constructed algorithm will use pairing heap as a default heap implementation.
      Parameters:
      graph - the graph
    • DijkstraShortestPath

      public DijkstraShortestPath(Graph<V,E> graph, double radius)
      Constructs a new instance of the algorithm for a given graph. The constructed algorithm will use pairing heap as a default heap implementation.
      Parameters:
      graph - the graph
      radius - limit on path length, or Double.POSITIVE_INFINITY for unbounded search
    • DijkstraShortestPath

      public DijkstraShortestPath(Graph<V,E> graph, Supplier<org.jheaps.AddressableHeap<Double,Pair<V,E>>> heapSupplier)
      Constructs a new instance of the algorithm for a given graph. The constructed algorithm will use the heap supplied by the heapSupplier
      Parameters:
      graph - the graph
      heapSupplier - supplier of the preferable heap implementation
    • DijkstraShortestPath

      public DijkstraShortestPath(Graph<V,E> graph, double radius, Supplier<org.jheaps.AddressableHeap<Double,Pair<V,E>>> heapSupplier)
      Constructs a new instance of the algorithm for a given graph.
      Parameters:
      graph - the graph
      radius - limit on path length, or Double.POSITIVE_INFINITY for unbounded search
      heapSupplier - supplier of the preferable heap implementation
  • Method Details

    • findPathBetween

      public static <V, E> GraphPath<V,E> findPathBetween(Graph<V,E> graph, V source, V sink)
      Find a path between two vertices. For a more advanced search (e.g. limited by radius or using another heap), use the constructor instead.
      Type Parameters:
      V - the graph vertex type
      E - the graph edge type
      Parameters:
      graph - the graph to be searched
      source - the vertex at which the path should start
      sink - the vertex at which the path should end
      Returns:
      a shortest path, or null if no path exists
    • getPath

      public GraphPath<V,E> getPath(V source, V sink)
      Get a shortest path from a source vertex to a sink vertex.
      Parameters:
      source - the source vertex
      sink - the target vertex
      Returns:
      a shortest path or null if no path exists
    • getPaths

      public ShortestPathAlgorithm.SingleSourcePaths<V,E> getPaths(V source)
      Compute all shortest paths starting from a single source vertex.

      Note that in the case of Dijkstra's algorithm it is more efficient to compute all single-source shortest paths using this method than repeatedly invoking getPath(Object, Object) for the same source but different sink vertex.

      Specified by:
      getPaths in interface ShortestPathAlgorithm<V,E>
      Overrides:
      getPaths in class BaseShortestPathAlgorithm<V,E>
      Parameters:
      source - the source vertex
      Returns:
      the shortest paths