MyDigitalLife

GpsPrune

The GpsPrune component is a slightly modified version of GpsPrune by Activity Workshop, so all credits go to them.

Things to know to get started

Configuration file

Many things can be specified by a configuration file. The name of this file is ‘\users\<user-name>\.pruneconfig’.

The following settings are available:

  • prune.gnuplotpath
    TODO
  • prune.showmap
    If set to ‘1’ an Open Street Map map is shown as background of the GPX track. With other values (normally ‘0’) no map is shown.
  • prune.gpsbabelpath
    TODO
  • prune.trackdirectory
    Initial folder for ‘File/Open’.
    If not set, the value of ‘prune.photodirectory’ is used.
  • prune.photodirectory
    Initial folder for ‘File/Add photos’.
  • prune.unitsetkey
    Set the units used. E.g. ‘unitset.kilometres’ set the unit for distances to kilometers.
  • prune.coorddisplay
    TODO
  • prune.waypointiconsize
    TODO I would expect this to set the size of the waypoint markers, but I haven’t seen this working.
  • prune.mapsource
    TODO
  • prune.povrayfont
    TODO E.g. ‘crystal.ttf’.
  • prune.autosavesettings
    TODO
  • prune.exiftoolpath
    TODO E.g. exiftool
  • prune.terraingridsize
    TODO E.g. ’50’.
  • prune.diskcache
    Shall point to an existing folder where OSM tiles will be cached. If not pointing to a valid folder there will be no map displayed.
  • prune.gpsformat
    TODO E.g. ‘garmin’.
  • prune.linewidth
    TODO I would expect it to set the width of the line between the waypoints, but I haven’t seen this working.
  • prune.kmzimagewidth
    TODO E.g. ‘240’.
  • prune.antialias
    TODO
  • prune.gpsdevice
    TODO E.g. ‘usb\:’
  • prune.altitudetolerance
    TODO
  • prune.recentfiles=6;;;;;;
    TODO
  • prune.lastimportfileformat
    TODO
  • prune.heightexaggeration
    Default ‘Altitude exaggeration factor’ for a Three-D view of the GPS track. The value is specified as 100 times the actual value.
  • prune.waypointicons
    TODO
  • prune.windowbounds
    TODO

Open street map cache folder

Make sure that prune.diskcache is set to point to an existing folder, where the OSM tiles will be cached.

Description of the menu’s

File

Open file

Open a GPS file. This following formats are supported:

  • TXT files
    TODO
  • KML files
    Only the locations are shown.
  • KMZ files
    Only the locations are shown.

The folder that will initially be opened can be set via prune.trackdirectory.

If you open a file, while there is already a file opened, you’re asked if you want to ‘Append this data to the data already loaded?’. If you select ‘Yes’, the segments of the newly opened file are added as segments to the existing track. If you select no, the current data is discarded.

Import file with GPSBabel

Import a file with GPS information, using GPSBabel. This command requires an installation of GPSBabel.

Add photos

Add photos. Of each photo only the location is marked.

Add audio clips

TODO

Recent files

A list of recently opened files.

Load data from GPS

Requires GPSBabel.
TODO

Send data to GPS

Requires GPSBabel.
TODO

Save as text

Save the track point as a delimiter separated list (i.e. as a CSV file). You can select the delimiter character, which fields to save and more.

Export KML

Export the data to a Google Earth KML or KMZ file. Both tracks and photos are exported and can than be shown on Google Earth.

Export GPX

Export the data as a GPX file.

Export POV

Export a 3D view as a POV-Ray file. For details see View/Three-D view

Export image

Export the data as an image.

  • Draw track on map
    Draws the track (lines between the track points) on the map.
  • Draw track points
    Marks the track points, as small squares, on the map.
  • Base image
    It’s required to specify a base image. So click the ‘Edit’ button which opens the ‘Map image’ dialog. In this dialog select ‘Use image’ and then select a ‘Map source’. See Map sources for details about the available sources.
    Note however that here only map sources can be used which exist in the map cache, which typically are sources which were selected via ‘Settings/Set map background’ .

Online

Get altitudes from SRTM

TODO

Download SRTM files

TODO

Map in a browser window

TODO

Google maps

TODO

Openstreetmap

TODO

Mapquest

TODO

Yahoo maps

TODO

Bing maps

TODO

Inline map

TODO

GraphHopper

TODO

Get nearby Wikipedia articles

TODO

Search Wikipedia by name

TODO

Get nearby OSM points

TODO

Open Peakfinder.org

TODO

Open Geohack page

TODO

Search OpenCaching.de

TODO

