Merge branch 'pygmtlogo-font' into pygmtlogo-wordmark-vertical

seisman · web-flow · commit 05c862b34c25 · 2026-05-23T12:58:27.000+08:00
diff --git a/.github/release-drafter.yml b/.github/release-drafter.yml
@@ -22,6 +22,8 @@ exclude-labels:
   - 'skip-changelog'
 exclude-contributors:
   - 'actions-bot'
+  - 'Copilot'
+  - 'copilot-swe-agent[bot]'
   - 'dependabot'
   - 'dependabot[bot]'
 category-template: '### $TITLE'
diff --git a/.github/workflows/benchmarks.yml b/.github/workflows/benchmarks.yml
@@ -84,7 +84,7 @@ jobs:
 
       # Run the benchmark tests
       - name: Run benchmarks
-        uses: CodSpeedHQ/action@c381be0bfd20e844fb45594f6aa182ffcd94545c # v4.15.0
+        uses: CodSpeedHQ/action@3194d9a39c4d46684cb44bf7207fc56626aad8fd # v4.15.1
         with:
           mode: "instrumentation"
           # 'bash -el -c' is needed to use the custom shell.
diff --git a/.github/workflows/ci_docs.yml b/.github/workflows/ci_docs.yml
@@ -93,7 +93,7 @@ jobs:
           create-args: >-
             python=3.14
             gmt=6.6.0
-            ghostscript=10.07.0
+            ghostscript=10.07.1
             numpy
             pandas
             xarray
diff --git a/.github/workflows/ci_tests.yaml b/.github/workflows/ci_tests.yaml
@@ -75,9 +75,9 @@ jobs:
         include:
           # 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'
+            numpy-version: '2.1'
+            pandas-version: '=2.3'
+            xarray-version: '=2024.7'
             optional-packages: ' contextily geopandas ipython pyarrow-core rioxarray netCDF4 sphinx-gallery'
           # Python 3.14 + core packages (latest versions) + optional packages
           - python-version: '3.14'
@@ -128,7 +128,7 @@ jobs:
           create-args: >-
             python=${{ matrix.python-version }}${{ matrix.optional-packages }}
             gmt=6.6.0
-            ghostscript=10.07.0
+            ghostscript=10.07.1
             numpy=${{ matrix.numpy-version }}
             pandas${{ matrix.pandas-version }}
             xarray${{ matrix.xarray-version }}
diff --git a/.github/workflows/ci_tests_dev.yaml b/.github/workflows/ci_tests_dev.yaml
@@ -74,7 +74,7 @@ jobs:
             ninja
             curl
             fftw
-            ghostscript=10.07.0
+            ghostscript=10.07.1
             glib
             hdf5
             libblas
diff --git a/.github/workflows/ci_tests_legacy.yaml b/.github/workflows/ci_tests_legacy.yaml
@@ -61,9 +61,9 @@ jobs:
             python=3.12
             gmt=${{ matrix.gmt_version }}
             ghostscript
-            numpy=2.0
-            pandas=2.2
-            xarray=2024.5
+            numpy=2.1
+            pandas=2.3
+            xarray=2024.7
             packaging=24.2
             contextily=1.5
             geopandas=1.0
diff --git a/.github/workflows/format-command.yml b/.github/workflows/format-command.yml
@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-slim
     steps:
       # Generate token from GenericMappingTools bot
-      - uses: actions/create-github-app-token@1b10c78c7865c340bc4f6099eb2f838309f1e8c3 # v3.1.1
+      - uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
         id: generate-token
         with:
           client-id: ${{ vars.CLIENT_ID }}
diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
@@ -20,6 +20,6 @@ jobs:
     if: github.repository == 'GenericMappingTools/pygmt'
 
     steps:
-      - uses: release-drafter/release-drafter@5de93583980a40bd78603b6dfdcda5b4df377b32 # v7.2.0
+      - uses: release-drafter/release-drafter@563bf132657a13ded0b01fcb723c5a58cdd824e2 # v7.2.1
         with:
           config-name: release-drafter.yml
