gmt

The Generic Mapping Tools

https://github.com/genericmappingtools/gmt

Science Score: 77.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 7 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    10 of 77 committers (13.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.3%) to scientific vocabulary

Keywords

c earth-science generic-mapping-tools geophysics geospatial mapping

Keywords from Contributors

closember gtk qt tk wx geoscience mesh interpolation jax multiprocessing
Last synced: 6 months ago · JSON representation ·

Repository

The Generic Mapping Tools

Basic Info
Statistics
  • Stars: 908
  • Watchers: 40
  • Forks: 388
  • Open Issues: 256
  • Releases: 18
Topics
c earth-science generic-mapping-tools geophysics geospatial mapping
Created over 7 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing License Citation

README.md

GMT logo

Generic Mapping Tools

Tests CodeCov Coverity Documentation (development version) GitHub release Contributor Covenant DOI

What is GMT?

GMT is an open source collection of about 100 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, 3D perspective views and animations. The GMT supplements add another 50 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 the GMT Team, with help from a global set of contributors and support by the National Science Foundation.

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.

Installation

GMT has been installed successfully under UNIX/Linux/macOS/FreeBSD/OpenBSD 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.gz: The GMT 6 distribution
  2. gshhg-gmt-2.x.x.tar.gz: All five resolutions of GSHHG coastline data
  3. dcw-gmt-2.x.x.tar.gz: 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 the GMT main site.

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

Citation

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

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, 5556-5564. https://doi.org/10.1029/2019GC008515

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 by opening an issue 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.

For general questions, please post on the GMT Community Forum.

Contributing

Contributions are welcome and appreciated. Please refer to the contributing guidelines for more details.

License

Copyright (c) 1991-2025 by the GMT Team.

GMT is released under the GNU Lesser General Public License version 3 or any later version. See LICENSE.TXT for full details.

Acknowledgment

GMT relies on several other Open Source software libraries, programs and data for its operation. We gratefully acknowledge the importance to GMT of these products. GMT may be linked with these libraries (* means optional):

Network Common Data Form (netCDF), Geospatial Data Abstraction Library (GDAL), Perl Compatible Regular Expressions (PCRE*), Fastest Fourier Transform in the West (FFTW*), Linear Algebra Package (LAPACK*), Basic Linear Algebra Subprograms (BLAS*), GLIB*, and ZLIB*. GMT may call these executables: GDAL (ogr2ogr, gdal_translate), Ghostscript, FFmpeg, xdg-open, and GraphicsMagick.

GMT uses (or can access) raster data derived from these sources:

GMT provides several color maps from these sources:

Owner

  • Name: The Generic Mapping Tools (GMT)
  • Login: GenericMappingTools
  • Kind: organization

Tools for manipulating geographic and Cartesian data and creating plots, maps, and 3D views

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you think it is appropriate, you may consider paying us back by including our latest article in the reference list of your future publications that will benefit from the availability of GMT."
title: "The Generic Mapping Tools Version 6"
authors:
- family-names: Wessel
  given-names: Paul
  affiliation: University of Hawai'i at Mānoa, USA
  orcid: https://orcid.org/0000-0001-5708-7336
- family-names: "Luis"
  given-names: "Joaquim"
  orcid: "https://orcid.org/0000-0002-9035-4069"
- family-names: "Uieda"
  given-names: "Leonardo"
  orcid: "https://orcid.org/0000-0001-6123-9515"
- family-names: "Scharroo"
  given-names: "Remko"
  orcid: "https://orcid.org/0000-0002-2118-131X"
- family-names: "Wobbe"
  given-names: "Florian"
- family-names: "Smith"
  given-names: "Walter"
  orcid: "https://orcid.org/0000-0002-8814-015X"
- family-names: "Tian"
  given-names: "Dongdong"
  orcid: "https://orcid.org/0000-0001-7967-1197"
- family-names: "Jones"
  given-names: "Max"
  orcid: "https://orcid.org/0000-0003-0180-8928"
- family-names: "Esteban"
  given-names: "Federico"
  orcid: "https://orcid.org/0000-0002-0641-7371"
- family-names: "Fröhlich"
  given-names: "Yvonne"
  orcid: "https://orcid.org/0000-0002-0641-7371"
