# PyGMT v0.10.0 released

**Announcing PyGMT v0.10.0, write non-ASCII characters and plot xarray.DataArray RGB images!**

The PyGMT team is kicking off September with version [v0.10.0](https://www.pygmt.org/v0.10.0)! First, the highlights :tada::

* Support non-ASCII characters in `Figure.text` ([#2638](https://github.com/GenericMappingTools/pygmt/pull/2638)) and other method arguments ([#2584](https://github.com/GenericMappingTools/pygmt/pull/2584))
* Three new tutorials and seven new gallery examples

Read through the [changelog](https://www.pygmt.org/v0.10.0/changes.html) for the full list of changes. Installation/upgrade :arrow_up: instructions are at https://www.pygmt.org/v0.10.0/install.html! Note that this version is still cross-compatible with GMT 6.3 and 6.4, but requires :snake: Python 3.9+ and NumPy 1.22+ following [NEP29](https://numpy.org/neps/nep-0029-deprecation_policy.html). Go try it online at [try-gmt](https://github.com/GenericMappingTools/try-gmt) :rocket:.

Nice enhancements :sparkles::
* [Figure.grdimage](https://www.pygmt.org/v0.10.0/api/generated/pygmt.Figure.grdimage.html): Allow passing RGB xarray.DataArray images ([#2590](https://github.com/GenericMappingTools/pygmt/pull/2590))
* [pygmt.show_versions](https://www.pygmt.org/v0.10.0/api/generated/pygmt.show_versions.html): Show versions of IPython and rioxarray ([#2492](https://github.com/GenericMappingTools/pygmt/pull/2492))

New aliases :memo::
* [Figure.colorbar](https://www.pygmt.org/v0.10.0/api/generated/pygmt.Figure.colorbar.html): `log` (`Q`)
* [Figure.image](https://www.pygmt.org/v0.10.0/api/generated/pygmt.Figure.image.html): `bitcolor` (`G`)
* [Figure.meca](https://www.pygmt.org/v0.10.0/api/generated/pygmt.Figure.meca.html): `outline`(`L`), `nodal` (`T`), and `labelbox` (`Fr`)
* [pygmt.grdfill](https://www.pygmt.org/v0.10.0/api/generated/pygmt.grdfill.html): `no_data` (`N`)
* [pygmt.select](https://www.pygmt.org/v0.10.0/api/generated/pygmt.select.html): `dist2pt` (`C`), `polygon` (`F`), and `dist2line` (`L`)

As usual, report any bugs :beetle: 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!

### :bulb: New tutorial and gallery examples

- Tutorial to [explain naming of PyGMT figure elements](https://www.pygmt.org/v0.10.0/get_started/03_figure_element.html) by @JingHuiTong
- Tutorial to show [interactive data visualization via `panel`](https://www.pygmt.org/v0.10.0/tutorials/advanced/working_with_panel.html) by @yvonnefroehlich
- Tutorial for [cartesian histograms](https://www.pygmt.org/v0.10.0/tutorials/advanced/cartesian_histograms.html) by @yvonnefroehlich
- [Highlight country, continent and state polygons](https://www.pygmt.org/v0.10.0/gallery/maps/country_polygons.html) by @mgrund
- [Tile maps](https://www.pygmt.org/v0.10.0/gallery/maps/tilemaps.html) by @mgrund
- [Envelope](https://www.pygmt.org/v0.10.0/gallery/lines/envelope.html) around a curve by @yvonnefroehlich
- [Plotting an RGB image from an xarray.DataArray](https://www.pygmt.org/v0.10.0/gallery/images/rgb_image.html) by @weiji14
- [Quoted lines](https://www.pygmt.org/v0.10.0/gallery/lines/quoted_lines.html) by @yvonnefroehlich
- [Decorated lines](https://www.pygmt.org/v0.10.0/gallery/lines/decorated_lines.html) by @yvonnefroehlich
- [Cross-section along a transect](https://www.pygmt.org/v0.10.0/gallery/images/cross_section.html) by @yvonnefroehlich

| Figure elements | Interactive data visualization via `panel` | Cartesian histograms |
|--|--|--|
| [](https://www.pygmt.org/v0.10.0/get_started/03_figure_element.html)| [](https://www.pygmt.org/v0.10.0/tutorials/advanced/working_with_panel.html) | [](https://www.pygmt.org/v0.10.0/tutorials/advanced/cartesian_histograms.html)

| Highlight country, continent and state polygons | Tile maps | Envelope | RGB image |
|--|--|--|--|
| [](https://www.pygmt.org/v0.10.0/gallery/maps/country_polygons.html) | [](https://www.pygmt.org/v0.10.0/gallery/maps/tilemaps.html) | [](https://www.pygmt.org/v0.10.0/gallery/lines/envelope.html) | [](https://www.pygmt.org/v0.10.0/gallery/images/rgb_image.html)

| Quoted lines | Decorated lines | Cross-section along a transect |
|--|--|--|
| [](https://www.pygmt.org/v0.10.0/gallery/lines/quoted_lines.html) | [](https://www.pygmt.org/v0.10.0/gallery/lines/decorated_lines.html) | [](https://www.pygmt.org/v0.10.0/gallery/images/cross_section.html) |

### :railway_track: Roadmap to [v0.11.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 :sparkles:
- Wrap [fitcircle](https://github.com/GenericMappingTools/pygmt/pull/1550), [clip](https://github.com/GenericMappingTools/pygmt/pull/1779), [earthtide](https://github.com/GenericMappingTools/pygmt/pull/1824), [movie](https://github.com/GenericMappingTools/pygmt/issues/1347), [polar](https://github.com/GenericMappingTools/pygmt/issues/2358), [sac](https://github.com/GenericMappingTools/pygmt/issues/2358), and [coupe](https://github.com/GenericMappingTools/pygmt/issues/2019)
- 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))
- `Figure.shift_origin`: Allow shifting the origin back to the original position after plotting ([#2410](https://github.com/GenericMappingTools/pygmt/issues/2401))
- Add `load_*` functions to support more planetary relief datasets ([#2431](https://github.com/GenericMappingTools/pygmt/issues/2431))
- Documentation improvements :book:
- 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))
- Add a tutorial explaining the generally accepted input types ([#1268](https://github.com/GenericMappingTools/pygmt/issues/1268))
- Add a gallery example showing the configuration of a scale bar ([#2627](https://github.com/GenericMappingTools/pygmt/issues/2627))

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

### :warning: Upcoming deprecations

- **v0.12.0**
- All plotting methods: Remove aliases `xshift` (`X`) and `yshift` (`Y`) (FutureWarning raised since PyGMT v0.8.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)
- **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 https://www.pygmt.org/v0.10.0/#compatibility-with-gmt-python-numpy-versions, so make sure you keep things up to date!

### :world_map: Conference presentations/workshops/sprints

We hope that this new PyGMT release will be useful for those of you making posters for the upcoming [AGU Fall Meeting](https://www.agu.org/fall-meeting) in December 2023! Would you like to lead a PyGMT or GMT workshop at [EGU](https://meetingorganizer.copernicus.org/EGU24/provisionalprogramme), AGU, FOSS4G, or some other regional conferences next year in 2024? Let us know on the forum and we can help to organize and add it to https://www.generic-mapping-tools.org/workshops!

Onwards :rocket:

**P.S.** Share the word on Twitter [@gmt_dev](https://twitter.com/gmt_dev) :bird:, Instagram [@genericmappingtools](https://www.instagram.com/genericmappingtools/) :camera_with_flash: and ResearchGate (TODO?)