Thread: SF.net SVN: matplotlib:[5917] trunk/toolkits/basemap/doc/users

Brought to you by: cjgohlke, dsdale, efiring, heeres, and 8 others

matplotlib-checkins

SF.net SVN: matplotlib:[5917] trunk/toolkits/basemap/doc/users

From: <js...@us...> - 2008-07-29 12:17:04

Revision: 5917
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=5917&view=rev
Author:   jswhit
Date:     2008-07-29 12:17:01 +0000 (Tue, 29 Jul 2008)

Log Message:
-----------
new section for users guide

Modified Paths:
--------------
    trunk/toolkits/basemap/doc/users/index.rst

Added Paths:
-----------
    trunk/toolkits/basemap/doc/users/graticule.rst

Added: trunk/toolkits/basemap/doc/users/graticule.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/graticule.rst	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/graticule.rst	2008-07-29 12:17:01 UTC (rev 5917)
@@ -0,0 +1,13 @@
+.. _graticule:
+
+Drawing and Labelling Parallels and Meridians
+=============================================
+
+Most maps include a graticule grid, a reference network of labelled
+latitude and longitude lines. Basemap does this with the 
+:func:`~mpl_toolkits.basemap.Basemap.drawparallels` and
+:func:`~mpl_toolkits.basemap.Basemap.drawmeridians` instance methods.
+The longitude and latitude lines can be labelled where they
+the map projection boundary.
+
+.. toctree::

Modified: trunk/toolkits/basemap/doc/users/index.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/index.rst	2008-07-29 10:53:45 UTC (rev 5916)
+++ trunk/toolkits/basemap/doc/users/index.rst	2008-07-29 12:17:01 UTC (rev 5917)
@@ -11,3 +11,4 @@
 
     intro.rst
     mapsetup.rst
+    graticule.rst


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

SF.net SVN: matplotlib:[5920] trunk/toolkits/basemap/doc/users

From: <js...@us...> - 2008-07-29 16:00:39

Revision: 5920
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=5920&view=rev
Author:   jswhit
Date:     2008-07-29 16:00:35 +0000 (Tue, 29 Jul 2008)

Log Message:
-----------
add another section to users guide.

Modified Paths:
--------------
    trunk/toolkits/basemap/doc/users/index.rst

Added Paths:
-----------
    trunk/toolkits/basemap/doc/users/geography.rst

Added: trunk/toolkits/basemap/doc/users/geography.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/geography.rst	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/geography.rst	2008-07-29 16:00:35 UTC (rev 5920)
@@ -0,0 +1,23 @@
+.. _geography:
+
+Drawing Coastlines, Rivers and Political Boundaries
+===================================================
+
+Basemap includes the 
+`GSSH <http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html>`_
+coastline dataset, as well as datasets for rivers, state and
+country boundaries from 
+`GMT <http://gmt.soest.hawaii.edu>`_.
+These datasets can be used to draw coastlines, rivers and political
+boundaries on maps at several different resolutions.  The relevant Basemap 
+methods are:
+
+* :func:`~mpl_toolkits.basemap.Basemap.drawcoastlines`: draw coastlines.
+* :func:`~mpl_toolkits.basemap.Basemap.fillcontinents`: color the interior
+  of continents (by filling the coastline polygons).
+* :func:`~mpl_toolkits.basemap.Basemap.drawcountries`: draw country boundaries.
+* :func:`~mpl_toolkits.basemap.Basemap.drawstates`: draw state boundaries
+  in North America.
+* :func:`~mpl_toolkits.basemap.Basemap.drawrivers`: draw rivers.
+
+.. toctree::

Modified: trunk/toolkits/basemap/doc/users/index.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/index.rst	2008-07-29 12:23:43 UTC (rev 5919)
+++ trunk/toolkits/basemap/doc/users/index.rst	2008-07-29 16:00:35 UTC (rev 5920)
@@ -11,4 +11,5 @@
 
     intro.rst
     mapsetup.rst
+    geography.rst
     graticule.rst


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

SF.net SVN: matplotlib:[6146] trunk/toolkits/basemap/doc/users

From: <js...@us...> - 2008-10-04 13:10:02

Revision: 6146
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=6146&view=rev
Author:   jswhit
Date:     2008-10-04 13:09:52 +0000 (Sat, 04 Oct 2008)

Log Message:
-----------
add new projections

