REF: Use pyproj 3+ for PROJ 8+ migration

.appveyor.yml

@@ -2,7 +2,7 @@ environment:
     matrix:
         - PYTHON_VERSION: "3.9"
           CONDA_INSTALL_LOCN: "C:\\Miniconda3-x64"
-          PACKAGES: "cython numpy matplotlib-base proj=7 pykdtree scipy"
+          PACKAGES: "cython numpy matplotlib-base pyproj pykdtree scipy"
 
 install:
   # Install miniconda
@@ -15,7 +15,7 @@ install:
   - conda config --add channels conda-forge
   - conda config --add channels conda-forge/label/testing
   - set ENV_NAME=test-environment
-  - set PACKAGES=%PACKAGES% flufl.lock owslib pep8 pillow pyepsg pyshp pytest
+  - set PACKAGES=%PACKAGES% flufl.lock owslib pep8 pillow pyshp pytest
   - set PACKAGES=%PACKAGES% requests setuptools_scm setuptools_scm_git_archive
   - set PACKAGES=%PACKAGES% shapely
   - conda create -n %ENV_NAME% python=%PYTHON_VERSION% %PACKAGES%
@@ -37,6 +37,7 @@ build_script:
 
 test_script:
   - set MPLBACKEND=Agg
+  - set PYPROJ_GLOBAL_CONTEXT=ON
   - pytest --pyargs cartopy
 
 artifacts:

.circleci/config.yml

@@ -36,8 +36,7 @@ deps-run: &deps-install
         numpy \
         owslib \
         pillow \
-        'proj<8' \
-        pyepsg \
+        pyproj \
         pykdtree \
         pyshp \
         requests \
@@ -59,6 +58,7 @@ doc-run: &doc-build
   name: Build documentation
   command: |
     source activate test-environment
+    PYPROJ_GLOBAL_CONTEXT=ON
     make -C docs html
 
 

.github/workflows/ci-testing.yml

@@ -10,7 +10,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest]
-        python-version: [3.6, 3.9]
+        python-version: [3.7, 3.8, 3.9]
     defaults:
       run:
         shell: bash -l {0}
@@ -26,16 +26,16 @@ jobs:
       - name: Minimum packages
         # Only run on macos for now
         # Conda's linux packages don't grab the testing label of matplotlib causing failures due to freetype differences
-        if: matrix.python-version == '3.6' && matrix.os == 'macos-latest'
+        if: matrix.python-version == '3.7' && matrix.os == 'macos-latest'
         id: minimum-packages
         run: |
-          echo "PACKAGES=cython=0.28.5 matplotlib=2.2.2 numpy=1.16 owslib=0.17 proj4=5.2.0 scipy=1.2.0" >> $GITHUB_ENV
+          echo "PACKAGES=cython=0.28.5 matplotlib=3.1 numpy=1.18 owslib=0.17 pyproj=3.0 proj=8.0 scipy=1.2.0" >> $GITHUB_ENV
           echo "CFLAGS=-stdlib=libc++" >> $GITHUB_ENV
 
       - name: Latest packages
         if: steps.minimum-packages.conclusion == 'skipped'
         run: |
-          echo "PACKAGES=cython fiona matplotlib-base numpy proj<8 pykdtree scipy" >> $GITHUB_ENV
+          echo "PACKAGES=cython fiona matplotlib-base numpy pyproj pykdtree scipy" >> $GITHUB_ENV
 
       - name: Coverage packages
         id: coverage
@@ -48,7 +48,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          PACKAGES="$PACKAGES flufl.lock owslib pep8 pillow pyepsg pyshp pytest"
+          PACKAGES="$PACKAGES flufl.lock owslib pep8 pillow pyshp pytest"
           PACKAGES="$PACKAGES pytest-xdist requests setuptools_scm"
           PACKAGES="$PACKAGES setuptools_scm_git_archive shapely"
           conda install $PACKAGES
@@ -70,7 +70,7 @@ jobs:
           # Check that the downloader tool at least knows where to get the data from (but don't actually download it)
           python tools/cartopy_feature_download.py gshhs physical --dry-run
           CARTOPY_GIT_DIR=$PWD