version: 6.6.0
doi: 10.5281/zenodo.16448627
date-released: 2025-07-26
license: LGPL-3.0-or-later
repository-code: "https://github.com/GenericMappingTools/gmt"
type: software
preferred-citation:
  type: article
  authors:
  - family-names: "Wessel"
    given-names: "Paul"
    orcid: "https://orcid.org/0000-0001-5708-7336"
  - family-names: "Luis"
    given-names: "Joaquim"
    orcid: "https://orcid.org/0000-0002-9035-4069"
  - family-names: "Uieda"
    given-names: "Leonardo"
    orcid: "https://orcid.org/0000-0001-6123-9515"
  - family-names: "Scharroo"
    given-names: "Remko"
    orcid: "https://orcid.org/0000-0002-2118-131X"
  - family-names: "Wobbe"
    given-names: "Florian"
  - family-names: "Smith"
    given-names: "Walter"
    orcid: "https://orcid.org/0000-0002-8814-015X"
  - family-names: "Tian"
    given-names: "Dongdong"
    orcid: "https://orcid.org/0000-0001-7967-1197"
  doi: "10.1029/2019GC008515"
  journal: "Geochemistry, Geophysics, Geosystems"
  start: 5556
  end: 5564
  title: "The Generic Mapping Tools version 6"
  issue: 11
  volume: 20
  year: 2019

GitHub Events

Total
  • Create event: 94
  • Commit comment event: 3
  • Release event: 1
  • Issues event: 81
  • Watch event: 55
  • Delete event: 85
  • Issue comment event: 320
  • Push event: 259
  • Pull request review comment event: 11
  • Pull request review event: 90
  • Pull request event: 209
  • Fork event: 35
Last Year
  • Create event: 94
  • Commit comment event: 3
  • Release event: 1
  • Issues event: 81
  • Watch event: 55
  • Delete event: 85
  • Issue comment event: 320
  • Push event: 259
  • Pull request review comment event: 11
  • Pull request review event: 90
  • Pull request event: 209
  • Fork event: 35

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 26,066
  • Total Committers: 77
  • Avg Commits per committer: 338.519
  • Development Distribution Score (DDS): 0.389
Past Year
  • Commits: 225
  • Committers: 15
  • Avg Commits per committer: 15.0
  • Development Distribution Score (DDS): 0.689
Top Committers
Name Email Commits
Paul Wessel p****l@h****u 15,939
Joaquim Luis j****s@g****m 4,149
Remko Scharroo r****o@e****t 2,678
Dongdong Tian s****o@g****m 1,400
Florian Wobbe f****n@e****e 760
Meghan Jones m****j@a****u 191
Roger Davis r****s 133
dependabot[bot] 4****] 128
Federico Esteban f****n@g****m 100
anbj 2****j 99
Meghan Jones m****j@h****u 89
Michael Chandler m****l@h****u 67
Ben Horner-Johnson b****n 67
Yvonne Fröhlich 9****h 48
積丹尼 Dan Jacobson j****i@j****g 42
KristofKoch 4****h 29
Leonardo Uieda l****a@g****m 21
Walter H. F. Smith w****h@n****v 16
abanbj 2****j 10
Will Schlitzer s****0@g****m 9
Michael Grund 2****d 6
王亮 w****2@g****m 5
Lloyd Parkes l****d 4
Olivier Sarzeaud s****d@e****r 4
Wei Ji 2****4 4
holishing h****t@g****m 4
Mao Zhou 1****3@q****m 4
Marcin Rajner m****r@w****l 3
Yao Jiayuan c****m@g****m 3
Bas Couwenberg s****c@x****l 3
and 47 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 399
  • Total pull requests: 999
  • Average time to close issues: 9 months
  • Average time to close pull requests: 14 days
  • Total issue authors: 65
  • Total pull request authors: 26
  • Average comments per issue: 4.05
  • Average comments per pull request: 1.79
  • Merged pull requests: 897
  • Bot issues: 57
  • Bot pull requests: 88
Past Year
  • Issues: 65
  • Pull requests: 237
  • Average time to close issues: 6 days
  • Average time to close pull requests: 2 days
  • Issue authors: 24
  • Pull request authors: 13
  • Average comments per issue: 1.63
  • Average comments per pull request: 1.18
  • Merged pull requests: 198
  • Bot issues: 7
  • Bot pull requests: 33