Modified Paths:
--------------
    trunk/toolkits/basemap/doc/users/figures/robin.py
    trunk/toolkits/basemap/doc/users/mapsetup.rst

Added Paths:
-----------
    trunk/toolkits/basemap/doc/users/figures/gall.py
    trunk/toolkits/basemap/doc/users/figures/mbtfpq.py
    trunk/toolkits/basemap/doc/users/figures/vandg.py
    trunk/toolkits/basemap/doc/users/gall.rst
    trunk/toolkits/basemap/doc/users/mbtfpq.rst
    trunk/toolkits/basemap/doc/users/vandg.rst

Added: trunk/toolkits/basemap/doc/users/figures/gall.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/gall.py	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/figures/gall.py	2008-10-04 13:09:52 UTC (rev 6146)
@@ -0,0 +1,17 @@
+from mpl_toolkits.basemap import Basemap
+import numpy as np
+import matplotlib.pyplot as plt
+# llcrnrlat,llcrnrlon,urcrnrlat,urcrnrlon
+# are the lat/lon values of the lower left and upper right corners
+# of the map.
+# resolution = 'c' means use crude resolution coastlines.
+m = Basemap(projection='gall',llcrnrlat=-90,urcrnrlat=90,\
+            llcrnrlon=-180,urcrnrlon=180,resolution='c')
+m.drawcoastlines()
+m.fillcontinents(color='coral',lake_color='aqua')
+# draw parallels and meridians.
+m.drawparallels(np.arange(-90.,91.,30.))
+m.drawmeridians(np.arange(-180.,181.,60.))
+m.drawmapboundary(fill_color='aqua') 
+plt.title("Gall Stereographic Projection")
+plt.savefig('gall.png')

Added: trunk/toolkits/basemap/doc/users/figures/mbtfpq.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/mbtfpq.py	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/figures/mbtfpq.py	2008-10-04 13:09:52 UTC (rev 6146)
@@ -0,0 +1,14 @@
+from mpl_toolkits.basemap import Basemap
+import numpy as np
+import matplotlib.pyplot as plt
+# lon_0 is central longitude of projection.
+# resolution = 'c' means use crude resolution coastlines.
+m = Basemap(projection='mbtfpq',lon_0=0,resolution='c')
+m.drawcoastlines()
+m.fillcontinents(color='coral',lake_color='aqua')
+# draw parallels and meridians.
+m.drawparallels(np.arange(-90.,120.,30.))
+m.drawmeridians(np.arange(0.,360.,60.))
+m.drawmapboundary(fill_color='aqua') 
+plt.title("McBryde-Thomas Flat Polar Quartic Projection")
+plt.savefig('mbtfpq.png')

Modified: trunk/toolkits/basemap/doc/users/figures/robin.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/robin.py	2008-10-04 07:16:10 UTC (rev 6145)
+++ trunk/toolkits/basemap/doc/users/figures/robin.py	2008-10-04 13:09:52 UTC (rev 6146)
@@ -8,7 +8,7 @@
 m.fillcontinents(color='coral',lake_color='aqua')
 # draw parallels and meridians.
 m.drawparallels(np.arange(-90.,120.,30.))
-m.drawmeridians(np.arange(0.,420.,60.))
+m.drawmeridians(np.arange(0.,360.,60.))
 m.drawmapboundary(fill_color='aqua') 
 plt.title("Robinson Projection")
 plt.savefig('robin.png')

Added: trunk/toolkits/basemap/doc/users/figures/vandg.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/vandg.py	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/figures/vandg.py	2008-10-04 13:09:52 UTC (rev 6146)
@@ -0,0 +1,14 @@
+from mpl_toolkits.basemap import Basemap
+import numpy as np
+import matplotlib.pyplot as plt
+# lon_0 is central longitude of projection.
+# resolution = 'c' means use crude resolution coastlines.
+m = Basemap(projection='vandg',lon_0=0,resolution='c')
+m.drawcoastlines()
+m.fillcontinents(color='coral',lake_color='aqua')
+# draw parallels and meridians.
+m.drawparallels(np.arange(-80.,81.,20.))
+m.drawmeridians(np.arange(0.,360.,60.))
+m.drawmapboundary(fill_color='aqua') 
+plt.title("van der Grinten Projection")
+plt.savefig('vandg.png')

