Skip to content

Commit 10fb3fa

Browse files
github-actions[bot]github-actions[bot]
committed
0 parents  commit 10fb3fa

132 files changed

Lines changed: 42336 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.buildinfo‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Sphinx build info version 1
2+
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3+
config: 202d35bfa1089c7ffa7096aeea4a8a2e
4+
tags: 645f666f9bcd5a90fca523b33c5a78b7

‎.nojekyll‎

Whitespace-only changes.

‎CNAME‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
www.generic-mapping-tools.org

‎_sources/about/index.rst.txt‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
.. title:: About
2+
3+
About
4+
=====
5+
6+
GMT is an open-source collection of command-line tools for manipulating geographic and
7+
Cartesian data sets (including filtering, trend fitting, gridding, projecting, etc.) and
8+
producing high-quality illustrations ranging from simple x–y plots via contour maps to
9+
artificially illuminated surfaces and 3D perspective views. It supports many map
10+
projections and transformations and includes supporting data such as coastlines, rivers,
11+
and political boundaries and optionally country polygons.
12+
13+
14+
The Steering Committee
15+
----------------------
16+
17+
As of August 2024, the GMT development and maintenance is being guided by a GMT Steering
18+
Committee, with members David Caress, Dongdong Tian, Federico Esteban, Joaqium Luis,
19+
Remko Scharroo, Walter Smith, and Xiaohua (Eric) Xu.
20+
21+
Support
22+
-------
23+
24+
GMT could not have been designed without the generous support of several people:
25+
26+
* The founders (Wessel and Smith) gratefully acknowledge A. B. Watts and the late W. F.
27+
Haxby for supporting their efforts on the original version 1.0 while they were their
28+
graduate students at Lamont-Doherty Earth Observatory.
29+
* Doug Shearer and Roger Davis patiently answered many questions over e-mail.
30+
* The subroutine ``gauss`` was written and supplied by Bill Menke.
31+
32+
Further development was made possible by grants and fellowships:
33+
34+
* National Science Foundation grants
35+
`EAR-1948602 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1948602>`__,
36+
`OCE-1841660 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1841660>`__,
37+
`EAR-1829371 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1829371>`__,
38+
`OCE-1558403 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1558403>`__,
39+
`EAR-1347184 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1347184>`__,
40+
`OCE-1029874 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1029874>`__,
41+
`OCE-0452126 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=0452126>`__,
42+
`OCE-0082552 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=0082552>`__,
43+
`OCE-9529431 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=9529431>`__,
44+
and
45+
`EAR-9302272 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=9302272>`__.
46+
* Versions 2.0–2.1 would not have been possible without the support from the HIGP/SOEST
47+
Post-Doctoral Fellowship program to Paul Wessel.
48+
* Walter H. F. Smith gratefully acknowledges the generous support of the C. H. and I. M.
49+
Green Foundation for Earth Sciences at the Institute of Geophysics and Planetary
50+
Physics, Scripps Institution of Oceanography, University of California at San Diego.
51+
52+
History
53+
-------
54+
55+
The GMT system was initiated in late 1987 at Lamont-Doherty Earth Observatory, Columbia
56+
University by graduate students Paul Wessel and Walter H. F. Smith. Version 1 was
57+
officially introduced to Lamont scientists in July 1988. GMT 1 migrated by word of
58+
mouth (and tape) to other institutions in the United States, UK, Japan, and France and
59+
attracted a small following. Paul took a Post-doctoral position at SOEST in December
60+
1989 and continued the GMT development. Version 2.0 was released with an article in EOS,
61+
October 1991, and quickly spread worldwide. Version 3.0 in 1993 which was released with
62+
another article in EOS on August 15, 1995. A major upgrade to GMT 4.0 took place in Oct
63+
2004. Finally, in 2013 we released the new GMT 5 series, which are generally
64+
backwards compatible with GMT 4 syntax. Another major upgrade took place in 2019 with
65+
the release of GMT 6 and modern mode. GMT is used by tens of thousands of users
66+
worldwide in a broad range of disciplines.
67+
68+
More detail on the history of GMT:
69+
70+
* Listen to this interview of Paul Wessel and Leonardo Uieda on the *Don't Panic
71+
Geocast* episode
72+
`"You are headed to a warm and sunny place" <http://www.dontpanicgeocast.com/?p=638>`__.
73+
* Walter Smith was also interviewed by *Don't Panic* on episode
74+
`"Take the toaster apart" <https://www.dontpanicgeocast.com/?p=742>`__ where he talks
75+
about the early history of GMT and other topics.
76+
* 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.
77+
* Watch this recorded talk by Paul Wessel on the 20th anniversary of the first release (`original version <https://doi.org/10.5446/19869>`__):
78+
79+
.. raw:: html
80+
81+
<div class="embed-responsive embed-responsive-16by9">
82+
<iframe width="560" height="315" scrolling="no" src="//av.tib.eu/player/19869" frameborder="0" allowfullscreen></iframe>
83+
</div>

