/usr/share/doc/osm2pgrouting/Readme.md is in osm2pgrouting 2.2.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 | # osm2pgrouting
[![Join the chat at https://gitter.im/pgRouting/osm2pgrouting](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/pgRouting/osm2pgrouting?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## Requirements
Before you can use this tool for importing Openstreetmap data you need to install:
1. postgresql
2. postgis
3. pgrouting
4. boost
5. expat
6. cmake
and to prepare a database.
## Documentation
See in the documentation of the pgrouting website for more information: http://pgrouting.org
## Installation
For compiling this tool, you will need boost, libpq, expat and cmake:
Then just type the following in the root directory:
```
cmake -H. -Bbuild
cd build/
make
make install
```
If you have libraries installed in non-standard locations, you might need to pass in parameters to cmake. Commonly useful parameters are
Install some prerqeuisites
```
sudo apt-get install expat
sudo apt-get install libexpat1-dev
```
CMAKE options:
-DBOOST_ROOT:PATH=/path/to/boost folder that contains include, lib, bin directories for boost
-DEXPATH_INCLUDE_DIR:PATH=/path/to/expat/include the include folder for where your expat is installed
-DPOSTGRESQL_INCLUDE_DIR:PATH=/path/to/postgresql/include the include folder for postgresql development headers
A cmake with custom options might look something like
```
cmake -DBOOST_ROOT:PATH=/local/projects/rel-boost-1.58.0 \
-DPOSTGRESQL_INCLUDE_DIR:PATH=/local/projects/rel-pg94/include -Bbuild
```
## How to use
Prepare the database:
```
createdb routing
psql --dbname routing -c 'CREATE EXTENSION postgis'
psql --dbname routing -c 'CREATE EXTENSION pgRouting'
```
Start the program like this:
```
osm2pgrouting --f your-OSM-XML-File.osm --conf mapconfig.xml --dbname routing --username postgres --clean
```
Do incremental adition of data without using --clean
```
osm2pgrouting --f next-OSM-XML-File.osm --conf mapconfig.xml --dbname routing --username postgres
```
A complete list of arguments are:
```
Allowed options:
Allowed options:
Help:
--help Produce help message for this version.
-v [ --version ] Print version string
General:
-f [ --file ] arg REQUIRED: Name of the osm file.
-c [ --conf ] arg (=/usr/share/osm2pgrouting/mapconfig.xml)
Name of the configuration xml file.
--schema arg Database schema to put tables.
blank: defaults to default schema
dictated by PostgreSQL
search_path.
--prefix arg Prefix added at the beginning of the
table names.
--suffix arg Suffix added at the end of the table
names.
--addnodes Import the osm_nodes table.
--clean Drop previously created tables.
Database options:
-d [ --dbname ] arg Name of your database (Required).
-U [ --username ] arg (=postgres) Name of the user, which have write access
to the database.
-h [ --host ] arg (=localhost) Host of your postgresql database.
-p [ --port ] arg (=5432) db_port of your database.
-W [ --password ] arg Password for database access.
```
|