Merge branch 'main' into grdview/surftype

seisman · seisman · commit 69c28ef542a0 · 2025-12-09T10:53:50.000+08:00
diff --git a/.github/ISSUE_TEMPLATE/3-module_request.md b/.github/ISSUE_TEMPLATE/3-module_request.md
@@ -14,14 +14,16 @@ labels: ["feature request"]
 - GMT.jl: https://www.generic-mapping-tools.org/GMTjl_doc/documentation/modules/<module>
 - PyGMT: https://www.pygmt.org/dev/api/generated/<wrapper>.html
 
-## GMT Option Flags and Modifieres
+## GMT Option Flags and Modifiers
 
 ☑️: *Implemented*; ⬜: *To be implemented/discussed*; ~~Strikethrough~~: *Won't implement*.
 
-- [ ] `-R`: `region` #XXX
-- [ ] `-J`: `projection` #XXX
+- [ ] `-B`: `frame`
+- [ ] `-J`: `projection`
+- [ ] `-R`: `region`
 - [ ] ...
 - [ ] ~~`-U`~~: Use `Figure.timestamp` instead.
+- [ ] `-V`: `verbose`
 - [ ] ~~`-X`/`-Y`~~: Use `Figure.shift_origin` instead.
 - [ ] ~~`--PAR=value`~~: Use `pygmt.config` instead.
 
@@ -31,7 +33,7 @@ labels: ["feature request"]
 
 ## Linked Pull Requests
 
-- [ ] Initial feature implementation #XXX
+- [ ] Initial feature implementation
 - [ ] Add a tutorial or gallery example
 
 ## Related Issues and Discussions
diff --git a/.github/workflows/benchmarks.yml b/.github/workflows/benchmarks.yml
@@ -36,7 +36,7 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
@@ -56,7 +56,7 @@ jobs:
           cache-environment-key: micromamba-environment-${{ steps.date.outputs.date }}
           create-args: >-
             gmt=6.6.0
-            python=3.13
+            python=3.14
             numpy
             pandas
             xarray
diff --git a/.github/workflows/cache_data.yaml b/.github/workflows/cache_data.yaml
@@ -38,7 +38,7 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
@@ -50,7 +50,7 @@ jobs:
         with:
           environment-name: pygmt
           create-args: >-
-            python=3.13
+            python=3.14
             gmt=6.6.0
             numpy
             pandas
diff --git a/.github/workflows/cache_dvc.yaml b/.github/workflows/cache_dvc.yaml
@@ -35,7 +35,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
diff --git a/.github/workflows/check-links.yml b/.github/workflows/check-links.yml
@@ -26,13 +26,13 @@ jobs:
 
     steps:
     - name: Checkout the repository
-      uses: actions/checkout@v5.0.1
+      uses: actions/checkout@v6.0.1
       with:
         path: repository
         persist-credentials: false
 
     - name: Checkout the documentation
-      uses: actions/checkout@v5.0.1
+      uses: actions/checkout@v6.0.1
       with:
         ref: gh-pages
         path: documentation
diff --git a/.github/workflows/ci_docs.yml b/.github/workflows/ci_docs.yml
@@ -72,7 +72,7 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
@@ -91,7 +91,7 @@ jobs:
           # environment cache is persistent for one week.
           cache-environment-key: micromamba-environment-${{ steps.date.outputs.date }}
           create-args: >-
-            python=3.13
+            python=3.14
             gmt=6.6.0
             ghostscript=10.06.0
             numpy
@@ -168,7 +168,7 @@ jobs:
           REF_NAME: ${{ github.ref_name }}
 
       - name: Checkout the gh-pages branch
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           ref: gh-pages
           # Checkout to this folder instead of the current one
diff --git a/.github/workflows/ci_doctests.yaml b/.github/workflows/ci_doctests.yaml
@@ -37,7 +37,7 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
@@ -49,7 +49,7 @@ jobs:
         with:
           environment-name: pygmt
           create-args: >-
-            python=3.13
+            python=3.14
             gmt=6.6.0
             numpy
             pandas
