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.
  1. GMT Companion CD-R Installation WINDOWS
  2. GMT Companion CD-R Installation UNIX
  3. GMT Companion CD-R Data Utilities
  4. GMT Companion CD-R Software packages

Windows Installation:

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 simple instructions:
  1. 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)
  2. Change directory to the top directory on the DVD. If you type ls you should see a few files, including
  3. Type sh (on some systems you may have to say sh INSTALL.SH).
Once running, 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.


Data Utilities:

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:
  1. extract_epic.c: Extracts a subset of earthquakes from the NEIC EPIC data base
  2. extract_candy.c: Extracts lineaments from the Cande et al. [1989] data base
  3. extract_cities.c: Extracts a subset of cities from the UN world cities data base
  4. extract_countries.c: Extracts a list of country polygons from the DCW data base
  5. extract_srtm.c: Blends adjacent NASA SRTM tiles to give a single grd file
  6. extract_volcanoes.c: Extracts longitude, latitude for volcanoes in the Smithsonian database
  7. extract_woa01: Extracts a lon-lat grid of specified observation from the World Ocean Atlas 2001

Software source packages:

Windows: Users of Windows may want to install these optional packages:
  1. 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.
  2. 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.
UNIX: Users of UNIX may want to install these packages:
  1. bzip2: The bzip2 compressor/deflator source code [GNU]
  2. GMT: The Generic Mapping Tools (GMT), version 4.5.0 source code [GMT]
  3. netCDF: The netcdf library, version 3.6.3 [Unidata/UCAR]
  4. iGMT: The Interactive GMT (iGMT) source code [iGMT project]
  5. ArcGMT: The ARC/INFO GMT supplements [Dawn Wright]
  6. MB-System: The MB-System 5.1.1 for multibeam bathymetry analysis [LDEO/MBARI]
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).


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.