Revision: 5511
http://matplotlib.svn.sourceforge.net/matplotlib/?rev=5511&view=rev
Author: jswhit
Date: 2008-06-13 08:53:02 -0700 (Fri, 13 Jun 2008)
Log Message:
-----------
more work on docstrings.
Modified Paths:
--------------
trunk/toolkits/basemap/lib/mpl_toolkits/basemap/__init__.py
Modified: trunk/toolkits/basemap/lib/mpl_toolkits/basemap/__init__.py
===================================================================
--- trunk/toolkits/basemap/lib/mpl_toolkits/basemap/__init__.py 2008-06-13
15:38:46 UTC (rev 5510)
+++ trunk/toolkits/basemap/lib/mpl_toolkits/basemap/__init__.py 2008-06-13
15:53:02 UTC (rev 5511)
@@ -192,7 +192,7 @@
area_thresh coastline or lake with an area smaller than
area_thresh in km^2 will not be plotted.
Default 10000,1000,100,10,1 for resolution
- ``c``,``l``,``i``,``h``,``f``.
+ ``c``, ``l``, ``i``, ``h``, ``f``.
rsphere radius of the sphere used to define map projection
(default 6370997 meters, close to the arithmetic mean
radius of the earth). If given as a sequence, the
@@ -1613,46 +1613,49 @@
dashes=[1,1],labels=[0,0,0,0],labelstyle=None, \
fmt='%g',xoffset=None,yoffset=None,ax=None,**kwargs):
"""
- draw parallels (latitude lines).
+ Draw and label parallels (latitude lines).
- circles - list containing latitude values to draw (in degrees).
+ ============== ====================================================
+ Keyword Description
+ ============== ====================================================
+ circles sequence containing latitude values to draw (in
+ degrees).
+ color color to draw parallels (default black).
+ linewidth line width for parallels (default 1.)
+ zorder sets the zorder for parallels (if not specified,
+ uses default zorder for matplotlib.lines.Line2D
+ objects).
+ dashes dash pattern for parallels (default [1,1], i.e.
+ 1 pixel on, 1 pixel off).
+ labels list of 4 values (default [0,0,0,0]) that control
+ whether parallels are labelled where they intersect
+ the left, right, top or bottom of the plot. For
+ example labels=[1,0,0,1] will cause parallels
+ to be labelled where they intersect the left and
+ and bottom of the plot, but not the right and top.
+ labelstyle if set to "+/-", north and south latitudes are
+ labelled with "+" and "-", otherwise they are
+ labelled with "N" and "S".
+ fmt a format string to format the parallel labels
+ (default '%g') **or** a function that takes a
+ latitude value in degrees as it's only argument
+ and returns a formatted string.
+ xoffset label offset from edge of map in x-direction
+ (default is 0.01 times width of map in map
+ projection coordinates).
+ yoffset label offset from edge of map in y-direction
+ (default is 0.01 times height of map in map
+ projection coordinates).
+ ax axes instance (overrides default axes instance)
+ \**kwargs additional keyword arguments controlling text
+ for labels that are passed on to
+ the text method of the axes instance (see
+ matplotlib.pyplot.text documentation).
+ ============== ====================================================
- color - color to draw parallels (default black).
-
- linewidth - line width for parallels (default 1.)
-
- zorder - sets the zorder for parallels (if not specified,
- uses default zorder for Line2D class).
-
- dashes - dash pattern for parallels (default [1,1], i.e. 1 pixel on,
- 1 pixel off).
-
- labels - list of 4 values (default [0,0,0,0]) that control whether
- parallels are labelled where they intersect the left, right, top or
- bottom of the plot. For example labels=[1,0,0,1] will cause parallels
- to be labelled where they intersect the left and bottom of the plot,
- but not the right and top.
-
- labelstyle - if set to "+/-", north and south latitudes are labelled
- with "+" and "-", otherwise they are labelled with "N" and "S".
-
- fmt can be is a format string to format the parallel labels
- (default '%g') or a function that takes a latitude value
- in degrees as it's only argument and returns a formatted string.
-
- xoffset - label offset from edge of map in x-direction
- (default is 0.01 times width of map in map projection coordinates).
-
- yoffset - label offset from edge of map in y-direction
- (default is 0.01 times height of map in map projection coordinates).
-
- ax - axes instance (overrides default axes instance)
-
- additional keyword arguments control text properties for labels (see
- matplotlib.pyplot.text documentation)
-
- returns a dictionary whose keys are the parallels, and
- whose values are tuples containing lists of the Line2D and Text
instances
+ returns a dictionary whose keys are the parallel values, and
+ whose values are tuples containing lists of the
+ matplotlib.lines.Line2D and matplotlib.text.Text instances
associated with each parallel.
"""
# get current axes instance (if none specified).
@@ -1865,46 +1868,49 @@
dashes=[1,1],labels=[0,0,0,0],labelstyle=None,\
fmt='%g',xoffset=None,yoffset=None,ax=None,**kwargs):
"""
- draw meridians (longitude lines).
+ Draw and label meridians (longitude lines).
- meridians - list containing longitude values to draw (in degrees).
+ ============== ====================================================
+ Keyword Description
+ ============== ====================================================
+ meridians sequence containing longitude values to draw (in
+ degrees).
+ color color to draw meridians (default black).
+ linewidth line width for meridians (default 1.)
+ zorder sets the zorder for meridians (if not specified,
+ uses default zorder for matplotlib.lines.Line2D
+ objects).
+ dashes dash pattern for meridians (default [1,1], i.e.
+ 1 pixel on, 1 pixel off).
+ labels list of 4 values (default [0,0,0,0]) that control
+ whether meridians are labelled where they intersect
+ the left, right, top or bottom of the plot. For
+ example labels=[1,0,0,1] will cause meridians
+ to be labelled where they intersect the left and
+ and bottom of the plot, but not the right and top.
+ labelstyle if set to "+/-", east and west longitudes are
+ labelled with "+" and "-", otherwise they are
+ labelled with "E" and "W".
+ fmt a format string to format the meridian labels
+ (default '%g') **or** a function that takes a
+ longitude value in degrees as it's only argument
+ and returns a formatted string.
+ xoffset label offset from edge of map in x-direction
+ (default is 0.01 times width of map in map
+ projection coordinates).
+ yoffset label offset from edge of map in y-direction
+ (default is 0.01 times height of map in map
+ projection coordinates).
+ ax axes instance (overrides default axes instance)
+ \**kwargs additional keyword arguments controlling text
+ for labels that are passed on to
+ the text method of the axes instance (see
+ matplotlib.pyplot.text documentation).
+ ============== ====================================================
- color - color to draw meridians (default black).
-
- linewidth - line width for meridians (default 1.)
-
- zorder - sets the zorder for meridians (if not specified,
- uses default zorder for Line2D class).
-
- dashes - dash pattern for meridians (default [1,1], i.e. 1 pixel on,
- 1 pixel off).
-
- labels - list of 4 values (default [0,0,0,0]) that control whether
- meridians are labelled where they intersect the left, right, top or
- bottom of the plot. For example labels=[1,0,0,1] will cause meridians
- to be labelled where they intersect the left and bottom of the plot,
- but not the right and top.
-
- labelstyle - if set to "+/-", east and west longitudes are labelled
- with "+" and "-", otherwise they are labelled with "E" and "W".
-
- fmt can be is a format string to format the meridian labels
- (default '%g') or a function that takes a longitude value
- in degrees as it's only argument and returns a formatted string.
-
- xoffset - label offset from edge of map in x-direction
- (default is 0.01 times width of map in map projection coordinates).
-
- yoffset - label offset from edge of map in y-direction
- (default is 0.01 times height of map in map projection coordinates).
-
- ax - axes instance (overrides default axes instance)
-
- additional keyword arguments control text properties for labels (see
- matplotlib.pyplot.text documentation)
-
- returns a dictionary whose keys are the meridians, and
- whose values are tuples containing lists of the Line2D and Text
instances
+ returns a dictionary whose keys are the meridian values, and
+ whose values are tuples containing lists of the
+ matplotlib.lines.Line2D and matplotlib.text.Text instances
associated with each meridian.
"""
# get current axes instance (if none specified).
@@ -2102,8 +2108,8 @@
def gcpoints(self,lon1,lat1,lon2,lat2,npoints):
"""
- compute npoints points along a great circle with endpoints
- (lon1,lat1) and (lon2,lat2).
+ compute ``points`` points along a great circle with endpoints
+ ``(lon1,lat1)`` and ``(lon2,lat2)``.
Returns arrays x,y with map projection coordinates.
"""
@@ -2118,21 +2124,25 @@
def drawgreatcircle(self,lon1,lat1,lon2,lat2,del_s=100.,**kwargs):
"""
- draw a great circle on the map.
+ Draw a great circle on the map.
- lon1,lat1 - longitude,latitude of one endpoint of the great circle.
+ ==============
=======================================================
+ Keyword Description
+ ==============
=======================================================
+ lon1,lat1 longitude,latitude of one endpoint of the great
circle.
+ lon2,lat2 longitude,latitude of the other endpoint of the great
+ circle.
+ del_s points on great circle computed every del_s kilometers
+ (default 100).
+ \**kwargs other keyword arguments are passed on to :meth:`plot`
+ method of Basemap instance.
+ ==============
=======================================================
- lon2,lat2 - longitude,latitude of the other endpoint of the great
circle.
+ .. note::
+ Cannot handle situations in which the great circle intersects
+ the edge of the map projection domain, and then re-enters the domain.
- del_s - points on great circle computed every delta kilometers
(default 100).
-
- Other keyword arguments (\**kwargs) control plotting of great circle
line,
- see matplotlib.pyplot.plot documentation for details.
-
- Cannot handle situations in which the great circle intersects
- the edge of the map projection domain, and then re-enters the domain.
-
- Returns a Line2D object.
+ Returns a matplotlib.lines.Line2D object.
"""
# use great circle formula for a perfect sphere.
gc = pyproj.Geod(a=self.rmajor,b=self.rminor)
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
-------------------------------------------------------------------------
Check out the new SourceForge.net Marketplace.
It's the best place to buy or sell services for
just about anything Open Source.
http://sourceforge.net/services/buy/index.php
_______________________________________________
Matplotlib-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/matplotlib-checkins
