Analyze geospacial data tracks
Project description
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for geo_track_analyzer-1.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 126e638f177a943c2797b266dd03a1aa5230f75e128ad52bb2faa1657ce293a4 |
|
MD5 | 4c97e30cd2376aa5fa52194053edccc2 |
|
BLAKE2b-256 | 317099f84ab07d7959aba39ed5d11dcc484d230f8aaf83f4a6711fb784d9d78e |