Menu

Tree [r2194] / trunk / toolkits / basemap /
 History

HTTPS access


File Date Author Commit
 data 2006-02-26 jswhit [r2096] Added setupegg.py
 examples 2006-03-21 jswhit [r2194] Examples updated for new aspect handling in axe...
 lib 2006-03-21 jswhit [r2192] added special-case polar-centered versions of s...
 pyshapelib 2005-08-15 jswhit [r1644] pyshapelib reorg
 src 2006-03-20 jswhit [r2172] fixed for numpy array scalars (thanks Eric!)
 .cvsignore 2005-09-19 cmoad [r1763] added build dir to .cvsignore
 API_CHANGES 2005-10-13 jswhit [r1833] updates for 0.7.2
 Changelog 2006-02-23 jswhit [r2082] Updated to 0.8.2
 FAQ 2005-10-21 jswhit [r1846] plotclimdiv.py example has been replaced with f...
 LICENSE_data 2005-09-08 jswhit [r1733] data is from GMT, so use GPL
 LICENSE_proj4 2005-02-01 jdh2358 [r905] Initial revision
 LICENSE_pyshapelib 2005-08-14 jswhit [r1639] pyshapelib license (GPL)
 MANIFEST.in 2006-02-26 jswhit [r2096] Added setupegg.py
 PKG-INFO 2005-02-01 jdh2358 [r905] Initial revision
 README 2005-10-18 jswhit [r1843] *** empty log message ***
 setup.py 2006-02-23 jswhit [r2082] Updated to 0.8.2
 setupegg.py 2006-01-27 cmoad [r2003] moved setuptools support to setupegg.py

Read Me

**Descripton**

basemap.py - plot on map projections (with coastlines and political boundaries)
using matplotlib.

**Requirements**

matplotlib 0.81 (or higher)

**Copyright**

source code from proj.4 (http://proj.maptools.org) is included in the
'src' directory (under the terms given in LICENSE_proj4).

pyshapelib by Bernhard Herzog is included in the 'pyshapelib' directory
under the terms given in LICENSE_pyshapelib.

the coastline, lake, river and political boundary data are extracted
from datasets provided with the Generic Mapping Tools
(http://gmt.soest.hawaii.edu)
and are included under the terms given in LICENSE_data.

Everything else (include src/proj4.pyx and src/proj4.c):

copyright (c) 2004 by 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.

**Documentation** 

see basemap.py docstrings.

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**

1) run 'python setup.py install' 

for a non-standard install (python setup.py install --home=<dir>,
or python setup.py install --prefix=<dir>), the environment
variable BASEMAP_DATA_PATH must be set to the directory where the
data files (gshhs*.txt, countries*.txt, states*.txt and rivers*txt)
will be installed (see step 2 below).
Note: for this to work, matplotlib must also be installed in the same place
(via python setup.py install --home=<dir>).

2) download the basemap-data tarball, unpack and run "setup.py install"
This does not need to be done every time you update basemap (via step 1),
only when the basemap-data package is updated.

If you want the data files to be installed somewhere other than the 
default (sys.prefix/share/basemap), set the environment variable 
BASEMAP_DATA_PATH to the desired location. BASEMAP_DATA_PATH must then be 
set whenever basemap is imported in order for the package to locate the 
data files.

**Contact**

Jeff Whitaker <jeffrey.s.whitaker@noaa.gov>
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.