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
|
Installation
============
Installing from PyPI
--------------------
Precompiled binary wheels for Windows, GNU/Linux and MacOS are available
on PyPI and can be installed with `pip`_:
.. code-block:: sh
python -m pip install basemap
Installing ``basemap`` will also install ``basemap-data``, containing
the minimal data assets required by ``basemap``. If you also need the
high-resolution data assets, you can install them with `pip`_ too:
.. code-block:: sh
python -m pip install basemap-data-hires
Installing from conda-forge
---------------------------
For Miniforge users, ``basemap`` packages are available through the
``conda-forge`` channel:
.. code-block:: sh
conda install -c conda-forge basemap
Similarly to the PyPI installation, the high-resolution data assets
can be installed separately if needed:
.. code-block:: sh
conda install -c conda-forge basemap-data-hires
Installing from source
----------------------
Optionally, you can also install ``basemap`` from its source hosted
on GitHub as indicated in the following steps:
1. Install pre-requisite Python modules:
- `cython`_
- `numpy`_
2. Download the ``basemap`` source code:
.. code-block:: sh
git clone --depth 1 https://github.com/matplotlib/basemap.git
3. Build the `GEOS`_ library. You may use the helper provided in the
``utils`` folder (please note that you need `CMake`_ and a working
C compiler in advance):
.. code-block:: sh
export GEOS_DIR=<your desired location>
python -c "import utils; utils.GeosLibrary('3.6.5').build(installdir='${GEOS_DIR}')"
or you can link directly to the system library if it is already
installed. ``GEOS_DIR`` must point to the GEOS installation prefix;
e.g. if ``libgeos_c.so`` is located in ``/usr/lib`` and ``geos_c.h``
is located in ``/usr/include``, then you must set ``GEOS_DIR`` to
``/usr``.
4. Build and install the ``basemap`` binary wheel:
.. code-block:: sh
python -m pip install .
On GNU/Linux, if your Python was installed through a package
management system, make sure that you have the Python header
``Python.h`` required to build Cython extensions (e.g. on
Debian-like systems, you should have the package ``python-dev``
installed).
5. Check that the package was installed correctly by executing:
.. code-block:: sh
python -c "from mpl_toolkits.basemap import Basemap"
.. _pip: https://pip.pypa.io/
.. _cython: https://github.com/cython/cython
.. _numpy: https://github.com/numpy/numpy
.. _GEOS: https://github.com/libgeos/geos
.. _CMake: https://cmake.org/
|
