Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions[bot] committed Jun 25, 2024
0 parents commit b1e2211
Show file tree
Hide file tree
Showing 132 changed files with 42,106 additions and 0 deletions.
4 changes: 4 additions & 0 deletions .buildinfo
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 0ef5c5a2ade17db5dfee944971faa956
tags: 645f666f9bcd5a90fca523b33c5a78b7
Empty file added .nojekyll
Empty file.
1 change: 1 addition & 0 deletions CNAME
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
www.generic-mapping-tools.org
84 changes: 84 additions & 0 deletions _sources/about/index.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
.. title:: About

About
=====

GMT is an open-source collection of command-line tools for manipulating geographic and
Cartesian data sets (including filtering, trend fitting, gridding, projecting, etc.) and
producing high-quality illustrations ranging from simple x–y plots via contour maps to
artificially illuminated surfaces and 3D perspective views. It supports many map
projections and transformations and includes supporting data such as coastlines, rivers,
and political boundaries and optionally country polygons.


Council
-------

As of August 2016, GMT development and maintenance is being guided by a GMT Steering
Committee, led by Chair David Sandwell (Scripps) and members Dave Caress (MBARI),
Steve Diggs (Scripps), Dan Bassett (GNS Science, New Zealand), and Khalid Soofi (ConocoPhillips).


Support
-------

GMT could not have been designed without the generous support of several people:

* The founders (Wessel and Smith) gratefully acknowledge A. B. Watts and the late W. F.
Haxby for supporting their efforts on the original version 1.0 while they were their
graduate students at Lamont-Doherty Earth Observatory.
* Doug Shearer and Roger Davis patiently answered many questions over e-mail.
* The subroutine ``gauss`` was written and supplied by Bill Menke.

Further development was made possible by grants and fellowships:

* National Science Foundation grants
`EAR-1948602 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1948602>`__,
`OCE-1841660 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1841660>`__,
`EAR-1829371 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1829371>`__,
`OCE-1558403 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1558403>`__,
`EAR-1347184 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1347184>`__,
`OCE-1029874 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1029874>`__,
`OCE-0452126 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=0452126>`__,
`OCE-0082552 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=0082552>`__,
`OCE-9529431 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=9529431>`__,
and
`EAR-9302272 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=9302272>`__.
* Versions 2.0–2.1 would not have been possible without the support from the HIGP/SOEST
Post-Doctoral Fellowship program to Paul Wessel.
* Walter H. F. Smith gratefully acknowledges the generous support of the C. H. and I. M.
Green Foundation for Earth Sciences at the Institute of Geophysics and Planetary
Physics, Scripps Institution of Oceanography, University of California at San Diego.

History
-------

The GMT system was initiated in late 1987 at Lamont-Doherty Earth Observatory, Columbia
University by graduate students Paul Wessel and Walter H. F. Smith. Version 1 was
officially introduced to Lamont scientists in July 1988. GMT 1 migrated by word of
mouth (and tape) to other institutions in the United States, UK, Japan, and France and
attracted a small following. Paul took a Post-doctoral position at SOEST in December
1989 and continued the GMT development. Version 2.0 was released with an article in EOS,
October 1991, and quickly spread worldwide. Version 3.0 in 1993 which was released with
another article in EOS on August 15, 1995. A major upgrade to GMT 4.0 took place in Oct
2004. Finally, in 2013 we released the new GMT 5 series, which are generally
backwards compatible with GMT 4 syntax. Another major upgrade took place in 2019 with
the release of GMT 6 and modern mode. GMT is used by tens of thousands of users
worldwide in a broad range of disciplines.

More detail on the history of GMT:

* Listen to this interview of Paul Wessel and Leonardo Uieda on the *Don't Panic
Geocast* episode
`"You are headed to a warm and sunny place" <http://www.dontpanicgeocast.com/?p=638>`__.
* Walter Smith was also interviewed by *Don't Panic* on episode
`"Take the toaster apart" <https://www.dontpanicgeocast.com/?p=742>`__ where he talks
about the early history of GMT and other topics.
* Read Paul Wessel's article `"The Origins of the Generic Mapping Tools: From Table Tennis to Geoscience" <https://doi.org/10.1029/2023CN000231>`__ from 2024.
* Watch this recorded talk by Paul Wessel on the 20th anniversary of the first release (`original version <https://doi.org/10.5446/19869>`__):

