# PyGMT v0.11.0 released

**URL:** <https://forum.generic-mapping-tools.org/t/pygmt-v0-11-0-released/4667>\
**Category:** Announcements\
**Created:** [February 2, 2024, 11:56am UTC](https://forum.generic-mapping-tools.org/t/pygmt-v0-11-0-released/4667 "2024-02-02T11:56:52Z")\
**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:** [February 2, 2024, 11:56am UTC](https://forum.generic-mapping-tools.org/t/pygmt-v0-11-0-released/4667/1 "2024-02-02T11:56:53Z")

</div>

# PyGMT v0.11.0 released

**Announcing PyGMT v0.11.0 with 1 new tutorial, 4 new gallery examples, support of GMT 6.5, and access to 5 planetary reliefs!**

The PyGMT team is kicking off 2024 with version [v0.11.0](https://www.pygmt.org/v0.11.0), which is inline with the release of [GMT 6.5](https://docs.generic-mapping-tools.org/6.5/changes.html) just three weeks ago! First, the highlights 🎉:

- Tutorial for table inputs ([#2722](https://github.com/GenericMappingTools/pygmt/pull/2722)) and gallery example for a choropleth map ([#2796](https://github.com/GenericMappingTools/pygmt/pull/2796))
- Easy access to planetary relief datasets (Mercury, Venus, Moon, Mars, Pluto) ([#3028](https://github.com/GenericMappingTools/pygmt/pull/3028), [#2906](https://github.com/GenericMappingTools/pygmt/pull/2906), [#2674](https://github.com/GenericMappingTools/pygmt/pull/2674), [#2847](https://github.com/GenericMappingTools/pygmt/pull/2847), [#3027](https://github.com/GenericMappingTools/pygmt/pull/3027))
- 🚀 Faster PyGMT by ~0.1 seconds for each module call ([#2930](https://github.com/GenericMappingTools/pygmt/pull/2930))

| Mercury | Venus | Moon | Mars | Pluto |
| --- | --- | --- | --- | --- |
| [![Pluto](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/1/125407e9d07753f5cee1d2a19b9222d4e63c85d6.jpeg)](https://www.pygmt.org/v/api/generated/pygmt.datasets.load_mercury_relief.html) | [![Venus](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/a/a2238a914c79db338d089fb7309edadd4ae5195c.jpeg)](https://www.pygmt.org/v0.11.0/api/generated/pygmt.datasets.load_venus_relief.html) | [![Moon](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/3/3a4a9407974683f0f21452d024586c2ed110afb6.jpeg)](https://www.pygmt.org/v0.11.0/api/generated/pygmt.datasets.load_moon_relief.html) | [![Mars](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/4/48a4d7d05536c7ab0f924dcd1d66bb3874eb246e.jpeg)](https://www.pygmt.org/v0.11.0/api/generated/pygmt.datasets.load_mars_relief.html) | [![Pluto](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/c/cc497300736364008f047a91506deaf719626eba.jpeg)](https://www.pygmt.org/v0.11.0/api/generated/pygmt.datasets.load_pluto_relief.html) |

Read through the [changelog](https://www.pygmt.org/v0.11.0/changes.html) for the full list of changes. Installation/upgrade ⬆ instructions are at [Installing — PyGMT](https://www.pygmt.org/v0.11.0/install.html)! Note that this version is cross-compatible with GMT 6.3 - 6.5, but it requires 🐍 Python 3.9+ and NumPy 1.23+ following [NEP29](https://numpy.org/neps/nep-0029-deprecation_policy.html). Go try it online at [try-gmt](https://github.com/GenericMappingTools/try-gmt) 🚀.

Nice enhancements ✨:

- `Figure.savefig`: Support generating GeoTIFF file ([#2698](https://github.com/GenericMappingTools/pygmt/pull/2698))
- `Figure.text`: Allow lists as input type for the `angle`, `font`, and `justify` parameters ([#2720](https://github.com/GenericMappingTools/pygmt/pull/2720))
- `datasets.load_tile_map` and `Figure.tilemap`: Add `zoom_adjust` parameter ([#2934](https://github.com/GenericMappingTools/pygmt/pull/2934))

New aliases 📝:

- [Figure.coast](https://www.pygmt.org/v0.11.0/api/generated/pygmt.Figure.coast.html): `box` (`F`)
- [grdlandmask](https://www.pygmt.org/v0.11.0/api/generated/pygmt.grdlandmask.html): `cores` (`x`)

As usual, 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!

### 💡 New tutorial and gallery examples

- Add tutorial for working with **table inputs** in PyGMT ([#2722](https://github.com/GenericMappingTools/pygmt/pull/2722)) by @seisman
- Add gallery example showing how to create a **choropleth map** ([#2796](https://github.com/GenericMappingTools/pygmt/pull/2796)) by @mgrund
- Add gallery example showing how to add a **scale bar** ([#2822](https://github.com/GenericMappingTools/pygmt/pull/2822)) by @yvonnefroehlich
- Add gallery example showing how to plotting **connection lines** ([#2999](https://github.com/GenericMappingTools/pygmt/pull/2999)) by @yvonnefroehlich
- Add gallery example showing how to adjust **line segment ends** ([#3015](https://github.com/GenericMappingTools/pygmt/pull/3015)) by @yvonnefroehlich
- Update gallery example for **legend** regarding **multi-columns** ([#2762](https://github.com/GenericMappingTools/pygmt/pull/2762)) by @yvonnefroehlich

| Tabel inputs | Choropleth map | Scale bar |
| --- | --- | --- |
| [![Tabel inputs](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/d/d4acfd3ffded2aca9113fc44733a9ec02ce69aff.png)](https://www.pygmt.org/v0.11.0/get_started/04_table_inputs.html) | [![Choropleth map](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/a/a1c63e00a5106c35bc345dbb5ee3b1516879d822.png)](https://www.pygmt.org/v0.11.0/gallery/maps/choropleth_map.html) | [![Scale bar](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/3/3061a6cf91b8903ccc6a595caad1607e67c9bcc4.png)](https://www.pygmt.org/v0.11.0/gallery/embellishments/scalebar.html) |

| Connection lines | Line segment ends | Multi-column legend |
| --- | --- | --- |
| [![Connection lines](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/3/3566af9375fc7643887ae70668128854350a0798.png)](https://www.pygmt.org/v0.11.0/gallery/lines/connection_lines.html) | [![Line segment ends](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/0/069ee9278ca816a59ef98266513c122a0b999fee.png)](https://www.pygmt.org/v0.11.0/gallery/lines/line_segment_ends.html) | [![Multi-column legend](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/0/0e51cbadf33420ed8d7235ef1c27995383dece24.png)](https://www.pygmt.org/v0.11.0/gallery/embellishments/legend.html) |

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

The team has been focusing a lot more on the documentation and refactoring the internals of PyGMT in recent releases, but we do have plenty of features 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!

- Features/enhancements ✨
  - Wrap [clip](https://github.com/GenericMappingTools/pygmt/pull/1779), [coupe](https://github.com/GenericMappingTools/pygmt/issues/2019), [earthtide](https://github.com/GenericMappingTools/pygmt/pull/1824), [fitcircle](https://github.com/GenericMappingTools/pygmt/pull/1550), [movie](https://github.com/GenericMappingTools/pygmt/issues/1347), [polar](https://github.com/GenericMappingTools/pygmt/issues/2358), and [sac](https://github.com/GenericMappingTools/pygmt/issues/2358)
  - Add `Figure.hlines` ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) and `Figure.vlines` for plotting horizontal and vertical lines ([#670](https://github.com/GenericMappingTools/pygmt/issues/670))

- Documentation improvements 📖
  - Add a beginner 🔰 friendly PyGMT tutorial that is a good roadmap for new GMT/PyGMT users ([#770](https://github.com/GenericMappingTools/pygmt/issues/770))
  - Add a tutorial explaining the generally accepted input types ([#1268](https://github.com/GenericMappingTools/pygmt/issues/1268))

We invite you to get involved in these efforts by [reaching out on GitHub](https://github.com/GenericMappingTools/pygmt) 🚀!

### ⚠ Upcoming deprecations

- **v0.12.0**
  - All plotting methods: Remove aliases `xshift` (`X`) and `yshift` (`Y`) (FutureWarning raised since PyGMT v0.8.0)
  - All plotting methods: Remove alias `timestamp` (`U`) (FutureWarning raised since PyGMT v0.9.0)
  - `Figure.plot`, `Figure.plot3d`, `Figure.rose`, `Figure.velo`: Remove parameter `color`, use `fill` instead (FutureWarning raised since PyGMT v0.8.0)
  - `Figure.velo`: Remove parameter `uncertaintycolor`, use `uncertaintyfill` instead (FutureWarning raised since PyGMT v0.8.0)
  - `Figure.wiggle`: Remove parameter `color`, use `fillnegative` or `fillpositive` instead (FutureWarning raised since PyGMT v0.8.0)
  - `Figure.grdimage`: Remove parameter `bit_color`, use `bitcolor` instead (Future Warning raised since PyGMT v0.10.0)

- **v0.13.0**
  - `Figure.timestamp`: Remove parameter `justification`, use `justify` instead (FutureWarning raised since PyGMT v0.11.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 is listed at [Minimum Supported GMT/Python/NumPy Versions — PyGMT](https://www.pygmt.org/v0.11.0/minversions.html), so make sure you keep things up to date!

### 🗺 Conference presentations/workshops/sprints

We hope that this new PyGMT release will be useful for those of you making posters for the upcoming EGU Meeting in April 2024! Would you like to lead a PyGMT or GMT workshop at AGU, FOSS4G, or some other regional conferences this year? Let us know on the forum and we can help to organize and add it to [Workshops — The Generic Mapping Tools](https://www.generic-mapping-tools.org/workshops)!

Onwards 🚀

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