django-for-runners 0.4.0

Store your GPX tracks of your running (or other sports activity) in django.

Store your GPX tracks of your running (or other sports activity) in django.

	travis-ci.org/jedie/django-for-runners
	codecov.io/gh/jedie/django-for-runners
	coveralls.io/r/jedie/django-for-runners
	landscape.io/github/jedie/django-for-runners/master

The name Django-ForRunners has the origin from the great Android tracking app ForRunners by Benoît Hervier: http://rvier.fr/#forrunners

We collect some JavaScript files, for easier startup. These files are:

Project	License	storage directory
Leaflet JS	BSD	for_runners/static/leaflet/
Chart.js	MIT	for_runners/static/chartjs/

Screenshots

for-runners v0.4.0 2018-6-26 GPX info.png

for-runners v0.4.0 2018-6-26 Change GPX Track.png

try-out

e.g.:

# create a python virtualenv:
~$ python3 -Im venv DjangoForRunnersEnv

# activate the created virtualenv:
~$ cd DjangoForRunnersEnv/
~/DjangoForRunnersEnv$ source bin/activate

# Upgrate pip:
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv$ pip3 install --upgrade pip

# install django-for-runners:
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv$ pip3 install -e git+https://github.com/jedie/django-for-runners.git@master#egg=django_for_runners

# install dependencies:
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv$ cd src/django-for-runners/
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv/src/django-for-runners$ pip install -r requirements/tests.txt

start the development server, e.g.:

# activate the virtualenv:
~$ cd DjangoForRunnersEnv/
~/DjangoForRunnersEnv$ source bin/activate

# start server:
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv$ cd src/django-for-runners/
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv/src/django-for-runners$ ./run_test_project_dev_server.sh

import GPX files, e.g.:

# activate the virtualenv:
~$ cd DjangoForRunnersEnv/
~/DjangoForRunnersEnv$ source bin/activate

# import:
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv$ cd src/django-for-runners/
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv/src/django-for-runners$ ./manage.py import_gpx --username <username> ~/backups/gpx_files

Note: It is no problem to start import_gpx with the same GPX files: Duplicate entries are avoided. The start/finish (time/latitude/longitude) are compared.

run tests

# activate the virtualenv:
~$ cd DjangoForRunnersEnv/
~/DjangoForRunnersEnv$ source bin/activate

# import:
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv$ cd src/django-for-runners/
(DjangoForRunnersEnv) ~/DjangoForRunnersEnv/src/django-for-runners$ ./setup.py test

Note:

To run all tests, you need:

• Chromium Browser WebDriver e.g.: apt install chromium-chromedriver

• Firefox Browser WebDriver aka geckodriver

install geckodriver e.g.:

~$ cd /tmp
/tmp$ wget https://github.com/mozilla/geckodriver/releases/download/v0.20.1/geckodriver-v0.20.1-linux64.tar.gz -O geckodriver.tar.gz
/tmp$ sudo sh -c 'tar -x geckodriver -zf geckodriver.tar.gz -O > /usr/bin/geckodriver'
/tmp$ sudo chmod +x /usr/bin/geckodriver
/tmp$ rm geckodriver.tar.gz
/tmp$ geckodriver --version
geckodriver 0.20.1
...

some notes

GPX storage

Currently we store the unchanged GPX data in a TextField.

Precision of coordinates

GPX files from Garmin (can) contain:

• latitude with 29 decimal places

• longitude with 28 decimal places

• elevation with 19 decimal places

The route on OpenStreetMap does not look more detailed, with more than 5 decimal places.

See also: https://wiki.openstreetmap.org/wiki/Precision_of_coordinates

Django compatibility

django-for-runners	Django CMS	django version	python
v0.x.x	3.4.x TLS	1.11 TLS	3.5, 3.6

(See also combinations in .travis.yml and tox.ini)

TODO:

• Add real tests

• Support Django CMS v3.5 and run tests against these versions.

• Support Django v2.0 and run tests against these versions.

history

• compare v0.4.0…master dev

• 26.06.2018 - v0.4.0:

  • combine track filters with statistic views

  • NEW: GPX info (See length, point count and Average distance in meters between the points)

  • NEW: Display GPX metadata

  • Add ‘creator’ to every track and use it as changelist filter

  • remove Streetmap image generated via geotiler

  • Speedup by using a cache for gpxpy instances

• 23.06.2018 - v0.3.0:

  • Start adding statistics (See screenshot above)

  • add weather information from metaweather.com to every track

• 21.06.2018 - v0.2.0:

  • Display elevations, heart_rates and cadence_values if available

  • Add kilometer markers to OpenStreetMap

• 15.06.2018 - v0.1.1:

  • a few bugfixes

• 15.06.2018 - v0.1.0:

  • Render interactive OpenStreetMap track map with Leaflet JS

• 12.06.2018 - v0.0.4:

  • Better Events model

  • GPX error handling

  • more tests

  • Bugfix for Python 3.5 (Geotiler needs Python 3.6 or later)

• 12.06.2018 - v0.0.3:

  • display min/average/max heart rate

  • use autotask to generate the MAP in background

• 31.05.2018 - v0.0.2:

  • generate SVG ‘icon’ from GPX track

• v0.0.1 - 30.05.2018

  • Just create a pre-alpha release to save the PyPi package name ;)

links

Homepage	http://github.com/jedie/django-for-runners
PyPi	https://pypi.org/project/django-for-runners/

alternatives (OpenSource only)

• https://github.com/pytrainer/pytrainer (Desktop Program)

• https://github.com/GoldenCheetah/GoldenCheetah/ (Desktop Program)

Online tools:

• https://www.gpsies.com

• https://www.j-berkemeier.de/ShowGPX.html (de)

credits

The whole thing is based on many excellent projects. Especially the following:

• gpxpy GPX file parser

• Leaflet JS A JS library for interactive maps used to render the track on OpenStreetMap

• Chart.js HTML5 Charts

• geopy Get geo location names of the GPX track start/end point

• matplotlib plotting 2D graphics

• autotask schedule background jobs

• svgwrite Generating SVG file

donation

• paypal.me/JensDiemer

• Flattr This!

• Send Bitcoins to 1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F