Installing Cartopy

The latest release of Cartopy is available from https://github.com/SciTools/Cartopy.

Once you have satisfied the requirements detailed below, simply

python setup.py install

Requirements

These external packages are required to install Cartopy or gain access to significant Cartopy functionality.

Many of these packages are available in Linux package managers such as aptitude and yum. For example, it may be possible to install Numpy using:

apt-get install python-numpy

If you are installing dependencies with a package manager on Linux, you may need to install the development packages (look for a “-dev” postfix) in addition to the core packages.

python 2.7 or later (http://www.python.org/)

Cartopy requires Python 2.7 or later.

Cython 0.15.1 or later (https://pypi.python.org/pypi/Cython/)

numpy 1.6 or later (http://numpy.scipy.org/)

Python package for scientific computing including a powerful N-dimensional array object.

shapely 1.2.14* (https://github.com/Toblerity/Shapely)

Python package for the manipulation and analysis of planar geometric objects.

pyshp 1.1.4 or later (https://pypi.python.org/pypi/pyshp)

Pure Python read/write support for ESRI Shapefile format.

PROJ.4 4.8.0 or later (http://trac.osgeo.org/proj/)

Cartographic Projections library.

matplotlib 1.2.0 (http://matplotlib.sourceforge.net/)

Python package for 2D plotting. This package is required for any graphical capability.

six 1.3.0 or later (https://pypi.python.org/pypi/six)

Python 2 and 3 compatibility.

Optional

These are optional packages which you may want to install to enable additional Cartopy functionality.

Pillow 1.7.8 or later (https://pypi.python.org/pypi/Pillow/2.3.0)

Popular fork of PythonImagingLibrary.

or

PythonImagingLibrary 1.1.7 or later (http://effbot.org/zone/pil-index.htm)

Python package for image processing.

scipy 0.10 or later (http://www.scipy.org/)

Python package for scientific computing.

OWSLib 0.8.7 (https://pypi.python.org/pypi/OWSLib)

Python package for client programming with Open Geospatial Consortium (OGC) web service. Gives access to cartopy ogc clients.

Testing

These packages are required for the full Cartopy test suite to run.

mock 1.0.1 (http://pypi.python.org/pypi/mock/)

Python mocking and patching package for testing. Note that this package is only required to support the Cartopy unit tests.

nose 1.2.1 or later (http://nose.readthedocs.org/en/latest/)

Python package for software testing.

pep8 1.3.3 or later (https://pypi.python.org/pypi/pep8)

Python package for software testing.

• Those packages have been tested with a specific build.

Installation options

Conda (Anaconda), an OS agnostic package manager via Rich Signell’s conda repo.

Christoph Gohlke’s windows binaries.

A community maintained repository of installation recipes can be found at SciTools/installation-recipes which provide step-by-step instructions for building Cartopy from source on specific operating systems.

OSGeo Live

Enthought Canopy