Readme for gps2htmlReport-0.3

GPS 2 HTML Report

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

Included in the report:

An example can be seen here.

The hackage page is here.

Installation

A user first of all needs to install the Haskell Platform. For exmaple, on an RPM-based machine, as root:

># yum install haskell-platform

The recommended way to install the `gps2HtmlReport' program, is to grab it via http://hackage.haskell.org:

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

This Haskell program also makes use of the bindings to GraphcsMagick and Cairo, and so the necessary system packages need to be installed, via a Linux package manager.

On an RPM-based package manager, run this command as root:

># yum install GraphicsMagick cairo gtk2hs-buildtools

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.

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

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.