Visualizing running data through aggregation with hexagonal binning
Its rough purpose is to extract locations from GPS (or whatever it actually is that RunKeeper uses to track your location) tracks, filter to those in a compact area (e.g., Providence, RI), display them in a 2-d histogram with hexagonal binning, and superimpose over a map for context.
A current area of active work is finding colormaps that convey useful information about duration and pace when overlaid on the various map types that the Google Static Maps API makes available. I've found this guide useful but I'm still a long way from a really satisfying solution.
- Make sure you have a working Python 3.x setup and all the requirements listed below. (Alternatively, just use the error messages to figure out what needs to be installed.)
- Place the
hexruns.pyscript in a directory with the runs to be analyzed. If acquired from RunKeeper's data export, these should all have filenames and contents that the script won't choke on.
- Make it executable:
chmod u+x hexruns.py.
- Acquire a Google public API key, as per these instructions.
- Place the API key into a file:
echo "YOUR-KEY" > google_public_api_key.
- Run the script, e.g.,
./hexruns.py "Providence, RI".
For more control over the output, take a look at
TODO: Switch to a smoother install by running the following commands in a destination directory:
git clone https://github.com/othercriteria/hexruns.git cd hexruns/ ./setup.py install