SPEC 0: Set minimum supported versions to pandas>=1.5 and xarray>=2022.03

.github/workflows/ci_tests.yaml

@@ -62,14 +62,19 @@ jobs:
             isDraft: true
           - os: windows-latest
             isDraft: true
-        # Pair Python 3.10 with NumPy 1.23 and Python 3.12 with NumPy 1.26
-        # Only install optional packages on Python 3.12/NumPy 1.26
+        # Pair Python 3.10 with the minimum supported versions of NumPy/Pandas/Xarray
+        # and Python 3.12 with the latest versions of NumPy/Pandas/Xarray
+        # Only install optional packages on Python 3.12
         include:
           - python-version: '3.10'
             numpy-version: '1.23'
+            pandas-version: '=1.5'
+            xarray-version: '=2022.03'
             optional-packages: ''
           - python-version: '3.12'
             numpy-version: '1.26'
+            pandas-version: ''
+            xarray-version: ''
             optional-packages: ' contextily geopandas ipython pyarrow rioxarray sphinx-gallery'
 
     timeout-minutes: 30
@@ -107,8 +112,8 @@ jobs:
             gmt=6.5.0
             ghostscript=10.02.1
             numpy=${{ matrix.numpy-version }}
-            pandas
-            xarray
+            pandas${{ matrix.pandas-version }}
+            xarray${{ matrix.xarray-version }}
             netCDF4
             packaging
             build

doc/minversions.rst

@@ -8,101 +8,123 @@ the rest of the Scientific Python ecosystem, and therefore:
 * Support for core package dependencies (NumPy/Pandas/Xarray) be dropped 2 years after their initial release.
 
 .. list-table::
-    :widths: 25 30 15 20 15
+    :widths: 25 15 15 15 15 15
     :header-rows: 1
+    :align: center
 
     * - PyGMT Version
-      - Documentation
       - GMT
       - Python
       - NumPy
-    * - `Dev <https://github.com/GenericMappingTools/pygmt/milestones>`_ (upcoming release)
-      - `Dev Documentation <https://www.pygmt.org/dev>`_ (reflects `main branch <https://github.com/GenericMappingTools/pygmt>`_)
+      - Pandas
+      - Xarray
+    * - `Dev <https://github.com/GenericMappingTools/pygmt/milestones>`_ * [`Docs <https://www.pygmt.org/dev>`__]
       - >=6.3.0
       - >=3.10
       - >=1.23
-    * - `v0.11.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.11.0>`_ (latest release)
-      - `v0.11.0 Documentation <https://www.pygmt.org/v0.11.0>`_
+      - >=1.5
+      - >=2022.03
+    * - `v0.11.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.11.0>`_ [`Docs <https://www.pygmt.org/v0.11.0>`__]
       - >=6.3.0
       - >=3.9
       - >=1.23
-    * - `v0.10.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.10.0>`_
-      - `v0.10.0 Documentation <https://www.pygmt.org/v0.10.0>`_
+      -
+      -
+    * - `v0.10.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.10.0>`_ [`Docs <https://www.pygmt.org/v0.10.0>`__]
       - >=6.3.0
       - >=3.9
       - >=1.22
-    * - `v0.9.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.9.0>`_
-      - `v0.9.0 Documentation <https://www.pygmt.org/v0.9.0>`_
+      -
+      -
+    * - `v0.9.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.9.0>`_ [`Docs <https://www.pygmt.org/v0.9.0>`__]
       - >=6.3.0
       - >=3.8
       - >=1.21
-    * - `v0.8.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.8.0>`_
-      - `v0.8.0 Documentation <https://www.pygmt.org/v0.8.0>`_
+      -
+      -
+    * - `v0.8.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.8.0>`_ [`Docs <https://www.pygmt.org/v0.8.0>`__]
       - >=6.3.0
       - >=3.8
       - >=1.20
-    * - `v0.7.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.7.0>`_
-      - `v0.7.0 Documentation <https://www.pygmt.org/v0.7.0>`_
+      -
+      -
+    * - `v0.7.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.7.0>`_ [`Docs <https://www.pygmt.org/v0.7.0>`__]
       - >=6.3.0
       - >=3.8
       - >=1.20
-    * - `v0.6.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.6.1>`_
-      - `v0.6.1 Documentation <https://www.pygmt.org/v0.6.1>`_
+      -
+      -
+    * - `v0.6.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.6.1>`_ [`Docs <https://www.pygmt.org/v0.6.1>`__]
       - >=6.3.0
       - >=3.8
       - >=1.19
