Rc@sdZddlmZddlZddlmZddlZddlm Z ddlm Z ddlm Z ddl jZddl mZmZddljZdd lmZmZdd lmZdd lmZddljZdd lmZmZmZdd l m!Z!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(m)Z)ddl*m+Z+m,Z,ddl-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3e j4j5de(defdYZ6dfdYZ7defdYZ8dZ9e j4j5dej:e8dS(s4 The figure module provides the top-level :class:`~matplotlib.artist.Artist`, the :class:`Figure`, which contains all the plot elements. The following classes are defined :class:`SubplotParams` control the default spacing of the subplots :class:`Figure` top level container for all plot elements i(tprint_functionN(t itemgetter(trcParams(t docstring(t __version__(tArtisttallow_rasterization(tStacktiterable(t_image(t FigureImage(tAxest SubplotBasetsubplot_class_factory(tBlockingMouseInputtBlockingKeyMouseInput(tLegend(t Rectangle(tget_projection_namestprocess_projection_requirements(tTextt_process_text_args(tAffine2DtBboxtBboxTransformTotTransformedBbox(tNonGuiExceptiontprojection_namest AxesStackcBsheZdZdZdZdZdZdZdZdZ dZ d Z d Z RS( s Specialization of the Stack to handle all tracking of Axes in a Figure. This stack stores ``key, (ind, axes)`` pairs, where: * **key** should be a hash of the args and kwargs used in generating the Axes. * **ind** is a serial number for tracking the order in which axes were added. The AxesStack is a callable, where ``ax_stack()`` returns the current axes. Alternatively the :meth:`current_key_axes` will return the current key and associated axes. cCstj|d|_dS(Ni(Rt__init__t_ind(tself((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRAs cCsIg|jD]\}}|^q }|jg|D]\}}|^q3S(sX Return a list of the Axes instances that have been added to the figure (t _elementstsort(Rtktatia_listti((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytas_listEs" cCs0t|jj|}|dkr(dS|dS(sp Return the Axes instance that was added with *key*. If it is not present, return None. iN(tdictR tgettNone(Rtkeytitem((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR(Ms cCsTtg|jD]$\}\}}|||ff^q |\}}|||ffS(N(R'R (RteR"tindR#((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt_entry_from_axesWsDcCstj||j|dS(sRemove the axes from the stack.N(RtremoveR.(RR#((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR/[scCstj||j|S(sa Move the given axes, which must already exist in the stack, to the top. (RtbubbleR.(RR#((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR0_scCst|ts"td|nyt|Wn!tk rStd|nX|j|}|dk rtj|||ft j d|n||krdS|j d7_ tj |||j |ffS(s Add Axes *a*, with key *key*, to the stack, and return the stack. If *a* is already on the stack, don't add it again, but return *None*. s#second argument, %s, is not an Axess&first argument, %s, is not a valid keys.key %s already existed; Axes is being replacediN( t isinstanceR t ValueErrorthasht TypeErrorR(R)RR/twarningstwarnRtpush(RR*R#t a_existing((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytaddfs    cCsIt|js|j|jfS|j|j\}\}}||fSdS(s Return a tuple of ``(key, axes)`` for the active axes. If no axes exists on the stack, then returns ``(None, None)``. N(tlenR t_defaultt_pos(RR*tindextaxes((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytcurrent_key_axesscCs|jdS(Ni(R?(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt__call__scCs||jkS(N(R&(RR#((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt __contains__s( t__name__t __module__t__doc__RR&R(R.R/R0R9R?R@RA(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR2s       t SubplotParamscBsMeZdZdddddddZdddddddZdZRS(s6 A class to hold the parameters for a subplot cCs)t|_|j||||||dS(s All dimensions are fraction of the figure width or height. All values default to their rc params The following attributes are available *left* : 0.125 The left side of the subplots of the figure *right* : 0.9 The right side of the subplots of the figure *bottom* : 0.1 The bottom of the subplots of the figure *top* : 0.9 The top of the subplots of the figure *wspace* : 0.2 The amount of width reserved for blank space between subplots *hspace* : 0.2 The amount of height reserved for white space between subplots N(tTruetvalidatetupdate(Rtlefttbottomtrightttoptwspacethspace((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRs csMtdd tdd tdd tdd tdd tdd jd|jd|jd|jd|jd|jd|fd}jrIjjkr|tdnjjkrI|td qInd S( s Update the current values. If any kwarg is None, default to the current value, if set, otherwise to rc RIRKRLRJRMRNcs:______dS(N(RIRKRLRJRMRN((Rt thisbottomt thishspacetthisleftt thisrighttthistopt thiswspace(sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytresets      sleft cannot be >= rightsbottom cannot be >= topN( tgetattrR)t _update_thisRGRIRKR2RJRL(RRIRJRKRLRMRNRU((RRORPRQRRRSRTsK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRHs(! cCsX|dkrDt||d}|dkrDd|}t|}qDnt|||dS(Nsfigure.subplot.(R)RVRtsetattr(RtstvalR*((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRWs    N(RBRCRDR)RRHRW(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyREs   &tFigurec BseZdZdZdFdFdFdFddFdFdFdZedZdZe deddZ d Z d Z e e e Z d Zd Zd dddZdZdZdZdZdZdFdZdddFdFdFdFdFdFdZdZdZdZdZdZdZdZd Zd!Z d"Z!d#Z"d$Z#d%Z$d&Z%d'Z&d(Z'e(j)d)Z*e(j)d*Z+e,d+Z-d,Z.e/d-Z0d.Z1d/Z2d0Z3e(j)d1Z4d2Z5e(j)d3Z6d4Z7d5Z8d6Z9d7Z:d8Z;d9Z<e(j)dFdFed:Z=d;Z>d<ded<d=d>d?Z?d@dAZ@dBZAdCZBdFdDdFdFdFdEZCRS(Gs The Figure instance supports callbacks through a *callbacks* attribute which is a :class:`matplotlib.cbook.CallbackRegistry` instance. The events you can connect to are 'dpi_changed', and the callback will be called with ``func(fig)`` where fig is the :class:`Figure` instance. *patch* The figure patch is drawn by a :class:`matplotlib.patches.Rectangle` instance *suppressComposite* For multiple figure images, the figure will make composite images depending on the renderer option_image_nocomposite function. If suppressComposite is True|False, this will override the renderer. cCsdt|jjS(Ns Figure(%gx%g)(ttupletbboxtsize(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt__str__sgc Cstj|tj|_|dkr5td}n|dkrNtd}n|dkrgtd}n|dkrtd}n|dkrtd}nt|_||_ t j dd||_ t |j |j|_||_t|j|_tdddd d d d |d |d ||_|_|j|j|jjttd|_d|_d|_|dkrt}n||_|j|t|_|j d|_!dS(s *figsize* w,h tuple in inches *dpi* Dots per inch *facecolor* The figure patch facecolor; defaults to rc ``figure.facecolor`` *edgecolor* The figure patch edge color; defaults to rc ``figure.edgecolor`` *linewidth* The figure patch edge linewidth; the default linewidth of the frame *frameon* If *False*, suppress drawing the figure frame *subplotpars* A :class:`SubplotParams` instance, defaults to rc *tight_layout* If *False* use *subplotpars*; if *True* adjust subplot parameters using :meth:`tight_layout` with default padding. When providing a dict containing the keys `pad`, `w_pad`, `h_pad` and `rect`, the default :meth:`tight_layout` paddings will be overridden. Defaults to rc ``figure.autolayout``. sfigure.figsizes figure.dpisfigure.facecolorsfigure.edgecolorsfigure.frameonitxytwidthitheightt facecolort edgecolort linewidths axes.holdN(ii("RRtcbooktCallbackRegistryt callbacksR)RRtdpi_scale_transtdpiRt from_boundst bbox_inchesRR]tframeonRt transFigureRtpatcht figurePatcht_set_artist_propstset_aatFalset_holdtcanvast _suptitleREt subplotparstset_tight_layoutRt_axstacktclft_cachedRenderer( RtfigsizeRjRcRdReRmRwt tight_layout((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRsD(                        cCsyt|jd}Wn#tk r;}td|nX|dk rqy|jdSWqqtk rmqqXn|rddl}|jdndS(s If using a GUI backend with pyplot, display the figure window. If the figure was not created using :func:`~matplotlib.pyplot.figure`, it will lack a :class:`~matplotlib.backend_bases.FigureManagerBase`, and will raise an AttributeError. For non-GUI backends, this does nothing, in which case a warning will be issued if *warn* is True (default). tmanagers]%s Figure.show works only for figures managed by pyplot, normally created by pyplot.figure().NisJmatplotlib is currently using a non-GUI backend, so cannot show the figure(RVRutAttributeErrorR)tshowRR5R6(RR6R~terrR5((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRVs     cCs |jjS(N(RyR&(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt _get_axesvstfgettdocs!Read-only: list of axes in FigurecCs|jS(N(t_dpi(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt_get_dpi{scCs9||_|jjj|||jjd|dS(Nt dpi_changed(RRitcleartscaleRhtprocess(RRj((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt_set_dpi~s cCs|jS(sX Return the Boolean flag, True to use :meth`tight_layout` when drawing. (t_tight(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytget_tight_layoutscCsJ|dkrtd}nt||_t|tr=|ni|_dS(sc Set whether :meth:`tight_layout` is used upon drawing. If None, the rcParams['figure.autolayout'] value will be set. When providing a dict containing the keys `pad`, `w_pad`, `h_pad` and `rect`, the default :meth:`tight_layout` paddings will be overridden. ACCEPTS: [True | False | dict | None ] sfigure.autolayoutN(R)RtboolRR1R't_tight_parameters(Rttight((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRxs  g?iRKcCs,tjg|jD]}t|d^q}t|jdkr~x|jdjD] }|j||j|qWWn|rx|jD]w}|j rxb|jD] }|j||j|qWqx!|jD]}|j t qW|j dqWn|r(|j d|ndS(s_ Date ticklabels often overlap, so it is useful to rotate them and right align them. Also, a common use case is a number of subplots with shared xaxes where the x-axis is date data. The ticklabels are often long, and it helps to rotate them on the bottom subplot and turn them off on other subplots, as well as turn off xlabels. *bottom* The bottom of the subplots for :meth:`subplots_adjust` *rotation* The rotation of the xtick labels *ha* The horizontal alignment of the xticklabels t is_last_rowiitRJN(tnptalltrueR>thasattrR:tget_xticklabelstset_hat set_rotationtget_axesRt set_visibleRst set_xlabeltsubplots_adjust(RRJtrotationthataxt allsubplotstlabel((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt autofmt_xdates" %   cCs|jg}|j|j|j|j|j|j|j|j|j|j|j|j|j|j|S(s-get a list of artists contained in the figure( RotextendtartistsR>tlinestpatchesttextstimagestlegends(Rtchildren((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt get_childrens cCsDt|jr|j||S|jj|j|j}|ifS(s_ Test whether the mouse event occurred on the figure. Returns True,{} (tcallablet _containsR]tcontainstxty(Rt mouseeventtinside((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscOs|jS(s=get the figure bounding box in display space; kwargs are void(R](Rtargstkwargs((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytget_window_extentscKs|jdd}|jdd}d|krId|krId|d 0-1 vmin|vmax are used to scale a luminance image to 0-1. If either is *None*, the min and max of the luminance values will be used. Note if you pass a norm instance, the settings for *vmin* and *vmax* will be ignored. alpha the alpha blending value, default is *None* origin [ 'upper' | 'lower' ] Indicates where the [0,0] index of the array is in the upper left or lower left corner of the axes. Defaults to the rc image.origin value ========= ========================================================= figimage complements the axes image (:meth:`~matplotlib.axes.Axes.imshow`) which will be resampled to fit the current axes. If you want a resampled image to fill the entire figure, you can define an :class:`~matplotlib.axes.Axes` with size [0,1,0,1]. An :class:`matplotlib.image.FigureImage` instance is returned. .. plot:: mpl_examples/pylab_examples/figimage_demo.py Additional kwargs are Artist kwargs passed on to :class:`~matplotlib.image.FigureImage` N( RtRzR t set_arrayt set_alphaR)tset_climRtappend( RtXtxotyotalphatnormtcmaptvmintvmaxtoriginRtim((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytfigimage sC     c Os|jdt}t|dkr7|d\}}n |\}}|j}||f|j_|r|j}||}||}t|jdd} | dk r| j t |t |qndS(s set_size_inches(w,h, forward=False) Set the figure size in inches Usage:: fig.set_size_inches(w,h) # OR fig.set_size_inches((w,h) ) optional kwarg *forward=True* will cause the canvas size to be automatically updated; eg you can resize the figure window from the shell ACCEPTS: a w,h tuple with w,h in inches tforwardiiR~N( R(RsR:RjRltp1RVRuR)tresizetint( RRRRtwthtdpivaltcanvaswtcanvashR~((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytset_size_inchesns      cCs |jjS(N(RlR(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytget_size_inchesscCs |jjS(s*Get the edge color of the Figure rectangle(Rot get_edgecolor(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscCs |jjS(s*Get the face color of the Figure rectangle(Rot get_facecolor(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscCs |jjS(sReturn the figwidth as a float(RlRa(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt get_figwidthscCs |jjS(sReturn the figheight as a float(RlRb(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt get_figheightscCs|jS(sReturn the dpi as a float(Rj(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytget_dpiscCs|jS(s"get the boolean indicating frameon(Rm(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt get_frameonscCs|jj|dS(sv Set the edge color of the Figure rectangle ACCEPTS: any matplotlib color - see help(colors) N(Rot set_edgecolor(Rtcolor((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscCs|jj|dS(sv Set the face color of the Figure rectangle ACCEPTS: any matplotlib color - see help(colors) N(Rot set_facecolor(RR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscCs ||_dS(sM Set the dots-per-inch of the figure ACCEPTS: float N(Rj(RRZ((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytset_dpiscCs||j_dS(sO Set the width of the figure in inches ACCEPTS: float N(Rltx1(RRZ((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt set_figwidthscCs||j_dS(sP Set the height of the figure in inches ACCEPTS: float N(Rlty1(RRZ((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt set_figheightscCs ||_dS(so Set whether the figure frame (background) is displayed or invisible ACCEPTS: boolean N(Rm(RR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt set_frameonscCs2|jj|x|jD]}||qWdS(s4remove a from the figure and update the current axesN(RyR/t _axobservers(RR#tfunc((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytdelaxesscOs4d}d}||||jf}|S(s*make a hashable key out of args and kwargscSsUg}xB|D]:\}}t|r4t|}n|j||fq Wt|S(N(RR\R(titemstretR"tv((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytfixitemss  cSsIg}x6|D].}t|r.t|}n|j|q Wt|S(N(RR\R(RRR#((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytfixlists   (t iteritems(RRRRRR*((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt _make_keys cOs"t|sdS|j||}|jj|}|dk rQ|j||St|dtr|d}|j|kst nu|d}t |||\}}}|jj|}|dk rt||r|j||S||||}|jj |||j||S(s Add an axes at position *rect* [*left*, *bottom*, *width*, *height*] where all quantities are in fractions of figure width and height. kwargs are legal :class:`~matplotlib.axes.Axes` kwargs plus *projection* which sets the projection type of the axes. (For backward compatibility, ``polar=True`` may also be provided, which is equivalent to ``projection='polar'``). Valid values for *projection* are: %(projection_names)s. Some of these projections support additional kwargs, which may be provided to :meth:`add_axes`. Typical usage:: rect = l,b,w,h fig.add_axes(rect) fig.add_axes(rect, frameon=False, axisbg='g') fig.add_axes(rect, polar=True) fig.add_axes(rect, projection='polar') fig.add_axes(ax) If the figure already has an axes with the same parameters, then it will simply make that axes current and return it. If you do not want this behavior, e.g., you want to force the creation of a new Axes, you must use a unique set of args and kwargs. The axes :attr:`~matplotlib.axes.Axes.label` attribute has been exposed for this purpose. e.g., if you want two axes that are otherwise identical to be added to the figure, make sure you give them unique labels:: fig.add_axes(rect, label='axes1') fig.add_axes(rect, label='axes2') In rare circumstances, add_axes may be called with a single argument, an Axes instance already created in the present figure but not in the figure's list of axes. For example, if an axes has been removed with :meth:`delaxes`, it can be restored with:: fig.add_axes(ax) In all cases, the :class:`~matplotlib.axes.Axes` instance will be returned. In addition to *projection*, the following kwargs are supported: %(Axes)s Ni( R:RRyR(R)tscaR1R t get_figuretAssertionErrorRR9(RRRR*RR#trecttprojection_class((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytadd_axess*0       cOsYt|sdSt|dkrgt|dtrgtgt|dD]}t|^qI}nt|dtr|d}|j|kst|j||}nt |||\}}}|j j |}|dk rt||r |j ||S|j j|nt||||}|j j|||j ||S(sz Add a subplot. Examples:: fig.add_subplot(111) # equivalent but more general fig.add_subplot(1,1,1) # add subplot with red background fig.add_subplot(212, axisbg='r') # add a polar subplot fig.add_subplot(111, projection='polar') # add Subplot instance sub fig.add_subplot(sub) *kwargs* are legal :class:`~matplotlib.axes.Axes` kwargs plus *projection*, which chooses a projection type for the axes. (For backward compatibility, *polar=True* may also be provided, which is equivalent to *projection='polar'*). Valid values for *projection* are: %(projection_names)s. Some of these projections support additional *kwargs*, which may be provided to :meth:`add_axes`. The :class:`~matplotlib.axes.Axes` instance will be returned. If the figure already has a subplot with key (*args*, *kwargs*) then it will simply make that subplot current and return it. The following kwargs are supported: %(Axes)s Nii(R:R1RR\tstrR RRRRRyR(R)RR/R R9(RRRtcR#R*RR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt add_subplotKs(& %2    cCsd|_tj|_x.t|jD]}|j|j|q(Wt |j dd}|dk rw|j n|j j g|_g|_g|_g|_g|_g|_|sg|_ndS(s Clear the figure. Set *keep_observers* to True if, for example, a gui widget is tracking the axes in the figure. ttoolbarN(R)tsuppressCompositeRfRgRhR\R>tclaRRVRuRHRyRRRRRRRR(Rtkeep_observersRR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRzs"           cCs|jdS(s> Clear the figure -- synonym for :meth:`clf`. N(Rz(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscsjsdSjdjr`jr`yjjWq`tk r\q`Xnjr|jj ng}x6j D]+}|j |j ||j gfqWx6j D]+}|j |j ||j gfqWx6jD]+}|j |j ||j gfqWj}jdk rTj}ntjdks|stjgjD]j^q rxjD]+}|j |j ||j gfqWnj}gjD]-j|jjjf^q}tjjj|jj ||t!_"jj#\}}fd} |j jdj jd| gfx6jD]+}|j |j ||j gfqWx6j$D]+}|j |j ||j gfqWx6j%D]+}|j |j ||j gfq+Wg|D]} | dj&sa| ^qa}|j'dt(dx$|D]\} }} } | | qWj)d_*j+j,dS(su Render the figure using :class:`matplotlib.backend_bases.RendererBase` instance *renderer*. NtfigureicsSj}|jj|jjj||jdS(N(tnew_gctset_clip_rectangleR]t set_clip_patht get_clip_patht draw_imagetrestore(tgc(RRtltrendererR(sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytdraw_composites  iR*(-t get_visiblet open_groupRR>R}RR2RmRotdrawRRt get_zorderRRtoption_image_nocompositeRR)R:RRftallequalRtget_image_magnificationt make_imagetoxtoyt get_alphaR t from_imagesR]RbRaRst is_grayscaletboundsRRt get_animatedR!Rt close_groupR{Rut draw_event(RRtdsuR#t not_compositetmagtimsRRRtrowtzorderRR((RRR RRsK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRs`    )))  ), :     ))))  cCs)|jdk st|j|jdS(s draw :class:`matplotlib.artist.Artist` instance *a* only -- this is available only after the figure is drawn N(R{R)RR(RR#((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt draw_artistscCs|jS(N(R>(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscOs,t|||||}|jj||S(s Place a legend in the figure. Labels are a sequence of strings, handles is a sequence of :class:`~matplotlib.lines.Line2D` or :class:`~matplotlib.patches.Patch` instances, and loc can be a string or an integer specifying the legend location USAGE:: legend( (line1, line2, line3), ('label1', 'label2', 'label3'), 'upper right') The *loc* location codes are:: 'best' : 0, (currently not supported for figure legends) 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10, *loc* can also be an (x,y) tuple in figure coords, which specifies the lower left of the legend box. figure coords are (0,0) is the left, bottom of the figure and 1,1 is the right, top. Keyword arguments: *prop*: [ *None* | FontProperties | dict ] A :class:`matplotlib.font_manager.FontProperties` instance. If *prop* is a dictionary, a new instance will be created with *prop*. If *None*, use rc settings. *numpoints*: integer The number of points in the legend line, default is 4 *scatterpoints*: integer The number of points in the legend line, default is 4 *scatteryoffsets*: list of floats a list of yoffsets for scatter symbols in legend *markerscale*: [ *None* | scalar ] The relative size of legend markers vs. original. If *None*, use rc settings. *fancybox*: [ *None* | *False* | *True* ] if *True*, draw a frame with a round fancybox. If *None*, use rc *shadow*: [ *None* | *False* | *True* ] If *True*, draw a shadow behind legend. If *None*, use rc settings. *ncol* : integer number of columns. default is 1 *mode* : [ "expand" | *None* ] if mode is "expand", the legend will be horizontally expanded to fill the axes area (or *bbox_to_anchor*) *title* : string the legend title Padding and spacing between various elements use following keywords parameters. The dimensions of these values are given as a fraction of the fontsize. Values from rcParams will be used if None. ================ ==================================================== Keyword Description ================ ==================================================== borderpad the fractional whitespace inside the legend border labelspacing the vertical space between the legend entries handlelength the length of the legend handles handletextpad the pad between the legend handle and text borderaxespad the pad between the axes and legend border columnspacing the spacing between columns ================ ==================================================== .. Note:: Not all kinds of artist are supported by the legend. See LINK (FIXME) for details. **Example:** .. plot:: mpl_examples/pylab_examples/figlegend_demo.py (RRR(RthandlestlabelsRRR ((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytlegends[cOs[ti||}td|d|d|}|j||j||jj||S(sn Add text to figure. Call signature:: text(x, y, s, fontdict=None, **kwargs) Add text to figure at location *x*, *y* (relative 0-1 coords). See :func:`~matplotlib.pyplot.text` for the meaning of the other arguments. kwargs control the :class:`~matplotlib.text.Text` properties: %(Text)s RRR(RRRHRqRR(RRRRYRRtoverrideR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR|s   cCs0||kr|j|n|j|jdS(N(t set_figuret set_transformRn(RR#((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRqs cKs|jj\}}|dk r|s+|S|j}t||\}}}|d}|d}||krt||r|Sn|jddd|S(s Return the current axes, creating one if necessary The following kwargs are supported for ensuring the returned axes adheres to the given projection etc., and for axes creation if the active axes does not exist: %(Axes)s iN(RyR?R)tcopyRR1R(RRtckeytcaxt kwargs_copyRt_R*((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytgcas     cCs2|jj|x|jD]}||qW|S(s)Set the current axes to be a and return a(RyR0R(RR#R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRscCsy|jjd}|dkr#dS|j}|dk r?|Sx3t|jD]"}|j}|dk rO|SqOWdS(sZ helper for :func:`~matplotlib.pyplot.gci`; do not use elsewhere. iN(RyR?R)t_gcitreversedR>(RR0RR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR4s     cCs|jj}xd D]}|j|dqWt|dddl j }ddl j |j }|rt|dnd}|jj|||jrj|jnfd}jjd|_jj||_|jndS(NR6R7isWThis figure was saved with matplotlib version %s and is unlikely to function correctly.icsjjdS(N(R<t set_active(tevent(tmgrt pylab_helpers(sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt make_activestbutton_press_event(RRsR9R5R6R8RR)Rutmatplotlib.pyplottpyplotR:R;t get_fignumstmaxt _backend_modtnew_figure_manager_given_figuret get_labeltset_window_titlet mpl_connectt_cidgcfR<RCtnumbertdraw_if_interactive( RR?tversiontrestore_to_pylabR5tplttallnumstnumRG((RERFsK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt __setstate__s.           cCs|jj|dS(s=whenever the axes state change, ``func(self)`` will be calledN(RR(RR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytadd_axobserver%sc Os|jdtd|jdtd}|jdt}|r|jdd|jddg}x~|jD]H}|j}|j|j|jf|j d|j dqrWn(|jdtd |jdtd |r |j }|j |n|j j|||r4|j |n|rxKt|j|D]4\}} |jj | d |jj | d qMWnd S(s] Save the current figure. Call signature:: savefig(fname, dpi=None, facecolor='w', edgecolor='w', orientation='portrait', papertype=None, format=None, transparent=False, bbox_inches=None, pad_inches=0.1, frameon=None) The output formats available depend on the backend being used. Arguments: *fname*: A string containing a path to a filename, or a Python file-like object, or possibly some backend-dependent object such as :class:`~matplotlib.backends.backend_pdf.PdfPages`. If *format* is *None* and *fname* is a string, the output format is deduced from the extension of the filename. If the filename has no extension, the value of the rc parameter ``savefig.format`` is used. If *fname* is not a string, remember to specify *format* to ensure that the correct backend is used. Keyword arguments: *dpi*: [ *None* | ``scalar > 0`` ] The resolution in dots per inch. If *None* it will default to the value ``savefig.dpi`` in the matplotlibrc file. *facecolor*, *edgecolor*: the colors of the figure rectangle *orientation*: [ 'landscape' | 'portrait' ] not supported on all backends; currently only on postscript output *papertype*: One of 'letter', 'legal', 'executive', 'ledger', 'a0' through 'a10', 'b0' through 'b10'. Only supported for postscript output. *format*: One of the file extensions supported by the active backend. Most backends support png, pdf, ps, eps and svg. *transparent*: If *True*, the axes patches will all be transparent; the figure patch will also be transparent unless facecolor and/or edgecolor are specified via kwargs. This is useful, for example, for displaying a plot on top of a colored background on a web page. The transparency of these patches will be restored to their original values upon exit of this function. *frameon*: If *True*, the figure patch will be colored, if *False*, the figure background will be transparent. If not provided, the rcParam 'savefig.frameon' will be used. *bbox_inches*: Bbox in inches. Only the given portion of the figure is saved. If 'tight', try to figure out the tight bbox of the figure. *pad_inches*: Amount of padding around the figure when bbox_inches is 'tight'. *bbox_extra_artists*: A list of extra artists that will be considered when the tight bbox is calculated. Rjs savefig.dpiRmssavefig.frameont transparentRctnoneRdssavefig.facecolorssavefig.edgecoloriiN(t setdefaultRRRsR>RoRRRRRRRRut print_figuretzip( RRRRmR\toriginal_axes_colorsRRotoriginal_frameontcc((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytsavefig)s2N   cKs|dkr|j}n|j}|dkr~|rct|trctj||\}}q~tj||\}}n|jttj |||}|j ||S(s Create a colorbar for a ScalarMappable instance, *mappable*. Documentation for the pylab thin wrapper: %(colorbar_doc)s N( R)R3R1R tcbartmake_axes_gridspect make_axesRRFtcolorbar_factoryR(RtmappableR0Rt use_gridspectkwt current_axtcb((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytcolorbars     cOs|jj||x|jD]}t|ts|jdk rvt|jtrv|jj|j|jj q|j dk rt|j tr|j j|j|j j qq|j|j|j qWdS(s% Call signature:: subplots_adjust(left=None, bottom=None, right=None, top=None, wspace=None, hspace=None) Update the :class:`SubplotParams` with *kwargs* (defaulting to rc when *None*) and update the subplot locations N( RwRHR>R1R t_sharexR)t update_paramsRtfigboxt_sharey(RRRR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRs    iiicCs7t|d|d|d|}|d|d|d|S(s Call signature:: ginput(self, n=1, timeout=30, show_clicks=True, mouse_add=1, mouse_pop=3, mouse_stop=2) Blocking call to interact with the figure. This will wait for *n* clicks from the user and return a list of the coordinates of each click. If *timeout* is zero or negative, does not timeout. If *n* is zero or negative, accumulate clicks until a middle click (or potentially both mouse buttons at once) terminates the input. Right clicking cancels last input. The buttons used for the various actions (adding points, removing points, terminating the inputs) can be overriden via the arguments *mouse_add*, *mouse_pop* and *mouse_stop*, that give the associated mouse button: 1 for left, 2 for middle, 3 for right. The keyboard can also be used to select points in case your mouse does not have one or more of the buttons. The delete and backspace keys act like right clicking (i.e., remove last point), the enter key terminates input and any other key (not already used by the window manager) selects a point. t mouse_addt mouse_popt mouse_stoptnttimeoutt show_clicks(R(RRvRwRxRsRtRutblocking_mouse_input((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytginputs !  icCst|}|d|S(sd Call signature:: waitforbuttonpress(self, timeout=-1) Blocking call to interact with the figure. This will return True is a key was pressed, False if a mouse button was pressed and None if *timeout* was reached without either being pressed. If *timeout* is negative, does not timeout. Rw(R(RRwtblocking_input((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pytwaitforbuttonpresss cCsug|jD]}|jr |^q }x3|jD](}|jr5|j|jq5q5W|j|j|S(N(RRR>Rtget_default_bbox_extra_artistsR/Ro(Rtartistt bbox_artistsR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR}s cCsg}x6|jD]+}|jr|j|j|qqWtjg|D]*}|jdksp|jdkrL|^qL}t|t j d|j }|S(s Return a (tight) bounding box of the figure in inches. It only accounts axes title, axis labels, and axis ticklabels. Needs improvement. ig?( R>RRt get_tightbboxRtunionRaRbRRRRj(RRtbbRRt_bboxRl((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyRs @gHzG?c Csddlm}m}m}||j} d| krGtjdn|dkrb||}n|||j| |d|d|d|d|} |j| dS( sx Adjust subplot parameters to give specified padding. Parameters: *pad* : float padding between the figure edge and the edges of subplots, as a fraction of the font-size. *h_pad*, *w_pad* : float padding (height/width) between edges of adjacent subplots. Defaults to `pad_inches`. *rect* : if rect is given, it is interpreted as a rectangle (left, bottom, right, top) in the normalized figure coordinate that the whole subplots area (including labels) will fit into. Default is (0, 0, 1, 1). i(t get_renderertget_tight_layout_figuretget_subplotspec_listsgThis figure includes Axes that are not compatible with tight_layout, so its results might be incorrect.tpadth_padtw_padRN( R}RRRR>R)R5R6R( RRRRRRRRRtsubplotspec_listR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR}#s   N(DRBRCRDR_R)RRFRRtpropertyR>RRRjRRxRRRRRRRRRRRRRRRRRRRRRRRRRtdedent_interpdRRRsRzRRRR'RR*RRqR3RR4RBRZR[RdRnRRzR|R}RR}(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyR[s  N     '  *   F #               QM  Y   _ ,    *  n  '   c Cst|d}tjd }tjd }|rY|jd \}}t||}n t|}tdd}tj|||f}|td||:}|td||:}tj|||}|S( s; Create a figure with specified aspect ratio. If *arg* is a number, use that aspect ratio. If *arg* is an array, figaspect will determine the width and height for a figure that would fit array preserving aspect ratio. The figure width, height in inches are returned. Be sure to create an axes with equal with and height, eg Example usage:: # make a figure twice as tall as it is wide w, h = figaspect(2.) fig = Figure(figsize=(w,h)) ax = fig.add_axes([0.1, 0.1, 0.8, 0.8]) ax.imshow(A, **kwargs) # make a figure with the proper aspect for an array A = rand(5,3) w, h = figaspect(A) fig = Figure(figsize=(w,h)) ax = fig.add_axes([0.1, 0.1, 0.8, 0.8]) ax.imshow(A, **kwargs) Thanks to Fernando Perez for this function tshapeg@g@g0@isfigure.figsizeig?(g@g@(g0@g0@( RRtarrayRtfloatRtminRLtclip( targtisarrayt figsize_mint figsize_maxtnrtnct arr_ratiot fig_heighttnewsize((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt figaspectJs (;RDt __future__RR5toperatorRtnumpyRRARRRR9tmatplotlib.artistR~tmartistRRtmatplotlib.cbookRfRRR tmatplotlib.imageR tmatplotlib.colorbarRnRetmatplotlib.axesR R R tmatplotlib.blocking_inputRRtmatplotlib.legendRtmatplotlib.patchesRtmatplotlib.projectionsRRtmatplotlib.textRRtmatplotlib.transformsRRRRtmatplotlib.backend_basesRtinterpdRHRRER[Rtkwdoc(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/figure.pyt sB  "dSf =