Top Authors
Issue Authors
  • PaulWessel (58)
  • joa-quim (56)
  • github-actions[bot] (55)
  • Esteban82 (50)
  • seisman (37)
  • rbdavis (24)
  • anbj (13)
  • jidanni (12)
  • maxrjones (11)
  • yvonnefroehlich (9)
  • KristofKoch (4)
  • MarceloBanik (4)
  • gd-a (3)
  • ZMAlt (3)
  • weiji14 (3)
Pull Request Authors
  • PaulWessel (293)
  • rbdavis (157)
  • seisman (147)
  • joa-quim (143)
  • dependabot[bot] (87)
  • yvonnefroehlich (46)
  • Esteban82 (44)
  • anbj (23)
  • Dengda98 (15)
  • remkos (14)
  • jidanni (6)
  • maxrjones (4)
  • michaelgrund (3)
  • CovMat (2)
  • gsitcia (2)
Top Labels
Issue Labels
bug (169) feature request (108) documentation (36) longterm (12) maintenance (9) discussion (6) priority (3) enhancement (3) help wanted (2) add-changelog (2) good first issue (2) question (1)
Pull Request Labels
maintenance (181) documentation (166) bug (104) add-changelog (85) enhancement (77) new core module feature (9) new feature (8) deprecation (5) new module (4) supplement update (3) need-review (3) priority (2) longterm (1) feature request (1) discussion (1)

Packages

  • Total packages: 1
  • Total downloads: unknown
  • Total dependent packages: 2
  • Total dependent repositories: 37
  • Total versions: 13
conda-forge.org: 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

  • Versions: 13
  • Dependent Packages: 2
  • Dependent Repositories: 37
Rankings
Dependent repos count: 5.9%
Forks count: 9.9%
Average: 12.5%
Stargazers count: 14.6%
Dependent packages count: 19.6%
Last synced: 6 months ago

Dependencies

.github/workflows/backport.yml actions
  • tibdex/backport v2.0.3 composite
.github/workflows/build.yml actions
  • actions/cache v3 composite
  • actions/checkout v3.3.0 composite
  • dawidd6/action-download-artifact v2.25.0 composite
  • styfle/cancel-workflow-action 0.11.0 composite
.github/workflows/check-links.yml actions
  • actions/checkout v3.3.0 composite
  • lycheeverse/lychee-action v1.5.4 composite
  • peter-evans/create-issue-from-file v4 composite
.github/workflows/ci-caches.yml actions
  • actions/checkout v3.3.0 composite
  • actions/upload-artifact v3 composite
  • styfle/cancel-workflow-action 0.11.0 composite
.github/workflows/code-validator.yml actions
  • actions/checkout v3.3.0 composite
.github/workflows/docker.yml actions
  • actions/cache v3 composite
  • actions/checkout v3.3.0 composite
  • dawidd6/action-download-artifact v2.25.0 composite
  • styfle/cancel-workflow-action 0.11.0 composite
.github/workflows/docs.yml actions
  • actions/cache v3 composite
  • actions/checkout v3.3.0 composite
  • dawidd6/action-download-artifact v2.25.0 composite
  • styfle/cancel-workflow-action 0.11.0 composite
.github/workflows/draft-release.yml actions
  • softprops/action-gh-release v1 composite
.github/workflows/lint-checker.yml actions
  • actions/checkout v3.3.0 composite
.github/workflows/release-baseline-images.yml actions
  • actions/checkout v3.3.0 composite
  • iterative/setup-dvc v1.1.1 composite
  • shogo82148/actions-upload-release-asset v1.6.3 composite
.github/workflows/release-drafter.yml actions
  • release-drafter/release-drafter v5.22.0 composite
.github/workflows/scm-check.yml actions
  • nashmaniac/create-issue-action v1.1 composite
.github/workflows/tests.yml actions
  • actions/cache v3 composite
  • actions/checkout v3.3.0 composite
  • actions/upload-artifact v3 composite
  • dawidd6/action-download-artifact v2.25.0 composite
  • styfle/cancel-workflow-action 0.11.0 composite
.github/workflows/remind.yml actions
  • actions/checkout v4 composite
.github/workflows/dvc-diff.yml actions
  • actions/checkout v4.0.0 composite
  • actions/setup-node v3.8.1 composite
  • iterative/setup-cml v1.2.3 composite
  • iterative/setup-dvc v1.1.2 composite
  • mamba-org/setup-micromamba v1.4.4 composite