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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
Installation
============
GeoPandas depends for its spatial functionality on a large geospatial, open
source stack of libraries (`GEOS`_, `GDAL`_, `PROJ`_). See the
:ref:`dependencies` section below for more details. Those base C
libraries can sometimes be a challenge to install. Therefore, we advise you
to closely follow the recommendations below to avoid installation problems.
.. _install-conda:
Installing with Anaconda / conda
--------------------------------
To install GeoPandas and all its dependencies, we recommend to use the `conda`_
package manager. This can be obtained by installing the
`Anaconda Distribution`_ (a free Python distribution for data science), or
through `miniconda`_ (minimal distribution only containing Python and the
`conda`_ package manager). See also the `Conda installation docs
<https://conda.io/docs/user-guide/install/download.html>`__ for more information
on how to install Anaconda or miniconda locally.
The advantage of using the `conda`_ package manager is that it provides
pre-built binaries for all the required and optional dependencies of GeoPandas
for all platforms (Windows, Mac, Linux).
To install the latest version of GeoPandas, you can then do::
conda install geopandas
Using the conda-forge channel
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
`conda-forge`_ is a community effort that provides conda packages for a wide
range of software. It provides the *conda-forge* package channel for conda from
which packages can be installed, in addition to the "*defaults*" channel
provided by Anaconda.
Depending on what other packages you are working with, the *defaults* channel
or *conda-forge* channel may be better for your needs (e.g. some packages are
available on *conda-forge* and not on *defaults*). Generally, *conda-forge* is
more up to date with the latest versions of geospatial python packages.
GeoPandas and all its dependencies are available on the *conda-forge*
channel, and can be installed as::
conda install --channel conda-forge geopandas
.. note::
We strongly recommend to either install everything from the *defaults*
channel, or everything from the *conda-forge* channel. Ending up with a
mixture of packages from both channels for the dependencies of GeoPandas
can lead to import problems.
See the `conda-forge section on using multiple channels
<http://conda-forge.org/docs/user/tipsandtricks.html#using-multiple-channels>`__
for more details.
Creating a new environment
^^^^^^^^^^^^^^^^^^^^^^^^^^
Creating a new environment is not strictly necessary, but given that installing
other geospatial packages from different channels may cause dependency conflicts
(as mentioned in the note above), it can be good practice to install the geospatial
stack in a clean environment starting fresh.
The following commands create a new environment with the name ``geo_env``,
configures it to install packages always from conda-forge, and installs
GeoPandas in it::
conda create -n geo_env
conda activate geo_env
conda config --env --add channels conda-forge
conda config --env --set channel_priority strict
conda install python=3 geopandas
.. _install-pip:
Installing with pip
-------------------
GeoPandas can also be installed with pip, if all dependencies can be installed
as well::
pip install geopandas
.. _install-deps:
.. warning::
When using pip to install GeoPandas, you need to make sure that all dependencies are
installed correctly.
Our main dependencies (`shapely`_, `pyproj`_, `pyogrio`_) provide binary
wheels with dependencies included for Mac, Linux, and Windows.
However, depending on your platform or Python version, there might be no
pre-compiled wheels available, and then you need to compile and install their C
dependencies manually. We refer to the individual packages for more details on
installing those. Using conda (see above) avoids the need to compile the
dependencies yourself.
Optional runtime dependencies can also be installed all at once::
pip install 'geopandas[all]'
Installing from source
----------------------
You may install the latest development version by cloning the
`GitHub` repository and using pip to install from the local directory::
git clone https://github.com/geopandas/geopandas.git
cd geopandas
pip install .
Development dependencies can be installed using the dev optional
dependency group::
pip install '.[dev]'
It is also possible to install the latest development version
directly from the GitHub repository with::
pip install git+git://github.com/geopandas/geopandas.git
For installing GeoPandas from source, the same :ref:`note <install-deps>` on
the need to have all dependencies correctly installed applies. But, those
dependencies can also be installed independently with conda before installing
GeoPandas from source::
conda install pandas pyogrio shapely pyproj
See the :ref:`section on conda <install-conda>` above for more details on
getting running with Anaconda.
.. _dependencies:
Dependencies
------------
Required dependencies:
- `numpy`_
- `pandas`_ (version 1.4 or later)
- `shapely`_ (interface to `GEOS`_; version 2.0.0 or later)
- `pyogrio`_ (interface to `GDAL`_; version 0.7.2 or later)
- `pyproj`_ (interface to `PROJ`_; version 3.3.0 or later)
- `packaging`_
Further, optional dependencies are:
- `fiona`_ (optional; slower alternative to `pyogrio`)
- `psycopg`_ (optional; for PostGIS connection)
- `psycopg2`_ (optional; for PostGIS connection - older version of `psycopg` library)
- `GeoAlchemy2`_ (optional; for writing to PostGIS)
- `geopy`_ (optional; for geocoding)
- `pointpats`_ (optional; for advanced point sampling)
- `scipy`_ (optional; for sparse output of spatial indexing)
For plotting, these additional packages may be used:
- `matplotlib`_ (>= 3.5.0)
- `mapclassify`_ (>= 2.4.0)
- `folium`_ (for interactive plotting)
.. _PyPI: https://pypi.python.org/pypi/geopandas
.. _GitHub: https://github.com/geopandas/geopandas
.. _numpy: http://www.numpy.org
.. _pandas: http://pandas.pydata.org
.. _shapely: https://shapely.readthedocs.io
.. _fiona: https://fiona.readthedocs.io
.. _pyogrio: https://pyogrio.readthedocs.io
.. _matplotlib: http://matplotlib.org
.. _geopy: https://github.com/geopy/geopy
.. _psycopg: https://pypi.python.org/pypi/psycopg
.. _psycopg2: https://pypi.python.org/pypi/psycopg2
.. _GeoAlchemy2: https://geoalchemy-2.readthedocs.io/
.. _mapclassify: http://pysal.org/mapclassify
.. _pyproj: https://github.com/pyproj4/pyproj
.. _conda: https://conda.io/en/latest/
.. _Anaconda distribution: https://www.anaconda.com/distribution/
.. _miniconda: https://docs.conda.io/en/latest/miniconda.html
.. _conda-forge: https://conda-forge.org/
.. _GDAL: https://www.gdal.org/
.. _GEOS: https://geos.osgeo.org
.. _PROJ: https://proj.org/
.. _packaging: https://packaging.pypa.io/en/latest/
.. _pointpats: https://pysal.org/pointpats/
.. _folium: https://python-visualization.github.io/folium/latest/
.. _scipy: https://docs.scipy.org/doc/scipy/
|