.. raw:: html

<div class="embed-responsive embed-responsive-16by9">
<iframe width="560" height="315" scrolling="no" src="//av.tib.eu/player/19869" frameborder="0" allowfullscreen></iframe>
</div>
75 changes: 75 additions & 0 deletions _sources/cite/index.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
.. title:: Citing

Citing GMT
==========

If you feel it is appropriate, you may consider paying us back by citing our articles on
GMT and technical papers on algorithms when you publish papers containing results or
illustrations obtained using GMT. **When in doubt, please cite the latest paper.**

The articles on GMT are:

* **GMT 6**:
Wessel, P., Luis, J. F., Uieda, L., Scharroo, R., Wobbe, F., Smith, W. H. F., & Tian, D. (2019).
The Generic Mapping Tools Version 6.
*Geochemistry, Geophysics, Geosystems*, 20(11), 5556–5564.
https://doi.org/10.1029/2019GC008515
* **GMT/MATLAB**:
Wessel, P., & Luis, J. F. (2017).
The GMT/MATLAB Toolbox.
*Geochemistry, Geophysics, Geosystems*, 18(2), 811–823.
https://doi.org/10.1002/2016GC006723
* **GMT 5**:
Wessel, P., Smith, W. H. F., Scharroo, R., Luis, J., & Wobbe, F. (2013).
Generic Mapping Tools: Improved Version Released.
*EOS, Transactions American Geophysical Union*, 94(45), 409–410.
https://doi.org/10.1002/2013EO450001
* **GMT 3.1**:
Wessel, P., & Smith, W. H. F. (1998).
New, improved version of generic mapping tools released.
*EOS, Transactions American Geophysical Union*, 79(47), 579–579.
https://doi.org/10.1029/98EO00426
* **GMT 3.0**:
Wessel, P., & Smith, W. H. F. (1995).
New version of the generic mapping tools.
*EOS, Transactions American Geophysical Union*, 76(33), 329–329.
https://doi.org/10.1029/95EO00198
* **GMT 2**:
Wessel, P., & Smith, W. H. F. (1991).
Free software helps map and display data.
*EOS, Transactions American Geophysical Union*, 72(41), 441–446.
https://doi.org/10.1029/90EO00319

Some GMT modules are based on algorithms we have developed and published separately,
such as:

* Kim, S.-S., & Wessel, P. (2008).
Directional median filtering for regional‐residual separation of bathymetry.
*Geochemistry, Geophysics, Geosystems*, 9(3), 2007GC001850.
https://doi.org/10.1029/2007GC001850
[``dimfilter``]
* Luis, J. F., & Miranda, J. M. (2008).
Reevaluation of magnetic chrons in the North Atlantic between 35°N and 47°N: Implications for the formation of the Azores Triple Junction and associated plateau.
*Journal of Geophysical Research: Solid Earth*, 113(B10), 2007JB005573.
https://doi.org/10.1029/2007JB005573
[``grdredpol``, **potential** supplement]
* Smith, W. H. F., & Wessel, P. (1990).
Gridding with continuous curvature splines in tension.
*Geophysics*, 55(3), 293–305.
https://doi.org/10.1190/1.1442837
[``surface``]
* Wessel, P. (2010).
Tools for analyzing intersecting tracks: The x2sys package.
*Computers & Geosciences*, 36(3), 348–354.
https://doi.org/10.1016/j.cageo.2009.05.009
[**x2sys** supplement]
* Wessel, P. (2009).
A general-purpose Green’s function-based interpolator.
*Computers & Geosciences*, 35(6), 1247–1254.
https://doi.org/10.1016/j.cageo.2008.08.012
[``greenspline``]
* Wessel, P., & Becker, J. M. (2008).
Interpolation using a generalized Green’s function for a spherical surface spline in tension.
*Geophysical Journal International*, 174(1), 21–28.
https://doi.org/10.1111/j.1365-246X.2008.03829.x
[``greenspline``]
18 changes: 18 additions & 0 deletions _sources/documentation/index.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
.. title:: Documentation

