gpx-vis 0.3.0

Plots your Komoot tours

About gpx_vis

gpx_vis allows simple and easy visualisation of your cycling/walking tours.

Important: currently only works for .GPX from completed paths in Komoot. In development.

Install

pip install gpx_vis

Update to the latest version:

pip install gpx_vis --upgrade

Instantiate

from gpx_vis import Track

track = Track(pathname)

pathname serves as a reference to either a single .gpx file or a directory. If a directory path is provided, all .gpx files contained within that directory will be merged, but retain their original metadata (e.g., different tracks remain separated). This allows users to overlay multiple tracks onto a single map, providing a comprehensive summary of the data being analyzed.

Map creation

track.create_map(filename)

This creates an html file saved to path2file. An interactive html map will be created. Hover mouse over route, or click on final waypoints (flag marker) for further info.

If you have been very hard-working, thus having a large set of datapoints on the map: there is an option to include lite = True. By default, this limits the datapoints on each route to 50. This number can be tweaked via the nlite argument. E.g.,

track.create_map(filename, lite=True, nlite=100)

City overview

track.city_list

Curious which city you went through along the way? This command creates a list of cities - sorted by country then name - that were detected through the tour. The frequency parameter tells how many times a city was encountered; it should somewhat correlate to time spent in that city.

Additional information

Should you wish to plot/inspect different values, these parameters are also accesssible via:

track.t: time (UTC)
track.x: longitude (deg)
track.y: latitude (deg)
track.z: elevation (m)