diff --git a/AUTHORS.md b/AUTHORS.md
@@ -1,11 +1,6 @@
-# Project Contributors
+# PyGMT Developers
 
-This project was started in 2017 by [Leonardo Uieda](https://www.leouieda.com)
-during [an NSF funded postdoc](https://www.leouieda.com/blog/hawaii-gmt-postdoc)
-with [Paul Wessel](https://en.wikipedia.org/wiki/Pål_Wessel) at the University of
-Hawaiʻi at Mānoa.
-
-The following people have contributed code and/or documentation to the project
+The following people have contributed code and/or documentation to the PyGMT project
 (alphabetically by name) and are considered to be "PyGMT Developers":
 
 | Name | ORCID | Affiliation |
@@ -28,6 +23,3 @@ The following people have contributed code and/or documentation to the project
 | [Xingchen He](https://github.com/Chuan1937) | [0009-0004-7182-2252](https://orcid.org/0009-0004-7182-2252) | Chengdu University of Technology, China |
 | [Yohai Magen](https://github.com/yohaimagen) | [0000-0002-4892-4013](https://orcid.org/0000-0002-4892-4013) | Tel Aviv University, Israel |
 | [Yvonne Fröhlich](https://github.com/yvonnefroehlich) | [0000-0002-8566-0619](https://orcid.org/0000-0002-8566-0619) | Unaffiliated |
-
-Individuals who have made significant contributions to PyGMT are recognized on the
-[PyGMT Team](https://www.pygmt.org/dev/team.html) page.
diff --git a/AUTHORSHIP.md b/AUTHORSHIP.md
@@ -10,14 +10,27 @@ contributors for their work. To do so, we will attempt to define:
 
 The following are the ways in which individuals who have contributed will be recognized.
 
-> **Note**: These policies are not set in stone and may be changed to accommodate the
-> growth of the project or the preferences of the community.
+> **Notes**:
+>
+> 1. These policies are not set in stone and may be changed to accommodate the growth of
+>    the project or the preferences of the community.
+> 2. Authorship and contributor recognition apply to human contributors. Bots, automated
+>    accounts, and AI tools are not considered as authors. If these tools assist with a
+>    contribution, the recognized author is the human who reviews and submits the work.
 
 ## The `AUTHORS.md` file
 
-Anyone who has contributed a pull request to the project is welcome to add themselves to
-the `AUTHORS.md` file. This file lives in the repository and is packaged with
-distributions. This is an optional process.
+The `AUTHORS.md` file lists PyGMT Developers. Anyone who has contributed a pull request
+to the project is welcome to add themselves to the file. This file lives in the
+repository and is packaged with distributions. This is an optional process.
+
+## The PyGMT Team
+
+[The PyGMT Team](https://github.com/GenericMappingTools/pygmt/blob/main/doc/team.md) is
+a group of individuals who maintain the PyGMT project, make decisions about the
+direction of the project, and manage release cycles. The team also includes
+distinguished contributors who have made significant contributions to the project in
+many ways in the project's history.
 
 ## Changelog for each release
 
diff --git a/ci/requirements/docs.yml b/ci/requirements/docs.yml
@@ -6,7 +6,7 @@ dependencies:
     # Required dependencies
     - python=3.14
     - gmt=6.6.0
-    - ghostscript=10.07.0
+    - ghostscript=10.07.1
     - numpy
     - pandas
     - xarray
diff --git a/doc/_static/style.css b/doc/_static/style.css
@@ -162,6 +162,18 @@ html.writer-html5 .rst-content dl.field-list {
     max-width: 80%!important;
 }
 
+.sphx-glr-tag-label {
+    font-weight: bold;
+    background-color: #f2f3f5;
+    padding: 0.1rem 0.35rem;
+}
+
+.sphx-glr-tag {
+    background-color: #e6eef8;
+    margin: 0.1rem 0.2rem 0.1rem 0;
+    padding: 0.1rem 0.35rem;
+}
+
 /*
  * Styles for aligning table cells.
  * https://myst-parser.readthedocs.io/en/latest/syntax/tables.html#markdown-syntax
diff --git a/environment.yml b/environment.yml
@@ -6,10 +6,10 @@ dependencies:
     - python>=3.12
     # Required dependencies
     - gmt=6.6.0
-    - ghostscript=10.07.0
-    - numpy>=2.0
-    - pandas>=2.2
-    - xarray>=2024.5
+    - ghostscript=10.07.1
+    - numpy>=2.1
+    - pandas>=2.3
+    - xarray>=2024.7
     - packaging>=24.2
     # Optional dependencies
     - contextily>=1.5
@@ -41,7 +41,7 @@ dependencies:
     - sphinx-autodoc-typehints
     - sphinx-copybutton
     - sphinx-design
-    - sphinx-gallery>=0.19.0
+    - sphinx-gallery>=0.21.0
     - sphinx_rtd_theme
     # Dev dependencies (building PDF documentation)
     - cairosvg
diff --git a/examples/projections/azim/azim_equidistant.py b/examples/projections/azim/azim_equidistant.py
@@ -31,3 +31,5 @@
     water="white",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equidistant"]
diff --git a/examples/projections/azim/azim_general_stereographic.py b/examples/projections/azim/azim_general_stereographic.py
@@ -31,3 +31,5 @@
     water="white",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["conformal"]
diff --git a/examples/projections/azim/azim_lambert.py b/examples/projections/azim/azim_lambert.py
@@ -29,3 +29,5 @@
     water="white",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/examples/projections/conic/conic_albers.py b/examples/projections/conic/conic_albers.py
@@ -34,3 +34,5 @@
     water="gray90",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/examples/projections/conic/conic_equidistant.py b/examples/projections/conic/conic_equidistant.py
@@ -28,3 +28,5 @@
     water="gray90",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equidistant"]
diff --git a/examples/projections/conic/conic_lambert.py b/examples/projections/conic/conic_lambert.py
@@ -30,5 +30,6 @@
     land="seagreen",
     water="gray90",
 )
-
 fig.show()
+
+# sphinx_gallery_tags = ["conformal"]
diff --git a/examples/projections/cyl/cyl_equal_area.py b/examples/projections/cyl/cyl_equal_area.py
@@ -26,3 +26,5 @@
     water="steelblue",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/examples/projections/cyl/cyl_equidistant.py b/examples/projections/cyl/cyl_equidistant.py
@@ -30,3 +30,5 @@
     water="steelblue",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equidistant"]
diff --git a/examples/projections/cyl/cyl_mercator.py b/examples/projections/cyl/cyl_mercator.py
@@ -33,3 +33,5 @@
     water="steelblue",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["conformal"]
diff --git a/examples/projections/cyl/cyl_oblique_mercator.py b/examples/projections/cyl/cyl_oblique_mercator.py
@@ -78,3 +78,4 @@
 fig.show()
 
 # sphinx_gallery_thumbnail_number = 3
+# sphinx_gallery_tags = ["conformal"]
diff --git a/examples/projections/cyl/cyl_transverse_mercator.py b/examples/projections/cyl/cyl_transverse_mercator.py
@@ -29,3 +29,5 @@
     water="steelblue",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["conformal"]
diff --git a/examples/projections/cyl/cyl_universal_transverse_mercator.py b/examples/projections/cyl/cyl_universal_transverse_mercator.py
@@ -50,3 +50,5 @@
     water="steelblue",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["conformal"]
diff --git a/examples/projections/misc/misc_eckertIV.py b/examples/projections/misc/misc_eckertIV.py
@@ -27,3 +27,5 @@
     water="bisque4",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/examples/projections/misc/misc_eckertVI.py b/examples/projections/misc/misc_eckertVI.py
@@ -28,3 +28,5 @@
     water="bisque4",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/examples/projections/misc/misc_hammer.py b/examples/projections/misc/misc_hammer.py
@@ -28,3 +28,5 @@
     water="bisque4",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/examples/projections/misc/misc_mollweide.py b/examples/projections/misc/misc_mollweide.py
@@ -29,3 +29,5 @@
     water="bisque4",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/examples/projections/misc/misc_sinusoidal.py b/examples/projections/misc/misc_sinusoidal.py
@@ -29,3 +29,5 @@
     water="bisque4",
 )
 fig.show()
+
+# sphinx_gallery_tags = ["equal-area"]
diff --git a/pygmt/params/position.py b/pygmt/params/position.py
@@ -186,6 +186,18 @@ def _validate(self):
                         description="reference point",
                         reason="Expect a valid 2-character justification code.",
                     )
+            case _:
+                raise GMTValueError(
+                    self.cstype,
+                    description="cstype",
+                    choices=[
+                        "mapcoords",
+                        "plotcoords",
+                        "boxcoords",
+                        "inside",
+                        "outside",
+                    ],
+                )
         # Validate the anchor if specified.
         if self.anchor is not None and self.anchor not in _valid_anchors:
             raise GMTValueError(
diff --git a/pygmt/src/basemap.py b/pygmt/src/basemap.py
@@ -123,6 +123,13 @@ def basemap(  # noqa: PLR0913
     $coltypes
     $perspective
     $transparency
+
+    Examples
+    --------
+    >>> import pygmt
+    >>> fig = pygmt.Figure()
+    >>> fig.basemap(region="g", projection="H15c", frame=True)
+    >>> fig.show()
     """
     self._activate_figure()
 
diff --git a/pygmt/src/subplot.py b/pygmt/src/subplot.py
@@ -419,13 +419,11 @@ def set_panel(
     aliasdict = AliasSystem(A=Alias(tag, name="tag")).add_common(V=verbose)
     aliasdict.merge(kwargs)
 
+    args = ["set"]
+    if panel is not None:
+        args.append(Alias(panel, name="panel", sep=",", size=2)._value)  # type: ignore[arg-type]
+    args.extend(build_arg_list(aliasdict))
+
     with Session() as lib:
-        lib.call_module(
-            module="subplot",
-            args=[
-                "set",
-                Alias(panel, name="panel", sep=",", size=2)._value,
-                *build_arg_list(aliasdict),
-            ],
-        )
+        lib.call_module(module="subplot", args=args)
         yield
diff --git a/pygmt/tests/test_params_position.py b/pygmt/tests/test_params_position.py
@@ -37,6 +37,8 @@ def test_params_position_invalid_location():
     """
     Test that invalid location inputs raise GMTValueError.
     """
+    with pytest.raises(GMTValueError):
+        Position((1, 2), cstype="invalid")
     with pytest.raises(GMTValueError):
         Position("invalid", cstype="mapcoords")
     with pytest.raises(GMTValueError):
diff --git a/pygmt/tests/test_subplot.py b/pygmt/tests/test_subplot.py
@@ -132,6 +132,25 @@ def test_subplot_outside_plotting_positioning():
     return fig
 
 
+@pytest.mark.mpl_image_compare(filename="test_subplot_basic_frame.png")
+def test_subplot_set_panel_without_panel():
+    """
+    Ensure Figure.set_panel works when panel is omitted.
+
+    Omitting ``panel`` should let GMT advance to the next panel according to the subplot
+    order instead of passing an invalid ``None`` argument to the C API.
+
+    Use the baseline image from test_subplot_basic_frame.
+    """
+    fig = Figure()
+    with fig.subplot(nrows=1, ncols=2, figsize=("6c", "3c"), frame=Frame(axes="WSne")):
+        with fig.set_panel():
+            fig.basemap(region=[0, 3, 0, 3], frame=Frame(title="plot0"))
+        with fig.set_panel():
+            fig.basemap(region=[0, 3, 0, 3], frame=Frame(title="plot1"))
+    return fig
+
+
 def test_subplot_deprecated_autolabel():
     """
     Test that using the deprecated autolabel parameter raises a warning when conflicted
diff --git a/pyproject.toml b/pyproject.toml
@@ -35,9 +35,9 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
-    "numpy>=2.0",
-    "pandas>=2.2",
-    "xarray>=2024.5",
+    "numpy>=2.1",
+    "pandas>=2.3",
+    "xarray>=2024.7",
     "packaging>=24.2",
 ]
 dynamic = ["version"]