diff --git a/.github/workflows/ci_tests.yaml b/.github/workflows/ci_tests.yaml
@@ -56,7 +56,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.11', '3.13']
+        python-version: ['3.12', '3.14']
         os: [ubuntu-latest, ubuntu-24.04-arm, macos-latest, windows-latest]
         # Is it a draft Pull Request (true or false)?
         isDraft:
@@ -70,21 +70,21 @@ jobs:
           - os: windows-latest
             isDraft: true
         include:
-          # Python 3.11 + core packages (minimum supported versions) + optional packages (minimum supported versions if any)
-          - python-version: '3.11'
+          # Python 3.12 + core packages (minimum supported versions) + optional packages (minimum supported versions if any)
+          - python-version: '3.12'
             numpy-version: '2.0'
             pandas-version: '=2.2'
             xarray-version: '=2024.5'
             optional-packages: ' contextily geopandas ipython pyarrow-core rioxarray netCDF4 sphinx-gallery'
-          # Python 3.13 + core packages (latest versions) + optional packages
-          - python-version: '3.13'
+          # Python 3.14 + core packages (latest versions) + optional packages
+          - python-version: '3.14'
             numpy-version: '2.3'
             pandas-version: ''
             xarray-version: ''
             optional-packages: ' contextily geopandas ipython pyarrow-core rioxarray netCDF4 sphinx-gallery'
-          # Python 3.12 + core packages (Linux only)
+          # Python 3.13 + core packages (Linux only)
           - os: 'ubuntu-latest'
-            python-version: '3.12'
+            python-version: '3.13'
             numpy-version: ''
             pandas-version: ''
             xarray-version: ''
@@ -104,7 +104,7 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
diff --git a/.github/workflows/ci_tests_dev.yaml b/.github/workflows/ci_tests_dev.yaml
@@ -48,7 +48,7 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
@@ -67,7 +67,7 @@ jobs:
           # environment cache is persistent for one week.
           cache-environment-key: micromamba-environment-${{ steps.date.outputs.date }}
           create-args: >-
-            python=3.13
+            python=3.14
             cmake
             make
             ninja
@@ -94,7 +94,7 @@ jobs:
 
       # Checkout current GMT repository
       - name: Checkout the GMT source from ${{ matrix.gmt_git_ref }} branch
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           repository: 'GenericMappingTools/gmt'
           ref: ${{ matrix.gmt_git_ref }}
diff --git a/.github/workflows/ci_tests_legacy.yaml b/.github/workflows/ci_tests_legacy.yaml
@@ -46,7 +46,7 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
@@ -58,7 +58,7 @@ jobs:
         with:
           environment-name: pygmt
           create-args: >-
-            python=3.11
+            python=3.12
             gmt=${{ matrix.gmt_version }}
             ghostscript
             numpy=2.0
diff --git a/.github/workflows/dvc-diff.yml b/.github/workflows/dvc-diff.yml
@@ -25,7 +25,7 @@ jobs:
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v5.0.1
+      uses: actions/checkout@v6.0.1
       with:
         # fetch all history so that dvc diff works
         fetch-depth: 0
diff --git a/.github/workflows/format-command.yml b/.github/workflows/format-command.yml
@@ -24,23 +24,22 @@ jobs:
           private-key: ${{ secrets.APP_PRIVATE_KEY }}
 
       # Checkout the pull request branch
-      - uses: actions/checkout@v5.0.1
+      - uses: actions/checkout@v6.0.1
         with:
           token: ${{ steps.generate-token.outputs.token }}
           repository: ${{ github.event.client_payload.pull_request.head.repo.full_name }}
           ref: ${{ github.event.client_payload.pull_request.head.ref }}
           persist-credentials: true
 
       # Setup Python environment
-      - uses: actions/setup-python@v6.0.0
+      - name: Set up Python and install dependencies
+        uses: actions/setup-python@v6.1.0
         with:
-          python-version: '3.13'
+          python-version: '3.14'
+          pip-install: ruff prek
 
-      # Install formatting tools
-      - name: Install formatting tools
-        run: |
-          python -m pip install ruff prek
-          python -m pip list
+      - name: List installed packages
+        run: python -m pip list
 
       # Run "make format" and commit the change to the PR branch
       - name: Commit to the PR branch if any changes