Added: trunk/toolkits/basemap/doc/users/gall.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/gall.rst	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/gall.rst	2008-10-04 13:09:52 UTC (rev 6146)
@@ -0,0 +1,11 @@
+.. _gall:
+
+Gall Stereographic Projection
+=============================
+
+A stereographic, cylindrical projection that is neither equal-area
+or conformal.
+
+.. literalinclude:: figures/gall.py
+
+.. image:: figures/gall.png

Modified: trunk/toolkits/basemap/doc/users/mapsetup.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/mapsetup.rst	2008-10-04 07:16:10 UTC (rev 6145)
+++ trunk/toolkits/basemap/doc/users/mapsetup.rst	2008-10-04 13:09:52 UTC (rev 6146)
@@ -6,7 +6,7 @@
 In order to represent the curved surface of the earth on a two-dimensional
 map, a map projection is needed. Since this cannot be done without
 distortion, there are many map projections, each with it's own advantages
-and disadvantages. Basemap provides 19 different map projections.
+and disadvantages. Basemap provides 22 different map projections.
 Some are global, some can only represent a portion of the globe. When
 a :class:`~mpl_toolkits.basemap.Basemap` class instance is
 created, the desired map projection must
@@ -47,6 +47,7 @@
     omerc.rst
     poly.rst
     mill.rst
+    gall.rst
     lcc.rst
     laea.rst
     stere.rst
@@ -55,3 +56,5 @@
     pstere.rst
     plaea.rst
     paeqd.rst
+    mbtfpq.rst
+    vandg.rst

Added: trunk/toolkits/basemap/doc/users/mbtfpq.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/mbtfpq.rst	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/mbtfpq.rst	2008-10-04 13:09:52 UTC (rev 6146)
@@ -0,0 +1,10 @@
+.. _mbtfpq:
+
+McBryde-Thomas Flat Polar Quartic
+=================================
+
+A global equal-area projection.
+
+.. literalinclude:: figures/mbtfpq.py
+
+.. image:: figures/mbtfpq.png

Added: trunk/toolkits/basemap/doc/users/vandg.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/vandg.rst	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/vandg.rst	2008-10-04 13:09:52 UTC (rev 6146)
@@ -0,0 +1,12 @@
+.. _vandg:
+
+van der Grinten Projection
+==========================
+
+A global projection once used by the National Geographic Society for world maps.
+Neither equal area or conformal, shows the world in a circle centered on
+the equator.
+
+.. literalinclude:: figures/vandg.py
+
+.. image:: figures/vandg.png


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

SF.net SVN: matplotlib:[6740] trunk/toolkits/basemap/doc/users

From: <js...@us...> - 2009-01-06 16:38:50

Revision: 6740
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=6740&view=rev
Author:   jswhit
Date:     2009-01-06 16:38:47 +0000 (Tue, 06 Jan 2009)

Log Message:
-----------
add fulldisk aeqd example.

Modified Paths:
--------------
    trunk/toolkits/basemap/doc/users/aeqd.rst

Added Paths:
-----------
    trunk/toolkits/basemap/doc/users/figures/aeqd_fulldisk.py

Modified: trunk/toolkits/basemap/doc/users/aeqd.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/aeqd.rst	2009-01-06 08:07:18 UTC (rev 6739)
+++ trunk/toolkits/basemap/doc/users/aeqd.rst	2009-01-06 16:38:47 UTC (rev 6740)
@@ -10,6 +10,15 @@
 this point are equidistant on the surface of the earth on this projection.
 The specified point ``lon_0, lat_0`` shows up as a black dot in the center of the map.
 
+Here's an example using the width and height keywords to specify the map region.
+
 .. literalinclude:: figures/aeqd.py
 
 .. image:: figures/aeqd.png
+
+If both the width/height and corner lat/lon keywords are omitted, the whole world is 
+plotted in a circle.
+
+.. literalinclude:: figures/aeqd_fulldisk.py
+
+.. image:: figures/aeqd_fulldisk.png

