m[c@`sdZddlmZmZmZmZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZddlmZmZddljZddlmZdd lmZdd lmZmZmZmZdd lm Z m!Z!m"Z"m#Z#m$Z$dd l%m&Z&m'Z'm(Z(dd l%m)Z)m*Z*ddl+m,Z,m-Z-m.Z.m/Z/ddl+m0Z0ddl1m2Z2m3Z3m4Z4ddl5m6Z6de0fdYZ7dZ8e j9j:de8defdYZ;e<dZ=e<dZ>dZ?dS(uO The legend module defines the Legend class, which is responsible for drawing legends associated with axes and/or figures. .. important:: It is unlikely that you would ever create a Legend instance manually. Most users would normally create a legend via the :meth:`~matplotlib.axes.Axes.legend` function. For more details on legends there is also a :doc:`legend guide `. The Legend class can be considered as a container of legend handles and legend texts. Creation of corresponding legend handles from the plot elements in the axes or figures (e.g., lines, patches, etc.) are specified by the handler map, which defines the mapping between the plot elements and the legend handlers to be used (the default legend handlers are defined in the :mod:`~matplotlib.legend_handler` module). Note that not all kinds of artist are supported by the legend yet by default but it is possible to extend the legend handler's capabilities to support arbitrary objects. See the :doc:`legend guide ` for more information. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(trcParams(t docstring(tArtisttallow_rasterization(t silent_listt is_hashable(tFontProperties(tLine2D(tPatcht RectangletShadowtFancyBboxPatch(tLineCollectiontRegularPolyCollectiontCircleCollectiontPathCollectiontPolyCollection(tBboxtBboxBasetTransformedBbox(tBboxTransformTotBboxTransformFrom(tHPackertVPackertTextAreat DrawingArea(tDraggableOffsetBox(tErrorbarContainert BarContainert StemContaineri(tlegend_handlertDraggableLegendcB`s;eZeddZdZdZdZdZRS(uloccC`sQ||_|dkr!||_ntd|tj|||jd|dS(u Parameters ---------- update : string If "loc", update *loc* parameter of legend upon finalizing. If "bbox", update *bbox_to_anchor* parameter. ulocubboxu'update parameter '%s' is not supported.tuse_blitN(ulocubbox(tlegendt_updatet ValueErrorRt__init__t _legend_box(tselfR%R$tupdate((s0lib/python2.7/site-packages/matplotlib/legend.pyR(7s    cC`s|jj|S(N(R%tcontains(R*R%tevt((s0lib/python2.7/site-packages/matplotlib/legend.pyt artist_pickerJscC`sa|j}|jdkr+|j|n2|jdkrJ|j|ntd|jdS(Nulocubboxu'update parameter '%s' is not supported.(tget_loc_in_canvasR&t _update_loct_update_bbox_to_anchort RuntimeErrorR+(R*t loc_in_canvas((s0lib/python2.7/site-packages/matplotlib/legend.pytfinalize_offsetMs cC`sz|jj}|jdks-|jdkrO|jjd|jj}nt|}t|j||j_ dS(Ni( R%tget_bbox_to_anchortwidththeighttset_bbox_to_anchortNoneRttuplettransform_pointt_loc(R*R3tbboxt_bbox_transform((s0lib/python2.7/site-packages/matplotlib/legend.pyR0Xs cC`s2|jjj}|j|}|jj|dS(N(R%taxest transAxesR;R8(R*R3ttrt loc_in_bbox((s0lib/python2.7/site-packages/matplotlib/legend.pyR1fs(t__name__t __module__tFalseR(R.R4R0R1(((s0lib/python2.7/site-packages/matplotlib/legend.pyR#6s   u loc : int or string or pair of floats, default: :rc:`legend.loc` ('best' for axes, 'upper right' for figures) The location of the legend. Possible codes are: =============== ============= Location String Location Code =============== ============= 'best' 0 '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 =============== ============= Alternatively can be a 2-tuple giving ``x, y`` of the lower-left corner of the legend in axes coordinates (in which case ``bbox_to_anchor`` will be ignored). bbox_to_anchor : `.BboxBase` or pair of floats Specify any arbitrary location for the legend in `bbox_transform` coordinates (default Axes coordinates). For example, to put the legend's upper right hand corner in the center of the axes the following keywords can be used:: loc='upper right', bbox_to_anchor=(0.5, 0.5) ncol : integer The number of columns that the legend has. Default is 1. prop : None or :class:`matplotlib.font_manager.FontProperties` or dict The font properties of the legend. If None (default), the current :data:`matplotlib.rcParams` will be used. fontsize : int or float or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'} Controls the font size of the legend. If the value is numeric the size will be the absolute font size in points. String values are relative to the current default font size. This argument is only used if `prop` is not specified. numpoints : None or int The number of marker points in the legend when creating a legend entry for a `.Line2D` (line). Default is ``None``, which will take the value from :rc:`legend.numpoints`. scatterpoints : None or int The number of marker points in the legend when creating a legend entry for a `.PathCollection` (scatter plot). Default is ``None``, which will take the value from :rc:`legend.scatterpoints`. scatteryoffsets : iterable of floats The vertical offset (relative to the font size) for the markers created for a scatter plot legend entry. 0.0 is at the base the legend text, and 1.0 is at the top. To draw all markers at the same height, set to ``[0.5]``. Default is ``[0.375, 0.5, 0.3125]``. markerscale : None or int or float The relative size of legend markers compared with the originally drawn ones. Default is ``None``, which will take the value from :rc:`legend.markerscale`. markerfirst : bool If *True*, legend marker is placed to the left of the legend label. If *False*, legend marker is placed to the right of the legend label. Default is *True*. frameon : None or bool Control whether the legend should be drawn on a patch (frame). Default is ``None``, which will take the value from :rc:`legend.frameon`. fancybox : None or bool Control whether round edges should be enabled around the :class:`~matplotlib.patches.FancyBboxPatch` which makes up the legend's background. Default is ``None``, which will take the value from :rc:`legend.fancybox`. shadow : None or bool Control whether to draw a shadow behind the legend. Default is ``None``, which will take the value from :rc:`legend.shadow`. framealpha : None or float Control the alpha transparency of the legend's background. Default is ``None``, which will take the value from :rc:`legend.framealpha`. If shadow is activated and *framealpha* is ``None``, the default value is ignored. facecolor : None or "inherit" or a color spec Control the legend's background color. Default is ``None``, which will take the value from :rc:`legend.facecolor`. If ``"inherit"``, it will take :rc:`axes.facecolor`. edgecolor : None or "inherit" or a color spec Control the legend's background patch edge color. Default is ``None``, which will take the value from :rc:`legend.edgecolor` If ``"inherit"``, it will take :rc:`axes.edgecolor`. mode : {"expand", None} If `mode` is set to ``"expand"`` the legend will be horizontally expanded to fill the axes area (or `bbox_to_anchor` if defines the legend's size). bbox_transform : None or :class:`matplotlib.transforms.Transform` The transform for the bounding box (`bbox_to_anchor`). For a value of ``None`` (default) the Axes' :data:`~matplotlib.axes.Axes.transAxes` transform will be used. title : str or None The legend's title. Default is no title (``None``). borderpad : float or None The fractional whitespace inside the legend border. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.borderpad`. labelspacing : float or None The vertical space between the legend entries. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.labelspacing`. handlelength : float or None The length of the legend handles. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.handlelength`. handletextpad : float or None The pad between the legend handle and text. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.handletextpad`. borderaxespad : float or None The pad between the axes and legend border. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.borderaxespad`. columnspacing : float or None The spacing between columns. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.columnspacing`. handler_map : dict or None The custom dictionary mapping instances or types to a legend handler. This `handler_map` updates the default handler map found at :func:`matplotlib.legend.Legend.get_legend_handler_map`. t_legend_kw_doctLegendcB`seZdZi dd6dd6dd6dd6d d 6d d 6d d6dd6dd6dd6dd6Zd ZdZejeeee eeeeeeeeeeedeeeeeeeeeeedZ dZ dZ dZ ee e ZdZedZedZi eje6eje6eje6eje6eje6eje 6ej!e"6ejdej#e$6ej%e&6ej'e(6ej)e*6Z+e,d Z-e,d!Z.e,d"Z/d#Z0e1d$Z2e d%Z3d&Z4d'Z5d(Z6d)Z7d*Z8d+Z9d,Z:ed-Z;d.Z<d/Z=d0Z>d1Z?d2Z@ed3ZAd4ZBed5ZCd6ZDeeEd7d8ZFRS(9u6 Place a legend on the axes at location loc. iubestiu upper rightiu upper leftiu lower leftiu lower rightiurightiu center leftiu center rightiu lower centeri u upper centeri ucentercC`sdS(NuLegend((R*((s0lib/python2.7/site-packages/matplotlib/legend.pyt__str__/sc)C`s ddlm}ddlm} tj|| d:krs| d:k rZtd| |_qtdt d|_nMt | t rt| |_d| kr|jj t dqn | |_|jj |_g|_g|_d:|_||_t}!xjddd d d d d ddddg D]A}"|!|"d:krNt d|"}#n |!|"}#t||"|#q'W~!gg}$}%xtt||D]c\}&}'t |&tjr|&jdrtjdj|'|&q|$j|&|%j|'qW|$|%}}t|}t|dkr'd}n||_|j dkrRt!d|n| d:kr|t"j#d;d<d=g|_$nt"j%| |_$|j&t|j$d}(t"j'|j$|(|j& |_$d:|_(t ||rt)|_*||_+|j,|j-n4t || r,t.|_*|j,|n t/d||_0|d:kryt d}|j* ry|d>kryd}qynt |tjr ||j1kr|j*rtjd |d!j2|j1fd}qtjd"|d!j2|j1fd}q |j1|}n|j* r7|dkr7tjd#d}n||_3|j4|||d:krit d$}n|d%krt d&}n|d:krt d'}n|d%krt d(}nt5d)d?d+d,d-d,d.|d/|d0|jd1t)|_6|d:krt d2}n|r+|j6j7d3d4dd5d6n|j6j7d7d4d|j8|j6||_9|d:krvt d8|_9n|j:||||d:kr|r|j;j<dq|j;j<t d9n|j;j<|||_=|j>||j|_?d:|_@d:S(@uC Parameters ---------- parent : `~matplotlib.axes.Axes` or `.Figure` The artist that contains the legend. handles : sequence of `.Artist` A list of Artists (lines, patches) to be added to the legend. labels : sequence of strings A list of labels to show next to the artists. The length of handles and labels should be the same. If they are not, they are truncated to the smaller of both lengths. Other Parameters ---------------- loc : int or string or pair of floats, default: 'upper right' The location of the legend. Possible codes are: =============== ============= Location String Location Code =============== ============= 'best' 0 '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 =============== ============= Alternatively can be a 2-tuple giving ``x, y`` of the lower-left corner of the legend in axes coordinates (in which case ``bbox_to_anchor`` will be ignored). bbox_to_anchor : `.BboxBase` or pair of floats Specify any arbitrary location for the legend in `bbox_transform` coordinates (default Axes coordinates). For example, to put the legend's upper right hand corner in the center of the axes the following keywords can be used:: loc='upper right', bbox_to_anchor=(0.5, 0.5) ncol : integer The number of columns that the legend has. Default is 1. prop : None or :class:`matplotlib.font_manager.FontProperties` or dict The font properties of the legend. If None (default), the current :data:`matplotlib.rcParams` will be used. fontsize : int or float or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'} Controls the font size of the legend. If the value is numeric the size will be the absolute font size in points. String values are relative to the current default font size. This argument is only used if `prop` is not specified. numpoints : None or int The number of marker points in the legend when creating a legend entry for a `.Line2D` (line). Default is ``None``, which will take the value from :rc:`legend.numpoints`. scatterpoints : None or int The number of marker points in the legend when creating a legend entry for a `.PathCollection` (scatter plot). Default is ``None``, which will take the value from :rc:`legend.scatterpoints`. scatteryoffsets : iterable of floats The vertical offset (relative to the font size) for the markers created for a scatter plot legend entry. 0.0 is at the base the legend text, and 1.0 is at the top. To draw all markers at the same height, set to ``[0.5]``. Default is ``[0.375, 0.5, 0.3125]``. markerscale : None or int or float The relative size of legend markers compared with the originally drawn ones. Default is ``None``, which will take the value from :rc:`legend.markerscale`. markerfirst : bool If *True*, legend marker is placed to the left of the legend label. If *False*, legend marker is placed to the right of the legend label. Default is *True*. frameon : None or bool Control whether the legend should be drawn on a patch (frame). Default is ``None``, which will take the value from :rc:`legend.frameon`. fancybox : None or bool Control whether round edges should be enabled around the :class:`~matplotlib.patches.FancyBboxPatch` which makes up the legend's background. Default is ``None``, which will take the value from :rc:`legend.fancybox`. shadow : None or bool Control whether to draw a shadow behind the legend. Default is ``None``, which will take the value from :rc:`legend.shadow`. framealpha : None or float Control the alpha transparency of the legend's background. Default is ``None``, which will take the value from :rc:`legend.framealpha`. If shadow is activated and *framealpha* is ``None``, the default value is ignored. facecolor : None or "inherit" or a color spec Control the legend's background color. Default is ``None``, which will take the value from :rc:`legend.facecolor`. If ``"inherit"``, it will take :rc:`axes.facecolor`. edgecolor : None or "inherit" or a color spec Control the legend's background patch edge color. Default is ``None``, which will take the value from :rc:`legend.edgecolor` If ``"inherit"``, it will take :rc:`axes.edgecolor`. mode : {"expand", None} If `mode` is set to ``"expand"`` the legend will be horizontally expanded to fill the axes area (or `bbox_to_anchor` if defines the legend's size). bbox_transform : None or :class:`matplotlib.transforms.Transform` The transform for the bounding box (`bbox_to_anchor`). For a value of ``None`` (default) the Axes' :data:`~matplotlib.axes.Axes.transAxes` transform will be used. title : str or None The legend's title. Default is no title (``None``). borderpad : float or None The fractional whitespace inside the legend border. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.borderpad`. labelspacing : float or None The vertical space between the legend entries. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.labelspacing`. handlelength : float or None The length of the legend handles. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.handlelength`. handletextpad : float or None The pad between the legend handle and text. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.handletextpad`. borderaxespad : float or None The pad between the axes and legend border. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.borderaxespad`. columnspacing : float or None The spacing between columns. Measured in font-size units. Default is ``None``, which will take the value from :rc:`legend.columnspacing`. handler_map : dict or None The custom dictionary mapping instances or types to a legend handler. This `handler_map` updates the default handler map found at :func:`matplotlib.legend.Legend.get_legend_handler_map`. Notes ----- 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(tAxes(tFiguretsizeulegend.fontsizeusizeu numpointsu markerscaleushadowu columnspacingu scatterpointsu handleheightu borderpadu labelspacingu handlelengthu handletextpadu borderaxespadulegend.u_uVThe handle {!r} has a label of {!r} which cannot be automatically added to the legend.iiu numpoints must be > 0; it was %dg@g @g@g@u,Legend needs either Axes or Figure as parentu legend.locubestu upper rightuLUnrecognized location "%s". Falling back on "best"; valid locations are %s u uSUnrecognized location "%s". Falling back on "upper right"; valid locations are %s uiAutomatic legend placement (loc="best") not implemented for figure legend. Falling back on "upper right".ulegend.facecoloruinherituaxes.facecolorulegend.edgecoloruaxes.edgecolortxygR6g?R7t facecolort edgecolortmutation_scaletsnapulegend.fancyboxuroundtpadt rounding_sizeg?usquareulegend.frameonulegend.framealphaNg?g?g?(iubest(gg(Atmatplotlib.axesRItmatplotlib.figureRJRR(R9R tpropRt isinstancetdicttset_sizetget_size_in_pointst _fontsizettextst legendHandlest_legend_title_boxt_custom_handler_maptlocalstsetattrtziptsixt string_typest startswithtwarningstwarntformattappendtlisttlent_ncolt numpointsR'tnptarrayt_scatteryoffsetstasarrayt scatterpointsttileR)tTruetisaxesR?t set_figuretfigureREt TypeErrortparenttcodestjoint_modeR8Rt legendPatcht set_boxstylet_set_artist_propst _drawFramet_init_legend_boxt get_framet set_alphaR<t set_titlet_last_fontsize_pointst _draggable()R*RxthandlestlabelstlocRlt markerscalet markerfirstRqtscatteryoffsetsRUtfontsizet borderpadt labelspacingt handlelengtht handleheightt handletextpadt borderaxespadt columnspacingtncoltmodetfancyboxtshadowttitlet framealphaRNRMtbbox_to_anchortbbox_transformtframeont handler_mapRIRJt locals_viewtnametvaluet_labt_handtlabelthandletreps((s0lib/python2.7/site-packages/matplotlib/legend.pyR(2s                                                           cC`s?|j|j|jr(|j|_n|j|jdS(uF Set the boilerplate props for artists added to axes. N(RuRvRtR?t set_transformt get_transform(R*ta((s0lib/python2.7/site-packages/matplotlib/legend.pyR~s cC`s)||_t|_|jj|jdS(N(t _loc_realRststaleR)t set_offsett _findoffset(R*R((s0lib/python2.7/site-packages/matplotlib/legend.pyt_set_locs  cC`s|jS(N(R(R*((s0lib/python2.7/site-packages/matplotlib/legend.pyt_get_locsc C`s|jdkr-|j|||\}}n|jtjjkrtjdd||}|j|j||j|\}}nD|j\} } |j}|j |j | |j |j | }}||||fS(u%Helper function to locate the legend.i( R<t_find_best_positionRGRytvaluesRt from_boundst_get_anchored_bboxR5tx0R6ty0R7( R*R6R7txdescenttydescenttrenderertxtyR=tfxtfy((s0lib/python2.7/site-packages/matplotlib/legend.pyRs  )cC`s1|jsdS|jd|j|j}|jdkrvd|j|j|}|jj|j j |n|jj |}|j j |j|j|j |j|j j||jr|jrt|j dd}|j|n|j j|n|jj||jdt|_dS(u+Draw everything that belongs to the legend.Nulegenduexpandii(uexpand(t get_visiblet open_grouptpoints_to_pixelsRZR{RRR)t set_widthR5R6tget_window_extentR|t set_boundsRRR7tset_mutation_scaleRRRtdrawt close_groupRER(R*RRRQR=R((s0lib/python2.7/site-packages/matplotlib/legend.pyRs&      cC`s'|dkr|jS|j|jSdS(um Return the approximate height of the text. This is used to place the legend handle. N(R9RZR(R*R((s0lib/python2.7/site-packages/matplotlib/legend.pyt_approx_text_heights t update_funccC`s|jS(uF A class method that returns the default handler map. (t_default_handler_map(tcls((s0lib/python2.7/site-packages/matplotlib/legend.pytget_default_handler_map7scC`s ||_dS(u@ A class method to set the default handler map. N(R(RR((s0lib/python2.7/site-packages/matplotlib/legend.pytset_default_handler_map>scC`s|jj|dS(uC A class method to update the default handler map. N(RR+(RR((s0lib/python2.7/site-packages/matplotlib/legend.pytupdate_default_handler_mapEscC`s=|j}|jr5|j}|j|j|S|SdS(u) Return the handler map. N(RR^tcopyR+(R*tdefault_handler_mapthm((s0lib/python2.7/site-packages/matplotlib/legend.pytget_legend_handler_mapLs    cC`spt|r/y ||SWq/tk r+q/Xnx:t|jD]&}y ||SWqBtk rgqBXqBWdS(u Return a legend handler from *legend_handler_map* that corresponds to *orig_handler*. *legend_handler_map* should be a dictionary object (that is returned by the get_legend_handler_map method). It first checks if the *orig_handle* itself is a key in the *legend_hanler_map* and return the associated value. Otherwise, it checks for each of the classes in its method-resolution-order. If no matching key is found, it returns ``None``. N(R tKeyErrorttypetmroR9(tlegend_handler_mapt orig_handlet handle_type((s0lib/python2.7/site-packages/matplotlib/legend.pytget_legend_handlerZs     c! C`s|j}g}g}g}tddddd|j}d|j|jd} |j|j| } |j} xt||D]\} } |j| | }|dkrt j dj | |j dqt | d |d td t}td |j|d | ddd| }|j |j|j |j|| |||j ||fqW|rt|jt|}tt||\}}||}|dg||g|}tjdgtj|d g}t||}ng}g}x|D]\}}g||||!D]L\}}tddd|j|d|ra||gn ||gdd^q*}|r|djdjtn|djdjt|rdnd}|j tddd|j |d|d|q W|j!dkrdnd}|j"|} tddd| ddd|d||_#t d|_$td|j%|d|j |ddd|j$|j#g|_&|j&j'|j(||_)||_*dS(u Initialize 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. tverticalalignmentubaselinethorizontalalignmentulefttfontpropertiesgffffff?gffffff?uLegend does not support {!r} instances. A proxy artist may be used instead. See: http://matplotlib.org/users/legend_guide.html#creating-artists-specifically-for-adding-to-the-legend-aka-proxy-artistst textpropstmultilinebaselinetminimumdescentR6R7RgRiiiRQtseptchildrentalignurightuexpandufixedRuucenterN(+RZRWRURRRRaRR9ReRfRgRhRRsRRt_textt legend_artisttminRkRjtdivmodRmt concatenatetcumsumRRt get_childrentset_minimumdescentRERRR{Rt_legend_handle_boxR]RR)RuRvR[R\(!R*RRRRt text_listt handle_listthandles_and_labelst label_proptdescentR7RRtlabthandlerttextboxt handleboxRtnrowst num_largecolt num_smallcolt rows_per_colt start_idxstcolst columnboxti0tdithttt itemBoxest alignmentRR((s0lib/python2.7/site-packages/matplotlib/legend.pyRws|         %a       cC`s|jst|j}g}g}g}xZ|jD]O}t|tsOt|j}|j}|j|}|j |q4Wx|j D]}}t|t stt|t r|j } |j |jj| q|j} |j |jj| qWx_|jD]T}|j\} } } } t| rx'| j| D]} |j | qVWqqWy)tjg|D]}|j^q}Wn tk rtjg}nX||||gS(u{ 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. (RttAssertionErrorRxtlinesRVR tget_pathRttransform_pathRhtpatchesR R tget_data_transformtget_bboxt transformedt get_extentst collectionst_prepare_pointsRjt transformRmRtverticesR'Rn(R*taxtbboxesRtoffsetsRtpathttransttpathR t transOffsetthoffsetstpathstoffsettlR ((s0lib/python2.7/site-packages/matplotlib/legend.pyt_auto_legend_datas8       ) cC`s|j|dS(u^ Set draw frame to b. Parameters ---------- b : bool N(t set_frame_on(R*tb((s0lib/python2.7/site-packages/matplotlib/legend.pyt draw_frame$scC`s9g}|jr"|j|jn|j|j|S(uReturn a list of child artists.(R)RhR(R*R((s0lib/python2.7/site-packages/matplotlib/legend.pyR.s  cC`s|jS(uV Return the `~.patches.Rectangle` instances used to frame the legend. (R|(R*((s0lib/python2.7/site-packages/matplotlib/legend.pyR7scC`s)g|jD]}t|tr |^q S(u:Return a list of `~.lines.Line2D` instances in the legend.(R\RVR (R*R((s0lib/python2.7/site-packages/matplotlib/legend.pyt get_lines=scC`s2tdg|jD]}t|tr|^qS(u;Return a list of `~.patches.Patch` instances in the legend.uPatch(RR\RVR (R*R((s0lib/python2.7/site-packages/matplotlib/legend.pyt get_patchesAscC`std|jS(u7Return a list of `~.text.Text` instances in the legend.uText(RR[(R*((s0lib/python2.7/site-packages/matplotlib/legend.pyt get_textsGscC`s|jjj||dk rSt|tr=t|}n|jjj|n|rl|jjt n|jjt t |_ dS(uk Set the legend title. Fontproperties can be optionally set with *prop* parameter. N( R]Rtset_textR9RVRWR tset_fontpropertiest set_visibleRsRER(R*RRU((s0lib/python2.7/site-packages/matplotlib/legend.pyRKs cC`s |jjS(u1Return the `.Text` instance for the legend title.(R]R(R*((s0lib/python2.7/site-packages/matplotlib/legend.pyt get_title]scO`s|jj||S(uReturn extent of the legend.(R|R(R*targstkwargs((s0lib/python2.7/site-packages/matplotlib/legend.pyRascC`s|jS(u*Get whether the legend box patch is drawn.(R(R*((s0lib/python2.7/site-packages/matplotlib/legend.pyt get_frame_onescC`s||_t|_dS(u Set whether the legend box patch is drawn. Parameters ---------- b : bool .. ACCEPTS: bool N(RRsR(R*R((s0lib/python2.7/site-packages/matplotlib/legend.pyRis cC`s$|jdkr|jjS|jSdS(u4Return the bbox that the legend will be anchored to.N(t_bbox_to_anchorR9RxR=(R*((s0lib/python2.7/site-packages/matplotlib/legend.pyR5us cC`s|dkrd|_dSt|tr4||_nuyt|}Wn'tk rmtdt|nX|dkr|d|dddg}ntj ||_|dkrt |j j }nt |j||_t|_dS(ub Set the bbox that the legend will be anchored to. *bbox* can be - A `.BboxBase` instance - A tuple of ``(left, bottom, width, height)`` in the given transform (normalized axes coordinate if None) - A tuple of ``(left, bottom)`` where the width and height will be assumed to be zero. NuInvalid argument for bbox : %siii(R9R%RVRRjRwR'tstrRRRRxR=RRsR(R*R=R R((s0lib/python2.7/site-packages/matplotlib/legend.pyR8|s"        c C`s|tddksttd\ }}}}} } } } } }}i d|6d|6d|6d| 6d| 6d| 6d| 6d | 6d |6d |6}||}|j|j}|j|j |}|j|d |}|j|jfS( u 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 coordinate units. - parentbbox: a parent box which will contain the bbox. In display coordinates. ii uNEuNWuSWuSEuEuWuSuNuCt container( trangeRRRZtpaddedRtanchoredRR(R*RR=t parentbboxRtBESTtURtULtLLtLRtRtCLtCRtLCtUCtCt anchor_coefstcRR't anchored_box((s0lib/python2.7/site-packages/matplotlib/legend.pyRs" -   c`sr|jst|j\}}}}tjdd||} |dkrgtdt|jD]$} |j | | |j |^qd}ng} xt |D]\} \} }tj| |||d}j |j |j |tfd|D}|dkr-| |fS| j|| | |ffqWt| \}}\} }| |fS(u 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. iic3`s$|]}|jdtVqdS(tfilledN(tintersects_bboxRE(t.0tline(t legendBox(s0lib/python2.7/site-packages/matplotlib/legend.pys sN(RtRRRRR9R(RjRyRR5t enumeratetcount_containstcount_overlapstsumRhR(R*R6R7RtconsidertvertsR RRR=Rt candidatestidxRRtbadnesst_((R>s0lib/python2.7/site-packages/matplotlib/legend.pyRs" C5   cC`s|jj|S(N(R|R,(R*tevent((s0lib/python2.7/site-packages/matplotlib/legend.pyR,suloccC`s|jdk }|dkr%| }n|rX|jdkrt||d||_qn(|jdk rw|jjnd|_|jS(u? Set the draggable state -- if state is * None : toggle the current state * True : turn draggable on * False : turn draggable off If draggable is on, you can drag the legend on the canvas with the mouse. The `.DraggableLegend` helper instance is returned if draggable is on. The update parameter control which parameter of the legend changes when dragged. If update is "loc", the *loc* parameter of the legend is changed. If "bbox", the *bbox_to_anchor* parameter is changed. R+N(RR9R#t disconnect(R*tstateR$R+t is_draggable((s0lib/python2.7/site-packages/matplotlib/legend.pyt draggables   (GRCRDt__doc__RytzorderRHRtdedent_interpdR9RsR(R~RRtpropertyR<RRRRR"t HandlerStemR!tHandlerErrorbarRt HandlerLine2DR t HandlerPatchR tHandlerLineCollectionRtHandlerRegularPolyCollectionRtHandlerCircleCollectionRtupdate_from_first_childR t HandlerTupleR:tHandlerPathCollectionRtHandlerPolyCollectionRRt classmethodRRRRt staticmethodRRRRRRRRRRR!RR$RR5R8RRR,RERM(((s0lib/python2.7/site-packages/matplotlib/legend.pyRGs   r   #              y 4          # # ' c c`sg}xx|D]p}||j|j|j|j7}t|dr x6|jD](}||j|j|j|j7}qNWq q Wtj}|dk r|j }|j |ntj }x=|D]5}|j }|dkr|||r|VqqWdS(uU Return a generator of artists that can be used as handles in a legend. u parasitesu _nolegend_N( RRRt containersthasattrt parasitesRGRR9RR+Rt get_label( taxsRthandles_originalR taxxRt has_handlerRR((s0lib/python2.7/site-packages/matplotlib/legend.pyt_get_legend_handless" *      cC`sog}g}xVt||D]E}|j}|r|jd r|j||j|qqW||fS(uA Return handles and labels for legend, internal method. u_(RgRbRdRh(RcRRRRR((s0lib/python2.7/site-packages/matplotlib/legend.pyt_get_legend_handles_labels1s  c O`stjt}|jdip$i}|jdd }|jdd }d }|d k si|d k rt|rtjdn|r|rt t ||\}}nP|d k r|d krg|D]}|j ^q}n|d k r5|d kr5gt t |||D]\}} |^q}nt|dkrut ||\}}|s|j dqnt|dkr|\}gt t |||D]\}} |^q}n;t|dkr|d \}}|d}n td ||||fS( u Get the handles and labels from the calls to either ``figure.legend`` or ``axes.legend``. ``axs`` is a list of axes (to get legend artists from) u handler_mapuhandlesulabelsuMYou have mixed positional and keyword arguments, some input may be discarded.iu.No handles with labels found to put in legend.iiuInvalid arguments to legend.N((tloggingt getLoggerRCtgettpopR9RjReRfRaRbRgRhtwarningRw( RcR"R#tlogthandlersRRt extra_argsRR((s0lib/python2.7/site-packages/matplotlib/legend.pyt_parse_legend_argsAs6$ "1 1  (@RNt __future__RRRRRbRiRetnumpyRmt matplotlibRRtmatplotlib.artistRRtmatplotlib.cbookRR tmatplotlib.colorstcolorstmatplotlib.font_managerR tmatplotlib.linesR tmatplotlib.patchesR R RRtmatplotlib.collectionsRRRRRtmatplotlib.transformsRRRRRtmatplotlib.offsetboxRRRRRtmatplotlib.containerRR R!tR"R#RFtinterpdR+RGR9RgRhRq(((s0lib/python2.7/site-packages/matplotlib/legend.pyts<"    "("