Documentation
=============

Documentation for GMT is available online in different versions (if in doubt, use the
**latest stable** version):

* `Latest stable release <https://docs.generic-mapping-tools.org/latest>`__
* `Current development version (unstable nightly builds) <https://docs.generic-mapping-tools.org/dev/>`__
* `GMT 6.5.0 <https://docs.generic-mapping-tools.org/6.5/>`__
* `GMT 6.4.0 <https://docs.generic-mapping-tools.org/6.4/>`__
* `GMT 6.3.0 <https://docs.generic-mapping-tools.org/6.3/>`__
* `GMT 6.2.0 <https://docs.generic-mapping-tools.org/6.2/>`__
* `GMT 6.1.1 <https://docs.generic-mapping-tools.org/6.1/>`__
* `GMT 6.0.0 <https://docs.generic-mapping-tools.org/6.0/>`__
* `GMT 5.4.5 <https://docs.generic-mapping-tools.org/5.4/>`__
* `GMT 4.5.18 <https://docs.generic-mapping-tools.org/4/>`__
52 changes: 52 additions & 0 deletions _sources/download/index.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
.. title:: Download

Download
========

Releases
--------

GMT Releases
~~~~~~~~~~~~

GMT is available on Windows, macOS, Linux and FreeBSD. Source and binary packages are provided
from `GitHub <https://github.com/GenericMappingTools/gmt/releases>`__:

* `GMT 6.5.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.5.0>`__ (**recommended**)
* `GMT 6.4.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.4.0>`__
* `GMT 6.3.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.3.0>`__
* `GMT 6.2.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.2.0>`__
* `GMT 6.1.1 <https://github.com/GenericMappingTools/gmt/releases/tag/6.1.1>`__
* `GMT 6.1.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.1.0>`__
* `GMT 6.0.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.0.0>`__
* `GMT 5.4.5 <https://github.com/GenericMappingTools/gmt/releases/tag/5.4.5>`__
* `GMT 4.5.18 <https://github.com/GenericMappingTools/gmt/wiki/GMT-4.5.18>`__

GMT Wrapper Releases
~~~~~~~~~~~~~~~~~~~~

The latest `GMT.jl <https://www.generic-mapping-tools.org/GMT.jl/stable/>`__ and
`PyGMT <https://www.pygmt.org/latest/>`__ releases are provided from GitHub:

* `GMT.jl releases <https://github.com/GenericMappingTools/GMT.jl/releases>`__
* `PyGMT releases <https://github.com/GenericMappingTools/pygmt/releases>`__

Support Data
------------

* `GSHHG 2.3.7 <https://github.com/GenericMappingTools/gshhg-gmt/releases/download/2.3.7/gshhg-gmt-2.3.7.tar.gz>`__: The Global Self-consistent, Hierarchical, High-resolution Geography Database
* `DCW 2.2.0 <https://github.com/GenericMappingTools/dcw-gmt/releases/download/2.2.0/dcw-gmt-2.2.0.tar.gz>`__: The Digital Chart of the World Data [requires GMT 6.1.1 or later]

**Note:** You may also get GMT and its support data from any of :doc:`the GMT FTP mirrors </mirrors/index>`.
Try the site that is closest to you to minimize transmission times.

Install
-------

See the `install guide`_ for instructions and to make sure you have all required
dependencies installed.

Alternatively, you can build GMT from source by following the `building guide`_.

.. _install guide: https://docs.generic-mapping-tools.org/latest/install.html
.. _building guide: https://github.com/GenericMappingTools/gmt/blob/master/BUILDING.md
Loading

0 comments on commit b1e2211

Please sign in to comment.