Added: trunk/toolkits/basemap/doc/users/figures/aeqd_fulldisk.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/aeqd_fulldisk.py	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/figures/aeqd_fulldisk.py	2009-01-06 16:38:47 UTC (rev 6740)
@@ -0,0 +1,19 @@
+from mpl_toolkits.basemap import Basemap
+import numpy as np
+import matplotlib.pyplot as plt
+lon_0 = -105; lat_0 = 40
+m = Basemap(projection='aeqd',lat_0=lat_0,lon_0=lon_0)
+# fill background.
+m.drawmapboundary(fill_color='aqua')
+# draw coasts and fill continents.
+m.drawcoastlines(linewidth=0.5)
+m.fillcontinents(color='coral',lake_color='aqua')
+# 20 degree graticule.
+m.drawparallels(np.arange(-80,81,20))
+m.drawmeridians(np.arange(-180,180,20))
+# draw a black dot at the center.
+xpt, ypt = m(lon_0, lat_0)
+m.plot([xpt],[ypt],'ko') 
+# draw the title.
+plt.title('Whole World Azimuthal Equidistant Projection')
+plt.savefig('aeqd_fulldisk.png')


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

SF.net SVN: matplotlib:[8131] trunk/toolkits/basemap/doc/users

From: <js...@us...> - 2010-02-15 02:31:40

Revision: 8131
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=8131&view=rev
Author:   jswhit
Date:     2010-02-15 02:31:33 +0000 (Mon, 15 Feb 2010)

Log Message:
-----------
add nsper examples

Added Paths:
-----------
    trunk/toolkits/basemap/doc/users/figures/nsper_full.py
    trunk/toolkits/basemap/doc/users/figures/nsper_partial.py
    trunk/toolkits/basemap/doc/users/nsper.rst

Added: trunk/toolkits/basemap/doc/users/figures/nsper_full.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/nsper_full.py	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/figures/nsper_full.py	2010-02-15 02:31:33 UTC (rev 8131)
@@ -0,0 +1,18 @@
+from mpl_toolkits.basemap import Basemap
+import numpy as np
+import matplotlib.pyplot as plt
+# lon_0, lat_0 are the center point of the projection.
+# satellite_height is the altitude of the camera.
+# resolution = 'l' means use low resolution coastlines.
+h = 3000.
+m = Basemap(projection='nsper',lon_0=-105,lat_0=40,
+        satellite_height=h*1000.,resolution='l')
+m.drawcoastlines()
+m.fillcontinents(color='coral',lake_color='aqua')
+# draw parallels and meridians.
+m.drawparallels(np.arange(-90.,120.,30.))
+m.drawmeridians(np.arange(0.,420.,60.))
+m.drawmapboundary(fill_color='aqua') 
+plt.title("Full Disk Near-Sided Perspective Projection %d km above earth" %
+        h,fontsize=10)
+plt.savefig('nsper_full.png')

Added: trunk/toolkits/basemap/doc/users/figures/nsper_partial.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/nsper_partial.py	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/figures/nsper_partial.py	2010-02-15 02:31:33 UTC (rev 8131)
@@ -0,0 +1,33 @@
+from mpl_toolkits.basemap import Basemap
+import numpy as np
+import matplotlib.pyplot as plt
+fig = plt.figure()
+# global ortho map centered on lon_0,lat_0
+lat_0=10.; lon_0=57.
+# altitude of camera (in km).
+h = 3000.
+# resolution = None means don't process the boundary datasets.
+m1 = Basemap(projection='nsper',satellite_height=h*1000.,\
+        lon_0=lon_0,lat_0=lat_0,resolution=None)
+# add an axes with a black background
+ax = fig.add_axes([0.1,0.1,0.8,0.8],axisbg='k')
+# plot just upper right quadrant (corners determined from global map).
+# keywords llcrnrx,llcrnry,urcrnrx,urcrnry used to define the lower
+# left and upper right corners in map projection coordinates.
+# llcrnrlat,llcrnrlon,ucrnrlon,urcrnrlat could be used to define
+# lat/lon values of corners - but this won't work in cases such as this
+# where one of the corners does not lie on the earth.
+m = Basemap(projection='nsper',satellite_height=h*1000.,\
+        lon_0=lon_0,lat_0=lat_0,resolution='l',\
+    llcrnrx=0.,llcrnry=0.,urcrnrx=m1.urcrnrx/2.,urcrnry=m1.urcrnry/2.)
+m.drawcoastlines()
+m.drawmapboundary(fill_color='aqua')
+m.fillcontinents(color='coral',lake_color='aqua')
+m.drawcountries()
+# draw parallels and meridians.
+m.drawparallels(np.arange(-90.,120.,30.))
+m.drawmeridians(np.arange(0.,360.,60.))
+m.drawmapboundary()
+plt.title('Near-Sided Perspective Map Showing A Quadrant of the Globe',\
+          fontsize=12)
+plt.savefig('nsper_partial.png')

