DOC: Add tips for finding grids to download

pyproj4 · Sep 16, 2020 · 20b7ddf · 20b7ddf
1 parent 0787555
commit 20b7ddf
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 3 deletions.
diff --git a/docs/advanced_examples.rst b/docs/advanced_examples.rst
@@ -182,7 +182,9 @@ Here is an example where enabling the global context can help:
     crs_list = [pyproj.CRS.from_epsg(code) for code in codes]
 
 
-Debugging Internal PROJ:
+.. _debugging-internal-proj:
+
+Debugging Internal PROJ
 ------------------------
 
 .. versionadded:: 3.0.0

diff --git a/docs/transformation_grids.rst b/docs/transformation_grids.rst
@@ -61,6 +61,8 @@ Available methods for download include:
   .. note:: You can use the `network` kwarg when initializing
             :class:`pyproj.Proj` or :class:`pyproj.Transformer <pyproj.transformer.Transformer>`
 
+- Download stable from https://download.osgeo.org/proj or latest from https://github.com/OSGeo/PROJ-data
+
 - Use `conda <https://conda.io/en/latest/>`__ with the `conda-forge <https://conda-forge.org/>`__ channel:
 
   .. code-block:: bash
@@ -93,7 +95,10 @@ What grids to download?
 
 - Have a machine with limited space and want to pre-download files?
 
-  The :class:`pyproj.transformer.TransformerGroup` can assist finding the grids you need to download.
+  You can enable enable :ref:`debugging-internal-proj` with pyproj 3+ and perform a transformation.
+  The logs will show the grids PROJ searches for.
+
+  Additionally, the :class:`pyproj.transformer.TransformerGroup` can assist finding the grids you need to download.
 
   .. code-block:: python
 
@@ -110,6 +115,6 @@ What grids to download?
     'Inverse of NAD27 to WGS 84 (85) + Alaska Albers'
     >>> tg.unavailable_operations[0].grids[0].url
     'https://cdn.proj.org/us_noaa_alaska.tif'
-    >>> tg.download_grids(verbose=True)
+    >>> tg.download_grids(verbose=True)  # pyproj 3+
     Downloading: https://cdn.proj.org/us_noaa_alaska.tif
     Downloading: https://cdn.proj.org/ca_nrc_ntv2_0.tif