GMT - The Generic Mapping Tools
GMT is released under the
GNU General Public License
Note: current version is
GMT-3.3.4. Also see the ERRATA page.
Version 3.3.4 was officially announced on March 20, 2000. Click
here to
read the release announcements.
GMT is a free, public-domain collection of ~60 UNIX tools that allow
users to manipulate (x,y) and (x,y,z) data sets (including filtering, trend
fitting, gridding, projecting, etc.) and produce Encapsulated PostScript
File (EPS) illustrations ranging from simple x-y plots through contour
maps to artificially illuminated surfaces and 3-D perspective views in
black and white, gray tone, hachure patterns, and 24-bit color. GMT supports
25 common map projections plus linear, log, and power scaling, and comes
with support data such as coastlines, rivers, and political boundaries.
GMT is developed and maintained by Paul
Wessel and Walter H. F.
Smith.
Where is GMT used?
GMT is used all over the world. The yellow dots show the location of individuals at
700+ institutions who have installed GMT, representing about 6000 GMT users. To add
your dot, fill out the registration form.
Frequently Asked Questions about GMT.
Online GMT Services
Click HERE for access to the complete Online
GMT Technical Reference and Cookbook, GMT Tutorial, and GMT Unix Man Pages.
GMT Examples
Click HERE to see examples of GMT output.
Cannot find the answer to a question in the documentation?
We have a world-wide mailinglist for use by GMT users. If you send mail
to gmthelp it will reach
~500 subscribed GMT users, one of which is likely to know the solution
to your problem. To add yourself to this mailinglist (which is maintained
by the listserver program), you must send mail to the listserver
with a 1-line message. E.g., if your name is John Smith then send
subscribe gmthelp John Smith
The listserver will automatically obtain your email address.
There is a second mailinglist that is only used by the GMT developers
to broadcast infrequent messages regarding bug fixes and updates. Users
cannot post to this mailinglist. To stay informed of new developments,
send mail to the listserver
replacing gmthelp with gmtgroup in the message example above. Note:
the GMT developers monitor both lists and are aware of all submissions
allthough they may not respond personally to each message.
Occacionally, a frustrated new GMT user will convince him/herself
that their work is so important that they are justified in digging up our
phone numbers and calling us directly to get personal attention to their
problem. Please don't even think about doing this unless you are
prepared to pay our standard consulting fee of USD 200 per hour.
Availability of GMT source code
The GMT package is available via anonymous ftp from several servers; they
all contain the same files as the main server in Hawaii. Because of file
sizes you are strongly encouraged to use the server closest to you.
Obtaining and Installing GMT
- UNIX or LINUX:
Because of the size of the archives we suggest you verify that you have
bzip2 on your system.
If not, it is worth installing (executables for most platforms are available)
since *.bz2 files are much smaller than the *.gz files. For instance, the
entire GMT package is ~50 Mb with bzip2 and 75 Mb with gzip.
- Have csh or tcsh.
Obtain and install GMT by interacting with the INSTALL FORM on the web.
Follow instructions there to obtain an csh install-script and a customized install parameter file.
- Only sh or bash.
If you cannot use csh/tcsh, you must do the typical manual install by ftping the files, untar,
run configure, make etc. Read the README file for the required steps.
For manual install you must also manually get and install the Unidata
netCDF library, version 3.4 or higher, which GMT requries.
For your convenience, this library is also available from the GMT ftp sites.
- WINDOWS:
- DOS scripts rule.
All the archives are also available as *.zip files. In addition, two extra files can be found:
GMT_exe.zip contains main GMT executables, and GMT_suppl_exe.zip contains executables for the supplements.
Note that many of the DOS example scripts utilize GNU awk; the WIN32 executable
gawk
has therefore been placed on all ftp sites.
A precompiled netCDF
library for Windows is also available, and needed for GMT to compile and run (even if you only get the executables).
For your convenience, this library is also available from the GMT ftp sites.
- DOS scripts suck, part I.
Because you cannot get much done with DOS batch jobs, we strongly recommend that you install
Cygwin, a free Unix emulation package for Windows.
Cygwin lets you open a bash command window and run bash shell scripts and comes with a suite of
standard Unix tools. You would then install GMT manually as under 1.2 above. If you don't like
bash then Cygnus (now RedHat) sells a commercial version that has csh.
- DOS scripts suck, part II.
If you run Windows NT, you can get access to csh command windows by installing the commercial
product Interix, a Unix environment for Windows.
Interix lets you install GMT automatically as under 1.1 above. Recently, Interix was
assimilated by the Borg from the planet Redmond.
- OS/2:
GMT has been ported to OS/2. For information and precompiled executables, see Allen Cogbill's
GMT OS/2 page.
- MacIntosh:
- Running Linux.
If you run Linux on your Mac, follow the steps above for automatic install under UNIX or LINUX (1.1).
- Running MacOS X Server.
GMT installs and runs under MacOS X Server which is Unix-based (follow instructions for
UNIX/Linux in 1.1).
- Running MacOS 8 or 9.
GMT does not run directly under MacOS 9 or earlier. However, you can run GMT
using the commercial Machten Unix emulation package. When
Machten is installed, GMT can be installed as under 1.1 above.
GMT master and mirror sites
You need to visit one of these sites if you cannot do the automatic Unix/Linux install under 1.1 above.
-
SOEST, Dept of Geology & Geophysics, Honolulu, Hawaii, USA. Serving the Pacific Rim
-
NOAA, Lab for Satellite Altimetry, Silver Spring, Maryland, USA. Serving North America
-
IAG-USP, Dept of Geophysics, Sao Paulo, Brazil. Serving South America
-
IFG, Institute for Geology, Oslo, Norway. Serving Europe
-
Charles Sturt U, Albury, Australia. Serving Australia
-
ISV, Sapporo, Japan. Serving Asia
Post-Installation Notes
- The latest compressed tar archives for version 3.3.4 were created March
20, 2000. See the list of known bugs since the creation
of the archive - use this information to temporarily fix these problems.
- The latest version may have caused a few cases of backward incompability
with previous versions, so you may need to modify your custom scripts.
- You can also check out the latest news about
programs and useful scripts added to the ftp site since the release of
the current GMT version.
Don't forget to register now!
Fill out the GMT users online registration
form and subscribe to the official GMT mailing lists.
Thank you for visiting the GMT home page!
An illuminated view of the world.
Go to SOEST home page.
This page is maintained by:
Paul Wessel (pwessel@hawaii.edu)
Last update March 20, 2000 08:00 HST