forked from SciTools/cartopy
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
132 lines (90 loc) · 4.37 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
Installing Cartopy
==================
Pre-built binaries
------------------
The easiest route to installing cartopy is through
`Conda <https://conda.io/miniconda.html>`_. For all platforms
installing cartopy can be done with::
conda install -c conda-forge cartopy
Additional options include:
* `Enthought Canopy <https://www.enthought.com/product/canopy/>`_.
* Christoph Gohlke (https://www.lfd.uci.edu/~gohlke/pythonlibs/)
maintains unofficial Windows binaries of cartopy.
* `OSGeo Live <https://live.osgeo.org>`_.
Building from source
--------------------
The latest release of Cartopy is available from
https://github.com/SciTools/Cartopy.
Once you have satisfied the requirements detailed below, simply run::
python setup.py install
For non-standard locations, additional build lib & include paths
can be provided as per-usual at build_ext phase::
python setup.py build_ext -I/path/to/include -L/path/to/lib
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"
suffix) in addition to the core packages.
Many of these dependencies are built as part of Cartopy's conda distribution.
The recipes for these can be found at https://github.com/conda-forge/feedstocks.
**Python** 2.7 or later (https://www.python.org/)
Cartopy requires Python 2.7 or later.
**Cython** 0.17 or later (https://pypi.python.org/pypi/Cython/)
**NumPy** 1.10 or later (http://www.numpy.org/)
Python package for scientific computing including a powerful N-dimensional
array object.
**GEOS** 3.3.3 or later (https://trac.osgeo.org/geos/)
GEOS is an API of spatial predicates and functions for processing geometry
written in C++.
**Shapely** 1.5.6 or later (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.9.0 or later (https://proj4.org/)
Cartographic Projections library.
**six** 1.3.0 or later (https://pypi.python.org/pypi/six)
Python 2 and 3 compatibility.
Optional Dependencies
~~~~~~~~~~~~~~~~~~~~~
These are optional packages which you may want to install to enable
additional Cartopy functionality.
**Matplotlib** 1.5.1 or later (https://matplotlib.org/)
Python package for 2D plotting. This package is required for any
graphical capability.
**GDAL** version 1.10.0 (http://www.gdal.org/)
GDAL is a translator library for raster and vector geospatial data formats,
which has powerful data transformation and processing capabilities.
**Pillow** 1.7.8 or later (https://pypi.python.org/pypi/Pillow/2.3.0)
Popular fork of PythonImagingLibrary.
**pyepsg** 0.2.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)
Fast kd-tree implementation in Python; used for faster warping of images in
preference to SciPy.
**SciPy** 0.10 or later (https://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.
**Fiona** 1.0 or later (https://github.com/Toblerity/Fiona)
Python package for reading shapefiles faster than the default (pyshp).
Testing Dependencies
~~~~~~~~~~~~~~~~~~~~
These packages are required for the full Cartopy test suite to run.
**filelock** (https://filelock.readthedocs.io/)
A platform independent file lock for Python.
**mock** 1.0.1 (https://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.
**pytest** 3.1.0 or later (https://docs.pytest.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.