pytopo 1.6.5

Tiled map viewer and track editor, using cached offline map tiles and track files

PyTopo

PyTopo is a tiled map viewer and a track log viewer/editor.

Downloaded map tiles are cached locally, so you can use PyTopo offline if you've already cached the tiles for an area.

See the project home page at http://shallowsky.com/software/topo for more information, examples, screenshots, hints on creating custom maps, and more.

By default, PyTopo uses tiles from OpenStreetMap, but you can specify a variety of tile sources (which may or may not require API keys); or you can create your own tiles. It can also use tiles from a few commercial programs like the old National Geographic Topo!

The package also includes ellie, a simple script for reporting and plotting distance and elevation change statistics from a GPX track log. More information: http://shallowsky.com/software/ellie/

Track Logs and Waypoints

PyTopo can read track logs in GPX, KML, KMZ or geojson format. It can make simple edits, like splitting a track or deleting to the begin or end point and can save as GPX.

It can also measure distances and bearing angles between points, or report the coordinates of a point.

Installing and Dependencies

You can install PyTopo with pip install pytopo

Dependencies include GTK (and its various dependencies), numpy, and (optionally) matplotlib. If you want to read from a GPS, you'll need gpsd and python-gps.

The first time you run pytopo, it will create a ~/.config/pytopo directory for its configuration files, and a ~/Maps directory for map data.

Other Info

pytopo -h gives usage examples.

If you need custom maps., edit ~/.config/pytopo/pytopo.sites to add new map Collections (see examples in that file or on the project home page).

Code contributions appreciated!

Tests and Documentation

There are some unit tests in the test/ directory; run them with python -m unittest discover from the top-level directory.

The docs directory contains documentation on the two apps and the API. To build the documentation:

python setup.py build_sphinx

or

cd sphinxdoc
make html

Happy mapping!