Search for photos in Mapillary

TODO

Download OSM  data for area

TODO

Get weather forecast

TODO

Track

Undo

TODO

Clear undo list

TODO

Compress track

Reduce the number of points of a track.

  • Duplicate removal
    Removes duplicate points (points with the same latitude and longitude as other points) in the track. So this doesn’t lose any accuracy.
  • Nearby point removal
    This has a variable parameter to offer different levels of compression – this “Span factor” is based on the total span of the track in longitude and latitude. With the default parameter value of 200, points which are closer than one 200th of the track span to the previous point, are marked for deletion. Higher values of this span factor delete fewer points and lower numbers delete more.
  • Wacky point removal
    This identifies points which are far from their two neighbours even though those neighbours are close together. It usually indicates an error in the reception, where the estimated location temporarily jumps in the wrong direction, and then jumps back. The parameter “distance factor” influences how far away the point must be from its neighbours to be considered “wacky”. It’s a multiple of the average distance between neighbouring points in the track, so if the parameter is 2, points with more than twice the average distance to their neighbours will be considered wacky.
  • Singleton removal
    This uses the track segment information (if available) to look for isolated points not connected to their neighbours. It uses the same “distance factor” as the wacky point algorithm to identify single points far from their neighbours (often produced when reception is poor).

TODO

Mark points in rectangle

TODO

Mark uphill lifts

TODO

Delete marked points

TODO

Delete points by date

TODO

Rearrange waypoints

TODO

Split track into segments

TODO

Sew track segments together

TODO

Create marker waypoints

TODO

Learn time estimation parameters

TODO

Range

Select all

TODO

Select none

TODO

Select current segment

TODO

Set range start

TODO

Set range end

TODO

Delete range

TODO

Crop track

TODO

Reverse range

TODO

Add time offset

TODO

Add altitude offset

TODO

Merge track segments

TODO

Delete field values

TODO

Interpolate points

TODO

Average selection

TODO

Cut and move selection

TODO

Convert waypoint names to times

TODO

Point

Edit point

TODO

Edit waypoint name

TODO

Delete point

TODO

Find waypoint

TODO

Duplicate point

TODO

Project point

TODO

Enter point coordinates

TODO

Enter list of coordinates

TODO

Enter pluscode

TODO

View

Show map

TODO

Show sidebars

TODO

Three-D view

Create a three-D view of the data.

TODO

The view can be exported as a POV-Ray (.pov) file. For details of this format and the POV-Ray application see http://www.povray.org/.
As an example, to create a .png image from a .pov file:
c:\Program Files\POV-Ray\v3.7\bin\pvengine64.exe" Height=1600 Width=2000 Test.pov

Charts

TODO

Distances

TODO

Full details

TODO

Estimate time

TODO

Autoplay track

TODO

Functionality

Map sources

Different map sources can be used for a background image.

  • Mapnik
    The OpenStreetMap tile provider: https://tile.openstreetmap.org/.
    These tiles are rendered with the Mapnik renderer.
  • Cycling Trails
    Cycling maps of Waymarked Trails: https://tile.waymarkedtrails.org/cycling/.
  • Reitcarte
    Reit- und Wanderkarte (horseriding and hiking map: http://topo2.wanderreitkarte.de/topo/.
  • Mapsforfree
    Maps-For-Free relief maps: https://maps-for-free.com/layer/relief/ and https://maps-for-free.com/layer/water.
    These maps are only available for a scale of 5km or higher.
  • Hikebikemap
    The OpenStreetMap Hike & Bike map: https://tiles.wmflabs.org/hikebike/.
    On this map hiking trails and cycling paths are better visible.
  • Openseamap
    The OpenSeaMap (the free nautical chart) tile provider: http://tiles.openseamap.org/seamark/.

Editing the points of a track

Deleting a single point

Select the point by left clicking on it and then either press the ‘Delete’ key or from the menu select ‘Point/Delete’. Note that this doesn’t always work on the last point of the track.

Deleting a sequence (range) of points

To delete a range of points, select the first point of the range (by left clicking) and select the last point of the range (by SHIFT + left clicking) and then from the menu select ‘Range/Delete range’.

Photos

A list of added photos is shown at the bottom left of the window.
The photos are marked on the map by a little orange square.
You can select a photo in the list or on the map. On the right hand side information about the photo is shown. There you can also rotate the photo, or get a preview of the photo.

Merging segments from different gps files

Open the first file via ‘File/Open’. Open any other files and select ‘Yes’ upon the question ‘Append this data to the data already loaded?’.
Finally save to a new file using ‘File/Export’.