‎_sources/cite/index.rst.txt‎

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
.. title:: Citing
2+
3+
Citing GMT
4+
==========
5+
6+
If you feel it is appropriate, you may consider paying us back by citing our articles on
7+
GMT and technical papers on algorithms when you publish papers containing results or
8+
illustrations obtained using GMT. **When in doubt, please cite the latest paper.**
9+
Furthermore, you are welcome to cite the specific version you have used in your work.
10+
11+
The GMT releases are:
12+
13+
+---------------------+----------------------------------------------------------------------+
14+
|| * **latest / all** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3407865.svg |
15+
|| || :target: https://doi.org/10.5281/zenodo.3407865 |
16+
+---------------------+----------------------------------------------------------------------+
17+
|| * **6.7.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.19398868.svg |
18+
|| || :target: https://doi.org/10.5281/zenodo.19398868 |
19+
+---------------------+----------------------------------------------------------------------+
20+
|| * **6.6.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.16448627.svg |
21+
|| || :target: https://doi.org/10.5281/zenodo.16448627 |
22+
+---------------------+----------------------------------------------------------------------+
23+
|| * **6.5.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.10119499.svg |
24+
|| || :target: https://doi.org/10.5281/zenodo.10119499 |
25+
+---------------------+----------------------------------------------------------------------+
26+
|| * **6.4.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.6623271.svg |
27+
|| || :target: https://doi.org/10.5281/zenodo.6623271 |
28+
+---------------------+----------------------------------------------------------------------+
29+
|| * **6.3.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.5708769.svg |
30+
|| || :target: https://doi.org/10.5281/zenodo.5708769 |
31+
+---------------------+----------------------------------------------------------------------+
32+
|| * **6.2.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4900001.svg |
33+
|| || :target: https://doi.org/10.5281/zenodo.4900001 |
34+
+---------------------+----------------------------------------------------------------------+
35+
|| * **6.1.1** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4010996.svg |
36+
|| || :target: https://doi.org/10.5281/zenodo.4010996 |
37+
+---------------------+----------------------------------------------------------------------+
38+
|| * **6.1.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3924517.svg |
39+
|| || :target: https://doi.org/10.5281/zenodo.3924517 |
40+
+---------------------+----------------------------------------------------------------------+
41+
|| * **6.0.0** || .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3407866.svg |
42+
|| || :target: https://doi.org/10.5281/zenodo.3407866 |
43+
+---------------------+----------------------------------------------------------------------+
44+
45+
The articles on GMT are:
46+
47+
* **PyGMT**:
48+
Tian, D., Fröhlich, Y., Leong, W. J., Grund, M., Schlitzer, W., Jones, M., Uieda, L., Luis, J. M. F. (2026).
49+
PyGMT: Bridging Python and the Generic Mapping Tools for Geospatial Visualization and Analysis.
50+
*Geochemistry, Geophysics, Geosystems*, 27(7), e2026GC013105.
51+
https://doi.org/10.1029/2026GC013105
52+
* **GMT 6**:
53+
Wessel, P., Luis, J. F., Uieda, L., Scharroo, R., Wobbe, F., Smith, W. H. F., & Tian, D. (2019).
54+
The Generic Mapping Tools Version 6.
55+
*Geochemistry, Geophysics, Geosystems*, 20(11), 5556–5564.
56+
https://doi.org/10.1029/2019GC008515
57+
* **GMT Animation**:
58+
Wessel, P., Esteban, F., & Delaviel-Anger, G. (2024).
59+
The Generic Mapping Tools and Animations for the Masses.
60+
*Geochemistry, Geophysics, Geosystems*, 25(6).
61+
https://doi.org/10.1029/2024GC011545
62+
* **Origin of GMT**:
63+
Wessel, P. (2024).
64+
The origins of the generic mapping tools: From table tennis to geoscience.
65+
*Perspectives of Earth and Space Scientists*, 5(1), e2023CN000231.
66+
https://doi.org/10.1029/2023CN000231
67+
* **GMT/MATLAB**:
68+
Wessel, P., & Luis, J. F. (2017).
69+
The GMT/MATLAB Toolbox.
70+
*Geochemistry, Geophysics, Geosystems*, 18(2), 811–823.
71+
https://doi.org/10.1002/2016GC006723
72+
* **GMT 5**:
73+
Wessel, P., Smith, W. H. F., Scharroo, R., Luis, J., & Wobbe, F. (2013).
74+
Generic Mapping Tools: Improved Version Released.
75+
*EOS, Transactions American Geophysical Union*, 94(45), 409–410.
76+
https://doi.org/10.1002/2013EO450001
77+
* **GMT 3.1**:
78+
Wessel, P., & Smith, W. H. F. (1998).
79+
New, improved version of generic mapping tools released.
80+
*EOS, Transactions American Geophysical Union*, 79(47), 579–579.
81+
https://doi.org/10.1029/98EO00426
82+
* **GMT 3.0**:
83+
Wessel, P., & Smith, W. H. F. (1995).
84+
New version of the generic mapping tools.
85+
*EOS, Transactions American Geophysical Union*, 76(33), 329–329.
86+
https://doi.org/10.1029/95EO00198
87+
* **GMT 2**:
88+
Wessel, P., & Smith, W. H. F. (1991).
89+
Free software helps map and display data.
90+
*EOS, Transactions American Geophysical Union*, 72(41), 441–446.
91+
https://doi.org/10.1029/90EO00319
92+
93+
Some GMT modules are based on algorithms we have developed and published separately,
94+
such as:
95+
96+
* Kim, S.-S., & Wessel, P. (2008).
97+
Directional median filtering for regional‐residual separation of bathymetry.
98+
*Geochemistry, Geophysics, Geosystems*, 9(3), 2007GC001850.
99+
https://doi.org/10.1029/2007GC001850
100+
[``dimfilter``]
101+
* Luis, J. F., & Miranda, J. M. (2008).
102+
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.
103+
*Journal of Geophysical Research: Solid Earth*, 113(B10), 2007JB005573.
104+
https://doi.org/10.1029/2007JB005573
105+
[``grdredpol``, **potential** supplement]
106+
* Smith, W. H. F., & Wessel, P. (1990).
107+
Gridding with continuous curvature splines in tension.
108+
*Geophysics*, 55(3), 293–305.
109+
https://doi.org/10.1190/1.1442837
110+
[``surface``]
111+
* Wessel, P. (2010).
112+
Tools for analyzing intersecting tracks: The x2sys package.
113+
*Computers & Geosciences*, 36(3), 348–354.
114+
https://doi.org/10.1016/j.cageo.2009.05.009
115+
[**x2sys** supplement]
116+
* Wessel, P. (2009).
117+
A general-purpose Green’s function-based interpolator.
118+
*Computers & Geosciences*, 35(6), 1247–1254.
119+
https://doi.org/10.1016/j.cageo.2008.08.012
120+
[``greenspline``]
121+
* Wessel, P., & Becker, J. M. (2008).
122+
Interpolation using a generalized Green’s function for a spherical surface spline in tension.
123+
*Geophysical Journal International*, 174(1), 21–28.
124+
https://doi.org/10.1111/j.1365-246X.2008.03829.x
125+
[``greenspline``]

