Skip to content
/ gmt Public
forked from GenericMappingTools/gmt

The Generic Mapping Tools

License

Unknown, LGPL-3.0 licenses found

Licenses found

Unknown
LICENSE.TXT
LGPL-3.0
COPYING.LESSERv3
Notifications You must be signed in to change notification settings

sqdeng/gmt

 
 

Generic Mapping Tools

TravisCI Azure CodeCov Coverity Documentation (development version)

What is GMT?

GMT is an open source collection of about 80 command-line tools for manipulating geographic and Cartesian data sets (including filtering, trend fitting, gridding, projecting, etc.) and producing PostScript illustrations ranging from simple x–y plots via contour maps to artificially illuminated surfaces and 3D perspective views. The GMT supplements add another 40 more specialized and discipline-specific tools. GMT supports over 30 map projections and transformations and requires support data such as GSHHG coastlines, rivers, and political boundaries and optionally DCW country polygons.

GMT is developed and maintained by Paul Wessel, Walter H. F. Smith, Remko Scharroo, Joaquim Luis and Florian Wobbe, with help from a global set of contributors and support by the National Science Foundation. It is released under the GNU Lesser General Public License version 3 or any later version.

The GMT World Domination

Considering its flexibility at no charge, people worldwide are using GMT in their work and at home. Most users of GMT are Earth, ocean or planetary scientists, but there are apparently no limits to the kind of applications that may benefit from GMT. We know GMT is used in medical research, engineering, physics, mathematics, social and biological sciences, and by geographers, fisheries institutes, oil companies, a wide range of government agencies, and last but not least innumerable hobbyists.

A reminder

If you think it is appropriate, you may consider paying us back by including our latest EOS article in the reference list of your future publications that will benefit from the availability of GMT:

Wessel, P., W. H. F. Smith, R. Scharroo, J. F. Luis, and F. Wobbe (2013), Generic Mapping Tools: Improved version released, Eos Trans. AGU, 94(45), 409-410, doi:10.1002/2013EO450001

Install GMT

GMT has been installed successfully under UNIX/Linux/OS X on workstations. It also installs under Windows and in UNIX emulators such as Cygwin or on virtual machines. We anticipate few problems if you are installing the package on other platforms.

Note there are three GMT tar archives available (#3 is optional):

  1. gmt-6.x.x.tar.bz2: The GMT 6 distribution
  2. gshhg-gmt-2.x.x.tar.gz: All five resolutions of GSHHG coastline data
  3. dcw-gmt-1.x.x.tar.bz2: Digital Chart of the World polygon data

For macOS and Windows users there are separate installers available. You can obtain GMT and support data from http://gmt.soest.hawaii.edu/. Alternatively you may get GMT from any of the following FTP sites. Try the site that is closest to you to minimize transmission times:

Site FTP address
SOEST, U. of Hawaii ftp://ftp.soest.hawaii.edu/gmt
Lab for Satellite Altimetry, NOAA ftp://ftp.star.nesdis.noaa.gov/pub/sod/lsa/gmt
IRIS, Washington, US ftp://ftp.iris.washington.edu/pub/gmt
IAG-USP, U. of Sao Paulo, BRAZIL ftp://ftp.iag.usp.br/pub/gmt
TENET, Tertiary Education & Research Networks, SOUTH AFRICA ftp://gmt.mirror.ac.za/gmt/
Tokai U, Shimizu, JAPAN ftp://ftp.scc.u-tokai.ac.jp/pub/gmt
University of Science and Technology of China, Hefei, CHINA http://mirrors.ustc.edu.cn/gmt

Refer to the install instructions to install GMT, and build instructions to build GMT from the sources.

GMT supplemental Code

GMT users elsewhere have developed programs that utilize the GMT libraries and produce PostScript code compatible with the rest of GMT or simply perform data manipulation. Currently, the supplemental archive include the directories:

  • gshhg: Data extractor for GSHHG shoreline polygons and rivers, borders.
  • img: Data extractor for Smith/Sandwell altimetry grids.
  • meca: Plotting of focal mechanisms, velocity arrows, and error ellipses on maps.
  • mgd77: Programs for handling of native MGD77 files.
  • potential: geopotential manipulations
  • segyprogs: Plotting SEGY seismic data sets.
  • spotter: Plate tectonic & kinematics applications.
  • x2sys: Track intersection (crossover) tools.

Misc

Before running programs, there are a few things you should do/know:

Read carefully the documentation for the gmt system. This can be
found as both PDF and HTML files in the doc/pdf|html directories.
The successful operation of gmt-programs depends directly on your
understanding of how gmt "works", its option lists, I/O, and composite
plot mechanisms. Then, before running individual gmt programs, read
the associated man page.

Software support

You haven't bought anything so you cannot expect full service. However, if you find a bug in any of the programs, please report it to us (http://gmt.soest.hawaii.edu/) rather than trying to fix it yourself so that we, and through us, other users may benefit from your find. Make sure you provide us with enough information so that we can recreate the problem.

In addition to the bug tracking feature (New Issues) on the website, you can also post general questions on the GMT user forum. Note that registration is required to post on the site.

Ordering the GMT package on CD/DVD-Rs

Should you or someone you know without net-access need to obtain GMT: Geoware makes and distributes CD/DVD-Rs with the GMT package and many useful data sets. For more details and a full description of the data sets (up to 60 Gb of data!) visit http://www.geoware-online.com/.

About

The Generic Mapping Tools

Resources

License

Unknown, LGPL-3.0 licenses found

Licenses found

Unknown
LICENSE.TXT
LGPL-3.0
COPYING.LESSERv3

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 68.9%
  • PostScript 22.3%
  • Shell 3.7%
  • Objective-C 2.7%
  • Makefile 1.1%
  • CMake 0.9%
  • Other 0.4%