o h|@sddlmZmZddlmZddlZddlZddlZddlm Z ddl m Z ddl Z ddl Z ddlZddlZddlmZmZmZmZddlmZddlmZddlmZmZmZddl m!Z"ddl#m$Z%ddl&m'Z'ddl(m)Z)ddl*m+Z,ddl-m.Z/ddl0m1Z2dd l3m4Z4m5Z5ddl6m7Z8ddl9m:Z;ddlddl?m@ZAddlBmCZDeEeFZGGd d d ZHGd d d ZIddddZJGdddZKeLddgiGdddejMZNddZOdS))IterableSequence) ExitStackN)Real) attrgetter)_apicbook _docstring offsetbox) _OrderedSet _check_1dindex_of) SubplotSpec)cyclervalidate_axisbelowc@s&eZdZdZddddZddZdS)_axis_method_wrappera6 Helper to generate Axes methods wrapping Axis methods. After :: get_foo = _axis_method_wrapper("xaxis", "get_bar") (in the body of a class) ``get_foo`` is a method that forwards it arguments to the ``get_bar`` method of the ``xaxis`` attribute, and gets its signature and docstring from ``Axis.get_bar``. The docstring of ``get_foo`` is built by replacing "this Axis" by "the {attr_name}" (i.e., "the xaxis", "the yaxis") in the wrapped method's dedented docstring; additional replacements can be given in *doc_sub*. Ndoc_subcCs|||_||_tttj|}g|_|r9dd|ji|pi}|D]\}}||vr2|j || ||}q$||_ dS)Nz this Axiszthe ) attr_name method_nameinspectgetdocgetattrmaxisAxis _missing_subsitemsappendreplace__doc__)selfrrrdockvr$i/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/matplotlib/axes/_base.py__init__4s  z_axis_method_wrapper.__init__c st|jd|jfdd}|j|_||_|jd||_|j|_tt t j |j|_ |j rEtd|j|jdtt|j t|||dS)N.cs||i|SNr$)r argskwargs get_methodr$r%wrapperIsz2_axis_method_wrapper.__set_name__..wrapperzWThe definition of {} expected that the docstring of Axis.{} contains {!r} as substrings, )rrr __module____name__ __qualname__rr signaturerrr __signature__r ValueErrorformatjoinmapreprsetattr)r ownernamer-r$r+r% __set_name__Cs$  z!_axis_method_wrapper.__set_name__)r0r/r1rr&r<r$r$r$r%r#s rc@s eZdZdZddZddZdS)_TransformedBoundsLocatorz Axes locator for `.Axes.inset_axes` and similarly positioned Axes. The locator is a callable object used in `.Axes.set_aspect` to compute the Axes location depending on the renderer. cCs||_||_dS)z *bounds* (a ``[l, b, w, h]`` rectangle) and *transform* together specify the position of the inset Axes. N)_bounds _transform)r bounds transformr$r$r%r&hs z"_TransformedBoundsLocator.__init__cCs&ttjj|j|j|jddjS)NFroot) mtransformsTransformedBboxBbox from_boundsr>r? get_figuretransSubfigure)r axrendererr$r$r%__call__ps z"_TransformedBoundsLocator.__call__N)r0r/r1rr&rLr$r$r$r%r=`s r=Fambiguous_fmt_datakeyc Csd}d}d}|dvrz t|}|||fWStyYnw|r#dnd}d}|t|kr||}|||dtjvrU|durHt||d|||d}|d7}n||tjvrm|durft||d|}|d7}nd|tjvr|dur~t||d |}|d7}nL|tvr|durt||d |}|d7}n3|d krt d ||d}|st||d t|d}|t|d7}n t||d||t|ks-|dur|durt j d}|durd}|durd}|||fS)av Convert a MATLAB style color/line style format string to a (*linestyle*, *marker*, *color*) tuple. Example format strings include: * 'ko': black circles * '.b': blue dots * 'r--': red dashed lines * 'C2--': the third color in the color cycle, dashed lines The format is absolute in the sense that if a linestyle or marker is not defined in *fmt*, there is no line or marker. This is expressed by returning 'None' for the respective quantity. See Also -------- matplotlib.Line2D.lineStyles, matplotlib.colors.cnames All possible styles and color format strings. N)01z9{!r} is neither a data key nor a valid format string ({})z&{!r} is not a valid format string ({})rztwo linestyle symbolsztwo marker symbolsztwo color symbolsCzC\d+z 'C' must be followed by a numberzunrecognized character zlines.linestyleNone) mcolorsto_rgbar4lenmlines lineStylesr5 lineMarkersget_named_colors_mappingrematchmplrcParams) fmtrN linestylemarkercolorerrfmticcn_colorr$r$r%_process_plot_formatysh              rhc@sxeZdZdZdddZddZddd d d Zd d ZefddZ ddZ ddZ ddZ ddZ dddddZdS)_process_plot_var_argsa Process variable length arguments to `~.Axes.plot`, to support :: 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 Line2DcCs&tjgd|d||_|ddS)NrjPolygon coordinatesoutput)r check_in_listroset_prop_cycle)r ror$r$r%r&sz_process_plot_var_args.__init__cCs&|dur tjd}d|_g||_dS)Nzaxes.prop_cycler)r^r__idx _cycler_items)r rr$r$r%rqs z%_process_plot_var_args.set_prop_cycleNF)data return_kwargsc /s|j|ddD]}||vrttdj|q |sdSdur+dd|D}nhfdd|D}t|dkr=d}nAt|dkrqzt|dWn tyVd}Yn(w|d|durnt d |dd t d}nd}n t|d krzd}ntd | d durt |||||d <|}duot|dk} t|dkrt| d std|r|dd|dd} }|rt|dtr| |df7} |dd}|j|| || |dEdH|sdSdS)N)r*xyrRcSsg|]}t|qSr$)rsanitize_sequence.0ar$r$r% z3_process_plot_var_args.__call__..csg|]}t|qSr$)r^ _replacer)ryargrtr$r%r{rrQzSecond argument a" is ambiguous: could be a format string but is in 'data'; using as data. If it was intended as data, set the format string to an empty string to suppress this warning. If it was intended as a format string, explicitly pass the x-values as well. Alternatively, rename the entry in 'data'.zwUsing arbitrary long args with data is not supported due to ambiguity of arguments; use multiple plotting calls insteadlabelz]plot() with multiple groups of data (i.e., pairs of x and y) does not support multiple labels)rNru)_process_unit_infor kwarg_errorrstackfunctionrWrhr4 warn_externalRuntimeWarninggetr^_label_from_argris_scalar_or_string isinstancestr _plot_args) r axesrtrur)r*pos_onlyreplacedlabel_namer_idxrNthisr$rr%rLsf          z_process_plot_var_args.__call__cCs6|j|j}d|vr|jdt|j|_|dSdS)z#Return the next color in the cycle.rcrRr")rsrrrW)r entryr$r$r%get_next_color.s z%_process_plot_var_args.get_next_colorcsZ|j|j}tfddh|Dr+|jdt|j|_fdd|DSiS)a8 If some keys in the property cycle (excluding those in the set *ignore*) are absent or set to None in the dict *kw*, return a copy of the next entry in the property cycle, excluding keys in *ignore*. Otherwise, don't advance the property cycle, and return an empty dict. c3s |] }|dduVqdSr(rryr")kwr$r% ?sz6_process_plot_var_args._getdefaults..rRcsi|] \}}|vr||qSr$r$ryr"r#)ignorer$r% Bsz7_process_plot_var_args._getdefaults..)rsrranyrWr)r rrdefaultsr$)rrr% _getdefaults7s z#_process_plot_var_args._getdefaultscCs*|D]}||ddur||||<qdS)zx Add to the dict *kw* the entries in the dict *default* that are absent or set to None in *kw*. Nr)r rrr"r$r$r% _setdefaultsFs  z#_process_plot_var_args._setdefaultscCs:i||}||||tj||fi|}||fSr()rrrXrj)r rxyrr*segr$r$r% _make_lineOs z!_process_plot_var_args._make_linecCs*i||}||||||f|fSr()rr)r rrrrr*r$r$r%_make_coordinatesUs  z(_process_plot_var_args._make_coordinatesc Cs||}||}|}|}hddd|DB}|||}||||dd}|dd|||tj t ||f||dd|dd} | j d i|| |fS) N>rb markersizemarkeredgecolormarkeredgewidthmarkerfacecolorcSsh|] \}}|dur|qSr(r$rr$r$r% msz7_process_plot_var_args._make_polygon..rcfillTclosed) facecolorrrr$) convert_xunitsconvert_yunitscopyrrrrpopmpatchesrlnp column_stackset) r rrrrr*ignores default_dictrrr$r$r% _make_polygonZs&        z$_process_plot_var_args._make_polygon)rurNc sbt|dkrt|dtr|^}}t||d\}} } nt|dkr&td|}d\}} } tdd|Dr:td itd || | fD].\} } | d urr|d krn| vrn| d krnt | d| d|d| d| d | | <qDt|dkrt |dt |dnt |d\j d urj jd urj jdjdkrtdjdjjdksĈjdkrtdjdjjdkrވd d tjfjdkrd d tjf|jdkr|jn&|jdkrddd<|jn|jdkr|jn tjgd|jdjdjddkr@dkr@kr@tdd d!dksJdkrLgSd"} t}t| rb| g|}n/t| |krl| }n%|dkrd#t| d$}tjd%|d&| g}n td't| d(|d)fd*dt|D}|rt|Sd+d,|DS)-a Process the arguments of ``plot([x], y, [fmt], **kwargs)`` calls. This processes a single set of ([x], y, [fmt]) parameters; i.e. for ``plot(x, y, x2, y2)`` it will be called twice. Once for (x, y) and once for (x2, y2). x and y may be 2D and thus can still represent multiple datasets. For multiple datasets, if the keyword argument *label* is a list, this will unpack the list and assign the individual labels to the datasets. Parameters ---------- tup : tuple A tuple of the positional parameters. This can be one of - (y,) - (x, y) - (y, fmt) - (x, y, fmt) kwargs : dict The keyword arguments passed to ``plot()``. return_kwargs : bool Whether to also return the effective keyword arguments after label unpacking as well. ambiguous_fmt_datakey : bool Whether the format string in *tup* could also have been a misspelled data key. Returns ------- result If *return_kwargs* is false, a list of Artists representing the dataset(s). If *return_kwargs* is true, a list of (Artist, effective_kwargs) representing the dataset(s). See *return_kwargs*. The Artist is either `.Line2D` (if called from ``plot()``) or `.Polygon` otherwise. rRrMrz!third arg must be a format string)NNNcss|]}|duVqdSr(r$)ryr#r$r$r%rz4_process_plot_var_args._plot_args..z(x, y, and format string must not be None)rarbrcNnonerTz is redundantly defined by the 'z'' keyword argument and the fmt string "z" (-> =z-). The keyword argument will take precedence.rQrz8x and y must have same first dimension, but have shapes z and z3x and y can be no greater than 2D, but have shapes rjrlrTrmrkrnzx has z columns but y has z columnsrzPassing label as a length z sequence when plotting a single dataset is deprecated in Matplotlib 3.9 and will error in 3.11. To keep the current behavior, cast the sequence to string before passing.z3.9)messagezJlabel must be scalar or have the same length as the input data, but found z for z datasets.c 3sP|]#\}}dd|fdd|fid|iVqdS)Nrr$)ryjrrrr* make_artistncxncyrrr$r%rs * cSsg|]}|dqSrr$)rylr$r$r%r{"z5_process_plot_var_args._plot_args..)rWrrrhr4rziplowerrrr r xaxis update_unitsyaxisshapendimrnewaxisrorrrrrpmaxrrwarn_deprecated enumeratelist)r rtupr*rurNrvr`rarbrc prop_namevalr n_datasetslabelsmsgresultr$rr%rs-                      z!_process_plot_var_args._plot_args)rj)r0r/r1rr&rqrLr frozensetrrrrrrr$r$r$r%ris K  3rirfcc s eZdZUdZdZddeDZeZdZ e j e d< e je d< e je d< ed d Zd d Zd dd d dd d d dd fdd ZfddZfddZddZddZddZddZd d!Zdud"d#Zd$d%Zfd&d'Zd(d)Zed*d+Zdvd-d.Z d/d0Z!dwd2d3Z"d4d5Z#d6d7Z$dwd8d9Z%d:d;Z&dd?Z(dxd@dAZ)dydCdDZ*dydEdFZ+dGdHZ,dIdJZ-dKdLZ.dMdNZ/dOdPZ0dzdSdTZ1dUdVZ2dWdXZ3dYdZZ4d[d\Z5d]d^Z6Gd_d`d`e7Z8edadbZ9edcddZ:ededfZ;edgdhZedmdnZ?dodpZ@dqdrZAdsdtZBdudvZCdwdxZDd{dydzZEd{d|ZFdxd}d~ZGddZHduddZIddZJdxddZKddZLduddZMduddddZNddZOddZPddZQddZRddZSeTddZUeTddZVeTddZWeTddZXddZYddZZddZ[ddZ\ddZ]d|ddZ^ddZ_ddZ`ddZaddZbddZcddZdddZeddZfddZgduddZhdxddZid}ddZjd~ddddZkdd„ZleTddÃZmeTddÃZneTddăZoeTddăZpddƄZqddȄZreddʄZsesjtddʄZsdd̈́ZuddτZvddфZwddӄZxd d ddԜddքZydd؄ZzddڄZ{ddd܄Z|dddބZ}ddZ~ejddZddZddZddZddZddZddZejdddZdBd d d d d dddZdddZdyddZddZddZddZd~d dddZddZeTddZddZd~ddZd d Zd d Zd~ddd d d ddZeTddZeTddZeTddZeTddddidZeTddZeTddZeTddZeTddddidZddZd~d dddZd d!ZeTddZd"d#Zd~d$d%Zd&d'Zd~ddd d d(d)d*ZeTddZeTddZeTddZeTdddd+idZeTddZeTddZeTddZeTdddd,idZeTdd-ZeTdd-Zd.d/Zd0d1Zd2d3Zd4d5Zd6d7Zd8d9Zd:d;Zd<d=Zd>d?Zd@dAZdBdCZdDdEZdFdGZ H ddIdJZ H ddKdLZdMdNZdOdPZÐdQdRZĐdSdTZŐdUdVZƐdWdXZǐdYdZZȐd[d\Zɐdudd dd]d^d_Zʐd`daZːdbdcZ̐dddeZ͐dfdgZΐdhdiZϐdxdjdkZddldmdnZddldodpZҐdqdrZӐdsdtZԇZS( _AxesBase rectilinearrrcCsi|]}|tqSr$)rGrouperryr;r$r$r%r1r|z_AxesBase.FdataLimrrcsfddjDS)z7A mapping of axis names, e.g. 'x', to `Axis` instances.csi|] }|t|dqSaxis)rrr r$r%rZsz'_AxesBase._axis_map..) _axis_namesrr$rr% _axis_mapWs z_AxesBase._axis_mapcCsdt|j|jjS)Nz({0}({1[0]:g},{1[1]:g};{1[2]:g}x{1[3]:g}))r5typer0 _positionr@rr$r$r%__str__]sz_AxesBase.__str__NTauto) rframeonsharexshareyrxscaleyscale box_aspectforward_navigation_eventsc  sRtd| vr!| rtd| d} tjtjtf| d| f} d}t | dkr9t | dtjr9| d |_ n&t | dkrPt | drPtjj| d|_ ntj|_ |_t|| }|j jdksk|j jdkrotd|j |_||_d|_d |_d |_t|jd |_| |_||_ ||_!|"||#||r|$|nd|_%|&| d|_'g|_(g|_)t*j+,|-|_.|/|durt0j1d }||_2||_3|4t0j1d d|_5|6d|_7d|_8|9d|:d|r|;||r|<||=| |j>?D]\}}|j@Ad|B|qt0j1}|jC|do%|d|do-|d|do5|d|do=|d|doE|d|doM|d|doU|d|do]|ddd |jC|dok|d|dos|d|do{|d|do|d|do|d |do|d!|do|d |do|d!d"d dS)#a* Build an Axes in a figure. Parameters ---------- fig : `~matplotlib.figure.Figure` The Axes is built in the `.Figure` *fig*. *args ``*args`` can be a single ``(left, bottom, width, height)`` rectangle or a single `.Bbox`. This specifies the rectangle (in figure coordinates) where the Axes is positioned. ``*args`` can also consist of three numbers or a single three-digit number; in the latter case, the digits are considered as independent numbers. The numbers are interpreted as ``(nrows, ncols, index)``: ``(nrows, ncols)`` specifies the size of an array of subplots, and ``index`` is the 1-based index of the subplot being created. Finally, ``*args`` can also directly be a `.SubplotSpec` instance. sharex, sharey : `~matplotlib.axes.Axes`, optional The x- or y-`~.matplotlib.axis` is shared with the x- or y-axis in the input `~.axes.Axes`. Note that it is not possible to unshare axes. frameon : bool, default: True Whether the Axes frame is visible. box_aspect : float, optional Set a fixed aspect for the Axes box, i.e. the ratio of height to width. See `~.axes.Axes.set_box_aspect` for details. forward_navigation_events : bool or "auto", default: "auto" Control whether pan/zoom events are passed through to Axes below this one. "auto" is *True* for axes with an invisible patch and *False* otherwise. **kwargs Other optional keyword arguments: %(Axes:kwdoc)s Returns ------- `~.axes.Axes` The new `~.axes.Axes` object. rectz8'rect' cannot be used together with positional arguments)rNrRrz/Width and height specified must be non-negativerboxrSFzaxes.facecolorzaxes.axisbelowTunitsz xtick.topzxtick.minor.topz xtick.bottomzxtick.minor.bottomzxtick.labeltopzxtick.labelbottomz ytick.leftzytick.minor.leftz ytick.rightzytick.minor.rightzytick.labelleftzytick.labelrightminor) topbottomlabeltop labelbottomleftright labelleft labelrightwhichzxtick.major.topzxtick.major.bottomzytick.major.leftzytick.major.rightmajor)Dsuperr& TypeErrorrrcheck_isinstancerDrFrrWrfrozenrriterablerGunit_originalPositionr_from_subplot_argswidthheightr4r_aspect _adjustable_anchordictfromkeysr_stale_viewlims_forward_navigation_events_sharex_sharey set_label set_figureset_subplotspec _subplotspecset_box_aspect _axes_locator _children _colorbarsmspinesSpines from_dict_gen_axes_spinesspines _init_axisr^r_ _facecolor_frameon set_axisbelow_rasterization_zorderclear fmt_xdata fmt_ydata set_navigateset_navigate_mode set_xscale set_yscale_internal_updaterr callbacks_connect_picklable_unit_change_handler tick_params)r figrrrrrrrrrr)r*r subplotspecr;rr_ __class__r$r%r&as >                       z_AxesBase.__init__c s^t||j}d|jvrtjddd|jd|jddd|jvp"||_tjdi|dS) Nclaz3.6TzOverriding `Axes.cla` in z is pending deprecation in %(since)s and will be fully deprecated in favor of `Axes.clear` in the future. Please report this to the z author.)pendingrr$)r_subclass_uses_cla__dict__rrr1r/__init_subclass__)clsr*parent_uses_clar4r$r%r: s   z_AxesBase.__init_subclass__csDt}fddjD|d<jvrjnd|d<|S)Ncs,i|]}j|vr|j|qSr$ _shared_axes get_siblingsrrr$r%rsz*_AxesBase.__getstate__..r> _twinned_axes)r __getstate__rr@r?)r stater4rr%rAs    z_AxesBase.__getstate__cCsV|d}|D] \}}|j|j|q |d}|r#|jj|||_d|_dS)Nr>r@T)rrr>r6r@r9_stale)r rB shared_axesr;shared_siblingstwinned_siblingsr$r$r% __setstate__!s    z_AxesBase.__setstate__cCsg}|r|d|g7}t|dr2i}dD]}|j|d}|r'|||<q|r2|d|g7}|jD]\}}|jrP|jrP||d|jg7}q7d|jjdd |d S) Nzlabel= get_titlercenterrlocztitle=) get_labelhasattrrHrrrget_textr5r0r6)r fieldstitlesr"titler;rr$r$r%__repr__,s"  z_AxesBase.__repr__cC|jS)z?Return the `.SubplotSpec` associated with the subplot, or None.)rrr$r$r%get_subplotspec=z_AxesBase.get_subplotspeccCs"||_|||jdddS)z4Set the `.SubplotSpec`. associated with the subplot.FrBN)r _set_position get_positionrH)r r3r$r$r%rAsz_AxesBase.set_subplotspeccCs|jr|jSdS)z..)rr>r?)ryrrir%rts z._AxesBase._unstale_viewLim..FcSsi|] \}}d||qS)scaler$)ryr;rkr$r$r%r|sr$)rrvaluesr>r?rautoscale_viewr)r need_scaler;rJr$rr%_unstale_viewLimqs   z_AxesBase._unstale_viewLimcCs||jS)z/The view limits as `.Bbox` in data coordinates.)rorcrr$r$r%viewLimsz_AxesBase.viewLimallcCsRtjidd|jDd|ji|d}|D]}d|j|<q|dur'||_dSdS)a Mark a single axis, or all of them, as stale wrt. autoscaling. No computation is performed until the next autoscaling; thus, separate calls to control individual axises incur negligible performance cost. Parameters ---------- axis : str, default: "all" Either an element of ``self._axis_names``, or "all". tight : bool or None, default: None cSsi|]}||gqSr$r$rr$r$r%rrz5_AxesBase._request_autoscale_view..rqrTN)r check_getitemrr_tight)r rtight axis_namesr;r$r$r%_request_autoscale_views   z!_AxesBase._request_autoscale_viewcCsrt|j|_tt|_tt|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 `~matplotlib.axes.Axes` class, and is meant to be overridden by new kinds of projection Axes that need different transformations and limits. (See `~matplotlib.projections.polar.PolarAxes` for an example.) N)rDBboxTransformTor\ transAxesrdrerfBboxTransformFromrErc transLimits transDatablended_transform_factory_xaxis_transform_yaxis_transformrr$r$r%rgs  z!_AxesBase._set_lim_and_transformsgridcCD|dkr|jS|dkr|jjS|dkr|jjStd|)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 `~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. Parameters ---------- which : {'grid', 'tick1', 'tick2'} rtick1tick2unknown value for which: )r}r rget_spine_transformrr4r rr$r$r%get_xaxis_transform  z_AxesBase.get_xaxis_transformcCs<tjd}|jddtdd|d|jddjd |fS) a Returns ------- transform : Transform The transform used for drawing x-axis labels, which will add *pad_points* of padding (in points) between the axis and the label. The x-direction is in data coordinates and the y-direction is in axis coordinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~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. xtick.alignmentrrrrHFrBrr^r_rrDScaledTranslationrHdpi_scale_transr pad_points labels_alignr$r$r%get_xaxis_text1_transform    z#_AxesBase.get_xaxis_text1_transformcCs8tjd}|jddtd|d|jddjd|fS) a Returns ------- transform : Transform The transform used for drawing secondary x-axis labels, which will add *pad_points* of padding (in points) between the axis and the label. The x-direction is in data coordinates and the y-direction is in axis coordinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~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. rrrrrFrBrrrr$r$r%get_xaxis_text2_transform   z#_AxesBase.get_xaxis_text2_transformcCr)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 `~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. Parameters ---------- which : {'grid', 'tick1', 'tick2'} rrrr)r~r rrrr4rr$r$r%get_yaxis_transformrz_AxesBase.get_yaxis_transformcCs<tjd}|jddtd|dd|jddj|d fS) a Returns ------- transform : Transform The transform used for drawing y-axis labels, which will add *pad_points* of padding (in points) between the axis and the label. The x-direction is in axis coordinates and the y-direction is in data coordinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~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. ytick.alignmentrrrrrFrBrr^r_rrDrrHrrr$r$r%get_yaxis_text1_transform,rz#_AxesBase.get_yaxis_text1_transformcCs8tjd}|jddt|dd|jddj|dfS) a Returns ------- transform : Transform The transform used for drawing secondart y-axis labels, which will add *pad_points* of padding (in points) between the axis and the label. The x-direction is in axis coordinates and the y-direction is in data coordinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~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. rrrrrFrBrrrr$r$r%get_yaxis_text2_transformGrz#_AxesBase.get_yaxis_text2_transformcCs$|jt|j|jdSr()rfrrDr|r get_transformrrr$r$r%_update_transScalebs z_AxesBase._update_transScalecCs,|r|jS|}|s||jS)aq Return the position of the Axes within the figure 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 ------- `.Bbox` )rrget_axes_locator apply_aspectr)r originallocatorr$r$r%rZgs   z_AxesBase.get_positionbothcCs|j||d|ddS)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 `.Axes.set_aspect` for details. Parameters ---------- pos : [left, bottom, width, height] or `~matplotlib.transforms.Bbox` The new position of the Axes in `.Figure` coordinates. which : {'both', 'active', 'original'}, default: 'both' Determines which position variables to change. See Also -------- matplotlib.transforms.Bbox.from_bounds matplotlib.transforms.Bbox.from_extents rFN)rY set_in_layout)r posrr$r$r% set_positionsz_AxesBase.set_positioncCs\t|tjs tjj|}|j|D]}|dvr|j||dvr(|j |qd|_ dS)z Private version of set_position. Call this internally to get the same functionality of `set_position`, but not to take the axis out of the constrained_layout hierarchy. )ractive)rrTN) rrDBboxBaserFrGr@r?rrrstale)r rrrJr$r$r%rYs     z_AxesBase._set_positioncCs0|j|D]}|jdd}|j|ddqdS)z Reset the active position to the original position. This undoes changes to the active position (as defined in `.set_position`) which may have been performed to satisfy fixed-aspect constraints. TrrrN)r@r?rZr)r rJrr$r$r%reset_positions z_AxesBase.reset_positioncC||_d|_dS)z Set the Axes locator. Parameters ---------- locator : Callable[[Axes, Renderer], Bbox] TN)rr)r rr$r$r%set_axes_locator z_AxesBase.set_axes_locatorcCrV)z* Return the axes_locator. )rrr$r$r%rz_AxesBase.get_axes_locatorcCsH||jdd|s||j||_|r"|j|dSdS)z4Set the boilerplate props for artists added to Axes.FrBN) rrHis_transform_set set_transformr{r get_mouseover_mouseover_setaddr rzr$r$r%_set_artist_propss z_AxesBase._set_artist_propscCstdddS)a Returns ------- Patch 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. Notes ----- Intended to be overridden by new projection types. )r?)r Rectanglerr$r$r%_gen_axes_patchsz_AxesBase._gen_axes_patchrinchescsfdddDS)a} Returns ------- dict Mapping of spine names to `.Line2D` or `.Patch` instances that are used to draw Axes spines. In the standard Axes, spines are single line segments, but in other projections they may not be. Notes ----- Intended to be overridden by new projection types. csi|] }|tj|qSr$)rSpine linear_spine)rysiderr$r%rsz._AxesBase._gen_axes_spines..)rrrrr$)r locationsoffsetrr$rr%rs z_AxesBase._gen_axes_spinescCtjt|d|jdur||jurtd|jd||||_|jj|j_|jj |j_ | \}}|j ||d| d|jj |j_ dS)a Share the x-axis with *other*. This is equivalent to passing ``sharex=other`` when constructing the Axes, and cannot be used if the x-axis is already being shared with another Axes. Note that it is not possible to unshare axes. otherNzx-axis is already sharedrFemitr)rrrrr4r>r6rrrget_xlimset_xlimget_autoscalex_on_scale)r rx0x1r$r$r%r   z_AxesBase.sharexcCr)a Share the y-axis with *other*. This is equivalent to passing ``sharey=other`` when constructing the Axes, and cannot be used if the y-axis is already being shared with another Axes. Note that it is not possible to unshare axes. rNzy-axis is already sharedrFr)rrrrr4r>r6rrrget_ylimset_ylimget_autoscaley_onr)r ry0y1r$r$r%rrz_AxesBase.shareycCsnt|dr |j}nd}|j}|j}|jD]}|q|jD]}| q(d|_ t j gdd|_ tjdrH|jttjdrU|jttjd|_tjd|_d |_d|_t|_td |_tjd |_|jg}|_|D] }d |_d |_d |_q|t|_ g|_!d |_"d |_#d |_$g|_%|&d |j&|jtjd tjddt'j(tjdtjdd}tjd} | d urd} d|_)nd |_)t*j+d| d|ddd|_,t*j+d| d|-ddd|_.t*j+d| d|-ddd|_/tjd} |0| |j,|j.|j/fD]} |1| q|2|_|j3|j4d d|j5|j6|j7d|j8d |j9|j:|;|j<|j|j<|j|j=d ure|j>||j>||j?d urw|j>||j>||j@D]1\} }tA|d!| } | d urtA|d"| | q||jBd#kr|Cd$|jDd d%dd&q||Ed|_Fd S)'Clear the Axes.patchT) xlim_changed ylim_changed zlim_changed)signalszxtick.minor.visiblezytick.minor.visiblez axes.xmarginz axes.ymarginNrlz axes.gridFzaxes.grid.whichzaxes.grid.axis)rrzaxes.titlesizezaxes.titleweight)sizeweightz axes.titleyr?rbaselinerJ)rrtextfontpropertiesverticalalignmenthorizontalalignmentrrrz axes.titlepadrBrr_sharesharepolarlinearrRr)GrPr get_visiblerrrrlr&r _clearignore_existing_data_limitsrCallbackRegistryr.r^r_set_minor_locatormtickerAutoMinorLocator_xmargin_ymarginrs_use_sticky_edgesri _get_lines_get_patches_for_fill_gridOnr_remove_method_parent_figurerr r child_axes_current_image_projection_initlegend_ containersr font_managerFontProperties _autotitleposmtextTextrTr _left_title _right_title_set_title_offset_transrrrrH set_facecolorr" set_edgecolor set_linewidthrrx set_axis_on set_clip_pathr set_visiblerrrr; _set_scale_set_limrr)r patch_visible xaxis_visible yaxis_visiblerspine old_childrenchldpropsrtitle_offset_points_titler;rr$r$r%__clears                             z_AxesBase.__clearcC|jr |dS|dSrN)r8r6_AxesBase__clearrr$r$r%r&  z_AxesBase.clearcCrr)r8rr&rr$r$r%r6rz _AxesBase.clac@sLeZdZdZ dddZddZddZd d Zd d Zd dZ ddZ dS)z_AxesBase.ArtistLista A sublist of Axes children based on their type. The type-specific children sublists were made immutable in Matplotlib 3.7. In the future these artist lists may be replaced by tuples. Use as if this is a tuple already. Ncs ||_||_fdd|_dS)a! Parameters ---------- axes : `~matplotlib.axes.Axes` The Axes from which this sublist will pull the children Artists. prop_name : str The property name used to access this sublist from the Axes; used to generate deprecation warnings. valid_types : list of type, optional A list of types that determine which children will be returned by this sublist. If specified, then the Artists in the sublist must be instances of any of these types. If unspecified, then any type of Artist is valid (unless limited by *invalid_types*.) invalid_types : tuple, optional A list of types that determine which children will *not* be returned by this sublist. If specified, then Artists in the sublist will never be an instance of these types. Otherwise, no types will be excluded. cs" st|o pt| Sr()r)artist invalid_types valid_typesr$r%sz/_AxesBase.ArtistList.__init__..N)_axes _prop_name _type_check)r rrrrr$rr%r&sz_AxesBase.ArtistList.__init__cCsdt|d|jdS)Nz.)sumrrrr$rr%__len__s z_AxesBase.ArtistList.__len__ccs(t|jjD] }||r|VqdSr()rrrr)r rr$r$r%__iter__s  z_AxesBase.ArtistList.__iter__csfddjjD|S)Ncsg|] }|r|qSr$rrrr$r%r{s z4_AxesBase.ArtistList.__getitem__..)rr)r keyr$rr% __getitem__s z _AxesBase.ArtistList.__getitem__cCs>t|ttjfrg||St|ttjfrg||RStSr()rrr ArtistListtupleNotImplementedr rr$r$r%__add__s  z_AxesBase.ArtistList.__add__cCs0t|tr |t|St|tr|t|StSr()rrr%r&r'r$r$r%__radd__s    z_AxesBase.ArtistList.__radd__NN) r0r/r1rr&rUr r!r#r(r)r$r$r$r%r$s  r$c Cs(|j|dtjtjtjtjt j t j fdS)Nartists)r) r$mcoll Collectionmimage AxesImagerXrjrPatchmtableTablerrrr$r$r%r+sz_AxesBase.artistscC|j|dtjdS)N collectionsr)r$r,r-rr$r$r%r4sz_AxesBase.collectionscCr3)Nimagesr5)r$r.r/rr$r$r%r6z_AxesBase.imagescCr3)Nlinesr5)r$rXrjrr$r$r%r8r7z_AxesBase.linescCr3)Npatchesr5)r$rr0rr$r$r%r9 r7z_AxesBase.patchescCr3)Ntablesr5)r$r1r2rr$r$r%r: r7z_AxesBase.tablescCr3)Ntextsr5)r$rrrr$r$r%r;r7z_AxesBase.textscCs |jS)zGet the facecolor of the Axes.)r get_facecolorrr$r$r%r<s z_AxesBase.get_facecolorcCs||_d|_|j|S)zx Set the facecolor of the Axes. Parameters ---------- color : :mpltype:`color` T)r"rrr)r rcr$r$r%rs z_AxesBase.set_facecolorcCsTtd|d|jddj|_|j|j|jfD]}||j |j| dqdS)zw Set the offset for the title either from :rc:`axes.titlepad` or from set_title kwarg ``pad``. rrFrBN) rDrrHrtitleOffsetTransrTrrrrx set_clip_box)r r rr$r$r%r%s  z!_AxesBase._set_title_offset_transcOsX|r|rtdt|dkr|ddurd}nt|i|}|j||j|dS)a 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.Cycler` Set the given Cycler. *None* resets to the cycle defined by the current style. .. ACCEPTS: `~cycler.Cycler` 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. See Also -------- matplotlib.rcsetup.cycler Convenience function for creating validated cyclers for properties. cycler.cycler The original function for creating unvalidated cyclers. 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']) zCCannot supply both positional and keyword arguments to this method.rRrN)rrWrrrqr)r r)r* prop_cycler$r$r%rq1sA z_AxesBase.set_prop_cyclecCrV)z Return the aspect ratio of the Axes scaling. This is either "auto" or a float giving the ratio of y/x-scale. )r rr$r$r% get_aspect}sz_AxesBase.get_aspectcst|drd}t|dst|}|dkst|std|r,fddjD}ng}|D]}||_q1|dur>j}j ||d |durPj ||d d _ dS) aK Set the aspect ratio of the Axes scaling, i.e. y/x-scale. Parameters ---------- aspect : {'auto', 'equal'} or float Possible values: - 'auto': fill the position rectangle with data. - 'equal': same as ``aspect=1``, i.e. same scaling for x and y. - *float*: The displayed size of 1 unit in y-data coordinates will be *aspect* times the displayed size of 1 unit in x-data coordinates; e.g. for ``aspect=2`` a square in data coordinates will be rendered with a height of twice its width. adjustable : None or {'box', 'datalim'}, optional If not ``None``, this defines which parameter will be adjusted to meet the required aspect. See `.set_adjustable` for further details. anchor : None or str or (float, float), optional If not ``None``, this defines where the Axes will be drawn if there is extra space due to aspect constraints. The most common way to specify the anchor are abbreviations of cardinal directions: ===== ===================== value description ===== ===================== 'C' centered 'SW' lower left corner 'S' middle of bottom edge 'SE' lower right corner etc. ===== ===================== See `~.Axes.set_anchor` for further details. share : bool, default: False If ``True``, apply the settings to all shared Axes. See Also -------- matplotlib.axes.Axes.set_adjustable Set how the Axes adjusts to achieve the required aspect ratio. matplotlib.axes.Axes.set_anchor Set the position in case of extra space. equalrRrrz#aspect must be finite and positive c&h|]}j|D]}|q qSr$r=ryr;siblingrr$r%r  z'_AxesBase.set_aspect..N)rT) r _str_equalfloatrisfiniter4rr r set_adjustable set_anchorr)r aspect adjustableanchorrrrJr$rr% set_aspects" 0  z_AxesBase.set_aspectcCrV)a Return whether the Axes will adjust its physical dimension ('box') or its data limits ('datalim') to achieve the desired aspect ratio. See Also -------- matplotlib.axes.Axes.set_adjustable Set how the Axes adjusts to achieve the required aspect ratio. matplotlib.axes.Axes.set_aspect For a description of aspect handling. )r rr$r$r%get_adjustable z_AxesBase.get_adjustablecsntjddg|d|rfddjD}ng}|dkr*tdd|Dr*td|D]}||_q,d _d S) a Set how the Axes adjusts to achieve the required aspect ratio. Parameters ---------- adjustable : {'box', 'datalim'} If 'box', change the physical dimensions of the Axes. If 'datalim', change the ``x`` or ``y`` data limits. This may ignore explicitly defined axis limits. share : bool, default: False If ``True``, apply the settings to all shared Axes. See Also -------- matplotlib.axes.Axes.set_aspect For a description of aspect handling. Notes ----- Shared Axes (of which twinned Axes are a special case) impose restrictions on how aspect ratios can be imposed. For twinned Axes, use 'datalim'. For Axes that share both x and y, use 'box'. Otherwise, either 'datalim' or 'box' may be used. These limitations are partly a requirement to avoid over-specification, and partly a result of the particular implementation we are currently using, in which the adjustments for aspect ratios are done sequentially and independently on each Axes as it is drawn. rdatalimrLcrBr$r=rCrr$r%rrEz+_AxesBase.set_adjustable..css$|] }t|jddtjkVqdS)__func__N)rget_data_ratiorrhr$r$r%rs   z+_AxesBase.set_adjustable..zPCannot set Axes adjustable to 'datalim' for Axes which override 'get_data_ratio'TN)rrprrr4r r)r rLraxsrJr$rr%rIs z_AxesBase.set_adjustablecCrV)a Return the Axes box aspect, i.e. the ratio of height to width. The box aspect is ``None`` (i.e. chosen depending on the available figure space) unless explicitly specified. See Also -------- matplotlib.axes.Axes.set_box_aspect for a description of box aspect. matplotlib.axes.Axes.set_aspect for a description of aspect handling. ) _box_aspectrr$r$r%get_box_aspect r^z_AxesBase.get_box_aspectcCsZh|j||j|}|dur t|}|D]}|dq|D]}||_d|_q"dS)aD Set the Axes box aspect, i.e. the ratio of height to width. This defines the aspect of the Axes in figure space and is not to be confused with the data aspect (see `~.Axes.set_aspect`). Parameters ---------- aspect : float or None Changes the physical dimensions of the Axes, such that the ratio of the Axes height to the Axes width in physical units is equal to *aspect*. Defining a box aspect will change the *adjustable* property to 'datalim' (see `~.Axes.set_adjustable`). *None* will disable a fixed box aspect so that height and width of the Axes are chosen independently. See Also -------- matplotlib.axes.Axes.set_aspect for a description of aspect handling. NrQT)r@r?rGrIrVr)r rKrUrJr$r$r%rs  z_AxesBase.set_box_aspectcCrV)z Get the anchor location. See Also -------- matplotlib.axes.Axes.set_anchor for a description of the anchor. matplotlib.axes.Axes.set_aspect for a description of aspect handling. )r rr$r$r% get_anchorAs z_AxesBase.get_anchorcsh|tjjvst|dkstddtjj|r$fddjD}ng}|D]}||_q)d_dS)ux Define the anchor location. The actual drawing area (active position) of the Axes may be smaller than the Bbox (original position) when a fixed aspect is required. The anchor defines where the drawing area will be located within the available space. Parameters ---------- anchor : (float, float) or {'C', 'SW', 'S', 'SE', 'E', 'NE', ...} Either an (*x*, *y*) pair of relative coordinates (0 is left or bottom, 1 is right or top), 'C' (center), or a cardinal direction ('SW', southwest, is bottom left, etc.). str inputs are shorthands for (*x*, *y*) coordinates, as shown in the following diagram:: ┌─────────────────┬─────────────────┬─────────────────┐ │ 'NW' (0.0, 1.0) │ 'N' (0.5, 1.0) │ 'NE' (1.0, 1.0) │ ├─────────────────┼─────────────────┼─────────────────┤ │ 'W' (0.0, 0.5) │ 'C' (0.5, 0.5) │ 'E' (1.0, 0.5) │ ├─────────────────┼─────────────────┼─────────────────┤ │ 'SW' (0.0, 0.0) │ 'S' (0.5, 0.0) │ 'SE' (1.0, 0.0) │ └─────────────────┴─────────────────┴─────────────────┘ share : bool, default: False If ``True``, apply the settings to all shared Axes. See Also -------- matplotlib.axes.Axes.set_aspect for a description of aspect handling. rQzargument must be among %sr.crBr$r=rCrr$r%rsrEz'_AxesBase.set_anchor..TN) rDrFcoefsrWr4r6rr r)r rMrrrJr$rr%rJNs!  z_AxesBase.set_anchorcCs\|j|\}}|j|\}}tt||d}tt||d}||S)z Return the aspect ratio of the scaled data. Notes ----- This method is intended to be overridden by new projection types. KH9)rrrA get_xboundr get_yboundrabs)r txmintxmaxtymintymaxxsizeysizer$r$r%rT|s z_AxesBase.get_data_ratioc(Csv|dur |jdd}|}|dkr |jdur |j|dddS|jddj}tj |}|j |j }|j d krb||j vrCtd ||}|}||||}||||ddS|jdur|}||j||}||||d|dkrdS|jdur|j|ddn|||}|j} |j} | |\} } | |\} }tt| | d }tt|| d }||j |j }||}|||d }t|d krdS|j}| |j\}}| |j\}}d||}d||}||}||}||}||}||}||}d} d}!||jdv}"||jdv}#|"r7|#r7td|#r=d}$n'|| kr[||!kr[|dkrQ|dkpY|dkoY|dk}%n|dk}%|"pc|%}$|$rd| |}&|&|d}|&|d}| st!"d|#| $||gdSd| | }'|'|d}|'|d}|%st!"d|&| $||gdS)a Adjust the Axes for a specified data aspect ratio. Depending on `.get_adjustable` this will modify either the Axes box (position) or the view limits. In the former case, `~matplotlib.axes.Axes.get_anchor` will affect the position. Parameters ---------- position : None or .Bbox .. note:: This parameter exists for historic reasons and is considered internal. End users should not use it. If not ``None``, this defines the position of the Axes within the figure as a Bbox. See `~.Axes.get_position` for further details. Notes ----- This is called automatically when each Axes is drawn. You may need to call it yourself if you need to update the Axes position and/or view limits before the Figure is drawn. An alternative with a broader scope is `.Figure.draw_without_rendering`, which updates all stale components of a figure, not only the positioning / view limits of a single Axes. See Also -------- matplotlib.axes.Axes.set_aspect For a description of aspect ratio handling. matplotlib.axes.Axes.set_adjustable Set how the Axes adjusts to achieve the required aspect ratio. matplotlib.axes.Axes.set_anchor Set the position in case of extra space. matplotlib.figure.Figure.draw_without_rendering Update all stale components of a figure. Examples -------- A typical usage example would be the following. `~.Axes.imshow` sets the aspect to 1, but adapting the Axes position and extent to reflect this is deferred until rendering for performance reasons. If you want to know the Axes size before, you need to call `.apply_aspect` to get the correct values. >>> fig, ax = plt.subplots() >>> ax.imshow(np.zeros((3, 3))) >>> ax.bbox.width, ax.bbox.height (496.0, 369.59999999999997) >>> ax.apply_aspect() >>> ax.bbox.width, ax.bbox.height (369.59999999999997, 369.59999999999997) NTrrrrFrBrzHAdjustable 'box' is not allowed in a twinned Axes; use 'datalim' insteadrZrRg{Gzt?g?rrrzset_aspect(..., adjustable='datalim') or axis('equal') are not allowed when both axes are shared. Try set_aspect(..., adjustable='box').r@zQIgnoring fixed y limits to fulfill fixed data aspect with adjustable data limits.zQIgnoring fixed x limits to fulfill fixed data aspect with adjustable data limits.)'rZr@rVrYrHrIrDrFr transformedr r r r@ RuntimeErrorrTrshrunk_to_aspectanchoredrXrrrrAr[r\rr]r intervalx intervalyr>r_logwarning set_yboundinvertedr set_xbound)(r positionrKtransbb fig_aspectrpbpb1x_trfy_trfxminxmaxyminymaxrbrc data_ratio y_expanderdLrrrrxryrxmargymargYsizeXsizeXmargYmargxmymshared_xshared_yadjust_yadjyycxcr$r$r%rs9                        z_AxesBase.apply_aspect)rc stttfrՈdur ddurddkr!|n-dkr+|n#dvr|d|d|jdddkrL|jdd d nd kr^|jdd d d|dndkrn|jdd|dndkr|jdd|d|jdd d dnȈdkr|jdd d d|d| }| }t t |t |d}|j|d|d|g|dd|j|d|d|g|ddntdddurtdt|jkrtdddd|jDfddt|jD}n!i}|jD]}||dd} ||dd} | | f||<q|D]&\}\} } | dur9| dur9dnd} t|d |d!} | | | || dq'|rWtd"|d#} |jD]}t|d$|d!}| |7} q\| 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, xmax, ymin, ymax : float, optional The axis limits to be set. This can also be achieved using :: ax.set(xlim=(xmin, xmax), ylim=(ymin, ymax)) option : bool or str If a bool, turns axis lines and labels on or off. If a string, possible values are: ================ =========================================================== Value Description ================ =========================================================== 'off' or `False` Hide all axis decorations, i.e. axis labels, spines, tick marks, tick labels, and grid lines. This is the same as `~.Axes.set_axis_off()`. 'on' or `True` Do not hide all axis decorations, i.e. axis labels, spines, tick marks, tick labels, and grid lines. This is the same as `~.Axes.set_axis_on()`. 'equal' Set equal scaling (i.e., make circles circular) by changing the axis limits. This is the same as ``ax.set_aspect('equal', adjustable='datalim')``. Explicit data limits may not be respected in this case. 'scaled' Set equal scaling (i.e., make circles circular) by changing dimensions of the plot box. This is the same as ``ax.set_aspect('equal', adjustable='box', anchor='C')``. Additionally, further autoscaling will be disabled. 'tight' Set limits just large enough to show all data, then disable further autoscaling. 'auto' Automatic scaling (fill plot box with data). 'image' 'scaled' with axis limits equal to data limits. 'square' Square plot; similar to 'scaled', but initially forcing ``xmax-xmin == ymax-ymin``. ================ =========================================================== emit : bool, 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 Notes ----- For 3D Axes, this method additionally takes *zmin*, *zmax* as parameters and likewise returns them. TonFoff)rArtscaledrimagesquarerrtrArQrRrrrS)rLrMrtrrrrzUnrecognized string z to axis; try 'on' or 'off'NrQzAThe first argument to axis() must be an iterable of the form [{}]r.css |] }|d|dVqdS)zmin, rNr$rr$r$r%rs z!_AxesBase.axis..cs*i|]\}}|d|d|dqS)rQrRr$)ryrer;r~r$r%rsz"_AxesBase.axis..minrset_limrr$get_)rrboolrr set_axis_offset_autoscale_onrNrmrrrrdiffrrr4rWrrr5r6rrrrrr)r r~rr*xlimylim edge_sizelimitsr;ax_minax_maxax_auto set_ax_limlims get_ax_limr$rr%r.sC                 z_AxesBase.axiscCrV)z?Return the `.Legend` instance, or None if no legend is defined.)rrr$r$r% get_legendrXz_AxesBase.get_legendcCtd|jS)z6Return a list of `.AxesImage`\s contained by the Axes.r/)r silent_listr6rr$r$r% get_imagesz_AxesBase.get_imagescCr)z-Return a list of lines contained by the Axes.rj)rrr8rr$r$r% get_linesrz_AxesBase.get_linescCrV)z [*Discouraged*] Return the XAxis instance. .. admonition:: Discouraged The use of this function is discouraged. You should instead directly access the attribute `~.Axes.xaxis`. )rrr$r$r% get_xaxis z_AxesBase.get_xaxiscCrV)z [*Discouraged*] Return the YAxis instance. .. admonition:: Discouraged The use of this function is discouraged. You should instead directly access the attribute `~.Axes.yaxis`. )rrr$r$r% get_yaxisrz_AxesBase.get_yaxis get_gridlines get_ticklinescCs2tjtjtjf|d||jvrtd||_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. )imz4Argument must be an image or collection in this AxesN) rrr,r-r.r/rr4r)r rr$r$r%_scis  z_AxesBase._scicCrV)z:Helper for `~matplotlib.pyplot.gci`; do not use elsewhere.)rrr$r$r%_gcirXz_AxesBase._gcicCstdd|jDS)z Return whether any artists have been added to the Axes. This should not be used to determine whether the *dataLim* need to be updated, and may not actually be useful for anything. css*|]}t|tjtjtjtjfVqdSr() rr,r-r.r/rXrjrr0rxr$r$r%rs  z%_AxesBase.has_data..)rrrr$r$r%has_datasz_AxesBase.has_datacCsH||_|j||jj|_|||dur||jd|_ |S)a Add an `.Artist` to the Axes; return the artist. 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 `~.Axes.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``. NT) rrrremoverr get_clip_pathrrrrr$r$r% add_artists     z_AxesBase.add_artistcCsB||_tj|_|j|tj|jddj |jgd|_ d|_ |S)z Add an `.Axes` to the Axes' children; return the child Axes. This is the lowlevel version. See `.axes.Axes.inset_axes`. FrB)ownersT) rmartist_stale_axes_callbackstale_callbackrr functoolspartialrH _remove_axesrr)r rJr$r$r%add_child_axes s  z_AxesBase.add_child_axescCstjtj|d|s|dt|j|j||jj |_ | || dur3| |j|rY|||j}|}t|jsTt||jgg}||d|_|S)zI Add a `.Collection` to the Axes; return the collection. ) collection_childNT)rrr,r-rOrrWrrrrrrrrro get_datalimr{ get_pointsrisinfminposrq concatenateupdate_datalimr)r rautolimrQpointsr$r$r%add_collection' s"       z_AxesBase.add_collectioncCsXtjtj|d|||s|dt|j|j ||jj |_ d|_ |S)zD Add an `.AxesImage` to the Axes; return the image. )rrT) rrr.r/rrOrrWrrrrr)r rr$r$r% add_imageG s   z_AxesBase.add_imagecCs,|\}}}}|j||f||ffdSr() get_extentrr)r rrxryrzr{r$r$r%_update_image_limitsT sz_AxesBase._update_image_limitscCsztjtj|d|||dur||j||| s-| dt |j |j ||j j|_d|_|S)z? Add a `.Line2D` to the Axes; return the line. )lineNrT)rrrXrjrrrr_update_line_limitsrOrrWrrrrr)r rr$r$r%add_lineX s      z_AxesBase.add_linecCs:tjtj|d|||j||jj|_d|_ |S)z= Add a `.Text` to the Axes; return the text. )txtT) rrrrrrrrrr)r rr$r$r% _add_texti s    z_AxesBase._add_textc Cs|}|jjdkr dS|}||jkr|}n)t||jr?||j}|jjr9|}| \}}| |}n| |}n|}|jjsGdS||j\} } |j dkrh| r^|| kr^d} | rh||krhd} |jj||j| | dd|_dS)zY Figures out the data limit of the given line, updating `.Axes.dataLim`. rNrFupdatexupdatey)get_pathverticesrrr{rcontains_branch_seperately is_affine_get_transformed_pathget_transformed_path_and_affinetransform_path_affinetransform_pathr;rrrupdate_from_pathr) r rpathline_trf data_path trf_to_dataline_trans_pathna_path_rrr$r$r%rt s6        z_AxesBase._update_line_limitscCsVtjtj|d|||dur||j|||j ||j j |_ |S)z? Add a `.Patch` to the Axes; return the patch. )pN) rrrr0rrrr_update_patch_limitsrrrr)r rr$r$r% add_patch s      z_AxesBase.add_patchc Cst|tjr|s|sdS|}g}|jddD]\}}|\}}||dg|dqt |rt|}tt|sdS|jj||j||dd|_dS)ak 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 (N, 2) array. updatex, updatey : bool, default: True Whether to update the x/y limits. NrF)rasarrayrrHrupdate_from_data_xyr)r rrrr$r$r%r s   z_AxesBase.update_datalim)convertc s|pg}|pi}|j|D]+\}}z|}Wnty&td|dw|dur8|dur8|s8||q D]G\}}|durFq=||d|j}|jdkrbddd}||||}||jkr|dur| ||D]\} }| |kr|dur||qrq=fdd |DS) a Set axis units based on *datasets* and *kwargs*, and optionally apply unit conversions to *datasets*. Parameters ---------- datasets : list List of (axis_name, dataset) pairs (where the axis name is defined as in `._axis_map`). Individual datasets can also be None (which gets passed through). kwargs : dict Other parameters from which unit info (i.e., the *xunits*, *yunits*, *zunits* (for 3D Axes), *runits* and *thetaunits* (for polar) entries) is popped, if present. Note that this dict is mutated in-place! convert : bool, default: True Whether to return the original datasets or the converted ones. Returns ------- list Either the original datasets if *convert* is False, or the converted ones if *convert* is True (the default). zInvalid axis name: Nrr thetaunitsrunitsrcs.g|]\}}r|dur||n|qSr() convert_units)ryrrtaxis_maprr$r%r{i sz0_AxesBase._process_unit_info..) rKeyErrorr4 have_unitsrrrrr; set_units) r datasetsr*rrrtrr polar_unitsdataset_axis_namer$rr%r0 s8          z_AxesBase._process_unit_infocCs|j|dS)zT Return whether the given event (in display coords) is in the Axes. rrcontainsr mouseeventr$r$r%in_axesm sz_AxesBase.in_axes_get_autoscale_on_set_autoscale_oncCstdd|jDS)z8Return True if each axis is autoscaled, False otherwise.cs|]}|VqdSr()r)ryrr$r$r%rz sz-_AxesBase.get_autoscale_on..)rqrrlrr$r$r%get_autoscale_onx sz_AxesBase.get_autoscale_oncCs|jD]}||qdS)z Set whether autoscaling is applied to each axis on the next draw or call to `.Axes.autoscale_view`. Parameters ---------- b : bool N)rrlr)r brr$r$r%r} s z_AxesBase.set_autoscale_oncCrV)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. )rrr$r$r%use_sticky_edges sz_AxesBase.use_sticky_edgescCst||_dSr()rrr rr$r$r%r rcCrV)z Retrieve autoscaling margin of the x-axis. .. versionadded:: 3.9 Returns ------- xmargin : float See Also -------- matplotlib.axes.Axes.set_xmargin )rrr$r$r% get_xmargin r^z_AxesBase.get_xmargincCrV)z Retrieve autoscaling margin of the y-axis. .. versionadded:: 3.9 Returns ------- ymargin : float See Also -------- matplotlib.axes.Axes.set_ymargin )rrr$r$r% get_ymargin r^z_AxesBase.get_ymargincC*|dkrtd||_|dd|_dS)a 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. If *m* is negative, this will clip the data range instead of expanding it. For example, if your data is in the range [0, 2], a margin of 0.1 will result in a range [-0.2, 2.2]; a margin of -0.1 will result in a range of [0.2, 1.8]. Parameters ---------- m : float greater than -0.5 margin must be greater than -0.5rTN)r4rrvrr mr$r$r% set_xmargin   z_AxesBase.set_xmargincCr)a 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. If *m* is negative, this will clip the data range instead of expanding it. For example, if your data is in the range [0, 2], a margin of 0.1 will result in a range [-0.2, 2.2]; a margin of -0.1 will result in a range of [0.2, 1.8]. Parameters ---------- m : float greater than -0.5 rrrTN)r4rrvrr r$r$r% set_ymargin r#z_AxesBase.set_ymargin)rrrtcGs|r|dus |durtdt|dkr|d}}nt|dkr&|\}}n|r,td|durG|durG|durAtd|d |j|jfS|durN||_|durW|||durb||dSdS) an Set or retrieve margins around the data for autoscaling axis limits. This allows to configure the padding around the data without having to set explicit limits using `~.Axes.set_xlim` / `~.Axes.set_ylim`. Autoscaling determines the axis limits by adding *margin* times the data interval as padding around the data. See the following illustration: .. plot:: _embedded_plots/axes_margins.py All input parameters must be floats greater than -0.5. Passing both positional and keyword arguments is invalid and will raise a TypeError. If no arguments (positional or otherwise) are provided, the current margins will remain unchanged and simply be returned. The default margins are :rc:`axes.xmargin` and :rc:`axes.ymargin`. Parameters ---------- *margins : float, optional If a single positional argument is provided, it specifies both margins of the x-axis and y-axis limits. If two positional arguments are provided, they will be interpreted as *xmargin*, *ymargin*. If setting the margin on a single axis is desired, use the keyword arguments described below. x, y : float, optional Specific margin values for the x-axis and y-axis, respectively. These cannot be used with positional arguments, but can be used individually to alter on e.g., only the y-axis. tight : bool or None, default: True The *tight* parameter is passed to `~.axes.Axes.autoscale_view`, which is executed after a margin is changed; the default here is *True*, on the assumption that when margins are specified, no additional padding to match tick marks is usually desired. Setting *tight* to *None* preserves the previous setting. Returns ------- xmargin, ymargin : float Notes ----- If a previously used Axes method such as :meth:`pcolor` has set `~.Axes.use_sticky_edges` to `True`, only the limits not set by the "sticky artists" will be modified. To force all margins to be set, set `~.Axes.use_sticky_edges` to `False` before calling :meth:`margins`. See Also -------- .Axes.set_xmargin, .Axes.set_ymargin NzACannot pass both positional and keyword arguments for x and/or y.rRrrQzVMust pass a single positional argument for all margins, or one for each margin (x, y).Tzignoring tight=z in get mode) rrWrrrrrsr"r$)r rrrtmarginsr$r$r%r% s&;     z_AxesBase.marginscCr)a Set the zorder threshold for rasterization for vector graphics output. All artists with a zorder below the given value will be rasterized if they support rasterization. This setting is ignored for pixel-based output. See also :doc:`/gallery/misc/rasterization_demo`. Parameters ---------- z : float or None The zorder below which artists are rasterized. If ``None`` rasterization based on zorder is deactivated. TN)r%r)r zr$r$r%set_rasterization_zorder= s z"_AxesBase.set_rasterization_zordercCrV)z?Return the zorder value below which artists will be rasterized.)r%rr$r$r%get_rasterization_zorderQ rXz"_AxesBase.get_rasterization_zordercCs|dur d}d}n$|dvr|t||}nd}|dvr+|t||}nd}|r4|r4d|_|r;|r;d|_|rD|jd|d|rO|jd |ddSdS) a Autoscale the axis view to the data (toggle). Convenience method for simple axis view autoscaling. It turns autoscaling on or off, and then, if autoscaling for either axis is on, it performs the autoscaling on the specified axis or Axes. Parameters ---------- enable : bool or None, default: True True turns autoscaling on, False turns it off. None leaves the autoscaling state unchanged. axis : {'both', 'x', 'y'}, default: 'both' The axis on which to operate. (For 3D Axes, *axis* can also be set to 'z', and 'both' refers to all three Axes.) tight : bool or None, default: None If True, first set the margins to zero. Then, this argument is forwarded to `~.axes.Axes.autoscale_view` (regardless of its value); see the description of its behavior there. NTrrFrrrrrr)set_autoscalex_onrrset_autoscaley_onrrrrv)r enablerrtscalexscaleyr$r$r% autoscaleU s(  z_AxesBase.autoscalecs|dur t|_tg}}jrKjr/|r/r/ttddj d D}j rK|rK rKttddj d D} dkrW||dk}dkrc||dk}fd d }||j ddjj|j||j ddjj |jdS) a Autoscale the view limits using the data limits. Parameters ---------- tight : bool or None If *True*, only expand the axis limits using the margins. Note that unlike for `autoscale`, ``tight=True`` does *not* set the margins to zero. If *False* and :rc:`axes.autolimit_mode` is 'round_numbers', then after expansion by the margins, further expand the axis limits using the axis major locator. If None (the default), reuse the value set in the previous call to `autoscale_view` (the initial value is False, but the default style sets :rc:`axes.autolimit_mode` to 'data', in which case this behaves like True). scalex : bool, default: True Whether to autoscale the x-axis. scaley : bool, default: True Whether to autoscale the y-axis. Notes ----- The autoscaling preserves any preexisting axis direction reversal. The data limits are not updated automatically when artist data are changed after the artist has been added to an Axes instance. In that case, use :meth:`matplotlib.axes.Axes.relim` prior to calling autoscale_view. If the views of the Axes are fixed, e.g. via `set_xlim`, they will not be changed by autoscale_view(). See :meth:`matplotlib.axes.Axes.autoscale` for an alternative. NcS"g|] }|D]}|jjqqSr$) get_children sticky_edgesrryrJrr$r$r%r{ z,_AxesBase.autoscale_view..rcSr1r$)r2r3rr4r$r$r%r{ r5rlogrcs|r|sdS|}fdd|D}|r"t|t|} } ntjdr.dStj tj} } |} | | | \} } tfdd|D} dt | | } | | | d}|dkrf||nd}| | | }|t |kry||nd}| }|}|j| | | \} } || | g\}}|||}t|sd }|||||g\} } |durt| |} |durt| |} js| | | \} } || | dS) Ncs2g|]}t|jdD] }t|r |q qS)interval)rrrrH)ryrJrrir$r%r{ s  zH_AxesBase.autoscale_view..handle_single_axis..mutatedc3s"|] }t|jdVqdS)rN)rrrhrir$r%r s zG_AxesBase.autoscale_view..handle_single_axis..gh㈵>rRrr)rr?rrrrcrinfget_major_locator nonsingularr] searchsortedrWrrnrlimit_range_for_scalerArHrs view_limits)rkrDr;rmarginstickies set_boundsharedrlrrrminimum_minpostoli0x0boundi1x1boundrA inverse_transx0tx1tdeltarrir%handle_single_axis sD       z4_AxesBase.autoscale_view..handle_single_axis)rrsrarrayrrrsortrr>r?rr get_xscale get_yscalerrorrm)r rtr.r/ x_stickies y_stickiesrMr$rr%rm s2'       >z_AxesBase.autoscale_viewc Cs^|jdur|jstddS|j|j|jf}tdd|Ds"dSt}||j ||j |||j ddj d ||j D]}|}||rU|||ndqFtj }|D]+}d}|jdvsq|jd krw|j|}|dur|jd |}t||j}q_|D]}|\} } || d f|r|D]!}|j||jjr|jj|}| |||r|j}q|d krtd dS||j!|kr|j"#$d |f\} } || | f||j!|kr|j"#$dd|||j!f\} } || | fqtdd|D} |D]}|\} } || | fqdS)z Update the title position based on the bounding box enclosing all the ticklabels and x-axis spine and xlabel... Nz2title position was updated manually, not adjustingcsrr()rQryrTr$r$r%r rz3_AxesBase._update_title_position..FrBrT)runknownroutlinerrz1top of Axes not in the figure, so title not movedrrQcss|] }|dVqdS)rRN)rZrTr$r$r%rB s)%rrkdebugrTrrrrupdaterr@r?rH_align_label_groupsrrrr9rget_ticks_positionget_label_position get_tightbboxr rr]rr{rZrrQr offsetText intersectionrzrxrnrA) r rKrSrUrJrrrrrTrrrr{r$r$r%_update_title_position sh          z _AxesBase._update_title_positionc Cs|durtd|sdS||jd|dd|_|}||r+|||nd|}| |j |j r>|j sK|j D]}| |qC|||j s`|jD]}| |qX|jddjspdd|D}t|tdd }|j}|dur|r|d j|krtjd d|D|d d }|d|}||d}ng}|j r|j r|r|j g|}n|j g|}|rt|jdd||t||||jddj|dd|_dS)NzNo renderer definedr)gidTrBcSs$g|]}|rt|tjr|qSr$) get_animatedrr.r/rxr$r$r%r{m s z"_AxesBase.draw..zorderr"rcSsg|]}|jqSr$)rb)ryartr$r$r%r{y sr)rF) rfrro open_groupget_gidrCrrr2rraxisonr#r rlr_rrHcanvas is_savingsortedrr%rbrr<_draw_rasterizedr._draw_list_compositing_imagessuppressComposite close_groupr) r rKrr+r _axisrasterization_zorder split_indexartists_rasterizedr$r$r%drawI s\           z_AxesBase.drawcCs||jddjdS)z5 Efficiently redraw a single artist. TrBN)rsrHrh get_rendererrr$r$r% draw_artist sz_AxesBase.draw_artistcCs|t1}g|j|j|j|jD] }||jddq||j ddj WddS1s7wYdS)zP Efficiently redraw Axes data, but not axis ticks, labels, etc. F)visibleTrBN) rrrlrTrr enter_context_cm_setrsrHrhrt)r rrr$r$r%redraw_in_frame s "z_AxesBase.redraw_in_framecCrV)z.Get whether the Axes rectangle patch is drawn.)r#rr$r$r% get_frame_on rXz_AxesBase.get_frame_oncCr)zx Set whether the Axes rectangle patch is drawn. Parameters ---------- b : bool TN)r#rrr$r$r% set_frame_on rz_AxesBase.set_frame_oncCrV)z Get whether axis ticks and gridlines are above or below most artists. Returns ------- bool or 'line' See Also -------- set_axisbelow ) _axisbelowrr$r$r% get_axisbelow rPz_AxesBase.get_axisbelowcCsBt||_}dddd|}|jD]}||qd|_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 patches and lines, though still above images. - 'line' (zorder = 1.5): Ticks and gridlines are above patches (e.g. rectangles, with default zorder = 1) but still below lines and markers (with their default zorder = 2). - *False* (zorder = 2.5): Ticks and gridlines are above patches and lines / markers. Notes ----- For more control, call the `~.Artist.set_zorder` method of each axis. See Also -------- get_axisbelow rg?g@)TrFTN)rr|rrl set_zorderr)r r axisbelowrbrr$r$r%r$ s  z_AxesBase.set_axisbelowrcKsZtjgd|d|dvr|jj|fd|i||dvr+|jj|fd|i|dSdS)a Configure the grid lines. Parameters ---------- visible : bool or None, optional Whether to show the grid lines. If any *kwargs* are supplied, it is assumed you want the grid on and *visible* will be set to True. If *visible* is *None* and there are no *kwargs*, this toggles the visibility of the lines. which : {'major', 'minor', 'both'}, optional The grid lines to apply the changes on. axis : {'both', 'x', 'y'}, optional The axis to apply the changes on. **kwargs : `~matplotlib.lines.Line2D` properties Define the line properties of the grid, e.g.:: grid(color='r', linestyle='-', linewidth=2) Valid keyword arguments are: %(Line2D:kwdoc)s Notes ----- The axis is drawn as a unit, so the effective zorder for drawing the grid is determined by the zorder of each axis, not by the zorder of the `.Line2D` objects comprising the grid. Therefore, to set grid zorder, use `.set_axisbelow` or, for more control, call the `~.Artist.set_zorder` method of each axis. rrrrr)rr*N)rrprrr)r rvrrr*r$r$r%r s %z_AxesBase.grid)rstyle scilimits useOffset useLocale useMathTextc CsZt|tr |}|}|dur1z |\}}||dWnttfy0} ztd| d} ~ wwdddddd} tj| |d} idd |jDd t |j i} tj| |d } z?| D]9}| durl|j j | |durw|j j ||dur|j j ||dur|j j ||dur|j j |q_WdSty} ztd | d} ~ ww) a Configure the `.ScalarFormatter` used by default for linear Axes. If a parameter is not set, the corresponding property of the formatter is left unchanged. Parameters ---------- axis : {'x', 'y', 'both'}, default: 'both' The axis to configure. Only major ticks are affected. style : {'sci', 'scientific', 'plain'} Whether to use scientific notation. The formatter default is to use scientific notation. 'sci' is equivalent to 'scientific'. scilimits : pair of ints (m, n) Scientific notation is used only for numbers outside the range 10\ :sup:`m` to 10\ :sup:`n` (and only if the formatter is configured to use scientific notation at all). Use (0, 0) to include all numbers. Use (m, m) where m != 0 to fix the order of magnitude to 10\ :sup:`m`. The formatter default is :rc:`axes.formatter.limits`. useOffset : bool or float If True, the offset is calculated as needed. If False, no offset is used. If a numeric value, it sets the offset. The formatter default is :rc:`axes.formatter.useoffset`. useLocale : bool Whether to format the number using the current locale or using the C (English) locale. This affects e.g. the decimal separator. The formatter default is :rc:`axes.formatter.use_locale`. useMathText : bool Render the offset and scientific notation in mathtext. The formatter default is :rc:`axes.formatter.use_mathtext`. Raises ------ AttributeError If the current formatter is not a `.ScalarFormatter`. NrRz*scilimits must be a sequence of 2 integersTF)sci scientificplainrN)rcSsi|]\}}||gqSr$r$rr$r$r%rL rz._AxesBase.ticklabel_format..rrz/This method only works with the ScalarFormatter)rrrr4rrrrrrrrlr formatterset_scientificset_powerlimits set_useOffset set_useLocaleset_useMathTextAttributeError)r rrrrrrr!nerrSTYLES is_sci_styleraxisesr$r$r%ticklabel_format sR . z_AxesBase.ticklabel_formatcKsftjg|jd|d|jD]}||dfvr-|j|}|jdi||j||dqd|_dS)a Control behavior of major tick locators. Because the locator is involved in autoscaling, `~.Axes.autoscale_view` is called automatically after the parameters are changed. Parameters ---------- axis : {'both', 'x', 'y'}, default: 'both' The axis on which to operate. (For 3D Axes, *axis* can also be set to 'z', and 'both' refers to all three axes.) tight : bool or None, optional Parameter passed to `~.Axes.autoscale_view`. Default is None, for no change. Other Parameters ---------------- **kwargs Remaining keyword arguments are passed to directly to the ``set_params()`` method of the locator. Supported keywords depend on the type of the locator. See for example `~.ticker.MaxNLocator.set_params` for the `.ticker.MaxNLocator` used by default for linear. Examples -------- When plotting small subplots, one might want to reduce the maximum number of ticks and use tight bounds, for example:: ax.locator_params(tight=True, nbins=4) rrrTNr$)rrprrr: set_paramsrvr)r rrtr*r;rLr$r$r%locator_params_ s!   z_AxesBase.locator_paramscKstjgd|d|dvr2t|}|dd|dd|dd|dd|jjdi||d vr]t|}|d d|d d|d d|d d|jjdi|dSdS)ac Change the appearance of ticks, tick labels, and gridlines. Tick properties that are not explicitly set using the keyword arguments remain unchanged unless *reset* is True. For the current style settings, see `.Axis.get_tick_params`. Parameters ---------- axis : {'x', 'y', 'both'}, default: 'both' The axis to which the parameters are applied. which : {'major', 'minor', 'both'}, default: 'major' The group of ticks to which the parameters are applied. reset : bool, default: False Whether to reset the ticks to defaults before updating them. Other Parameters ---------------- 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 : :mpltype:`color` Tick color. 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 : :mpltype:`color` Tick label color. labelfontfamily : str Tick label font. colors : :mpltype:`color` Tick color and label color. 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 : :mpltype:`color` Gridline color. grid_alpha : float Transparency of gridlines: 0 (transparent) to 1 (opaque). grid_linewidth : float Width of gridlines in points. grid_linestyle : str Any valid `.Line2D` line style spec. Examples -------- :: 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. rrr)rNrrrr*rrrrr$)rrprrrset_tick_paramsr)r rr*xkwykwr$r$r%r1 s B        z_AxesBase.tick_paramscCsd|_d|_dS)ar Hide all visual components of the x- and y-axis. This sets a flag to suppress drawing of all axis decorations, i.e. axis labels, axis spines, and the axis tick component (tick markers, tick labels, and grid lines). Individual visibility settings of these components are ignored as long as `set_axis_off()` is in effect. FTNrgrrr$r$r%r s z_AxesBase.set_axis_offcCsd|_d|_dS)a& Do not hide all visual components of the x- and y-axis. This reverts the effect of a prior `.set_axis_off()` call. Whether the individual axis decorations are drawn is controlled by their respective visibility settings. This is on by default. TNrrr$r$r%r s z_AxesBase.set_axis_oncC|jj}|S)z- Get the xlabel text string. )rrrQr rr$r$r% get_xlabel z_AxesBase.get_xlabelrKcKs|dur||j_gd}h|h|@r!|dur td|dn!|dur'|ntjd}tjd|ddd d d|}|j||d |jj||fi|S) a1 Set the label for the x-axis. Parameters ---------- xlabel : str The label text. labelpad : float, default: :rc:`axes.labelpad` Spacing in points from the Axes bounding box including ticks and tick labels. If None, the previous value is left as is. loc : {'left', 'center', 'right'}, default: :rc:`xaxis.labellocation` The label position. This is a high-level alternative for passing parameters *x* and *horizontalalignment*. Other Parameters ---------------- **kwargs : `~matplotlib.text.Text` properties `.Text` properties control the appearance of the label. See Also -------- text : Documents the properties supported by `.Text`. N)rrhaZSpecifying 'loc' is disallowed when any of its corresponding low level keyword arguments () are also suppliedzxaxis.labellocationrIrKrrrR)rr) rlabelpadrr^r_rrprXset_label_text)r xlabelfontdictrrLr* protected_kwrr$r$r% set_xlabel s*  z_AxesBase.set_xlabelcC|j|j dS)z Invert the x-axis. See Also -------- xaxis_inverted get_xlim, set_xlim get_xbound, set_xbound N)r set_inverted get_invertedrr$r$r% invert_xaxis/ z_AxesBase.invert_xaxisrcC$|\}}||kr||fS||fS)z Return the lower and upper x-axis bounds, in increasing order. See Also -------- set_xbound get_xlim, set_xlim invert_xaxis, xaxis_inverted )r)r rrr$r$r%r[= z_AxesBase.get_xboundcCd|dur t|r |\}}|\}}|dur|}|dur|}|jt||ft|ddddS)aF Set the lower and upper numerical bounds of the x-axis. This method will honor axis inversion regardless of parameter order. It will not change the autoscaling setting (`.get_autoscalex_on()`). Parameters ---------- lower, upper : float or None The lower and upper bounds. If *None*, the respective axis bound is not modified. .. ACCEPTS: (lower: float, upper: float) See Also -------- get_xbound get_xlim, set_xlim invert_xaxis, xaxis_inverted Nreverser)rrr[rrjrxaxis_invertedr rupper old_lower old_upperr$r$r%roM    z_AxesBase.set_xboundcC t|jjS)a Return the x-axis view limits. Returns ------- left, right : (float, float) The current x-axis limits in data coordinates. See Also -------- .Axes.set_xlim .Axes.set_xbound, .Axes.get_xbound .Axes.invert_xaxis, .Axes.xaxis_inverted Notes ----- The x-axis may be inverted, in which case the *left* value will be greater than the *right* value. )r%rprirr$r$r%ro z_AxesBase.get_xlimcCsH|dur"||}t|tjr|}t|tr 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)rrndarraysqueezerrHr4)r limitrconverted_limitr$r$r%_validate_converted_limitss   z$_AxesBase._validate_converted_limits)rrrxrycCf|dur t|r |\}}|dur|durtd|}|dur)|dur'td|}|jj||||dS)a Set the x-axis view limits. Parameters ---------- left : float, optional The left xlim in data coordinates. Passing *None* leaves the limit unchanged. The left and right xlims may also be passed as the tuple (*left*, *right*) as the first positional argument (or as the *left* keyword argument). .. ACCEPTS: (left: float, right: float) right : float, optional The right xlim in data coordinates. Passing *None* leaves the limit unchanged. emit : bool, default: True Whether to notify observers of limit change. auto : bool or None, default: False Whether to turn on autoscaling of the x-axis. True turns on, False turns off, None leaves unchanged. xmin, xmax : float, optional They are equivalent to left and right respectively, and it is an error to pass both *xmin* and *left* or *xmax* and *right*. Returns ------- left, right : (float, float) The new x-axis limits in data coordinates. See Also -------- get_xlim set_xbound, get_xbound invert_xaxis, xaxis_inverted Notes ----- The *left* value may be greater than the *right* value, in which case the x-axis values will decrease from left to right. Examples -------- >>> 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) Nz"Cannot pass both 'left' and 'xmin'z#Cannot pass both 'right' and 'xmax'r)rrrrr)r rrrrrxryr$r$r%rBz_AxesBase.set_xlim get_scale_set_axes_scale get_ticklocs set_ticks set_xticksrget_majorticklabelsget_minorticklabelsget_ticklabelsset_ticklabelszAxis.set_tickszAxes.set_xtickscCr)z- Get the ylabel text string. )rrrQrr$r$r% get_ylabelrz_AxesBase.get_ylabelc Ks|dur||j_gd}h|h|@r!|dur td|dn#|dur'|ntjd}tjd|ddd d d|\}}|j||d |jj||fi|S) a1 Set the label for the y-axis. Parameters ---------- ylabel : str The label text. labelpad : float, default: :rc:`axes.labelpad` Spacing in points from the Axes bounding box including ticks and tick labels. If None, the previous value is left as is. loc : {'bottom', 'center', 'top'}, default: :rc:`yaxis.labellocation` The label position. This is a high-level alternative for passing parameters *y* and *horizontalalignment*. Other Parameters ---------------- **kwargs : `~matplotlib.text.Text` properties `.Text` properties control the appearance of the label. See Also -------- text : Documents the properties supported by `.Text`. N)rrrrrzyaxis.labellocation)rrJrrK)rr)rrJ)rRr)rr) rrrr^r_rrprXr) r ylabelrrrLr*rrrr$r$r% set_ylabels*  z_AxesBase.set_ylabelcCr)z Invert the y-axis. See Also -------- yaxis_inverted get_ylim, set_ylim get_ybound, set_ybound N)rrrrr$r$r% invert_yaxis,rz_AxesBase.invert_yaxiscCr)z Return the lower and upper y-axis bounds, in increasing order. See Also -------- set_ybound get_ylim, set_ylim invert_yaxis, yaxis_inverted )r)r rrr$r$r%r\:rz_AxesBase.get_yboundcCr)aC Set the lower and upper numerical bounds of the y-axis. This method will honor axis inversion regardless of parameter order. It will not change the autoscaling setting (`.get_autoscaley_on()`). Parameters ---------- lower, upper : float or None The lower and upper bounds. If *None*, the respective axis bound is not modified. .. ACCEPTS: (lower: float, upper: float) See Also -------- get_ybound get_ylim, set_ylim invert_yaxis, yaxis_inverted Nrr)rrr\rrjryaxis_invertedrr$r$r%rmJrz_AxesBase.set_yboundcCr)a Return the y-axis view limits. Returns ------- bottom, top : (float, float) The current y-axis limits in data coordinates. See Also -------- .Axes.set_ylim .Axes.set_ybound, .Axes.get_ybound .Axes.invert_yaxis, .Axes.yaxis_inverted Notes ----- The y-axis may be inverted, in which case the *bottom* value will be greater than the *top* value. )r%rprjrr$r$r%rlrz_AxesBase.get_ylim)rrrzr{cCr)a Set the y-axis view limits. Parameters ---------- bottom : float, optional The bottom ylim in data coordinates. Passing *None* leaves the limit unchanged. The bottom and top ylims may also be passed as the tuple (*bottom*, *top*) as the first positional argument (or as the *bottom* keyword argument). .. ACCEPTS: (bottom: float, top: float) top : float, optional The top ylim in data coordinates. Passing *None* leaves the limit unchanged. emit : bool, default: True Whether to notify observers of limit change. auto : bool or None, default: False Whether to turn on autoscaling of the y-axis. *True* turns on, *False* turns off, *None* leaves unchanged. ymin, ymax : float, optional They are equivalent to bottom and top respectively, and it is an error to pass both *ymin* and *bottom* or *ymax* and *top*. Returns ------- bottom, top : (float, float) The new y-axis limits in data coordinates. See Also -------- get_ylim set_ybound, get_ybound invert_yaxis, yaxis_inverted Notes ----- The *bottom* value may be greater than the *top* value, in which case the y-axis values will decrease from *bottom* to *top*. Examples -------- >>> 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) Nz$Cannot pass both 'bottom' and 'ymin'z!Cannot pass both 'top' and 'ymax'r)rrrrr)r rrrrrzr{r$r$r%rrz_AxesBase.set_ylim set_ytickszAxes.set_yticks axis_datecC$|jdur |j|S|jj|S)z Return *x* formatted as an x-value. This function will use the `.fmt_xdata` attribute if it is not None, else will fall back on the xaxis major formatter. N)r'rget_major_formatterformat_data_short)r rr$r$r% format_xdata  z_AxesBase.format_xdatacCr)z Return *y* formatted as a y-value. This function will use the `.fmt_ydata` attribute if it is not None, else will fall back on the yaxis major formatter. N)r(rrr)r rr$r$r% format_ydatarz_AxesBase.format_ydatac Cs|j|}t|dkr%d|durdn|||durdS||S|j||f}g}t|t ddD]}|j |\}}| d||||q7dd |S) z;Return a format string formatting the *x*, *y* coordinates.rRz(x, y) = ({}, {})Nz???rbrcz({}, {})z (x, y) = {}z | ) r@r?rWr5rrr{rArjrrnrr6) r rrtwins screen_xyxy_strsrJdata_xdata_yr$r$r% format_coords   z_AxesBase.format_coordcC|j|jdS)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. N)r minorticks_onrrr$r$r%rs z_AxesBase.minorticks_oncCr)z!Remove minor ticks from the Axes.N)rminorticks_offrrr$r$r%rs z_AxesBase.minorticks_offcCdS)zV Return whether this Axes supports the zoom box button functionality. Tr$rr$r$r%can_zoomz_AxesBase.can_zoomcCr)zV Return whether this Axes supports any pan/zoom button functionality. Tr$rr$r$r%can_panrz_AxesBase.can_pancCrV)zG Get whether the Axes responds to navigation commands.  _navigaterr$r$r% get_navigate!rz_AxesBase.get_navigatecC ||_dS)z Set whether the Axes responds to navigation toolbar commands. Parameters ---------- b : bool See Also -------- matplotlib.axes.Axes.set_forward_navigation_events Nrrr$r$r%r)'s z_AxesBase.set_navigatecCrV)zS Get the navigation toolbar button status: 'PAN', 'ZOOM', or None. _navigate_moderr$r$r%get_navigate_mode6rz_AxesBase.get_navigate_modecCr)z Set the navigation toolbar button status. .. warning:: This is not a user-API function. Nrrr$r$r%r*<s z_AxesBase.set_navigate_modecCs||||dS)a Save information required to reproduce the current view. This method is called before a view is changed, such as during a pan or zoom initiated by the user. It returns an opaque object that describes the current view, in a format compatible with :meth:`_set_view`. The default implementation saves the view limits and autoscaling state. Subclasses may override this as needed, as long as :meth:`_set_view` is also adjusted accordingly. )r autoscalex_onr autoscaley_on)rrrrrr$r$r% _get_viewFs z_AxesBase._get_viewcCs|jdi|dS)a7 Apply a previously saved view. This method is called when restoring a view (with the return value of :meth:`_get_view` as argument), such as with the navigation buttons. Subclasses that override :meth:`_get_view` also need to override this method accordingly. Nr$)r)r viewr$r$r% _set_viewWs z_AxesBase._set_viewinc,Cst|dkrz|\}}}|dkrd}|dkrd}nd}d|}|jt||g\\} } \} } | | } | | }| | d}| | d}||d||}||d||}|| d|||d||| d|||d|g}n t|d krtd d S| \}}| \}}|\}}}}|j ||f||fg\\}}\}}t t ||g||\} } t t ||g||\} } |s|d kr||} } |s|d kr||} } |dkr| | f}| | f}||fS|dkrX|j}|||| | g\}}} }!|||!| }"||"| |}#||"||!}$| |#|$g}|j}%|%||| | g\}&}'}(})|'|&|)|(}"|&|"|(|&}*|'|"|'|)}+|% |*|+g}||fS)z Helper function to prepare the new bounds from a bbox. This helper function returns the new x and y bounds from the zoom bbox. This a convenience method to abstract the bbox logic out of the base setter. rrrrRroutrrdrzgWarning in _set_view_from_bbox: bounding box is not a tuple of length 3 or 4. Ignoring the view change.Nrr)rWr{rAr transposerrrrr[r\rncliprjrrr),r r\ directionmodetwinxtwinyxpypsclrxrzryr{xwidthywidthxcenycenxzcyzcxmin0xmax0ymin0ymax0startxstartystopxstopy new_xbound new_yboundrvsxmin0sxmax0sxminsxmaxfactorsxmin1sxmax1rwsymin0symax0syminsymaxsymin1symax1r$r$r%_prepare_view_from_bboxcsv                  z!_AxesBase._prepare_view_from_bboxcCsd|j|||||d\}}|s|dkr|||d|s.|dkr0|||ddSdSdS)a Update view from a selection bbox. .. note:: Intended to be overridden by new projection types, but if not, the default implementation sets the view limits to the bbox directly. Parameters ---------- bbox : 4-tuple or 3 tuple * If bbox is a 4 tuple, it is the selected bounding box limits, in *display* coordinates. * If bbox is a 3 tuple, it is an (xp, yp, scl) triple, where (xp, yp) is the center of zooming and scl the scale factor to zoom by. direction : str The direction to apply the bounding box. * `'in'` - The bounding box describes the view directly, i.e., it zooms in. * `'out'` - The bounding box describes the size to make the existing view, i.e., it zooms out. mode : str or None The selection mode, whether to apply the bounding box in only the `'x'` direction, `'y'` direction or both (`None`). twinx : bool Whether this axis is twinned in the *x*-direction. twiny : bool Whether this axis is twinned in the *y*-direction. )rrrrrFrN)rror+rmr,)r r\rrrrr r r$r$r%_set_view_from_bboxs$      z_AxesBase._set_view_from_bboxcCs8tj|j|j|j|j||d|_dS)aQ Called when a pan operation has started. Parameters ---------- x, y : float The mouse coordinates in display coords. button : `.MouseButton` The pressed mouse button. Notes ----- This is intended to be overridden by new projection types. )rrq trans_inverser\rrN)typesSimpleNamespacerprr{rnr\ _pan_start)r rrbuttonr$r$r% start_pans  z_AxesBase.start_pancCs|`dS)z Called when a pan operation completes (when the mouse button is up.) Notes ----- This is intended to be overridden by new projection types. N)rrr$r$r%end_pansz_AxesBase.end_pancCsfdd}|j}||j}||j}||krdkrdS|dkr7||||\}}|j| | |j} ne|dkrzO| |jj}| |jj}||||\}}| dkr`d||}}t d ||f} t |j|jg} |j |j} | | | | } t| |j} Wntytd YdSwdSt | |j}| t}d||<|S) z Helper function to return the new points after a pan. This helper function returns the points on the axis after a pan has occurred. This is a convenience method to abstract the pan logic out of the base setter. cSs|dkrt|t|kr|}||fS|}||fS|dkr"d}||fS|dkr,d}||fS|dkrpdt|t|kr@d}||fSdt|t|krPd}||fSt|t|krf|t|t|}||fS|t|t|}||fS)NcontrolrrrshiftrQ)r])r"dxdyr$r$r% format_deltas s0  z0_AxesBase._get_pan_points..format_deltasrNrRrrrg$@zOverflow while panning)rrrr\ translatedrerr r r@rpowerrNrrqrDrF OverflowErrorrrrHrastyper)r rr"rrr&rr$r%ralphastart oldpoints newpointsvalidrr$r$r%_get_pan_pointssB      z_AxesBase._get_pan_pointscCsL|||||}|dur$||dddf||dddfdSdS)a Called when the mouse moves during a pan operation. Parameters ---------- button : `.MouseButton` The pressed mouse button. key : str or None The pressed key, if any. x, y : float The mouse coordinates in display coords. Notes ----- This is intended to be overridden by new projection types. NrrR)r0rr)r rr"rrrr$r$r%drag_pan?s z_AxesBase.drag_pancCsRg|j|j|j|j|j|j|j|jdur#|jgng|j Sr() rr rlrrTrrrrrrr$r$r%r2Us&z_AxesBase.get_childrencCs |j|Sr(rrr$r$r%ras z_AxesBase.containscCs|jj|ddS)zf Return whether *point* (pair of pixel coordinates) is inside the Axes patch. r)radius)rcontains_point)r pointr$r$r%r3esz_AxesBase.contains_pointcs|}|jD]}||q |jr|js$|jD]}||q||j||j||j t t j t jt jffdd|DS)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)``. cs2g|]}|r|rt|s|s|qSr$)r get_in_layoutr_fully_clipped_to_axesrxnoclipr$r%r{s  z<_AxesBase.get_default_bbox_extra_artists..)r2rrlrrgr#r rTrrrrrr AnnotationBbox OffsetBox)r r+rr r$r7r%get_default_bbox_extra_artistsls       z(_AxesBase.get_default_bbox_extra_artists)call_axes_locatorbbox_extra_artistsfor_layout_onlycCsg}|dur|jdd}|sdS|}||r#|r#|||nd|jD]}|jrA|rAt ||}|rA| |q+| || |} | | |j |j|jfD](} | r| |} |r|| jdkr|| j| jdd| _| jd| _| | qY|} | dur|} | D],} | |}|durd|jkrtjkrnqd|jkrtjkrnq| |qtjdd |DS) 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` subclass 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 : bool, 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. for_layout_only : default: False The bounding box will *not* include the x-extent of the title and the xlabel, or the y-extent of the ylabel. Returns ------- `.BboxBase` Bounding box in figure pixel coordinates. See Also -------- matplotlib.axes.Axes.get_window_extent matplotlib.axis.Axis.get_tightbbox matplotlib.spines.Spine.get_window_extent NTrBrrQrrcSs$g|]}|jdks|jdkr|qSr)r r )ryrr$r$r%r{s$z+_AxesBase.get_tightbbox..)rH _get_rendererrrrrrlrgr_get_tightbbox_for_layout_onlyrr_r]rTrrr rrr;r\rr9r rDrFunion)r rKr<r=r>rrrrbaaxbboxrTbt bbox_artistsrzr\r$r$r%r\sN+           z_AxesBase.get_tightbboxcOsd|vrd|vr|d|ur|d|urtd|}|r/|jddj|g|Ri|}n|jddj|dg|Ri|dtgd|ji}|d |d | |j |j |||S) zrr$r$r%get_shared_x_axes6z_AxesBase.get_shared_x_axescCrT)z6Return an immutable view on the shared y-axes Grouper.rrUrr$r$r%get_shared_y_axes:rXz_AxesBase.get_shared_y_axescCs |jd|d|jd|ddS)a Only show "outer" labels and tick labels. x-labels are only kept for subplots on the last row (or first row, if labels are on the top side); y-labels only for subplots on the first column (or last column, if labels are on the right side). Parameters ---------- remove_inner_ticks : bool, default: False If True, remove the inner ticks as well (not only tick labels). .. versionadded:: 3.8 F)skip_non_rectangular_axesremove_inner_ticksN)_label_outer_xaxis_label_outer_yaxis)r r[r$r$r% label_outer>s  z_AxesBase.label_outer)r[cC|r t|jtjjs dS|}|sdS|j}|sK|dkr&| d|r,ddini}|jj d ddd||jj ddkrK|jj d|s|dkrX| d|r^ddini}|jj d ddd||jj dd kr|jj ddSdSdS) NrrFr)rrrRr)rrrr$)rrr^r9rrWrr[ is_first_rowrrr]rZr is_last_row)r rZr[rIlabel_positiontop_kw bottom_kwr$r$r%r\R@    z_AxesBase._label_outer_xaxiscCr_) NrrFr)rrrr)rrrRr$)rrr^r9rrWrr[ is_first_colrrr]rZr is_last_col)r rZr[rIrbleft_kwright_kwr$r$r%r]mrez_AxesBase._label_outer_yaxiscCr)a Set how pan/zoom events are forwarded to Axes below this one. Parameters ---------- forward : bool or "auto" Possible values: - True: Forward events to other axes with lower or equal zorder. - False: Events are only executed on this axes. - "auto": Default behaviour (*True* for axes with an invisible patch and *False* otherwise) See Also -------- matplotlib.axes.Axes.set_navigate Nr)r forwardr$r$r%set_forward_navigation_eventss z'_AxesBase.set_forward_navigation_eventscCrV)z=Get how pan/zoom events are forwarded to Axes below this one.rjrr$r$r%get_forward_navigation_eventsrXz'_AxesBase.get_forward_navigation_eventsr()rqN)rF)r)Nrr)NNF)T)TTr*)TrN)NTT)Nrr)rN)rNFF)r0r/r1r;rr>rrr@r8rDrF__annotations__rr_rapropertyrrr&r:rArGrUrWrr[r]r!rrorprvrgrrrrrrrrZrrYrrrrrrrrrr&r6rr$r+r4r6r8r9r:r;r<rrrqr@rNrOrIrWrrXrJrTrrrrrrrrget_xgridlinesget_xticklinesget_ygridlinesget_yticklinesrrrrrrrrrrrrrrrr0rrrrrrr+r,rrrsetterrrr"r$r%r'r(r0rmr_rallow_rasterizationrsruryrzr{r}r$r interpdrrrr1rrrrrrr[rorrrrPr+ get_xticksrget_xmajorticklabelsget_xminorticklabelsget_xticklabelsset_xticklabelsrrrrr\rmrrrQr, get_yticksrget_ymajorticklabelsget_yminorticklabelsget_yticklabelsset_yticklabels xaxis_date yaxis_daterrrrrrrrr)rr*rrrrr r!r0r1r2rr3r;r\rKrrrWrYr^r\r]rlrm __classcell__r$r$r4r%r%s       )        $         E         L H 1 % . %          0 ( =      R  -G F  '* N )R  3  "  N         3  " N                   P -  >     W     rcCsGddd}||||S)a A helper function for rasterizing the list of artists. The bookkeeping to track if we are or are not in rasterizing mode with the mixed-mode backends is relatively complicated and is now handled in the matplotlib.artist.allow_rasterization decorator. This helper defines the absolute minimum methods and attributes on a shim class to be compatible with that decorator and then uses it to rasterize the list of artists. This is maybe too-clever, but allows us to reuse the same code that is used on normal artists to participate in the "are we rasterizing" accounting. Please do not use this outside of the "rasterize below a given zorder" functionality of Axes. Parameters ---------- figure : matplotlib.figure.Figure The figure all of the artists belong to (not checked). We need this because we can at the figure level suppress composition and insert each rasterized artist as its own image. artists : List[matplotlib.artist.Artist] The list of Artists to be rasterized. These are assumed to all be in the same Figure. renderer : matplotlib.backendbases.RendererBase The currently active renderer Returns ------- None c@s<eZdZddZddZddZd dd Zejd d Z d S)z(_draw_rasterized.._MinimalArtistcSr)NTr$rr$r$r%get_rasterizedz7_draw_rasterized.._MinimalArtist.get_rasterizedcSsdSr(r$rr$r$r%get_agg_filterrz7_draw_rasterized.._MinimalArtist.get_agg_filtercSs||_||_dSr()figurer+)r rr+r$r$r%r&s z1_draw_rasterized.._MinimalArtist.__init__FcSs|r |jjddS|jS)NTrB)rrH)r rCr$r$r%rHsz3_draw_rasterized.._MinimalArtist.get_figurecSs|jD]}||qdSr()r+rs)r rKrzr$r$r%rss  z-_draw_rasterized.._MinimalArtist.drawNrn) r0r/r1rrr&rHrrvrsr$r$r$r%_MinimalArtists r)rs)rr+rKrr$r$r%rks&rk)Pcollections.abcrr contextlibrrrloggingnumbersroperatorrr\rnumpyr matplotlibr^rrr r matplotlib.artistrrmatplotlib.axisrrmatplotlib.cbookr r r matplotlib.collectionsr4r,matplotlib.colorscolorsrUmatplotlib.font_managerrmatplotlib.gridspecrmatplotlib.imagerr.matplotlib.linesr8rXmatplotlib.patchesr9rmatplotlib.rcsetuprrmatplotlib.spinesr rmatplotlib.tabletabler1matplotlib.textrrmatplotlib.tickertickerrmatplotlib.transforms transformsrD getLoggerr0rkrr=rhridefine_aliasesArtistrrkr$r$r$r%s                  =S[