/usr/share/doc/python-mpltoolkits.basemap-doc/html/_sources/users/installing.txt is in python-mpltoolkits.basemap-doc 1.0.7+dfsg-3build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | .. _installing:
**********
Installing
**********
Dependencies
============
**Requirements**
These are external packages which you will need to install before
installing basemap.
matplotlib 1.0.0 (or later, `download <http://sf.net/projects/matplotlib/>`__)
Python 2.4 (or later, including Python 3)
matplotlib requires python 2.4 or later (`download <http://www.python.org/download/>`__)
numpy 1.2.1 (or later)
array support for python (`download <http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=175103>`__)
**Required libraries that ship with basemap**
`GEOS <http://trac.osgeo.org/geos/>`__ (Geometry Engine - Open Source) library 3.1.1 or later.
Source code is included in the geos-3.3.3 directory.
When building from source, must be built and installed separately
from basemap (see build instructions below).
Included in Windows binary installers.
`PROJ4 <http://trac.osgeo.org/proj/>`__ Cartographic Projections Library.
Patched version automatically built into basemap.
**Optional libraries**
PIL
Python Imaging Library (`download <http://www.pythonware.com/products/pil/>`__),
only needed for :func:`~mpl_toolkits.basemap.Basemap.bluemarble`, :func:`~mpl_toolkits.basemap.Basemap.etopo`, :func:`~mpl_toolkits.basemap.Basemap.shadedrelief` and :func:`~mpl_toolkits.basemap.Basemap.warpimage` instance methods.
Installation
============
Download either Windows binary installers or source tarballs
`here <http://sourceforge.net/projects/matplotlib/files/matplotlib-toolkits/>`__.
To install from the source, follow these steps:
* Install pre-requisite requirements.
* Untar the basemap version X.Y.Z source tar.gz file, and
and cd to the basemap-X.Y.Z directory.
* Install the GEOS library. If you already have it on your
system, just set the environment variable GEOS_DIR to point to the location
of libgeos_c and geos_c.h (if libgeos_c is in /usr/local/lib and
geos_c.h is in /usr/local/include, set GEOS_DIR to /usr/local).
Then go to next step. If you don't have it, you can build it from
the source code included with basemap by following these steps::
cd geos-3.3.3
export GEOS_DIR=<where you want the libs and headers to go>
# A reasonable choice on a Unix-like system is /usr/local, or
# if you don't have permission to write there, your home directory.
./configure --prefix=$GEOS_DIR
make; make install
* cd back to the top level basemap directory (basemap-X.Y.Z) and
run the usual ``python setup.py install``. Check your installation
by running ``from mpl_toolkits.basemap import Basemap`` at the python
prompt.
* To test, cd to the examples directory and run ``python simpletest.py``.
To run all the examples (except those that have extra dependencies
or require an internet connection), execute ``python run_all.py``.
|