m[c@`sxddlmZmZmZmZddlZddlmZmZddl m Z ddl Z ddl Z ddl Z ddlZddlZddlmZmZmZddlmZddlmZmZmZmZmZmZd Zd Zed d Z d e!fdYZ"de!fdYZ#e$dZ%e%Z&dZ'dZ(ej)j*d e(e"dS(i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t OrderedDictt namedtuple(twrapsi(tcbookt docstringtrcParams(tPath(tBboxtIdentityTransformt TransformtTransformedBboxtTransformedPatchPathtTransformedPathc`s(tfd}t|_|S(u- Decorator for Artist.draw method. Provides routines that run before and after the draw call. The before and after functions are useful for changing artist-dependent renderer attributes or making other setup function calls, such as starting and flushing a mixed-mode renderer. c`szO|jr|jn|jdk r;|jn||||SWd|jdk rz|j|jn|jr|jnXdS(N(tget_rasterizedtstart_rasterizingtget_agg_filtertNonet start_filtert stop_filtertstop_rasterizing(tartisttrenderertargstkwargs(tdraw(s0lib/python2.7/site-packages/matplotlib/artist.pyt draw_wrapper/s    (RtTruet_supports_rasterization(RR((Rs0lib/python2.7/site-packages/matplotlib/artist.pytallow_rasterization%s  cC`s|jr||j_ndS(N(taxeststale(tselftval((s0lib/python2.7/site-packages/matplotlib/artist.pyt_stale_axes_callbackBs u_XYPairux ytArtistcB`seZdZdZdZeddZdZdZdZ dZ d Z d Z e d Zejd Ze d ZejdZdZdZdZdZdZdZdZejddZdZdZdZdZdZdZ dZ!dZ"ejdd d!Z#d"Z$d#Z%d$Z&d%Z'd&Z(d'Z)d(Z*dOdOdOd)Z,d*Z-d+Z.d,Z/d-Z0d.Z1dOd/Z2d0Z3d1Z4d2Z5d3Z6d4Z7d5Z8d6Z9d7Z:d8Z;d9Z<d:Z=d;Z>d<Z?d=Z@d>ZAd?ZBd@ZCdAZDdBZEdCZFdDZGdEZHe dFZIdGZJdHZKdIZLdOeMdJZNdKZOdLZPe dMZQeQjdNZQRS(PuW Abstract base class for someone who renders into a :class:`FigureCanvas`. uArtistitcoloricC`s2t|_d|_d|_d|_d|_t|_t|_ t|_ d|_ d|_ d|_ t|_d|_d|_d|_d|_d|_t|_t|_d|_i|_y d|_Wntk rnXd|_d|_d|_d|_td|_td|_ t!gg|_"dS(Nuiu path.sketchu path.effects(#Rt_staleRtstale_callbackt_axestfiguret _transformtFalset _transformSett_visiblet _animatedt_alphatclipboxt _clippatht_clipont_labelt_pickert _containst _rasterizedt _agg_filtert _mouseoverteventsont_oidt_propobserversR!tAttributeErrort_remove_methodt_urlt_gidt_snapR t_sketcht _path_effectst_XYPairt _sticky_edges(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt__init__Ws@                             cC`s'|jj}d|d             $ cC`s|jS(ub Return the alpha value used for blending - not supported on all backends (R1(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_alphascC`s|jS(uReturn the artist's visiblity(R/(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_visiblescC`s|jS(u"Return the artist's animated state(R0(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyR^scC`s|jS(u#Return whether artist uses clipping(R4(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_clip_onscC`s|jS(uReturn artist clipbox(R2(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_clip_boxscC`s|jS(uReturn artist clip path(R3(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_clip_pathscC`s |jdk r|jjSdS(u Return the clip path with the non-affine part of its transformation applied, and the remaining affine part of its transformation. N(NN(R3Rtget_transformed_path_and_affine(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt$get_transformed_clip_path_and_affines cC`s ||_|jt|_dS(u Set whether artist uses clipping. When False artists will be visible out side of the axes which can lead to unexpected results. Parameters ---------- b : bool .. ACCEPTS: bool N(R4RgRR"(R#tb((s0lib/python2.7/site-packages/matplotlib/artist.pyt set_clip_ons  cC`s\|jr>|jdk r+|j|jn|j|jn|jd|jddS(u Set the clip properly for the gcN(R4R2Rtset_clip_rectangleRR3(R#tgc((s0lib/python2.7/site-packages/matplotlib/artist.pyt _set_gc_clips   cC`s|jS(u.Return whether the artist is to be rasterized.(R8(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyRscC`s:|r-t|jd r-tjd|n||_dS(u Force rasterized (bitmap) drawing in vector backend output. Defaults to None, which implies the backend's default behavior. Parameters ---------- rasterized : bool or None .. ACCEPTS: bool or None u_supports_rasterizationu%Rasterization of '%s' will be ignoredN(RLRR}R~R8(R#t rasterized((s0lib/python2.7/site-packages/matplotlib/artist.pytset_rasterizeds cC`s|jS(u1Return filter function to be used for agg filter.(R9(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyRscC`s||_t|_dS(upSet the agg filter. Parameters ---------- filter_func : callable A filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array. .. ACCEPTS: a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array N(R9RR"(R#t filter_func((s0lib/python2.7/site-packages/matplotlib/artist.pytset_agg_filters cO`s|jsdSt|_dS(uDerived classes drawing methodN(RR-R"(R#RRR((s0lib/python2.7/site-packages/matplotlib/artist.pyR(s cC`s ||_|jt|_dS(u Set the alpha value used for blending - not supported on all backends. Parameters ---------- alpha : float .. ACCEPTS: float (0.0 transparent through 1.0 opaque) N(R1RgRR"(R#talpha((s0lib/python2.7/site-packages/matplotlib/artist.pyt set_alpha.s  cC`s ||_|jt|_dS(u Set the artist's visibility. Parameters ---------- b : bool .. ACCEPTS: bool N(R/RgRR"(R#R((s0lib/python2.7/site-packages/matplotlib/artist.pyt set_visible<s  cC`s)|j|kr%||_|jndS(u Set the artist's animation state. Parameters ---------- b : bool .. ACCEPTS: bool N(R0Rg(R#R((s0lib/python2.7/site-packages/matplotlib/artist.pyt set_animatedIs  cC`sd}|j}t|_z5g|jD]\}}||||^q+}Wd||_Xt|r|jt|_n|S(uM Update this artist's properties from the dictionary *prop*. cS`sn|j}|dhkr+t|||St|d|d}t|s`td|n||SdS(uSorting out how to update property (setter or setattr). Parameters ---------- k : str The name of property to update v : obj The value to assign to the property Returns ------- ret : obj or None If using a `set_*` method return it's return, else None. uaxesuset_uUnknown property %sN(tlowertsetattrRVRR|R>(R#tktvR`((s0lib/python2.7/site-packages/matplotlib/artist.pyt_update_propertyZs  N(R;R-titemstlenRgRR"(R#tpropsRtstoreRRtret((s0lib/python2.7/site-packages/matplotlib/artist.pytupdateVs   2    cC`s|jS(u1Get the label used for this artist in the legend.(R5(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_labelscC`sA|dk r!tj||_n d|_|jt|_dS(u Set the label to *s* for auto legend. Parameters ---------- s : object *s* will be converted to a string by calling `str` (`unicode` on Py2). .. ACCEPTS: object N(RRet text_typeR5RgRR"(R#ts((s0lib/python2.7/site-packages/matplotlib/artist.pyt set_labels   cC`s|jS(uReturn the artist's zorder.(tzorder(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_zorderscC`s;|dkr|jj}n||_|jt|_dS(u Set the zorder for the artist. Artists with lower zorder values are drawn first. Parameters ---------- level : float .. ACCEPTS: float N(RRsRRgRR"(R#tlevel((s0lib/python2.7/site-packages/matplotlib/artist.pyt set_zorders   cC`s|jS(u} `x` and `y` sticky edge lists. When performing autoscaling, if a data limit coincides with a value in the corresponding sticky_edges list, then no margin will be added--the view limit "sticks" to the edge. A typical usecase is histograms, where one usually expects no margin on the bottom edge (0) of the histogram. This attribute cannot be assigned to; however, the `x` and `y` lists can be modified in place as needed. Examples -------- >>> artist.sticky_edges.x[:] = (xmin, xmax) >>> artist.sticky_edges.y[:] = (ymin, ymax) (RF(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt sticky_edgesscC`s|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j |_ |j j |j j (|j j |j j (|j t|_dS(u'Copy properties from *other* to *self*.N(R,R.R/R1R2R4R3R5RCRDRRXRZRgRR"(R#tother((s0lib/python2.7/site-packages/matplotlib/artist.pyt update_froms           cC`st|jS(uY return a dictionary mapping property name -> value for all Artist props (tArtistInspectort properties(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyRsc `s:tt|jdtdfd}j|S(uBA property batch setter. Pass *kwargs* to set properties. treversetkeyc`s!jj|dd|dfS(Ni(t _prop_ordertget(RX(R#(s0lib/python2.7/site-packages/matplotlib/artist.pyts(RtsortedRRR(R#RR((R#s0lib/python2.7/site-packages/matplotlib/artist.pytsetsc`sdkrd}nQttrHttrHfd}n!tr]}n tdtg|jD]}|j |^qyg}|r||r|j |n|S(u Find artist objects. Recursively find all :class:`~matplotlib.artist.Artist` instances contained in self. *match* can be - None: return all objects contained in artist. - function with signature ``boolean = match(artist)`` used to filter matches - class instance: e.g., Line2D. Only return artists of class type. If *include_self* is True (default), include self in the list to be checked for a match. cS`stS(N(R(RX((s0lib/python2.7/site-packages/matplotlib/artist.pyt matchfuncsc`s t|S(N(Rk(RX(tmatch(s0lib/python2.7/site-packages/matplotlib/artist.pyRsuFmatch must be None, a matplotlib.artist.Artist subclass, or a callableN( RRkRt issubclassR&R|R\tsumRttfindobjRo(R#Rt include_selfRtctartists((Rs0lib/python2.7/site-packages/matplotlib/artist.pyRs     1cC`sdS(u8 Get the cursor data for a given event. N(R(R#Rw((s0lib/python2.7/site-packages/matplotlib/artist.pytget_cursor_datascC`sFy |dWn ttfk r.|g}nXdjd|DS(u8 Return *cursor data* string formatted. iu, cs`s?|]5}t|tjtjttfrdj|VqdS(u{:0.3g}N(RktnptfloatingtintegertinttfloatR(t.0titem((s0lib/python2.7/site-packages/matplotlib/artist.pys s(Rt IndexErrortjoin(R#tdata((s0lib/python2.7/site-packages/matplotlib/artist.pytformat_cursor_datas   cC`s|jS(N(R:(R#((s0lib/python2.7/site-packages/matplotlib/artist.pyt mouseoverscC`sTt|}||_|j}|rP|r=|jj|qP|jj|ndS(N(tboolR:R!RMtaddRN(R#R$RU((s0lib/python2.7/site-packages/matplotlib/artist.pyRs   N(RRt __module__t__doc__tanameRtdictRRGRKRQRSRYR[tpropertyR!tsetterR"R_RbRdRgRhRjRmRt deprecatedRvRtRnRRRRRRRRRRRRRRRRRRRRRRRRR^RRRRRRRRRRRRRRRRRRRRRRRRRRRR(((s0lib/python2.7/site-packages/matplotlib/artist.pyR&Js $  .               %          6              +       %  RcB`seZdZdZdZejdZdZdZ dZ dZ dZ d Z dd d Zdd d ZdZdZRS(u A helper class to inspect an :class:`~matplotlib.artist.Artist` and return information about it's settable properties and their current values. cC`st|tsItj|rIt|}t|rF|d}qFqIn||_tj|spt |}n||_ |j |_ dS(u Initialize the artist inspector with an `Artist` or an iterable of `Artist`\s. If an iterable is used, we assume it is a homogeneous sequence (all `Artists` are of the same type) and it is your responsibility to make sure this is so. iN( RkR&RtiterabletlistRtoorigtinspecttisclassRtot get_aliasestaliasd(R#R((s0lib/python2.7/site-packages/matplotlib/artist.pyRG/s    cC`sgt|jD]3}|jdrtt|j|r|^q}i}xf|D]^}t|j|}|j|sqVn|j}|d}d|j|di|d *alias* for each *alias* in the :class:`~matplotlib.artist.ArtistInspector`. e.g., for lines:: {'markerfacecolor': 'mfc', 'linewidth' : 'lw', } uset_uget_i i(uset_uget_N( tdirRt startswithR|RVtis_aliasRRt setdefault(R#tnametnamestaliasesR`Rtfullname((s0lib/python2.7/site-packages/matplotlib/artist.pyRCs $   "u6\n\s*(?:\.\.\s+)?ACCEPTS:\s*((?:.|\n)*?)(?:$|(?:\n\n))cC`sd|}t|j|s8td|j|fnt|j|}|j}|dkrcdS|jdrvdS|jj|}|dk rt j dd|j dSdS( u_ Get the legal arguments for the setter associated with *attr*. This is done by querying the docstring of the function *set_attr* for a line that begins with "ACCEPTS" or ".. ACCEPTS": e.g., for a line linestyle, return "[ ``'-'`` | ``'--'`` | ``'-.'`` | ``':'`` | ``'steps'`` | ``'None'`` ]" uset_%su%s has no function %suunknownu alias for u *u iN( RLRR>RVRRR t_get_valid_values_regextsearchtretsubtgroup(R#tattrR R`RR((s0lib/python2.7/site-packages/matplotlib/artist.pytget_valid_values`s    cC`s6g}x)t|jD]}|jds1qnt|j|}t|sUqntjrzttj |d}nttj |d}|dks|j |rqn|jj d|jj }x>|jjD]-}||jkr|j d|j }PqqW|j|d|d|fqW|S(u Get the attribute strings and a full path to where the setter is defined for all setters in an object. uset_iiu.i(R RR RVR|RetPY2RRt getargspectgetfullargspecR RRtmroRHRo(R#tsettersR R`tnargst source_classtcls((s0lib/python2.7/site-packages/matplotlib/artist.pyt_get_setters_and_targets}s&  #cC`s#g|jD]\}}|^q S(u Get the attribute strings with setters for object. e.g., for a line, return ``['markerfacecolor', 'linewidth', ....]``. (R (R#Rttarget((s0lib/python2.7/site-packages/matplotlib/artist.pyt get_settersscC`s&|j}|dkrtS|jdS(u^ Return *True* if method object *o* is an alias for another function. u alias for N(RRR-R (R#Rtds((s0lib/python2.7/site-packages/matplotlib/artist.pyR s  cC`sL||jkrD|djgt|j|D]}d|^q,S|SdS(u return 'PROPNAME or alias' if *s* has an alias, else return PROPNAME. e.g., for the line markerfacecolor property, which has an alias, return 'markerfacecolor or mfc' and for the transform property, which does not, return 'transform' uu or %sN(RRR(R#RRX((s0lib/python2.7/site-packages/matplotlib/artist.pyt aliased_names  )cC`s\||jkrEdjgt|j|D]}d|^q)}nd}d|||fS(u. return 'PROPNAME or alias' if *s* has an alias, else return PROPNAME formatted for ReST e.g., for the line markerfacecolor property, which has an alias, return 'markerfacecolor or mfc' and for the transform property, which does not, return 'transform' uu or %su:meth:`%s <%s>`%s(RRR(R#RR!RXR((s0lib/python2.7/site-packages/matplotlib/artist.pytaliased_name_rests  -ic C`s|rd|}nd}|dk rE|j|}d|||fS|j}|jg}xL|D]D\}}|j|}|j|}|jd|||fqhW|S(u If *prop* is *None*, return a list of strings of all settable properties and their valid values. If *prop* is not *None*, it is a valid property name and that property will be returned as a string of property : valid values. u uu%s%s: %sN(RRR tsortR$Ro( R#Rt leadingspacetpadtacceptstattrstlinesRR ((s0lib/python2.7/site-packages/matplotlib/artist.pytpprint_setterss     icC`s|rd|}nd}|d k rE|j|}d|||fS|j}|jg}g|D]\}}|j||^qh}g|D]\}}|j|^q}td|D} td|D} |jd|j|d|j|d|d7}|d | dd | } |jd|j| |j|d j| d d j| |j| |jgt ||D]0\} } || j| d | j| ^q|j| |jd|S(u/ If *prop* is *None*, return a list of strings of all settable properties and their valid values. Format the output for ReST If *prop* is not *None*, it is a valid property name and that property will be returned as a string of property : valid values. u uu%s%s: %scs`s|]}t|VqdS(N(R(Rtn((s0lib/python2.7/site-packages/matplotlib/artist.pys scs`s|]}t|VqdS(N(R(RR{((s0lib/python2.7/site-packages/matplotlib/artist.pys su .. table::u :class: property-tableu u=uPropertyiu DescriptionN( RRR R&R%tmaxRotljustRutzip(R#RR'R(R)R*R+R!Rtcol0_lentcol1_lenttable_formatstrR-R{((s0lib/python2.7/site-packages/matplotlib/artist.pytpprint_setters_rests:     ((      D  cC`s|j}gt|D]0}|jdrtt||r|^q}|jt}xz|D]r}t||}|j|rqfny-tj tj d|}WdQXWn qfqfX|||d value uget_uignoreNi( RR R R|RVR&RR R}tcatch_warningst simplefilter(R#RR tgettersRJR`R$((s0lib/python2.7/site-packages/matplotlib/artist.pyRs" 0     cC`sg}xttj|jD]\}}t|ddd krot|dkrot|d d}n t|}|jdd}t|dkr|d d}n|j|}|j d||fq"W|S( uJ Return the getters and actual values as list of strings. ushapeiu...u u i2u %s = %s((( RReRfRRVRtstrtreplaceR$Ro(R#R+R R$R((s0lib/python2.7/site-packages/matplotlib/artist.pytpprint_getters1s(* N(RRRRGRRtcompileRRR R"R R$R%RR,R4RR:(((s0lib/python2.7/site-packages/matplotlib/artist.pyR)s        1 cC`sU|dkr;t|}|j}tdj|dSt|d|}|S(uJ Return the value of object's property. *property* is an optional string for the property you want to return Example usage:: getp(obj) # get all the object properties getp(obj, 'linestyle') # get the linestyle property *obj* is a :class:`Artist` instance, e.g., :class:`~matplotllib.lines.Line2D` or an instance of a :class:`~matplotlib.axes.Axes` or :class:`matplotlib.text.Text`. If the *property* is 'somename', this function returns obj.get_somename() :func:`getp` can be used to query all the gettable properties with ``getp(obj)``. Many properties have aliases for shorter typing, e.g. 'lw' is an alias for 'linewidth'. In the output, aliases and full property names will be listed as: property or alias = value e.g.: linewidth or lw = 2 u Nuget_(RRR:RrRRV(tobjRtinspRR`((s0lib/python2.7/site-packages/matplotlib/artist.pytgetpDs   c O`st|tr|g}nttj|}|s:dSt|d}i}d|krr|jd|d>> line, = plot([1,2,3]) >>> setp(line, linestyle='--') If you want to know the valid types of arguments, you can provide the name of the property you want to set without a value:: >>> setp(line, 'linestyle') linestyle: [ '-' | '--' | '-.' | ':' | 'steps' | 'None' ] If you want to see all the properties that can be set, and their possible values, you can do:: >>> setp(line) ... long output listing omitted You may specify another output file to `setp` if `sys.stdout` is not acceptable for some reason using the `file` keyword-only argument:: >>> with fopen('output.log') as f: >>> setp(line, file=f) :func:`setp` operates on a single instance or a iterable of instances. If you are in query mode introspecting the possible values, only the first instance in the sequence is used. When actually setting values, all the instances will be set. e.g., suppose you have a list of two lines, the following will make both lines thicker and red:: >>> x = arange(0,1.0,0.01) >>> y1 = sin(2*pi*x) >>> y2 = sin(4*pi*x) >>> lines = plot(x, y1, x, y2) >>> setp(lines, linewidth=2, color='r') :func:`setp` works with the MATLAB style string/value pairs or with python kwargs. For example, the following are equivalent:: >>> setp(lines, 'linewidth', 2, 'color', 'r') # MATLAB style >>> setp(lines, linewidth=2, color='r') # python style NiufileiRu u(The set args must be string, value pairsi(RkR&RRtflattenRtpopRRrR,RR\RtrangeRRuR( R<RRtobjsR=t printArgstfuncvalstiRRRX((s0lib/python2.7/site-packages/matplotlib/artist.pytsetpms,2    #")cC`sUtjd}|r2djt|jddSdjt|jddSdS(Nudocstring.hardcopyu R'ii(t matplotlibR RRR4R,(R{thardcopy((s0lib/python2.7/site-packages/matplotlib/artist.pytkwdocs   (+t __future__RRRRRet collectionsRRt functoolsRRRR}tnumpyRRGtRRR RR t transformsR R R RRRR R%REtobjectR&RRR>RRFRItinterpdR(((s0lib/python2.7/site-packages/matplotlib/artist.pyts2"      .   & U