Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jannisborn/gpxfix
A python GUI that helps you to repair the GPX file of your outdoor activity. Helpful if, e.g: (1) your device ran out of battery, (2) you lost GPS signal during the activity, (3) you forgot to unpause after having a break or (4) you forgot to start the tracking at the beginning of your activity
https://github.com/jannisborn/gpxfix
cycling gpx gpxpy python sporttracking strava tkinter
Last synced: 16 days ago
JSON representation
A python GUI that helps you to repair the GPX file of your outdoor activity. Helpful if, e.g: (1) your device ran out of battery, (2) you lost GPS signal during the activity, (3) you forgot to unpause after having a break or (4) you forgot to start the tracking at the beginning of your activity
- Host: GitHub
- URL: https://github.com/jannisborn/gpxfix
- Owner: jannisborn
- License: mit
- Created: 2017-11-22T12:17:26.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-05-22T06:21:45.000Z (over 1 year ago)
- Last Synced: 2024-12-07T12:29:57.693Z (16 days ago)
- Topics: cycling, gpx, gpxpy, python, sporttracking, strava, tkinter
- Language: Python
- Homepage:
- Size: 1.82 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://badge.fury.io/py/gpxfix)
[](https://opensource.org/licenses/MIT)
[](https://pepy.tech/project/gpxfix)
[](https://pepy.tech/project/gpxfix)
[](https://github.com/psf/black)
# gpxfix
A small python-based GUI that helps you reestablishing broken GPX-files.
## When can this be useful?
It's a common issue for every sportsman who loves recording activities. Your device runs out of battery before you come back home, you forgot to start the record when you left home or, even worse but a frequent problem in older iPhones, you lost GPS signal somewhere on the track for a couple of minutes.
Then, checking out your track, you see straight lines or the first/last bit is completelty missing.
## Installation
`gpxfix` ships via `pypi`:
```sh
pip install gpxfix
```
Afterwards, just type `gpxfix` to start the UI
## Usage instruction
1. If you run the file, the default windofw of the GUI shows up:
2. You see a couple of options here, the first step should be to upload your GPX file
3. You get a confirmation message once the file has been parsed successfully
4. Press **Show Tracking Mistakes** to let the algorithm find the missing sections in your file. Per default a tracking mistake is defined as not having recorded a GPX trackpoint for at least **5 sec** with you having moved at least **400m**. I find this okay for cycling but you can change these parameters at the beginning of the code.
1. A window pops up saying *"Great! No error has been found."* This means, your file itself is consistent, but you may want to insert something at the beginning or at the end. To do so, please click on the respective link which directs you to Google Maps. Then you simply have to tell Google where you started/ended your trip.
2. Otherwise, you get an overview of the found errors, i.e. the program displays you the coordinates of the last trackpoint before and the first trackpoint after the missing spot. Now, assuming you want to fill in this gap in your GPX file, please select the number of the error from the dropdown and click **GO!** to instruct GoogleMaps to find the shortest path between the 2 trackpoints. Default vehicle is bicycle. Now you can set easily adjust this snippet such that it fits the route you actually took.
**NOTE: In this window you determine *where* your snippet will be inserted. ** If you want to insert a snippet at the start click "I miss the start of my ride". If you dont select *anything* here, the program will not know *where* to insert your snippet and fail later.
6. Now, we want to merge the snippet we just created with the broken track we recorded. For this, we use a nice tool called [mapstogpx](https://www.mapstogpx.com). Past the link from the Google Maps snippet you just created and download the file (make sure you to tick **Advanced Settings -> Include Elevation** before downloading). Please also make sure to remember the distance of the snippet (according to Googe Maps).
7. Tell the program where you saved the snippet via **Upload GPX fragment**.
8. You have to fill in the distance of the fragment that you want to merge (for some reason, ```gpxpy.geo.haversine_distance``` behaves a bit erratically and consequently speed estimation is imprecise). Then press **OK** and then **Repair!**
9. Hopefully, everything went through and the repaired file was saved in the directory "*Corrected Files*"
10. If you have multiple issues with your GPX file, just repeat the procedure.
Feel free to fork and please report any issues.