Added: trunk/toolkits/basemap/doc/users/nsper.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/nsper.rst	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/nsper.rst	2010-02-15 02:31:33 UTC (rev 8131)
@@ -0,0 +1,15 @@
+.. _nsper:
+
+Near-Sided Perspective Projection
+=================================
+
+The near-sided perspective projection displays the earth as a satellite 
+(in orbit at an arbitrary altitude above the earth) would see it.
+
+.. literalinclude:: figures/nsper_full.py
+
+.. image:: figures/nsper_full.png
+
+.. literalinclude:: figures/nsper_partial.py
+
+.. image:: figures/nsper_partial.png


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

SF.net SVN: matplotlib:[8132] trunk/toolkits/basemap/doc/users

From: <js...@us...> - 2010-02-15 02:34:45

Revision: 8132
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=8132&view=rev
Author:   jswhit
Date:     2010-02-15 02:34:39 +0000 (Mon, 15 Feb 2010)

Log Message:
-----------
update with nsper

Modified Paths:
--------------
    trunk/toolkits/basemap/doc/users/graticule.rst
    trunk/toolkits/basemap/doc/users/intro.rst
    trunk/toolkits/basemap/doc/users/mapsetup.rst

Modified: trunk/toolkits/basemap/doc/users/graticule.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/graticule.rst	2010-02-15 02:31:33 UTC (rev 8131)
+++ trunk/toolkits/basemap/doc/users/graticule.rst	2010-02-15 02:34:39 UTC (rev 8132)
@@ -8,10 +8,10 @@
 :func:`~mpl_toolkits.basemap.Basemap.drawparallels` and
 :func:`~mpl_toolkits.basemap.Basemap.drawmeridians` instance methods.
 The longitude and latitude lines can be labelled where they intersect
-the map projection boundary.  There are four exceptions:  meridians
+the map projection boundary.  There are a few exceptions:  meridians
 and parallels cannot be labelled on maps with 
-``proj`` set to ``ortho`` (orthographic) or
-``vandg`` (van der Grinten),
+``proj`` set to ``ortho`` (orthographic), ``geos`` (geostationary),
+``vandg`` (van der Grinten) or ``nsper`` (near-sided perspective),
 and meridians cannot be labelled on maps with 
 ``proj`` set to ``robin`` (robinson), ``mbtfpq``
 (McBryde-Thomas Flat Polar Quartic), ``moll`` (mollweide) or ``sinu``

Modified: trunk/toolkits/basemap/doc/users/intro.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/intro.rst	2010-02-15 02:31:33 UTC (rev 8131)
+++ trunk/toolkits/basemap/doc/users/intro.rst	2010-02-15 02:34:39 UTC (rev 8132)
@@ -11,7 +11,7 @@
 `CDAT <http://www-pcmdi.llnl.gov/software/cdat/support/vcs/vcs.html>`_
 are other libraries that provide similar capabilities in Python.
 
-Basemap does not do any plotting on it's own, but provides the facilities to transform coordinates to one of 22 different map projections (using the 
+Basemap does not do any plotting on it's own, but provides the facilities to transform coordinates to one of 23 different map projections (using the 
 `PROJ.4 <http://trac.osgeo.org/proj/>`_ C library).  `Matplotlib
 <http://matplotlib.sourceforge.net>`_ is then
 used to plot contours, images, vectors, lines or points

Modified: trunk/toolkits/basemap/doc/users/mapsetup.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/mapsetup.rst	2010-02-15 02:31:33 UTC (rev 8131)
+++ trunk/toolkits/basemap/doc/users/mapsetup.rst	2010-02-15 02:34:39 UTC (rev 8132)
@@ -6,7 +6,7 @@
 In order to represent the curved surface of the earth on a two-dimensional
 map, a map projection is needed. Since this cannot be done without
 distortion, there are many map projections, each with it's own advantages
-and disadvantages. Basemap provides 22 different map projections.
+and disadvantages. Basemap provides 23 different map projections.
 Some are global, some can only represent a portion of the globe. When
 a :class:`~mpl_toolkits.basemap.Basemap` class instance is
 created, the desired map projection must
