B ]”t\#bã@s”ddlmZddlZddlZddlZddlmZddlmZddl Z ddl Z ddl Z ddl Z ddl mZmZddlmZmZmZmZmZmZddl mZddlmZddlmZddlmZ ddl!m"Z#ddl$m%Z&ddl'm(Z)ddl*m+Z,ddl-m.Z/ddl0m1Z2ddl3m4Z4ddl5m6Z7ddl8m9Z:ddl;mm?Z?dd l@mAZAmBZBe CeD¡ZEd d „ZFGdd„deGƒZHGdd„de#jIƒZJdS)é)Ú OrderedDictN)ÚReal)Ú attrgetter)ÚcbookÚrcParams)Ú _OrderedSetÚ _check_1dÚ_string_to_boolÚiterableÚindex_ofÚ get_label)Ú docstring)Ú OffsetBox)Úallow_rasterization)ÚLegend)ÚcyclerÚvalidate_axisbelowc Csd}d}d}yPt |¡}ytt|ƒƒ}Wntk rB|||fSX||krV|||fSd}Wntk rpYnX| d¡dkrd}| dd¡}| d¡dkr®d}| dd¡}| d¡dkrÌd}| dd¡}dd „|Dƒ}d}xî|t|ƒkrÌ||}|tj kr|dk rtd |ƒ‚|}n¤|tj krF|dk r@td |ƒ‚|}n||t  ¡krp|dk rjtd |ƒ‚|}nR|d kr¶|t|ƒdkr¶t||dƒ}t d  |¡¡}|d7}n td|ƒ‚|d7}qàW|dkrê|dkrêt d}|dkrød}|dkrd}|||fS)a  Process a MATLAB style color/line style format string. Return a (*linestyle*, *color*) tuple as a result of the processing. Default values are ('-', 'b'). Example format strings include: * 'ko': black circles * '.b': blue dots * 'r--': red dashed lines * 'C2--': the third color in the color cycle, dashed lines .. seealso:: :func:`~matplotlib.Line2D.lineStyles` and :attr:`~matplotlib.colors.cnames` for all possible styles and color format string. Nz--rÚz-.ú ÚNonecSsg|]}|‘qS©r)Ú.0Úcrrú4lib/python3.7/site-packages/matplotlib/axes/_base.pyú \sz(_process_plot_format..z1Illegal format string "%s"; two linestyle symbolsz.Illegal format string "%s"; two marker symbolsz-Illegal format string "%s"; two color symbolsÚCézC{}z*Unrecognized character %c in format stringzlines.linestyle)ÚmcolorsZto_rgbaÚstrÚintÚ ValueErrorÚfindÚreplaceÚlenÚmlinesZ lineStylesZ lineMarkersZget_named_colors_mappingÚformatr) ZfmtÚ linestyleÚmarkerÚcolorZfmtintÚcharsÚirZcolor_cycle_numberrrrÚ_process_plot_format'sp                   r+c@sŠeZdZdZd"dd„Zdd„Zdd„Zd d „Zd d „Zd d„Z dd„Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„Zdd„Zdd „Zd!S)#Ú_process_plot_var_argsa3 Process variable length arguments to the plot command, so that plot commands like the following are supported:: plot(t, s) plot(t1, s1, t2, s2) plot(t1, s1, 'ko', t2, s2) plot(t1, s1, 'ko', t2, s2, 'r--', t3, e3) an arbitrary number of *x*, *y*, *fmt* are allowed ÚplotcCs||_||_| ¡dS)N)ÚaxesÚcommandÚset_prop_cycle)Úselfr.r/rrrÚ__init__sz_process_plot_var_args.__init__cCs|j|jdœS)N)r.r/)r.r/)r1rrrÚ __getstate__”sz#_process_plot_var_args.__getstate__cCs| ¡|_| ¡dS)N)ÚcopyÚ__dict__r0)r1ÚstaterrrÚ __setstate__˜s z#_process_plot_var_args.__setstate__cOsL|s|r t|ƒdkr*|ddkr*td}n t||Ž}t |¡|_|j|_dS)Nrrzaxes.prop_cycle)r#rrÚ itertoolsÚcycleÚ prop_cyclerÚkeysÚ _prop_keys)r1ÚargsÚkwargsr:rrrr0œs     z%_process_plot_var_args.set_prop_cyclecOs´|jjdk r¤|jjdk r¤| d|jjj¡}|jjdkrB| d|¡}| d|jjj¡}|jjdkrl| d|¡}||jjjkrˆ|jj |¡||jjjkr¤|jj |¡|j||Ž}|S)NÚxunitsÚpolarÚ thetaunitsÚyunitsÚrunits)r.ÚxaxisÚyaxisÚpopÚunitsÚnameÚ set_unitsÚ_grab_next_args)r1r=r>r?rBÚretrrrÚ__call__§s     z_process_plot_var_args.__call__cCsd|jkrdSt|jƒdS)z#Return the next color in the cycle.r(Úk)r<Únextr:)r1rrrÚget_next_color¼s z%_process_plot_var_args.get_next_colorcKs"|jdkstdƒ‚|jf|ŽdS)Nr-z$set_lineprops only works with "plot")r/ÚAssertionErrorÚset)r1Úliner>rrrÚ set_linepropsÂsz$_process_plot_var_args.set_linepropscKs"|jdkstdƒ‚|jf|ŽdS)NÚfillz%set_patchprops only works with "fill")r/rPrQ)r1Z fill_polyr>rrrÚset_patchpropsÆsz%_process_plot_var_args.set_patchpropscCsþ|jjdk r^|jjdk r^|jj |¡}|jj |¡}|jdkr^|rN|j |¡}|r^|j |¡}t|ƒ}t|ƒ}|jd|jdkr–t d  |j|j¡ƒ‚|j dksª|j dkr¾t d  |j|j¡ƒ‚|j dkrÚ|dd…t j f}|j dkrö|dd…t j f}||fS)Nr-rzAx and y must have same first dimension, but have shapes {} and {}éz=x and y can be no greater than 2-D, but have shapes {} and {}r)r.rDrEÚ update_unitsr/Úconvert_xunitsÚconvert_yunitsrÚshaper r%ÚndimÚnpZnewaxis)r1ÚxÚyZbxZbyrrrÚ _xy_from_xyÊs*     z"_process_plot_var_args._xy_from_xycsd|j}|dkrtƒ}||}t‡fdd„|Dƒƒr\t|jƒ ¡}x|D]}| |d¡qFWni}|S)a! Only advance the cycler if the cycler has information that is not specified in any of the supplied tuple of dicts. Ignore any keys specified in the `ignore` set. Returns a copy of defaults dictionary if there are any keys that are not found in any of the supplied dictionaries. If the supplied dictionaries have non-None values for everything the property cycler has, then just return an empty dictionary. Ignored keys are excluded from the returned dictionary. Nc3s$|]‰t‡fdd„ˆDƒƒVqdS)c3s|]}| ˆd¡dkVqdS)N)Úget)rÚkw)rMrrú sz@_process_plot_var_args._getdefaults...N)Úall)r)r>)rMrrbsz6_process_plot_var_args._getdefaults..)r<rQÚanyrNr:r4rF)r1Úignorer>Z prop_keysÚ default_dictÚpr)r>rÚ _getdefaultsòs   z#_process_plot_var_args._getdefaultscsBx<|D]4‰t‡fdd„|Dƒƒrx|D]}|ˆ|ˆ<q&WqWdS)zÕ Given a defaults dictionary, and any other dictionaries, update those other dictionaries with information in defaults if none of the other dictionaries contains that information. c3s|]}| ˆd¡dkVqdS)N)r`)rra)rMrrrbsz6_process_plot_var_args._setdefaults..N)rc)r1Údefaultsr>rar)rMrÚ _setdefaultss  z#_process_plot_var_args._setdefaultscCs4||–}| d|¡}| ||¡tj||f|Ž}|S)N)rhrjr$ÚLine2D)r1r]r^rar>rfÚsegrrrÚ _makelines   z _process_plot_var_args._makelinec Cs¼| ¡}| ¡}dddddh}x&| ¡D]\}}|dk r(| |¡q(W| ||¡}| ||¡| dd¡} | dd¡| ||¡tjt   ||f¡| | dd¡|d d } |j | f|Ž| S) Nr'Z markersizeZmarkeredgecolorZmarkerfacecolorZmarkeredgewidthr(rTTÚclosed)Ú facecolorrTrn) r4ÚitemsÚaddrhrjr`rFÚmpatchesZPolygonr\Z column_stackrU) r1r]r^rar>ZignoresrMÚvrfrorlrrrÚ _makefill#s$        z _process_plot_var_args._makefillcCsÖg}t|ƒdkr>t|dtƒr>t|dƒ\}}}|dd…}n t|ƒdkrTtdƒ‚n d\}}}tdd„|Dƒƒrxtdƒ‚i}x,td |||fƒD]\}} | dk rŽ| ||<qŽWd |ks¾|d dkrÐt|ddƒ|d <t|ƒd kröt|d ƒ} t|dƒ} nt |dƒ\} } |  | | ¡\} } |j d kr*|j } n|  dd¡|d<|j} | jd| jd} }| dkr€|dkr€| |kr€t dd¡xPtt| |ƒƒD]>}| | dd…|| f| dd…||f||ƒ}| |¡qW|S)Nréÿÿÿÿéz!third arg must be a format string)NNNcss|]}|dkVqdS)Nr)rrsrrrrb`sz4_process_plot_var_args._plot_args..z(x, y, and format string must not be None)r&r'r(ÚlabelrVrr-rnTz2.2zGcycling among columns of inputs with non-matching shapes is deprecated.)r#Ú isinstancerr+r rdÚzipr rr r_r/rmr`rtrZrÚwarn_deprecatedÚrangeÚmaxÚappend)r1Útupr>rKr&r'r(rarMrsr]r^ÚfuncZncxZncyÚjrlrrrÚ _plot_argsSs@        .z!_process_plot_var_args._plot_argscosfx`|r`|dd…|dd…}}|rLt|dtƒrL||df7}|dd…}| ||¡EdHqWdS)NrVrr)rxrr)r1r=r>ÚthisrrrrJƒs  z&_process_plot_var_args._grab_next_argsN)r-)Ú__name__Ú __module__Ú __qualname__Ú__doc__r2r3r7r0rLrOrSrUr_rhrjrmrtrrJrrrrr,ƒs    ( 00r,csìeZdZdZdZe ¡Ze ¡Ze ¡Z e dd„ƒZ e j dd„ƒZ dd„Z dVd d „Z‡fd d„Zdd„Zdd„Zdd„Zdd„Zdd„ZdWdd„Zdd„Zdd„ZdXd d!„Zd"d#„Zd$d%„Zd&d'„ZdYd)d*„ZdZd,d-„Zd[d.d/„Zd0d1„Zd2d3„Z d4d5„Z!d6d7„Z"d8d9„Z#d\dd?„Z%e e &d@¡dAdB„ƒƒZ'dCdD„Z(dEdF„Z)e)Z*dGdH„Z+e+Z,dIdJ„Z-dKdL„Z.dMdN„Z/d]dOdP„Z0dQdR„Z1d^dSdT„Z2dUdV„Z3d_dWdX„Z4dYdZ„Z5d[d\„Z6d`d]d^„Z7d_d`„Z8dadb„Z9dcdd„Z:dedf„Z;dgdh„Zdmdn„Z?dodp„Z@dqdr„ZAdsdt„ZBdudv„ZCdwdx„ZDdydz„ZEd{d|„ZFdad}d~„ZGdd€„ZHdd‚„ZIdƒd„„ZJd…d†„ZKd‡dˆ„ZLd‰dŠ„ZMd‹dŒ„ZNddŽ„ZOdd„ZPdbd‘d’„ZQdcd“d”„ZRddd•d–„ZSd—d˜„ZTded™dš„ZUd›dœ„ZVddž„ZWdŸd „ZXd¡d¢„ZYd£d¤„ZZd¥d¦„Z[d§d¨„Z\e d©dª„ƒZ]e]j d«dª„ƒZ]d¬d­„Z^d®d¯„Z_ddd d°œd±d²„Z`d³d´„Zadµd¶„Zbdfd·d¸„Zcdgd¹dº„Zdd»d¼„Zed½d¾„Zfegdhd¿dÀ„ƒZhdÁd„ZidÃdÄ„ZjdÅdÆ„ZkdÇdÈ„ZldÉdÊ„ZmdËdÌ„ZndÍd΄ZoepjqdidÐdÑ„ƒZrd+d dddddÒœdÓdÔ„ZsdjdÕdÖ„Ztdkd×dØ„ZudÙdÚ„ZvdÛdÜ„ZwdÝdÞ„Zxdßdà„Zydádâ„Zzdldãdä„Z{dådæ„Z|dçdè„Z}dmdddéœdêdë„Z~dìdí„Zdîdï„Z€dndðdñ„Zdodòdó„Z‚dôdõ„Zƒdöd÷„Z„dpdødù„Z…dqdúdû„Z†düdý„Z‡dþdÿ„Zˆdd„Z‰drdd„ZŠdd„Z‹dsdddœdd„ZŒd d „Zd d „ZŽdtd d„Zdudd„Zdd„Z‘dd„Z’dvdd„Z“dwdd„Z”dxdd„Z•dydd„Z–dd„Z—dd „Z˜d!d"„Z™d#d$„Zšd%d&„Z›d'd(„Zœd)d*„Zd+d,„Zžd-d.„ZŸd/d0„Z d1d2„Z¡d3d4„Z¢d5d6„Z£dzd8d9„Z¤d:d;„Z¥d<d=„Z¦d>d?„Z§d@dA„Z¨dBdC„Z©dDdE„ZªdFdG„Z«dHdI„Z¬d{dJdK„Z­dLdM„Z®dNdO„Z¯dPdQ„Z°dRdS„Z±dTdU„Z²‡Z³S(|Ú _AxesBasez Z rectilinearcCsdS)NTr)r1rrrÚ_hold•sz_AxesBase._holdcCsdS)Nr)r1Úvaluerrrrˆ™scCsd t|ƒj|jj¡S)Nz({0}({1[0]:g},{1[1]:g};{1[2]:g}x{1[3]:g}))r%ÚtyperƒÚ _positionÚbounds)r1rrrÚ__str__sz_AxesBase.__str__NTrc sätj ˆ¡t|tjƒr |ˆ_ntjj|Žˆ_ˆjjdksFˆjj dkrNt dƒ‚ˆj  ¡ˆ_ ˆˆ_ dˆ_dˆ_dˆ_|ˆ_|ˆ_|dk r”ˆj ˆ|¡|dk rªˆj ˆ|¡ˆ |¡ˆ |¡ˆ |  dd¡¡ˆ ¡ˆ_ˆ ¡|dkròtd}|ˆ_|ˆ_ˆ  td ¡dˆ_!iˆ_"ˆ #¡dˆ_$dˆ_%dˆ_&ˆ 'd ¡ˆ (d¡|rVˆ )|¡| rfˆ *| ¡ˆ +| ¡ˆj,dk r–ˆj,j- .d ‡fd d „¡ˆ_/ˆj0dk r¼ˆj0j- .d ‡fdd „¡ˆ_1ˆj2tdoÐtdtdoàtdtdoðtdtdotdtdotdtdo tdtdo0tdtdo@tddd ˆj2tdo\tdtdoltdtdo|tdtdoŒtdtdoœtdtdo¬td tdo¼tdtdoÌtd d!d dˆ_3dˆ_4dS)"a Build an axes in a figure. Parameters ---------- fig : `~matplotlib.figure.Figure` The axes is build in the `.Figure` *fig*. rect : [left, bottom, width, height] The axes is build in the rectangle *rect*. *rect* is in `.Figure` coordinates. sharex, sharey : `~.axes.Axes`, optional The x or y `~.matplotlib.axis` is shared with the x or y axis in the input `~.axes.Axes`. frameon : bool, optional True means that the axes frame is visible. **kwargs Other optional keyword arguments: %(Axes)s Returns ------- axes : `~.axes.Axes` The new `~.axes.Axes` object. rz/Width and height specified must be non-negativeÚautoÚboxrNZ axes_locatorzaxes.facecolorzaxes.axisbelowTzunits finalizecs ˆjddS)NT)Úscalex)Ú_on_units_changedr)r1rrÚþsz$_AxesBase.__init__..cs ˆjddS)NT)Úscaley)r‘r)r1rrr’sz xtick.topzxtick.minor.topz xtick.bottomzxtick.minor.bottomzxtick.labeltopzxtick.labelbottomz ytick.leftzytick.minor.leftz ytick.rightzytick.minor.rightzytick.labelleftzytick.labelrightÚminor) ÚtopÚbottomÚlabeltopÚ labelbottomÚleftÚrightÚ labelleftÚ labelrightÚwhichzxtick.major.topzxtick.major.bottomzytick.major.leftzytick.major.rightÚmajor)5ÚmartistÚArtistr2rxÚ mtransformsÚBboxr‹Ú from_boundsÚwidthÚheightr ÚfrozenÚ_originalPositionr.Ú_aspectÚ _adjustableÚ_anchorÚ_sharexÚ_shareyÚ_shared_x_axesÚjoinÚ_shared_y_axesÚ set_labelÚ set_figureÚset_axes_locatorr`Ú_gen_axes_spinesÚspinesÚ _init_axisrÚ _facecolorÚ_frameonÚ set_axisbelowÚ_rasterization_zorderZ _connectedÚclaÚ fmt_xdataÚ fmt_ydataÚ_cachedRendererÚ set_navigateÚset_navigate_modeÚ set_xscaleÚ set_yscaleÚupdaterDÚ callbacksZconnectZ_xcidrEZ_ycidÚ tick_paramsÚ _layoutboxÚ _poslayoutbox) r1ÚfigZrectroZframeonÚsharexÚshareyrwÚxscaleÚyscaler>r)r1rr2¡s˜'                     z_AxesBase.__init__csVtƒ ¡}xdD] }d||<qWx0dD](}t||ƒ}||krF| |¡nd||<q&W|S)N)r½rÅrÆ)r­r¯Ú _twinned_axes)Úsuperr3ÚgetattrÚ get_siblings)r1r6ÚkeyÚ grouper_nameZgrouper)Ú __class__rrr3%s     z_AxesBase.__getstate__cCs<x*dD]"}| |¡}|rt||ƒj|ŽqW||_d|_dS)N)r­r¯rÌT)rFrÎr®r5Ú_stale)r1r6rÑZsiblingsrrrr73s   z_AxesBase.__setstate__cOsp|j}d}|jr$|j ¡r$|j ¡}d}|jrB|j ¡rB|j ¡}t |j||j |g|j ||j |gg¡S)zc get the axes bounding box in display space; *args* and *kwargs* are empty r) ÚbboxÚaxisonrDÚ get_visibleZget_tick_paddingrEr¡r¢Úx0Úy0Úx1Úy1)r1r=r>rÔZx_padZy_padrrrÚget_window_extent=s  z_AxesBase.get_window_extentcCslt |¡|_|jd |j¡|jd |j¡t |¡|_|jd |j¡|jd |j¡| ¡dS)zAmove this out of __init__ because non-separable axes don't use itr–r•r™ršN)ÚmaxisZXAxisrDr´Z register_axisZYAxisrEÚ_update_transScale)r1rrrrµLs  z_AxesBase._init_axiscCsTtj ||¡t |j|j¡|_tj  ¡|_ tj  ¡|_ t  t ¡¡|_| ¡dS)zt Set the `.Figure` for this `.Axes`. Parameters ---------- fig : `.Figure` N)rŸr r±r¡ÚTransformedBboxr‹Z transFigurerÔr¢ÚnullÚdataLimZunitÚviewLimÚTransformWrapperÚIdentityTransformÚ transScaleÚ_set_lim_and_transforms)r1rÇrrrr±Vs    z_AxesBase.set_figurecCsrt |j¡|_t t ¡¡|_t t |j |j¡¡|_ |j|j |j|_ t  |j |j¡|_ t  |j|j ¡|_dS)a set the *_xaxis_transform*, *_yaxis_transform*, *transScale*, *transData*, *transLimits* and *transAxes* transformations. .. note:: This method is primarily used by rectilinear projections of the :class:`~matplotlib.axes.Axes` class, and is meant to be overridden by new kinds of projection axes that need different transformations and limits. (See :class:`~matplotlib.projections.polar.PolarAxes` for an example. N)r¡ZBboxTransformTorÔÚ transAxesrârãräZBboxTransformFromrÞráZ transLimitsÚ transDataÚblended_transform_factoryÚ_xaxis_transformÚ_yaxis_transform)r1rrrråjs z!_AxesBase._set_lim_and_transformsÚgridcCsF|dkr|jS|dkr$|jd ¡S|dkr:|jd ¡Stdƒ‚dS)aÐ Get the transformation used for drawing x-axis labels, ticks and gridlines. The x-direction is in data coordinates and the y-direction is in axis coordinates. .. note:: This transformation is primarily used by the :class:`~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. rëÚtick1r–Útick2r•zunknown value for whichN)rér´Úget_spine_transformr )r1rrrrÚget_xaxis_transform‘sz_AxesBase.get_xaxis_transformcCs6tjd}|jddt dd|d|jj¡d|fS)a¾ Get the transformation used for drawing x-axis labels, which will add the given amount of padding (in points) between the axes and the label. The x-direction is in data coordinates and the y-direction is in axis coordinates. Returns a 3-tuple of the form:: (transform, valign, halign) where *valign* and *halign* are requested alignments for the text. .. note:: This transformation is primarily used by the :class:`~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. zxtick.alignmentrì)rrruéHr•)Ú matplotlibrrïr¡ÚScaledTranslationÚfigureÚdpi_scale_trans)r1Ú pad_pointsÚ labels_alignrrrÚget_xaxis_text1_transformªs    z#_AxesBase.get_xaxis_text1_transformcCs2tjd}|jddt d|d|jj¡d|fS)aË Get the transformation used for drawing the secondary x-axis labels, which will add the given amount of padding (in points) between the axes and the label. The x-direction is in data coordinates and the y-direction is in axis coordinates. Returns a 3-tuple of the form:: (transform, valign, halign) where *valign* and *halign* are requested alignments for the text. .. note:: This transformation is primarily used by the :class:`~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. zxtick.alignmentrí)rrrðr–)rñrrïr¡ròrórô)r1rõrörrrÚget_xaxis_text2_transformÆs     z#_AxesBase.get_xaxis_text2_transformcCsF|dkr|jS|dkr$|jd ¡S|dkr:|jd ¡Stdƒ‚dS)aÐ Get the transformation used for drawing y-axis labels, ticks and gridlines. The x-direction is in axis coordinates and the y-direction is in data coordinates. .. note:: This transformation is primarily used by the :class:`~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. rërìr™ríršzunknown value for whichN)rêr´rîr )r1rrrrÚget_yaxis_transformász_AxesBase.get_yaxis_transformcCs6tjd}|jddt d|dd|jj¡|dfS)a¾ Get the transformation used for drawing y-axis labels, which will add the given amount of padding (in points) between the axes and the label. The x-direction is in axis coordinates and the y-direction is in data coordinates. Returns a 3-tuple of the form:: (transform, valign, halign) where *valign* and *halign* are requested alignments for the text. .. note:: This transformation is primarily used by the :class:`~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. zytick.alignmentrì)rrurðrrš)rñrrùr¡ròrórô)r1rõrörrrÚget_yaxis_text1_transformús    z#_AxesBase.get_yaxis_text1_transformcCs2tjd}|jddt |dd|jj¡|dfS)aË Get the transformation used for drawing the secondary y-axis labels, which will add the given amount of padding (in points) between the axes and the label. The x-direction is in axis coordinates and the y-direction is in data coordinates. Returns a 3-tuple of the form:: (transform, valign, halign) where *valign* and *halign* are requested alignments for the text. .. note:: This transformation is primarily used by the :class:`~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. zytick.alignmentrí)rrðrr™)rñrrùr¡ròrórô)r1rõrörrrÚget_yaxis_text2_transforms     z#_AxesBase.get_yaxis_text2_transformc Cs^|j t |j ¡|j ¡¡¡x8t|dgƒD](}y|j  ¡Wq.t k rTYq.Xq.WdS)NÚlines) rärQr¡rèrDÚ get_transformrErÎZ_transformed_pathZ invalidateÚAttributeError)r1rRrrrrÝ1sz_AxesBase._update_transScaleFcCs0|r|j ¡S| ¡}|s"| ¡|j ¡SdS)ae Get a copy of the axes rectangle as a `.Bbox`. Parameters ---------- original : bool If ``True``, return the original position. Otherwise return the active position. For an explanation of the positions see `.set_position`. Returns ------- pos : `.Bbox` N)r§r¦Úget_axes_locatorÚ apply_aspectr‹)r1ÚoriginalÚlocatorrrrÚ get_position;s  z_AxesBase.get_positionÚbothcCs|j||dd|_d|_dS)a Set the axes position. Axes have two position attributes. The 'original' position is the position allocated for the Axes. The 'active' position is the position the Axes is actually drawn at. These positions are usually the same unless a fixed aspect is set to the Axes. See `.set_aspect` for details. Parameters ---------- pos : [left, bottom, width, height] or `~matplotlib.transforms.Bbox` The new position of the in `.Figure` coordinates. which : {'both', 'active', 'original'}, optional Determines which position variables to change. )rN)Ú _set_positionrÅrÆ)r1ÚposrrrrÚ set_positionSsz_AxesBase.set_positioncCs`t|tjƒstjj|Ž}x<|j |¡D],}|dkr>|j |¡|dkr&|j  |¡q&Wd|_ dS)zÓ private version of set_position. Call this internally to get the same functionality of `get_position`, but not to take the axis out of the constrained_layout hierarchy. )rÚactive)rrTN) rxr¡ÚBboxBaser¢r£rÌrÏr‹rQr§Ústale)r1rrÚaxrrrrls   z_AxesBase._set_positioncCs4x.|j |¡D]}|jdd}|j|ddqWdS)zÕ Reset the active position to the original position. This resets the a possible position change due to aspect constraints. For an explanation of the positions see `.set_position`. T)rr)rN)rÌrÏrr)r1r rrrrÚreset_position|s z_AxesBase.reset_positioncCs||_d|_dS)z Set the axes locator. Parameters ---------- locator : Callable[[Axes, Renderer], Bbox] TN)Ú _axes_locatorr )r1rrrrr²‡sz_AxesBase.set_axes_locatorcCs|jS)z* Return the axes_locator. )r )r1rrrrÿ’sz_AxesBase.get_axes_locatorcCs<| |j¡| ¡s | |j¡||_|jr8|j |¡dS)z3set the boilerplate props for artists added to axesN) r±róZis_transform_setÚ set_transformrçr.Z mouseoverÚ_mouseover_setrq)r1ÚarrrÚ_set_artist_props˜s   z_AxesBase._set_artist_propscCst ddd¡S)a] Returns the patch used to draw the background of the axes. It is also used as the clipping path for any data elements on the axes. In the standard axes, this is a rectangle, but in other projections it may not be. .. note:: Intended to be overridden by new projection types. )gggð?)rrÚ Rectangle)r1rrrÚ_gen_axes_patch¢sz_AxesBase._gen_axes_patchçÚinchescst‡fdd„dDƒƒS)ai Returns a dict whose keys are spine names and values are Line2D or Patch instances. Each element is used to draw a spine of the axes. In the standard axes, this is a single line segment, but in other projections it may not be. .. note:: Intended to be overridden by new projection types. c3s |]}|tj ˆ|¡fVqdS)N)ÚmspinesZSpineZ linear_spine)rZside)r1rrrbÀsz-_AxesBase._gen_axes_spines..)r™ršr–r•)r)r1Z locationsÚoffsetrGr)r1rr³²s z_AxesBase._gen_axes_spinesc Cs,t|dƒr|j ¡}nd}|j ¡}|j ¡}|j ¡|j ¡x|j ¡D]\}}| ¡qNWd|_t   ¡|_ |j dk rÚ|j jj |j_ |j jj|j_|j  ¡\}}|j||d|j  ¡dt |j j ¡|j¡|j_n4|j d¡y| dd¡Wntk r YnX|jdk rx|jjj |j_ |jjj|j_|j ¡\}} |j|| d|j ¡dt |jj ¡|j¡|j_n4|j d¡y| dd¡Wntk rªYnXtd rÆ|j t ¡¡td rà|j t ¡¡|j dkròd|_ |jdkrd|_!td |_"td |_#d|_$d|_%| &¡t'|ƒ|_(t'|d ƒ|_)td|_*g|_+g|_,g|_-g|_.g|_/g|_0t1ƒ|_2g|_3d|_4d|_5g|_6g|_7| 8d¡|j8|j*tdtddt9j:tdtdd} t;j¡ddd|_?t;j¡ddd|_@td} | A| ¡d|_Bx$|j=|j?|j@fD]} | C| ¡qJW| D¡|_|j E|jF¡|j G|jH¡|j Id¡|j Jd¡|j K|jL¡| M¡|j N|j¡|j N|j¡|jO P¡|jQ P¡|j r|j R|¡|j R|¡|jr"|j R|¡|j R|¡d|_SdS) zClear the current axes.ÚpatchTNF)ÚemitrŽÚlinearrrzxtick.minor.visiblezytick.minor.visiblez axes.xmarginz axes.ymarginrTz axes.gridzaxes.grid.whichzaxes.grid.axis)rÚaxiszaxes.titlesizezaxes.titleweight)ÚsizeZweightgà?gð?rZbaselineÚcenter)r]r^ÚtextZfontpropertiesZverticalalignmentZhorizontalalignmentgr™ršz axes.titlepadr)TÚhasattrrrÖrDrErºr´rpÚignore_existing_data_limitsrZCallbackRegistryrÃr«ržr”Úget_xlimÚset_xlimÚget_autoscalex_onÚmscaleZ scale_factoryÚ get_scaleÚ_scaleÚ _set_scaleÚ TypeErrorr¬Úget_ylimÚset_ylimÚget_autoscaley_onrÚset_minor_locatorÚmtickerÚAutoMinorLocatorÚ _autoscaleXonÚ _autoscaleYonÚ_xmarginÚ_ymarginÚ_tightÚ_use_sticky_edgesrÝr,Ú _get_linesÚ_get_patches_for_fillZ_gridOnrüÚpatchesÚtextsÚtablesÚartistsÚimagesrrÚ child_axesÚ_current_imageÚlegend_Ú collectionsÚ containersrëÚ font_managerZFontPropertiesÚmtextZTextÚtitler4Ú _left_titleÚ _right_titleÚ_set_title_offset_transÚ _autotitleposrrr±róÚ set_facecolorr¶Z set_edgecolorZ set_linewidthrræÚ set_axis_onÚ set_clip_pathr­Zcleanr¯Ú set_visibler ) r1Z patch_visibleZ xaxis_visibleZ yaxis_visiblerHÚspiner×rÙrØrÚZpropsÚtitle_offset_pointsÚ_titlerrrrºÃsÚ                                       z _AxesBase.claz3.0cCs t|jƒS)N)Ú frozensetr)r1rrrÚ mouseover_setWsz_AxesBase.mouseover_setcCs | ¡dS)zClear the axes.N)rº)r1rrrÚclear\sz_AxesBase.clearcCs |j ¡S)zGet the facecolor of the Axes.)rÚ get_facecolor)r1rrrrR`sz_AxesBase.get_facecolorcCs||_d|_|j |¡S)zm Set the facecolor of the Axes. Parameters ---------- color : color T)r¶r rrH)r1r(rrrrHesz_AxesBase.set_facecolorcCsRt d|d|jj¡|_x4|j|j|jfD] }| |j |j¡|  d¡q*WdS)z} Set the offset for the title either from rcParams['axes.titlepad'] or from set_title kwarg ``pad``. grðN) r¡ròrórôZtitleOffsetTransrCrDrErræZ set_clip_box)r1rMrNrrrrFrs  z!_AxesBase._set_title_offset_transcOsT|r|rtdƒ‚t|ƒdkr.|ddkr.d}n t||Ž}|j |¡|j |¡dS)at Set the property cycle of the Axes. The property cycle controls the style properties such as color, marker and linestyle of future plot commands. The style properties of data already added to the Axes are not modified. Call signatures:: set_prop_cycle(cycler) set_prop_cycle(label=values[, label2=values2[, ...]]) set_prop_cycle(label, values) Form 1 sets given `~cycler.Cycler` object. Form 2 creates a `~cycler.Cycler` which cycles over one or more properties simultaneously and set it as the property cycle of the axes. If multiple properties are given, their value lists must have the same length. This is just a shortcut for explicitly creating a cycler and passing it to the function, i.e. it's short for ``set_prop_cycle(cycler(label=values label2=values2, ...))``. Form 3 creates a `~cycler.Cycler` for a single property and set it as the property cycle of the axes. This form exists for compatibility with the original `cycler.cycler` interface. Its use is discouraged in favor of the kwarg form, i.e. ``set_prop_cycle(label=values)``. Parameters ---------- cycler : Cycler Set the given Cycler. *None* resets to the cycle defined by the current style. label : str The property key. Must be a valid `.Artist` property. For example, 'color' or 'linestyle'. Aliases are allowed, such as 'c' for 'color' and 'lw' for 'linewidth'. values : iterable Finite-length iterable of the property values. These values are validated and will raise a ValueError if invalid. Examples -------- Setting the property cycle for a single property: >>> ax.set_prop_cycle(color=['red', 'green', 'blue']) Setting the property cycle for simultaneously cycling over multiple properties (e.g. red circle, green plus, blue cross): >>> ax.set_prop_cycle(color=['red', 'green', 'blue'], ... marker=['o', '+', 'x']) See Also -------- matplotlib.rcsetup.cycler Convenience function for creating validated cyclers for properties. cycler.cycler The original function for creating unvalidated cyclers. zCCannot supply both positional and keyword arguments to this method.rrN)r(r#rr5r0r6)r1r=r>Z prop_cyclerrrr0~s?  z_AxesBase.set_prop_cyclecCs|jS)N)r¨)r1rrrÚ get_aspectÈsz_AxesBase.get_aspectcCs’t|tƒr|dkst|ƒ}|radjustable='datalim' is not allowed when both axes are shared.Fgà?g@g$@)%rrSrHÚ get_xscaleÚ get_yscaleÚwarningsÚwarnrZ get_figureZget_size_inchesr©rÌÚ RuntimeErrorrmrjr¦Zshrunk_to_aspectZanchoredr`rarbrkrlr|rcrŒràrÙr×rÚrØr¤r¥r­r¯Ú set_yboundÚ set_xbound)0r1ZpositionrYrÊrËZaspect_scale_modeÚAZfigWZfigHZ fig_aspectZ box_aspectZpbZpb1rdrerfrgrhriÚlÚbÚwÚhZ data_ratioZ y_expanderZdLZdL_widthZ dL_heightZxrZyrZxmargZymargZYsizeZXsizeZXmargZYmargZxmZymZshared_xZshared_yZadjust_yZadjyZycrØrÚZxcr×rÙrrrr£s¶                          z_AxesBase.apply_aspectc Os6t|ƒt|ƒkrdkrDnn$| ¡\}}| ¡\}}||||fS| dd¡}t|ƒdkrt|dtƒr|d ¡}|dkrŽ| ¡nj|dkr¢| ¡nV|dkrì|  d¡|  d¡|j d d |d kræ|j d d d qø|dkr |j d ddd|  d ¡nÞ|dkr.|j dd |  d ¡n¼|dkr`|j dd |  d ¡|j d dddnŠ|dkrø|j d ddd|  d ¡| ¡} | ¡} t t  | ¡t  | ¡ƒ} |j| d| d| g|d d|j| d| d| g|d dn td|ƒ‚| ¡\}}| ¡\}}||||fSy |dWn²tk rÚ| dd¡}| dd¡}d } |dkrn|dkrnd} |j|||| d\}}| dd¡}| dd¡}d } |dkr¸|dkr¸d} |j|||| d\}}||||fSX|d}t|ƒdkrútdƒ‚|j|d|dg|d d|j|d|dg|d d|S) a¬ Convenience method to get or set some axis properties. Call signatures:: xmin, xmax, ymin, ymax = axis() xmin, xmax, ymin, ymax = axis(xmin, xmax, ymin, ymax) xmin, xmax, ymin, ymax = axis(option) xmin, xmax, ymin, ymax = axis(**kwargs) Parameters ---------- xmin, ymin, xmax, ymax : float, optional The axis limits to be set. Either none or all of the limits must be given. option : str Possible values: ======== ========================================================== Value Description ======== ========================================================== 'on' Turn on axis lines and labels. 'off' Turn off axis lines and labels. 'equal' Set equal scaling (i.e., make circles circular) by changing axis limits. 'scaled' Set equal scaling (i.e., make circles circular) by changing dimensions of the plot box. 'tight' Set limits just large enough to show all data. 'auto' Automatic scaling (fill plot box with data). 'normal' Same as 'auto'; deprecated. 'image' 'scaled' with axis limits equal to data limits. 'square' Square plot; similar to 'scaled', but initially forcing ``xmax-xmin = ymax-ymin``. ======== ========================================================== emit : bool, optional, default *True* Whether observers are notified of the axis limit change. This option is passed on to `~.Axes.set_xlim` and `~.Axes.set_ylim`. Returns ------- xmin, xmax, ymin, ymax : float The axis limits. See also -------- matplotlib.axes.Axes.set_xlim matplotlib.axes.Axes.set_ylim rrTrZonZoff)rTÚtightÚscaledZnormalrŽÚimageÚsquarerŽF)r|rTr_)rZr}rr)rZr[r|r~r)rrŽz-Unrecognized string %s to axis; try on or offrdNrerfrgéz$v must contain [xmin xmax ymin ymax]rVrv)r#r!r)r`rxrÚlowerrIÚ set_axis_offÚset_autoscale_onr\Úautoscale_viewr|r\Zdiffr"r*r Ú IndexError) r1rsr>rdrerfrgrÚsZxlimZylimZ edge_sizerŽrrrr:s€5                                z_AxesBase.axiscCs|jS)z>Return the `Legend` instance, or None if no legend is defined.)r>)r1rrrÚ get_legendºsz_AxesBase.get_legendcCst d|j¡S)z2return a list of Axes images contained by the AxesZ AxesImage)rÚ silent_listr;)r1rrrÚ get_images¾sz_AxesBase.get_imagescCst d|j¡S)z,Return a list of lines contained by the Axesrk)rrˆrü)r1rrrÚ get_linesÂsz_AxesBase.get_linescCs|jS)zReturn the XAxis instance.)rD)r1rrrÚ get_xaxisÆsz_AxesBase.get_xaxiscCst d|j ¡¡S)z5Get the x grid lines as a list of `Line2D` instances.zLine2D xgridline)rrˆrDÚ get_gridlines)r1rrrÚget_xgridlinesÊsz_AxesBase.get_xgridlinescCst d|j ¡¡S)z5Get the x tick lines as a list of `Line2D` instances.zLine2D xtickline)rrˆrDÚ get_ticklines)r1rrrÚget_xticklinesÏsz_AxesBase.get_xticklinescCs|jS)zReturn the YAxis instance.)rE)r1rrrÚ get_yaxisÔsz_AxesBase.get_yaxiscCst d|j ¡¡S)z5Get the y grid lines as a list of `Line2D` instances.zLine2D ygridline)rrˆrErŒ)r1rrrÚget_ygridlinesØsz_AxesBase.get_ygridlinescCst d|j ¡¡S)z5Get the y tick lines as a list of `Line2D` instances.zLine2D ytickline)rrˆrErŽ)r1rrrÚget_yticklinesÝsz_AxesBase.get_yticklinescCsNt|tjjƒr(|jd|jkrDtdƒ‚n||jkrD||jkrDtdƒ‚||_dS)zêSet the current image. This image will be the target of colormap functions like `~.pyplot.viridis`, and other functions such as `~.pyplot.clim`. The current image is an attribute of the current axes. rz"ContourSet must be in current AxeszAArgument must be an image, collection, or ContourSet in this AxesN)rxrñZcontourZ ContourSetr?r r;r=)r1ZimrrrÚ_sciäs  z_AxesBase._scicCs|jS)zZ Helper for :func:`~matplotlib.pyplot.gci`; do not use elsewhere. )r=)r1rrrÚ_gciósz_AxesBase._gcicCs,t|jƒt|jƒt|jƒt|jƒdkS)zÜ Return *True* if any artists have been added to axes. This should not be used to determine whether the *dataLim* need to be updated, and may not actually be useful for anything. r)r#r?r;rür7)r1rrrÚhas_dataús z_AxesBase.has_datacCs<||_|j |¡|jj|_| |¡| |j¡d|_|S)aAdd any :class:`~matplotlib.artist.Artist` to the axes. Use `add_artist` only for artists for which there is no dedicated "add" method; and if necessary, use a method such as `update_datalim` to manually update the dataLim if the artist is to be included in autoscaling. If no ``transform`` has been specified when creating the artist (e.g. ``artist.get_transform() == None``) then the transform is set to ``ax.transData``. Returns the artist. T) r.r:r}ÚremoveÚ_remove_methodrrJrr )r1rrrrÚ add_artists    z_AxesBase.add_artistcCs.||_tj|_|j |¡|jj|_d|_|S)zÈ Add a :class:`~matplotlib.axes.Axesbase` instance as a child to the axes. Returns the added axes. This is the lowlevel version. See `.axes.Axes.inset_axes` T) Z_axesrŸZ_stale_axes_callbackZstale_callbackr<r}r–r—r )r1r rrrÚadd_child_axess   z_AxesBase.add_child_axescCsx| ¡}|s | dt|jƒ¡|j |¡|jj|_| |¡| ¡dkrX|  |j ¡|rn|  |  |j ¡¡d|_|S)z‚ Add a :class:`~matplotlib.collections.Collection` instance to the axes. Returns the collection. z _collection%dNT)r r°r#r?r}r–r—rÚ get_clip_pathrJrÚupdate_datalimZ get_datalimrçr )r1Z collectionZautolimrwrrrÚadd_collection3s     z_AxesBase.add_collectioncCsF| |¡| ¡s&| dt|jƒ¡|j |¡|jj|_d|_|S)ze Add a :class:`~matplotlib.image.AxesImage` to the axes. Returns the image. z_image%dT) rr r°r#r;r}r–r—r )r1r~rrrÚ add_imageJs   z_AxesBase.add_imagecCs,| ¡\}}}}|j ||f||ff¡dS)N)Z get_extentr.r›)r1r~rdrerfrgrrrÚ_update_image_limitsXsz_AxesBase._update_image_limitscCsh| |¡| ¡dkr"| |j¡| |¡| ¡sH| dt|jƒ¡|j  |¡|jj |_ d|_ |S)zv Add a :class:`~matplotlib.lines.Line2D` to the list of plot lines Returns the line. Nz_line%dT) rršrJrÚ_update_line_limitsr r°r#rür}r–r—r )r1rRrrrÚadd_line\s      z_AxesBase.add_linecCs*| |¡|j |¡|jj|_d|_|S)z T)rr8r}r–r—r )r1ZtxtrrrÚ _add_textos    z_AxesBase._add_textc Cs¾| ¡}|jjdkrdS| ¡}||jkr0|}nRt| |j¡ƒr~||j}|jjrr| ¡}|  ¡\}}|  |¡}q‚|  |¡}n|}|jjdkrº| |j¡\} } |j j ||j| | dd|_dS)zV Figures out the data limit of the given line, updating self.dataLim. rN)ÚupdatexÚupdateyF)Úget_pathÚverticesrrýrçrdÚcontains_branch_seperatelyZ is_affineZ_get_transformed_pathZget_transformed_path_and_affineZtransform_path_affineZtransform_pathràZupdate_from_pathr ) r1rRÚpathZ line_transZ data_pathZ trans_to_dataZline_trans_pathZna_pathÚ_r¢r£rrrrŸys,        z_AxesBase._update_line_limitscCsF| |¡| ¡dkr"| |j¡| |¡|j |¡|jj|_|S)a Add a :class:`~matplotlib.patches.Patch` *p* to the list of axes patches; the clipbox will be set to the Axes clipping box. If the transform is not set, it will be set to :attr:`transData`. Returns the patch. N) rršrJrÚ_update_patch_limitsr7r}r–r—)r1rgrrrÚ add_patch¥s      z_AxesBase.add_patchcCst|tjƒr | ¡s | ¡s dS| ¡j}|jdkrŒ| ¡  |¡}|  ¡|j krh|  ¡|j }|  |¡}|  ¡  |j ¡\}}|j|||ddS)z$update the data limits for patch *p*Nr)r¢r£)rxrrrZ get_widthZ get_heightr¤r¥rZget_patch_transformÚ transformZget_data_transformrçrýr¦r›)r1rr¥ÚxysZ patch_to_datar¢r£rrrr©·s     z_AxesBase._update_patch_limitscCs0| |¡|j |¡| |j¡|jj|_|S)a Add a :class:`~matplotlib.table.Table` instance to the list of axes tables Parameters ---------- tab: `matplotlib.table.Table` Table instance Returns ------- `matplotlib.table.Table`: the table. )rr9r}rJrr–r—)r1ZtabrrrÚ add_tableÑs     z_AxesBase.add_tablecCs:| ¡}|s | dt|jƒ¡|j |¡|jj|_|S)z Add a :class:`~matplotlib.container.Container` instance to the axes. Returns the collection. z _container%d)r r°r#r@r}r–r—)r1Z containerrwrrrÚ add_containerås   z_AxesBase.add_containercCs| ¡|j||ddS)z‚ Callback for processing changes to axis units. Currently forces updates of data limits and view limits. )rr“N)Úrelimr„)r1rr“rrrr‘ósz_AxesBase._on_units_changedcCsž|j d¡|j tj ¡ ¡¡d|_x$|jD]}|r@|  ¡r0|  |¡q0Wx$|j D]}|rf|  ¡rV|  |¡qVWx$|j D]}|rŒ|  ¡r|| |¡q|WdS)a Recompute the data limits based on current artists. If you want to exclude invisible artists from the calculation, set ``visible_only=True`` At present, :class:`~matplotlib.collections.Collection` instances are not supported. TN)ràreZ set_pointsr¡r¢rßÚ get_pointsr rürÖrŸr7r©r;rž)r1Z visible_onlyrRrgr~rrrr¯üs       z_AxesBase.relimcCs6t |¡}t|ƒsdS|jj||j||dd|_dS)as Extend the `~.Axes.dataLim` BBox to include the given points. If no data is set currently, the BBox will ignore its limits and set the bound to be the bounds of the xydata (*xys*). Otherwise, it will compute the bounds of the union of its current data and the data in *xys*. Parameters ---------- xys : 2D array-like The points to include in the data limits BBox. This can be either a list of (x, y) tuples or a Nx2 array. updatex, updatey : bool, optional, default *True* Whether to update the x/y limits. N)r¢r£F)r\Zasarrayr#ràZupdate_from_data_xyr )r1r¬r¢r£rrrr›s    z_AxesBase.update_datalimcCs|j tj |j|g¡¡dS)zÄ Extend the `~.Axes.datalim` BBox to include the given `~matplotlib.transforms.Bbox`. Parameters ---------- bounds : `~matplotlib.transforms.Bbox` N)ràrQr¡r¢Úunion)r1rŒrrrÚupdate_datalim_bounds0s z_AxesBase.update_datalim_boundscs0‡fdd„}||ˆjd|ƒ}||ˆjd|ƒ}|S)zALook for unit *kwargs* and update the axis instances as necessarycsŠ|dkr |S|dk r&| ¡s&| |¡|dk r†| ||j¡}ˆjdkr`dddœ}| |||¡}||jkr†| |¡|dk r†| |¡|S)Nr@rArC)r?rB)Z have_unitsrWrFrGrHrI)ÚdatarZ unit_namer>rGZ polar_units)r1rrÚ_process_single_axis>s      z:_AxesBase._process_unit_info.._process_single_axisr?rB)rDrE)r1ÚxdataÚydatar>r´r)r1rÚ_process_unit_info;s z_AxesBase._process_unit_infocCs|j |¡dS)zd Return *True* if the given *mouseevent* (in display coords) is in the Axes r)rÚcontains)r1Ú mouseeventrrrÚin_axes[sz_AxesBase.in_axescCs |jo |jS)zS Get whether autoscaling is applied for both axes on plot commands )r/r0)r1rrrÚget_autoscale_onbsz_AxesBase.get_autoscale_oncCs|jS)zT Get whether autoscaling for the x-axis is applied on plot commands )r/)r1rrrr#hsz_AxesBase.get_autoscalex_oncCs|jS)zT Get whether autoscaling for the y-axis is applied on plot commands )r0)r1rrrr+nsz_AxesBase.get_autoscaley_oncCs||_||_dS)z} Set whether autoscaling is applied on plot commands Parameters ---------- b : bool N)r/r0)r1ryrrrrƒtsz_AxesBase.set_autoscale_oncCs ||_dS)zŒ Set whether autoscaling for the x-axis is applied on plot commands Parameters ---------- b : bool N)r/)r1ryrrrÚset_autoscalex_onsz_AxesBase.set_autoscalex_oncCs ||_dS)zŒ Set whether autoscaling for the y-axis is applied on plot commands Parameters ---------- b : bool N)r0)r1ryrrrÚset_autoscaley_on‰sz_AxesBase.set_autoscaley_oncCs|jS)aÌ When autoscaling, whether to obey all `Artist.sticky_edges`. Default is ``True``. Setting this to ``False`` ensures that the specified margins will be applied, even if the plot includes an image, for example, which would otherwise force a view limit to coincide with its data limit. The changing this property does not change the plot until `autoscale` or `autoscale_view` is called. )r4)r1rrrÚuse_sticky_edges“sz_AxesBase.use_sticky_edgescCst|ƒ|_dS)N)Úboolr4)r1ryrrrr¾¤scCs |dkrtdƒ‚||_d|_dS)aB Set padding of X data limits prior to autoscaling. *m* times the data interval will be added to each end of that interval before it is used in autoscaling. For example, if your data is in the range [0, 2], a factor of ``m = 0.1`` will result in a range [-0.2, 2.2]. Negative values -0.5 < m < 0 will result in clipping of the data range. I.e. for a data range [0, 2], a factor of ``m = -0.1`` will result in a range [0.2, 1.8]. Parameters ---------- m : float greater than -0.5 gà¿z margin must be greater than -0.5TN)r r1r )r1ÚmrrrÚ set_xmargin©sz_AxesBase.set_xmargincCs |dkrtdƒ‚||_d|_dS)aB Set padding of Y data limits prior to autoscaling. *m* times the data interval will be added to each end of that interval before it is used in autoscaling. For example, if your data is in the range [0, 2], a factor of ``m = 0.1`` will result in a range [-0.2, 2.2]. Negative values -0.5 < m < 0 will result in clipping of the data range. I.e. for a data range [0, 2], a factor of ``m = -0.1`` will result in a range [0.2, 1.8]. Parameters ---------- m : float greater than -0.5 gà¿z margin must be greater than -0.5TN)r r2r )r1rÀrrrÚ set_ymargin¿sz_AxesBase.set_ymargin)r]r^r|cGsÒ|r|dk r|dk rtdƒ‚n.cSsg|] }|j‘qSr)r])rÚstickyrrrr{ scSsg|] }|j‘qSr)r^)rrÊrrrr| srncSsg|]}|dkr|‘qS)rr)rÚxsrrrr~ scSsg|]}|dkr|‘qS)rr)rÚysrrrr€ sc  s¾|r|s dS| ˆ¡} dd„| Dƒ} dd„| Dƒ‰tˆƒrv‡fdd„| Dƒ} ‡fdd„| Dƒ} ˆ} |  | ¡|  | ¡tj | ¡} t| |ƒ\}}| ¡}y| ||¡\}}Wn*t k rÖtj||ddd\}}YnXt| |ƒ}|  ¡}|  ¡}t   t  ||¡¡ }t   t  ||¡¡ }|j |||¡\}}| ||g¡\}}t  |¡rft  |¡rf|||}nd }|rx||8}|r†||7}| ||g¡\}}ˆjs°| ||¡\}}|||ƒdS) NcSsg|] }|j‘qSr)rà)rr rrrr‹ szH_AxesBase.autoscale_view..handle_single_axis..cSsg|]}t |¡ ¡r|‘qSr)r\Úisfiniterc)rÚdrrrr scs(g|] }t |j¡ ¡r|ˆkr|‘qSr)r\rÍÚ intervalxrc)rrÎ)Ú finite_dlrrr‘ scs(g|] }t |j¡ ¡r|ˆkr|‘qSr)r\rÍÚ intervalyrc)rrÎ)rÐrrr” sFgš™™™™™©?)Ú increasingZexpanderr)rÏr#Úextendr¡r r±rÎÚget_major_locatorÚ nonsingularrþrýÚinvertedr\rdÚiscloser&Úlimit_range_for_scaler«rÍr3Z view_limits)ÚscaleZ autoscaleonZ shared_axesZintervalZminposrZmarginÚstickiesZ set_boundZsharedZdlZx_finiteZy_finiteÚbbr×rÙrr«Z inverse_transZdo_lower_marginZdo_upper_marginZx0tZx1tZdelta)r1)rÐrÚhandle_single_axis„ sJ     z4_AxesBase.autoscale_view..handle_single_axisrÏZminposxrÑZminposy)r¿r3r¾r1r2Ú get_childrenÚsumrprrqr/r­rDrvr0r¯rEru)r1r|rr“rÚZ x_stickiesZ y_stickiesrÜr)r1rr„a s$   @  z_AxesBase.autoscale_viewcCs |j|jfS)N)rDrE)r1rrrÚ_get_axis_listË sz_AxesBase._get_axis_listc Cs<t d¡|jdk r(|js(t d¡dS|j|j|jf}|jdkr„x:|D]2}| ¡\}}t |d¡sHd|_t d|¡dSqHWd|_x²|D]ª}| ¡\}}d}|j   |¡}xz|D]r}yV|j   ¡dksÔ|j   ¡dkr|j  |¡} | j} |j ¡ d | f¡d } t|| ƒ}Wq°tk r Yq°Xq°W| ||f¡qŠWdS) z‰ Update the title position based on the bounding box enclosing all the ticklabels and x-axis spine and xlabel... Zupdate_title_posNz2title position was updated manually, not adjustinggð?FzEnot adjusting title pos because title was already placed manually: %fTr•gr)Ú_logÚdebugrGrCrDrErr\r×rÌrÏrDZget_label_positionZget_ticks_positionÚ get_tightbboxrgrærÖr«r|rþr) r1ÚrendererZtitlesrCr]r^rØZaxsr rÛr•ZynrrrÚ_update_title_positionÎ s:            z _AxesBase._update_title_positionc sî|dkrˆj}|dkrtdƒ‚ˆ ¡s*dS| d¡dˆ_ˆ ¡}|r\|ˆ|ƒ}ˆ |¡nˆ ¡ˆ ¡}| ˆj ¡ˆj r„ˆj s¢xˆj   ¡D]}| |¡qWˆ |¡ˆj r¶|rÒxˆ ¡D]}| |¡qÀW|rú| ˆj¡| ˆj¡| ˆj¡ˆjj ¡s‡fdd„|Dƒ}t|tdƒd}ˆj‰ˆdk r~|r~|d jˆkr~| ¡‡fd d„|Dƒ}‡fd d„|Dƒ}ng}ˆj ržˆj ržˆj  |¡|rÆx|D]} |  |¡qªW| ¡t |ˆ|¡| d¡|ˆ_d ˆ_ dS) z*Draw everything (plot lines, axes, labels)NzNo renderer definedr.Tcs"g|]}| ¡r|ˆjkr|‘qSr)Z get_animatedr;)rr)r1rrr( sz"_AxesBase.draw..Úzorder)rÐrcsg|]}|jˆkr|‘qSr)rå)rr)Úrasterization_zorderrrr3 scsg|]}|jˆkr|‘qSr)rå)rr)rærrr5 sF)!r½rtrÖZ open_grouprÓrÿrrÝr–rrÕr·r´ÚvaluesrärßrCrDrEróÚcanvasZ is_savingÚsortedrr¹råZstart_rasterizingÚdrawZstop_rasterizingÚmimageZ_draw_list_compositing_imagesZ close_groupr ) r1rãÚinframerrr:rLÚ_axisZartists_rasterizedrr)rær1rrêü s\              z_AxesBase.drawcCs"|jdkrtdƒ‚| |j¡dS)zÅ This method can only be used after an initial draw which caches the renderer. It is used to efficiently update Axes data (axis ticks, labels, etc are not updated) NzLdraw_artist can only be used after an initial draw which caches the renderer)r½rþrê)r1rrrrÚ draw_artistJ s z_AxesBase.draw_artistcCs&|jdkrtdƒ‚|j|jdddS)zÅ This method can only be used after an initial draw which caches the renderer. It is used to efficiently update Axes data (axis ticks, labels, etc are not updated) NzPredraw_in_frame can only be used after an initial draw which caches the rendererT)rì)r½rþrê)r1rrrÚredraw_in_frameU s z_AxesBase.redraw_in_framecCs|jS)N)r½)r1rrrÚget_renderer_cache` sz_AxesBase.get_renderer_cachecCs|jS)z.Get whether the axes rectangle patch is drawn.)r·)r1rrrÚ get_frame_one sz_AxesBase.get_frame_oncCs||_d|_dS)zx Set whether the axes rectangle patch is drawn. Parameters ---------- b : bool TN)r·r )r1ryrrrÚ set_frame_oni sz_AxesBase.set_frame_oncCs|jS)zÔ Get whether axis ticks and gridlines are above or below most artists. Returns ------- axisbelow : bool or 'line' See Also -------- set_axisbelow )Ú _axisbelow)r1rrrÚ get_axisbelowt s z_AxesBase.get_axisbelowcCsft|ƒ|_}|dkrd}n$|dkr*d}n|dkr8d}ntdƒ‚x| ¡D]}| |¡qJWd|_dS) aË Set whether axis ticks and gridlines are above or below most artists. This controls the zorder of the ticks and gridlines. For more information on the zorder see :doc:`/gallery/misc/zorder_demo`. Parameters ---------- b : bool or 'line' Possible values: - *True* (zorder = 0.5): Ticks and gridlines are below all Artists. - 'line' (zorder = 1.5): Ticks and gridlines are above patches ( e.g. rectangles) but still below lines / markers. - *False* (zorder = 2.5): Ticks and gridlines are above patches and lines / markers. See Also -------- get_axisbelow Tgà?Fg@rRgø?zUnexpected axisbelow valueN)rrór rßZ set_zorderr )r1ryZ axisbelowrårrrrr¸‚ sz_AxesBase.set_axisbelowržcKsrt|ƒrd}n|dk rt|ƒ}|dks.|dkrF|jj|fd|i|—Ž|dksV|dkrn|jj|fd|i|—ŽdS)ae Configure the grid lines. Parameters ---------- b : bool or None Whether to show the grid lines. If any *kwargs* are supplied, it is assumed you want the grid on and *b* will be set to True. If *b* is *None* and there are no *kwargs*, this toggles the visibility of the lines. which : {'major', 'minor', 'both'} The grid lines to apply the changes on. axis : {'both', 'x', 'y'} The axis to apply the changes on. **kwargs : `.Line2D` properties Define the line properties of the grid, e.g.:: grid(color='r', linestyle='-', linewidth=2) Valid *kwargs* are %(Line2D)s Notes ----- The grid will be drawn according to the axes' zorder and not its own. TNr]rrr^)r#r rDrërE)r1ryrrr>rrrrë¥ s!z_AxesBase.grid)rÚstyleÚ scilimitsÚ useOffsetÚ useLocaleÚ useMathTextc CsD| ¡}| ¡}|dk rRy|\}}||dWn ttfk rPtdƒ‚YnX|dd…dkrhd} n$|dkrvd} n|d kr„d} ntd ƒ‚y’| dk rØ|d ks¨|d kr¸|jjj | ¡|d ksÈ|d krØ|jjj | ¡|dk r(|d ksô|d kr|jjj |¡|d ks|d kr(|jjj |¡|dk rz|d ksF|d krV|jjj  |¡|d ksj|d krz|jjj  |¡|dk rÌ|d ks˜|d kr¨|jjj  |¡|d ks¼|d krÌ|jjj  |¡|dk r|d ksê|d krú|jjj  |¡|d ks|d kr|jjj  |¡Wnt k r>t dƒ‚YnXdS)a= Change the `~matplotlib.ticker.ScalarFormatter` used by default for linear axes. Optional keyword arguments: ============== ========================================= Keyword Description ============== ========================================= *axis* [ 'x' | 'y' | 'both' ] *style* [ 'sci' (or 'scientific') | 'plain' ] plain turns off scientific notation *scilimits* (m, n), pair of integers; if *style* is 'sci', scientific notation will be used for numbers outside the range 10\ :sup:`m` to 10\ :sup:`n`. Use (0,0) to include all numbers. Use (m,m) where m <> 0 to fix the order of magnitude to 10\ :sup:`m`. *useOffset* [ bool | offset ]; if True, the offset will be calculated as needed; if False, no offset will be used; if a numeric offset is specified, it will be used. *useLocale* If True, format the number according to the current locale. This affects things such as the character used for the decimal separator. If False, use C-style (English) formatting. The default setting is controlled by the axes.formatter.use_locale rcparam. *useMathText* If True, render the offset and scientific notation in mathtext ============== ========================================= Only the major ticks are affected. If the method is called when the :class:`~matplotlib.ticker.ScalarFormatter` is not the :class:`~matplotlib.ticker.Formatter` being used, an :exc:`AttributeError` will be raised. Nrz*scilimits must be a sequence of 2 integersrvZsciTZplainFrz%s is not a valid style valuerr]r^z0This method only works with the ScalarFormatter.) rr r(rDržZ formatterZset_scientificrEZset_powerlimitsZ set_useOffsetZ set_useLocaleZset_useMathTextrþ) r1rrõrör÷rørùrÀÚnZsbrrrÚticklabel_formatÐ sX,    z_AxesBase.ticklabel_formatcKsP|dk}|dk}|r&|j ¡jf|Ž|r<|j ¡jf|Ž|j|||ddS)a Control behavior of tick locators. Parameters ---------- axis : {'both', 'x', 'y'}, optional The axis on which to operate. tight : bool or None, optional Parameter passed to :meth:`autoscale_view`. Default is None, for no change. Other Parameters ---------------- **kw : Remaining keyword arguments are passed to directly to the :meth:`~matplotlib.ticker.MaxNLocator.set_params` method. Typically one might want to reduce the maximum number of ticks and use tight bounds when plotting small subplots, for example:: ax.locator_params(tight=True, nbins=4) Because the locator is involved in autoscaling, :meth:`autoscale_view` is called automatically after the parameters are changed. This presently works only for the :class:`~matplotlib.ticker.MaxNLocator` used by default on linear axes, but it may be generalized. )r]r)r^r)r|rr“N)rDrÔZ set_paramsrEr„)r1rr|r>Z_xZ_yrrrÚlocator_params* s!z_AxesBase.locator_paramscKs |dkrNt|ƒ}| dd¡| dd¡| dd¡| dd¡|jjf|Ž|dkrœt|ƒ}| dd¡| d d¡| d d¡| d d¡|jjf|ŽdS) aa Change the appearance of ticks, tick labels, and gridlines. Parameters ---------- axis : {'x', 'y', 'both'}, optional Which axis to apply the parameters to. Other Parameters ---------------- axis : {'x', 'y', 'both'} Axis on which to operate; default is 'both'. reset : bool If *True*, set all parameters to defaults before processing other keyword arguments. Default is *False*. which : {'major', 'minor', 'both'} Default is 'major'; apply arguments to *which* ticks. direction : {'in', 'out', 'inout'} Puts ticks inside the axes, outside the axes, or both. length : float Tick length in points. width : float Tick width in points. color : color Tick color; accepts any mpl color spec. pad : float Distance in points between tick and label. labelsize : float or str Tick label font size in points or as a string (e.g., 'large'). labelcolor : color Tick label color; mpl color spec. colors : color Changes the tick color and the label color to the same value: mpl color spec. zorder : float Tick and label zorder. bottom, top, left, right : bool Whether to draw the respective ticks. labelbottom, labeltop, labelleft, labelright : bool Whether to draw the respective tick labels. labelrotation : float Tick label rotation grid_color : color Changes the gridline color to the given mpl color spec. grid_alpha : float Transparency of gridlines: 0 (transparent) to 1 (opaque). grid_linewidth : float Width of gridlines in points. grid_linestyle : string Any valid :class:`~matplotlib.lines.Line2D` line style spec. Examples -------- Usage :: ax.tick_params(direction='out', length=6, width=2, colors='r', grid_color='r', grid_alpha=0.5) This will make all major ticks be red, pointing out of the box, and with dimensions 6 points by 2 points. Tick labels will also be red. Gridlines will be red and translucent. )r]rr™Nršr›rœ)r^rr•r–r—r˜)ÚdictrFrDZset_tick_paramsrE)r1rr>ZxkwZykwrrrrÄS sT        z_AxesBase.tick_paramscCsd|_d|_dS)z| Turn the x- and y-axis off. This affects the axis lines, ticks, ticklabels, grid and axis labels. FTN)rÕr )r1rrrr‚¶ sz_AxesBase.set_axis_offcCsd|_d|_dS)z{ Turn the x- and y-axis on. This affects the axis lines, ticks, ticklabels, grid and axis labels. TN)rÕr )r1rrrrI¿ sz_AxesBase.set_axis_oncCs |j| ¡ddd…dddS)z˜ Invert the x-axis. See Also -------- xaxis_inverted get_xlim, set_xlim get_xbound, set_xbound Nru)rŽ)r"r!)r1rrrÚ invert_xaxisÊ s z_AxesBase.invert_xaxiscCs| ¡\}}||kS)zú Return whether the x-axis is inverted. The axis is inverted if the left value is larger than the right value. See Also -------- invert_xaxis get_xlim, set_xlim get_xbound, set_xbound )r!)r1r™ršrrrÚxaxis_invertedÖ s z_AxesBase.xaxis_invertedcCs(| ¡\}}||kr||fS||fSdS)zÆ Return the lower and upper x-axis bounds, in increasing order. See Also -------- set_xbound get_xlim, set_xlim invert_xaxis, xaxis_inverted N)r!)r1r™ršrrrraå s z_AxesBase.get_xboundcCsž|dkrt|ƒr|\}}| ¡\}}|dkr0|}|dkr<|}| ¡rp||kr^|j||ddqš|j||ddn*||krŠ|j||ddn|j||dddS)a Set the lower and upper numerical bounds of the x-axis. This method will honor axes inversion regardless of parameter order. It will not change the autoscaling setting (``Axes._autoscaleXon``). Parameters ---------- lower, upper : float or None The lower and upper bounds. If *None*, the respective axis bound is not modified. See Also -------- get_xbound get_xlim, set_xlim invert_xaxis, xaxis_inverted N)rŽ)r rarÿr")r1rÚupperÚ old_lowerÚ old_upperrrrrvõ s z_AxesBase.set_xboundcCs t|jjƒS)aº Return the x-axis view limits. Returns ------- left, right : (float, float) The current x-axis limits in data coordinates. See Also -------- set_xlim set_xbound, get_xbound invert_xaxis, xaxis_inverted Notes ----- The x-axis may be inverted, in which case the *left* value will be greater than the *right* value. )ÚtuplerárÏ)r1rrrr! sz_AxesBase.get_xlimcCs4|dk r0||ƒ}t|tƒr,t |¡s,tdƒ‚|SdS)zû Raise ValueError if converted limits are non-finite. Note that this function also accepts None as a limit argument. Returns ------- The limit value after call to convert(), or None if limit is None. Nz Axis limits cannot be NaN or Inf)rxrr\rÍr )r1ÚlimitZconvertZconverted_limitrrrÚ_validate_converted_limits4 s   z$_AxesBase._validate_converted_limits)rdrec Csî|dkrt|ƒr|\}}|dk rFtjddddd|dk rBtdƒ‚|}|dk rttjddd dd|dk rptd ƒ‚|}|j||fd | ||j¡}| ||j¡}| ¡\}}|dkr¸|}|dkrÄ|}||krâtj d ||fd dt j ||dd\}}|  ¡dkr<|dkr tj dd d|}|dkr>> set_xlim(left, right) >>> set_xlim((left, right)) >>> left, right = set_xlim(left, right) One limit may be left unchanged. >>> set_xlim(right=right_lim) Limits may be passed in reverse order to flip the direction of the x-axis. For example, suppose ``x`` represents the number of years before present. The x-axis limits might be set like the following so 5000 years ago is on the left of the plot and the present is on the right. >>> set_xlim(5000, 0) Nz3.0z`xmin`z`left`Úargument)rHÚ alternativer^z"Cannot pass both `xmin` and `left`z`xmax`z`right`z#Cannot pass both `xmax` and `right`)rµzwAttempting to set identical left==right results in singular transformations; automatically expanding. left=%s, right=%srV)roF)rÒrnrz\Attempted to set non-positive left xlim on a log-scaled axis. Invalid limit will be ignored.z]Attempted to set non-positive right xlim on a log-scaled axis. Invalid limit will be ignored.Z xlim_changed)rrŽT)r rrzr(r·rrXr!rrrsr¡rÕrprDrØrárÏr¿r/rÃÚprocessr­rÏr"rórèÚ draw_idler ) r1r™ršrrŽrdreZold_leftZ old_rightÚotherrrrr"F sjE           z_AxesBase.set_xlimcCs |j ¡S)zj Return the x-axis scale as string. See Also -------- set_xscale )rDr%)r1rrrrpÌ sz_AxesBase.get_xscalecKsJ| ¡}x0| |¡D]"}|jj|f|Ž| ¡d|_qW|jdddS)aý Set the x-axis scale. Parameters ---------- value : {"linear", "log", "symlog", "logit", ...} The axis scale type to apply. **kwargs Different keyword arguments are accepted, depending on the scale. See the respective class keyword arguments: - `matplotlib.scale.LinearScale` - `matplotlib.scale.LogScale` - `matplotlib.scale.SymmetricalLogScale` - `matplotlib.scale.LogitScale` Notes ----- By default, Matplotlib supports the above mentioned scales. Additionally, custom scales may be registered using `matplotlib.scale.register_scale`. These scales can then also be used here. TF)r“N)Úget_shared_x_axesrÏrDr'rÝr r„)r1r‰r>Úgr rrrrÀÖ s  z_AxesBase.set_xscalecCs|jj|dS)z)Return the x ticks as a list of locations)r”)rDÚ get_ticklocs)r1r”rrrÚ get_xticksø sz_AxesBase.get_xtickscCs|jj||d}d|_|S)a( Set the x ticks with list of *ticks* Parameters ---------- ticks : list List of x-axis tick locations. minor : bool, optional If ``False`` sets major ticks, if ``True`` sets minor ticks. Default is ``False``. )r”T)rDÚ set_ticksr )r1Úticksr”rKrrrÚ set_xticksü s z_AxesBase.set_xtickscCst d|j ¡¡S)z¢ Get the major x tick labels. Returns ------- labels : list List of :class:`~matplotlib.text.Text` instances zText xticklabel)rrˆrDÚget_majorticklabels)r1rrrÚget_xmajorticklabels s z_AxesBase.get_xmajorticklabelscCst d|j ¡¡S)z¢ Get the minor x tick labels. Returns ------- labels : list List of :class:`~matplotlib.text.Text` instances zText xticklabel)rrˆrDÚget_minorticklabels)r1rrrÚget_xminorticklabels s z_AxesBase.get_xminorticklabelscCst d|jj||d¡S)aù Get the x tick labels as a list of :class:`~matplotlib.text.Text` instances. Parameters ---------- minor : bool, optional If True return the minor ticklabels, else return the major ticklabels. which : None, ('minor', 'major', 'both') Overrides `minor`. Selects which ticklabels to return Returns ------- ret : list List of :class:`~matplotlib.text.Text` instances. zText xticklabel)r”r)rrˆrDÚget_ticklabels)r1r”rrrrÚget_xticklabels% sz_AxesBase.get_xticklabelscKs4|dk r| |¡|jj|fd|i|—Ž}d|_|S)a% Set the x-tick labels with list of string labels. Parameters ---------- labels : List[str] List of string labels. fontdict : dict, optional A dictionary controlling the appearance of the ticklabels. The default `fontdict` is:: {'fontsize': rcParams['axes.titlesize'], 'fontweight': rcParams['axes.titleweight'], 'verticalalignment': 'baseline', 'horizontalalignment': loc} minor : bool, optional Whether to set the minor ticklabels rather than the major ones. Returns ------- A list of `~.text.Text` instances. Other Parameters ----------------- **kwargs : `~.text.Text` properties. Nr”T)rÂrDÚset_ticklabelsr )r1ÚlabelsÚfontdictr”r>rKrrrÚset_xticklabels> s    z_AxesBase.set_xticklabelscCs |j| ¡ddd…dddS)z˜ Invert the y-axis. See Also -------- yaxis_inverted get_ylim, set_ylim get_ybound, set_ybound Nru)rŽ)r*r))r1rrrÚ invert_yaxisb s z_AxesBase.invert_yaxiscCs| ¡\}}||kS)zú Return whether the y-axis is inverted. The axis is inverted if the bottom value is larger than the top value. See Also -------- invert_yaxis get_ylim, set_ylim get_ybound, set_ybound )r))r1r–r•rrrÚyaxis_invertedn s z_AxesBase.yaxis_invertedcCs(| ¡\}}||kr||fS||fSdS)zÆ Return the lower and upper y-axis bounds, in increasing order. See Also -------- set_ybound get_ylim, set_ylim invert_yaxis, yaxis_inverted N)r))r1r–r•rrrrb} s z_AxesBase.get_yboundcCsž|dkrt|ƒr|\}}| ¡\}}|dkr0|}|dkr<|}| ¡rp||kr^|j||ddqš|j||ddn*||krŠ|j||ddn|j||dddS)a Set the lower and upper numerical bounds of the y-axis. This method will honor axes inversion regardless of parameter order. It will not change the autoscaling setting (``Axes._autoscaleYon``). Parameters ---------- lower, upper : float or None The lower and upper bounds. If *None*, the respective axis bound is not modified. See Also -------- get_ybound get_ylim, set_ylim invert_yaxis, yaxis_inverted N)rŽ)r rbrr*)r1rrrrrrrru s z_AxesBase.set_yboundcCs t|jjƒS)aº Return the y-axis view limits. Returns ------- bottom, top : (float, float) The current y-axis limits in data coordinates. See Also -------- set_ylim set_ybound, get_ybound invert_yaxis, yaxis_inverted Notes ----- The y-axis may be inverted, in which case the *bottom* value will be greater than the *top* value. )rrárÑ)r1rrrr)µ sz_AxesBase.get_ylim)rfrgc Csî|dkrt|ƒr|\}}|dk rFtjddddd|dk rBtdƒ‚|}|dk rttjddd dd|dk rptd ƒ‚|}|j||fd | ||j¡}| ||j¡}| ¡\}}|dkr¸|}|dkrÄ|}||krâtj d ||fd dt j ||dd\}}|  ¡dkr<|dkr tj dd d|}|dkr>> set_ylim(bottom, top) >>> set_ylim((bottom, top)) >>> bottom, top = set_ylim(bottom, top) One limit may be left unchanged. >>> set_ylim(top=top_lim) Limits may be passed in reverse order to flip the direction of the y-axis. For example, suppose ``y`` represents depth of the ocean in m. The y-axis limits might be set like the following so 5000 m depth is at the bottom of the plot and the surface, 0 m, is at the top. >>> set_ylim(5000, 0) Nz3.0z`ymin`z`bottom`r)rHrr^z$Cannot pass both `ymin` and `bottom`z`ymax`z`top`z!Cannot pass both `ymax` and `top`)r¶zwAttempting to set identical bottom==top results in singular transformations; automatically expanding. bottom=%s, top=%srV)roF)rÒrnrz^Attempted to set non-positive bottom ylim on a log-scaled axis. Invalid limit will be ignored.z[Attempted to set non-positive top ylim on a log-scaled axis. Invalid limit will be ignored.Z ylim_changed)rrŽT)r rrzr(r·rrYr)rrrsr¡rÕrqrErØrárÑr¿r0rÃrr¯rÏr*rórèr r ) r1r–r•rrŽrfrgZ old_bottomZold_topr rrrr*Ì sjD           z_AxesBase.set_ylimcCs |j ¡S)zj Return the x-axis scale as string. See Also -------- set_yscale )rEr%)r1rrrrqRsz_AxesBase.get_yscalecKsJ| ¡}x0| |¡D]"}|jj|f|Ž| ¡d|_qW|jdddS)aý Set the y-axis scale. Parameters ---------- value : {"linear", "log", "symlog", "logit", ...} The axis scale type to apply. **kwargs Different keyword arguments are accepted, depending on the scale. See the respective class keyword arguments: - `matplotlib.scale.LinearScale` - `matplotlib.scale.LogScale` - `matplotlib.scale.SymmetricalLogScale` - `matplotlib.scale.LogitScale` Notes ----- By default, Matplotlib supports the above mentioned scales. Additionally, custom scales may be registered using `matplotlib.scale.register_scale`. These scales can then also be used here. TF)rN)Úget_shared_y_axesrÏrEr'rÝr r„)r1r‰r>r r rrrrÁ\s  z_AxesBase.set_yscalecCs|jj|dS)z)Return the y ticks as a list of locations)r”)rEr )r1r”rrrÚ get_yticks}sz_AxesBase.get_ytickscCs|jj||d}|S)a' Set the y ticks with list of *ticks* Parameters ---------- ticks : list List of y-axis tick locations minor : bool, optional If ``False`` sets major ticks, if ``True`` sets minor ticks. Default is ``False``. )r”)rEr)r1rr”rKrrrÚ set_ytickss z_AxesBase.set_ytickscCst d|j ¡¡S)z¢ Get the major y tick labels. Returns ------- labels : list List of :class:`~matplotlib.text.Text` instances zText yticklabel)rrˆrEr)r1rrrÚget_ymajorticklabels‘s z_AxesBase.get_ymajorticklabelscCst d|j ¡¡S)z¢ Get the minor y tick labels. Returns ------- labels : list List of :class:`~matplotlib.text.Text` instances zText yticklabel)rrˆrEr)r1rrrÚget_yminorticklabelss z_AxesBase.get_yminorticklabelscCst d|jj||d¡S)aî Get the y tick labels as a list of :class:`~matplotlib.text.Text` instances. Parameters ---------- minor : bool If True return the minor ticklabels, else return the major ticklabels which : None, ('minor', 'major', 'both') Overrides `minor`. Selects which ticklabels to return Returns ------- ret : list List of :class:`~matplotlib.text.Text` instances. zText yticklabel)r”r)rrˆrEr)r1r”rrrrÚget_yticklabels©sz_AxesBase.get_yticklabelscKs*|dk r| |¡|jj|fd|i|—ŽS)a$ Set the y-tick labels with list of strings labels. Parameters ---------- labels : List[str] list of string labels fontdict : dict, optional A dictionary controlling the appearance of the ticklabels. The default `fontdict` is:: {'fontsize': rcParams['axes.titlesize'], 'fontweight': rcParams['axes.titleweight'], 'verticalalignment': 'baseline', 'horizontalalignment': loc} minor : bool, optional Whether to set the minor ticklabels rather than the major ones. Returns ------- A list of `~.text.Text` instances. Other Parameters ---------------- **kwargs : `~.text.Text` properties. Nr”)rÂrEr)r1rrr”r>rrrÚset_yticklabelsÂs  z_AxesBase.set_yticklabelscCs|j |¡dS)zñ Sets up x-axis ticks and labels that treat the x data as dates. Parameters ---------- tz : string or :class:`tzinfo` instance, optional Timezone string or timezone. Defaults to rc value. N)rDÚ axis_date)r1ÚtzrrrÚ xaxis_dateäs z_AxesBase.xaxis_datecCs|j |¡dS)zñ Sets up y-axis ticks and labels that treat the y data as dates. Parameters ---------- tz : string or :class:`tzinfo` instance, optional Timezone string or timezone. Defaults to rc value. N)rEr%)r1r&rrrÚ yaxis_dateñs z_AxesBase.yaxis_datecCs8y | |¡Stk r2|j ¡j}||ƒ}|SXdS)z· Return *x* string formatted. This function will use the attribute self.fmt_xdata if it is callable, else will fall back on the xaxis major formatter N)r»r(rDÚget_major_formatterÚformat_data_short)r1r]rÚvalrrrÚ format_xdataüs   z_AxesBase.format_xdatacCs8y | |¡Stk r2|j ¡j}||ƒ}|SXdS)z¸ Return y string formatted. This function will use the :attr:`fmt_ydata` attribute if it is callable, else will fall back on the yaxis major formatter N)r¼r(rEr)r*)r1r^rr+rrrÚ format_ydata s   z_AxesBase.format_ydatacCs<|dkrd}n | |¡}|dkr&d}n | |¡}d||fS)z4Return a format string formatting the *x*, *y* coordNz???z x=%s y=%s)r,r-)r1r]r^rËrÌrrrÚ format_coords  z_AxesBase.format_coordcCs|xv|j|jfD]f}| ¡}|dkr@|j}| t |j|j¡¡q|dkrf|j}| t  |j |j¡¡q| t  ¡¡qWdS)zÀ Display minor ticks on the axes. Displaying minor ticks may reduce performance; you may turn them off using `minorticks_off()` if drawing speed is a problem. rnZsymlogN) rDrEr%r&r,r-Z LogLocatorÚbaseZsubsZSymmetricalLogLocatorZ _transformr.)r1r rÙr†rrrÚ minorticks_on"sz_AxesBase.minorticks_oncCs$|j t ¡¡|j t ¡¡dS)z!Remove minor ticks from the axes.N)rDr,r-Z NullLocatorrE)r1rrrÚminorticks_off5sz_AxesBase.minorticks_offcCsdS)zX Return *True* if this axes supports the zoom box button functionality. Tr)r1rrrÚcan_zoom<sz_AxesBase.can_zoomcCsdS)zX Return *True* if this axes supports any pan/zoom button functionality. Tr)r1rrrÚcan_panBsz_AxesBase.can_pancCs|jS)zF Get whether the axes responds to navigation commands )Ú _navigate)r1rrrÚ get_navigateHsz_AxesBase.get_navigatecCs ||_dS)z† Set whether the axes responds to navigation toolbar commands Parameters ---------- b : bool N)r4)r1ryrrrr¾Nsz_AxesBase.set_navigatecCs|jS)zR Get the navigation toolbar button status: 'PAN', 'ZOOM', or None )Ú_navigate_mode)r1rrrÚget_navigate_modeXsz_AxesBase.get_navigate_modecCs ||_dS)z Set the navigation toolbar button status; .. warning:: this is not a user-API function. N)r6)r1ryrrrr¿^sz_AxesBase.set_navigate_modecCs$| ¡\}}| ¡\}}||||fS)aî Save information required to reproduce the current view. Called before a view is changed, such as during a pan or zoom initiated by the user. You may return any information you deem necessary to describe the view. .. note:: Intended to be overridden by new projection types, but if not, the default implementation saves the view limits. You *must* implement :meth:`_set_view` if you implement this method. )r!r))r1rdrerfrgrrrÚ _get_viewhs  z_AxesBase._get_viewcCs,|\}}}}| ||f¡| ||f¡dS)am Apply a previously saved view. Called when restoring a view, such as with the navigation buttons. .. note:: Intended to be overridden by new projection types, but if not, the default implementation restores the view limits. You *must* implement :meth:`_get_view` if you implement this method. N)r"r*)r1ZviewrdrerfrgrrrÚ _set_viewzs z_AxesBase._set_viewÚinc&CsN| ¡\}}| ¡\}} t|ƒdkr |\} } } | dkrnndS|dkrr||||ƒ\}}|j | | ¡ |j¡} nÔ|dkrByž| |jj}| |jj}||||ƒ\}}|  ¡dkrÆd||}}t   d ||f¡} t   |j|jg¡} |j  |j¡} | | | | } t | ¡ |j¡} Wn$tk r>tjd d d dSXndSt  |  |j¡¡}|  ¡ t¡}d||<| |dd…df¡| |dd…df¡dS) a` Called when the mouse moves during a pan operation. *button* is the mouse button number: * 1: LEFT * 2: MIDDLE * 3: RIGHT *key* is a "shift" key *x*, *y* are the mouse coordinates in display coords. .. note:: Intended to be overridden by new projection types. cSs¾|dkr$t|ƒt|ƒkr|}q¶|}n’|dkr2d}n„|dkr@d}nv|dkr¶dt|ƒt|ƒkrbd}nTdt|ƒt|ƒkr|d}n:t|ƒt|ƒkr¢|t|ƒt|ƒ}n|t|ƒt|ƒ}||fS)NZcontrolr]rr^ÚshiftrV)rc)rÐÚdxÚdyrrrÚ format_deltasds"z)_AxesBase.drag_pan..format_deltasrNrrvrŽgà?g$@zOverflow while panningrV)ro)rHr]r^rÔZ translatedZ transformedrEr¤r¥rSr\ZpowerZarrayrCrDr¡r¢Ú OverflowErrorrrrsrÍr°ZastypeÚobjectr"r*)r1rIrÐr]r^rOrgrMrNÚresultrAÚstartZ oldpointsZ newpointsZvalidZpointsrrrÚdrag_panQs>       z_AxesBase.drag_pancCsÖg}| |j¡| |j¡| |j¡| |j¡| |j¡| |j ¡¡| |j ¡| |j ¡| |j ¡| |j ¡| |j ¡| |j¡| |j¡| |j¡|jdk rÆ| |j¡| |j¡|S)zreturn a list of child artistsN)rÓr?r7rür8r:r´rçr}rDrErCrDrEr9r;r<r>r)r1ZchildrenrrrrÝ›s&                z_AxesBase.get_childrencCs"t|jƒr| ||¡S|j |¡S)zj Test whether the mouse event occurred in the axes. Returns *True* / *False*, {} )ÚcallableZ _containsrr¸)r1r¹rrrr¸³s  z_AxesBase.containscCs|jj|ddS)z¥ Returns *True* if the point (tuple of x,y) is inside the axes (the area defined by the its patch). A pixel coordinate is required. gð?)Zradius)rÚcontains_point)r1ZpointrrrrV½sz_AxesBase.contains_pointcGstj ||d¡dS)zÌTrigger pick event Call signature:: pick(mouseevent) each child artist will fire a pick event if mouseevent is over the artist and the artist has picker set rN)rŸr Úpick)r1r=rrrrWÆs z_AxesBase.pickcCsb| ¡}|jr|js2x|j ¡D]}| |¡q W|jsTx| ¡D]}| |¡qBWdd„|DƒS)zÐ Return a default list of artists that are used for the bounding box calculation. Artists are excluded either by not being visible or ``artist.set_in_layout(False)``. cSs g|]}| ¡r| ¡r|‘qSr)rÖZ get_in_layout)rrÉrrrråsz<_AxesBase.get_default_bbox_extra_artists..)rÝrÕr·r´rçr–rß)r1r:rLrírrrÚget_default_bbox_extra_artistsÒs  z(_AxesBase.get_default_bbox_extra_artistsc Csfg}| ¡sdS| ¡}|r6|r6|||ƒ}| |¡n| ¡|j |¡}|rX| |¡| |¡| | |¡¡|j ¡rŽ| |j |¡¡|j  ¡rª| |j  |¡¡|j  ¡rÆ| |j  |¡¡|j  |¡}|rà| |¡|} | dkrô|  ¡} xV| D]N} |  |¡} | dk rú| j dks&| jdkrút | j ¡rút | j¡rú| | ¡qúWtj dd„|Dƒ¡} | S)a” Return the tight bounding box of the axes, including axis and their decorators (xlabel, title, etc). Artists that have ``artist.set_in_layout(False)`` are not included in the bbox. Parameters ---------- renderer : `.RendererBase` instance renderer that will be used to draw the figures (i.e. ``fig.canvas.get_renderer()``) bbox_extra_artists : list of `.Artist` or ``None`` List of artists to include in the tight bounding box. If ``None`` (default), then all artist children of the axes are included in the tight bounding box. call_axes_locator : boolean (default ``True``) If *call_axes_locator* is ``False``, it does not call the ``_axes_locator`` attribute, which is necessary to get the correct bounding box. ``call_axes_locator=False`` can be used if the caller is only interested in the relative size of the tightbbox compared to the axes bbox. Returns ------- bbox : `.BboxBase` bounding box in figure pixel coordinates. NrcSs$g|]}|jdks|jdkr|‘qS)r)r¤r¥)rryrrrr3sz+_AxesBase.get_tightbbox..)rÖrÿrrDrâr}rärÛrCrDrErErXr¤r¥r\rÍr¡r¢r±) r1rãZcall_axes_locatorZbbox_extra_artistsrÛrrZbb_xaxisZbb_yaxisZ bbox_artistsrrÔZ_bboxrrrrâèsD!            z_AxesBase.get_tightbboxcOsXd|krd|krtdƒ‚|jj| d¡f|ž|Ž}| d¡| d¡|j ||¡|S)zN Make a twinx axes of self. This is used for twinx and twiny. rÈrÉz%Twinned Axes may share only one axis.Tr_)r róZadd_axesrrWrÌr®)r1Zklr>Úax2rrrÚ_make_twin_axes7s  z_AxesBase._make_twin_axescCsb|j|d}|j ¡|j d¡|j d¡| | ¡¡|j ¡|j  d¡|j   d¡|S)a’ Create a twin Axes sharing the xaxis Create a new Axes instance with an invisible x-axis and an independent y-axis positioned opposite to the original one (i.e. at right). The x-axis autoscale setting will be inherited from the original Axes. To ensure that the tick marks of both y-axes align, see `~matplotlib.ticker.LinearLocator` Returns ------- ax_twin : Axes The newly created Axes instance Notes ----- For those who are 'picking' artists while using twinx, pick events are only called for the artists in the top-most axes. )rÈršF) rZrEZ tick_rightÚset_label_positionZset_offset_positionr¼r#Z tick_leftrDrKr)r1rYrrrr?Es       z_AxesBase.twinxcCsV|j|d}|j ¡|j d¡| | ¡¡|j ¡|j d¡|j  d¡|S)a Create a twin Axes sharing the yaxis Create a new Axes instance with an invisible y-axis and an independent x-axis positioned opposite to the original one (i.e. at top). The y-axis autoscale setting will be inherited from the original Axes. To ensure that the tick marks of both x-axes align, see `~matplotlib.ticker.LinearLocator` Returns ------- ax_twin : Axes The newly created Axes instance Notes ----- For those who are 'picking' artists while using twiny, pick events are only called for the artists in the top-most axes. )rÉr•F) rZrDZtick_topr[r½r+Z tick_bottomrErKr)r1rYrrrr@cs      z_AxesBase.twinycCs|jS)z@Return a reference to the shared axes Grouper object for x axes.)r­)r1rrrr sz_AxesBase.get_shared_x_axescCs|jS)z@Return a reference to the shared axes Grouper object for y axes.)r¯)r1rrrr…sz_AxesBase.get_shared_y_axes)NTNNrNN)rë)rë)F)r)r)Nrr)NNF)F)F)N)T)FF)F)TT)NNN)TrN)NTT)NF)Nržr)rN)r)NN)NNTF)F)F)FN)NF)NN)NNTF)F)F)FN)NF)N)N)r:NFF)TN)´rƒr„r…r†rHrZGrouperr­r¯rÌÚpropertyrˆÚsetterrr2r3r7rÛrµr±rårïr÷rørùrúrûrÝrrrr r²rÿrrr³rºZ deprecatedrPrQrRZget_fcrHZset_fcrFr0rSr\r]rWr`rXrjrmrrr‡r‰rŠr‹rrrr‘r’r“r”r•r˜r™rœrržr r¡rŸrªr©r­r®r‘r¯r›r²r·rºr»r#r+rƒr¼r½r¾rÁrÂrÃrÅrÆrÈr„rßrärrêrîrïrðrñròrôr¸r Zdedent_interpdrërûrürÄr‚rIrþrÿrarvr!rr"rprÀrrrrrrrrrbrur)r*rqrÁrr r!r"r#r$r'r(r,r-r.r0r1r2r3r5r¾r7r¿r8r9rBrJrKrTrÝr¸rVrWrXrârZr?r@r rÚ __classcell__rr)rÒrr‡Œs|  }   '           J G - 8   ,      P  - j.M   #*Y ) c    ( "     $  (  ! "         #  J  N    r‡)Kr?rr8ZloggingrkZnumbersrÚoperatorrrFrrZnumpyr\rñrrZmatplotlib.cbookrrr r r r r Zmatplotlib.colorsZcolorsrZmatplotlib.linesrür$Zmatplotlib.patchesr7rrZmatplotlib.artistrÉrŸZmatplotlib.transformsZ transformsr¡Zmatplotlib.tickerZtickerr-Zmatplotlib.axisrrÜZmatplotlib.scalerÙr$Zmatplotlib.spinesr´rZmatplotlib.font_managerrAZmatplotlib.textrrBZmatplotlib.imager~rëZmatplotlib.offsetboxrrZmatplotlib.legendrZmatplotlib.rcsetuprrZ getLoggerrƒràr+rQr,r r‡rrrrÚsD                     \