FitTrack_GarminSync/examples/GarminSync/GPX_SUPPORT.md

GPX File Support in GarminSync

GarminSync now supports processing GPX files with accurate distance calculation using the Haversine formula.

Features

• Parses GPX 1.1 files with extended Garmin TrackPoint extensions
• Calculates total distance using Haversine formula
• Extracts elevation data including gain/loss
• Processes heart rate and cadence data
• Calculates activity duration

Supported Metrics

Metric	Description	Data Source
Distance	Total activity distance	Calculated from GPS coordinates
Duration	Activity duration	Start/end timestamps
Elevation	Min, max, gain, loss	ele tags in track points
Heart Rate	Max and average	gpx:hr extension
Cadence	Average cadence	gpx:cad extension

Implementation Details

The GPX parser:

1. Uses XML parsing to extract track points
2. Calculates distance between points using Haversine formula
3. Processes elevation data to determine gain/loss
4. Handles time zone conversions for timestamps
5. Gracefully handles missing data points

For more details, see the gpx_parser.py file.