diff --git a/.github/workflows/publish-to-pypi.yml b/.github/workflows/publish-to-pypi.yml
@@ -43,19 +43,17 @@ jobs:
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v5.0.1
+      uses: actions/checkout@v6.0.1
       with:
         # fetch all history so that setuptools-scm works
         fetch-depth: 0
         persist-credentials: false
 
-    - name: Set up Python
-      uses: actions/setup-python@v6.0.0
+    - name: Set up Python and install dependencies
+      uses: actions/setup-python@v6.1.0
       with:
-        python-version: '3.13'
-
-    - name: Install dependencies
-      run: python -m pip install build
+        python-version: '3.14'
+        pip-install: build
 
     # This step is only necessary for testing purposes and for TestPyPI
     - name: Fix up version string for TestPyPI
diff --git a/.github/workflows/release-baseline-images.yml b/.github/workflows/release-baseline-images.yml
@@ -23,7 +23,7 @@ jobs:
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v5.0.1
+      uses: actions/checkout@v6.0.1
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/style_checks.yaml b/.github/workflows/style_checks.yaml
@@ -26,20 +26,18 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           persist-credentials: false
 
-      # Setup Python
-      - name: Set up Python
-        uses: actions/setup-python@v6.0.0
+      - name: Set up Python and install dependencies
+        uses: actions/setup-python@v6.1.0
         with:
-          python-version: '3.13'
+          python-version: '3.14'
+          pip-install: ruff prek
 
-      - name: Install packages
-        run: |
-          python -m pip install ruff prek
-          python -m pip list
+      - name: List installed packages
+        run: python -m pip list
 
       - name: Formatting check (ruff + prek)
         run: |
diff --git a/.github/workflows/type_checks.yml b/.github/workflows/type_checks.yml
@@ -35,29 +35,25 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           persist-credentials: false
 
       # Setup Python
       - name: Set up Python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
-          python-version: '3.13'
-
-      - name: Install packages
-        run: |
-          # Need to install four groups of packages:
+          python-version: '3.14'
+          # Need to install following packages:
           # 1. required packages
-          # 2. optional packages
-          # 3. type checker and stub packages
-          # 4. other packages that are used somewhere in PyGMT
-          python -m pip install \
-            numpy pandas xarray packaging \
-            contextily geopandas ipython pyarrow rioxarray \
-            mypy pandas-stubs pyarrow-stubs \
-            matplotlib pytest
-          python -m pip list
+          # 2. type checker and stub packages
+          # 3. other packages that are used somewhere in PyGMT
+          pip-install: |
+            numpy pandas xarray packaging
+            mypy pandas-stubs pyarrow-stubs
+
+      - name: List install packages
+        run: python -m pip list
 
       - name: Static type check
         run: make typecheck
diff --git a/ci/requirements/docs.yml b/ci/requirements/docs.yml
@@ -4,7 +4,7 @@ channels:
     - nodefaults
 dependencies:
     # Required dependencies
-    - python=3.13
+    - python=3.14
     - gmt=6.6.0
     - ghostscript=10.06.0
     - numpy
diff --git a/doc/install.md b/doc/install.md
@@ -127,14 +127,14 @@ installed (we'll call it `pygmt` but feel free to change it to whatever you want
 ::: {tab-item} mamba
 :sync: mamba
 ```
-mamba create --name pygmt python=3.13 numpy pandas xarray packaging gmt
+mamba create --name pygmt python=3.14 numpy pandas xarray packaging gmt
 ```
 :::
 
 ::: {tab-item} conda
 :sync: conda
 ```
-conda create --name pygmt python=3.13 numpy pandas xarray packaging gmt
+conda create --name pygmt python=3.14 numpy pandas xarray packaging gmt
 ```
 :::
 ::::
diff --git a/environment.yml b/environment.yml
diff --git a/pygmt/src/coast.py b/pygmt/src/coast.py
diff --git a/pygmt/src/colorbar.py b/pygmt/src/colorbar.py
diff --git a/pygmt/src/legend.py b/pygmt/src/legend.py
diff --git a/pygmt/src/shift_origin.py b/pygmt/src/shift_origin.py
diff --git a/pygmt/tests/test_legend.py b/pygmt/tests/test_legend.py
diff --git a/pyproject.toml b/pyproject.toml
