Repository files navigation

Plot on map projections (with coastlines and political boundaries) usingmatplotlib.

Precompiled binary wheels for Windows, GNU/Linux and MacOS are availableon PyPI and can be installed withpip:

python -m pip install basemap

For specific details on how to installbasemap throughconda orfrom source, please refer to thebasemap installation instructionsin the documentation.

This package depends onbasemap-data with the basicbasemapdata assets supporting the essential functionality.

This package depends optionally onbasemap-data-hires withthe high-resolution data assets, which can be installed manuallywithpip:

python -m pip install basemap-data-hires

This package depends optionally onOWSLib for theBasemap methodBasemap.wmsimage.

The library is licensed under the terms of theMIT license (seeLICENSE). The GEOS dynamic library bundled with the package wheelsis provided under the terms of theLGPL-2.1-only license as given inLICENSE.geos.

Seehttps://matplotlib.org/basemap/.

See scripts in thedoc/examples directory for example usage.

Read the FAQ and/or email the matplotlib-users mailing list if you haveproblems or questions.

Ben Rootben.v.root@gmail.com

Víctor Molina García (@molinav)

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, StephaneRaynaud, Tom Loredo, Patrick Marsh, Phil Elson, and Henry Hammond forvaluable contributions.

TheBasemap.fillcontinents method doesn't always do the right thing.Matplotlib always tries to fill the inside of a polygon. Under certainsituations, what is the inside of a coastline polygon can be ambiguous,and the outside may be filled instead of the inside. A workaround is tochange the map projection region slightly or mask the land areas withtheBasemap.drawlsmask method instead of filling the coastlinepolygons (this is illustrated in theortho_demo.py example).