Overview

The Shortest Path Faster Algorithm (SPFA) is an improvement of the Bellman–Ford algorithm which computes the shortest path between a source node and all reachable nodes (i.e., single-source shortest paths) in a graph. The algorithm is particularly suitable for graphs that contain negative-weight edges.

The SPFA algorithm was first published by E.F. Moore in 1959, but the name, “Shortest Path Faster Algorithm (SPFA),” was given by FanDing Duan who rediscovered the algorithm in 1994.

• F. Duan, 关于最短路径的SPFA快速算法 [About the SPFA algorithm] (1994)

Concepts

Shortest Path Faster Algorithm (SPFA)

Given a graph G = (V, E) and a source node s∈V, array d[] is used to store the distances of the shortest paths from s to all nodes. Initialize all elements in d[] by infinity except for d[s] = 0.

The basic idea of SPFA is the same as the Bellman–Ford algorithm in that each node is used as a candidate to relax its adjacent nodes. The improvement over the latter is that instead of trying all nodes unnecessary, SPFA maintains a first-in, first-out queue Q to store candidate nodes and only adds a node to the queue if it is relaxed.

The term relaxation refers to the process of updating the distance of a node v that is connected to node u to a potential shorter distance by considering the path through node u. Specifically, the distance of node v is updated to d[v] = d[u] + w(u,v), where w(u,v) is the weight of the edge (u,v). This update is performed only if the current d[v] is greater than d[u] + w(u,v).

At the begining of the algorithm, all nodes have the distance as infinity except for the source node as 0. The source node is viewed as first relaxed and pushed into the queue.

During each iteration, SPFA dequeues a node u from Q as a candidate. For each edge (u,v) in the graph, if node v can be relaxed, the following steps are performed:

• Relax node v: d[v] = d[v] + w(u,v).
• Push node v into Q if v is not in Q.

This process repeats until no more nodes can be relaxed.

The steps below illustrate how to compute the SPFA with source node A and find the weighted shortest paths in the outgoing direction:

Considerations

• The SPFA can handle graphs with negative edge weights under the conditions that (1) the source node cannot access any node within a negative cycle, and (2) the shortest paths are directed. A negative cycle is a cycle where the sum of the edge weights is negative. When negative cycles are present or the shortest paths are undirected when negative weights exist, the algorithm will output infinite results. This happens because it repeatedly traverses through the negative cycle or negative edge, leading to continually decreasing costs each time.
• If there are multiple shortest paths exist between two nodes, all of them will be found.
• In disconnected graphs, the algorithm only outputs the shortest paths from the source node to all nodes belonging to the same connected component as the source node.

Example Graph

To create this graph:

// Runs each row separately in order in an empty graphset
create().edge_property(@default, "value", int32)
insert().into(@default).nodes([{_id:"A"}, {_id:"B"}, {_id:"C"}, {_id:"D"}, {_id:"E"}, {_id:"F"}, {_id:"G"}])
insert().into(@default).edges([{_from:"A", _to:"B", value:2}, {_from:"A", _to:"F", value:4}, {_from:"B", _to:"F", value:6}, {_from:"B", _to:"C", value:3}, {_from:"B", _to:"D", value:3}, {_from:"D", _to:"F", value:2}, {_from:"F", _to:"E", value:1}, {_from:"D", _to:"E", value:2}, {_from:"E", _to:"G", value:3}])

Creating HDC Graph

To load the entire graph to the HDC server hdc-server-1 as hdc_sssp:

CALL hdc.graph.create("hdc-server-1", "hdc_sssp", {
  nodes: {"*": ["*"]},
  edges: {"*": ["*"]},
  direction: "undirected",
  load_id: true,
  update: "static",
  query: "query",
  default: false
})

hdc.graph.create("hdc_sssp", {
  nodes: {"*": ["*"]},
  edges: {"*": ["*"]},
  direction: "undirected",
  load_id: true,
  update: "static",
  query: "query",
  default: false
}).to("hdc-server-1")

Parameters

Algorithm name: sssp

File Writeback

CALL algo.sssp.write("hdc_sssp", {
  params: {
    ids: "A",
    edge_schema_property: "@default.value",
    impl_type: "spfa",
    return_id_uuid: "id"
  },
  return_params: {
    file: {
      filename: "costs"
    }
  }
})

algo(sssp).params({
  project: "hdc_sssp",
  ids: "A",
  edge_schema_property: "@default.value",
  impl_type: "spfa",
  return_id_uuid: "id"
}).write({
  file: {
      filename: "costs"
  }
})

Result:

_id,totalCost
D,5
F,4
B,2
E,5
C,5
G,8

CALL algo.sssp.write("hdc_sssp", {
  params: {
    ids: "A",
    edge_schema_property: "@default.value",
    impl_type: "spfa",
    record_path: 1,
    return_id_uuid: "id"
  },
  return_params: {
    file: {
      filename: "paths"
    }
  }
})

algo(sssp).params({
  project: "hdc_sssp",
  ids: "A",
  edge_schema_property: "@default.value",
  impl_type: "spfa",
  record_path: 1,
  return_id_uuid: "id"
}).write({
  file: {
      filename: "paths"
  }
})

Result:

totalCost,_ids
8,A--[102]--F--[107]--E--[109]--G
5,A--[101]--B--[105]--D
5,A--[102]--F--[107]--E
5,A--[101]--B--[104]--C
4,A--[102]--F
2,A--[101]--B

Full Return

CALL algo.sssp("hdc_sssp", {
  params: {
    ids: 'A',
    edge_schema_property: 'value',
    impl_type: 'spfa',
    record_path: 0,
    return_id_uuid: 'id',
    order: 'desc'
  },
  return_params: {}
}) YIELD r
RETURN r

exec{
  algo(sssp).params({
    ids: 'A',
    edge_schema_property: 'value',
    impl_type: 'spfa',
    record_path: 0,
    return_id_uuid: 'id',
    order: 'desc'
  }) as r
  return r
} on hdc_sssp

Result:

Stream Return

CALL algo.sssp("hdc_sssp", {
  params: {
    ids: 'A',
    edge_schema_property: '@default.value',
    impl_type: 'spfa',
    record_path: 1,
    return_id_uuid: 'id'
  },
  return_params: {
    stream: {}
  }
}) YIELD r
RETURN r

exec{
  algo(sssp).params({
    ids: 'A',
    edge_schema_property: '@default.value',
    impl_type: 'spfa',
    record_path: 1,
    return_id_uuid: 'id'
  }).stream() as r
  return r
} on hdc_sssp

Result: