Merge branch 'main' into tilemap

Author: weiji14

.github/ISSUE_TEMPLATE/bump_gmt_checklist.md

@@ -10,7 +10,7 @@ assignees: ''
 :tada: [GMT X.Y.Z](https://github.com/GenericMappingTools/gmt/releases/tag/X.Y.Z) has been released! It is installable from the
 [conda-forge channel](https://anaconda.org/conda-forge/gmt/files) using the following command:
 
-`conda install -c conda-forge gmt=X.Y.Z`
+`mamba install -c conda-forge gmt=X.Y.Z`
 
 <!-- Please add specific checklist items for the tests, xfail pytest markers, and deprecated syntax that need to be updated. -->
 

.github/ISSUE_TEMPLATE/release_checklist.md

@@ -16,7 +16,10 @@ assignees: ''
 - [ ] Wrap Y ()
 
 **Before release**:
-- [ ] Run `grep --include="*.py" -r 'remove_version="vX.Y.Z"' pygmt` from the base of the repository to check if any deprecations and related tests should be removed in this version
+- [ ] Check to ensure that:
+  - [ ] All tests pass in the ["GMT Legacy Tests" workflow](https://github.com/GenericMappingTools/pygmt/actions/workflows/ci_tests_legacy.yaml)
+  - [ ] All tests pass in the ["GMT Dev Tests" workflow](https://github.com/GenericMappingTools/pygmt/actions/workflows/ci_tests_dev.yaml)
+  - [ ] Deprecations and related tests are removed for this version by running `grep --include="*.py" -r 'remove_version="vX.Y.Z"' pygmt` from the base of the repository
 - [ ] Reserve a DOI on [Zenodo](https://zenodo.org) by clicking on "New Version"
 - [ ] Finish up 'Changelog entry for v0.x.x' Pull Request:
   - [ ] Add a new entry in `doc/_static/version_switch.js` for documentation switcher

.github/workflows/publish-to-pypi.yml

@@ -53,13 +53,13 @@ jobs:
         ls -lh dist/
 
     - name: Publish to Test PyPI
-      uses: pypa/gh-action-pypi-publish@v1.6.4
+      uses: pypa/gh-action-pypi-publish@v1.7.1
       with:
         password: ${{ secrets.TEST_PYPI_API_TOKEN }}
-        repository_url: https://test.pypi.org/legacy/
+        repository-url: https://test.pypi.org/legacy/
 
     - name: Publish to PyPI
       if: startsWith(github.ref, 'refs/tags')
-      uses: pypa/gh-action-pypi-publish@v1.6.4
+      uses: pypa/gh-action-pypi-publish@v1.7.1
       with:
         password: ${{ secrets.PYPI_API_TOKEN }}

.github/workflows/release-baseline-images.yml

@@ -34,7 +34,7 @@ jobs:
         shasum -a 256 baseline-images.zip
 
     - name: Upload baseline image as a release asset
-      uses: shogo82148/[email protected].3
+      uses: shogo82148/[email protected].4
       with:
         upload_url: ${{ github.event.release.upload_url }}
         asset_path: baseline-images.zip

.github/workflows/style_checks.yaml

@@ -18,7 +18,7 @@ jobs:
       - name: Checkout
         uses: actions/[email protected]
 
-      # Setup Miniconda
+      # Setup Python
       - name: Set up Python
         uses: actions/[email protected]
         with:

AUTHORS.md

@@ -13,6 +13,7 @@ The following people have contributed code and/or documentation to the project
 * [Dongdong Tian](https://seisman.info/) | [0000-0001-7967-1197](https://orcid.org/0000-0001-7967-1197) | China University of Geosciences, China
 * [Jamie Quinn](http://jamiejquinn.com) | [0000-0002-0268-7032](https://orcid.org/0000-0002-0268-7032) | University College London, United Kingdom
 * [Jiayuan Yao](https://github.com/core-man) | [0000-0001-7036-4238](https://orcid.org/0000-0001-7036-4238) | Nanyang Technological University, Singapore
+* [Jing-Hui Tong](https://github.com/JingHuiTong) | [0009-0002-7195-3071](https://orcid.org/0009-0002-7195-3071) | National Taiwan Normal University, Taiwan
 * [Kathryn Materna](https://github.com/kmaterna) | [0000-0002-6687-980X](https://orcid.org/0000-0002-6687-980X) | US Geological Survey, USA
 * [Leonardo Uieda](http://www.leouieda.com/) | [0000-0001-6123-9515](https://orcid.org/0000-0001-6123-9515) | University of Liverpool, United Kingdom
 * [Liam Toney](https://liam.earth/) | [0000-0003-0167-9433](https://orcid.org/0000-0003-0167-9433) | University of Alaska Fairbanks, USA

Makefile

@@ -26,7 +26,7 @@ install:
 	pip install --no-deps -e .
 
 package:
-	python -m build --sdist --wheel
+	python -m build
 
 test:
 	# Run a tmp folder to make sure the tests are run on the installed version

README.rst

@@ -92,13 +92,13 @@ Quickstart
 Installation
 ++++++++++++
 
-Simple installation using `conda <https://docs.conda.io/projects/conda/en/latest/user-guide/index.html>`__::
+Simple installation using `mamba <https://mamba.readthedocs.org/>`__::
 
-    conda install --channel conda-forge pygmt
+    mamba install --channel conda-forge pygmt
 
-If you use `mamba <https://mamba.readthedocs.org/>`__::
+If you use `conda <https://docs.conda.io/projects/conda/en/latest/user-guide/index.html>`__::
 
-    mamba install --channel conda-forge pygmt
+    conda install --channel conda-forge pygmt
 
 For other ways to install ``pygmt``, see `full installation instructions <https://www.pygmt.org/latest/install.html>`__.
 

doc/contributing.md

@@ -190,7 +190,7 @@ We highly recommend using [Mambaforge](https://github.com/conda-forge/miniforge#
 and the `mamba` package manager to install and manage your Python packages.
 It will make your life a lot easier!
 
-The repository includes a conda environment file `environment.yml` with the
+The repository includes a virtual environment file `environment.yml` with the
 specification for all development requirements to build and test the project.
 In particular, these are some of the key development dependencies you will need
 to install to build the documentation and run the unit tests locally:

doc/install.rst

@@ -116,15 +116,15 @@ Installing GMT and other dependencies
 Before installing PyGMT, we must install GMT itself along with the other
 dependencies. The easiest way to do this is via the ``mamba`` or ``conda`` package manager.
 We recommend working in an isolated
-`conda environment <https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html>`__
+`virtual environment <https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html>`__
 to avoid issues with conflicting versions of dependencies.
 
 First, we must configure conda to get packages from the
 `conda-forge channel <https://conda-forge.org/>`__::
 
     conda config --prepend channels conda-forge
 
-Now we can create a new conda environment with Python and all our dependencies
+Now we can create a new virtual environment with Python and all our dependencies
 installed (we'll call it ``pygmt`` but feel free to change it to whatever you
 want):
 
@@ -135,14 +135,14 @@ want):
 
         ::
 
-            mamba create --name pygmt python=3.9 numpy pandas xarray netcdf4 packaging gmt
+            mamba create --name pygmt python=3.11 numpy pandas xarray netcdf4 packaging gmt
 
     .. tab-item:: conda
         :sync: conda
 
         ::
 
-            conda create --name pygmt python=3.9 numpy pandas xarray netcdf4 packaging gmt
+            conda create --name pygmt python=3.11 numpy pandas xarray netcdf4 packaging gmt
 
 Activate the environment by running the following (**do not forget this step!**):
 
@@ -162,17 +162,17 @@ Activate the environment by running the following (**do not forget this step!**)
 
             conda activate pygmt
 
-From now on, all commands will take place inside the conda virtual environment
-called ``pygmt`` and won't affect your default ``base`` installation.
+From now on, all commands will take place inside the virtual environment called
+``pygmt`` and won't affect your default ``base`` installation.
 
 
 Installing PyGMT
 ----------------
 
-Now that you have GMT installed and your conda virtual environment activated,
-you can install PyGMT using any of the following methods:
+Now that you have GMT installed and your virtual environment activated, you can
+install PyGMT using any of the following methods:
 
-Using conda/mamba (recommended)
+Using mamba/conda (recommended)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This installs the latest stable release of PyGMT from
@@ -233,9 +233,8 @@ Alternatively, you can install the latest development version from
 To upgrade the installed stable release or development version to be the latest
 one, just add ``--upgrade`` to the corresponding command above.
 
-Any of the above methods (conda/pip) should allow you to use the PyGMT package
-from Python.
-
+Any of the above methods (mamba/conda/pip) should allow you to use the PyGMT
+package from Python.
 
 Testing your install
 --------------------
@@ -268,7 +267,7 @@ respectively.
 For Linux/macOS, add the following line to your shell configuration file
 (usually ``~/.bashrc`` for Bash on Linux and ``~/.zshrc`` for Zsh on macOS)::
 
-    export GMT_LIBRARY_PATH=$HOME/anaconda3/envs/pygmt/lib
+    export GMT_LIBRARY_PATH=$HOME/mambaforge/envs/pygmt/lib
 
 For Windows, add the ``GMT_LIBRARY_PATH`` environment variable following these
 `instructions <https://www.wikihow.com/Create-an-Environment-Variable-in-Windows-10>`__
@@ -281,10 +280,10 @@ Notes for Jupyter users
 
 If you can successfully import pygmt in a Python interpreter or IPython, but
 get a ``ModuleNotFoundError`` when importing pygmt in Jupyter, you may need to
-install a ``pygmt`` kernel following the commands below::
+activate your ``pygmt`` virtual environment (using ``mamba activate pygmt`` or
+``conda activate pygmt``) and install a ``pygmt`` kernel following the commands below::
 
-    conda activate pygmt
-    python -m ipykernel install --user --name pygmt  # install conda environment properly
+    python -m ipykernel install --user --name pygmt  # install virtual environment properly
     jupyter kernelspec list --json
 
 After that, you need to restart Jupyter, open your notebook, select the