/usr/lib64/python2.6/site-packages/matplotlib
Edit: /usr/lib64/python2.6/site-packages/matplotlib/legend.pyc (23551B)
6Jc @ s2 d Z d d k l Z d d k Z d d k Z d d k l Z d d k l Z l
Z
d d k l Z l
Z
l Z l Z d d k l Z d d k l Z d d k l Z l Z l Z l Z d d
k l Z l Z l Z d d k l Z l Z l Z l! Z! d d k" l# Z# l$ Z$ l% Z% l& Z& d
e f d YZ' d S( s
Place a legend on the axes at location loc. Labels are a
sequence of strings and loc can be a string or an integer
specifying the legend location
The location codes are
'best' : 0, (only implemented for axis legends)
'upper right' : 1,
'upper left' : 2,
'lower left' : 3,
'lower right' : 4,
'right' : 5,
'center left' : 6,
'center right' : 7,
'lower center' : 8,
'upper center' : 9,
'center' : 10,
Return value is a sequence of text, line instances that make
up the legend
i( t divisionN( t rcParams( t Artistt allow_rasterization( t is_string_liket iterablet silent_listt safezip( t FontProperties( t Line2D( t Patcht Rectanglet Shadowt FancyBboxPatch( t LineCollectiont RegularPolyCollectiont CircleCollection( t Bboxt BboxBaset TransformedBboxt BboxTransformTo( t HPackert VPackert TextAreat DrawingAreat Legendc B s e Z d Z h d d 6d d 6d d 6d d 6d d
6d d 6d
d 6d d 6d d 6d d 6d d 6Z d Z d Z d- d- d- d d- d- d- d- d- d- d- d- d- d- d- d- d- d d- d- d- d- d- d- d Z d Z d Z d Z
e d Z d- d Z
d Z d Z d Z d! Z d" Z d# Z d$ Z d% Z d& Z d' Z d( Z d) Z d- d* Z d+ Z d- d, Z RS(. s
Place a legend on the axes at location loc. Labels are a
sequence of strings and loc can be a string or an integer
specifying the legend location
The location codes are::
'best' : 0, (only implemented for axis legends)
'upper right' : 1,
'upper left' : 2,
'lower left' : 3,
'lower right' : 4,
'right' : 5,
'center left' : 6,
'center right' : 7,
'lower center' : 8,
'upper center' : 9,
'center' : 10,
loc can be a tuple of the noramilzed coordinate values with
respect its parent.
Return value is a sequence of text, line instances that make
up the legend
i t besti s upper righti s
upper lefti s
lower lefti s lower righti t righti s center lefti s center righti s lower centeri s upper centeri
t centerc C s d S( NR ( ( t self( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt __str__T s c ( C s~ d d k l } d d k l } t i | | d7 j o t d t d | _ nR t
| t o8 t | | _ d | j o | i i t d q n
| | _ | i i
| _ d d d d d
g } t } xK | D]C } | | d7 j o t d | }! n | | }! t | | |! q Wh d d
6d d 6d d 6d d 6d d 6}" | i }# t |# i |# i | i }$ x |" i D] \ }% }& | |% d7 j oJ | |& d7 j o9 t i d |& |% f t t | |& | |% |$ q~n | |& d7 j o t | |& t d |& q~t | |& | |& q~W~ t | } t | d j o
d } n | | _ | i d j o t d | n | d7 j o t i d8 d9 d: g | _ n t i! | | _ t" | i t | i d }' t i# | i |' | i$ | _ d7 | _% t
| | o t& | _' | i( | i) n7 t
| | o t* | _' | i( | n
t+ d | | _, | d7 j o0 t d } | i' o | d; j o
d" } qn t- | o | | i. j op | i' o3 t i d# | d$ i/ | i. i0 f d } qLt i d% | d$ i/ | i. i0 f d } qP| i. | } n | i' o$ | d j o t i d& d } n | | _1 | | _2 | i3 | | t4 d' d< d) d* d+ d* d, d- d. d/ d0 | i d1 t& | _5 | d7 j o t d2 } n | t& j o | i5 i6 d3 d
d d4 d5 n | i5 i6 d6 d
d | i7 | i5 t& | _8 | i9 | | | i: | | i | _; d7 S(= s
- *parent* : the artist that contains the legend
- *handles* : a list of artists (lines, patches) to add to the legend
- *labels* : a list of strings to label the legend
Optional keyword arguments:
================ ==================================================================
Keyword Description
================ ==================================================================
loc a location code
prop the font property
markerscale the relative size of legend markers vs. original
numpoints the number of points in the legend for line
scatterpoints the number of points in the legend for scatter plot
scatteryoffsets a list of yoffsets for scatter symbols in legend
fancybox if True, draw a frame with a round fancybox. If None, use rc
shadow if True, draw a shadow behind legend
ncol number of columns
borderpad the fractional whitespace inside the legend border
labelspacing the vertical space between the legend entries
handlelength the length of the legend handles
handletextpad the pad between the legend handle and text
borderaxespad the pad between the axes and legend border
columnspacing the spacing between columns
title the legend title
bbox_to_anchor the bbox that the legend will be anchored.
bbox_transform the transform for the bbox. transAxes if None.
================ ==================================================================
The dimensions of pad and spacing are given as a fraction of the
_fontsize. Values from rcParams will be used if None.
Users can specify any arbitrary location for the legend using the
*bbox_to_anchor* keyword argument. bbox_to_anchor can be an instance
of BboxBase(or its derivatives) or a tuple of 2 or 4 floats.
See :meth:`set_bbox_to_anchor` for more detail.
The legend location can be specified by setting *loc* with a tuple of
2 floats, which is interpreted as the lower-left corner of the legend
in the normalized axes coordinate.
i( t Axes( t Figuret sizes legend.fontsizet numpointst markerscalet shadowt
columnspacingt
scatterpointss legend.t borderpadt padt labelspacingt labelsept handlelengtht handlelent
handletextpadt
handletextsept
borderaxespadt axespads Use '%s' instead of '%s'.i i i s! numpoints must be >= 0; it was %dg @g @g @g @s, Legend needs either Axes or Figure as parents
legend.locR s upper rightsL Unrecognized location "%s". Falling back on "best"; valid locations are
%s
s
sS Unrecognized location "%s". Falling back on "upper right"; valid locations are
%s
si Automatic legend placement (loc="best") not implemented for figure legend. Falling back on "upper right".t xyg t widthg ?t heightt facecolort wt edgecolort kt mutation_scalet snaps legend.fancyboxt roundt
rounding_sizeg?t squareNg ?g ?g ?( i R ( g g (< t matplotlib.axesR t matplotlib.figureR R t __init__t NoneR R t propt
isinstancet dictt set_sizet get_size_in_pointst _fontsizet localst setattrt bboxt minR2 R3 t itemst warningst warnt DeprecationWarningt listt lent _ncolR" t
ValueErrort npt arrayt _scatteryoffsetst asarrayt intt tileR& t _legend_boxt Truet isaxest
set_figuret figuret Falset TypeErrort parentR t codest joint keyst _loct _modet set_bbox_to_anchorR
t legendPatcht set_boxstylet _set_artist_propst
_drawFramet _init_legend_boxt set_titlet _last_fontsize_points(( R R` t handlest labelst locR" R# R& t scatteryoffsetsRA R( R* R, R. R0 R' R) R+ R- R/ R% t ncolt modet fancyboxR$ t titlet bbox_to_anchort bbox_transformR R t propnamest localdictt namet valuet deprecated_kwdsRI t axessize_fontsizeR7 t vt reps( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR? W s J
"
c C sN | i | i x$ | i D] } | i | i q W| i | i d S( sE
set the boilerplate props for artists added to axes
N( R\ R] t get_childrent
set_transformt
get_transform( R t at c( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyRi 7 s
c C s- | i | | | \ } } | | | | f S( s9 Helper function to locate the legend at its best position( t _find_best_position( R R2 R3 t xdescentt ydescentt renderert oxt oy( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt _findoffset_bestC s c C s t | i o^ t | i d j oH | i \ } } | i } | i | i | | i | i | } }
n@ t i d d | | } | i
| i | | i | \ } }
| | |
| f S( s; Heper function to locate the legend using the location codei i ( R Rd RP t get_bbox_to_anchort x0R2 t y0R3 R t from_boundst _get_anchored_bbox( R R2 R3 R R R t fxt fyRI t xt y( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt _findoffset_locH s & -'c sx | i p d S i d | i d j o
| i n
| i f d } | i i | i | i } | i d j o9 d | i
| i | } | i i | i
i | n | i o | i i } | i i | i | i | i | i | i i | | i o& t | i d d } | i n | i i n | i i i d d S( s* Draw everything that belongs to the legendNt legendi c s | | | | S( N( ( R2 R3 R R ( t _findoffsetR ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt
findoffsetg s t expandi i( R ( t get_visiblet
open_groupRd R R RY t
set_offsett points_to_pixelsRF Re R/ R' t set_widthR R2 Rj t get_window_extentRg t
set_boundsR R R3 t set_mutation_scaleR$ R t drawt close_group( R R R t fontsizeR( RI R$ ( ( R R s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR V s.
!
c C s) | d j o | i S| i | i Sd S( sm
Return the approximate height of the text. This is used to place
the legend handle.
N( R@ RF R ( R R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt _approx_text_height s
c , C s | i } g } g } t d d d d d | i } g } xI | D]A } t | d | d t d t } | i | i | i | q@ Wg }
| i d } d
} x| D]}
t |
t p t |
t
o
| i } n
| i } | d j o. t
i d | | i d | | } | } nB | d j o4 t
i d
| i | d } d | i | g } n t |
t o | | d t
i | i t } t | | } | i |
| i | | i d( | i d( | i d | i d | i | t | | t | } | i |
| i | | i d( | i d( | i d | | _ nt |
t ok t d d) d | i | d | | } | i |
| i | | i d( | i d( | i | nt |
t o | | d t
i | i t } t | | } | i | | i d( | i d( |
i! d
} |
i" d
} |
i# d
} | i$ | | i% | | d
d( j o | i& | d n | i | n2t |
t o| | i' } t( |
i) t* |
i) } } | i d j o d | | | | g } n% | | t
i d
d | i | } t+ |
|
i, d |
i- d | d t. | | d | i/ } | i |
| i0 | i1 | i d( | i d( | i | nt |
t
o | | i' } t( |
i) t* |
i) } } | i d j o d | | | | g } n% | | t
i d
d | i | } t+ |
| d t. | | d | i/ } | i |
| i0 | i1 | i d( | i d( | i | n | i d( t2 d | i | d | d d
d | } | d }
| i3 |
t4 |
d o | i3 |
i n |
i | q Wt* | i5 t |
} t6 t |
| \ } } | | } t7 t8 d
| | d | d | d g | } t7 t8 | | d t |
| | g | }! t7 |
| }" g }# x | |! D] \ }$ }% g }& |" |$ |$ |% !D]; \ }' }( |& t9 d d
d | i: | d! |' |( g d" d qK~& }) |) d i; d i< t= |# i t> d d
d | i? | d" d d! |) q)W| i@ d# j o
d# }* n d$ }* | iA | }+ t9 d d
d |+ d" d d% |* d! |# | _B t d& | _C t> d | iD | d | i? | d" d' d! | iC | iB g | _E | iE i0 | i1 | | _F | | _G d( S(* s
Initiallize the legend_box. The legend_box is an instance of
the OffsetBox, which is packed with legend handles and
texts. Once packed, their location is calculated during the
drawing time.
t verticalalignmentt baselinet horizontalalignmentt leftt fontpropertiest textpropst multilinebaselinet minimumdescentgffffff?g i g333333?i i g ?g @t defaultR@ R1 R2 R3 i t rotationt sizest offsetst transOffsetR R it
_legmarkerR( t sept childrent alignR t fixedRs t R N( g g (H RF RC RA R RZ t appendt _textR RB R R R& R" RS t linspaceR+ R t onest shapet floatt update_fromRi t set_clip_boxR@ t
set_clip_patht
set_drawstylet
set_markerRP t
set_linestyleR R
R R t
get_linewidtht
get_dashest
get_colorst set_colort
set_linewidtht
set_dashesRU t maxt get_sizesRJ t typet get_numsidest get_rotationt zipR R\ R] R t
add_artistt hasattrRQ t divmodR t rangeR R- R t set_minimumdescentR^ R R) Re R% t _legend_handle_boxt _legend_title_boxR' RY t textst
legendHandles(, R Rn Ro R t text_listt handle_listt
label_propt
labelboxest lt textboxt handleboxesR3 t descentt handlet npointst xdatat xdata_markert ydatat leglinet legline_markert pt lwt dashest colort size_maxt size_minR t handleboxRr t nrowst num_largecolt num_smallcolt largecolt smallcolt handle_labelt columnboxt i0t dit _[1]t ht tt itemBoxesRs R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyRk s(
!
!
$
$
S
c
C s' | i p t | i } g } g } g } x\ | i D]Q } t | t p t | i } | i } | i | } | i | q6 Wx | i
D] } t | t p t t | t o, | i
} | i | i i | q | i } | i | i i | q W| | | g S( s{
Returns list of vertices and extents covered by the plot.
Returns a two long list.
First element is a list of (x, y) vertices (in
display-coordinates) covered by all the lines and line
collections, in the legend's handles.
Second element is a list of bounding boxes for all the patches in
the legend's handles.
( R[ t AssertionErrorR` t linesRB R t get_pathR t transform_pathR t patchesR
R t get_data_transformt get_bboxt transformedt get_extents(
R t axt verticest bboxesR R t patht transt tpatht transform( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt _auto_legend_data s*
c C s
| | _ d S( s$ b is a boolean. Set draw frame to bN( Rj ( R t b( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt
draw_frame s c C s( g } | i o | i | i n | S( s return a list of child artists( RY R ( R R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR s
c C s | i S( s6 return the Rectangle instance used to frame the legend( Rg ( R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt get_frame s c C s6 g } | i D]! } t | t o | | q q ~ S( s5 return a list of lines.Line2D instances in the legend( R RB R ( R R R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt get_lines s c C s? t d g } | i D]! } t | t o | | q q ~ S( s. return a list of patch instances in the legendR
( R R RB R
( R R R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt get_patches s c C s t d | i S( s1 return a list of text.Text instance in the legendt Text( R R ( R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt get_texts s c C sB | i i i | | o | i i t n | i i t d S( s set the legend titleN( R R t set_textt set_visibleRZ R^ ( R Ru ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyRl s c C s
| i i S( s) return Text instance for the legend title( R R ( R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt get_title s c C s
| i i S( s! return a extent of the the legend( Rg R ( R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR s c C s& | i d j o | i i S| i Sd S( sB
return the bbox that the legend will be anchored
N( t _bbox_to_anchorR@ R` RI ( R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR s c C s | d j o d | _ d St | t o
| | _ nz y t | } Wn) t j
o t d t | n X| d j o | d | d d d g } n t i | | _ | d j o t
| i i } n t
| i | | _ d S( s>
set the bbox that the legend will be anchored.
*bbox* can be a BboxBase instance, a tuple of [left, bottom,
width, height] in the given transform (normalized axes
coordinate if None), or a tuple of [left, bottom] where the
width and height will be assumed to be zero.
Ns Invalid argument for bbox : %si i i ( R@ R RB R RP R_ RR t strR R R R` RI R ( R RI R R ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyRf s
c C s | t d d j p t t d \ } } } } } }
} } }
} } h
d | 6d | 6d | 6d | 6d |
6d | 6d | 6d |
6d
| 6d | 6} | | } | i | i } | i | i | } | i | d | } | i | i f S(
s
Place the *bbox* inside the *parentbbox* according to a given
location code. Return the (x,y) coordinate of the bbox.
- loc: a location code in range(1, 11).
This corresponds to the possible values for self._loc, excluding "best".
- bbox: bbox to be placed, display coodinate units.
- parentbbox: a parent box which will contain the bbox. In
display coordinates.
i i t NEt NWt SWt SEt Et Wt St Nt Ct container( R R R RF t paddedR/ t anchoredR R ( R Rp RI t
parentbboxR t BESTt URt ULt LLt LRt Rt CLt CRt LCt UCR" t anchor_coefsR R R# t anchored_box( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR s" -
c C s | i p t | i \ } } } t i d d | | } g } t d t | i D]% }
| | i |
| | i | q[ ~ } g } x | D] \ } }
t i | |
| | } d } | i
| } | | i | 7} x, | D]$ } | i | o | d 7} q q W| |
} } | d j o | | f S| i
| | |
f f q W| d } x- | D]% } | d | d j o
| } qdqdW| d \ } } | | f S( s
Determine the best location to place the legend.
`consider` is a list of (x, y) pairs to consider as a potential
lower-left corner of the legend. All are display coords.
i i ( R[ R R
R R R RP Ra R R t count_containst count_overlapst intersects_bboxR ( R R2 R3 R t considert vertsR R RI R R t
candidatesR R t legendBoxt badnesst lineR R t minCandidatet candidate( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR ' s6 D
N( t __name__t
__module__t __doc__Ra t zorderR R@ R? Ri R R R R R Rk R
R R R R R R Rl R R R Rf R R ( ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyR ) st
1 (
! #(( R@ t
__future__R RL t numpyRS t
matplotlibR t matplotlib.artistR R t matplotlib.cbookR R R R t matplotlib.font_managerR t matplotlib.linesR t matplotlib.patchesR
R R R
t matplotlib.collectionsR R R t matplotlib.transformsR R R R t matplotlib.offsetboxR R R R R ( ( ( s7 /usr/lib64/python2.6/site-packages/matplotlib/legend.pyt
s "" ""