m[c@`sdZddlmZmZmZmZddlZddlmZddl m Z ddl m Z ddl Z ddlZddlZddlZddlZddlZddlmZddlZddlmZmZmZmZmZmZmZm Z m!Z!m"Z"dd l#m$Z$dd l%m&Z&m'Z'm(Z(dd l)m*Z*ydd l+m,Z,e-Z.[,Wne/k re0Z.nXi d d6dd6dd6dd6dd6dd6dd6dd6dd6Z1i dd6dd6dd6dd6d d6d d6d d6d!d6d!d6Z2e3d"Z4d#Z5d$e6fd%YZ7d&e7fd'YZ8d(e6fd)YZ9d*e6fd+YZ:d,e6fd-YZ;d.e6fd/YZ<ej=d0d1e<fd2YZ>d3e<fd4YZ?d5e<fd6YZ@d7e<fd8YZAd9e<fd:YZBd;eBfd<YZCd=e<fd>YZDd?eBfd@YZEdAe6fdBYZFe3dCZGdDeHfdEYZIdFe6fdGYZJejKZKdHe6fdIYZLdJe6fdKYZMdLe6fdMYZNdS(Nub Abstract base classes define the primitives that renderers and graphics contexts must implement to serve as a matplotlib backend :class:`RendererBase` An abstract base class to handle drawing/rendering operations. :class:`FigureCanvasBase` The abstraction layer that separates the :class:`matplotlib.figure.Figure` from the backend specific details like a user interface drawing area :class:`GraphicsContextBase` An abstract base class that provides color, line styles, etc... :class:`Event` The base class for all of the matplotlib event handling. Derived classes such as :class:`KeyEvent` and :class:`MouseEvent` store the meta data like keys and buttons pressed, x and y locations in pixel and :class:`~matplotlib.axes.Axes` coordinates. :class:`ShowBase` The base class for the Show class of each interactive backend; the 'show' callable is then set to Show.__call__, inherited from ShowBase. :class:`ToolContainerBase` The base class for the Toolbar class of each interactive backend. :class:`StatusbarBase` The base class for the messaging area. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(txrange(tcontextmanager(tpartial(tWeakKeyDictionary( t backend_toolstcbooktcolorsttextpatht tight_bboxt transformstwidgetst get_backendtis_interactivetrcParams(tGcf(tBboxtTransformedBboxtAffine2D(tPath(tImageu PostscriptupsuEncapsulated PostscriptuepsuPortable Document FormatupdfuPGF code for LaTeXupgfuPortable Network GraphicsupnguRaw RGBA bitmapurawurgbauScalable Vector Graphicsusvgusvgzumatplotlib.backends.backend_psumatplotlib.backends.backend_pdfumatplotlib.backends.backend_pgfumatplotlib.backends.backend_aggumatplotlib.backends.backend_svgcC`s-|dkrd}n|t|<|t|t j ||j ||j } | j |j||} | | fS(u} return the text path and transform Parameters ---------- prop : `matplotlib.font_manager.FontProperties` font property s : str text to be converted usetex : bool If True, use matplotlib usetex mode. ismath : bool If True, use mathtext parser. If "TeX", use *usetex* mode. uTeXRtusetex(RXtpoints_to_pixelstget_size_in_pointst get_text_pathRARBRRtdeg2radtflipyRtscalet FONT_SCALEtrotateRgtheight( RGRmRnRZRRRt text2pathtfontsizetvertsRlR`Ra((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt_get_text_path_transforms"   %c C`sZ|j||||||\}} |j} |jd|j||| d| dS(u draw the text by converting them to paths using textpath module. Parameters ---------- prop : `matplotlib.font_manager.FontProperties` font property s : str text to be converted usetex : bool If True, use matplotlib usetex mode. ismath : bool If True, use mathtext parser. If "TeX", use *usetex* mode. gRbN(Rtget_rgbRRc( RGR_RmRnRZRRRR`Ratcolor((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRs   cC`s8|dkra|j}|jj}|j}|j||d|\}}} ||| fS|jd} |r|jjj|| |} | dd!S|jj} |jj|} |j}| j || | j |dd| | j \}}| j } |d}|d}| d} ||| fS( u Get the width, height, and descent (offset from the bottom to the baseline), in display coords, of the string *s* with :class:`~matplotlib.font_manager.FontProperties` *prop* uTeXtrendereriHiigtflagsgP@( RRXtget_texmanagertget_text_width_height_descentRtmathtext_parsertparset_get_hinting_flagt _get_fonttset_sizetset_texttget_width_heightt get_descent(RGRZRRtsizet texmanagerRtwthtdtdpitdimsRtfont((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRs,          cC`stS(u Return true if y small numbers are top for renderer Is used for drawing text (:mod:`matplotlib.text`) and images (:mod:`matplotlib.image`) only (RB(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`sdS(u4return the canvas width and height in display coordsi(ii((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_canvas_width_heightscC`s5|jdkr.ddlm}||_n|jS(uO return the :class:`matplotlib.texmanager.TexManager` instance i(t TexManagerN(RVRtmatplotlib.texmanagerR(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR scC`stS(uF Return an instance of a :class:`GraphicsContextBase` (tGraphicsContextBase(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s|S(u Convert points to display units You need to override this function (unless your backend doesn't have a dpi, e.g., postscript or svg). Some imaging systems assume some value for pixels per inch:: points to pixels = points * pixels_per_inch/72.0 * dpi/72.0 Parameters ---------- points : scalar or array_like a float or a numpy array of float Returns ------- Points converted to pixels ((RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s tj|S(N(R t strip_math(RGRZ((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR.scC`sdS(uK Used in MixedModeRenderer. Switch to the raster renderer. N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytstart_rasterizing1scC`sdS(u Used in MixedModeRenderer. Switch back to the vector renderer and draw the contents of the raster renderer as an image on the vector renderer. N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytstop_rasterizing6scC`sdS(uj Used in AggRenderer. Switch to a temporary renderer for image filtering effects. N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt start_filter=scC`sdS(u Used in AggRenderer. Switch back to the original renderer. The contents of the temporary renderer is processed with the *filter_func* and is drawn on the original renderer as an image. N((RGt filter_func((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt stop_filterCsN($RHRIRTRYRR\R]RcRoRRRRRpRRrRRRRRRARRRRRRRRRRRRRR(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRUs@     '      a  !  + *  !        RcB`seZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z ejd d ZdZdZdZdZdZdZdZdZdZdZdZedZdZdZejd dZ dZ!dZ"dZ#d Z$d!Z%d"d#Z&d$Z'd%Z(d&Z)d'Z*d)d)d)d(Z,RS(*uI An abstract base class that provides color, line styles, etc... cC`sd|_t|_d|_d|_d|_d|_d |_d|_ d|_ d|_ d |_ d|_ tjtd|_td|_d|_d|_d|_d|_dS( Ng?iubutturoundusolidgu hatch.coloruhatch.linewidth(NN(gggg?(t_alphaRAt _forced_alphat _antialiasedt _capstyleRt _cliprectt _clippatht_dashest _joinstylet _linestylet _linewidtht_rgbt_hatchR tto_rgbaRt _hatch_colort_hatch_linewidtht_urlt_gidt_snapt_sketch(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYQs$                cC`s|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j |_ |j |_ |j |_ |j |_ |j |_ |j|_|j|_|j|_|j|_dS(uCopy properties from gc to selfN(RRRRRRRRRRRRRRRRRR(RGR_((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRes$                 cC`sdS(u Restore the graphics context from the stack - needed only for backends that save graphics contexts on a stack N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRzscC`s|jS(ub Return the alpha value used for blending - not supported on all backends (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt get_alphascC`s|jS(u@Return true if the object should try to do antialiased rendering(R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_antialiasedscC`s|jS(uT Return the capstyle as a string in ('butt', 'round', 'projecting') (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt get_capstylescC`s|jS(uf Return the clip rectangle as a :class:`~matplotlib.transforms.Bbox` instance (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_clip_rectanglescC`s |jdk r|jjSdS(u Return the clip path in the form (path, transform), where path is a :class:`~matplotlib.path.Path` instance, and transform is an affine transform to apply to the path before clipping. N(NN(RRtget_transformed_path_and_affine(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt get_clip_paths cC`s|jS(uO Return the dash information as an offset dashlist tuple. The dash list is a even size list that gives the ink on, ink off in pixels. See p107 of to PostScript `BLUEBOOK `_ for more info. Default value is None (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt get_dashess cC`s|jS(u Return whether the value given by get_alpha() should be used to override any other alpha-channel values. (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_forced_alphascC`s|jS(uR Return the line join style as one of ('miter', 'round', 'bevel') (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt get_joinstylesu2.1cC`s|jS(u` Return the linestyle: one of ('solid', 'dashed', 'dashdot', 'dotted'). (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt get_linestylescC`s|jS(u= Return the line width in points as a scalar (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s|jS(uC returns a tuple of three or four floats from 0-1. (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s|jS(u= returns a url if one is set, None otherwise (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_urlscC`s|jS(uM Return the object identifier if one is set, None otherwise. (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_gidscC`s|jS(u returns the snap setting which may be: * True: snap vertices to the nearest pixel center * False: leave vertices as-is * None: (auto) If the path contains only rectilinear line segments, round to the nearest pixel center (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_snaps cC`sM|dk r!||_t|_nd|_t|_|j|jdtdS(uA Set the alpha value used for blending - not supported on all backends. If ``alpha=None`` (the default), the alpha components of the foreground and fill colors will be used to set their respective transparencies (where applicable); otherwise, ``alpha`` will override them. g?tisRGBAN(RRRBRRARR(RGtalpha((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt set_alphas      cC`s|rd|_n d|_dS(uK True if object should be drawn with antialiased rendering iiN(R(RGtb((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRs cC`s,|dkr||_ntd|dS(uQ Set the capstyle as a string in ('butt', 'round', 'projecting') ubutturoundu projectingu!Unrecognized cap style. Found %sN(ubutturoundu projecting(Rt ValueError(RGtcs((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt set_capstyles  cC`s ||_dS(uT Set the clip rectangle with sequence (left, bottom, width, height) N(R(RGt rectangle((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytset_clip_rectanglescC`s;|dk r.t|tj r.tdn||_dS(u Set the clip path and transformation. Path should be a :class:`~matplotlib.transforms.TransformedPath` instance. u?Path should be a matplotlib.transforms.TransformedPath instanceN(RRR tTransformedPathRR(RGR`((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt set_clip_paths cC`sU|dk rBtj|}tj|dkrBtdqBn||f|_dS(u$ Set the dash style for the gc. Parameters ---------- dash_offset : float is the offset (usually 0). dash_list : array_like specifies the on-off sequence as points. ``(None, None)`` specifies a solid line gu,All values in the dash list must be positiveN(RRtasarraytanyRR(RGt dash_offsett dash_listtdl((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s  cC`su|jr)|r)|d |jf|_nH|jrMtj||j|_n$|r_||_ntj||_dS(u Set the foreground color. fg can be a MATLAB format string, a html hex color string, an rgb or rgba unit tuple, or a float between 0 and 1. In the latter case, grayscale is used. If you know fg is rgba, set ``isRGBA=True`` for efficiency. iN(RRRR R(RGRR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR5s  cC`s,|dkr||_ntd|dS(uM Set the join style to be one of ('miter', 'round', 'bevel') umiteruroundubevelu"Unrecognized join style. Found %sN(umiteruroundubevel(RR(RGtjs((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt set_joinstyleFs  cC`st||_dS(u- Set the linewidth in points N(RR(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyROscC`s ||_dS(uC Set the linestyle to be one of ('solid', 'dashed', 'dashdot', 'dotted'). These are defined in the rcParams `lines.dashed_pattern`, `lines.dashdot_pattern` and `lines.dotted_pattern`. One may also specify customized dash styles by providing a tuple of (offset, dash pairs). N(R(RGtstyle((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt set_linestyleUs cC`s ||_dS(u? Sets the url for links in compatible backends N(R(RGturl((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR`scC`s ||_dS(u Sets the id. N(R(RGtid((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytset_gidfscC`s ||_dS(u Sets the snap setting which may be: * True: snap vertices to the nearest pixel center * False: leave vertices as-is * None: (auto) If the path contains only rectilinear line segments, round to the nearest pixel center N(R(RGtsnap((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytset_snapls cC`s ||_dS(u2 Sets the hatch style for filling N(R(RGthatch((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt set_hatchyscC`s|jS(u. Gets the current hatch style (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt get_hatchsg@cC`s,|j}|dkrdStj||S(u7 Returns a Path for the current hatch. N(R-RRR+(RGtdensityR+((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_hatch_paths  cC`s|jS(u5 Gets the color to use for hatching. (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_hatch_colorscC`s ||_dS(u5 sets the color to use for hatching. N(R(RGt hatch_color((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytset_hatch_colorscC`s|jS(u9 Gets the linewidth to use for hatching. (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_hatch_linewidthscC`s|jS(u Returns the sketch parameters for the artist. Returns ------- sketch_params : tuple or `None` A 3-tuple with the following elements: * `scale`: The amplitude of the wiggle perpendicular to the source line. * `length`: The length of the wiggle along the line. * `randomness`: The scale factor by which the length is shrunken or expanded. May return `None` if no sketch parameters were set. (R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_sketch_paramsscC`s4|dkrdn||pd|p'df|_dS(u0 Sets the sketch parameters. Parameters ---------- scale : float, optional The amplitude of the wiggle perpendicular to the source line, in pixels. If scale is `None`, or not provided, no sketch filter will be provided. length : float, optional The length of the wiggle along the line, in pixels (default 128) randomness : float, optional The scale factor by which the length is shrunken or expanded (default 16) g`@g0@N(RR(RGRtlengtht randomness((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytset_sketch_paramssN(-RHRIRTRYRRRRRRR R R R R t deprecatedRRRRRRRRRRRRRARR#RR%RR(R*R,R-R/R0R2R3R4RR7(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRLsN                           t TimerBasecB`seZdZdddZdZddZdZdZdZ dZ dZ e e e Z d Zed Ze eeZd Zd Zd ZdZdZRS(u A base class for providing timer events, useful for things animations. Backends need to implement a few specific methods in order to use their own timing mechanisms so that the timer events are integrated into their event loops. Mandatory functions that must be implemented: * `_timer_start`: Contains backend-specific code for starting the timer * `_timer_stop`: Contains backend-specific code for stopping the timer Optional overrides: * `_timer_set_single_shot`: Code for setting the timer to single shot operating mode, if supported by the timer object. If not, the `Timer` class itself will store the flag and the `_on_timer` method should be overridden to support such behavior. * `_timer_set_interval`: Code for setting the interval on the timer, if there is a method for doing so on the timer object. * `_on_timer`: This is the internal function that any timer object should call, which will handle the task of running all callbacks that have been set. Attributes ---------- interval : scalar The time between timer events in milliseconds. Default is 1000 ms. single_shot : bool Boolean flag indicating whether this timer should operate as single shot (run once and then stop). Defaults to `False`. callbacks : List[Tuple[callable, Tuple, Dict]] Stores list of (func, args, kwargs) tuples that will be called upon timer events. This list can be manipulated directly, or the functions `add_callback` and `remove_callback` can be used. cC`sY|dkrg|_n ||_|dkr:d|_n ||_t|_d|_dS(Ni(Rt callbackst _intervalRAt_singlet_timer(RGtintervalR:((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYs       cC`s|jdS(u1Need to stop timer and possibly disconnect timer.N(t _timer_stop(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt__del__scC`s*|dk r|j|n|jdS(u Start the timer object. `interval` is optional and will be used to reset the timer interval first if provided. N(Rt _set_intervalt _timer_start(RGR>((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytstarts cC`s|jdS(u! Stop the timer. N(R?(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytstopscC`sdS(N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRB!scC`sdS(N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR?$scC`s|jS(N(R;(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt _get_interval'scC`s#t|}||_|jdS(N(tintR;t_timer_set_interval(RGR>((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRA*s  cC`s|jS(N(R<(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt_get_single_shot3scC`s||_|jdS(N(R<t_timer_set_single_shot(RGtss((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt_set_single_shot6s cO`s|jj|||fdS(u Register `func` to be called by timer when the event fires. Any additional arguments provided will be passed to `func`. N(R:Rq(RGtfuncR.R/((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt add_callback<scO`st|s |r(|jj|||fnHg|jD]}|d^q2}||krp|jj|j|ndS(u Remove `func` from list of callbacks. `args` and `kwargs` are optional and used to distinguish between copies of the same function registered to be called with different arguments. iN(R:tremoveR*tindex(RGRLR.R/tctfuncs((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytremove_callbackCs    cC`sdS(u0Used to set interval on underlying timer object.N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRGPscC`sdS(u3Used to set single shot on underlying timer object.N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRISscC`szxQ|jD]F\}}}|||}|dkr |jj|||fq q Wt|jdkrv|jndS(u Runs all function that have been registered as callbacks. Functions can return False (or 0) if they should not be called any more. If there are no callbacks, the timer is automatically stopped. iN(R:RNRfRD(RGRLR.R/tret((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt _on_timerVs   N(RHRIRTRRYR@RCRDRBR?RERAtpropertyR>RHRBRKt single_shotRMRRRGRIRT(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR9s$-           tEventcB`seZdZddZRS(u A matplotlib event. Attach additional attributes as defined in :meth:`FigureCanvasBase.mpl_connect`. The following attributes are defined and shown with their default values Attributes ---------- name : str the event name canvas : `FigureCanvasBase` the backend-specific canvas instance generating the event guiEvent the GUI event that triggered the matplotlib event cC`s||_||_||_dS(N(ROR5tguiEvent(RGROR5RX((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRY|s  N(RHRIRTRRY(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRWjsu2.1t IdleEventcB`seZdZRS(uc An event triggered by the GUI backend when it is idle -- useful for passive animation (RHRIRT(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYst DrawEventcB`seZdZdZRS(u An event triggered by a draw operation on the canvas In most backends callbacks subscribed to this callback will be fired after the rendering is complete but before the screen is updated. Any extra artists drawn to the canvas's renderer will be reflected without an explicit call to ``blit``. .. warning :: Calling ``canvas.draw`` and ``canvas.blit`` in these callbacks may not be safe with all backends and may cause infinite recursion. In addition to the :class:`Event` attributes, the following event attributes are defined: Attributes ---------- renderer : `RendererBase` the renderer for the draw event cC`s tj|||||_dS(N(RWRYR(RGROR5R((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYs(RHRIRTRY(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRZst ResizeEventcB`seZdZdZRS(u' An event triggered by a canvas resize In addition to the :class:`Event` attributes, the following event attributes are defined: Attributes ---------- width : scalar width of the canvas in pixels height : scalar height of the canvas in pixels cC`s/tj||||j\|_|_dS(N(RWRYRtwidthR(RGROR5((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYs(RHRIRTRY(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR[st CloseEventcB`seZdZddZRS(u6 An event triggered by a figure being closed cC`stj||||dS(N(RWRY(RGROR5RX((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYsN(RHRIRTRRY(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR]st LocationEventcB`sGeZdZdZdZdZdZdZdZ ddZ dZ RS(ud An event that has a screen location The following additional attributes are defined and shown with their default values. In addition to the :class:`Event` attributes, the following event attributes are defined: Attributes ---------- x : scalar x position - pixels from left of canvas y : scalar y position - pixels from bottom of canvas inaxes : bool the :class:`~matplotlib.axes.Axes` instance if mouse is over axes xdata : scalar x coord of mouse in data coords ydata : scalar y coord of mouse in data coords c C`sMtj|||d|||_||_|dksC|dkrZd|_|jdS|jjdkrg|jj j D]}|j |r|^q}n|jjg}|r6t j ||_y1|jjj}|j||f\} } Wn#tk r d|_d|_q?X| |_| |_n d|_|jdS(u? *x*, *y* in figure coords, 0,0 = bottom, left RXN(RWRYRmRnRtinaxest_update_enter_leaveR5t mouse_grabberR4tget_axestin_axesR t_topmost_artistt transDatatinvertedRRtxdatatydata( RGROR5RmRnRXtat axes_listRjRgRh((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYs.          cC`stjdk rtj}|j|jkry,|jdk rU|jjjd|nWnnX|jdk r|jjjd|qqn(|jdk r|jjjd|n|t_dS(u*process the figure/axes enter leave eventsuaxes_leave_eventuaxes_enter_eventN(R^t lasteventRR_R5R:tprocess(RGtlast((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR`s N( RHRIRTRRmRnR_RgRhRkRYR`(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR^s %t MouseEventcB`s_eZdZdZdZdZdZdZdZ dZ dZ ddde ddZ dZRS(u A mouse event ('button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event'). In addition to the :class:`Event` and :class:`LocationEvent` attributes, the following attributes are defined: Attributes ---------- button : None, scalar, or str button pressed None, 1, 2, 3, 'up', 'down' (up and down are used for scroll events). Note that in the nbagg backend, both the middle and right clicks return 3 since right clicking will bring up the context menu in some browsers. key : None, or str the key depressed when the mouse event triggered (see :class:`KeyEvent`) step : scalar number of scroll steps (positive for 'up', negative for 'down') Examples -------- Usage:: def on_press(event): print('you pressed', event.button, event.xdata, event.ydata) cid = fig.canvas.mpl_connect('button_press_event', on_press) ic C`sGtj|||||d| ||_||_||_||_dS(un x, y in figure coords, 0,0 = bottom, left button pressed None, 1, 2, 3, 'up', 'down' RXN(R^RYtbuttontkeytsteptdblclick( RGROR5RmRnRoRpRqRrRX((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYUs    cC`s6dd|j|j|j|j|j|j|jfS(Nu4MPL MouseEvent: xy=(%d,%d) xydata=(%s,%s) button=%s udblclick=%s inaxes=%s(RmRnRgRhRoRrR_(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt__str__as N(RHRIRTRRmRnRoRrR_RgRhRqRARYRs(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRn)s" t PickEventcB`seZdZddZRS(u a pick event, fired when the user picks a location on the canvas sufficiently close to an artist. Attrs: all the :class:`Event` attributes plus Attributes ---------- mouseevent : `MouseEvent` the mouse event that generated the pick artist : `matplotlib.artist.Artist` the picked artist other extra class dependent attrs -- e.g., a :class:`~matplotlib.lines.Line2D` pick may define different extra attributes than a :class:`~matplotlib.collections.PatchCollection` pick event Examples -------- Usage:: ax.plot(np.rand(100), 'o', picker=5) # 5 points tolerance def on_pick(event): line = event.artist xdata, ydata = line.get_data() ind = event.ind print('on pick line:', np.array([xdata[ind], ydata[ind]]).T) cid = fig.canvas.mpl_connect('pick_event', on_pick) cK`s<tj||||||_||_|jj|dS(N(RWRYt mouseeventtartistt__dict__tupdate(RGROR5RuRvRXR/((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYs  N(RHRIRTRRY(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRths#tKeyEventcB`s eZdZddddZRS(u A key event (key press, key release). Attach additional attributes as defined in :meth:`FigureCanvasBase.mpl_connect`. In addition to the :class:`Event` and :class:`LocationEvent` attributes, the following attributes are defined: Attributes ---------- key : None or str the key(s) pressed. Could be **None**, a single case sensitive ascii character ("g", "G", "#", etc.), a special key ("control", "shift", "f1", "up", etc.) or a combination of the above (e.g., "ctrl+alt+g", "ctrl+alt+G"). Notes ----- Modifier keys will be prefixed to the pressed key and will be in the order "ctrl", "alt", "super". The exception to this rule is when the pressed key is itself a modifier key, therefore "ctrl+alt" and "alt+control" can both be valid key values. Examples -------- Usage:: def on_key(event): print('you pressed', event.key, event.xdata, event.ydata) cid = fig.canvas.mpl_connect('key_press_event', on_key) icC`s,tj|||||d|||_dS(NRX(R^RYRp(RGROR5RpRmRnRX((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYsN(RHRIRTRRY(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRys"tFigureCanvasBasecB`seZdZddddddddd d d d d ddgZeZdGZeZ e re ddde ddde ddde dddndZ e dZdZejddZdZdGdZdZdZd ZdGd!ZdGd"ZdGd#Zd$ZdGd%ZedGd&ZdGd'ZdGd(Z dGd)Z!dGdGd*Z"ejd+dGd,Z#d-Z$d.Z%d/Z&d0Z'd1Z(d2Z)e*d3Z+e*d4Z,d5Z-dGdGdGd6dGd7Z.e*d8Z/d9Z0d:Z1d;Z2d<Z3d=Z4d>Z5d?Z6d@Z7dAdBZ8dCZ9ejd+dDdEe8Z:ejd+dDdFe9Z;RS(Hu The canvas the figure renders into. Public attributes Attributes ---------- figure : `matplotlib.figure.Figure` A high-level figure instance u resize_eventu draw_eventukey_press_eventukey_release_eventubutton_press_eventubutton_release_eventu scroll_eventumotion_notify_eventu pick_eventu idle_eventufigure_enter_eventufigure_leave_eventuaxes_enter_eventuaxes_leave_eventu close_eventujpgumatplotlib.backends.backend_aggu Joint Photographic Experts GroupujpegutifuTagged Image File FormatutiffcC`st|_t|_|j|||_tj|_t j |_ d|_ d|_d\|_|_|jd|j|_|jd|j|_d|_d|_t|_dS(Nubutton_press_eventu scroll_event(NN(RBt_is_idle_drawingRAt _is_savingt set_canvasR4R tCallbackRegistryR:RtLockDrawt widgetlockRt_buttont_keyt_lastxt_lastyt mpl_connecttpicktbutton_pick_idtscroll_pick_idRattoolbar(RGR4((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYs        cc`st|_dVt|_dS(N(RBR{RA(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt_idle_draw_cntxs cC`s|jS(u Returns whether the renderer is in the process of saving to a file, rather than rendering for an on-screen buffer. (R|(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt is_savingsu2.2cC`stj|jj|}d}|r4|d}nx]|r|jrW|jPnd}x*|D]"}||jkrd|}PqdqdW|}q7WdS(u Mouse event processor which removes the top artist under the cursor. Connect this to the 'mouse_press_event' using:: canvas.mpl_connect('mouse_press_event',canvas.onRemove) iN(R RdR4thitlistRRNt draw_idlet get_children(RGtevtunderRtparenttp((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytonRemoves      cC`s&|jjs"|jj|ndS(N(RtlockedR4R(RGRu((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR$scC`sdS(u0Blit the canvas in bbox (default entire canvas).N((RGtbbox((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytblit(scC`sdS(uSet the canvas size in pixels.N((RGRR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytresize+scC`s/d}t|||}|jj||dS(u@Pass a `DrawEvent` to all functions connected to ``draw_event``.u draw_eventN(RZR:Rl(RGRRZtevent((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt draw_event.scC`s6d}t||}|jj|||jdS(uMPass a `ResizeEvent` to all functions connected to ``resize_event``. u resize_eventN(R[R:RlR(RGRZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt resize_event4scC`sPd}y,t||d|}|jj||Wnttfk rKnXdS(uKPass a `CloseEvent` to all functions connected to ``close_event``. u close_eventRXN(R]R:Rlt TypeErrorR@(RGRXRZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt close_event<s cC`sJ||_d}t||||j|jd|}|jj||dS(uMPass a `KeyEvent` to all functions connected to ``key_press_event``. ukey_press_eventRXN(RRyRRR:Rl(RGRpRXRZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytkey_press_eventKs  !cC`sJd}t||||j|jd|}|jj||d|_dS(uX Pass a `KeyEvent` to all functions connected to ``key_release_event``. ukey_release_eventRXN(RyRRR:RlRR(RGRpRXRZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytkey_release_eventTs !cK`s>d}t||||d|j|}|jj||dS(u This method will be called by artists who are picked and will fire off :class:`PickEvent` callbacks registered listeners u pick_eventRXN(RtRXR:Rl(RGRuRvR/RZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt pick_event^s  c C`sk|dkrd|_n d|_d}t|||||j|jd|d|}|jj||dS(uI Backend derived classes should call this function on any scroll wheel event. x,y are the canvas coords: 0,0 is lower, left. button and key are as defined in MouseEvent. This method will be call all functions connected to the 'scroll_event' with a :class:`MouseEvent` instance. iuupudownu scroll_eventRqRXN(RRnRR:Rl(RGRmRnRqRXRZRu((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt scroll_eventis   c C`sP||_d}t||||||jd|d|}|jj||dS(uW Backend derived classes should call this function on any mouse button press. x,y are the canvas coords: 0,0 is lower, left. button and key are as defined in :class:`MouseEvent`. This method will be call all functions connected to the 'button_press_event' with a :class:`MouseEvent` instance. ubutton_press_eventRrRXN(RRnRR:Rl(RGRmRnRoRrRXRZRu((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytbutton_press_event{s c C`sJd}t||||||jd|}|jj||d|_dS(u Backend derived classes should call this function on any mouse button release. This method will call all functions connected to the 'button_release_event' with a :class:`MouseEvent` instance. Parameters ---------- x : scalar the canvas coordinates where 0=left y : scalar the canvas coordinates where 0=bottom guiEvent the native UI event that generated the mpl event ubutton_release_eventRXN(RnRR:RlRR(RGRmRnRoRXRZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytbutton_release_events$c C`sW|||_|_d}t|||||j|jd|}|jj||dS(u Backend derived classes should call this function on any motion-notify-event. This method will call all functions connected to the 'motion_notify_event' with a :class:`MouseEvent` instance. Parameters ---------- x : scalar the canvas coordinates where 0=left y : scalar the canvas coordinates where 0=bottom guiEvent the native UI event that generated the mpl event umotion_notify_eventRXN(RRRnRRR:Rl(RGRmRnRXRZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytmotion_notify_events  cC`s5|jjdtjdt_d\|_|_dS(u Backend derived classes should call this function when leaving canvas Parameters ---------- guiEvent the native UI event that generated the mpl event ufigure_leave_eventN(NN(R:RlR^RkRRR(RGRX((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytleave_notify_events  cC`sW|dk r.|\}}|||_|_ntd||}|jjd|dS(uP Backend derived classes should call this function when entering canvas Parameters ---------- guiEvent the native UI event that generated the mpl event xy : tuple of 2 scalars the coordinate location of the pointer when the canvas is entered ufigure_enter_eventN(RRRRWR:Rl(RGRXtxyRmRnR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytenter_notify_events   u2.1cC`s2d}t||d|}|jj||dS(uCalled when GUI is idle.u idle_eventRXN(RYR:Rl(RGRXRZR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt idle_eventscC`s1|jd|fkr$tdn||_dS(u Set the child axes which are currently grabbing the mouse events. Usually called by the widgets themselves. It is an error to call this if the mouse is already grabbed by another axes. u&Another Axes already grabs mouse inputN(RaRt RuntimeError(RGtax((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt grab_mousescC`s|j|krd|_ndS(u Release the mouse grab held by the axes, ax. Usually called by the widgets. It is ok to call this even if you ax doesn't have the mouse grab currently. N(RaR(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt release_mousescO`sdS(u.Render the :class:`~matplotlib.figure.Figure`.N((RGR.R/((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytdrawscO`s3|js/|j|j||WdQXndS(uW :meth:`draw` only if idle; defaults to draw but backends can override N(R{RR(RGR.R/((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRs  cC`sdS(u Draw a cursor in the event.axes if inaxes is not None. Use native GUI drawing for efficiency if possible N((RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt draw_cursor scC`s(t|jjjt|jjjfS(u Return the figure width and height in points or pixels (depending on the backend), truncated to integers (RFR4RR\R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s|jS(u=Return dict of savefig file formats supported by this backend(t filetypes(R,((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_supported_filetypesscC`sTi}xGtj|jD]3\}}|j|gj|||jqW|S(u Return a dict of savefig file formats supported by this backend, where the keys are a file type name, such as 'Joint Photographic Experts Group', and the values are a list of filename extensions used for that filetype, such as ['jpg', 'jpeg'].(R t iteritemsRt setdefaultRqtsort(R,t groupingstextRO((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_supported_filetypes_groupeds cC`smd|}t||r|St|}|r<|j|Stdj|djt|jdS(u Return a canvas suitable for saving figures to a specified file format. If necessary, this function will switch to a registered backend that supports the format. uprint_%su4Format {!r} is not supported (supported formats: {})u, N(thasattrR&tswitch_backendsRRtjointsortedR(RGtfmtt method_namet canvas_class((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt_get_output_canvas's   uportraitc K`st|_t}t|dr3|j} |`n|} |dkrt|ttddrrtj |}nt|t j rtj j |dd}n|dks|dkr|j}t|t j r|jdd|}qqn|j}|j|} t| d|} |dkr>td}n|dkrht|jd |jj}n|dkrtd }n|dkrtd }n|jj} |jj} |jj}||j_|jj||jj||jd d}|dkrtd }n|rT|dkr*| tjd|d|d|d|dt|}|jj}|jj|}|jdd}|dkr|jj}ng}x|D]}|j|}|j rW|j!}|dk r t"j#||}n|j$}|dk rW|dk rW|j%}t"j#||j&}qWn|dk r|j'dks|j(dkr|j)|qqW|rt"j*|}t+j,d|jj}t-||}t"j*||g}n|jdd}|dkrtd}n|j.|}nt/j0|j|| j1}||f}nd}z1| |d|d|d|d|d||}Wd|r|r|n| |j_|jj| |jj||jj2|| |k r| |_nt3|_X|S(u  Render the figure to hardcopy. Set the figure patch face and edge colors. This is useful because some of the GUIs have a gray figure face color background and you'll probably want to override this on hardcopy. Parameters ---------- filename can also be a file object on image backends orientation : {'landscape', 'portrait'}, optional only currently applies to PostScript printing. dpi : scalar, optional the dots per inch to save the figure in; if None, use savefig.dpi facecolor : color spec or None, optional the facecolor of the figure; if None, defaults to savefig.facecolor edgecolor : color spec or None, optional the edgecolor of the figure; if None, defaults to savefig.edgecolor format : str, optional when set, forcibly set the file format to save to bbox_inches : str or `~matplotlib.transforms.Bbox`, optional Bbox in inches. Only the given portion of the figure is saved. If 'tight', try to figure out the tight bbox of the figure. If None, use savefig.bbox pad_inches : scalar, optional Amount of padding around the figure when bbox_inches is 'tight'. If None, use savefig.pad_inches bbox_extra_artists : list of `~matplotlib.artist.Artist`, optional A list of extra artists that will be considered when the tight bbox is calculated. umanageruPathLikeiuu.uprint_%su savefig.dpiufigureu _original_dpiusavefig.facecolorusavefig.edgecoloru bbox_inchesu savefig.bboxutightRt facecolort edgecolort orientationtdryrunubbox_extra_artistsig?u pad_inchesusavefig.pad_inchestbbox_inches_restoreN((4RBR|tobjectRR6RRRMtostfspathR R!R`tsplitexttget_default_filetypetrstriptlowerRRR4Rt get_facecolort get_edgecolort set_facecolort set_edgecolorR*tiotBytesIOt_cachedRenderert get_tightbboxtget_default_bbox_extra_artiststget_window_extentt get_clip_ont get_clip_boxRt intersectionR tget_fully_transformed_patht get_extentsR\RRqtunionRRRtpaddedR t adjust_bboxt fixed_dpiR}RA(RGtfilenameRRRRRR/t _no_managerR6R5t print_methodtorigDPIt origfacecolort origedgecolort bbox_inchestresultRt bbox_artistst bbox_filteredRiRtclip_boxt clip_patht_bboxRjt bbox_extratpadt restore_bboxt_bbox_inches_restore((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt print_figure;s*                                         cC`stdS(u Get the default savefig file format as specified in rcParam ``savefig.format``. Returned string excludes period. Overridden in backends that only support a single file type. usavefig.format(R(R,((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s t|dr|jjSdS(u Get the title text of the window containing the figure. Return None if there is no window (e.g., a PS backend). umanagerN(RR6tget_window_title(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s&t|dr"|jj|ndS(u Set the title text of the window containing the figure. Note that this has no effect if there is no window (e.g., a PS backend). umanagerN(RR6tset_window_title(RGttitle((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRscC`s|jpd}|jdd}|j}|d|}tjjtd}d}xDtjjtjj||rdj |||}|d7}q]W|S(ul Return a string, which includes extension, suitable for use as a default filename. uimageu u_u.usavefig.directoryiu{}-{}.{}( RtreplaceRRR`t expanduserRtisfileRR(RGtdefault_basenametdefault_filetypetdefault_filenametsave_dirR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytget_default_filenames $cC`s||j}|j|_|S(uS Instantiate an instance of FigureCanvasClass This is used for backend switching, e.g., to instantiate a FigureCanvasPS from a FigureCanvasGTK. Note, deep copying is not done, so any changes to one of the instances (e.g., setting figure size or line props), will be reflected in the other (R4R|(RGtFigureCanvasClasst newCanvas((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s  cC`s2|dkrtjddn|jj||S(u Connect event with string *s* to *func*. The signature of *func* is:: def func(event) where event is a :class:`matplotlib.backend_bases.Event`. The following events are recognized - 'button_press_event' - 'button_release_event' - 'draw_event' - 'key_press_event' - 'key_release_event' - 'motion_notify_event' - 'pick_event' - 'resize_event' - 'scroll_event' - 'figure_enter_event', - 'figure_leave_event', - 'axes_enter_event', - 'axes_leave_event' - 'close_event' For the location events (button and key press/release), if the mouse is over the axes, the variable ``event.inaxes`` will be set to the :class:`~matplotlib.axes.Axes` the event occurs is over, and additionally, the variables ``event.xdata`` and ``event.ydata`` will be defined. This is the mouse location in data coords. See :class:`~matplotlib.backend_bases.KeyEvent` and :class:`~matplotlib.backend_bases.MouseEvent` for more info. Return value is a connection id that can be used with :meth:`~matplotlib.backend_bases.Event.mpl_disconnect`. Examples -------- Usage:: def on_press(event): print('you pressed', event.button, event.xdata, event.ydata) cid = canvas.mpl_connect('button_press_event', on_press) u idle_eventg?u|idle_event is only implemented for the wx backend, and will be removed in matplotlib 2.1. Use the animations module instead.(R twarn_deprecatedR:tconnect(RGRZRL((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR! s.   cC`s|jj|S(u Disconnect callback id cid Examples -------- Usage:: cid = canvas.mpl_connect('button_press_event', on_press) #...later canvas.mpl_disconnect(cid) (R:t disconnect(RGtcid((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytmpl_disconnectW s cO`s t||S(u Creates a new backend-specific subclass of :class:`backend_bases.Timer`. This is useful for getting periodic events through the backend's native event loop. Implemented only for backends with GUIs. Other Parameters ---------------- interval : scalar Timer interval in milliseconds callbacks : List[Tuple[callable, Tuple, Dict]] Sequence of (func, args, kwargs) where ``func(*args, **kwargs)`` will be executed by the timer every *interval*. callbacks which return ``False`` or ``0`` will be removed from the timer. Examples -------- >>> timer = fig.canvas.new_timer(callbacks=[(f1, (1, ), {'a': 3}),]) (R9(RGR.R/((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt new_timere scC`sdS(ulFlush the GUI events for the figure. Interactive backends need to reimplement this method. N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt flush_events sicC`sr|dkrtj}nd}d}t|_x>|jrm|||krm|jtj||d7}q0WdS(u#Start a blocking event loop. Such an event loop is used by interactive functions, such as `ginput` and `waitforbuttonpress`, to wait for events. The event loop blocks until a callback function triggers `stop_event_loop`, or *timeout* is reached. If *timeout* is negative, never timeout. Only interactive backends need to reimplement this method and it relies on `flush_events` being properly implemented. Interactive backends should implement this in a more native way. ig{Gz?iN(RtinfRBt_loopingRttimetsleep(RGttimeoutttimesteptcounter((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytstart_event_loop s     cC`s t|_dS(uStop the current blocking event loop. Interactive backends need to reimplement this to match `start_event_loop` N(RAR(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytstop_event_loop sROustart_event_loop_defaultustop_event_loop_defaultN(<RHRIRTteventsRBt supports_blitRRRRt_has_pilRRYRRRR R8RRRRRRRRRRRRARRRRRRRRRRRRRQRRRRRRRRRRRRRR R tstart_event_loop_defaulttstop_event_loop_default(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRzs                              6     cC`sS|jdkrdStd}td}td}td}td}td}td} td } td } td } td } td }td}|j|kry|jjWqtk rqXn|j| krtj|jn|dk r|j|kr|j q|j|kr2|j q|j|krN|j q|j|krw|j |j |q|j|kr|j|j |q|j| kr|jqn|jdkrdSd}|j}|j| krd||jj||jjgkr||jj}||jj}ttfttfttfttfg}y1||j||fdt|\}}Wntk rqX|j|d|rdnddd|j|d|rdnddd|jn|j| krd||jj||jjgkr||jj}||jj}ttfttfttfttfg}y1||j||fdt|\}}Wntk rqOX|j|dddd|j|dddd|jn=|j| kr|j}|dkrY|jd|jjjqO|dkrOy|jdWn3tk r}tj t!||jdnX|jjjqOn|j|krr|j"}|dkr |j#d|jjjqO|dkrOy|j#dWn3tk r[}tj t!||j#dnX|jjjqOn|jj$r|jdks|j|krO|j|krt%|jd}nxt&|jj'D]n\}}|j(dk r|j)dk r|j*|r|j|kr2|j+tqH|j+||kqqWndS(uz Implement the default mpl key bindings for the canvas and toolbar described at :ref:`key-event-handling` Parameters ---------- event : :class:`KeyEvent` a key press/release event canvas : :class:`FigureCanvasBase` the backend-specific canvas instance toolbar : :class:`NavigationToolbar2` the navigation cursor toolbar Nukeymap.fullscreenu keymap.homeu keymap.backukeymap.forwardu keymap.panu keymap.zoomu keymap.saveu keymap.quitu keymap.gridukeymap.grid_minoru keymap.yscaleu keymap.xscaleukeymap.all_axescS`s<td|DrtStd|Ds4tSdSdS(Ncs`s|]}|jVqdS(N(tgridOn(t.0ttick((s7lib/python2.7/site-packages/matplotlib/backend_bases.pys scs`s|]}|jVqdS(N(R(RR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pys s(tallRBRRAR(tticks((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt_get_uniform_gridstate s itwhichumajorubothtaxisuxuyulogulinearu0(,RpRRR6tfull_screen_toggleR@Rt destroy_figR4thometbacktforwardtpant _set_cursortzoomt save_figureR_txaxist minorTickstyaxist majorTicksRARBRORfRtgridRt get_yscalet set_yscaleR5twarningstwarntstrt get_xscalet set_xscaletisdigitRFt enumerateRbRmRnRct set_navigate(RR5Rtfullscreen_keyst home_keyst back_keyst forward_keystpan_keyst zoom_keyst save_keyst quit_keyst grid_keystgrid_minor_keysttoggle_yscale_keysttoggle_xscale_keystall_keysRRtx_statety_statetcycleRtexctscalextnRRi((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytkey_press_handler s                     *1 %% *1          -"tNonGuiExceptioncB`seZRS((RHRI(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyREV stFigureManagerBasecB`sneZdZdZdZdZdZdZdZe j ddZ d Z d Z RS( u Helper class for pyplot mode, wraps everything up into a neat bundle Attributes ---------- canvas : :class:`FigureCanvasBase` The backend-specific canvas instance num : int or str The figure number key_press_handler_id : int The default key handler cid, when using the toolmanager. Can be used to disable default key press handling :: figure.canvas.mpl_disconnect( figure.canvas.manager.key_press_handler_id) cC`sV||_||_||_d|_tddkrR|jjd|j|_ndS(Nutoolbaru toolmanagerukey_press_event(R5R6R-Rtkey_press_handler_idRRt key_press(RGR5R-((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRYm s     cC`s tdS(u For GUI backends, show the figure window and redraw. For non-GUI backends, raise an exception to be caught by :meth:`~matplotlib.figure.Figure.show`, for an optional warning. N(RE(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR=x scC`sdS(N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytdestroy scC`sdS(N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR scC`sdS(u1"For GUI backends, resize the window (in pixels).N((RGRR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR scC`s0tddkr,t||j|jjndS(ue Implement the default mpl key bindings defined at :ref:`key-event-handling` utoolbaru toolmanagerN(RRDR5R(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRH su2.2cC`sdS(u'Display message in a popup -- GUI only.N((RGtmsg((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt show_popup scC`sdS(uvGet the title text of the window containing the figure. Return None for non-GUI (e.g., PS) backends. uimage((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR scC`sdS(u}Set the title text of the window containing the figure. This has no effect for non-GUI (e.g., PS) backends. N((RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s(RHRIRTRYR=RIRRRHR R8RKRR(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRFZ s     tNavigationToolbar2c B`sReZdZd;d<d=d?d@dAdBdCdDf ZdZdZdZej dddd Z d!Z d"Z d#Z d$Zd%Zd&Zd'Zd(Zd)Zd*Zd+Zd,Zd-Zd.Zd/Zd0Zd1Zd2Zd3Zd4Zd5Zd6Z d7Z!d8Z"d9Z#d:Z$RS(Eu% Base class for the navigation cursor, version 2 backends must implement a canvas that handles connections for 'button_press_event' and 'button_release_event'. See :meth:`FigureCanvasBase.mpl_connect` for more information They must also define :meth:`save_figure` save the current figure :meth:`set_cursor` if you want the pointer icon to change :meth:`_init_toolbar` create your toolbar widget :meth:`draw_rubberband` (optional) draw the zoom to rect "rubberband" rectangle :meth:`press` (optional) whenever a mouse button is pressed, you'll be notified with the event :meth:`release` (optional) whenever a mouse button is released, you'll be notified with the event :meth:`set_message` (optional) display message :meth:`set_history_buttons` (optional) you can change the history back / forward buttons to indicate disabled / enabled state. That's it, we'll do the rest! uHomeuReset original viewuhomeuBackuBack to previous viewubackuForwarduForward to next viewuforwarduPanu)Pan axes with left mouse, zoom with rightumoveupanuZoomuZoom to rectangleu zoom_to_rectuzoomuSubplotsuConfigure subplotsusubplotsuconfigure_subplotsuSaveuSave the figureufilesaveu save_figurecC`s||_||_tj|_d|_d|_d|_d|_ t j |_ |j |jjd|j|_g|_d|_d|_d|_|jdS(Numotion_notify_eventu(R5RR tStackt _nav_stackRt_xypresst_idPresst _idReleaset_activetcursorstPOINTERt _lastCursort _init_toolbarRt mouse_movet_idDragt _ids_zoomt _zoom_modet_button_pressedtmodetset_history_buttons(RGR5((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRY s              cC`sdS(u.Display a message on toolbar or in status bar.N((RGRZ((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt set_message scG`s%|jj|j|jdS(umove back up the view lim stackN(RNRR]t _update_view(RGR.((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s  u2.1t alternativeucanvas.draw_idlecC`s|jjdS(N(R5R(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytdynamic_update scC`sdS(uDraw a rectangle rubberband to indicate zoom limits. Note that it is not guaranteed that ``x0 <= x1`` and ``y0 <= y1``. N((RGRtx0ty0tx1ty1((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytdraw_rubberband scC`sdS(uRemove the rubberband.N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytremove_rubberband scG`s%|jj|j|jdS(u#Move forward in the view lim stack.N(RNRR]R_(RGR.((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s  cG`s%|jj|j|jdS(uRestore the original view.N(RNRR]R_(RGR.((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s  cC`s tdS(u This is where you actually build the GUI widgets (called by __init__). The icons ``home.xpm``, ``back.xpm``, ``forward.xpm``, ``hand.xpm``, ``zoom_to_rect.xpm`` and ``filesave.xpm`` are standard across backends (there are ppm versions in CVS also). You just need to set the callbacks home : self.home back : self.back forward : self.forward hand : self.pan zoom_to_rect : self.zoom filesave : self.save_figure You only need to define the last one - the others are in the base class implementation. N(R^(RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRV scC`s|j s|j rH|jtjkr|jtjtj|_qn|jdkr|jtjkr|jtjtj|_n@|jdkr|jtjkr|jtjtj|_ndS(NuZOOMuPAN(R_RRRURSRTt set_cursort SELECT_REGIONtMOVE(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR3 scC`sJ|j||jr6|jjr6y|jj|j|j}Wnttfk r]qFXg|jjD]'}|j |rk|j rk|^qk}|rt j |}||jj k r|j|}|dk r|d|j|7}qqnt|jr&|jd|j|fqF|j|n|j|jdS(Nu [%s]u%s, %s(RR_t get_navigatet format_coordRgRhRt OverflowErrort mouseover_settcontainst get_visibleR Rdtpatchtget_cursor_dataRtformat_cursor_dataRfR\R^(RGRRZRitartiststdata((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRWB s$ '  cG`s9|jdkrd|_n d|_|jdk rW|jj|j|_d|_n|jdk r|jj|j|_d|_n|jr|jjd|j|_|jjd|j |_d|_|jj |n|jj j |x*|jj j D]}|j|jq W|j|jdS(uAActivate the pan/zoom tool. pan with left button, zoom with rightuPANuubutton_press_eventubutton_release_eventupan/zoomN(RRRRPR5RR\RQRt press_pant release_panRtreleaseR4Rbtset_navigate_modeR^(RGR.Ri((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR] s(        cC`sdS(u*Called whenever a mouse button is pressed.N((RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytpress} scC`sT|jdkrd|_n(|jdkr6d|_n d|_dS|jdkrb|jn|j|j}}g|_xt|j j j D]\}}|dk r|dk r|j |r|j r|jr|j|||j|jj||f|j j|j|j jd|j|_qqW|j|dS(u1Callback for mouse button press in pan/zoom mode.iiNumotion_notify_event(RoR[RRNt push_currentRmRnROR/R5R4RbRcRktcan_pant start_panRqRRXRtdrag_panRz(RGRRmRnRRi((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRv s&     %' c C`s|jgkrix!|jD]}|jj|qW|j||jd|_d|_g|_dS|jdkrd|_n(|jdkrd|_n d|_dS|j dkr|j n|j |j }}g|_xt |jjjD]s\}}|dk r|dk r|j|r|jr|jr|jj|||||jfqqW|jjd|j}|jjd|j}|jjd|j} ||| f|_|j|_|j|dS(u5Callback for mouse button press in zoom to rect mode.Niiumotion_notify_eventukey_press_eventukey_release_event(RYR5RRxRRROR[RoRNR{RmRnR/R4RbRcRktcan_zoomRqt _get_viewRt drag_zoomt_switch_on_zoom_modet_switch_off_zoom_modeRpRZRz( RGRtzoom_idRmRnRRitid1tid2tid3((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt press_zoom s>          %',     cC`s|j|_|j|dS(N(RpRZRW(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s cC`sd|_|j|dS(N(RRZRW(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s cC`s7|jjtd|jjjD|jdS(u9Push the current view limits and position onto the stack.cS`sFi|]<}|j|jtj|jjff|qS((Rt get_positionRBR(RR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pys s N(RNtpushRR5R4taxesR](RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR{ s  cC`sdS(u"Callback for mouse button release.N((RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRx scC`s|jdkrdS|jj|j|jjd|j|_x!|jD]\}}|jqKW|jsrdSg|_d|_|j |j ||j dS(u3Callback for mouse button release in pan/zoom mode.Numotion_notify_event( R[RR5RRXRRWROtend_panR{RxR(RGRRitind((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRw s      cC`sMx9|jD].\}}|j|j|j|j|jq W|jjdS(u'Callback for dragging in pan/zoom mode.N(ROR~R[RpRmRnR5R(RGRRiR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR~ s&c C`s|jr|j|j}}|jd\}}}}}tj||g||gg|jj|jj\\} } \} } |jdkr|jj \} } n$|jdkr|jj \} } n|j || | | | ndS(u#Callback for dragging in zoom mode.iuxuyN( RORmRnRtclipRtminRRZt intervalyt intervalxRf( RGRRmRntlastxtlastyRiRtviewRdRetx2ty2((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s ?cC`sx!|jD]}|jj|q Wg|_|j|jsDdSg}xx|jD]m}|j|j}}|\}}} } } t||dkr|jdkst||dkr|jdkrd|_|j ||j dSt t } } |rYxS|D]H}| j j| |r1t} n| jj| |r t} q q Wn|j| |jdkr~d}n|jdkrTd}nqT| j||||f||j| | qTW|j d|_d|_d|_|j|j |dS( u7Callback for mouse button release in zoom to rect mode.Niuyuxiuiniuout(RYR5RRgRORmRntabsRZRRxRRAtget_shared_x_axestjoinedRBtget_shared_y_axesRqR[t_set_view_from_bboxR{(RGRRtlast_at cur_xypressRmRnRRRiRRttwinxttwinytlat direction((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt release_zoom sJ   %%              cC`sx|jjjD]}t|dd}t|dd}g}|dk rx|j|j|j|jn|dk r|j|j|j|jnx|D]}|jqWqW|jj dS(u)Redraw the canvases, update the locators.uxaxisuyaxisN( R5R4RbRMRRqtget_major_locatortget_minor_locatortrefreshR(RGRiR"R$tlocatorstloc((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR< s   cC`s|j}|dkrdSt|j}xM|D]E\}\}\}}|j||j|d|j|dq5W|jjdS(u`Update the viewlim and position from the view and position stack for each axes. Nuoriginaluactive(RNRtlisttitemst _set_viewt _set_positionR5R(RGtnav_infoRRRtpos_origt pos_active((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR_M s   cG`s tdS(uSave the current figure.N(R^(RGR.((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR!^ scC`sdS(uCSet the current cursor to one of the :class:`Cursors` enums values. If required by the backend, this method should trigger an update in the backend event loop after the cursor is set, as this method may be called e.g. before a long-running task during which the GUI is not updated. N((RGtcursor((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRhb scC`s|jj|jdS(uReset the axes stack.N(RNtclearR](RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRxk s cG`s9|jdkrd|_n d|_|jdk rW|jj|j|_d|_n|jdk r|jj|j|_d|_n|jr|jjd|j|_|jjd|j |_d|_|jj |n|jj j |x*|jj j D]}|j|jq W|j|jdS(uActivate zoom to rect mode.uZOOMuubutton_press_eventubutton_release_eventu zoom rectN(RRRRPR5RR\RQRRRRRxR4RbRyR^(RGR.Ri((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR p s(        cC`sdS(u*Enable or disable the back/forward button.N((RG((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR] s(uHomeuReset original viewuhomeuhome(uBackuBack to previous viewubackuback(uForwarduForward to next viewuforwarduforwardN(NNNN(uPanu)Pan axes with left mouse, zoom with rightumoveupan(uZoomuZoom to rectangleu zoom_to_rectuzoom(uSubplotsuConfigure subplotsusubplotsuconfigure_subplots(NNNN(uSaveuSave the figureufilesaveu save_figure(%RHRIRTRt toolitemsRYR^RR R8RaRfRgRRRVRRWRRzRvRRRR{RxRwR~RRRR_R!RhRxR R](((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRL sP'               ,      7     tToolContainerBasecB`sheZdZdZdZdZddZdZdZdZ d Z d Z d Z RS( u Base class for all tool containers, e.g. toolbars. Attributes ---------- toolmanager : `ToolManager` The tools with which this `ToolContainer` wants to communicate. u.pngcC`s#||_|jjd|jdS(Nutool_removed_event(t toolmanagerttoolmanager_connectt_remove_tool_cbk(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRY s  cC`s |j|jj|jjdS(uc Captures the 'tool_trigger_[name]' This only gets used for toggled tools N(ttoggle_toolitemttoolROttoggled(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt_tool_toggled_cbk sicC`s|jj|}|j|j}t|dddk }|j|j||||j||r|jj d|j|j |j r|j |jt qndS(ue Adds a tool to this container Parameters ---------- tool : tool_like The tool to add, see `ToolManager.get_tool`. group : str The name of the group to add this tool to. position : int (optional) The position within the group to place this tool. Defaults to end. utoggledutool_trigger_%sN(Rtget_toolt_get_image_filenametimageRMRt add_toolitemRORRRRRRB(RGRtgrouptpositionRttoggle((s7lib/python2.7/site-packages/matplotlib/backend_bases.pytadd_tool s   cC`s|j|jjdS(u>Captures the 'tool_removed_event' signal and removes the tool.N(tremove_toolitemRRO(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR scC`s|s dStjjtdd}|||jtjj||tjj|||jf}x$|D]}tjj|rh|SqhWdS(u!Find the image based on its name.udatapathuimagesN(RRR`RRt_icon_extensionR(RGRtbasedirtpossible_imagestfname((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s  cC`s|jj|d|dS(u Trigger the tool Parameters ---------- name : String Name (id) of the tool triggered from within the container tsenderN(Rt trigger_tool(RGRO((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s cC`s tdS(u Add a toolitem to the container This method must get implemented per backend The callback associated with the button click event, must be **EXACTLY** `self.trigger_tool(name)` Parameters ---------- name : string Name of the tool to add, this gets used as the tool's ID and as the default label of the buttons group : String Name of the group that this tool belongs to position : Int Position of the tool within its group, if -1 it goes at the End image_file : String Filename of the image for the button or `None` description : String Description of the tool, used for the tooltips toggle : Bool * `True` : The button is a toggle (change the pressed/unpressed state between consecutive clicks) * `False` : The button is a normal button (returns to unpressed state after release) N(R^(RGRORRRRR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR scC`s tdS(u Toggle the toolitem without firing event Parameters ---------- name : String Id of the tool to toggle toggled : bool Whether to set this tool as toggled or not. N(R^(RGROR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s cC`s tdS(u Remove a toolitem from the `ToolContainer` This method must get implemented per backend Called when `ToolManager` emits a `tool_removed_event` Parameters ---------- name : string Name of the tool to remove N(R^(RGRO((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s ( RHRIRTRRYRRRRRRRR(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR s       t StatusbarBasecB`s)eZdZdZdZdZRS(uBase class for the statusbarcC`s#||_|jjd|jdS(Nutool_message_event(RRt _message_cbk(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyRY% s  cC`s|j|jdS(u5Captures the 'tool_message_event' and set the messageN(R^tmessage(RGR((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR* scC`sdS(u Display a message on toolbar or in status bar Parameters ---------- s : str Message text N((RGRZ((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR^. s (RHRIRTRYRR^(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyR# s  (ORTt __future__RRRRR t six.movesRt contextlibRt functoolsRR"RRRKRR)tweakrefRtnumpyRR>RttoolsR R R R R RRRRtmatplotlib._pylab_helpersRtmatplotlib.transformsRRRtmatplotlib.pathRtPILRRBRt ImportErrorRARRRRR&RR'RNRURR9RWR8RYRZR[R]R^RnRtRyRzRDt ExceptionRERFRSRLRR(((s7lib/python2.7/site-packages/matplotlib/backend_bases.pyt!s"        F      g [ e?,( J