NEP29: Set minimum required version to NumPy 1.18+ (#1430)

Following NEP29 policy. Bumps minimum supported
NumPy version to 1.18 in the setup.py, requirements.txt
and environment.yml files. Also update installation
documentation and set CI tests to run on NumPy 1.18.

* List NumPy >= 1.18 in compatibility table on main README.rst
* Mention dev docs directly in compatibility table

Co-authored-by: Meghan Jones <[email protected]>

.github/workflows/ci_tests.yaml

@@ -44,11 +44,11 @@ jobs:
  # - os: ubuntu-latest
  # python-version: 3.7
  # isDraft: true
- # Pair Python 3.7 with NumPy 1.17 and Python 3.9 with NumPy 1.21
+ # Pair Python 3.7 with NumPy 1.18 and Python 3.9 with NumPy 1.21
  # Only install optional packages on Python 3.9/NumPy 1.21
  include:
  - python-version: 3.7
- numpy-version: '1.17'
+ numpy-version: '1.18'
  optional-packages: ''
  - python-version: 3.9
  numpy-version: '1.21'

README.rst

@@ -228,16 +228,21 @@ Compatibility with GMT/Python/NumPy versions
  - GMT
  - Python
  - Numpy
+ * - `v0.5.0 <https://github.com/GenericMappingTools/pygmt/milestone/8>`_ (upcoming release)
+ - `Dev Documentation <https://www.pygmt.org/dev>`_ (reflects `main branch <https://github.com/GenericMappingTools/pygmt>`_)
+ - >=6.2.0
+ - >=3.7
+ - >=1.18
  * - `v0.4.1 <https://github.com/GenericMappingTools/pygmt/releases/tag/v0.4.1>`_ (latest release)
  - `v0.4.1 Documentation <https://www.pygmt.org/v0.4.1>`_
  - >=6.2.0
  - >=3.7
- - >=1.17.0
+ - >=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>`_
  - >=6.2.0
  - >=3.7
- - >=1.17.0
+ - >=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>`_
  - >=6.1.1
@@ -273,6 +278,3 @@ Compatibility with GMT/Python/NumPy versions
  - >=6.0.0
  - 3.6 - 3.8
  -
-
-The unstable development documentation, which reflects the `main branch <https://github.com/GenericMappingTools/pygmt>`_
-on GitHub, can be found at https://www.pygmt.org/dev/.

doc/install.rst

@@ -80,7 +80,7 @@ Dependencies
 
 PyGMT requires the following libraries to be installed:
 
-* `numpy <https://numpy.org>`__ (>= 1.17)
+* `numpy <https://numpy.org>`__ (>= 1.18)
 * `pandas <https://pandas.pydata.org>`__
 * `xarray <https://xarray.pydata.org>`__
 * `netCDF4 <https://unidata.github.io/netcdf4-python>`__

environment.yml

@@ -6,7 +6,7 @@ dependencies:
  # Required dependencies
  - pip
  - gmt=6.2.0
- - numpy>=1.17
+ - numpy>=1.18
  - pandas
  - xarray
  - netCDF4

requirements.txt

@@ -1,5 +1,5 @@
 # Required packages
-numpy>=1.17
+numpy>=1.18
 pandas
 xarray
 netCDF4

setup.py

@@ -34,7 +34,7 @@
 ]
 PLATFORMS = "Any"
 PYTHON_REQUIRES = ">=3.7"
-INSTALL_REQUIRES = ["numpy>=1.17", "pandas", "xarray", "netCDF4", "packaging"]
+INSTALL_REQUIRES = ["numpy>=1.18", "pandas", "xarray", "netCDF4", "packaging"]
 # Configuration for setuptools-scm
 SETUP_REQUIRES = ["setuptools_scm"]
 USE_SCM_VERSION = {"local_scheme": "node-and-date", "fallback_version": "unknown"}