Installation¶
scarplet
is on PyPI and conda-forge. You can install it with
conda install scarplet -c conda-forge
or, using pip
,
pip install scarplet
The main dependencies are:
- NumPy
- Numexpr
- GDAL and Rasterio
- PyFFTW
- SciPy
A conda installation will install the Python GDAL bindings and PyFFTW. For instructions on manually installing LibFFTW and GDAL, see below.
Installing FFTW3 and pyFFTW¶
The Fast Fourier Transform library FFTW is a
requirement of the pyfftw
module used by this package. On Ubuntu or Debian,
it can be installed with the package manager
sudo apt-get install libfftw3-3 libfftw3-bin libfftw3-dev
On Mac OS X, you can use Homebrew
brew install fftw
Then pyFFTW can be install via pip
pip install pyfftw
There are some known issues with pyFFTW on OS X. It may be necessary to export link paths as environment variable prior to calling pip. See their installation instructions for more details
Installing GDAL¶
GDAL and python-gdal
are notoriously tricky to install. Hopefully your system
has GDAL installed already; if not, you can install using your OS’ package
manager.
For example, on Ubuntu or Debian,
sudo apt-get install gdal libgdal1h gdal-bin
Or, on OS X,
brew install gdal
Then, the Python bindings to GDAL can be installed. Typically this is as simple as
pip install gdal
but you may find that the compiler can’t find the GDAL header files. Usually
this will give a an error like fatal error: cpl_vsi_error.h: No such file or
directory
. To get around this, we need to pass the include path to pip
:
pip install gdal --global-option=build_ext --global-option="-I/usr/include/gdal/"
or
pip install gdal==$(gdal-config --version) --global-option=build_ext --global-option="-I/usr/include/gdal/"
In my case, with GDAL 1.11.2, this is
pip install gdal==1.11.2 --global-option=build_ext --global-option="-I/usr/include/gdal/"
Once GDAL is installed, you can go ahead and install the package as usual
pip install scarplet