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! First, the highlights :
- Support non-ASCII characters in
Figure.text
(#2638) and other method arguments (#2584) - Three new tutorials and seven new gallery examples
Read through the changelog for the full list of changes. Installation/upgrade instructions are at Installing β PyGMT! Note that this version is still cross-compatible with GMT 6.3 and 6.4, but requires Python 3.9+ and NumPy 1.22+ following NEP29. Go try it online at try-gmt .
Nice enhancements :
- Figure.grdimage: Allow passing RGB xarray.DataArray images (#2590)
- pygmt.show_versions: Show versions of IPython and rioxarray (#2492)
New aliases :
- Figure.colorbar:
log
(Q
) - Figure.image:
bitcolor
(G
) - Figure.meca:
outline
(L
),nodal
(T
), andlabelbox
(Fr
) - pygmt.grdfill:
no_data
(N
) - pygmt.select:
dist2pt
(C
),polygon
(F
), anddist2line
(L
)
As usual, report any bugs with the issue template on GitHub. Your feedback is what helps us to improve!
New tutorial and gallery examples
- Tutorial to explain naming of PyGMT figure elements by @JingHuiTong
- Tutorial to show interactive data visualization via
panel
by @yvonnefroehlich - Tutorial for cartesian histograms by @yvonnefroehlich
- Highlight country, continent and state polygons by @mgrund
- Tile maps by @mgrund
- Envelope around a curve by @yvonnefroehlich
- Plotting an RGB image from an xarray.DataArray by @weiji14
- Quoted lines by @yvonnefroehlich
- Decorated lines by @yvonnefroehlich
- Cross-section along a transect by @yvonnefroehlich
Roadmap to v0.11.0
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 on GitHub or the list below for things you can help with!
- Features/enhancements
- Wrap fitcircle, clip, earthtide, movie, polar, sac, and coupe
- Add
Figure.hlines
(#923) andFigure.vlines
for plotting horizontal and vertical lines (#670) Figure.shift_origin
: Allow shifting the origin back to the original position after plotting (#2410)- Add
load_*
functions to support more planetary relief datasets (#2431)
- Documentation improvements
We invite you to get involved in these efforts by reaching out on GitHub !
Upcoming deprecations
- v0.12.0
- All plotting methods: Remove aliases
xshift
(X
) andyshift
(Y
) (FutureWarning raised since PyGMT v0.8.0) Figure.plot
,Figure.plot3d
,Figure.rose
,Figure.velo
: Remove parametercolor
, usefill
instead (FutureWarning raised since PyGMT v0.8.0)Figure.velo
: Remove parameteruncertaintycolor
, useuncertaintyfill
instead (FutureWarning raised since PyGMT v0.8.0)Figure.wiggle
: Remove parametercolor
, usefillnegative
orfillpositive
instead (FutureWarning raised since PyGMT v0.8.0)Figure.grdimage
: Remove parameterbit_color
, usebitcolor
instead (Future Warning raised since PyGMT v0.10.0)
- All plotting methods: Remove aliases
- 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)
- Short form aliases (e.g.
The compatibility matrix is listed at PyGMT, 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 AGU Fall Meeting in December 2023! Would you like to lead a PyGMT or GMT workshop at EGU, 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 Workshops β The Generic Mapping Tools!
Onwards
P.S. Share the word on Twitter @gmt_dev , Instagram @genericmappingtools