---
# System prepended metadata

title: '[PyGMT v0.5.0 released](https://forum.generic-mapping-tools.org/t/pygmt-v0-5-0-released)'
tags: [release-announcement]

---

# [PyGMT v0.5.0 released](https://forum.generic-mapping-tools.org/t/pygmt-v0-5-0-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 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 :memo: 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 https://github.com/GenericMappingTools/pygmt#citing-pygmt.

![image](https://user-images.githubusercontent.com/23487320/139506506-6e6a055c-baf2-4dfc-a5d0-019c1b80b0ad.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 https://github.com/GenericMappingTools/pygmt and say hi!


### :bulb: 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://user-images.githubusercontent.com/23487320/139422901-092691f4-d775-426d-acdd-7100c81e7b96.png)
](https://www.pygmt.org/v0.5.0/gallery/index.html)

### :railway_track: 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!

- :globe_with_meridians: + :snake: *Design a [logo for PyGMT!](https://forum.generic-mapping-tools.org/t/design-for-pygmt-logo/1346)
- Integration with PyData :snake: 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 :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 :sparkles::
  - 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))


### :warning: 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)
  - Require GMT>=6.3.0, i.e. drop GMT<=6.2.0. For the brave folks, feel free to test using `conda install -c conda-forge/label/dev gmt`.
  - [NEP29](https://numpy.org/neps/nep-0029-deprecation_policy.html#support-table): drop support for NumPy 1.18 so that NumPy 1.19 or above is required
  - Aliases "columns" and "sizes" are replaced by "incols" and "size" respectively (FutureWarning raised since PyGMT v0.4.0)
- **v0.7.0** (~Feb/Mar 2022 before EGU conference)
  - `pygmt.info` and `Figure.histogram` Deprecate parameter “table” to “data” (FutureWarning raised since PyGMT v0.5.0)
  - In 9 modules: Reorder input parameters to ‘data, x, y, z’ (FutureWarning raised since PyGMT v0.5.0)
  - `Figure.wiggle`: Deprecate parameter “columns” to “incols” (FutureWarning raised since PyGMT v0.5.0)
  - `pygmt.surface`: Deprecate parameter “outfile” to “outgrid” (FutureWarning raised since PyGMT v0.5.0)

- **v1.0.0** (?)
  - Short form aliases (e.g. 'R') will not work if long form aliases (e.g. 'region') are available (SyntaxWarning raised since PyGMT v0.4.0, see [#1316](https://github.com/GenericMappingTools/pygmt/pull/1316))

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

### :world_map: 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!

- :earth_americas: [AGU 2021 session](https://forum.generic-mapping-tools.org/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 for more details.
- :earth_africa: [EGU 2022 short-course](https://forum.generic-mapping-tools.org/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 https://meetingorganizer.copernicus.org/EGU22/session/43186 for more details. Information on how to register for the workshop will be posted next year.
- :earth_asia: 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://user-images.githubusercontent.com/14077947/128094898-8c14fbbe-504e-4bca-9e73-0fefd871d4e8.png)](https://github.com/GenericMappingTools/pygmt/issues/1395)

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://forum.generic-mapping-tools.org/t/pygmt-community-meeting-wednesday-6-oct-2021-utc-1800/2163), and are active on this [forum](https://forum.generic-mapping-tools.org/c/questions/pygmt-q-a) and [GitHub](https://github.com/GenericMappingTools/pygmt). 

Onwards :rocket:

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