The GMT Companion Software CD-R
The GMT Companion Software CD-R
Version 2.4 - August 2010
Paul Wessel, Geoware
Installation of GMT and Geoware Companion software only for use with
the GMT Companion DVD-R products.
- GMT Companion CD-R Installation WINDOWS
- GMT Companion CD-R Installation UNIX
- GMT Companion CD-R Data Utilities
- GMT Companion CD-R Software packages
Insert the CD into your CD-R drive. The four installers will install
GMT, the GMT PDF documentation, the GSHHS high and full coastline data, and the Geoware
utilities. Run the installers in that order. Each installer
will take you through the installation.
The GMT Companion DVD-R installation has been tested successfully under Solaris,
Linux, Cygwin, Interix, and Mac OS X. The basic requirements are:
To install programs from Geoware GMT Companion DVD-Rs, follow these
- You have access to a POSIX Bourne shell (Bash will also work). Note that on Solaris you are advised
to use the version in /usr/xpg4/bin since /usr/bin/sh (and things like /usr/bin/grep) are not Posix-compliant,
and furthermore /usr/bin/awk still thinks sin(1) = 1.
- You have bzip2 on your system. If not, use your package manager, or get source code and executables for bzip2
from the bzip2 site. For your convenience, the bzip2 tar
ball can also be found in the PROGS/MISC directory on this CD.
- You have write permissions in all directories you specify below.
you will be faced with several questions that should be self-explanatory.
First, a main Geoware directory must be chosen. The default is geoware in
your home directory - you can override this choice if necessary.
The installer will allow you to install any of the
programs on the DVD as well as the required Companion utilities. Once you have finished
you may remove the DVD-R; it is not used once installation is complete.
- Mount the DVD-rom device if your OS does not do so automatically.
See your system's technical documentation on how to do this step (e.g., man mount)
- Change directory to the top directory on the DVD. If you type ls you
should see a few files, including install.sh.
- Type sh install.sh (on some systems you may have to say sh INSTALL.SH).
The GMT Companion package contains tools required to decompress data from the CD-Rs as well as
manipulating some of the data sets listed above. The package contains:
- extract_epic.c: Extracts a subset of earthquakes from the NEIC EPIC data base
- extract_candy.c: Extracts lineaments from the Cande et al.  data base
- extract_cities.c: Extracts a subset of cities from the UN world cities data base
- extract_countries.c: Extracts a list of country polygons from the DCW data base
- extract_srtm.c: Blends adjacent NASA SRTM tiles to give a single grd file
- extract_volcanoes.c: Extracts longitude, latitude for volcanoes in the Smithsonian database
- extract_woa01: Extracts a lon-lat grid of specified observation from the World Ocean Atlas 2001
Windows: Users of Windows may want to install these optional packages:
UNIX: Users of UNIX may want to install these packages:
- Mirone 1.5.0, a Matlab-based interface to GMT under Windows or OS X.
To install, locate the files in the PROGS/MIRONE folder, copy to your PC or Mac, and run the appropriate installer to install Mirone.
The MIRONEPC.ZIP file is for Windows users who have Matlab 6.5 or higher installed, while the MIRSETUP.EXE file is a standalone Windows Mirone package if you
do not have Matlab. For OS X you must use MIRONOSX.ZIP.
- Win4GMT, a graphical user interface to GMT under Windows.
To install, locate W4Gsetup.exe in the PROGS/WIN4GMT folder, copy to your PC, and run it to install Win4GMT.
Follow directions in the PROGS/Win4GMT folder.
Of these, the CD-R install script can install GMT and netcdf for you (see installers for Windows); the others
require you to following instructions specific to each package (under UNIX/Linux only).
- bzip2: The bzip2 compressor/deflator source code [GNU]
- GMT: The Generic Mapping Tools (GMT), version 4.5.0 source code [GMT]
- netCDF: The netcdf library, version 3.6.3 [Unidata/UCAR]
- iGMT: The Interactive GMT (iGMT) source code [iGMT project]
- ArcGMT: The ARC/INFO GMT supplements [Dawn Wright]
- MB-System: The MB-System 5.1.1 for multibeam bathymetry analysis [LDEO/MBARI]
For details on file names and sizes in both compressed and natural form, see the file
gmtcompp.dat on the Geoware GMT Companion CD-R.
Should you have questions regarding this CD-R or the data
distributed with it, contact Geoware.
For questions regarding any of the program packages, see the contact person(s) for each package.
This page was last modified on July 21, 2010.