‎_sources/documentation/index.rst.txt‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
.. title:: Documentation
2+
3+
Documentation
4+
=============
5+
6+
Documentation for GMT is available online in different versions (if in doubt, use the
7+
**latest stable** version):
8+
9+
* `Latest stable release <https://docs.generic-mapping-tools.org/latest>`__
10+
* `Current development version (unstable nightly builds) <https://docs.generic-mapping-tools.org/dev/>`__
11+
* `GMT 6.6.0 <https://docs.generic-mapping-tools.org/6.6/>`__
12+
* `GMT 6.5.0 <https://docs.generic-mapping-tools.org/6.5/>`__
13+
* `GMT 6.4.0 <https://docs.generic-mapping-tools.org/6.4/>`__
14+
* `GMT 6.3.0 <https://docs.generic-mapping-tools.org/6.3/>`__
15+
* `GMT 6.2.0 <https://docs.generic-mapping-tools.org/6.2/>`__
16+
* `GMT 6.1.1 <https://docs.generic-mapping-tools.org/6.1/>`__
17+
* `GMT 6.0.0 <https://docs.generic-mapping-tools.org/6.0/>`__
18+
* `GMT 5.4.5 <https://docs.generic-mapping-tools.org/5.4/>`__
19+
* `GMT 4.5.18 <https://docs.generic-mapping-tools.org/4/>`__

