# PyGMT v0.15.0 released

**URL:** <https://forum.generic-mapping-tools.org/t/pygmt-v0-15-0-released/5812>\
**Category:** Announcements\
**Created:** [March 31, 2025, 12:29pm UTC](https://forum.generic-mapping-tools.org/t/pygmt-v0-15-0-released/5812 "2025-03-31T12:29:24Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![yvonnefroehlich](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/yvonnefroehlich/32/5064_2.png) [@yvonnefroehlich](https://forum.generic-mapping-tools.org/u/yvonnefroehlich)\
**Post date:** [March 31, 2025, 12:29pm UTC](https://forum.generic-mapping-tools.org/t/pygmt-v0-15-0-released/5812/1 "2025-03-31T12:29:24Z")

</div>

**We’re excited to announce the release of PyGMT [v0.15.0](https://www.pygmt.org/v0.15.0)! 🎉 This minor release includes nice enhancements, and documentation improvements.**

**Here are the highlights** 🎉:

- One new gallery example and two new tutorials to help users get started and explore new features
- `Figure.shift_origin` now supports shifting origins temporarily when used as a context manager
- PyGMT documentation is now available as [HTML ZIP](https://github.com/GenericMappingTools/pygmt/releases/download/v0.15.0/pygmt-docs.zip) archive and in [PDF](https://github.com/GenericMappingTools/pygmt/releases/download/v0.15.0/pygmt-docs.pdf) format for offline reference

| Focal mechanisms as beachballs (`Figure.meca`) | Creating complex legends (`Figure.legend`) | Plotting horizontal & vertical lines (`Figure.hlines`, `Figure.vlines`) |
| --- | --- | --- |
| [![](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/b/bd8f28d16b40a0bc95a63aa76c930b6656f0872b.png)](https://www.pygmt.org/v0.15.0/tutorials/advanced/focal_mechanisms.html) | [![](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/e/e91dffc707d9c57e468695782bb850bdf050a1dc.png)](https://www.pygmt.org/v0.15.0/tutorials/advanced/legends.html) | [![](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/a/a9de61212c0adf740e2ff125766e22867b128023.png)](https://www.pygmt.org/v0.15.0/gallery/lines/hlines_vlines.html) |

**Nice enhancements ✨** :

- Support typesetting apostrophe (') and backtick (`). What you type is what you see! ([#3105](https://github.com/GenericMappingTools/pygmt/pull/3105))
- GMTDataArrayAccessor: Support passing more readable values using enums GridRegistration and GridType for grid registration and type ([#3696](https://github.com/GenericMappingTools/pygmt/pull/3696))
- `pygmt.grdfill`: Pythonic 🐍 parameters `constantfill`/`gridfill`/`neighborfill`/`splinefill` for different hole-filling algorithms

Read through the [changelog](https://www.pygmt.org/v0.15.0/changes.html) for the full list of changes. Installation/upgrade ⬆ instructions are at [Installing — PyGMT](https://www.pygmt.org/v0.15.0/install.html)! Note that this version is cross-compatible with GMT 6.4 - 6.5, but it requires Python 3.11+ 🐍, NumPy 1.25+, pandas 2.0+, and Xarray 2023.04+ following our [support policy for GMT and other package dependencies](https://www.pygmt.org/v0.15.0/minversions.html). Go try it online at [try-gmt](https://github.com/GenericMappingTools/try-gmt) 🚀.

As usual, please feel free to report any bugs 🪲 with the [issue template on GitHub](https://github.com/GenericMappingTools/pygmt/issues/new?assignees=&labels=bug&template=bug_report.yaml). Your feedback is what helps us to improve 🙏! For example, this bug report at issue [#3104](https://github.com/GenericMappingTools/pygmt/issues/3104) sparked off a major refactoring by @seisman at PR [#3132](https://github.com/GenericMappingTools/pygmt/pull/3132) that removed a ton of workarounds in PyGMT’s codebase related to spaces and funny characters!

### 🛤 Roadmap to future releases

While the team continues to enhance functionality and fix bugs, there are still plenty of features and improvements we’d like to add! Check out the [good first issue label](https://github.com/GenericMappingTools/pygmt/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) on GitHub or the list below for things you can help with!

- **PyGMT Logo**  
Thanks to the contributions of [@sfrooti](https://github.com/sfrooti), we’re very close to having an official logo for PyGMT. If you’d like to provide feedback during the early stages of the design process, please leave your comments on [issue #1404](https://github.com/GenericMappingTools/pygmt/issues/1404) or [PR #3849](https://github.com/GenericMappingTools/pygmt/pull/3849). Stay tuned!

- Features/enhancements ✨

- Documentation improvements 📖

Please don’t be shy to [reach out on GitHub](https://github.com/GenericMappingTools/pygmt) if you’re interested in contributing 😄! Also have a look at our [Contributors Guide](https://www.pygmt.org/v0.15.0/contributing.html) to figure out how you can help and get started 🚀.

### ⚠ Upcoming deprecations

- **v0.16.0 (Planned for June 2025)**

- **v0.19.0 (Planned for March 2026)**

- **v1.0.0**

The compatibility matrix for GMT, Python, and the required core package dependencies NumPy, pandas, and Xarray is listed at [Minimum Supported Versions — PyGMT](https://www.pygmt.org/v0.15.0/minversions.html), so make sure you keep things up to date!

### 🗺 Conference presentations/workshops/sprints

- The GMT and PyGMT teams have organized an AGU pre-conference workshop for GMT and PyGMT 💻 in Washington, D.C. 🏛 on 2024-12-08: **PREWS9 Mastering Geospatial Visualizations with GMT/PyGMT**. If you could not make it to the AGU Annual meeting this year in-person, or you missed the workshop for other reasons, you can still go through the workshop on your own, as the materials are freely available from [Mastering Geospatial Visualizations with GMT/PyGMT — Mastering Geospatial Visualizations with GMT/PyGMT](https://www.generic-mapping-tools.org/agu24workshop/intro.html).
- Besides this workshop there was an union-wide memorial session for Paul Wessel: **U019 - The impact of GMT in the Earth, Ocean and Space sciences: What’s next?**. Check out the slides for the PyGMT talk **PyGMT – Accessing and Integrating GMT with Python and the Scientific Python Ecosystem** , which are free available from [https://doi.org/10.6084/m9.figshare.28049495](https://doi.org/10.6084/m9.figshare.28049495).

| GMT/PyGMT preworkshop | PyGMT talk |
| --- | --- |
| [![GMT/PyGMT preworkshop](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/b/b718dc259574e5631ec10a3b49abead560e32f33.png)](https://www.generic-mapping-tools.org/agu24workshop/intro.html) | [![PyGMT talk](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/f/f0142b46186ed4c80858e56a60264c031c8c283d.jpeg)](https://figshare.com/articles/presentation/PyGMT_Accessing_and_Integrating_GMT_with_Python_and_the_Scientific_Python_Ecosystem_AGU24_U12B-05_/28049495?file=51279815) |

**P.S.** Share the word on Instagram [@genericmappingtools](https://www.instagram.com/genericmappingtools/) 📸 and ResearchGate!
