pgr_prim¶
pgr_prim
— Minimum spanning forest of graph using Prim algorithm.
Availability
Version 3.0.0
New Official function
Support
Description¶
This algorithm finds the minimum spanning forest in a possibly disconnected graph using Prim’s algorithm.
The main characteristics are:
It’s implementation is only on undirected graph.
Process is done only on edges with positive costs.
When the graph is connected
The resulting edges make up a tree
When the graph is not connected,
Finds a minimum spanning tree for each connected component.
The resulting edges make up a forest.
Prim’s running time: \(O(E*log V)\)
EMPTY SET is returned when there are no edges in the graph.
Signatures¶
Summary
pgr_prim(edges_sql)
RETURNS SET OF (edge, cost)
OR EMPTY SET
 Example
Minimum Spanning Forest of a subgraph
SELECT edge, cost FROM pgr_prim(
'SELECT id, source, target, cost, reverse_cost FROM edge_table WHERE id < 14'
) ORDER BY edge;
edge  cost
+
1  1
2  1
3  1
4  1
5  1
6  1
7  1
9  1
10  1
11  1
13  1
(11 rows)
Parameters¶
Parameter 
Type 
Description 

Edges SQL 

SQL query described in Inner query. 
Inner query¶
Column 
Type 
Default 
Description 

id 

Identifier of the edge. 

source 

Identifier of the first end point vertex of the edge. 

target 

Identifier of the second end point vertex of the edge. 

cost 

Weight of the edge (source, target)


reverse_cost 

1 
Weight of the edge (target, source),

Where:
 ANYINTEGER
SMALLINT, INTEGER, BIGINT
 ANYNUMERICAL
SMALLINT, INTEGER, BIGINT, REAL, FLOAT
Result Columns¶
Returns SET OF (edge, cost)
Column 
Type 
Description 

edge 

Identifier of the edge. 
cost 

Cost to traverse the edge. 