Pygmt

[](https://doi.org/10.5281/zenodo.4253459)

Highlights

* 🎉 **Patch release with more tutorials and gallery examples!** 🎉
* 🐍 Support Python 3.9 ([689](https://github.com/GenericMappingTools/pygmt/pull/689))
* 📹 Add [Liam](https://github.com/liamtoney)'s [ROSES 2020 PyGMT talk](https://www.youtube.com/watch?v=SSIGJEe0BIk) ([#643](https://github.com/GenericMappingTools/pygmt/pull/643))

New Features

* Wrap plot3d ([471](https://github.com/GenericMappingTools/pygmt/pull/471))
* Wrap grdfilter ([616](https://github.com/GenericMappingTools/pygmt/pull/616))

Enhancements

* Allow np.object dtypes into virtualfile_from_vectors ([684](https://github.com/GenericMappingTools/pygmt/pull/684))
* Let plot() accept record-by-record transparency ([626](https://github.com/GenericMappingTools/pygmt/pull/626))
* Refactor info to allow datetime inputs from xarray.Dataset and pandas.DataFrame tables ([619](https://github.com/GenericMappingTools/pygmt/pull/619))

Tutorials & Gallery

* Add tutorial for pygmt.config ([482](https://github.com/GenericMappingTools/pygmt/pull/482))
* Add an example for different line styles ([604](https://github.com/GenericMappingTools/pygmt/pull/604), [#664](https://github.com/GenericMappingTools/pygmt/pull/664))
* Add a gallery example for varying transparent points ([654](https://github.com/GenericMappingTools/pygmt/pull/654))
* Add tutorial for pygmt.Figure.text ([480](https://github.com/GenericMappingTools/pygmt/pull/480))
* Add an example for scatter plots with auto legends ([607](https://github.com/GenericMappingTools/pygmt/pull/607))
* Improve colorbar gallery example ([596](https://github.com/GenericMappingTools/pygmt/pull/596))

Documentation Improvements

* doc: Fix the description of grdcontour -G option ([681](https://github.com/GenericMappingTools/pygmt/pull/681))
* Refresh Code of Conduct from v1.4 to v2.0 ([673](https://github.com/GenericMappingTools/pygmt/pull/673))
* Add PyGMT Zenodo BibTeX entry to main README ([678](https://github.com/GenericMappingTools/pygmt/pull/678))
* Complete most of documentation for makecpt ([676](https://github.com/GenericMappingTools/pygmt/pull/676))
* Complete documentation for plot ([666](https://github.com/GenericMappingTools/pygmt/pull/666))
* Add "no_clip" to plot, text, contour and meca ([661](https://github.com/GenericMappingTools/pygmt/pull/661))
* Add common alias "verbose" (V) to all functions ([662](https://github.com/GenericMappingTools/pygmt/pull/662))
* Improve documentation of Figure.logo() ([651](https://github.com/GenericMappingTools/pygmt/pull/651))
* Add mini-galleries for methods and functions ([648](https://github.com/GenericMappingTools/pygmt/pull/648))
* Complete documentation of grdimage ([620](https://github.com/GenericMappingTools/pygmt/pull/620))
* Add common alias perspective (p) for plotting 3D illustrations ([627](https://github.com/GenericMappingTools/pygmt/pull/627))
* Add common aliases xshift (X) and yshift (Y) ([624](https://github.com/GenericMappingTools/pygmt/pull/624))
* Add common alias cores (x) for grdimage and other multi-threaded modules ([625](https://github.com/GenericMappingTools/pygmt/pull/625))
* Enable switching different versions of documentation ([621](https://github.com/GenericMappingTools/pygmt/pull/621))
* Add common alias transparency (-t) to all plotting functions ([614](https://github.com/GenericMappingTools/pygmt/pull/614))

Bug Fixes

* Disallow passing arguments like -XNone to GMT ([639](https://github.com/GenericMappingTools/pygmt/pull/639))

Maintenance

* Migrate PyPI release to GitHub Actions ([679](https://github.com/GenericMappingTools/pygmt/pull/679))
* Upload artifacts showing diff images on test failure ([675](https://github.com/GenericMappingTools/pygmt/pull/675))
* Add slash command "/format" to automatically format PRs ([646](https://github.com/GenericMappingTools/pygmt/pull/646))
* Add instructions to run specific tests ([660](https://github.com/GenericMappingTools/pygmt/pull/660))
* Add more tests for xarray grid shading ([650](https://github.com/GenericMappingTools/pygmt/pull/650))
* Refactor xfail tests to avoid storing baseline images ([603](https://github.com/GenericMappingTools/pygmt/pull/603))
* Add blackdoc to format Python codes in docstrings ([641](https://github.com/GenericMappingTools/pygmt/pull/641))
* Check and lint sphinx configuration file doc/conf.py ([630](https://github.com/GenericMappingTools/pygmt/pull/630))
* Improve Makefile to clean ``__pycache__`` directory recursively ([611](https://github.com/GenericMappingTools/pygmt/pull/611))
* Update release process and checklist template ([602](https://github.com/GenericMappingTools/pygmt/pull/602))

Contributors

* [Dongdong Tian](https://github.com/seisman)
* [Wei Ji Leong](https://github.com/weiji14)
* [Conor Bacon](https://github.com/hemmelig)
* [carocamargo](https://github.com/carocamargo)

----

[](https://doi.org/10.5281/zenodo.4025418)

Highlights

* 🎉 **Second minor release of PyGMT** 🎉
* Minimum required GMT version is now 6.1.1 or newer ([577](https://github.com/GenericMappingTools/pygmt/pull/577))
* Plotting xarray grids using grdimage and grdview should not crash anymore and works for most cases ([560](https://github.com/GenericMappingTools/pygmt/pull/560))
* Easier time-series plots with support for datetime-like inputs to plot ([464](https://github.com/GenericMappingTools/pygmt/pull/464)) and the region argument ([#562](https://github.com/GenericMappingTools/pygmt/pull/562))

New Features

* Wrap GMT_Put_Strings to pass str columns into GMT C API directly ([520](https://github.com/GenericMappingTools/pygmt/pull/520))
* Wrap meca ([516](https://github.com/GenericMappingTools/pygmt/pull/516))
* Wrap x2sys_init and x2sys_cross ([546](https://github.com/GenericMappingTools/pygmt/pull/546))
* Let grdcut() accept xarray.DataArray as input ([541](https://github.com/GenericMappingTools/pygmt/pull/541))
* Initialize a GMTDataArrayAccessor ([500](https://github.com/GenericMappingTools/pygmt/pull/500))

Enhancements

* Allow passing in pandas dataframes to x2sys_cross ([591](https://github.com/GenericMappingTools/pygmt/pull/591))
* Sensible array outputs for pygmt info ([575](https://github.com/GenericMappingTools/pygmt/pull/575))
* Allow pandas.DataFrame table and 1D/2D numpy array inputs into pygmt.info ([574](https://github.com/GenericMappingTools/pygmt/pull/574))
* Add auto-legend feature to grdcontour and contour ([568](https://github.com/GenericMappingTools/pygmt/pull/568))
* Add common alias verbose (V) ([550](https://github.com/GenericMappingTools/pygmt/pull/550))
* Let load_earth_relief() support all resolutions and optional subregion ([542](https://github.com/GenericMappingTools/pygmt/pull/542))
* Allow load_earth_relief() to load pixel or gridline registered data ([509](https://github.com/GenericMappingTools/pygmt/pull/509))

Documentation

* Link to try-gmt binder repository ([598](https://github.com/GenericMappingTools/pygmt/pull/598))
* Improve docstring of data_kind() to include xarray grid ([588](https://github.com/GenericMappingTools/pygmt/pull/588))
* Improve the documentation of Figure.shift_origin() ([536](https://github.com/GenericMappingTools/pygmt/pull/536))
* Add shading to grdview gallery example ([506](https://github.com/GenericMappingTools/pygmt/pull/506))

Bug Fixes

* Ensure surface and grdcut loads GMTDataArray accessor info into xarray ([539](https://github.com/GenericMappingTools/pygmt/pull/539))
* Raise an error if short- and long-form arguments coexist ([537](https://github.com/GenericMappingTools/pygmt/pull/537))
* Fix the grdtrack example to avoid crashes on macOS ([531](https://github.com/GenericMappingTools/pygmt/pull/531))
* Properly allow for either pixel or gridline registered grids ([476](https://github.com/GenericMappingTools/pygmt/pull/476))

Maintenance

* Add a test for xarray shading ([581](https://github.com/GenericMappingTools/pygmt/pull/581))
* Remove expected failures on grdview tests ([589](https://github.com/GenericMappingTools/pygmt/pull/589))
* Redesign check_figures_equal testing function to be more explicit ([590](https://github.com/GenericMappingTools/pygmt/pull/590))
* Cut Windows CI build time in half to 15 min ([586](https://github.com/GenericMappingTools/pygmt/pull/586))
* Add a test for Session.write_data() writing netCDF grids ([583](https://github.com/GenericMappingTools/pygmt/pull/583))
* Add a test to make sure shift_origin does not crash ([580](https://github.com/GenericMappingTools/pygmt/pull/580))
* Add testing.check_figures_equal to avoid storing baseline images ([555](https://github.com/GenericMappingTools/pygmt/pull/555))
* Eliminate unnecessary jobs from Travis CI ([567](https://github.com/GenericMappingTools/pygmt/pull/567)) and Azure Pipelines ([#513](https://github.com/GenericMappingTools/pygmt/pull/513))
* Improve the workflow to test both GMT master ([485](https://github.com/GenericMappingTools/pygmt/pull/485)) and 6.1 branches ([#554](https://github.com/GenericMappingTools/pygmt/pull/554))
* Automatically cancel in-progress CI runs of old commits ([544](https://github.com/GenericMappingTools/pygmt/pull/544))
* Remove the Stickler CI configuration file ([538](https://github.com/GenericMappingTools/pygmt/pull/538)), run style checks using GitHub Actions ([#519](https://github.com/GenericMappingTools/pygmt/pull/519))
* Cache GMT remote data as artifacts on GitHub ([530](https://github.com/GenericMappingTools/pygmt/pull/530))
* Let pytest generate both HTML and XML coverage reports ([512](https://github.com/GenericMappingTools/pygmt/pull/512))
* Run Continuous Integration tests on GitHub Actions ([475](https://github.com/GenericMappingTools/pygmt/pull/475))

Contributors

* [Dongdong Tian](https://github.com/seisman)
* [Wei Ji Leong](https://github.com/weiji14)
* [Tyler Newton](https://github.com/tjnewton)
* [Liam Toney](https://github.com/liamtoney)

----

[](https://doi.org/10.5281/zenodo.3930577)

Highlights

* Patch release in preparation for the SciPy 2020 sprint session
* Last version to support GMT 6.0, future PyGMT versions will require GMT 6.1 or newer

New Features

* Wrap grdcut ([492](https://github.com/GenericMappingTools/pygmt/pull/492))
* Add show_versions() function for printing debugging information used in issue reports ([466](https://github.com/GenericMappingTools/pygmt/pull/466))

Enhancements

* Change load_earth_relief()'s default resolution to 01d ([488](https://github.com/GenericMappingTools/pygmt/pull/488))
* Enhance text with extra functionality and aliases ([481](https://github.com/GenericMappingTools/pygmt/pull/481))

Documentation

* Add gallery example for grdview ([502](https://github.com/GenericMappingTools/pygmt/pull/502))
* Turn all short aliases into long form ([474](https://github.com/GenericMappingTools/pygmt/pull/474))
* Update the plotting example using the colormap generated by pygmt.makecpt ([472](https://github.com/GenericMappingTools/pygmt/pull/472))
* Add instructions to view the test coverage reports locally ([468](https://github.com/GenericMappingTools/pygmt/pull/468))
* Update the instructions for testing pygmt install ([459](https://github.com/GenericMappingTools/pygmt/pull/459))

Bug Fixes

* Fix a bug when passing data to GMT in Session.open_virtual_file() ([490](https://github.com/GenericMappingTools/pygmt/pull/490))

Maintenance

* Temporarily expect failures for some grdcontour and grdview tests ([503](https://github.com/GenericMappingTools/pygmt/pull/503))
* Fix several failures due to updates of earth relief data ([498](https://github.com/GenericMappingTools/pygmt/pull/498))
* Unpin pylint version and fix some lint warnings ([484](https://github.com/GenericMappingTools/pygmt/pull/484))
* Separate tests of gmtinfo and grdinfo ([461](https://github.com/GenericMappingTools/pygmt/pull/461))
* Fix the test for GMT_COMPATIBILITY=6 ([454](https://github.com/GenericMappingTools/pygmt/pull/454))
* Update baseline images for updates of earth relief data ([452](https://github.com/GenericMappingTools/pygmt/pull/452))
* Simplify PyGMT Release process ([446](https://github.com/GenericMappingTools/pygmt/pull/446))

Contributors

* [Dongdong Tian](https://github.com/seisman)
* [Wei Ji Leong](https://github.com/weiji14)
* [Liam Toney](https://github.com/liamtoney)

----

[](https://doi.org/10.5281/zenodo.3837197)

Highlights

* 🏁Windows users rejoice, this bugfix release is for you!🏁
* Let PyGMT work with the conda GMT package on Windows ([434](https://github.com/GenericMappingTools/pygmt/pull/434))

Enhancements

* Handle setting special parameters without default settings for config ([411](https://github.com/GenericMappingTools/pygmt/pull/411))

Documentation

* Update install instructions ([430](https://github.com/GenericMappingTools/pygmt/pull/430))
* Add PyGMT AGU 2019 poster to website ([425](https://github.com/GenericMappingTools/pygmt/pull/425))
* Redirect www.pygmt.org to latest, instead of dev ([423](https://github.com/GenericMappingTools/pygmt/pull/423))

Bug Fixes

* Set GMT_COMPATIBILITY to 6 when pygmt session starts ([432](https://github.com/GenericMappingTools/pygmt/pull/432))
* Improve how PyGMT finds the GMT library ([440](https://github.com/GenericMappingTools/pygmt/pull/440))

Maintenance

* Finalize fixes on Windows test suite for v0.1.1 ([441](https://github.com/GenericMappingTools/pygmt/pull/441))
* Cache test data on Azure Pipelines ([438](https://github.com/GenericMappingTools/pygmt/pull/438))

Contributors

* [Dongdong Tian](https://github.com/seisman)
* [Wei Ji Leong](https://github.com/weiji14)
* [Jason K. Moore](https://github.com/moorepants)

----

[](https://doi.org/10.5281/zenodo.3782862)

Highlights

* 🎉 **First official release of PyGMT** 🎉
* Python 3.8 is now supported ([398](https://github.com/GenericMappingTools/pygmt/pull/398))
* PyGMT now uses the stable version of GMT 6.0.0 by default ([363](https://github.com/GenericMappingTools/pygmt/pull/363))
* Use sphinx-gallery to manage examples and tutorials ([268](https://github.com/GenericMappingTools/pygmt/pull/268))

New Features

* Wrap blockmedian ([349](https://github.com/GenericMappingTools/pygmt/pull/349))
* Add pygmt.config() to change gmt defaults locally and globally ([293](https://github.com/GenericMappingTools/pygmt/pull/293))
* Wrap grdview ([330](https://github.com/GenericMappingTools/pygmt/pull/330))
* Wrap grdtrack ([308](https://github.com/GenericMappingTools/pygmt/pull/308))
* Wrap colorbar ([332](https://github.com/GenericMappingTools/pygmt/pull/332))
* Wrap text ([321](https://github.com/GenericMappingTools/pygmt/pull/321))
* Wrap legend ([333](https://github.com/GenericMappingTools/pygmt/pull/333))
* Wrap makecpt ([329](https://github.com/GenericMappingTools/pygmt/pull/329))
* Add a new method to shift plot origins ([289](https://github.com/GenericMappingTools/pygmt/pull/289))

Enhancements

* Allow text accepting "frame" as an argument ([385](https://github.com/GenericMappingTools/pygmt/pull/385))
* Allow for grids with negative lat/lon increments ([369](https://github.com/GenericMappingTools/pygmt/pull/369))
* Allow passing in list to 'region' argument in surface ([378](https://github.com/GenericMappingTools/pygmt/pull/378))
* Allow passing in scalar number to x and y in plot ([376](https://github.com/GenericMappingTools/pygmt/pull/376))
* Implement default position/box for legend ([359](https://github.com/GenericMappingTools/pygmt/pull/359))
* Add sequence_space converter in kwargs_to_string ([325](https://github.com/GenericMappingTools/pygmt/pull/325))

Documentation

* Update PyPI install instructions and API disclaimer message ([421](https://github.com/GenericMappingTools/pygmt/pull/421))
* Fix the link to GMT documentation ([419](https://github.com/GenericMappingTools/pygmt/pull/419))
* Use napoleon instead of numpydoc with sphinx ([383](https://github.com/GenericMappingTools/pygmt/pull/383))
* Document using a list for repeated arguments ([361](https://github.com/GenericMappingTools/pygmt/pull/361))
* Add legend gallery entry ([358](https://github.com/GenericMappingTools/pygmt/pull/358))
* Update instructions to set GMT_LIBRARY_PATH ([324](https://github.com/GenericMappingTools/pygmt/pull/324))
* Fix the link to the GMT homepage ([331](https://github.com/GenericMappingTools/pygmt/pull/331))
* Split projections gallery by projection types ([318](https://github.com/GenericMappingTools/pygmt/pull/318))
* Fix the link to GMT/Matlab API in the README ([297](https://github.com/GenericMappingTools/pygmt/pull/297))
* Use shinx extlinks for linking GMT docs ([294](https://github.com/GenericMappingTools/pygmt/pull/294))
* Comment about country code in projection examples ([290](https://github.com/GenericMappingTools/pygmt/pull/290))
* Add an overview page listing presentations ([286](https://github.com/GenericMappingTools/pygmt/pull/286))

Bug Fixes

* Let surface return xr.DataArray instead of xr.Dataset ([408](https://github.com/GenericMappingTools/pygmt/pull/408))
* Update GMT constant GMT_STR16 to GMT_VF_LEN for GMT API change in 6.1.0 ([397](https://github.com/GenericMappingTools/pygmt/pull/397))
* Properly trigger pytest matplotlib image comparison ([352](https://github.com/GenericMappingTools/pygmt/pull/352))
* Use uuid.uuid4 to generate unique names ([274](https://github.com/GenericMappingTools/pygmt/pull/274))

Maintenance

* Quickfix Zeit Now miniconda installer link to anaconda.com ([413](https://github.com/GenericMappingTools/pygmt/pull/413))
* Fix GitHub Pages deployment from Travis ([410](https://github.com/GenericMappingTools/pygmt/pull/410))
* Update and clean TravisCI configuration ([404](https://github.com/GenericMappingTools/pygmt/pull/404))
* Quickfix min elevation for new SRTM15+V2.1 earth relief grids ([401](https://github.com/GenericMappingTools/pygmt/pull/401))
* Wrap docstrings to 79 chars and check with flake8 ([384](https://github.com/GenericMappingTools/pygmt/pull/384))
* Update continuous integration scripts to 1.2.0 ([355](https://github.com/GenericMappingTools/pygmt/pull/355))
* Use Zeit Now to deploy doc builds from PRs ([344](https://github.com/GenericMappingTools/pygmt/pull/344))
* Move gmt from requirements.txt to CI scripts instead ([343](https://github.com/GenericMappingTools/pygmt/pull/343))
* Change py.test to pytest ([338](https://github.com/GenericMappingTools/pygmt/pull/338))
* Add Google Analytics to measure site visitors ([314](https://github.com/GenericMappingTools/pygmt/pull/314))
* Register mpl_image_compare marker to remove PytestUnknownMarkWarning ([323](https://github.com/GenericMappingTools/pygmt/pull/323))
* Disable Windows CI builds before PR [313](https://github.com/GenericMappingTools/pygmt/pull/313) is merged ([#320](https://github.com/GenericMappingTools/pygmt/pull/320))
* Enable Mac and Windows CI on Azure Pipelines ([312](https://github.com/GenericMappingTools/pygmt/pull/312))
* Fixes for using GMT 6.0.0rc1 ([311](https://github.com/GenericMappingTools/pygmt/pull/311))
* Assign authorship to "The PyGMT Developers" ([284](https://github.com/GenericMappingTools/pygmt/pull/284))

Deprecations

* Remove mention of gitter.im ([405](https://github.com/GenericMappingTools/pygmt/pull/405))
* Remove portrait (-P) from common options ([339](https://github.com/GenericMappingTools/pygmt/pull/339))
* Remove require.js since WorldWind was dropped ([278](https://github.com/GenericMappingTools/pygmt/pull/278))
* Remove Web WorldWind support ([275](https://github.com/GenericMappingTools/pygmt/pull/275))

Contributors

* [Dongdong Tian](https://github.com/seisman)
* [Wei Ji Leong](https://github.com/weiji14)
* [Leonardo Uieda](https://github.com/leouieda)
* [Liam Toney](https://github.com/liamtoney)
* [Brook Tozer](https://github.com/btozer)
* [Claudio Satriano](https://github.com/claudiodsf)
* [Cody Woodson](https://github.com/Dovacody)
* [Mark Wieczorek](https://github.com/MarkWieczorek)
* [Philipp Loose](https://github.com/phloose)
* [Kathryn Materna](https://github.com/kmaterna)