Skip to main content

Analyze geospacial data tracks

Project description

Testing Build Documentation PyPI - Python Version PyPI - License PyPI - Version

Track analyzer

The focus of this package lies on analyzing and visualizing tracks of cycling or similar activities. Depending on the usecase settings like stopped_speed_threshold or max_speed_percentile may not be appropriate.

Installing the package with cli extra, I.e. using pip install geo-track-analyzer[cli], add utility tools. See the documentation for details.

From files

Tracks my be initialized from .gpx and .fit files using the GPXFileTrack and FITTrack object, respectively.

Programmatically

You can instanciate tracks programmatically inside your code using the PyTrack class.

PyTrack(
        points: list[tuple[float, float]] = ...,
        elevations: None | list[float] = ...,
        times: None | list[datetime] = ...,
        heartrate: None | list[int] = None,
        cadence: None | list[int] = None,
        power: None | list[int] = None,
    )

Extracting track data

The data of the track can be extracted into a pandas DataFrame object with the columns:

  • latitude: Track point latitude value
  • longitude: Track point longitude value
  • elevation: Track point elevation value
  • speed: Speed in m/s calculated relative to previous point. Requires time to be present in track.
  • distance: Distance in m relative to previous point
  • heartrate: Heartrate in bpm (if present in input)
  • cadence: Cadence in rmp(if present in input)
  • power: Power in W (if present in input)
  • time: Time in seconds relative to previous point. Time must be present in track.
  • cum_time: Cummulated time of the track/segment in seconds. Requires time to be present in track.
  • cum_time_moving: Cummulated moving time of the track/segment in seconds. Requires time to be present in track.
  • cum_distance: Cummulated distance in track/segement in meters.
  • cum_distance_moving: Cummulated moving distance in track/segement in meters.
  • cum_distance_stopped: Cummulated stopped distance in track/segement in meters.
  • moving: Bool flag specifing if the stopped_speed_threshold was exceeded for the point.

Because some values are relative to previous points, the first point in the segment is not represented in this dataframe.


Furthermore an summary of the segments and tracks can be generated in the form of a SegmentOverview containing:

  • Time in seconds (moving and totoal)
  • Distance in meters and km (moving and totoal)
  • Maximum and average velocity in m/s and km/h
  • Maximum and minimum elevation in meters
  • Uphill and downhill elevation in meters

Visualizing the track

Visualizations of a track can be generated via the plot method and the kind parameter. See documentation for further details and examples how to use the visualizations.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geo_track_analyzer-1.5.0.tar.gz (144.2 kB view details)

Uploaded Source

Built Distribution

geo_track_analyzer-1.5.0-py3-none-any.whl (152.3 kB view details)

Uploaded Python 3

File details

Details for the file geo_track_analyzer-1.5.0.tar.gz.

File metadata

  • Download URL: geo_track_analyzer-1.5.0.tar.gz
  • Upload date:
  • Size: 144.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.10

File hashes

Hashes for geo_track_analyzer-1.5.0.tar.gz
Algorithm Hash digest
SHA256 4fb92eb52d4326c23bbd4a01c5f6038d54b00f8a87153c9ee04f257e522f526c
MD5 f55c535334a13b169625dc14ae74b132
BLAKE2b-256 d0fd6733516af8d38a80a8bb863831f9107bbad92c7e2c62644f55b49924321e

See more details on using hashes here.

File details

Details for the file geo_track_analyzer-1.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for geo_track_analyzer-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5920f26d1d2c2dfa734f74c94dc48a11e144e4cd7c66588abfeacdc3b23f277a
MD5 3ceecbed2abe19b773aeb160c9c94f2c
BLAKE2b-256 e9024019ccec84a9bcd4c2e20d97a57a43a3536a9316102147690e31641d1eb8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page