/pgrouting

Repository contains pgRouting library. Development branch is "develop", stable branch is "master"

Primary LanguageC++GNU General Public License v2.0GPL-2.0

pgRouting - Routing on PostgreSQL

Join the chat at https://gitter.im/pgRouting/pgrouting

STATUS

Branches

The master branch reflects the current 2.2.3 release. The develop branch reflects the 2.3.0-dev

LINKS

<tr>
	<td>gh-pages</td>
	<td><img src="https://travis-ci.org/pgRouting/pgrouting.png?branch=gh-pages" alt="Build Status"/></td>
	<td>not enabled</td>
</tr>
Branch Status Comment
master Build Status
develop Build Status

INTRODUCTION

pgRouting extends the PostGIS/PostgreSQL geospatial database to provide geospatial routing and other network analysis functionality.

This library contains following features:

  • All Pairs Shortest Path, Johnson’s Algorithm
  • All Pairs Shortest Path, Floyd-Warshall Algorithm
  • Shortest Path A*
  • Bi-directional Dijkstra Shortest Path
  • Bi-directional A* Shortest Path
  • Shortest Path Dijkstra Family of functions
  • Shortest Path Dijkstra Cost Family of functions
  • Driving Distance
  • K-Shortest Path, Multiple Alternative Paths (Yen's algorithm)
  • Traveling Sales Person
  • Turn Restriction Shortest Path (TRSP)

Additionaly, ready for testing and to be part of 2.3 official version:

  • Shortest Path Dijkstra With Points Family of functions
  • Shortest Path Dijkstra Cost With Points Family of functions
  • Driving Distance With Points
  • K-Shortest Path With Points, Multiple Alternative Paths (Yen's algorithm)
  • Dijkstra Via vertices

Family of functions include:

  • one to one
  • one to many
  • many to one
  • many to many

REQUIREMENTS

  • C and C++ compilers
  • Postgresql version >= 9.1
  • PostGIS version >= 2.0
  • The Boost Graph Library (BGL).
    • Version >= 1.46
  • CMake >= 2.8.8
  • CGAL >= 4.4
  • Sphinx >= 1.2

INSTALLATION

See online documentation: http://docs.pgrouting.org/

COMPILATION

For MinGW on Windows

mkdir build
cd build
cmake -G"MSYS Makefiles" ..
make
make install

Also pre-built Windows binaries can be downloaded from http://.postgis.net/windows_downloads

For Linux

mkdir build
cd build
cmake  ..
make
sudo make install

Build with documentation (requires Sphinx)

cmake -DWITH_DOC=ON ..

Postgresql 9.1+

createdb mydatabase
psql mydatabase -c "CREATE EXTENSION postgis"
psql mydatabase -c "CREATE EXTENSION pgrouting"

USAGE

See online documentation: http://docs.pgrouting.org/2.2/en/doc/index.html

LICENSE

  • Most features are available under GPLv2.
  • Some Boost extensions are available under Boost license (see LICENSE_1_0.txt)
  • Some code contributed by iMaptools.com is available under MIT-X license.