From 9f128bc0da3fdaf04b7f23b94eabf1d7c02fe99c Mon Sep 17 00:00:00 2001 From: Sean Gillies Date: Fri, 15 Feb 2019 12:30:17 -0700 Subject: [PATCH] More details --- docs/faq.rst | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/docs/faq.rst b/docs/faq.rst index 64162504..9a70ebec 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -25,14 +25,22 @@ your shell and running a command like ogrinfo: ERROR 4: Unable to open EPSG support file gcs.csv. Try setting the GDAL_DATA environment variable to point to the directory containing EPSG csv files. If you're using GDAL software installed by a package management system like apt -or yum, or Homebrew, you don't need to set the GDAL_DATA environment variable. +or yum, or Homebrew, or if you've built and installed it using ``configure; +make; make install``, you don't need to set the GDAL_DATA environment variable. That software has the right directory path built in. If you see this error, it's likely a sign that GDAL_DATA is set to a bogus value. Unset GDAL_DATA if it exists and see if that eliminates the error condition and the message. If you're installing GDAL into a Conda environment or into a Python virtual -environment by running `pip install rasterio` (remember that the Rasterio -wheels on the Python Package Index include a GDAL library and its data files) -the situation is different. The proper data directory path is not built in and -GDAL_DATA must be set. Rasterio 1.0.18, whether from PyPI or Conda, will set -the GDAL_DATA environment variable to the correct location when it is imported. +environment (remember that the Rasterio wheels on the Python Package Index +include a GDAL library and its data files) the situation is different. The +proper data directory path is not built in and GDAL_DATA must be set. + +Rasterio 1.0.18, whether from PyPI or Conda, will set the GDAL_DATA environment +variable to the correct location when it is imported, but only if it has not +already been set. Previous versions of Rasterio tried to avoid patching the +environment of the process, but there's really no better option. + +Get the latest version of Rasterio, 1.0.18, and use it without setting +GDAL_DATA. You shouldn't experience the error condition or the message about +it.