Skip to content

Latest commit

 

History

History
102 lines (75 loc) · 3.12 KB

README.md

File metadata and controls

102 lines (75 loc) · 3.12 KB

GPS 2 HTML Report

This is a utility written in Haskell, to generate HTML reports from GPS track files.

Included in the report:

  • Details of the journey... journey time, distance travelled etc..
  • Diagrams charting speed, elevation, accumulated distance etc..
  • OpenStreetMap diagram highlighting the GPS track

An example can be seen here.

The hackage page is here.

Installation

A user first of all needs to install the Haskell Platform, and a few additional system packages - GraphcsMagick and Cairo . For exmaple, on an RPM-based machine, as root:

># yum install haskell-platform GraphicsMagick cairo gtk2hs-buildtools

The recommended way to install the gps2HtmlReport program, is to grab it via hackage:

cabal update
cabal install gps2htmlReport

Or to install the version in the github repository:

git clone git://github.com/robstewart57/Gps2HtmlReport.git
cd Gps2HtmlReport
cabal update
cabal configure
cabal install

Prerequisites

First of all, you need to have your GPS date in a GPX file. There are many gpx exporters available. I use my Android phone to take GPX tracks, with a great application, OSMTracker. This application allows you to export your GPS tracks to GPX. I am sure that there are plenty of good applications for iOS to perform the same function. And I'm aware that GPS devices allow .gpx files to be extracted from GPS logs.

Usage

The program will search for all files ending in ".gpx", and for each one, generate a HTML report.

$ cd $location_of_gpx_files
$ ls
1.gpx
$ gps2HtmlReport --help

gps2HtmlReport [OPTIONS]
  A Haskell utility to generate HTML page reports of GPS Tracks and Track
  overlays on OpenStreetMap tiles

Common flags:
  -i --imageonly  Generates only an image of the track overlay on an
                  OpenStreetMap layer
  -a --archive    Produce tar archive for web and image files
     --hashnames  Create reports in hashed directory names
  -h --help       Display help message
  -v --version    Print version information
  -V --Verbose    Loud verbosity
  -q --quiet      Quiet verbosity

Problems

If you receive this error when trying to run the program:

can't load .so/.DLL for: stdc++ (libstdc++.so: cannot open shared object file: No such file or directory)

... then you are experiencing this bug: #5289.

To fix this

  • Fedora 32bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/lib/
  • Fedora 64bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/lib64/
  • Ubuntu 32bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/local/lib/
  • Ubuntu 64bit: $# ln -vs $(gcc --print-file-name=libstdc++.so) /usr/local/lib64/

If you experience other problems, please let me know - and preferrably sending me the problematic .gpx file.

Credits

Thanks to Thomas DuBuisson, for implementing the `gps' package and contributing it to Hackage.