From d8659c1e249eb43bd1feece55a14ff8aac2668a8 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sat, 28 Dec 2024 22:51:48 +0800 Subject: [PATCH 01/28] Add v0.14.0 entry in doc/_static/version_switch.js for documentation switcher --- doc/_static/version_switch.js | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/_static/version_switch.js b/doc/_static/version_switch.js index acedd8c1d4c..5450cb9d6af 100644 --- a/doc/_static/version_switch.js +++ b/doc/_static/version_switch.js @@ -12,6 +12,7 @@ var all_versions = { 'latest': 'latest', 'dev': 'dev', + 'v0.14.0': 'v0.14.0', 'v0.13.0': 'v0.13.0', 'v0.12.0': 'v0.12.0', 'v0.11.0': 'v0.11.0', From 5c9272f70271a491d5d01be5ea4e3b452d67efb6 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sat, 28 Dec 2024 22:57:57 +0800 Subject: [PATCH 02/28] Add the version to the compatibility table doc/minversions.md --- doc/minversions.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/minversions.md b/doc/minversions.md index 1d348ec6922..b10150b5ce1 100644 --- a/doc/minversions.md +++ b/doc/minversions.md @@ -41,6 +41,7 @@ compatibility reasons. | PyGMT Version | GMT | Python | NumPy | pandas | Xarray | |---|---|---|---|---|---| | [Dev][]* [] | {{ requires.gmt }} | {{ requires.python }} | {{ requires.numpy }} | {{ requires.pandas }} | {{ requires.xarray }} | +| [] | >=6.4.0 | >=3.11 | >=1.25 | >=2.0 | >=2023.04 | | [] | >=6.3.0 | >=3.10 | >=1.24 | >=1.5 | >=2022.09 | | [] | >=6.3.0 | >=3.10 | >=1.23 | >=1.5 | >=2022.06 | | [] | >=6.3.0 | >=3.9 | >=1.23 | | | From d05426fc3ad53430d61560efd54485aa944e9f46 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sat, 28 Dec 2024 23:03:28 +0800 Subject: [PATCH 03/28] Update citation information CITATION.cff and BibTeX in README --- CITATION.cff | 6 +++--- README.md | 10 +++++----- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/CITATION.cff b/CITATION.cff index e6d79e2530d..32fdcf171c2 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -76,9 +76,9 @@ authors: family-names: Wessel affiliation: University of Hawaiʻi at Mānoa, USA orcid: https://orcid.org/0000-0001-5708-7336 -date-released: 2024-09-05 -doi: 10.5281/zenodo.13679420 +date-released: 2024-12-31 +doi: 10.5281/zenodo.14535921 license: BSD-3-Clause repository-code: https://github.com/GenericMappingTools/pygmt type: software -version: 0.13.0 +version: 0.14.0 diff --git a/README.md b/README.md index 44f4065aeb7..041c2cb3da9 100644 --- a/README.md +++ b/README.md @@ -132,7 +132,7 @@ research using the following BibTeX: ``` @software{ - pygmt_2024_13679420, + pygmt_2024_14535921, author = {Tian, Dongdong and Uieda, Leonardo and Leong, Wei Ji and @@ -152,12 +152,12 @@ research using the following BibTeX: Quinn, Jamie and Wessel, Paul}, title = {{PyGMT: A Python interface for the Generic Mapping Tools}}, - month = sep, + month = dec, year = 2024, publisher = {Zenodo}, - version = {0.13.0}, - doi = {10.5281/zenodo.13679420}, - url = {https://doi.org/10.5281/zenodo.13679420} + version = {0.14.0}, + doi = {10.5281/zenodo.14535921}, + url = {https://doi.org/10.5281/zenodo.14535921} } ``` From 9fd98fc255fff4b00bb5ff6479956a258ccd9ba0 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sat, 28 Dec 2024 23:05:19 +0800 Subject: [PATCH 04/28] Copy the draft release note from the release page --- doc/changes.md | 115 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 115 insertions(+) diff --git a/doc/changes.md b/doc/changes.md index 2efe67a7f1d..b7dab98954f 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -1,5 +1,120 @@ # Changelog +## Release v0.14.0 (20YY/MM/DD) + +[![Digital Object Identifier for PyGMT v0.14.0](https://zenodo.org/badge/DOI/10.5281/zenodo.3781524.svg)](https://doi.org/10.5281/zenodo.3781524) + +### Highlights + +* + +### New Features + +* Remote datasets: Add "uncertainty" parameter to "load_earth_free_air_anomaly" to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) +* Remote datasets: Add "load_earth_mean_sea_surface" to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) +* Remote datasets: Add "load_earth_mean_dynamic_topography" to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) +* Remote datasets: Add "load_earth_dist" to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) +* Add the Session.virtualfile_from_stringio method to allow StringIO input for certain functions/methods ([#3326](https://github.com/GenericMappingTools/pygmt/pull/3326)) +* Add function to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) +* Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) +* Add Figure.hlines for plotting horizontal lines ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) +* Add function to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) + +### Enhancements + +* pyarrow: Support pyarrow arrays with string/large_string/string_view types ([#3619](https://github.com/GenericMappingTools/pygmt/pull/3619)) +* pyarrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) +* load_tile_map: Add the new parameter 'crs' to set the CRS of the returned dataarray ([#3554](https://github.com/GenericMappingTools/pygmt/pull/3554)) +* Support 1-D/2-D numpy arrays with longlong and ulonglong dtype ([#3566](https://github.com/GenericMappingTools/pygmt/pull/3566)) +* GMT_IMAGE: Implement the GMT_IMAGE.to_dataarray method for 3-band images ([#3128](https://github.com/GenericMappingTools/pygmt/pull/3128)) +* Figure.show: Raise ImportError instead of GMTError if IPython is not installed but required ([#3580](https://github.com/GenericMappingTools/pygmt/pull/3580)) +* Figure.plot: Add the "symbol" parameter to support plotting data points with varying symbols ([#1117](https://github.com/GenericMappingTools/pygmt/pull/1117)) +* Figure.plot3d: Add the "symbol" parameter to support plotting data points with varying symbols ([#3559](https://github.com/GenericMappingTools/pygmt/pull/3559)) +* Figure.legend: Support passing a StringIO object as the legend specification ([#3438](https://github.com/GenericMappingTools/pygmt/pull/3438)) +* Ensure non-ASCII characters are typeset correctly even if PS_CHAR_ENCODING is not 'ISOLatin1+' ([#3611](https://github.com/GenericMappingTools/pygmt/pull/3611)) +* Add the private _to_numpy function to convert anything to a numpy array ([#3581](https://github.com/GenericMappingTools/pygmt/pull/3581)) +* Add enums GridRegistration and GridType for grid registration and type ([#3693](https://github.com/GenericMappingTools/pygmt/pull/3693)) +* Add PyArrow as an optional dependency ([#3592](https://github.com/GenericMappingTools/pygmt/pull/3592)) + +### Deprecations + +* clib.Session.virtualfile_from_vectors: Now takes a sequence of vectors as its single argument (Passing multiple arguments will be unsupported in v0.16.0) ([#3522](https://github.com/GenericMappingTools/pygmt/pull/3522)) +* Set minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) +* SPEC 0: Set minimum supported versions to pandas>=2.0 and xarray>=2023.04 ([#3460](https://github.com/GenericMappingTools/pygmt/pull/3460)) +* SPEC 0: Bump minimum supported version to Python 3.11 ([#3606](https://github.com/GenericMappingTools/pygmt/pull/3606)) +* SPEC 0: Bump minimum supported version to NumPy 1.25 ([#3697](https://github.com/GenericMappingTools/pygmt/pull/3697)) +* Remove the deprecated build_arg_string function (deprecated since v0.12.0) ([#3427](https://github.com/GenericMappingTools/pygmt/pull/3427)) +* Figure.grdcontour: Remove the deprecated syntax for the 'annotation' parameter ([#3428](https://github.com/GenericMappingTools/pygmt/pull/3428)) + +### Bug Fixes + +* launch_external_viewer: Use full path when opening the file in a web browser ([#3647](https://github.com/GenericMappingTools/pygmt/pull/3647)) +* clib.session: Add the GMT_SESSION_NOGDALCLOSE flag to keep GDAL open ([#3672](https://github.com/GenericMappingTools/pygmt/pull/3672)) +* Set the 'Conventions' attribute to 'CF-1.7' for netCDF grids only ([#3463](https://github.com/GenericMappingTools/pygmt/pull/3463)) +* Improve the workarounds for handling pandas nullable dtypes in pandas<=2.1 ([#3596](https://github.com/GenericMappingTools/pygmt/pull/3596)) +* GeoPandas: Explicitly convert columns with overflow integers to avoid OverflowError with fiona 1.10 ([#3455](https://github.com/GenericMappingTools/pygmt/pull/3455)) +* Fix the conversion error for pandas.Series with missing values in pandas<=2.1 ([#3505](https://github.com/GenericMappingTools/pygmt/pull/3505)) +* Figure.plot/Figure.plot3d: Improve the check of the "style" parameter for "v" or "V" ([#3603](https://github.com/GenericMappingTools/pygmt/pull/3603)) +* Correctly reserve the grid data dtype by converting ctypes array to numpy array with np.ctypeslib.as_array ([#3446](https://github.com/GenericMappingTools/pygmt/pull/3446)) +* **Breaking**: Figure.text: Fix typesetting of integers when mixed with floating-point values ([#3493](https://github.com/GenericMappingTools/pygmt/pull/3493)) + +### Documentation + +* Update "PyData Ecosystem" to "Scientific Python Ecosystem" ([#3447](https://github.com/GenericMappingTools/pygmt/pull/3447)) +* Mention breaking change regarding extra quotation marks around text strings in changelog v0.12.0 ([#3462](https://github.com/GenericMappingTools/pygmt/pull/3462)) +* List function aliases in a more compact layout ([#3666](https://github.com/GenericMappingTools/pygmt/pull/3666)) +* Figure.savefig: Clarify that 'transparent' also works for the PNG file associated with the KML format ([#3579](https://github.com/GenericMappingTools/pygmt/pull/3579)) +* Document the support policy for optional packages ([#3616](https://github.com/GenericMappingTools/pygmt/pull/3616)) +* Document the environment variables that can affect the behavior of PyGMT ([#3432](https://github.com/GenericMappingTools/pygmt/pull/3432)) +* Document the built-in patterns in the Technical Reference section ([#3466](https://github.com/GenericMappingTools/pygmt/pull/3466)) +* Document Continuous Benchmarking in Maintainers Guides ([#3631](https://github.com/GenericMappingTools/pygmt/pull/3631)) +* DOC: Add basic tutorial "Plotting polygons" ([#3593](https://github.com/GenericMappingTools/pygmt/pull/3593)) +* Combine the Oblique Mercator projection pages into one page ([#3451](https://github.com/GenericMappingTools/pygmt/pull/3451)) +* Add the PyGMT talk at AGU24 to the "Overview" section ([#3685](https://github.com/GenericMappingTools/pygmt/pull/3685)) +* Add the PyGMT ecosystem page ([#3475](https://github.com/GenericMappingTools/pygmt/pull/3475)) +* Add the GMT/PyGMT preworkshop at AGU24 to the "External resources" section ([#3689](https://github.com/GenericMappingTools/pygmt/pull/3689)) +* Add instructions for installing optional dependencies ([#3506](https://github.com/GenericMappingTools/pygmt/pull/3506)) +* Add TODO comments in the maintainers guides and update the release checklist ([#3724](https://github.com/GenericMappingTools/pygmt/pull/3724)) + +### Maintenance + +* pyarrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) +* doc: Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) +* clib.conversion: Remove the as_c_contiguous function and use np.ascontiguousarray instead ([#3492](https://github.com/GenericMappingTools/pygmt/pull/3492)) +* clib.Session: Add type hints and improve docstrings of the Session create/destroy methods ([#3515](https://github.com/GenericMappingTools/pygmt/pull/3515)) +* Use TODO comments to track deprecations and workarounds ([#3722](https://github.com/GenericMappingTools/pygmt/pull/3722)) +* Refactor the _get_module_version function using importlib and add two more tests ([#3538](https://github.com/GenericMappingTools/pygmt/pull/3538)) +* Pin numpy<2 in ci_tests_legacy.yaml ([#3641](https://github.com/GenericMappingTools/pygmt/pull/3641)) +* Move Figure.psconvert into a separate file ([#3553](https://github.com/GenericMappingTools/pygmt/pull/3553)) +* Improve the data type checking for 2-D arrays passed to the GMT C API ([#3563](https://github.com/GenericMappingTools/pygmt/pull/3563)) +* GMT_DATASET: Refactor nested classes to improve code readability ([#3653](https://github.com/GenericMappingTools/pygmt/pull/3653)) +* Enable ruff's flake8-todos (TD) rules ([#3723](https://github.com/GenericMappingTools/pygmt/pull/3723)) +* Enable ruff's flake8-commas (COM) and refurb (FURB) rules ([#3531](https://github.com/GenericMappingTools/pygmt/pull/3531)) +* Enable ruff's TRY (tryceratops) rules ([#3665](https://github.com/GenericMappingTools/pygmt/pull/3665)) +* Enable ruff's EM (flake8-errmsg) rules and fix violations ([#3661](https://github.com/GenericMappingTools/pygmt/pull/3661)) +* CI: Use windows-2025 in the GMT Dev Tests workflow ([#3701](https://github.com/GenericMappingTools/pygmt/pull/3701)) +* CI: Test NumPy 2.2 in the GMT Tests workflow ([#3677](https://github.com/GenericMappingTools/pygmt/pull/3677)) +* CI: Run the 'GMT Tests' workflow on Python 3.10/3.12 with optional packages and Python 3.11 without optional packages ([#3618](https://github.com/GenericMappingTools/pygmt/pull/3618)) +* CI: Remove the pytest-xdist plugin from the "Tests" and "Dev Tests" workflows ([#3627](https://github.com/GenericMappingTools/pygmt/pull/3627)) +* CI: Pin to sphinx>=6.2 for docs build on Python 3.13 ([#3667](https://github.com/GenericMappingTools/pygmt/pull/3667)) +* CI: Install pyarrow-core instead of pyarrow from conda-forge ([#3698](https://github.com/GenericMappingTools/pygmt/pull/3698)) +* CI: Ensure no hyphens in Python file and directory names in the "Style Checks" workflow ([#3703](https://github.com/GenericMappingTools/pygmt/pull/3703)) +* CI: Add a separate CI job on Ubuntu to test geopandas v0.x ([#3420](https://github.com/GenericMappingTools/pygmt/pull/3420)) +* Bump to ruff>=0.8.0 and rename rule TCH to TC ([#3662](https://github.com/GenericMappingTools/pygmt/pull/3662)) +* Bump to Ghostscript 10.04.0 ([#3443](https://github.com/GenericMappingTools/pygmt/pull/3443)) +* Add support for Python 3.13 ([#3490](https://github.com/GenericMappingTools/pygmt/pull/3490)) +* Add enums GridFormat for GMT grid format ID ([#3449](https://github.com/GenericMappingTools/pygmt/pull/3449)) +* Add a test for plotting global grid without the redundant 360 longitude ([#3358](https://github.com/GenericMappingTools/pygmt/pull/3358)) +* Add 'geodatasets' as a dependency for docs and update the choropleth example ([#3719](https://github.com/GenericMappingTools/pygmt/pull/3719)) +* **Breaking**: data_kind: data is None and required now returns the 'empty' kind ([#3482](https://github.com/GenericMappingTools/pygmt/pull/3482)) +* **Breaking**: data_kind: Now 'matrix' represents a 2-D numpy array and unrecognized data types fall back to 'vectors' ([#3351](https://github.com/GenericMappingTools/pygmt/pull/3351)) + +**Full Changelog**: + +### Contributors + +[@core](https://github.com/core)-man, [Michael Grund](https://github.com/michaelgrund), [Dongdong Tian](https://github.com/seisman), [Wei Ji Leong](https://github.com/weiji14), [Will Schlitzer](https://github.com/willschlitzer) and [Yvonne Fröhlich](https://github.com/yvonnefroehlich) + ## Release v0.13.0 (2024/09/05) [![Digital Object Identifier for PyGMT v0.13.0](https://zenodo.org/badge/DOI/10.5281/zenodo.13679420.svg)](https://doi.org/10.5281/zenodo.13679420) From f15e9fc07b28fa71a60e50553f78f368fc51c3fd Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sat, 28 Dec 2024 23:06:39 +0800 Subject: [PATCH 05/28] Update the release date and the DOI badge in doc/changes --- doc/changes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index b7dab98954f..8dc662cfd02 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -1,8 +1,8 @@ # Changelog -## Release v0.14.0 (20YY/MM/DD) +## Release v0.14.0 (2024/12/31) -[![Digital Object Identifier for PyGMT v0.14.0](https://zenodo.org/badge/DOI/10.5281/zenodo.3781524.svg)](https://doi.org/10.5281/zenodo.3781524) +[![Digital Object Identifier for PyGMT v0.14.0](https://zenodo.org/badge/DOI/10.5281/zenodo.14535921.svg)](https://doi.org/10.5281/zenodo.14535921) ### Highlights From 685032d3c7051ec6a8b7d385b3b204baeb215438 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sat, 28 Dec 2024 23:10:44 +0800 Subject: [PATCH 06/28] Update the author order in doc/changes.md --- doc/changes.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/changes.md b/doc/changes.md index 8dc662cfd02..c679e89c5d5 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -113,7 +113,12 @@ ### Contributors -[@core](https://github.com/core)-man, [Michael Grund](https://github.com/michaelgrund), [Dongdong Tian](https://github.com/seisman), [Wei Ji Leong](https://github.com/weiji14), [Will Schlitzer](https://github.com/willschlitzer) and [Yvonne Fröhlich](https://github.com/yvonnefroehlich) +* [Dongdong Tian](https://github.com/seisman) +* [Yvonne Fröhlich](https://github.com/yvonnefroehlich) +* [Wei Ji Leong](https://github.com/weiji14) +* [Michael Grund](https://github.com/michaelgrund) +* [Will Schlitzer](https://github.com/willschlitzer) +* [Jiayuan Yao](https://github.com/core-man) ## Release v0.13.0 (2024/09/05) From fb2b922528f3e9aa7943adc50f9fe518b49e7756 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 12:27:45 +0800 Subject: [PATCH 07/28] Apply suggestions from code review --- doc/changes.md | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index c679e89c5d5..a7ee7a21d73 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -18,7 +18,7 @@ * Add function to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) * Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) * Add Figure.hlines for plotting horizontal lines ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) -* Add function to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) +* Add function to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) ### Enhancements @@ -40,9 +40,7 @@ * clib.Session.virtualfile_from_vectors: Now takes a sequence of vectors as its single argument (Passing multiple arguments will be unsupported in v0.16.0) ([#3522](https://github.com/GenericMappingTools/pygmt/pull/3522)) * Set minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) -* SPEC 0: Set minimum supported versions to pandas>=2.0 and xarray>=2023.04 ([#3460](https://github.com/GenericMappingTools/pygmt/pull/3460)) -* SPEC 0: Bump minimum supported version to Python 3.11 ([#3606](https://github.com/GenericMappingTools/pygmt/pull/3606)) -* SPEC 0: Bump minimum supported version to NumPy 1.25 ([#3697](https://github.com/GenericMappingTools/pygmt/pull/3697)) +* SPEC 0: Bump minimum supported versions to Python 3.11, NumPy 1.25, pandas>=2.0 and xarray>=2023.04 ([#3460](https://github.com/GenericMappingTools/pygmt/pull/3460), [#3606](https://github.com/GenericMappingTools/pygmt/pull/3606), [#3697](https://github.com/GenericMappingTools/pygmt/pull/3697)) * Remove the deprecated build_arg_string function (deprecated since v0.12.0) ([#3427](https://github.com/GenericMappingTools/pygmt/pull/3427)) * Figure.grdcontour: Remove the deprecated syntax for the 'annotation' parameter ([#3428](https://github.com/GenericMappingTools/pygmt/pull/3428)) @@ -81,17 +79,13 @@ * pyarrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) * doc: Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) * clib.conversion: Remove the as_c_contiguous function and use np.ascontiguousarray instead ([#3492](https://github.com/GenericMappingTools/pygmt/pull/3492)) -* clib.Session: Add type hints and improve docstrings of the Session create/destroy methods ([#3515](https://github.com/GenericMappingTools/pygmt/pull/3515)) * Use TODO comments to track deprecations and workarounds ([#3722](https://github.com/GenericMappingTools/pygmt/pull/3722)) * Refactor the _get_module_version function using importlib and add two more tests ([#3538](https://github.com/GenericMappingTools/pygmt/pull/3538)) * Pin numpy<2 in ci_tests_legacy.yaml ([#3641](https://github.com/GenericMappingTools/pygmt/pull/3641)) * Move Figure.psconvert into a separate file ([#3553](https://github.com/GenericMappingTools/pygmt/pull/3553)) * Improve the data type checking for 2-D arrays passed to the GMT C API ([#3563](https://github.com/GenericMappingTools/pygmt/pull/3563)) * GMT_DATASET: Refactor nested classes to improve code readability ([#3653](https://github.com/GenericMappingTools/pygmt/pull/3653)) -* Enable ruff's flake8-todos (TD) rules ([#3723](https://github.com/GenericMappingTools/pygmt/pull/3723)) -* Enable ruff's flake8-commas (COM) and refurb (FURB) rules ([#3531](https://github.com/GenericMappingTools/pygmt/pull/3531)) -* Enable ruff's TRY (tryceratops) rules ([#3665](https://github.com/GenericMappingTools/pygmt/pull/3665)) -* Enable ruff's EM (flake8-errmsg) rules and fix violations ([#3661](https://github.com/GenericMappingTools/pygmt/pull/3661)) +* Enable ruff's TD (flake8-todos), COM (flake8-commas), TRY (tryceratops), and EM (flake8-errmsg) rules ([#3723](https://github.com/GenericMappingTools/pygmt/pull/3723), [#3531](https://github.com/GenericMappingTools/pygmt/pull/3531), [#3665](https://github.com/GenericMappingTools/pygmt/pull/3665), [#3661](https://github.com/GenericMappingTools/pygmt/pull/3661)) * CI: Use windows-2025 in the GMT Dev Tests workflow ([#3701](https://github.com/GenericMappingTools/pygmt/pull/3701)) * CI: Test NumPy 2.2 in the GMT Tests workflow ([#3677](https://github.com/GenericMappingTools/pygmt/pull/3677)) * CI: Run the 'GMT Tests' workflow on Python 3.10/3.12 with optional packages and Python 3.11 without optional packages ([#3618](https://github.com/GenericMappingTools/pygmt/pull/3618)) From 92f9e752cd6d958cd7c964a636fffab99635ee6c Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 19:58:28 +0800 Subject: [PATCH 08/28] Apply suggestions from code review --- doc/changes.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index a7ee7a21d73..a1a6f0783a6 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -14,11 +14,10 @@ * Remote datasets: Add "load_earth_mean_sea_surface" to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) * Remote datasets: Add "load_earth_mean_dynamic_topography" to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) * Remote datasets: Add "load_earth_dist" to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) -* Add the Session.virtualfile_from_stringio method to allow StringIO input for certain functions/methods ([#3326](https://github.com/GenericMappingTools/pygmt/pull/3326)) -* Add function to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) +* Add "load_blue_marble" to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) * Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) * Add Figure.hlines for plotting horizontal lines ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) -* Add function to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) +* Add "load_black_marble" to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) ### Enhancements @@ -75,7 +74,7 @@ * Add TODO comments in the maintainers guides and update the release checklist ([#3724](https://github.com/GenericMappingTools/pygmt/pull/3724)) ### Maintenance - +* Add the Session.virtualfile_from_stringio method to allow StringIO input for certain functions/methods ([#3326](https://github.com/GenericMappingTools/pygmt/pull/3326)) * pyarrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) * doc: Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) * clib.conversion: Remove the as_c_contiguous function and use np.ascontiguousarray instead ([#3492](https://github.com/GenericMappingTools/pygmt/pull/3492)) From 73a37e5a092f6b879e0b67eb67565788f9060047 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 20:12:07 +0800 Subject: [PATCH 09/28] Sort entries in the 'New Features' category --- doc/changes.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index a1a6f0783a6..90cffc5fad8 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -10,14 +10,15 @@ ### New Features -* Remote datasets: Add "uncertainty" parameter to "load_earth_free_air_anomaly" to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) -* Remote datasets: Add "load_earth_mean_sea_surface" to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) -* Remote datasets: Add "load_earth_mean_dynamic_topography" to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) -* Remote datasets: Add "load_earth_dist" to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) -* Add "load_blue_marble" to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) -* Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) * Add Figure.hlines for plotting horizontal lines ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) +* Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) +* Add "load_blue_marble" to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) * Add "load_black_marble" to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) +* Add "load_earth_mean_sea_surface" to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) +* Add "load_earth_mean_dynamic_topography" to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) +* Add "load_earth_dist" to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) +* Add "uncertainty" parameter to "load_earth_free_air_anomaly" to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) + ### Enhancements From f4ad6a85f0515004b3f6e75dccd34cf76f8794ff Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 22:07:45 +0800 Subject: [PATCH 10/28] Sort entries in the 'Enhancements' category --- doc/changes.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 90cffc5fad8..68d5aedb3d8 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -22,15 +22,14 @@ ### Enhancements -* pyarrow: Support pyarrow arrays with string/large_string/string_view types ([#3619](https://github.com/GenericMappingTools/pygmt/pull/3619)) -* pyarrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) -* load_tile_map: Add the new parameter 'crs' to set the CRS of the returned dataarray ([#3554](https://github.com/GenericMappingTools/pygmt/pull/3554)) -* Support 1-D/2-D numpy arrays with longlong and ulonglong dtype ([#3566](https://github.com/GenericMappingTools/pygmt/pull/3566)) -* GMT_IMAGE: Implement the GMT_IMAGE.to_dataarray method for 3-band images ([#3128](https://github.com/GenericMappingTools/pygmt/pull/3128)) * Figure.show: Raise ImportError instead of GMTError if IPython is not installed but required ([#3580](https://github.com/GenericMappingTools/pygmt/pull/3580)) * Figure.plot: Add the "symbol" parameter to support plotting data points with varying symbols ([#1117](https://github.com/GenericMappingTools/pygmt/pull/1117)) * Figure.plot3d: Add the "symbol" parameter to support plotting data points with varying symbols ([#3559](https://github.com/GenericMappingTools/pygmt/pull/3559)) * Figure.legend: Support passing a StringIO object as the legend specification ([#3438](https://github.com/GenericMappingTools/pygmt/pull/3438)) +* load_tile_map: Add the new parameter 'crs' to set the CRS of the returned dataarray ([#3554](https://github.com/GenericMappingTools/pygmt/pull/3554)) +* pyarrow: Support pyarrow arrays with string/large_string/string_view types ([#3619](https://github.com/GenericMappingTools/pygmt/pull/3619)) +* Support 1-D/2-D numpy arrays with longlong and ulonglong dtype ([#3566](https://github.com/GenericMappingTools/pygmt/pull/3566)) +* GMT_IMAGE: Implement the GMT_IMAGE.to_dataarray method for 3-band images ([#3128](https://github.com/GenericMappingTools/pygmt/pull/3128)) * Ensure non-ASCII characters are typeset correctly even if PS_CHAR_ENCODING is not 'ISOLatin1+' ([#3611](https://github.com/GenericMappingTools/pygmt/pull/3611)) * Add the private _to_numpy function to convert anything to a numpy array ([#3581](https://github.com/GenericMappingTools/pygmt/pull/3581)) * Add enums GridRegistration and GridType for grid registration and type ([#3693](https://github.com/GenericMappingTools/pygmt/pull/3693)) @@ -47,6 +46,8 @@ ### Bug Fixes * launch_external_viewer: Use full path when opening the file in a web browser ([#3647](https://github.com/GenericMappingTools/pygmt/pull/3647)) +* pyarrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) + * clib.session: Add the GMT_SESSION_NOGDALCLOSE flag to keep GDAL open ([#3672](https://github.com/GenericMappingTools/pygmt/pull/3672)) * Set the 'Conventions' attribute to 'CF-1.7' for netCDF grids only ([#3463](https://github.com/GenericMappingTools/pygmt/pull/3463)) * Improve the workarounds for handling pandas nullable dtypes in pandas<=2.1 ([#3596](https://github.com/GenericMappingTools/pygmt/pull/3596)) From da7e08cc5b29f5afcd24ed342365c08a7195ed7a Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 22:08:55 +0800 Subject: [PATCH 11/28] Sort entries in the 'Deprecations' category --- doc/changes.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 68d5aedb3d8..198901773ee 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -37,9 +37,9 @@ ### Deprecations -* clib.Session.virtualfile_from_vectors: Now takes a sequence of vectors as its single argument (Passing multiple arguments will be unsupported in v0.16.0) ([#3522](https://github.com/GenericMappingTools/pygmt/pull/3522)) -* Set minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) +* Bump minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) * SPEC 0: Bump minimum supported versions to Python 3.11, NumPy 1.25, pandas>=2.0 and xarray>=2023.04 ([#3460](https://github.com/GenericMappingTools/pygmt/pull/3460), [#3606](https://github.com/GenericMappingTools/pygmt/pull/3606), [#3697](https://github.com/GenericMappingTools/pygmt/pull/3697)) +* clib.Session.virtualfile_from_vectors: Now takes a sequence of vectors as its single argument (Passing multiple arguments will be unsupported in v0.16.0) ([#3522](https://github.com/GenericMappingTools/pygmt/pull/3522)) * Remove the deprecated build_arg_string function (deprecated since v0.12.0) ([#3427](https://github.com/GenericMappingTools/pygmt/pull/3427)) * Figure.grdcontour: Remove the deprecated syntax for the 'annotation' parameter ([#3428](https://github.com/GenericMappingTools/pygmt/pull/3428)) @@ -47,7 +47,6 @@ * launch_external_viewer: Use full path when opening the file in a web browser ([#3647](https://github.com/GenericMappingTools/pygmt/pull/3647)) * pyarrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) - * clib.session: Add the GMT_SESSION_NOGDALCLOSE flag to keep GDAL open ([#3672](https://github.com/GenericMappingTools/pygmt/pull/3672)) * Set the 'Conventions' attribute to 'CF-1.7' for netCDF grids only ([#3463](https://github.com/GenericMappingTools/pygmt/pull/3463)) * Improve the workarounds for handling pandas nullable dtypes in pandas<=2.1 ([#3596](https://github.com/GenericMappingTools/pygmt/pull/3596)) From 9e4475035c2bcd9c20e4d64673ffa412255bc239 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 22:10:32 +0800 Subject: [PATCH 12/28] Sort entries in the 'Bug Fixes' category --- doc/changes.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 198901773ee..70892f6d5f5 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -49,9 +49,8 @@ * pyarrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) * clib.session: Add the GMT_SESSION_NOGDALCLOSE flag to keep GDAL open ([#3672](https://github.com/GenericMappingTools/pygmt/pull/3672)) * Set the 'Conventions' attribute to 'CF-1.7' for netCDF grids only ([#3463](https://github.com/GenericMappingTools/pygmt/pull/3463)) -* Improve the workarounds for handling pandas nullable dtypes in pandas<=2.1 ([#3596](https://github.com/GenericMappingTools/pygmt/pull/3596)) +* Fix the conversion error for pandas.Series with missing values in pandas<=2.1 ([#3505](https://github.com/GenericMappingTools/pygmt/pull/3505), [#3596](https://github.com/GenericMappingTools/pygmt/pull/3596)) * GeoPandas: Explicitly convert columns with overflow integers to avoid OverflowError with fiona 1.10 ([#3455](https://github.com/GenericMappingTools/pygmt/pull/3455)) -* Fix the conversion error for pandas.Series with missing values in pandas<=2.1 ([#3505](https://github.com/GenericMappingTools/pygmt/pull/3505)) * Figure.plot/Figure.plot3d: Improve the check of the "style" parameter for "v" or "V" ([#3603](https://github.com/GenericMappingTools/pygmt/pull/3603)) * Correctly reserve the grid data dtype by converting ctypes array to numpy array with np.ctypeslib.as_array ([#3446](https://github.com/GenericMappingTools/pygmt/pull/3446)) * **Breaking**: Figure.text: Fix typesetting of integers when mixed with floating-point values ([#3493](https://github.com/GenericMappingTools/pygmt/pull/3493)) From 31788f3d5fe3fbe7c96658fa6ea02b4d4f28e4f3 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 22:12:25 +0800 Subject: [PATCH 13/28] Sort entries in the 'Documentation' category --- doc/changes.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 70892f6d5f5..da8b7d3da14 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -57,20 +57,17 @@ ### Documentation -* Update "PyData Ecosystem" to "Scientific Python Ecosystem" ([#3447](https://github.com/GenericMappingTools/pygmt/pull/3447)) -* Mention breaking change regarding extra quotation marks around text strings in changelog v0.12.0 ([#3462](https://github.com/GenericMappingTools/pygmt/pull/3462)) -* List function aliases in a more compact layout ([#3666](https://github.com/GenericMappingTools/pygmt/pull/3666)) -* Figure.savefig: Clarify that 'transparent' also works for the PNG file associated with the KML format ([#3579](https://github.com/GenericMappingTools/pygmt/pull/3579)) +* Add basic tutorial "Plotting polygons" ([#3593](https://github.com/GenericMappingTools/pygmt/pull/3593)) +* Add the PyGMT ecosystem page ([#3475](https://github.com/GenericMappingTools/pygmt/pull/3475)) * Document the support policy for optional packages ([#3616](https://github.com/GenericMappingTools/pygmt/pull/3616)) * Document the environment variables that can affect the behavior of PyGMT ([#3432](https://github.com/GenericMappingTools/pygmt/pull/3432)) * Document the built-in patterns in the Technical Reference section ([#3466](https://github.com/GenericMappingTools/pygmt/pull/3466)) * Document Continuous Benchmarking in Maintainers Guides ([#3631](https://github.com/GenericMappingTools/pygmt/pull/3631)) -* DOC: Add basic tutorial "Plotting polygons" ([#3593](https://github.com/GenericMappingTools/pygmt/pull/3593)) -* Combine the Oblique Mercator projection pages into one page ([#3451](https://github.com/GenericMappingTools/pygmt/pull/3451)) +* Add instructions for installing optional dependencies ([#3506](https://github.com/GenericMappingTools/pygmt/pull/3506)) +* Update "PyData Ecosystem" to "Scientific Python Ecosystem" ([#3447](https://github.com/GenericMappingTools/pygmt/pull/3447)) +* Figure.savefig: Clarify that 'transparent' also works for the PNG file associated with the KML format ([#3579](https://github.com/GenericMappingTools/pygmt/pull/3579)) * Add the PyGMT talk at AGU24 to the "Overview" section ([#3685](https://github.com/GenericMappingTools/pygmt/pull/3685)) -* Add the PyGMT ecosystem page ([#3475](https://github.com/GenericMappingTools/pygmt/pull/3475)) * Add the GMT/PyGMT preworkshop at AGU24 to the "External resources" section ([#3689](https://github.com/GenericMappingTools/pygmt/pull/3689)) -* Add instructions for installing optional dependencies ([#3506](https://github.com/GenericMappingTools/pygmt/pull/3506)) * Add TODO comments in the maintainers guides and update the release checklist ([#3724](https://github.com/GenericMappingTools/pygmt/pull/3724)) ### Maintenance From 39561f7bd9b8e8351f9085359d24c86bb9546c67 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Sun, 29 Dec 2024 22:14:40 +0800 Subject: [PATCH 14/28] Sort entries in the 'Maintenance' category --- doc/changes.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index da8b7d3da14..ada15684057 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -71,16 +71,18 @@ * Add TODO comments in the maintainers guides and update the release checklist ([#3724](https://github.com/GenericMappingTools/pygmt/pull/3724)) ### Maintenance + +* **Breaking**: data_kind: data is None and required now returns the 'empty' kind ([#3482](https://github.com/GenericMappingTools/pygmt/pull/3482)) +* **Breaking**: data_kind: Now 'matrix' represents a 2-D numpy array and unrecognized data types fall back to 'vectors' ([#3351](https://github.com/GenericMappingTools/pygmt/pull/3351)) * Add the Session.virtualfile_from_stringio method to allow StringIO input for certain functions/methods ([#3326](https://github.com/GenericMappingTools/pygmt/pull/3326)) +* Add 'geodatasets' as a dependency for docs and update the choropleth example ([#3719](https://github.com/GenericMappingTools/pygmt/pull/3719)) * pyarrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) * doc: Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) * clib.conversion: Remove the as_c_contiguous function and use np.ascontiguousarray instead ([#3492](https://github.com/GenericMappingTools/pygmt/pull/3492)) * Use TODO comments to track deprecations and workarounds ([#3722](https://github.com/GenericMappingTools/pygmt/pull/3722)) -* Refactor the _get_module_version function using importlib and add two more tests ([#3538](https://github.com/GenericMappingTools/pygmt/pull/3538)) * Pin numpy<2 in ci_tests_legacy.yaml ([#3641](https://github.com/GenericMappingTools/pygmt/pull/3641)) * Move Figure.psconvert into a separate file ([#3553](https://github.com/GenericMappingTools/pygmt/pull/3553)) * Improve the data type checking for 2-D arrays passed to the GMT C API ([#3563](https://github.com/GenericMappingTools/pygmt/pull/3563)) -* GMT_DATASET: Refactor nested classes to improve code readability ([#3653](https://github.com/GenericMappingTools/pygmt/pull/3653)) * Enable ruff's TD (flake8-todos), COM (flake8-commas), TRY (tryceratops), and EM (flake8-errmsg) rules ([#3723](https://github.com/GenericMappingTools/pygmt/pull/3723), [#3531](https://github.com/GenericMappingTools/pygmt/pull/3531), [#3665](https://github.com/GenericMappingTools/pygmt/pull/3665), [#3661](https://github.com/GenericMappingTools/pygmt/pull/3661)) * CI: Use windows-2025 in the GMT Dev Tests workflow ([#3701](https://github.com/GenericMappingTools/pygmt/pull/3701)) * CI: Test NumPy 2.2 in the GMT Tests workflow ([#3677](https://github.com/GenericMappingTools/pygmt/pull/3677)) @@ -94,10 +96,6 @@ * Bump to Ghostscript 10.04.0 ([#3443](https://github.com/GenericMappingTools/pygmt/pull/3443)) * Add support for Python 3.13 ([#3490](https://github.com/GenericMappingTools/pygmt/pull/3490)) * Add enums GridFormat for GMT grid format ID ([#3449](https://github.com/GenericMappingTools/pygmt/pull/3449)) -* Add a test for plotting global grid without the redundant 360 longitude ([#3358](https://github.com/GenericMappingTools/pygmt/pull/3358)) -* Add 'geodatasets' as a dependency for docs and update the choropleth example ([#3719](https://github.com/GenericMappingTools/pygmt/pull/3719)) -* **Breaking**: data_kind: data is None and required now returns the 'empty' kind ([#3482](https://github.com/GenericMappingTools/pygmt/pull/3482)) -* **Breaking**: data_kind: Now 'matrix' represents a 2-D numpy array and unrecognized data types fall back to 'vectors' ([#3351](https://github.com/GenericMappingTools/pygmt/pull/3351)) **Full Changelog**: From 5e3cc60c5305a3543a11e580678eba81c32c55da Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Mon, 30 Dec 2024 12:33:56 +0800 Subject: [PATCH 15/28] Remove double quotes from function names --- doc/changes.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index ada15684057..54dc72177ca 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -12,11 +12,11 @@ * Add Figure.hlines for plotting horizontal lines ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) * Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) -* Add "load_blue_marble" to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) -* Add "load_black_marble" to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) -* Add "load_earth_mean_sea_surface" to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) -* Add "load_earth_mean_dynamic_topography" to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) -* Add "load_earth_dist" to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) +* Add load_blue_marble to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) +* Add load_black_marble to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) +* Add load_earth_mean_sea_surface to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) +* Add load_earth_mean_dynamic_topography to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) +* Add load_earth_dist to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) * Add "uncertainty" parameter to "load_earth_free_air_anomaly" to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) From 71bc440d8ab615b2904c2ab5d413d33673d0088d Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Mon, 30 Dec 2024 12:38:33 +0800 Subject: [PATCH 16/28] Add two highlights --- doc/changes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 54dc72177ca..37993fcd2bd 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -6,7 +6,8 @@ ### Highlights -* +* 🎉 Fourteenth minor release of PyGMT 🎉 +* Bump minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) ### New Features @@ -37,7 +38,6 @@ ### Deprecations -* Bump minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) * SPEC 0: Bump minimum supported versions to Python 3.11, NumPy 1.25, pandas>=2.0 and xarray>=2023.04 ([#3460](https://github.com/GenericMappingTools/pygmt/pull/3460), [#3606](https://github.com/GenericMappingTools/pygmt/pull/3606), [#3697](https://github.com/GenericMappingTools/pygmt/pull/3697)) * clib.Session.virtualfile_from_vectors: Now takes a sequence of vectors as its single argument (Passing multiple arguments will be unsupported in v0.16.0) ([#3522](https://github.com/GenericMappingTools/pygmt/pull/3522)) * Remove the deprecated build_arg_string function (deprecated since v0.12.0) ([#3427](https://github.com/GenericMappingTools/pygmt/pull/3427)) From 895bbfe22869309ed8d61a30145ce26963861716 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Mon, 30 Dec 2024 13:11:21 +0800 Subject: [PATCH 17/28] Fix Jing-Hui Tong's name --- CITATION.cff | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CITATION.cff b/CITATION.cff index 32fdcf171c2..c23f001d60e 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -44,8 +44,8 @@ authors: family-names: Magen affiliation: Tel Aviv University, Israel orcid: https://orcid.org/0000-0002-4892-4013 -- given-names: Tong - family-names: Jing-Hui +- given-names: Jing-Hui + family-names: Tong affiliation: National Taiwan Normal University, Taiwan orcid: https://orcid.org/0009-0002-7195-3071 - given-names: Kathryn From b0364669794ff55eeff3f81999809e5bfa334e81 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Mon, 30 Dec 2024 17:28:48 +0800 Subject: [PATCH 18/28] Clean up some changelog entries --- doc/changes.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 37993fcd2bd..a547e8bf029 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -18,21 +18,19 @@ * Add load_earth_mean_sea_surface to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) * Add load_earth_mean_dynamic_topography to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) * Add load_earth_dist to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) -* Add "uncertainty" parameter to "load_earth_free_air_anomaly" to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) +* load_earth_free_air_anomaly: Add "uncertainty" parameter to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) ### Enhancements -* Figure.show: Raise ImportError instead of GMTError if IPython is not installed but required ([#3580](https://github.com/GenericMappingTools/pygmt/pull/3580)) * Figure.plot: Add the "symbol" parameter to support plotting data points with varying symbols ([#1117](https://github.com/GenericMappingTools/pygmt/pull/1117)) * Figure.plot3d: Add the "symbol" parameter to support plotting data points with varying symbols ([#3559](https://github.com/GenericMappingTools/pygmt/pull/3559)) * Figure.legend: Support passing a StringIO object as the legend specification ([#3438](https://github.com/GenericMappingTools/pygmt/pull/3438)) -* load_tile_map: Add the new parameter 'crs' to set the CRS of the returned dataarray ([#3554](https://github.com/GenericMappingTools/pygmt/pull/3554)) -* pyarrow: Support pyarrow arrays with string/large_string/string_view types ([#3619](https://github.com/GenericMappingTools/pygmt/pull/3619)) +* load_tile_map: Add parameter 'crs' to set the CRS of the returned dataarray ([#3554](https://github.com/GenericMappingTools/pygmt/pull/3554)) +* PyArrow: Support pyarrow arrays with string/large_string/string_view types ([#3619](https://github.com/GenericMappingTools/pygmt/pull/3619)) * Support 1-D/2-D numpy arrays with longlong and ulonglong dtype ([#3566](https://github.com/GenericMappingTools/pygmt/pull/3566)) -* GMT_IMAGE: Implement the GMT_IMAGE.to_dataarray method for 3-band images ([#3128](https://github.com/GenericMappingTools/pygmt/pull/3128)) +* GMT_IMAGE: Implement the to_dataarray method for 3-band images ([#3128](https://github.com/GenericMappingTools/pygmt/pull/3128)) * Ensure non-ASCII characters are typeset correctly even if PS_CHAR_ENCODING is not 'ISOLatin1+' ([#3611](https://github.com/GenericMappingTools/pygmt/pull/3611)) -* Add the private _to_numpy function to convert anything to a numpy array ([#3581](https://github.com/GenericMappingTools/pygmt/pull/3581)) * Add enums GridRegistration and GridType for grid registration and type ([#3693](https://github.com/GenericMappingTools/pygmt/pull/3693)) * Add PyArrow as an optional dependency ([#3592](https://github.com/GenericMappingTools/pygmt/pull/3592)) @@ -41,12 +39,12 @@ * SPEC 0: Bump minimum supported versions to Python 3.11, NumPy 1.25, pandas>=2.0 and xarray>=2023.04 ([#3460](https://github.com/GenericMappingTools/pygmt/pull/3460), [#3606](https://github.com/GenericMappingTools/pygmt/pull/3606), [#3697](https://github.com/GenericMappingTools/pygmt/pull/3697)) * clib.Session.virtualfile_from_vectors: Now takes a sequence of vectors as its single argument (Passing multiple arguments will be unsupported in v0.16.0) ([#3522](https://github.com/GenericMappingTools/pygmt/pull/3522)) * Remove the deprecated build_arg_string function (deprecated since v0.12.0) ([#3427](https://github.com/GenericMappingTools/pygmt/pull/3427)) -* Figure.grdcontour: Remove the deprecated syntax for the 'annotation' parameter ([#3428](https://github.com/GenericMappingTools/pygmt/pull/3428)) +* Figure.grdcontour: Remove the deprecated syntax for the 'annotation' parameter (deprecated since v0.12.0) ([#3428](https://github.com/GenericMappingTools/pygmt/pull/3428)) ### Bug Fixes * launch_external_viewer: Use full path when opening the file in a web browser ([#3647](https://github.com/GenericMappingTools/pygmt/pull/3647)) -* pyarrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) +* PyArrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) * clib.session: Add the GMT_SESSION_NOGDALCLOSE flag to keep GDAL open ([#3672](https://github.com/GenericMappingTools/pygmt/pull/3672)) * Set the 'Conventions' attribute to 'CF-1.7' for netCDF grids only ([#3463](https://github.com/GenericMappingTools/pygmt/pull/3463)) * Fix the conversion error for pandas.Series with missing values in pandas<=2.1 ([#3505](https://github.com/GenericMappingTools/pygmt/pull/3505), [#3596](https://github.com/GenericMappingTools/pygmt/pull/3596)) @@ -76,8 +74,8 @@ * **Breaking**: data_kind: Now 'matrix' represents a 2-D numpy array and unrecognized data types fall back to 'vectors' ([#3351](https://github.com/GenericMappingTools/pygmt/pull/3351)) * Add the Session.virtualfile_from_stringio method to allow StringIO input for certain functions/methods ([#3326](https://github.com/GenericMappingTools/pygmt/pull/3326)) * Add 'geodatasets' as a dependency for docs and update the choropleth example ([#3719](https://github.com/GenericMappingTools/pygmt/pull/3719)) -* pyarrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) -* doc: Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) +* PyArrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) +* Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) * clib.conversion: Remove the as_c_contiguous function and use np.ascontiguousarray instead ([#3492](https://github.com/GenericMappingTools/pygmt/pull/3492)) * Use TODO comments to track deprecations and workarounds ([#3722](https://github.com/GenericMappingTools/pygmt/pull/3722)) * Pin numpy<2 in ci_tests_legacy.yaml ([#3641](https://github.com/GenericMappingTools/pygmt/pull/3641)) From e41a0631aaf742b4f2b6aa943e49379b940e6423 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Mon, 30 Dec 2024 21:28:10 +0800 Subject: [PATCH 19/28] Add more highlights --- doc/changes.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/changes.md b/doc/changes.md index a547e8bf029..cd2162db18f 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -7,7 +7,9 @@ ### Highlights * 🎉 Fourteenth minor release of PyGMT 🎉 +* Support for Python 3.13 ([#3490](https://github.com/GenericMappingTools/pygmt/pull/3490)) * Bump minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) +* Two new plotting methods and six new functions to access more GMT remote datasets ### New Features @@ -92,7 +94,6 @@ * CI: Add a separate CI job on Ubuntu to test geopandas v0.x ([#3420](https://github.com/GenericMappingTools/pygmt/pull/3420)) * Bump to ruff>=0.8.0 and rename rule TCH to TC ([#3662](https://github.com/GenericMappingTools/pygmt/pull/3662)) * Bump to Ghostscript 10.04.0 ([#3443](https://github.com/GenericMappingTools/pygmt/pull/3443)) -* Add support for Python 3.13 ([#3490](https://github.com/GenericMappingTools/pygmt/pull/3490)) * Add enums GridFormat for GMT grid format ID ([#3449](https://github.com/GenericMappingTools/pygmt/pull/3449)) **Full Changelog**: From 173e2ee5652f2a607133b83cf813ad7f0b9a176b Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Mon, 30 Dec 2024 21:55:30 +0800 Subject: [PATCH 20/28] Remove unimportant CI entries --- doc/changes.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index cd2162db18f..b30395de2ff 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -80,18 +80,11 @@ * Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) * clib.conversion: Remove the as_c_contiguous function and use np.ascontiguousarray instead ([#3492](https://github.com/GenericMappingTools/pygmt/pull/3492)) * Use TODO comments to track deprecations and workarounds ([#3722](https://github.com/GenericMappingTools/pygmt/pull/3722)) -* Pin numpy<2 in ci_tests_legacy.yaml ([#3641](https://github.com/GenericMappingTools/pygmt/pull/3641)) * Move Figure.psconvert into a separate file ([#3553](https://github.com/GenericMappingTools/pygmt/pull/3553)) * Improve the data type checking for 2-D arrays passed to the GMT C API ([#3563](https://github.com/GenericMappingTools/pygmt/pull/3563)) * Enable ruff's TD (flake8-todos), COM (flake8-commas), TRY (tryceratops), and EM (flake8-errmsg) rules ([#3723](https://github.com/GenericMappingTools/pygmt/pull/3723), [#3531](https://github.com/GenericMappingTools/pygmt/pull/3531), [#3665](https://github.com/GenericMappingTools/pygmt/pull/3665), [#3661](https://github.com/GenericMappingTools/pygmt/pull/3661)) -* CI: Use windows-2025 in the GMT Dev Tests workflow ([#3701](https://github.com/GenericMappingTools/pygmt/pull/3701)) -* CI: Test NumPy 2.2 in the GMT Tests workflow ([#3677](https://github.com/GenericMappingTools/pygmt/pull/3677)) -* CI: Run the 'GMT Tests' workflow on Python 3.10/3.12 with optional packages and Python 3.11 without optional packages ([#3618](https://github.com/GenericMappingTools/pygmt/pull/3618)) -* CI: Remove the pytest-xdist plugin from the "Tests" and "Dev Tests" workflows ([#3627](https://github.com/GenericMappingTools/pygmt/pull/3627)) -* CI: Pin to sphinx>=6.2 for docs build on Python 3.13 ([#3667](https://github.com/GenericMappingTools/pygmt/pull/3667)) * CI: Install pyarrow-core instead of pyarrow from conda-forge ([#3698](https://github.com/GenericMappingTools/pygmt/pull/3698)) * CI: Ensure no hyphens in Python file and directory names in the "Style Checks" workflow ([#3703](https://github.com/GenericMappingTools/pygmt/pull/3703)) -* CI: Add a separate CI job on Ubuntu to test geopandas v0.x ([#3420](https://github.com/GenericMappingTools/pygmt/pull/3420)) * Bump to ruff>=0.8.0 and rename rule TCH to TC ([#3662](https://github.com/GenericMappingTools/pygmt/pull/3662)) * Bump to Ghostscript 10.04.0 ([#3443](https://github.com/GenericMappingTools/pygmt/pull/3443)) * Add enums GridFormat for GMT grid format ID ([#3449](https://github.com/GenericMappingTools/pygmt/pull/3449)) From 9eda152a75fb5406f07b04a69c6ccc389a9d7d5b Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 04:20:00 +0800 Subject: [PATCH 21/28] Add the entry for load_earth_deflection --- doc/changes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/changes.md b/doc/changes.md index b30395de2ff..6d0c7c8637d 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -20,6 +20,7 @@ * Add load_earth_mean_sea_surface to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) * Add load_earth_mean_dynamic_topography to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) * Add load_earth_dist to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) +* Add load_earth_deflection to load "IGPP Earth east-west and north-south deflection" datasets ([#3728](https://github.com/GenericMappingTools/pygmt/pull/3728)) * load_earth_free_air_anomaly: Add "uncertainty" parameter to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) From 6fd6a464d5b22c2d39fd6a8e99d49abd1b32e841 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 04:20:22 +0800 Subject: [PATCH 22/28] Fix the entry for pre-conference workshop Co-authored-by: Michael Grund <23025878+michaelgrund@users.noreply.github.com> --- doc/changes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/changes.md b/doc/changes.md index 6d0c7c8637d..fa306c28822 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -68,7 +68,7 @@ * Update "PyData Ecosystem" to "Scientific Python Ecosystem" ([#3447](https://github.com/GenericMappingTools/pygmt/pull/3447)) * Figure.savefig: Clarify that 'transparent' also works for the PNG file associated with the KML format ([#3579](https://github.com/GenericMappingTools/pygmt/pull/3579)) * Add the PyGMT talk at AGU24 to the "Overview" section ([#3685](https://github.com/GenericMappingTools/pygmt/pull/3685)) -* Add the GMT/PyGMT preworkshop at AGU24 to the "External resources" section ([#3689](https://github.com/GenericMappingTools/pygmt/pull/3689)) +* Add the GMT/PyGMT pre-conference workshop at AGU24 to the "External resources" section ([#3689](https://github.com/GenericMappingTools/pygmt/pull/3689)) * Add TODO comments in the maintainers guides and update the release checklist ([#3724](https://github.com/GenericMappingTools/pygmt/pull/3724)) ### Maintenance From e69fb3f2906bd43c7509ed3c59585e953d5181d5 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 04:21:45 +0800 Subject: [PATCH 23/28] Move the 'Python 3.13 support' entry back to maintainence --- doc/changes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/changes.md b/doc/changes.md index fa306c28822..0e087cc3ce4 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -7,7 +7,6 @@ ### Highlights * 🎉 Fourteenth minor release of PyGMT 🎉 -* Support for Python 3.13 ([#3490](https://github.com/GenericMappingTools/pygmt/pull/3490)) * Bump minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) * Two new plotting methods and six new functions to access more GMT remote datasets @@ -75,6 +74,7 @@ * **Breaking**: data_kind: data is None and required now returns the 'empty' kind ([#3482](https://github.com/GenericMappingTools/pygmt/pull/3482)) * **Breaking**: data_kind: Now 'matrix' represents a 2-D numpy array and unrecognized data types fall back to 'vectors' ([#3351](https://github.com/GenericMappingTools/pygmt/pull/3351)) +* Add Support for Python 3.13 ([#3490](https://github.com/GenericMappingTools/pygmt/pull/3490)) * Add the Session.virtualfile_from_stringio method to allow StringIO input for certain functions/methods ([#3326](https://github.com/GenericMappingTools/pygmt/pull/3326)) * Add 'geodatasets' as a dependency for docs and update the choropleth example ([#3719](https://github.com/GenericMappingTools/pygmt/pull/3719)) * PyArrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) From 894fe933cc669c08dccda470a3a35125e838d787 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 04:27:52 +0800 Subject: [PATCH 24/28] Move Jing-Hui up for the AGU24 contribution --- CITATION.cff | 8 ++++---- README.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/CITATION.cff b/CITATION.cff index c23f001d60e..a18999e8f2d 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -40,14 +40,14 @@ authors: family-names: Yao affiliation: Nanyang Technological University, Singapore orcid: https://orcid.org/0000-0001-7036-4238 -- given-names: Yohai - family-names: Magen - affiliation: Tel Aviv University, Israel - orcid: https://orcid.org/0000-0002-4892-4013 - given-names: Jing-Hui family-names: Tong affiliation: National Taiwan Normal University, Taiwan orcid: https://orcid.org/0009-0002-7195-3071 +- given-names: Yohai + family-names: Magen + affiliation: Tel Aviv University, Israel + orcid: https://orcid.org/0000-0002-4892-4013 - given-names: Kathryn family-names: Materna affiliation: US Geological Survey, USA diff --git a/README.md b/README.md index 041c2cb3da9..edcf9959769 100644 --- a/README.md +++ b/README.md @@ -142,8 +142,8 @@ research using the following BibTeX: Jones, Max and Toney, Liam and Yao, Jiayuan and - Magen, Yohai and Tong, Jing-Hui and + Magen, Yohai and Materna, Kathryn and Belem, Andre and Newton, Tyler and From ad2ada9005a54ff5585370ff57230683ff10294b Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 04:57:33 +0800 Subject: [PATCH 25/28] Consistently use double quotes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com> --- doc/changes.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 0e087cc3ce4..f56b6c01a95 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -14,13 +14,13 @@ * Add Figure.hlines for plotting horizontal lines ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) * Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) -* Add load_blue_marble to load Blue Marble dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) -* Add load_black_marble to load Black Marble dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) +* Add load_blue_marble to load "Blue Marble" dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) +* Add load_black_marble to load "Black Marble" dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) * Add load_earth_mean_sea_surface to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) * Add load_earth_mean_dynamic_topography to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) * Add load_earth_dist to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) * Add load_earth_deflection to load "IGPP Earth east-west and north-south deflection" datasets ([#3728](https://github.com/GenericMappingTools/pygmt/pull/3728)) -* load_earth_free_air_anomaly: Add "uncertainty" parameter to load the "free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) +* load_earth_free_air_anomaly: Add "uncertainty" parameter to load the "IGPP Earth free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) ### Enhancements @@ -28,11 +28,11 @@ * Figure.plot: Add the "symbol" parameter to support plotting data points with varying symbols ([#1117](https://github.com/GenericMappingTools/pygmt/pull/1117)) * Figure.plot3d: Add the "symbol" parameter to support plotting data points with varying symbols ([#3559](https://github.com/GenericMappingTools/pygmt/pull/3559)) * Figure.legend: Support passing a StringIO object as the legend specification ([#3438](https://github.com/GenericMappingTools/pygmt/pull/3438)) -* load_tile_map: Add parameter 'crs' to set the CRS of the returned dataarray ([#3554](https://github.com/GenericMappingTools/pygmt/pull/3554)) +* load_tile_map: Add parameter "crs" to set the CRS of the returned dataarray ([#3554](https://github.com/GenericMappingTools/pygmt/pull/3554)) * PyArrow: Support pyarrow arrays with string/large_string/string_view types ([#3619](https://github.com/GenericMappingTools/pygmt/pull/3619)) * Support 1-D/2-D numpy arrays with longlong and ulonglong dtype ([#3566](https://github.com/GenericMappingTools/pygmt/pull/3566)) * GMT_IMAGE: Implement the to_dataarray method for 3-band images ([#3128](https://github.com/GenericMappingTools/pygmt/pull/3128)) -* Ensure non-ASCII characters are typeset correctly even if PS_CHAR_ENCODING is not 'ISOLatin1+' ([#3611](https://github.com/GenericMappingTools/pygmt/pull/3611)) +* Ensure non-ASCII characters are typeset correctly even if PS_CHAR_ENCODING is not "ISOLatin1+" ([#3611](https://github.com/GenericMappingTools/pygmt/pull/3611)) * Add enums GridRegistration and GridType for grid registration and type ([#3693](https://github.com/GenericMappingTools/pygmt/pull/3693)) * Add PyArrow as an optional dependency ([#3592](https://github.com/GenericMappingTools/pygmt/pull/3592)) @@ -48,7 +48,7 @@ * launch_external_viewer: Use full path when opening the file in a web browser ([#3647](https://github.com/GenericMappingTools/pygmt/pull/3647)) * PyArrow: Map date32[day]/date64[ms] dtypes in pandas objects to np.datetime64 with correct date/time units ([#3617](https://github.com/GenericMappingTools/pygmt/pull/3617)) * clib.session: Add the GMT_SESSION_NOGDALCLOSE flag to keep GDAL open ([#3672](https://github.com/GenericMappingTools/pygmt/pull/3672)) -* Set the 'Conventions' attribute to 'CF-1.7' for netCDF grids only ([#3463](https://github.com/GenericMappingTools/pygmt/pull/3463)) +* Set the "Conventions" attribute to "CF-1.7" for netCDF grids only ([#3463](https://github.com/GenericMappingTools/pygmt/pull/3463)) * Fix the conversion error for pandas.Series with missing values in pandas<=2.1 ([#3505](https://github.com/GenericMappingTools/pygmt/pull/3505), [#3596](https://github.com/GenericMappingTools/pygmt/pull/3596)) * GeoPandas: Explicitly convert columns with overflow integers to avoid OverflowError with fiona 1.10 ([#3455](https://github.com/GenericMappingTools/pygmt/pull/3455)) * Figure.plot/Figure.plot3d: Improve the check of the "style" parameter for "v" or "V" ([#3603](https://github.com/GenericMappingTools/pygmt/pull/3603)) @@ -65,18 +65,18 @@ * Document Continuous Benchmarking in Maintainers Guides ([#3631](https://github.com/GenericMappingTools/pygmt/pull/3631)) * Add instructions for installing optional dependencies ([#3506](https://github.com/GenericMappingTools/pygmt/pull/3506)) * Update "PyData Ecosystem" to "Scientific Python Ecosystem" ([#3447](https://github.com/GenericMappingTools/pygmt/pull/3447)) -* Figure.savefig: Clarify that 'transparent' also works for the PNG file associated with the KML format ([#3579](https://github.com/GenericMappingTools/pygmt/pull/3579)) +* Figure.savefig: Clarify that the "transparent" parameter also works for the PNG file associated with the KML format ([#3579](https://github.com/GenericMappingTools/pygmt/pull/3579)) * Add the PyGMT talk at AGU24 to the "Overview" section ([#3685](https://github.com/GenericMappingTools/pygmt/pull/3685)) * Add the GMT/PyGMT pre-conference workshop at AGU24 to the "External resources" section ([#3689](https://github.com/GenericMappingTools/pygmt/pull/3689)) * Add TODO comments in the maintainers guides and update the release checklist ([#3724](https://github.com/GenericMappingTools/pygmt/pull/3724)) ### Maintenance -* **Breaking**: data_kind: data is None and required now returns the 'empty' kind ([#3482](https://github.com/GenericMappingTools/pygmt/pull/3482)) -* **Breaking**: data_kind: Now 'matrix' represents a 2-D numpy array and unrecognized data types fall back to 'vectors' ([#3351](https://github.com/GenericMappingTools/pygmt/pull/3351)) +* **Breaking**: data_kind: data is None and required now returns the "empty" kind ([#3482](https://github.com/GenericMappingTools/pygmt/pull/3482)) +* **Breaking**: data_kind: Now "matrix" represents a 2-D numpy array and unrecognized data types fall back to "vectors" ([#3351](https://github.com/GenericMappingTools/pygmt/pull/3351)) * Add Support for Python 3.13 ([#3490](https://github.com/GenericMappingTools/pygmt/pull/3490)) * Add the Session.virtualfile_from_stringio method to allow StringIO input for certain functions/methods ([#3326](https://github.com/GenericMappingTools/pygmt/pull/3326)) -* Add 'geodatasets' as a dependency for docs and update the choropleth example ([#3719](https://github.com/GenericMappingTools/pygmt/pull/3719)) +* Add "geodatasets" as a dependency for docs and update the choropleth example ([#3719](https://github.com/GenericMappingTools/pygmt/pull/3719)) * PyArrow: Check compatibility of pyarrow.array with string type ([#2933](https://github.com/GenericMappingTools/pygmt/pull/2933)) * Rename sphinx-gallery's README.txt to GALLERY_HEADER.rst and require Sphinx-Gallery>=0.17.0 ([#3348](https://github.com/GenericMappingTools/pygmt/pull/3348)) * clib.conversion: Remove the as_c_contiguous function and use np.ascontiguousarray instead ([#3492](https://github.com/GenericMappingTools/pygmt/pull/3492)) From ee710e8e5ae566db11b579885cf85746461e1c4d Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 08:31:04 +0800 Subject: [PATCH 26/28] Sort entries for load_xxx function alphabetically --- doc/changes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index f56b6c01a95..574169ae50a 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -14,12 +14,12 @@ * Add Figure.hlines for plotting horizontal lines ([#923](https://github.com/GenericMappingTools/pygmt/pull/923)) * Add Figure.vlines for plotting vertical lines ([#3726](https://github.com/GenericMappingTools/pygmt/pull/3726)) -* Add load_blue_marble to load "Blue Marble" dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) * Add load_black_marble to load "Black Marble" dataset ([#3469](https://github.com/GenericMappingTools/pygmt/pull/3469)) -* Add load_earth_mean_sea_surface to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) -* Add load_earth_mean_dynamic_topography to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) -* Add load_earth_dist to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) +* Add load_blue_marble to load "Blue Marble" dataset ([#2235](https://github.com/GenericMappingTools/pygmt/pull/2235)) * Add load_earth_deflection to load "IGPP Earth east-west and north-south deflection" datasets ([#3728](https://github.com/GenericMappingTools/pygmt/pull/3728)) +* Add load_earth_dist to load "GSHHG Earth distance to shoreline" dataset ([#3706](https://github.com/GenericMappingTools/pygmt/pull/3706)) +* Add load_earth_mean_dynamic_topography to load "CNES Earth Mean Dynamic Topography" dataset ([#3718](https://github.com/GenericMappingTools/pygmt/pull/3718)) +* Add load_earth_mean_sea_surface to load "CNES Earth Mean Sea Surface" dataset ([#3717](https://github.com/GenericMappingTools/pygmt/pull/3717)) * load_earth_free_air_anomaly: Add "uncertainty" parameter to load the "IGPP Earth free-air anomaly uncertainty" dataset ([#3727](https://github.com/GenericMappingTools/pygmt/pull/3727)) From 2625479b48d8cc9a458023f34fee2c786b688582 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 15:30:34 +0800 Subject: [PATCH 27/28] Add pyarrow to highlight --- doc/changes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/changes.md b/doc/changes.md index 574169ae50a..29fb30ef89d 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -6,9 +6,10 @@ ### Highlights -* 🎉 Fourteenth minor release of PyGMT 🎉 +* 🎉 **Fourteenth minor release of PyGMT** 🎉 * Bump minimum supported version to GMT>=6.4.0 ([#3450](https://github.com/GenericMappingTools/pygmt/pull/3450)) * Two new plotting methods and six new functions to access more GMT remote datasets +* PyArrow as an optional dependency and improved support of PyArrow data types ([#3592](https://github.com/GenericMappingTools/pygmt/pull/3592)) ### New Features @@ -34,7 +35,6 @@ * GMT_IMAGE: Implement the to_dataarray method for 3-band images ([#3128](https://github.com/GenericMappingTools/pygmt/pull/3128)) * Ensure non-ASCII characters are typeset correctly even if PS_CHAR_ENCODING is not "ISOLatin1+" ([#3611](https://github.com/GenericMappingTools/pygmt/pull/3611)) * Add enums GridRegistration and GridType for grid registration and type ([#3693](https://github.com/GenericMappingTools/pygmt/pull/3693)) -* Add PyArrow as an optional dependency ([#3592](https://github.com/GenericMappingTools/pygmt/pull/3592)) ### Deprecations From 624a90fc33d72c9740169618bd78f6bb49a51432 Mon Sep 17 00:00:00 2001 From: Dongdong Tian Date: Tue, 31 Dec 2024 23:44:59 +0800 Subject: [PATCH 28/28] Add an entry for PR #3711 --- doc/changes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/changes.md b/doc/changes.md index 29fb30ef89d..21250127374 100644 --- a/doc/changes.md +++ b/doc/changes.md @@ -58,6 +58,7 @@ ### Documentation * Add basic tutorial "Plotting polygons" ([#3593](https://github.com/GenericMappingTools/pygmt/pull/3593)) +* Update the gallery example for plotting lines with LineString/MultiLineString geometry ([#3711](https://github.com/GenericMappingTools/pygmt/pull/3711)) * Add the PyGMT ecosystem page ([#3475](https://github.com/GenericMappingTools/pygmt/pull/3475)) * Document the support policy for optional packages ([#3616](https://github.com/GenericMappingTools/pygmt/pull/3616)) * Document the environment variables that can affect the behavior of PyGMT ([#3432](https://github.com/GenericMappingTools/pygmt/pull/3432))