‎_sources/download/index.rst.txt‎

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
.. title:: Download
2+
3+
Download
4+
========
5+
6+
Releases
7+
--------
8+
9+
GMT Releases
10+
~~~~~~~~~~~~
11+
12+
GMT is available on Windows, macOS, Linux and FreeBSD. Source and binary packages are provided
13+
from `GitHub <https://github.com/GenericMappingTools/gmt/releases>`__:
14+
15+
* `GMT 6.7.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.7.0>`__ (**recommended**)
16+
* `GMT 6.6.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.6.0>`__
17+
* `GMT 6.5.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.5.0>`__
18+
* `GMT 6.4.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.4.0>`__
19+
* `GMT 6.3.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.3.0>`__
20+
* `GMT 6.2.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.2.0>`__
21+
* `GMT 6.1.1 <https://github.com/GenericMappingTools/gmt/releases/tag/6.1.1>`__
22+
* `GMT 6.1.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.1.0>`__
23+
* `GMT 6.0.0 <https://github.com/GenericMappingTools/gmt/releases/tag/6.0.0>`__
24+
* `GMT 5.4.5 <https://github.com/GenericMappingTools/gmt/releases/tag/5.4.5>`__
25+
* `GMT 4.5.18 <https://github.com/GenericMappingTools/gmt/wiki/GMT-4.5.18>`__
26+
27+
GMT Wrapper Releases
28+
~~~~~~~~~~~~~~~~~~~~
29+
30+
The latest `GMT.jl <https://www.generic-mapping-tools.org/GMT.jl/stable/>`__ and
31+
`PyGMT <https://www.pygmt.org/latest/>`__ releases are provided from GitHub:
32+
33+
* `GMT.jl releases <https://github.com/GenericMappingTools/GMT.jl/releases>`__
34+
* `PyGMT releases <https://github.com/GenericMappingTools/pygmt/releases>`__
35+
36+
Support Data
37+
------------
38+
39+
* `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
40+
* `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]
41+
42+
**Note:** You may also get GMT and its support data from any of :doc:`the GMT FTP mirrors </mirrors/index>`.
43+
Try the site that is closest to you to minimize transmission times.
44+
45+
Install
46+
-------
47+
48+
See the `install guide`_ for instructions and to make sure you have all required
49+
dependencies installed.
50+
51+
Alternatively, you can build GMT from source by following the `building guide`_.
52+
53+
.. _install guide: https://docs.generic-mapping-tools.org/latest/install.html
54+
.. _building guide: https://github.com/GenericMappingTools/gmt/blob/master/BUILDING.md

0 commit comments

Comments
 (0)