@header@
 
 
matplotlib.lines
index
/home/jdhunter/dev/lib/python2.5/site-packages/matplotlib/lines.py

This module contains all the 2D line class which can draw with a
variety of line styles, markers and colors

 
Modules
       
matplotlib.agg
matplotlib.artist
matplotlib.numerix.ma
math
numpy
sys
warnings

 
Classes
       
matplotlib.artist.Artist
Line2D

 
class Line2D(matplotlib.artist.Artist)
     Methods defined here:
__init__(self, xdata, ydata, linewidth=None, linestyle=None, color=None, marker=None, markersize=None, markeredgewidth=None, markeredgecolor=None, markerfacecolor=None, antialiased=None, dash_capstyle=None, solid_capstyle=None, dash_joinstyle=None, solid_joinstyle=None, pickradius=5, **kwargs)
Create a Line2D instance with x and y data in sequences xdata,
ydata
 
The kwargs are Line2D properties:
  alpha: float
  animated: [True | False]
  antialiased or aa: [True | False]
  clip_box: a matplotlib.transform.Bbox instance
  clip_on: [True | False]
  color or c: any matplotlib color
  dash_capstyle: ['butt' | 'round' | 'projecting']
  dash_joinstyle: ['miter' | 'round' | 'bevel']
  dashes: sequence of on/off ink in points
  data: (npy.array xdata, npy.array ydata)
  figure: a matplotlib.figure.Figure instance
  label: any string
  linestyle or ls: [ '-' | '--' | '-.' | ':' | 'steps' | 'None' | ' ' | '' ]
  linewidth or lw: float value in points
  lod: [True | False]
  marker: [ '+' | ',' | '.' | '1' | '2' | '3' | '4'
  markeredgecolor or mec: any matplotlib color
  markeredgewidth or mew: float value in points (default 5)
  markerfacecolor or mfc: any matplotlib color
  markersize or ms: float
  pickradius: mouse event radius for pick items in points (default 5)
  solid_capstyle: ['butt' | 'round' |  'projecting']
  solid_joinstyle: ['miter' | 'round' | 'bevel']
  transform: a matplotlib.transform transformation instance
  visible: [True | False]
  xdata: npy.array
  ydata: npy.array
  zorder: any number
__str__(self)
contains(self, mouseevent)
Test whether the mouse event occurred on the line.  The pick radius determines
the precision of the location test (usually within five points of the value).  Use
get/set pickradius() to view or modify it.
 
Returns True if any values are within the radius along with {'ind': pointlist},
npy.where pointlist is the set of points within the radius.
 
TODO: sort returned indices by distance
draw(self, renderer)
get_aa(self)
alias for get_antialiased
get_antialiased(self)
get_c(self)
alias for get_color
get_color(self)
get_dash_capstyle(self)
Get the cap style for dashed linestyles
get_dash_joinstyle(self)
Get the join style for dashed linestyles
get_linestyle(self)
get_linewidth(self)
get_ls(self)
alias for get_linestyle
get_lw(self)
alias for get_linewidth
get_marker(self)
get_markeredgecolor(self)
get_markeredgewidth(self)
get_markerfacecolor(self)
get_markersize(self)
get_mec(self)
alias for get_markeredgecolor
get_mew(self)
alias for get_markeredgewidth
get_mfc(self)
alias for get_markerfacecolor
get_ms(self)
alias for get_markersize
get_pickradius(self)
return the pick radius used for containment tests
get_solid_capstyle(self)
Get the cap style for solid linestyles
get_solid_joinstyle(self)
Get the join style for solid linestyles
get_window_extent(self, renderer)
get_xdata(self, orig=True)
return the xdata; if orig is true return the original data,
else the processed data
get_ydata(self, orig=True)
return the ydata; if orig is true return the original data,
else the processed data
is_dashed(self)
return True if line is dashstyle
recache(self)
set_aa(self, val)
alias for set_antialiased
set_antialiased(self, b)
True if line should be drawin with antialiased rendering
 
ACCEPTS: [True | False]
set_axes(self, ax)
set_c(self, val)
alias for set_color
set_color(self, color)
Set the color of the line
 
ACCEPTS: any matplotlib color
set_dash_capstyle(self, s)
Set the cap style for dashed linestyles
ACCEPTS: ['butt' | 'round' | 'projecting']
set_dash_joinstyle(self, s)
Set the join style for dashed linestyles
ACCEPTS: ['miter' | 'round' | 'bevel']
set_dashes(self, seq)
Set the dash sequence, sequence of dashes with on off ink in
points.  If seq is empty or if seq = (None, None), the
linestyle will be set to solid.
 
ACCEPTS: sequence of on/off ink in points
set_data(self, *args)
Set the x and y data
 
ACCEPTS: (npy.array xdata, npy.array ydata)
set_linestyle(self, linestyle)
Set the linestyle of the line
 
ACCEPTS: [ '-' | '--' | '-.' | ':' | 'steps' | 'None' | ' ' | '' ]
set_linewidth(self, w)
Set the line width in points
 
ACCEPTS: float value in points
set_ls(self, val)
alias for set_linestyle
set_lw(self, val)
alias for set_linewidth
set_marker(self, marker)
Set the line marker
 
ACCEPTS: [ '+' | ',' | '.' | '1' | '2' | '3' | '4'
         | '<' | '>' | 'D' | 'H' | '^' | '_' | 'd'
         | 'h' | 'o' | 'p' | 's' | 'v' | 'x' | '|'
         | TICKUP | TICKDOWN | TICKLEFT | TICKRIGHT
         | 'None' | ' ' | '' ]
set_markeredgecolor(self, ec)
Set the marker edge color
 
ACCEPTS: any matplotlib color
set_markeredgewidth(self, ew)
Set the marker edge width in points
 
ACCEPTS: float value in points
set_markerfacecolor(self, fc)
Set the marker face color
 
ACCEPTS: any matplotlib color
set_markersize(self, sz)
Set the marker size in points
 
ACCEPTS: float
set_mec(self, val)
alias for set_markeredgecolor
set_mew(self, val)
alias for set_markeredgewidth
set_mfc(self, val)
alias for set_markerfacecolor
set_ms(self, val)
alias for set_markersize
set_picker(self, p)
Sets the event picker details for the line.
 
Accepts: float distance in points or callable pick function fn(artist,event)
set_pickradius(self, d)
Sets the pick radius used for containment tests
 
Accepts: float distance in points.
set_solid_capstyle(self, s)
Set the cap style for solid linestyles
ACCEPTS: ['butt' | 'round' |  'projecting']
set_solid_joinstyle(self, s)
Set the join style for solid linestyles
ACCEPTS: ['miter' | 'round' | 'bevel']
set_xdata(self, x)
Set the data npy.array for x
 
ACCEPTS: npy.array
set_ydata(self, y)
Set the data npy.array for y
 
ACCEPTS: npy.array
update_from(self, other)
copy properties from other to self

Data and other attributes defined here:
filled_markers = ('o', '^', 'v', '<', '>', 's', 'd', 'D', 'h', 'H', 'p')
lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted', 'None': '_draw_nothing', 'steps': '_draw_steps'}
markers = {0: '_draw_tickleft', 1: '_draw_tickright', 2: '_draw_tickup', 3: '_draw_tickdown', 4: '_draw_caretleft', 5: '_draw_caretright', 6: '_draw_caretup', 7: '_draw_caretdown', '': '_draw_nothing', ' ': '_draw_nothing', ...}
validCap = ('butt', 'round', 'projecting')
validJoin = ('miter', 'round', 'bevel')
zorder = 2

Methods inherited from matplotlib.artist.Artist:
add_callback(self, func)
convert_xunits(self, x)
for artists in an axes, if the xaxis as units support,
convert x using xaxis unit type
convert_yunits(self, y)
for artists in an axes, if the yaxis as units support,
convert y using yaxis unit type
get_alpha(self)
Return the alpha value used for blending - not supported on all
backends
get_animated(self)
return the artist's animated state
get_axes(self)
return the axes instance the artist resides in, or None
get_clip_box(self)
Return artist clipbox
get_clip_on(self)
Return whether artist uses clipping
get_clip_path(self)
Return artist clip path
get_contains(self)
return the _contains test used by the artist, or None for default.
get_figure(self)
return the figure instance
get_label(self)
get_picker(self)
return the Pickeration instance used by this artist
get_transform(self)
return the Transformation instance used by this artist
get_visible(self)
return the artist's visiblity
get_zorder(self)
have_units(self)
return True if units are set on the x or y axes
hitlist(self, event)
List the children of the artist which contain the mouse event
is_figure_set(self)
is_transform_set(self)
Artist has transform explicity let
pchanged(self)
fire event when property changed
pick(self, mouseevent)
pick(mouseevent)
 
each child artist will fire a pick event if mouseevent is over
the artist and the artist has picker set
pickable(self)
return True if self is pickable
remove(self)
Remove the artist from the figure if possible.  The effect will not
be visible until the figure is redrawn, e.g., with ax.draw_idle().
Call ax.relim() to update the axes limits if desired.
 
Note: relim() will not see collections even if the collection
was added to axes with autolim=True.
 
Note: there is no support for removing the artist's legend entry.
remove_callback(self, oid)
set(self, **kwargs)
A tkstyle set command, pass kwargs to set properties
set_alpha(self, alpha)
Set the alpha value used for blending - not supported on
all backends
 
ACCEPTS: float
set_animated(self, b)
set the artist's animation state
 
ACCEPTS: [True | False]
set_clip_box(self, clipbox)
Set the artist's clip Bbox
 
ACCEPTS: a matplotlib.transform.Bbox instance
set_clip_on(self, b)
Set  whether artist uses clipping
 
ACCEPTS: [True | False]
set_clip_path(self, path)
Set the artist's clip path
 
ACCEPTS: an agg.path_storage instance
set_contains(self, picker)
Replace the contains test used by this artist. The new picker should
be a callable function which determines whether the artist is hit by the
mouse event:
 
    hit, props = picker(artist, mouseevent)
 
If the mouse event is over the artist, return hit=True and props
is a dictionary of properties you want returned with the contains test.
set_figure(self, fig)
Set the figure instance the artist belong to
 
ACCEPTS: a matplotlib.figure.Figure instance
set_label(self, s)
Set the line label to s for auto legend
 
ACCEPTS: any string
set_lod(self, on)
Set Level of Detail on or off.  If on, the artists may examine
things like the pixel width of the axes and draw a subset of
their contents accordingly
 
ACCEPTS: [True | False]
set_transform(self, t)
set the Transformation instance used by this artist
 
ACCEPTS: a matplotlib.transform transformation instance
set_visible(self, b)
set the artist's visiblity
 
ACCEPTS: [True | False]
set_zorder(self, level)
Set the zorder for the artist
 
ACCEPTS: any number
update(self, props)

Data and other attributes inherited from matplotlib.artist.Artist:
aname = 'Artist'

 
Functions
       
segment_hits(cx, cy, x, y, radius)
Determine if any line segments are within radius of a point. Returns
the list of line segments that are within that radius.
unmasked_index_ranges(mask, compressed=True)
Calculate the good data ranges in a masked 1-D npy.array, based on mask.
 
Returns Nx2 npy.array with each row the start and stop indices
for slices of the compressed npy.array corresponding to each of N
uninterrupted runs of unmasked values.
If optional argument compressed is False, it returns the
start and stop indices into the original npy.array, not the
compressed npy.array.
Returns None if there are no unmasked values.
 
Example:
 
y = ma.array(npy.arange(5), mask = [0,0,1,0,0])
#ii = unmasked_index_ranges(y.mask())
ii = unmasked_index_ranges(ma.getmask(y))
    # returns [[0,2,] [2,4,]]
 
y.compressed().filled()[ii[1,0]:ii[1,1]]
    # returns npy.array [3,4,]
    # (The 'filled()' method converts the masked npy.array to a numerix npy.array.)
 
#i0, i1 = unmasked_index_ranges(y.mask(), compressed=False)
i0, i1 = unmasked_index_ranges(ma.getmask(y), compressed=False)
    # returns [[0,3,] [2,5,]]
 
y.filled()[ii[1,0]:ii[1,1]]
    # returns npy.array [3,4,]

 
Data
        CARETDOWN = 7
CARETLEFT = 4
CARETRIGHT = 5
CARETUP = 6
LOG10 = 1
TICKDOWN = 3
TICKLEFT = 0
TICKRIGHT = 1
TICKUP = 2
colorConverter = <matplotlib.colors.ColorConverter instance at 0x85867ac>
division = _Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)
lineMarkers = {0: '_draw_tickleft', 1: '_draw_tickright', 2: '_draw_tickup', 3: '_draw_tickdown', 4: '_draw_caretleft', 5: '_draw_caretright', 6: '_draw_caretup', 7: '_draw_caretdown', '': '_draw_nothing', ' ': '_draw_nothing', ...}
lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted', 'None': '_draw_nothing', 'steps': '_draw_steps'}
rcParams = {'figure.subplot.right': 0.90000000000000002, 'm...persize': 'letter', 'svg.embed_char_paths': True}
verbose = <matplotlib.Verbose instance at 0x826eb6c>
@footer@