Activity Workshop
 

GpsPrune dependencies

Apart from downloading GpsPrune, there are other pieces of software you may need to install if you haven't got them already. The only one you need to have in order for GpsPrune to work is the Java Runtime, all the others are optional, but you may want to get them in order to get access to some of GpsPrune's functionality.

Note that if you get GpsPrune from a package manager (such as those in Debian or Ubuntu), then often all these dependencies will be automatically downloaded and installed for you. Full details are given in the download page.

Java runtime

The only required software is a java runtime, also known as a JRE (Java runtime environment). To run GpsPrune you need to get a java runtime of at least version 1.5, but versions 1.6 and 1.7 also work fine. If you haven't got a java runtime already then it's best to get the latest version available to make sure all the security fixes have been applied.

To install on Linux, simply get it from your package manager. Almost all current distributions now offer OpenJDK (instead of the old Sun JDK), for example Debian's runtime package is called openjdk-7-jre with several other related packages including the JDK itself, openjdk-7-jdk. These packages can be simply installed either from the command line or from GUI tools such as synaptic or "Software Manager".

For Windows, go to the Java SE download page, select the latest version of the JRE (at the time of writing this is given as " jre-7u51-windows-i586.exe"), and download the item marked "Windows Offline Installation". Run this executable and go through the wizard installation process. Also see the installation instructions.

Mac OSX users get prompted to install a java runtime the first time they try to run a java program. Just accept the prompts and it will be installed for you.

Java3d libraries (optional)

The java3d libraries are used for the real-time 3d display in GpsPrune. To install them, go to java3d.java.net and select the zip file for your platform. Follow the instructions inside, or just unpack the contents of the j3d-jre.zip file into your java installation. If you have Debian or Ubuntu you can get the libjava3d-java package from the normal repositories.

Again, Mac OSX users don't have to do anything here because apparently it is installed already by default. You can check this using the "About" page in GpsPrune.

Note that these java3d libraries are optional for running GpsPrune, but if you want to build the complete source, you'll need to have the java3d libraries installed so that you can build everything.

Exiftool (optional)

Exiftool is a multi-purpose tool for handling the exif data inside jpeg files. GpsPrune uses it to save the coordinates into the Jpeg files after correlation. If you haven't got Exiftool you can still read the coordinates from Jpegs and still generate Kmz files containing the photos in the right place but GpsPrune won't be able to save those coordinates in the Jpeg files.

To install on Linux, use your package manager. For example, on Mandriva just type urpmi exiftool, for Debian or Ubuntu aptitude install libimage-exiftool-perl.

To install on Windows, go to sno.phy.queensu.ca/~phil/exiftool and select the appropriate download file. You'll probably want the executable version which doesn't assume that you've already got perl. Open this file with an unzip tool and extract the single file called exiftool(k).exe. Now you need to rename this file exiftool.exe and either move it to somewhere within the system path or extend the system path to include the directory where you saved this exe. See the install instructions for more details.

To install on Mac, again go to sno.phy.queensu.ca/~phil/exiftool and download the Mac package, then install this in the usual way. Or you could use macports (the command is port install p5-image-exiftool I think) or Fink (apt-get install image-exiftool-pm I think).

Gpsbabel (optional)

Gpsbabel is a command-line tool for converting between data formats. GpsPrune uses it to load data directly from GPS receivers, and also to send data back to the GPS receivers. If you don't have gpsbabel installed then these functions won't be available.

To install on Linux, use your package manager. For example, on Mandriva just type urpmi gpsbabel, for Debian or Ubuntu aptitude install gpsbabel.

To install on Windows, go to gpsbabel.org and select the zip file from the download page. Save this file and open it in a zip utility, then extract the file gpsbabel.exe and save it somewhere in your system path (eg the windows directory).

To install on Mac, again go to gpsbabel.org and select the dmg file for Mac. This should be installed in the usual way. Or you can get it from macports (the command is port install gpsbabel I think) or Fink (apt-get install gpsbabel I think).

Gnuplot (optional)

Gnuplot is a powerful charting tool which GpsPrune uses to draw the charts of altitudes, times, speeds, distances and so on. If you don't have gnuplot installed then GpsPrune won't be able to generate these charts.

To install on Linux, use your package manager. For example, on Mandriva just type urpmi gnuplot, for Debian or Ubuntu aptitude install gnuplot gnuplot-x11.

To install on Windows, go to gnuplot.info and select the appropriate zip file from the binary download page. Open this file in a zip utility, then follow the installation instructions inside the zip. Also you'll need to inform GpsPrune where to find the executable (now called pgnuplot.exe), using the menu function Settings -> Set program paths.

For the Mac, there is no binary on sourceforge but you can use either macports (the command is port install gnuplot I think) or Fink (apt-get install gnuplot I think).

Povray (optional)

Povray is a rendering program for generating high-quality rendering of 3d images using the Pov files created by GpsPrune (using the menu command File -> Export POV).

To install on Linux, again you may be able to use your package manager. Just search for a package called povray. Unfortunately, due to some confusion about the licensing of version 3.7, povray has been removed from some distributions (such as Debian and Ubuntu), although it should be possible to install the older 3.6 version from the older repositories. With some luck and some packaging efforts, the new 3.7 should hopefully be reintroduced soon.

To install on Windows, go to povray.org and select your download (32-bit or 64-bit) from the download page. Save this executable file, run it, and follow the installation wizard.

To install on Mac, you can use the povray download page to get the Mac version and install it as usual. Or you can get it from macports (the command is port install povray I think) or Fink (apt-get install povray I think).