-          pytest -n 4 --doctest-modules --pyargs cartopy ${EXTRA_TEST_ARGS}
+          PYPROJ_GLOBAL_CONTEXT=ON pytest -n 4 --doctest-modules --pyargs cartopy ${EXTRA_TEST_ARGS}
 
       - name: Coveralls
         if: steps.coverage.conclusion == 'success'

.github/workflows/release.yml

@@ -24,8 +24,8 @@ jobs:
 
       - name: Install dependencies
         run: |
-          PACKAGES="cython fiona matplotlib-base numpy proj<8 pykdtree scipy"
-          PACKAGES="$PACKAGES flufl.lock owslib pep8 pillow pyepsg pyshp pytest"
+          PACKAGES="cython fiona matplotlib-base numpy pyproj pykdtree scipy"
+          PACKAGES="$PACKAGES flufl.lock owslib pep8 pillow pyshp pytest"
           PACKAGES="$PACKAGES pytest-xdist requests setuptools_scm"
           PACKAGES="$PACKAGES setuptools_scm_git_archive shapely"
           conda install $PACKAGES

.gitignore

@@ -53,6 +53,7 @@ benchmarks/envs/
 *.swp
 .ipynb_checkpoints/
 .idea/
+.vscode/
 
 # Operating system files
 \.DS_Store

INSTALL

@@ -90,8 +90,10 @@ Further information about the required dependencies can be found here:
 **pyshp** 2.0 or later (https://pypi.python.org/pypi/pyshp)
     Pure Python read/write support for ESRI Shapefile format.
 
-**PROJ** 4.9.0 or later (https://proj4.org/)
-    Cartographic Projections library.
+**PROJ** 8.0.0 or later (https://proj.org/).
+
+**pyproj** 3.0.0 or later (https://github.com/pyproj4/pyproj/)
+    Python interface to PROJ (cartographic projections and coordinate transformations library).
 
 Optional Dependencies
 ~~~~~~~~~~~~~~~~~~~~~
@@ -109,9 +111,6 @@ to install these optional dependencies.
 **Pillow** 1.7.8 or later (https://pypi.python.org/pypi/Pillow/2.3.0)
     A popular fork of PythonImagingLibrary.
 
-**pyepsg** 0.4.0 or later (https://github.com/rhattersley/pyepsg)
-    A simple Python interface to https://epsg.io
-
 **pykdtree** 1.2.2 or later (https://github.com/storpipfugl/pykdtree)
     A fast kd-tree implementation that is used for faster warping
     of images than SciPy.

examples/lines_and_polygons/effects_of_the_ellipse.py

@@ -46,10 +46,8 @@ def transform_fn(x, y, z=None):
 
 def main():
     # Define the two coordinate systems with different ellipses.
-    wgs84 = ccrs.PlateCarree(globe=ccrs.Globe(datum='WGS84',
-                                              ellipse='WGS84'))
-    sphere = ccrs.PlateCarree(globe=ccrs.Globe(datum='WGS84',
-                                               ellipse='sphere'))
+    wgs84 = ccrs.PlateCarree(globe=ccrs.Globe(ellipse='WGS84'))
+    sphere = ccrs.PlateCarree(globe=ccrs.Globe(ellipse='sphere'))
 
     # Define the coordinate system of the data we have from Natural Earth and
     # acquire the 1:10m physical coastline shapefile.

examples/miscellanea/eccentric_ellipse.py

@@ -50,8 +50,8 @@ def vesta_image():
     img_globe = ccrs.Globe(semimajor_axis=285000., semiminor_axis=229000.,
                            ellipse=None)
     img_proj = ccrs.PlateCarree(globe=img_globe)
-    img_extent = (-895353.906273091, 895353.906273091,
-                  447676.9531365455, -447676.9531365455)
+    img_extent = (-180, 180,
+                  -90, 90)
     return img, img_globe, img_proj, img_extent
 
 
@@ -60,7 +60,7 @@ def main():
     projection = ccrs.Geostationary(globe=globe)
 
     fig = plt.figure()
-    ax = fig.add_subplot(1, 1, 1, projection=projection)
+    ax = fig.add_subplot(1, 1, 1, projection=projection, frameon=False)
     ax.imshow(img, transform=crs, extent=extent)
     fig.text(.075, .012, "Image credit: NASA/JPL-Caltech/UCLA/MPS/DLR/IDA/PSI",
              bbox={'facecolor': 'w', 'edgecolor': 'k'})