GPXConv

GPX track converter: post-process routes and tracks produced by GPS loggers etc.

• Reads from file(s) given as argument or STDIN and writes to STDOUT or a file.

• Concatenates segments of multiple given tracks or routes (sequential composition), using (header) metadata of the first track, preserving segments, and collecting waypoints.

• Can fill gaps in main input merging data from alternative input (parallel composition).

• Reports missing data and by default ignores points containing implausible data w.r.t. altitude, ascent/descent rate, speed, acceleration/deceleration, and direction change.

• Corrects implausible elevation gain/loss after gaps, typically on exit of tunnel or building

• Optionally filters out points before or after given time limits.

• Optionally filters out points with an element value below or above given limits.

• Optionally prunes comments, extensions, or extension elements with value below or above given limits.

• By default carries over missing altitude and time data between segments.

• By default fills in missing altitude and time data by interpolation within segments.

• By default inserts interpolated points in long time gaps (default 1800 seconds sufficient for exiftool).

• Optionally corrects elevation and and smoothens tracks. (Orthometric height = GPS ellipsoidal height - geoid height, see http://www.unavco.org/edu_outreach/tutorial/geoidcorr.html)

• Produces statistics including ascent/descent rates, optionally also for climbing phases.

• Optionally produces additional statistics on a per-segment or per-day basis.

• Optionally calculates approximate total energy spent by biking along the resulting track.

• Prints information (if enabled), any warnings (if enabled), and errors to STDERR.

Usage:

  gpxconv <option(s) and infile(s)> [> <outfile>]

Command-line options:

  -h | -help | --help          - print these hints and exit
  -version                     - print tool name and version and exit
  -swim, -walk, -cycle, -drive, -fly - type of recorded activity, default: drive
  -no_sanitize                 - do not sanitize trackpoints with implausible data
  -no_insert                   - do not insert trackpoints on long time gaps
  -smooth                      - smoothen tracks
  -phases                      - analyze and provide statistics for ascent/descent phases
  -segs [<n>..[<m>][(+|-)<d>]] - add statistics per segment n..m, may adapt indexes +/-d
  -days [<n>..[<m>][(+|-)<d>]] - add statistics per day n..m, may adapt indexes +/-d
  -merge <file>                - complete gaps in infile(s) by data from given GPX file
  -weight <value>              - calculate biking energy for given weight in kg
  -begin <time>                - ignore points before given time
  -end <time>                  - ignore points after given time
  -min <name> <limit>          - ignore points with element value below limit
  -max <name> <limit>          - ignore points with element value above limit
  -min_ext <name> <limit>      - prune extension elements with value below limit
  -max_ext <name> <limit>      - prune extension elements with value above limit
  -prune_wpts                  - remove waypoints
  -prune_cmts                  - remove comments
  -prune_exts                  - remove track, waypoint, and trackpoint extensions
  -nw                          - do not print warnings
  -ni                          - do not print information
  -o <outfile>                 - output the resulting track to <outfile>
  -debug                       - enable internal consistency checks and debug output

Other options can be set by changing values of the configuration variables.