m[c@`sGdZddlmZmZmZddlZddlmZddlZddl Z ddl Z ddl Z ddl Z ddl ZddlmZmZmZmZddlmZddlmZdd lmZdd lmZmZmZdd lmZdd lm Z m!Z!m"Z"m#Z#m$Z$m%Z%e j&e'Z(e)d Z*ej+dZ,dZ-dZ.defdYZ/ej0j1dej2e/ej3e/j4de/fdYZ5ej0j1dej2e5de6fdYZ7de6fdYZ8de/e8fdYZ9ej0j1de9j4jdS(s) Classes for including text in a figure. i(tabsolute_importtdivisiontprint_functionN(tzipi(tartisttcbookt docstringtrcParams(tArtist(tFontProperties(tLine2D(tFancyArrowPatchtFancyBboxPatcht Rectangle(tTextPath(tAffine2DtBboxtBboxBasetBboxTransformTotIdentityTransformt TransformcK`s-|dk r|j|n|j||S(sEReturn an override dict. See :func:`~pyplot.text' docstring for infoN(tNonetupdate(toverridetfontdicttkwargs((s.lib/python2.7/site-packages/matplotlib/text.pyt_process_text_argss  cc`sQ|jrH|j}z|j|j|VWd|j|Xn|VdS(sLTemporarily inserts newlines to the text if the wrap option is enabled. N(tget_wraptget_texttset_textt_get_wrapped_text(ttextobjtold_text((s.lib/python2.7/site-packages/matplotlib/text.pyt _wrap_text(s   cC`syt|}Wnttfk rt|tj}|rJ|dksV|dkr_d}q|rz|dkrzd}qtdj|nX|dS(s Return the text angle as float. The returned angle is between 0 and 360 deg. *rotation* may be 'horizontal', 'vertical', or a numeric value in degrees. t horizontalgtverticalgV@sMrotation is {0} expected either 'horizontal' 'vertical', numeric value orNoneihN(tfloatt ValueErrort TypeErrort isinstancetsixt string_typesRtformat(trotationtangletisString((s.lib/python2.7/site-packages/matplotlib/text.pyt get_rotation8s   cC`sLg}g}tj|j}tj| }|j|\}}}x|D]~\} } } } | \} }|j| | f\}}||8}|| ||}}|j||g|j||gqSWt|t|}}t ||t ||}}tj|}|j||f\}}||||fS(s Calculate the bounding box of the text. Unlike :meth:`matplotlib.text.Text.get_extents` method, The bbox size of the text before the rotation is calculated. ( tnptdeg2radR.Rtrotatet _get_layoutttransform_pointtextendtmintmax(ttexttrenderert projected_xst projected_ystthetattrt_tpartstdtttwhtxtytwthtxt1tyt1txt2tyt2txt_boxtyt_boxtw_boxth_boxtx_boxty_box((s.lib/python2.7/site-packages/matplotlib/text.pyt _get_textboxOs"   !tTextcB`seeZdZdZejdZdZdddd\ddd\d\d\d\d\d\e d Z d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZd\dZdZdZdZdZdZ dZ!d Z"e#j$d!Z%d"Z&d#Z'd$Z(d%Z)d&Z*d'Z+d(Z,d)Z-d*Z.d+Z/d,Z0d-Z1d.Z2d/Z3d0Z4d1Z5d2Z6d3Z7d4Z8d5Z9d6Z:d\d7Z;d8Z<d9Z=d:Z>d\d\d;Z?d<Z@d=ZAd>ZBd?ZCd@ZDdAZEdBZFdCZGdDZHdEZIdFZJdGZKdHZLdIZMdJZNdKZOdLZPdMZQdNZRdOZSdPZTdQZUdRZVdSZWdTZXdUZYdVZZe[d\dWZ\dXZ]dYZ^dZZ_d[Z`RS(]sK Handle storing and drawing of text in window or data coordinates. ii2cC`s d|j|jt|jfS(NsText(%g,%g,%s)(t_xt_ytreprt_text(tself((s.lib/python2.7/site-packages/matplotlib/text.pyt__repr__~sittbaselinetleftcK`s!tj||||_|_|dkr9td}n|dkrQt}n!t|tj rrt|}n|j ||j ||j | |j | ||_||_||_| |_||_d|_d|_| dkrd} n| |_|j| |j|dS(s Create a :class:`~matplotlib.text.Text` instance at *x*, *y* with string *text*. Valid kwargs are %(Text)s s text.colorg333333?N(Rt__init__RRRSRRR R'R(R)Rt set_colort set_usetextset_wrapt_verticalalignmentt_horizontalalignmentt_multialignmentt _rotationt_fontpropertiest _bbox_patcht _renderert _linespacingtset_rotation_modeR(RVRBRCR7tcolortverticalalignmentthorizontalalignmenttmultialignmenttfontpropertiesR+t linespacingt rotation_modetusetextwrapR((s.lib/python2.7/site-packages/matplotlib/text.pyR[s0                    cC`sQt}|jd|}tt|j|||k rM|j|ndS(s6 Update properties from a dictionary. tbboxN(tobjecttpoptsuperRQRtset_bbox(RVRtsentinelRq((s.lib/python2.7/site-packages/matplotlib/text.pyRs   cC`s#tt|j}d|d<|S(NRe(RtRQt __getstate__R(RVR?((s.lib/python2.7/site-packages/matplotlib/text.pyRws cC`s t|jr|j||S|j s;|jdkrEtifS|jj\}}}}||||}}|j|j }} ||ko|kno|| ko|kn} i} |j r|j j |\} } | p| } | | ddS|jd|jt|R}|j|\}}}|j}t |j |j }t |j |j }|j||f\}}tj| stj| rtjddS|j\} } |jr4|j|||n|j} | j|j| j|j| j|j|j| |j} x|D]\} }}}t|dkr|nd}||}||}|j r| |}n|j!| |j"\}}|j#rEddl$m%}||j#|}n|}|j"r|j&| ||||j'| d|q|j(| ||||j'| d |d|qWWdQX| j)|j*dt+|_,dS( sI Draws the :class:`Text` object to the given *renderer*. NRXR7s%posx and posy should be finite valuesii(tPathEffectRenderertmtextR(-RReR{Rt open_grouptget_gidR!R2RR$RRRRRSR3R/tisfinitet_logtwarningtget_canvas_width_heightRdRtnew_gctset_foregroundt get_colort set_alphat get_alphatset_urlt_urlt _set_gc_clipR.RtflipyRRtget_path_effectstmatplotlib.patheffectsRtdraw_texRct draw_texttrestoret close_groupR|R(RVR8RRqtinfoRRRRtcanvaswtcanvashtgcR,RRARBRCRRRRt textrenderer((s.lib/python2.7/site-packages/matplotlib/text.pyRs`                      cC`s|jS(sReturn the color of the text(R(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`s|jS(s7Return the :class:`~font_manager.FontProperties` object(Rc(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`s |jS(salias for get_fontproperties(R(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_font_propertiesscC`s |jjS(s5Return the list of font families used for font lookup(Rct get_family(RV((s.lib/python2.7/site-packages/matplotlib/text.pyR.scC`s |jS(salias for get_family(R.(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_fontfamily scC`s |jjS(sReturn the font name as string(Rctget_name(RV((s.lib/python2.7/site-packages/matplotlib/text.pyR0 scC`s |jjS(sReturn the font style as string(Rct get_style(RV((s.lib/python2.7/site-packages/matplotlib/text.pyR1scC`s |jjS(sReturn the font size as integer(Rctget_size_in_points(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`s |jjS(s#Return the font variant as a string(Rct get_variant(RV((s.lib/python2.7/site-packages/matplotlib/text.pyR3scC`s |jS(salias for get_variant(R3(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_fontvariantscC`s |jjS(s'Get the font weight as string or number(Rct get_weight(RV((s.lib/python2.7/site-packages/matplotlib/text.pyR5!scC`s |jS(salias for get_name(R0(RV((s.lib/python2.7/site-packages/matplotlib/text.pyt get_fontname%scC`s |jS(salias for get_style(R1(RV((s.lib/python2.7/site-packages/matplotlib/text.pyt get_fontstyle)scC`s |jS(salias for get_size(R(RV((s.lib/python2.7/site-packages/matplotlib/text.pyt get_fontsize-scC`s |jS(salias for get_weight(R5(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_fontweight1scC`s |jjS(s*Get the font stretch as a string or number(Rct get_stretch(RV((s.lib/python2.7/site-packages/matplotlib/text.pyR:5scC`s |jS(salias for get_stretch(R:(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_fontstretch9scC`s |jS(s!alias for get_horizontalalignment(R(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_ha=scC`s|jS(sq Return the horizontal alignment as string. Will be one of 'left', 'center' or 'right'. (R`(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRAscC`s:t|j|j}t|j|j}||fS(s>Return the unitless position of the text as a tuple (*x*, *y*)(R$RRRRRS(RVRBRC((s.lib/python2.7/site-packages/matplotlib/text.pyRHscC`s|j|jfS(s5Return the position of the text as a tuple (*x*, *y*)(RRRS(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRPsc C`sy|j\}}|p|j}|||j|j|j|jt|j|j|j |j j t j ||jf S(s Return a hashable tuple of properties. Not intended to be human readable, but useful for backends who want to cache derived information about text (e.g., layouts) and need to know if the text has changed. (RReRRR_R`thashRcRbRtfiguretdpitweakreftrefRf(RVR8RBRC((s.lib/python2.7/site-packages/matplotlib/text.pyRVs   cC`s|jS(sGet the text as string(RU(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRhscC`s |jS(s&alias for :meth:`getverticalalignment`(tget_verticalalignment(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_valscC`s|jS(s{ Return the vertical alignment as string. Will be one of 'top', 'center', 'bottom' or 'baseline'. (R_(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRBpsc C`s,|jstjS|dk r=|jj}||j_n|jdkrw|j\}}tj||ddS|dk r||_ n|j dkrt dn|j |j \}}}|j \} } |j j| | f\} } |j| | }|dk r(||j_n|S(so Return a :class:`~matplotlib.transforms.Bbox` object bounding the text, in display units. In addition to being used internally, this is useful for specifying clickable regions in a png file on a web page. *renderer* defaults to the _renderer attribute of the text object. This is not assigned until the first execution of :meth:`draw`, so you must use this kwarg if you want to call :meth:`get_window_extent` prior to the first :meth:`draw`. For getting web page regions, it is simpler to call the method after saving the figure. *dpi* defaults to self.figure.dpi; the renderer dpi is irrelevant. For the web application, if figure.dpi is not the value used when saving the figure, then the value that was used must be specified as the *dpi* argument. RXis%Cannot get window extent w/o rendererN(R{RtunitRR>R?RRRRet RuntimeErrorR2RRR3t translated( RVR8R?tdpi_origttxttyRqR(RRBRC((s.lib/python2.7/site-packages/matplotlib/text.pyR}ws&      ! cC`s^|jdkr.|jtd|d|n|jjtd||jt|_dS(s Set the background color of the text by updating the bbox. .. seealso:: :meth:`set_bbox` To change the position of the bounding box. ACCEPTS: any matplotlib color t facecolort edgecolorN(RdRRuRRRRR(RVRh((s.lib/python2.7/site-packages/matplotlib/text.pytset_backgroundcolors  cC`sDyt|Wntk r-t|}nX||_t|_dS(s] Set the foreground color of the text ACCEPTS: any matplotlib color N(R=R&ttupleRRR(RVRh((s.lib/python2.7/site-packages/matplotlib/text.pyR\s   cC`s|j|dS(s!alias for set_horizontalalignmentN(tset_horizontalalignment(RVtalign((s.lib/python2.7/site-packages/matplotlib/text.pytset_hascC`sAd}||kr+tdt|n||_t|_dS(sj Set the horizontal alignment to one of ACCEPTS: [ 'center' | 'right' | 'left' ] RRRZs&Horizontal alignment must be one of %sN(RRRZ(R%tstrR`RR(RVROtlegal((s.lib/python2.7/site-packages/matplotlib/text.pyRNs   cC`s|j|dS(salias for set_multialignmentN(tset_multialignment(RVRO((s.lib/python2.7/site-packages/matplotlib/text.pytset_mascC`sAd}||kr+tdt|n||_t|_dS(s1 Set the alignment for multiple lines layout. The layout of the bounding box of all the lines is determined bu the horizontalalignment and verticalalignment properties, but the multiline text within that box can be ACCEPTS: ['left' | 'right' | 'center' ] RRRZs&Horizontal alignment must be one of %sN(RRRZ(R%RQRaRR(RVRORR((s.lib/python2.7/site-packages/matplotlib/text.pyRSs   cC`s||_t|_dS(s Set the line spacing as a multiple of the font size. Default is 1.2. ACCEPTS: float (multiple of font size) N(RfRR(RVtspacing((s.lib/python2.7/site-packages/matplotlib/text.pytset_linespacings cC`s|jj|t|_dS(s Set the font family. May be either a single string, or a list of strings in decreasing priority. Each string may be either a real font name or a generic font class name. If the latter, the specific font names will be looked up in the :file:`matplotlibrc` file. ACCEPTS: [FONTNAME | 'serif' | 'sans-serif' | 'cursive' | 'fantasy' | 'monospace' ] N(Rct set_familyRR(RVtfontname((s.lib/python2.7/site-packages/matplotlib/text.pyRWs cC`s|jj|t|_dS(sv Set the font variant, either 'normal' or 'small-caps'. ACCEPTS: [ 'normal' | 'small-caps' ] N(Rct set_variantRR(RVtvariant((s.lib/python2.7/site-packages/matplotlib/text.pyRYscC`s |j|S(salias for set_variant(RY(RVRZ((s.lib/python2.7/site-packages/matplotlib/text.pytset_fontvariant scC`s |j|S(salias for set_family(RW(RVRX((s.lib/python2.7/site-packages/matplotlib/text.pytset_name scC`s|j|dS(salias for set_familyN(RW(RVRX((s.lib/python2.7/site-packages/matplotlib/text.pyt set_fontnamescC`s|jj|t|_dS(sZ Set the font style. ACCEPTS: [ 'normal' | 'italic' | 'oblique'] N(Rct set_styleRR(RVt fontstyle((s.lib/python2.7/site-packages/matplotlib/text.pyR^scC`s |j|S(salias for set_style(R^(RVR_((s.lib/python2.7/site-packages/matplotlib/text.pyt set_fontstylescC`s|jj|t|_dS(s Set the font size. May be either a size string, relative to the default font size, or an absolute font size in points. ACCEPTS: [size in points | 'xx-small' | 'x-small' | 'small' | 'medium' | 'large' | 'x-large' | 'xx-large' ] N(Rctset_sizeRR(RVtfontsize((s.lib/python2.7/site-packages/matplotlib/text.pyRa"scC`s |j|S(salias for set_size(Ra(RVRb((s.lib/python2.7/site-packages/matplotlib/text.pyt set_fontsize-scC`s|jj|t|_dS(s. Set the font weight. ACCEPTS: [a numeric value in range 0-1000 | 'ultralight' | 'light' | 'normal' | 'regular' | 'book' | 'medium' | 'roman' | 'semibold' | 'demibold' | 'demi' | 'bold' | 'heavy' | 'extra bold' | 'black' ] N(Rct set_weightRR(RVtweight((s.lib/python2.7/site-packages/matplotlib/text.pyRd1s cC`s |j|S(salias for set_weight(Rd(RVRe((s.lib/python2.7/site-packages/matplotlib/text.pytset_fontweight=scC`s|jj|t|_dS(sR Set the font stretch (horizontal condensation or expansion). ACCEPTS: [a numeric value in range 0-1000 | 'ultra-condensed' | 'extra-condensed' | 'condensed' | 'semi-condensed' | 'normal' | 'semi-expanded' | 'expanded' | 'extra-expanded' | 'ultra-expanded' ] N(Rct set_stretchRR(RVtstretch((s.lib/python2.7/site-packages/matplotlib/text.pyRgAs cC`s |j|S(salias for set_stretch(Rg(RVRh((s.lib/python2.7/site-packages/matplotlib/text.pytset_fontstretchMscC`s&|j|d|j|ddS(sQ Set the (*x*, *y*) position of the text ACCEPTS: (x,y) iiN(tset_xtset_y(RVtxy((s.lib/python2.7/site-packages/matplotlib/text.pyt set_positionQscC`s||_t|_dS(sJ Set the *x* position of the text ACCEPTS: float N(RRRR(RVRB((s.lib/python2.7/site-packages/matplotlib/text.pyRjZs cC`s||_t|_dS(sJ Set the *y* position of the text ACCEPTS: float N(RSRR(RVRC((s.lib/python2.7/site-packages/matplotlib/text.pyRkcs cC`s||_t|_dS(sq Set the rotation of the text ACCEPTS: [ angle in degrees | 'vertical' | 'horizontal' ] N(RbRR(RVts((s.lib/python2.7/site-packages/matplotlib/text.pyt set_rotationls cC`s|j|dS(salias for set_verticalalignmentN(tset_verticalalignment(RVRO((s.lib/python2.7/site-packages/matplotlib/text.pytset_vauscC`sAd}||kr+tdt|n||_t|_dS(sk Set the vertical alignment ACCEPTS: [ 'center' | 'top' | 'bottom' | 'baseline' ] RtbottomRRYs$Vertical alignment must be one of %sN(RRrRRY(R%RQR_RR(RVRORR((s.lib/python2.7/site-packages/matplotlib/text.pyRpys   cC`sd|f|_t|_dS(s Set the text string *s* It may contain newlines (``\n``) or math in LaTeX syntax. ACCEPTS: string or anything printable with '%s' conversion. s%sN(RURR(RVRn((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`sq|dkrtd}n|r>|dkr4d}n|dfStj|rW|tfS|jddtfSdS(sS Returns a cleaned string and a boolean flag. The flag indicates if the given string *s* contains any mathtext, determined by counting unescaped dollar signs. If no mathtext is present, the cleaned string has its dollar signs unescaped. If usetex is on, the flag always has the value "TeX". s text.usetexR s\ tTeXs\$t$N(RRRRRtreplaceR|(RnRo((s.lib/python2.7/site-packages/matplotlib/text.pyRs      cC`s=t|tjr!t|}n|j|_t|_dS(s Set the font properties that control the text. *fp* must be a :class:`matplotlib.font_manager.FontProperties` object. ACCEPTS: a :class:`matplotlib.font_manager.FontProperties` instance N(R'R(R)R RRcRR(RVtfp((s.lib/python2.7/site-packages/matplotlib/text.pytset_fontpropertiesscC`s|j|dS(salias for set_fontpropertiesN(Rw(RVRv((s.lib/python2.7/site-packages/matplotlib/text.pytset_font_propertiesscC`s8|dkrtd|_nt||_t|_dS(s Parameters ---------- usetex : bool or None Whether to render using TeX, ``None`` means to use :rc:`text.usetex`. .. ACCEPTS: bool or None s text.usetexN(RRt_usetextboolRR(RVRo((s.lib/python2.7/site-packages/matplotlib/text.pyR]s cC`s"|jdkrtdS|jSdS(s Return whether this `Text` object uses TeX for rendering. If the user has not manually set this value, it defaults to :rc:`text.usetex`. s text.usetexN(RyRR(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRsN(at__name__t __module__t__doc__tzorderRtmaxdictRRWRR|R[RRwRRRR.RgRRR2RuRRRRRRRRR^RRR RRtallow_rasterizationRRRR-R.R/R0R1RR3R4R5R6R7R8R9R:R;R<RRRRRRCRBR}RLR\RPRNRTRSRVRWRYR[R\R]R^R`RaRcRdRfRgRiRmRjRkRoRqRpRt staticmethodRRwRxR]R(((s.lib/python2.7/site-packages/matplotlib/text.pyRQws   &        -          #F                         +                  t TextWithDashcB`seZdZdZdZddddddddddddddddZd Zd Zdd Zd Z d Z ddZ dZ dZ dZdZdZdZdZdZdZdZdZdZdZdZdZdZRS( sb This is basically a :class:`~matplotlib.text.Text` with a dash (drawn with a :class:`~matplotlib.lines.Line2D`) before/after it. It is intended to be a drop-in replacement for :class:`~matplotlib.text.Text`, and should behave identically to it when *dashlength* = 0.0. The dash always comes between the point specified by :meth:`~matplotlib.text.Text.set_position` and the text. When a dash exists, the text alignment arguments (*horizontalalignment*, *verticalalignment*) are ignored. *dashlength* is the length of the dash in canvas units. (default = 0.0). *dashdirection* is one of 0 or 1, where 0 draws the dash after the text and 1 before. (default = 0). *dashrotation* specifies the rotation of the dash, and should generally stay *None*. In this case :meth:`~matplotlib.text.TextWithDash.get_dashrotation` returns :meth:`~matplotlib.text.Text.get_rotation`. (i.e., the dash takes its rotation from the text's rotation). Because the text center is projected onto the dash, major deviations in the rotation cause what may be considered visually unappealing results. (default = *None*) *dashpad* is a padding length to add (or subtract) space between the text and the dash, in canvas units. (default = 3) *dashpush* "pushes" the dash and text away from the point specified by :meth:`~matplotlib.text.Text.set_position` by the amount in canvas units. (default = 0) .. note:: The alignment of the two objects is based on the bounding box of the :class:`~matplotlib.text.Text`, as obtained by :meth:`~matplotlib.artist.Artist.get_window_extent`. This, in turn, appears to depend on the font metrics as given by the rendering backend. Hence the quality of the "centering" of the label text with respect to the dash varies depending on the backend used. .. note:: I'm not sure that I got the :meth:`~matplotlib.text.TextWithDash.get_window_extent` right, or whether that's sufficient for providing the object bounding box. t textwithdashcC`s d|j|jt|jfS(NsTextWithDash(%g,%g,%s)(RRRSRTRU(RV((s.lib/python2.7/site-packages/matplotlib/text.pyt__str__siRXRgicC`stj|d|d|d|d|d|d|d|d|d | d |  td ||fd ||fdd dd|_t||_t||_| |_| |_| |_ ||_ ||_ dS(NRBRCR7RhRiRjRkRlR+Rmtxdatatydatatkt linestylet-( RQR[R tdashlineR$t_dashxt_dashyt _dashlengtht_dashdirectiont _dashrotationt_dashpadt _dashpush(RVRBRCR7RhRiRjRkRlR+Rmt dashlengtht dashdirectiont dashrotationtdashpadtdashpush((s.lib/python2.7/site-packages/matplotlib/text.pyR[s$$      cC`s:t|j|j}t|j|j}||fS(s>Return the unitless position of the text as a tuple (*x*, *y*)(R$RRRR(RVRBRC((s.lib/python2.7/site-packages/matplotlib/text.pyR?scC`s|j|jfS(s5Return the position of the text as a tuple (*x*, *y*)(RR(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRGscC`sigtj|d|D] }|^q}|j|j|j|j|j|j|j|j gt |S(s Return a hashable tuple of properties. Not intended to be human readable, but useful for backends who want to cache derived information about text (e.g., layouts) and need to know if the text has changed. R8( RQRR4RRRSRRRRRRM(RVR8tpR((s.lib/python2.7/site-packages/matplotlib/text.pyRMs ( cC`sO|j|tj|||jdkrB|jj|nt|_dS(sP Draw the :class:`TextWithDash` object to the given *renderer*. gN(t update_coordsRQRtget_dashlengthRR|R(RVR8((s.lib/python2.7/site-packages/matplotlib/text.pyR[s  c!C`s|j\}}|j}|dkrA|||_|_dS|j}|j}|j}|j}t|} t j | d|d} t j | t j | } } |j } | j||f}t j| | g}|||}||||}| j}|jt|\}}|jt|\}}|jj||f||ftj|d|}|j|j}}| dkr|}d}na| dkrd}|}nF| | }|}||}||ks|| kr|}||}nt j||gd}|d|t jt j||9}||dd|}|jt|\}} || |_|_tj|d|}|j|_|jjt j|gttj|dtj|ddS(s Computes the actual *x*, *y* coordinates for text based on the input *x*, *y* and the *dashlength*. Since the rotation is with respect to the actual canvas's coordinates we need to map back and forth. gNgf@iR8iR( RRRRRStget_dashrotationtget_dashdirectiont get_dashpadt get_dashpushR.R/tpiRtsinRR3RtinvertedRMRtset_dataRQR}RRtsqrttdottfrozent_twd_window_extenttupdate_from_data_xyR|RNRp(!RVR8tdashxtdashyRRRRRR,R;t cos_thetat sin_thetaRtcxytcdtc1tc2tinverseRRtx2ty2tweRDREtdxtdyt tan_thetatcwdtcwtnewxtnewy((s.lib/python2.7/site-packages/matplotlib/text.pyResZ                'cC`s=|j||jdkr2tj|d|S|jSdS(so Return a :class:`~matplotlib.transforms.Bbox` object bounding the text, in display units. In addition to being used internally, this is useful for specifying clickable regions in a png file on a web page. *renderer* defaults to the _renderer attribute of the text object. This is not assigned until the first execution of :meth:`draw`, so you must use this kwarg if you want to call :meth:`get_window_extent` prior to the first :meth:`draw`. For getting web page regions, it is simpler to call the method after saving the figure. gR8N(RRRQR}R(RVR8((s.lib/python2.7/site-packages/matplotlib/text.pyR}s cC`s|jS(s- Get the length of the dash. (R(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`s||_t|_dS(sT Set the length of the dash. ACCEPTS: float (canvas units) N(RRR(RVtdl((s.lib/python2.7/site-packages/matplotlib/text.pytset_dashlengths cC`s|jS(sO Get the direction dash. 1 is before the text and 0 is after. (R(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`s||_t|_dS(s Set the direction of the dash following the text. 1 is before the text and 0 is after. The default is 0, which is what you'd want for the typical case of ticks below and on the left of the figure. ACCEPTS: int (1 is before, 0 is after) N(RRR(RVtdd((s.lib/python2.7/site-packages/matplotlib/text.pytset_dashdirections cC`s$|jdkr|jS|jSdS(s: Get the rotation of the dash in degrees. N(RRR.(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRs cC`s||_t|_dS(s\ Set the rotation of the dash, in degrees ACCEPTS: float (degrees) N(RRR(RVtdr((s.lib/python2.7/site-packages/matplotlib/text.pytset_dashrotations cC`s|jS(sW Get the extra spacing between the dash and the text, in canvas units. (R(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`s||_t|_dS(s Set the "pad" of the TextWithDash, which is the extra spacing between the dash and the text, in canvas units. ACCEPTS: float (canvas units) N(RRR(RVtdp((s.lib/python2.7/site-packages/matplotlib/text.pyt set_dashpads cC`s|jS(sr Get the extra spacing between the dash and the specified text position, in canvas units. (R(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRscC`s||_t|_dS(s Set the "push" of the TextWithDash, which is the extra spacing between the beginning of the dash and the specified position. ACCEPTS: float (canvas units) N(RRR(RVR((s.lib/python2.7/site-packages/matplotlib/text.pyt set_dashpushs cC`s&|j|d|j|ddS(sd Set the (*x*, *y*) position of the :class:`TextWithDash`. ACCEPTS: (x, y) iiN(RjRk(RVRl((s.lib/python2.7/site-packages/matplotlib/text.pyRm#scC`st||_t|_dS(s\ Set the *x* position of the :class:`TextWithDash`. ACCEPTS: float N(R$RRR(RVRB((s.lib/python2.7/site-packages/matplotlib/text.pyRj,scC`st||_t|_dS(s\ Set the *y* position of the :class:`TextWithDash`. ACCEPTS: float N(R$RRR(RVRC((s.lib/python2.7/site-packages/matplotlib/text.pyRk5scC`s-tj|||jj|t|_dS(s Set the :class:`matplotlib.transforms.Transform` instance used by this artist. ACCEPTS: a :class:`matplotlib.transforms.Transform` instance N(RQRRRR(RVR@((s.lib/python2.7/site-packages/matplotlib/text.pyR>scC`s|jS(s0return the figure instance the artist belongs to(R>(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRIscC`s$tj|||jj|dS(s~ Set the figure instance the artist belong to. ACCEPTS: a :class:`matplotlib.figure.Figure` instance N(RQt set_figureR(RVtfig((s.lib/python2.7/site-packages/matplotlib/text.pyRMsN(R{R|R}RRR[RRRRRR}RRRRRRRRRRRmRjRkRRR(((s.lib/python2.7/site-packages/matplotlib/text.pyRsL5       T      t OffsetFromcB`s>eZdZddZdZdZdZdZRS(s3Callable helper class for working with `Annotation`tpointscC`s#||_||_|j|dS(sY Parameters ---------- artist : `Artist`, `BboxBase`, or `Transform` The object to compute the offset from. ref_coord : length 2 sequence If `artist` is an `Artist` or `BboxBase`, this values is the location to of the offset origin in fractions of the `artist` bounding box. If `artist` is a transform, the offset origin is the transform applied to this value. unit : {'points, 'pixels'} The screen units to use (pixels or points) for the offset input. N(t_artistt _ref_coordtset_unit(RVRt ref_coordRD((s.lib/python2.7/site-packages/matplotlib/text.pyR[[s  cC`s(|dkrtdn||_dS(s The unit for input to the transform used by ``__call__`` Parameters ---------- unit : {'points', 'pixels'} Rtpixelss-'unit' must be one of [ 'points' | 'pixels' ]N(RR(R%t_unit(RVRD((s.lib/python2.7/site-packages/matplotlib/text.pyRss cC`s|jS(s8The unit for input to the transform used by ``__call__``(R(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_unitscC`s-|j}|dkrdS|jdSdS(NRg?(RR(RVR8RD((s.lib/python2.7/site-packages/matplotlib/text.pyt _get_scales  c C`s1t|jtrh|jj|}|j\}}}}|j\}}||||||} } nt|jtr|jj\}}}}|j\}}||||||} } n<t|jtr|jj|j\} } n t d|j |} t j | | j | | } | S(sX Return the offset transform. Parameters ---------- renderer : `RendererBase` The renderer to use to compute the offset Returns ------- transform : `Transform` Maps (x, y) in pixel or point units to screen units relative to the given artist. s unknown type(R'RRR}R~RRRR3RERRtscaleR( RVR8RqRRRDREtxftyfRBRCtscR<((s.lib/python2.7/site-packages/matplotlib/text.pyt__call__s   !(R{R|R}R[RRRR(((s.lib/python2.7/site-packages/matplotlib/text.pyRYs    t_AnnotationBasecB`seeZdd dZdZdZdZdZdZdZ dZ d e d Z RS( tdatacC`s,||_||_|j|d|_dS(N(Rltxycoordstset_annotation_clipRt _draggable(RVRlRtannotation_clip((s.lib/python2.7/site-packages/matplotlib/text.pyR[s   c C`st|tr|\}}n ||}}|dkrOt|j|}n|dkrst|j|}n|j||}|j||f\}} || fS(NR(R'RMR$RRt_get_xy_transformR3( RVR8RBRCRnts1ts2R<RR((s.lib/python2.7/site-packages/matplotlib/text.pyt_get_xys   cC`set|trb|\}}ddlm}|j||}|j||}|||}|St|r||}t|trt|St|tr|St dn|t|t r|j |} t| St|trt|St|tr |St|t j s1t d|fn|dkrG|jjS|dkrddlm} | j}||jj} | S|j} t| dkrtd |nd\} }| \}}|d kr|jj} n|d kr|jj} n| dk r| jd }n|d kr<|j|}n|dk rQ|\}}dd lm}|dkr|jjd}|j||}n|dkr|}n|dkr|j}||jjd}|j||}nG|dkr1| jd\}}|j||}ntd ||j||Std |dS(Ni(tblended_transform_factorysunknown return type ...sunknown coordinate type : %sRtpolar(t PolarAxesis!%s is not a recognized coordinateR>taxestoffset(RRgR@RRbtfraction(NN( R'RMtmatplotlib.transformsRRRyRRRRERR}R(R)Rt transDatatmatplotlib.projectionsRtPolarTransformRRR%RR>RqR~t _get_ref_xyRtget_dpiRRR(RVR8RnRRRttr1ttr2R<RqRRts_tbbox0txy0t bbox_nameRDtref_xtref_yRtdppRbRDRE((s.lib/python2.7/site-packages/matplotlib/text.pyRsz                         c C`s>t|jtr|j\}}t|tjrI|jddksqt|tjr|jddkrtdn|j\}}|j||||\}}|j||||\}} || fSt|jtjr|jjddkrtdn(|j\}}|j||||jSdS(sy return x, y (in display coordinate) that is to be used for a reference of any offset coordinate iRs+xycoords should not be an offset coordinateN( R'RRMR(R)RR%RlR( RVR8RRRBRCRRRR((s.lib/python2.7/site-packages/matplotlib/text.pyRs  cC`s ||_dS(sK set *annotation_clip* attribute. * True: the annotation will only be drawn when self.xy is inside the axes. * False: the annotation will always be drawn regardless of its position. * None: the self.xy will be checked only if *xycoords* is "data" N(t_annotation_clip(RVR((s.lib/python2.7/site-packages/matplotlib/text.pyR>s cC`s|jS(s Return *annotation_clip* attribute. See :meth:`set_annotation_clip` for the meaning of return values. (R(RV((s.lib/python2.7/site-packages/matplotlib/text.pytget_annotation_clipJscC`s(|j\}}|j||||jS(s1Return the pixel position of the annotated point.(RlRR(RVR8RBRC((s.lib/python2.7/site-packages/matplotlib/text.pyt_get_position_xyQscC`sJ|j}|s-|dkrF|jdkrF|jj|sFtSntS(sb given the xy pixel coordinate, check if the annotation need to be drawn. RN(RRRRtcontains_pointR|R(RVR8txy_pixelR((s.lib/python2.7/site-packages/matplotlib/text.pyt _check_xyVs  !cC`sddlm}|jdk }|dkr5| }n|rb|jdkr||||_qn(|jdk r|jjnd|_|jS(sc 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 annotation on the canvas with the mouse. The DraggableAnnotation helper instance is returned if draggable is on. i(tDraggableAnnotationN(tmatplotlib.offsetboxRRRt disconnect(RVtstatetuse_blitRt is_draggable((s.lib/python2.7/site-packages/matplotlib/text.pyt draggablees   N( R{R|RR[RRRRRRRR|R(((s.lib/python2.7/site-packages/matplotlib/text.pyRs   S #   t AnnotationcB`seZdZejd dd d d dZdZedZ e j dZ edZ e j dZ dZ d Z d Zejd Zd d ZRS(cC`s(d|jd|jdt|jfS(NsAnnotation(%g,%g,%s)ii(RlRTRU(RV((s.lib/python2.7/site-packages/matplotlib/text.pyRs  RcK`sltj||d|d||dkrP|dk rP||krPtjdn|dkrh|j}n||_|dkr|j}n|\} } tj|| | ||||_ d|_ |dk r_d|kr|j j }|j dd|_ nHd} t}x6|j jD]%\} } | | kr| || '`` head_length=0.4,head_width=0.2 ``'-['`` widthB=1.0,lengthB=0.2,angleB=None ``'|-|'`` widthA=1.0,widthB=1.0 ``'-|>'`` head_length=0.4,head_width=0.2 ``'<-'`` head_length=0.4,head_width=0.2 ``'<->'`` head_length=0.4,head_width=0.2 ``'<|-'`` head_length=0.4,head_width=0.2 ``'<|-|>'`` head_length=0.4,head_width=0.2 ``'fancy'`` head_length=0.4,head_width=0.4,tail_width=0.4 ``'simple'`` head_length=0.5,head_width=0.5,tail_width=0.2 ``'wedge'`` tail_width=0.3,shrink_factor=0.5 ============ ============================================= Valid keys for `~matplotlib.patches.FancyArrowPatch` are: =============== ================================================== Key Description =============== ================================================== arrowstyle the arrow style connectionstyle the connection style relpos default is (0.5, 0.5) patchA default is bounding box of the text patchB default is None shrinkA default is 2 points shrinkB default is 2 points mutation_scale default is text size (in points) mutation_aspect default is 1. ? any key for :class:`matplotlib.patches.PathPatch` =============== ================================================== Defaults to None annotation_clip : bool, optional Controls the visibility of the annotation when it goes outside the axes area. If `True`, the annotation will only be drawn when the ``xy`` is inside the axes. If `False`, the annotation will always be drawn regardless of its position. The default is `None`, which behave as `True` only if *xycoords* is "data". Returns ------- Annotation RRsgYou have used the `textcoords` kwarg, but not the `xytext` kwarg. This can lead to surprising results.t arrowstyletrelposg?Rt headwidtht headlengthtshrinktfraciiN(g?g?(RRRRR(ii(ii(RR[RtwarningstwarnRt _textcoordsRlRQt arrowpropstarrowRRst _arrow_relposRtitemsR t arrow_patch(RVRnRltxytextRt textcoordsR RRRBRCt shapekeysRtval((s.lib/python2.7/site-packages/matplotlib/text.pyR[s<                 cC`stj||\}}|jdk rN|jj|\}}|pH|}n|jdk r|jj|\}}|p~|}n||fS(N(RQRR RR(RVteventRttinfotin_arrowR=tin_patch((s.lib/python2.7/site-packages/matplotlib/text.pyRUscC`s |jS(N(R(RV((s.lib/python2.7/site-packages/matplotlib/text.pytxyann`scC`s|j|dS(N(Rm(RVR((s.lib/python2.7/site-packages/matplotlib/text.pyRdscC`s|jS(N(R (RV((s.lib/python2.7/site-packages/matplotlib/text.pyt anncoordshscC`s ||_dS(N(R (RVtcoords((s.lib/python2.7/site-packages/matplotlib/text.pyRlscC`sX|jdk r"|jj|n|jdk rD|jj|ntj||dS(N(R RRRR(RVR((s.lib/python2.7/site-packages/matplotlib/text.pyRps cC`s#|j|}|j||dS(sQ"Update the pixel positions of the annotated point and the text. N(Rt_update_position_xytext(RVR8R((s.lib/python2.7/site-packages/matplotlib/text.pytupdate_positionsxsc"`s|j|j||j|j\}}|\}}|jdk r|\tj||j\}}} } || } || } d|| } d|| }|jj }|j d|j }|j j |d|kr|j dd}|j dd}|j dd }|j d d}|dk rMtjd n|j d d }td ||d||d||}|j jd||df| df| dff}|df|df| dff}tfd|D\}\}}tfd|D\}\}}||f|_tj||} || |jd}||j _||j _n|j}tj||} | j| j|d}| j| j|d}|j j||f||fd|kr|j j|j dq|jr7|j j|jq|jd}!|j dkrl|j jddStj||} | j\}}} } ||!d8}||!d8}| |!7} | |!7} t!d||fd| d| } | jt"| j#t$|j j| ndS(sWUpdate the pixel positions of the annotation text and the arrow patch. g?tmutation_scaleRRgRiRi Rsh'frac' option in 'arrowprops' is no longer supported; use 'headlength' to set the head length in points.Rt head_lengtht head_widtht tail_widthtsimpleiic3`s)|]}t|d|fVqdS(iN(tabs(t.0R(R(s.lib/python2.7/site-packages/matplotlib/text.pys sc3`s)|]}t|d|fVqdS(iN(R!(R"R(R(s.lib/python2.7/site-packages/matplotlib/text.pys stpatchARXNg@RlR(%RRRRR RRQR}R~RRsRRRRRRtset_arrowstyleR5R R/thypotRtshrinkAtshrinkBRRRRt set_positionst set_patchARdRR RRR|("RVR8Rtox0toy0tox1toy1RRRDRERR@txctycR?tmsRRRRRtstylekwtxpostyposR=RBtrelposxRCtrelposyt shrink_ptsRRqR((RRs.lib/python2.7/site-packages/matplotlib/text.pyRsx  !       !!((        cC`s|dk r||_n|js(dS|j|}|j||sMdS|j|||j||jdk r|jjdkr|jdk r|j|j_n|jj |nt j ||dS(sN Draw the :class:`Annotation` object to the given *renderer*. N( RReR{RRRRRR>RRQ(RVR8R((s.lib/python2.7/site-packages/matplotlib/text.pyRs    !cC`s|jstjS|j}|j}tj|d|}|g}|jdk rq|j|jd|n+|jdk r|j|jd|ntj |S(s] Return a :class:`~matplotlib.transforms.Bbox` object bounding the text and arrow annotation, in display units. *renderer* defaults to the _renderer attribute of the text object. This is not assigned until the first execution of :meth:`draw`, so you must use this kwarg if you want to call :meth:`get_window_extent` prior to the first :meth:`draw`. For getting web page regions, it is simpler to call the method after saving the figure. The *dpi* used defaults to self.figure.dpi; the renderer dpi is irrelevant. R8N( R{RRDR RRQR}Rtappendtunion(RVR8R Rt text_bboxtbboxes((s.lib/python2.7/site-packages/matplotlib/text.pyR}s     N(R{R|RRtdedent_interpdRR[RtpropertyRtsetterRRRRRRRR}(((s.lib/python2.7/site-packages/matplotlib/text.pyRs"     e(:R}t __future__RRRR(t six.movesRt contextlibtloggingRRR@tnumpyR/RXRRRRRt font_managerR RR tpatchesR R R ttextpathRt transformsRRRRRRt getLoggerR{RRRtcontextmanagerR!R.RPRQtinterpdRtkwdocR;R[RRrRRR(((s.lib/python2.7/site-packages/matplotlib/text.pytsH       ".   (b~T