@@ -37,6 +37,7 @@
     gnomon.rst
     ortho.rst
     geos.rst
+    nsper.rst
     moll.rst
     robin.rst
     sinu.rst


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

SF.net SVN: matplotlib:[8865] trunk/toolkits/basemap/doc/users

From: <js...@us...> - 2010-12-30 12:53:30

Revision: 8865
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=8865&view=rev
Author:   jswhit
Date:     2010-12-30 12:53:23 +0000 (Thu, 30 Dec 2010)

Log Message:
-----------
add info for Hammer projection.

Modified Paths:
--------------
    trunk/toolkits/basemap/doc/users/graticule.rst
    trunk/toolkits/basemap/doc/users/mapsetup.rst

Added Paths:
-----------
    trunk/toolkits/basemap/doc/users/figures/hammer.py
    trunk/toolkits/basemap/doc/users/hammer.rst

Added: trunk/toolkits/basemap/doc/users/figures/hammer.py
===================================================================
--- trunk/toolkits/basemap/doc/users/figures/hammer.py	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/figures/hammer.py	2010-12-30 12:53:23 UTC (rev 8865)
@@ -0,0 +1,14 @@
+from mpl_toolkits.basemap import Basemap
+import numpy as np
+import matplotlib.pyplot as plt
+# lon_0 is central longitude of projection.
+# resolution = 'c' means use crude resolution coastlines.
+m = Basemap(projection='hammer',lon_0=0,resolution='c')
+m.drawcoastlines()
+m.fillcontinents(color='coral',lake_color='aqua')
+# draw parallels and meridians.
+m.drawparallels(np.arange(-90.,120.,30.))
+m.drawmeridians(np.arange(0.,420.,60.))
+m.drawmapboundary(fill_color='aqua') 
+plt.title("Hammer Projection")
+plt.savefig('hammer.png')

Modified: trunk/toolkits/basemap/doc/users/graticule.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/graticule.rst	2010-12-30 12:49:13 UTC (rev 8864)
+++ trunk/toolkits/basemap/doc/users/graticule.rst	2010-12-30 12:53:23 UTC (rev 8865)
@@ -14,7 +14,8 @@
 ``vandg`` (van der Grinten) or ``nsper`` (near-sided perspective),
 and meridians cannot be labelled on maps with 
 ``proj`` set to ``robin`` (robinson), ``mbtfpq``
-(McBryde-Thomas Flat Polar Quartic), ``moll`` (mollweide) or ``sinu``
+(McBryde-Thomas Flat Polar Quartic), ``moll`` (Mollweide),
+``hammer`` (Hammer), or ``sinu``
 (sinusoidal).  This is because the lines can be very close 
 together where they intersect the boundary on these maps, so that
 they really need to be labelled manually on the interior of the plot.

Added: trunk/toolkits/basemap/doc/users/hammer.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/hammer.rst	                        (rev 0)
+++ trunk/toolkits/basemap/doc/users/hammer.rst	2010-12-30 12:53:23 UTC (rev 8865)
@@ -0,0 +1,10 @@
+.. _hammer:
+
+Hammer Projection
+====================
+
+The hammer projection is a global, elliptical, equal-area projection.  
+
+.. literalinclude:: figures/hammer.py
+
+.. image:: figures/hammer.png

Modified: trunk/toolkits/basemap/doc/users/mapsetup.rst
===================================================================
--- trunk/toolkits/basemap/doc/users/mapsetup.rst	2010-12-30 12:49:13 UTC (rev 8864)
+++ trunk/toolkits/basemap/doc/users/mapsetup.rst	2010-12-30 12:53:23 UTC (rev 8865)
@@ -6,7 +6,7 @@
 In order to represent the curved surface of the earth on a two-dimensional
 map, a map projection is needed. Since this cannot be done without
 distortion, there are many map projections, each with it's own advantages
-and disadvantages. Basemap provides 23 different map projections.
+and disadvantages. Basemap provides 24 different map projections.
 Some are global, some can only represent a portion of the globe. When
 a :class:`~mpl_toolkits.basemap.Basemap` class instance is
 created, the desired map projection must
@@ -39,6 +39,7 @@
     geos.rst
     nsper.rst
     moll.rst
+    hammer.rst
     robin.rst
     sinu.rst
     cyl.rst


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.