-    * - `v0.6.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.6.0>`_
-      - `v0.6.0 Documentation <https://www.pygmt.org/v0.6.0>`_
+      -
+      -
+    * - `v0.6.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.6.0>`_ [`Docs <https://www.pygmt.org/v0.6.0>`__]
       - >=6.3.0
       - >=3.8
       - >=1.19
-    * - `v0.5.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.5.0>`_
-      - `v0.5.0 Documentation <https://www.pygmt.org/v0.5.0>`_
+      -
+      -
+    * - `v0.5.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.5.0>`_ [`Docs <https://www.pygmt.org/v0.5.0>`__]
       - >=6.2.0
       - >=3.7
       - >=1.18
-    * - `v0.4.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.4.1>`_
-      - `v0.4.1 Documentation <https://www.pygmt.org/v0.4.1>`_
+      -
+      -
+    * - `v0.4.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.4.1>`_ [`Docs <https://www.pygmt.org/v0.4.1>`__]
       - >=6.2.0
       - >=3.7
       - >=1.17
-    * - `v0.4.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.4.0>`_
-      - `v0.4.0 Documentation <https://www.pygmt.org/v0.4.0>`_
+      -
+      -
+    * - `v0.4.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.4.0>`_ [`Docs <https://www.pygmt.org/v0.4.0>`__]
       - >=6.2.0
       - >=3.7
       - >=1.17
-    * - `v0.3.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.3.1>`_
-      - `v0.3.1 Documentation <https://www.pygmt.org/v0.3.1>`_
+      -
+      -
+    * - `v0.3.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.3.1>`_ [`Docs <https://www.pygmt.org/v0.3.1>`__]
       - >=6.1.1
       - >=3.7
       -
-    * - `v0.3.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.3.0>`_
-      - `v0.3.0 Documentation <https://www.pygmt.org/v0.3.0>`_
+      -
+      -
+    * - `v0.3.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.3.0>`_ [`Docs <https://www.pygmt.org/v0.3.0>`__]
       - >=6.1.1
       - >=3.7
       -
-    * - `v0.2.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.2.1>`_
-      - `v0.2.1 Documentation <https://www.pygmt.org/v0.2.1>`_
+      -
+      -
+    * - `v0.2.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.2.1>`_ [`Docs <https://www.pygmt.org/v0.2.1>`__]
       - >=6.1.1
       - >=3.6
       -
-    * - `v0.2.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.2.0>`_
-      - `v0.2.0 Documentation <https://www.pygmt.org/v0.2.0>`_
+      -
+      -
+    * - `v0.2.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.2.0>`_ [`Docs <https://www.pygmt.org/v0.2.0>`__]
       - >=6.1.1
       - 3.6 - 3.8
       -
-    * - `v0.1.2 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.2>`_
-      - `v0.1.2 Documentation <https://www.pygmt.org/v0.1.2>`_
+      -
+      -
+    * - `v0.1.2 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.2>`_ [`Docs <https://www.pygmt.org/v0.1.2>`__]
       - >=6.0.0
       - 3.6 - 3.8
       -
-    * - `v0.1.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.1>`_
-      - `v0.1.1 Documentation <https://www.pygmt.org/v0.1.1>`_
+      -
+      -
+    * - `v0.1.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.1>`_ [`Docs <https://www.pygmt.org/v0.1.1>`__]
       - >=6.0.0
       - 3.6 - 3.8
       -
-    * - `v0.1.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.0>`_
-      - `v0.1.0 Documentation <https://www.pygmt.org/v0.1.0>`_
+      -
+      -
+    * - `v0.1.0 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.1.0>`_ [`Docs <https://www.pygmt.org/v0.1.0>`__]
       - >=6.0.0
       - 3.6 - 3.8
       -
+      -
+      -
+
+*Dev reflects the main branch and is for the upcoming release.

environment.yml

@@ -7,8 +7,8 @@ dependencies:
     # Required dependencies
     - gmt=6.5.0
     - numpy>=1.23
-    - pandas
-    - xarray
+    - pandas>=1.5
+    - xarray>=2022.03
     - netCDF4
     - packaging
     # Optional dependencies

pyproject.toml

@@ -31,8 +31,8 @@ classifiers = [
 ]
 dependencies = [
     "numpy>=1.23",
-    "pandas",
-    "xarray",
+    "pandas>=1.5",
+    "xarray>=2022.03",
     "netCDF4",
     "packaging",
 ]

requirements.txt

@@ -1,6 +1,6 @@
 # Required packages
 numpy>=1.23
-pandas
-xarray
+pandas>=1.5
+xarray>=2022.03
 netCDF4
 packaging