Plot on map projections (with coastlines and political boundaries) using matplotlib.
Python 2.6 (or higher)
The GEOS (Geometry Engine - Open Source) library (version 3.1.1 or higher). Source code is included in the
On Linux, if your Python was installed via a package management system, make sure the corresponding
python-devpackage is also installed. Otherwise, you may not have the Python header (
Python.h), which is required to build Python C extensions.
OWSLib (optional) It is needed for the
Pillow (optional) It is needed for Basemap warpimage, bluemarble, shadedrelief, and etop methods. PIL should work on Python 2.x. Pillow is a maintained fork of PIL.
Source code for the GEOS library is included in the
under the terms given in
The land-sea mask, coastline, lake, river and political boundary data are
extracted from datasets provided with the
Generic Mapping Tools (GMT) and are included
under the terms given in
Everything else (including
src/_geos.pyx) is licensed under
the terms given in
Copyright (C) 2011 Jeffrey Whitaker
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notices appear in all copies and that both the copyright notices and this permission notice appear in supporting documentation.
THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
See scripts in
examples directory for example usage.
Read the FAQ and/or email the matplotlib-users mailing list if you have problems or questions.
Install pre-requisite Python modules numpy and matplotlib.
basemap-X.Y.Z.tar.gz(approx 100 MB) from the GitHub Releases page, unpack and
Install the GEOS library. If you already have it on your system, just set the environment variable
GEOS_DIRto point to the location of
/usr/local). Then go to step (3). 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
cdback 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.
cdto 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
An alternative method is using
pip install --user git+https://github.com/matplotlib/basemap.git
Ben Root firstname.lastname@example.org
Special thanks to John Hunter, Andrew Straw, Eric Firing, Rob Hetland, Scott Sinclair, Ivan Lima, Erik Andersen, Michael Hearne, Jesper Larsen, Ryan May, David Huard, Mauro Cavalcanti, Jonas Bluethgen, Chris Murphy, Pierre Gerard-Marchant, Christoph Gohlke, Eric Bruning, Stephane Raynaud, Tom Loredo, Patrick Marsh, Phil Elson, and Henry Hammond for valuable contributions.