OsmGpxInclinecalculator is a tool to calculate incline information from GPX traces. It requires the GPS data as 3D-Linestrings, a street network and a table relates the GPS traces to the street network (which trace was recorded on which street segment). Following tools may be used for importing, preprocessing and map matching:
- Importing and filtering by Bbox and elevation attribute: OsmGpxFilter
- Preprocessing of GPS traces (smoothing of elevation): OsmGpxPreprocessor
- MapMatching (requires street network): OsmGpxMapMatcher
The individual names of the database table and the column names can be adjusted in the properties file which is located under resources.
With the tool it is also possible to calculate the incline from a DEM in geotif format (such as SRTM), which is used to evaluate the incline calculated from GPS traces. The path to the geotiff file has to be set in the properties file. If no evaluation is desired just leave the parameter blank or comment it.
- install maven
- install git
- clone project
$ git clone https://github.com/GIScience/osmgpxinclinecalculator
- go into project directory
$ cd osmgpxinclinecalculator/
- run maven
$ mvn clean package
- start application
java -jar target/osmgpxinclinecalculator-0.1.jar <args>
-h,--help displays help
Requiered Arguments:
-D,--database Name of databas
-PW,--password <arg> Password of DB-User
-U,--user <arg> Name of DB-Username
Optional Arguments:
-H,--host <arg> Database host <default:localhost>
-P,--port <arg> Database port <default:5432>
Example java -jar target/osmgpxinclinecalculator-0.1.jar -D gpx_db -U postgres -PW xxx
When using this software for scientific purposes, please cite:
John, S., Hahmann, S., Rousell, A., Loewner, M., Zipf, A. (2016): Deriving incline values for street networks from voluntarily collected GPS traces. Cartography and Geographic Information Science (CaGIS). Taylor & Francis. http://dx.doi.org/10.1080/15230406.2016.1190300 (author manuscript: http://koenigstuhl.geog.uni-heidelberg.de/publications/2016/Hahmann/John_et_al_2016.pdf, version as accepted).
/*|----------------------------------------------------------------------------------------------
*| Heidelberg University
*| _____ _____ _____ _ Department of Geography
*| / ____|_ _|/ ____| (_) Chair of GIScience
*| | | __ | | | (___ ___ _ ___ _ __ ___ ___ (C) 2014
*| | | |_ | | | \___ \ / __| |/ _ \ '_ \ / __/ _ \
*| | |__| |_| |_ ____) | (__| | __/ | | | (_| __/ Berliner Strasse 48
*| \_____|_____|_____/ \___|_|\___|_| |_|\___\___| D-69120 Heidelberg, Germany
*| http://www.giscience.uni-hd.de
*|
*|----------------------------------------------------------------------------------------------*/