Release PyGMT v0.19.0

@seisman

Release: v0.19.0
Scheduled Date: 2026/07/05
Pull request due date: 2026/07/05
DOI: 10.5281/zenodo.19398871
Announcement draft: https://hackmd.io/xgfUvmc4TMW-fOGMoi_IbQ

Priority PRs/issues to complete prior to release

Before release:

Release:

At the PyGMT release page on GitHub:
- Edit the draft release notes with the finalized changelog
- Set the tag version and release title to vX.Y.Z
- Make a release by clicking the 'Publish Release' button, this will automatically create a tag too
Verify that all workflows triggered by the release pass
- The latest version is correct on PyPI
- The latest version is correct on https://www.pygmt.org/latest/
- The release page has five assets, including baseline-images.zip, pygmt-docs.zip and pygmt-docs.pdf
Download pygmt-X.Y.Z.zip (rename to pygmt-vX.Y.Z.zip) and baseline-images.zip from the release page, and upload the two zip files to https://zenodo.org/deposit, ensure that they are filed under the correct reserved DOI

After release:

Update conda-forge pygmt-feedstock (Done automatically by conda-forge's bot. If you don't want to wait, open a new issue in the conda-forge/pygmt-feedstock repository with the title @conda-forge-admin, please update version. This will trigger the bot immediately. Remember to pin GMT, Python and SPEC0 versions)
Bump PyGMT version on https://github.com/GenericMappingTools/try-gmt (after conda-forge update) Bump version to PyGMT v0.19.0 and geopandas 1.1.4 try-gmt#67
Announce the release on:
- GMT forum (do this announcement first! Requires moderator status)
- ResearchGate (after forum announcement; download the ZIP file of the new release from Zenodo and add it as research item via the code category, be sure to include the corresponding new Zenodo DOI) https://www.researchgate.net/publication/410488164_PyGMT_A_Python_interface_for_the_Generic_Mapping_Tools_v0190
Update release checklist template with any additional bullet points that may have arisen during the release Update the release checklist post v0.19.0 release #4733

Party 🎉 (don't tick before all other checkboxes are ticked!)

@yvonnefroehlich

@yvonnefroehlich I'm encountering internet connection issues accessing Zenodo. Could you please upload this version to Zenodo ?

@weiji14

@yvonnefroehlich I'm encountering internet connection issues accessing Zenodo. Could you please upload this version to Zenodo ?

Sure, I looked at this. I expected to see an unpublished draft record (see example from my own uploads) with the reserved DOI, but I can only find the published record for v0.18.0:

Maybe a draft record is only visible to the person who created it? Or I do not have enough permission (https://help.zenodo.org/docs/communities/about-communities/) as a Curator (you and @weiji14 are Owners)? Clicking "New upload" would lead to an upload, which is not listed as a version of the PyGMT upload. Clicking "New version" was already done to reserve the DOI and doing this again would generate a new DOI.

@yvonnefroehlich

Ok, I've done the Zenodo uploads. Have also added the paper DOI under 'Related Works' -> 'Is published in':

@yvonnefroehlich, I've bumped your permissions from Curator to Manager. Not sure if it helps you to see draft uploads, can check next time.

Ok, I've done the Zenodo uploads. Have also added the paper DOI under 'Related Works' -> 'Is published in':

@yvonnefroehlich, I've bumped your permissions from Curator to Manager. Not sure if it helps you to see draft uploads, can check next time.

Great! Thanks 🙂.

I'm still on a trip and have limited access to HackMD. For the announcement, I suggest we:

PyGMT paper section: Add a note acknowledging the typo in the PyGMT paper DOI.
Frame/Axis classes: These are new features that deserve a more thorough introduction. It would be helpful to include a side-by-side example comparing the legacy list syntax with the new class syntax, e.g.:

Old syntax:
```
frame=["xaf+lX", "yaf+lY", "+tTitle"]
```
New syntax:
```
frame=Frame(
    xaxis=Axis(annot=True, tick=True, label="X"),
    yaxis=Axis(annot=True, tick=True, label="Y"),
    title="Title"
)
```
and link to the frames tutorial at https://www.pygmt.org/v0.19.0/tutorials/basics/frames.html

I'm still on a trip and have limited access to HackMD. For the announcement, I suggest we:

I should have time today to fill the table for the examples and include these ideas into the announcement. If people have time proofreading would be nice afterwards, and then I could post it later the day (evening or night).

@weiji14

PyGMT paper section: Add a note acknowledging the typo in the PyGMT paper DOI.

I feel this is no longer necessary because the typo is only visible in the README file of the source code archive after @weiji14's fix in #4730, so it should have limited effect.

@michaelgrund

I'm still on a trip and have limited access to HackMD. For the announcement, I suggest we:

I should have time today to fill the table for the examples and include these ideas into the announcement. If people have time proofreading would be nice afterwards, and then I could post it later the day (evening or night).

I have filled the table to show the new and updated examples, added a separate subsection for the Axis and Frame parameter with the simple comparison example from Dongdong, included an image of the new PyGMT logo, and added a link to the JNs published along with the PyGMT paper.
I realized that besides the examples we already mentioned, the choropleth gallery example and the basic tutorial for setting the map frame were updated to use the high-level method and new parameter classes. Thus, I changed it to ten instead of eight new and updated examples.

I plan to post the announcement in the evening or night. So, @michaelgrund and @weiji14 if you have time, please have a look to see that everything looks good.

Forum announcement is at https://forum.generic-mapping-tools.org/t/pygmt-v0-19-0-released/6464.

ResearchGate done at https://www.researchgate.net/publication/410488164_PyGMT_A_Python_interface_for_the_Generic_Mapping_Tools_v0190.

Navigation Menu

Repository navigation

Release PyGMT v0.19.0 #4649

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Release PyGMT v0.19.0 #4649

Description

Activity

seisman commented on Jul 8, 2026

yvonnefroehlich commented on Jul 8, 2026

weiji14 commented on Jul 9, 2026

yvonnefroehlich commented on Jul 9, 2026

seisman commented on Jul 17, 2026

yvonnefroehlich commented on Jul 17, 2026

seisman commented on Jul 17, 2026

yvonnefroehlich commented on Jul 17, 2026

yvonnefroehlich commented on Jul 17, 2026

seisman commented on Jul 18, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions