# PyGMT v0.5.0 released

**URL:** <https://forum.generic-mapping-tools.org/t/pygmt-v0-5-0-released/2233>\
**Category:** Announcements\
**Created:** [October 30, 2021, 9:32am UTC](https://forum.generic-mapping-tools.org/t/pygmt-v0-5-0-released/2233 "2021-10-30T09:32:50Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![mgrund](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/mgrund/32/139_2.png) [@mgrund](https://forum.generic-mapping-tools.org/u/mgrund)\
**Post date:** [October 30, 2021, 9:32am UTC](https://forum.generic-mapping-tools.org/t/pygmt-v0-5-0-released/2233/1 "2021-10-30T09:32:51Z")

</div>

# [PyGMT v0.5.0 released](https://flint.soest.hawaii.edu/t/pygmt-v0-4-1-released)

**Announcing [PyGMT v0.5.0](https://github.com/GenericMappingTools/pygmt/releases/tag/v0.5.0), covering 12 new PyGMT functions!**

The PyGMT team is pleased to present version [v0.5.0](https://www.pygmt.org/v0.5.0), a jam-packed release made by 15 awesome open source 👩‍💻 contributors! Here are the highlights:

- Wrapped 12 GMT modules
- Standardized and reordered table inputs to be ‘data, x, y, z’ across functions ([#1479](https://github.com/GenericMappingTools/pygmt/pull/1479))
- Added a gallery example showing usage of line objects from a geopandas.GeoDataFrame ([#1474](https://github.com/GenericMappingTools/pygmt/pull/1474))

The full list of changes can be found in the [changelog](https://www.pygmt.org/v0.5.0/changes.html#release-v0-5-0-2021-10-29). Installation/Upgrade instructions can be found at [Installing — PyGMT](https://www.pygmt.org/v0.5.0/install.html), or you can try it online first at [try-gmt](https://github.com/GenericMappingTools/try-gmt)! If you’ve been using PyGMT in your work, please remember to 📝 cite the Digital Object Identifier ([DOI](https://doi.org/10.5281/zenodo.5607255)) of the version used. We’ve made it easier this release with a `CITATION.cff` file that enables a button to ‘Cite this repository’ on [GitHub](https://github.com/GenericMappingTools/pygmt), or you can copy the BibTeX from [GitHub - GenericMappingTools/pygmt: A Python interface for the Generic Mapping Tools. · GitHub](https://github.com/GenericMappingTools/pygmt#citing-pygmt).

 ![image](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/6/6c221b2d1721b657bc577d0991d8b9c1629b41c3.png)

Contributions in PyGMT are a team effort 🧑‍🤝‍🧑. Special shoutout to [@arleaman](https://github.com/arleaman), [@BeckySalvage](https://github.com/BeckySalvage), [@daroari](https://github.com/daroari), [@obaney](https://github.com/obaney) and [@srijac](https://github.com/srijac) for contributing during the [2021 ESWN PyGMT development workshop](https://github.com/GenericMappingTools/2021-eswn-pygmt-workshop)! Big cheers also to first time contributor [@aitorres](https://github.com/aitorres) for adding support for `pathlib.Path` inputs, and to returning contributor @claudiodsf for wrapping the [project](https://www.pygmt.org/v0.5.0/api/generated/pygmt.project.html) module for reprojecting data!

We’d also like to give a big thank you to all the maintainers in PyGMT and GMT for contributing behind the scenes to make all of this possible. Head over to the [team gallery](https://www.pygmt.org/v0.5.0/team.html) to see who they are! We always welcome new contributors to join in and contribute to this amazing open source project, so find us on GitHub at [GitHub - GenericMappingTools/pygmt: A Python interface for the Generic Mapping Tools. · GitHub](https://github.com/GenericMappingTools/pygmt) and say hi!

### 💡 New gallery examples

Thanks to [@yohaimagen](https://github.com/yohaimagen) for adding an example on making [hillshade maps using grdgradient](https://www.pygmt.org/v0.5.0/gallery/images/grdgradient.html) and to @mgrund for adding examples on [masking wet-dry land areas](https://www.pygmt.org/dev/gallery/images/grdlandmask.html), [plotting fancy text symbols](https://www.pygmt.org/v0.5.0/gallery/symbols/text_symbols.html), and [plotting road lines from `geopandas.GeoDataFrame` objects](https://www.pygmt.org/v0.5.0/gallery/lines/roads.html)! All of these colorful examples can be found at the PyGMT gallery (click on the image below).

[![Gallery in PyGMT v0.5.0](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/2/2ec484ded30ac1d411b724259bceb71300c6ace0.png)  
 ](https://www.pygmt.org/v0.5.0/gallery/index.html)

### 🛤 Roadmap to [v0.6.0](https://github.com/GenericMappingTools/pygmt/milestone/9)

For the next minor release, here are some things we have planned. Items marked with an asterisk (\*) are those we need people to help with!

- 🌐 + 🐍 \*Design a [logo for PyGMT!](https://flint.soest.hawaii.edu/t/design-for-pygmt-logo/1346)
- Integration with PyData 🐍 ecosystem:
  - rioxarray - to read RGB GeoTIFF files ([#1555](https://github.com/GenericMappingTools/pygmt/issues/1555))
  - \*ObsPy - to process seismological data ([#967](https://github.com/GenericMappingTools/pygmt/issues/967))

- \*Add a beginner 🔰 friendly PyGMT tutorial that is a good roadmap for new GMT/PyGMT users ([#770](https://github.com/GenericMappingTools/pygmt/issues/770))
- More features/enhancements ✨:
  - Wrap more GMT modules, e.g.,
    - \*movie ([#1347](https://github.com/GenericMappingTools/pygmt/issues/1347))
    - triangulate ([#731](https://github.com/GenericMappingTools/pygmt/pull/731))
    - grdhisteq ([#1433](https://github.com/GenericMappingTools/pygmt/pull/1433))
    - grdmix ([#1437](https://github.com/GenericMappingTools/pygmt/pull/1437))
    - \*(tell us what function you’d like to use!)

  - Add `Figure.hlines()` and `Figure.vlines()` for plotting horizontal and vertical lines ([#670](https://github.com/GenericMappingTools/pygmt/issues/670))
  - \*Support plotting text in paragraph mode ([#1078](https://github.com/GenericMappingTools/pygmt/issues/1078))

### ⚠ Upcoming deprecations

No one likes software that breaks suddenly. To ensure a bug-free product and consistency, these are some of the deprecations coming up for future releases of PyGMT:

- **v0.6.0** (~Dec 2021/Jan 2022 after AGU Fall Meeting)

- **v0.7.0** (~Feb/Mar 2022 before EGU conference)

- **v1.0.0** (?)

The compatibility matrix will be listed on [PyGMT](https://www.pygmt.org/v0.5.0/#compatibility-with-gmt-python-numpy-versions), so make sure you keep things up to date!

### 🗺 Conference presentations/workshops

It’s the season for major scientific conferences in the US and Europe. Be sure to tag us on social media if you have a poster made using #PyGMT, and check out our sessions listed below if you’re keen!

- 🌎 [AGU 2021 session](https://flint.soest.hawaii.edu/t/agu-2021-abstract-s/1803) (18 Dec 2021). A 3 minute e-Lightning talk and virtual poster will be presented, see abstract at [https://agu.confex.com/agu/fm21/meetingapp.cgi/Paper/916483](https://agu.confex.com/agu/fm21/meetingapp.cgi/Paper/916483) for more details.
- 🌍 [EGU 2022 short-course](https://flint.soest.hawaii.edu/t/egu-2022-short-course-proposal/1948) (3-8 Apr 2022). This will likely be a hybrid (online/in-person) 3.5 hour workshop covering the basics of using PyGMT. See abstract at [CO Meeting Organizer EGU22](https://meetingorganizer.copernicus.org/EGU22/session/43186) for more details. Information on how to register for the workshop will be posted next year.
- 🌏 Keen to organize a conference or online workshop in 2022 for your continent? Reach out to the team and we can help to support it!

 ![AGU 2021 PyGMT abstract image](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/0/066544042e040258991386de76ff1af25e54960e.jpeg)

Feel free to reach out to the PyGMT team during those conferences, or anytime in between! We have quarterly PyGMT community meetings (see the last one in [early October 2021](https://flint.soest.hawaii.edu/t/pygmt-community-meeting-wednesday-6-oct-2021-utc-1800/2163), and are active on this [forum](https://flint.soest.hawaii.edu/c/questions/pygmt-q-a) and [GitHub](https://github.com/GenericMappingTools/pygmt).

Onwards 🚀

**P.S.** Share the word on Twitter 🐦, #PyGMT [@gmt\_dev](https://twitter.com/gmt_dev)!
