o i04@srddlZddlmZddlmZddlmZddl m Z ddl m Z ddZGddde ZdZejjeddS) N) _AxesBasecstjj|fdd}|S)a  Helper function to locate the secondary axes. A locator gets used in `Axes.set_aspect` to override the default locations... It is a function that takes an axes object and a renderer and tells `set_aspect` where it is to be placed. This locator make the transform be in axes-relative co-coordinates because that is how we specify the "location" of the secondary axes. Here *rect* is a rectangle [l, b, w, h] that specifies the location for the axes in the transform given by *trans* on the *parent*. cs*tj}jj}t||}|SN) mtransformsTransformedBbox transAxesfigure transFigureinverted)axrendererbbtr_rectparentZ/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/matplotlib/axes/_secondary_axes.pysecondary_locators  z2_make_secondary_locator..secondary_locator)rBbox from_bounds)rectrrrrr_make_secondary_locator s rcseZdZdZfddZddZddZd fd d Ze d d d!ddZ ddZ fddZ ddZ ddZddZd"ddZd"ddZddZZS)# SecondaryAxisz4 General class to hold a Secondary_X/Yaxis. c s`||_||_||_d|_|jdkr/tj|jjgdfi||j|_ddg|_ ddg|_ n"|jdkrQtj|jjgd fi||j |_ddg|_ ddg|_ d |_ d |_ d |_|||||jdkrm|j }n|j}|t|d |j D] }|j|dq|j D] }|j|d q|jd kr|j d d d|_ ||j dd S)z See `.secondary_xaxis` and `.secondary_yaxis` for the doc string. While there is no need for this to be private, it should really be called by those higher level functions. Fx)r?-C6?topbottomleftrighty)rrrrNnoneTg?r) _functions_parent _orientation _ticks_setsuper__init__rxaxis_axis _locstrings _otherstringsyaxis _parentscale _layoutbox _poslayoutbox set_location set_functionsset_major_locatormticker NullLocatorset_ticks_positionspines set_visible_pos set_alignment)selfr orientationlocation functionskwargs otheraxisst __class__rrr)*s>             zSecondaryAxis.__init__cCsxtj|j|d||jdkr|jddd|_|j|jdd|j|jdd|j||j|dS)a Set if axes spine and labels are drawn at top or bottom (or left/right) of the axes. Parameters ---------- align : str either 'top' or 'bottom' for orientation='x' or 'left' or 'right' for orientation='y' axis. )alignrNr#rTF)cbook_check_in_listr,r8r9r+r7set_label_position)r<rErrrr;[s  zSecondaryAxis.set_alignmentcCst|tr(|dvr d|_n|dvrd|_ntd|jdd|jdd |||_||_|jd kr;d|jdd g}n|jdd dg}t||j}| |d S) a+ Set the vertical or horizontal location of the axes in parent-normalized coordinates. Parameters ---------- location : {'top', 'bottom', 'left', 'right'} or float The position to put the secondary axis. Strings can be 'top' or 'bottom' for orientation='x' and 'right' or 'left' for orientation='y'. A float indicates the relative position on the parent axes to put the new axes, 0.0 being the bottom (or left) and 1.0 being the top (or right). )rr r)rrgzlocation must be rz, rz, or a float, not rg|=N) isinstancestrr: ValueErrorr,_locr&rr%set_axes_locator)r<r>boundsrrrrr2ns&   zSecondaryAxis.set_locationNcs|t|dSr) _set_limsr( apply_aspect)r<positionrCrrrPszSecondaryAxis.apply_aspectz3.2minorFcCs |jj||d}d|_d|_|S)a  Set the x ticks with list of *ticks* Parameters ---------- ticks : list List of x-axis tick locations. minor : bool, default: False If ``False`` sets major ticks, if ``True`` sets minor ticks. )rRT)r+ set_ticksstaler')r<ticksrRretrrrrSs zSecondaryAxis.set_tickscCsft|trt|dkrt|drt|dr||_n|dur)ddddf|_ntd|dS)a& Set how the secondary axis converts limits from the parent axes. Parameters ---------- functions : 2-tuple of func, or `Transform` with an inverse. Transform between the parent axis values and the secondary axis values. If supplied as a 2-tuple of functions, the first function is the forward transform function and the second is the inverse transform. If a transform is supplied, then the transform must have an inverse. rrNcSs|Srr)rrrrsz-SecondaryAxis.set_functions..zfunctions argument of secondary axes must be a two-tuple of callable functions with the first function being the transform and the second being the inverse)rItuplelencallabler$rK _set_scale)r<r?rrrr3s   zSecondaryAxis.set_functionscs&||tj|i|dS)z Draw the secondary axes. Consults the parent axes for its limits and converts them using the converter specified by `~.axes._secondary_axes.set_functions` (or *functions* parameter when axes initialized.) N)rOr\r(drawr<argsr@rCrrr]s zSecondaryAxis.drawcCs|jdkr|jj}|j}|jdkr|jj}|j}||jkr#dS|dkr*d}nd}|jr4|j }|||j dddd|jrL|j t |||_dS) z3 Check if parent has set its scale rr!Nlog functionlogfunctionr#)r?)r&r%r* get_scale set_xscaler. set_yscaler/r'r+ get_ticklocsr$r4r5 FixedLocator)r<pscale set_scaledefscalerUrrrr\s"       zSecondaryAxis._set_scalecCs|jdkr |j}|j}|jdkr|j}|j}|d|dk}|jdt|}|d|dk}||kr?|ddd}||dS)z Set the limits based on parent limits and the convert method between the parent and this secondary axes. rr!rrNr#) r&r%get_xlimset_xlimget_ylimset_ylimr$nparray)r<limsset_limorderneworderrrrrOs     zSecondaryAxis._set_limscOstddS)zj Secondary axes cannot set the aspect ratio, so calling this just sets a warning. z)Secondary axes can't set the aspect ratioN)rF_warn_externalr^rrr set_aspectszSecondaryAxis.set_aspectcK&|dur||j_|jj||fi|S)a Set the label for the x-axis. Parameters ---------- xlabel : str The label text. labelpad : float, default: ``self.xaxis.labelpad`` Spacing in points between the label and the x-axis. Other Parameters ---------------- **kwargs : `.Text` properties `.Text` properties control the appearance of the label. See Also -------- text : Documents the properties supported by `.Text`. N)r*labelpadset_label_text)r<xlabelfontdictrxr@rrr set_xlabelzSecondaryAxis.set_xlabelcKrw)a Set the label for the y-axis. Parameters ---------- ylabel : str The label text. labelpad : float, default: ``self.yaxis.labelpad`` Spacing in points between the label and the y-axis. Other Parameters ---------------- **kwargs : `.Text` properties `.Text` properties control the appearance of the label. See Also -------- text : Documents the properties supported by `.Text`. N)r.rxry)r<ylabelr{rxr@rrr set_ylabel1r}zSecondaryAxis.set_ylabelcCs|jdkr%|jd|d|jd||jd||jj|dS|jd|d|jd||jd||jj|dS) z Change the color of the secondary axes and all decorators. Parameters ---------- color : color r)axiscolorsrrr!rr N)r& tick_paramsr8 set_colorr*labelr.)r<colorrrrrJs zSecondaryAxis.set_colorr)F)NN)__name__ __module__ __qualname____doc__r)r;r2rPrF_make_keyword_onlyrSr3r]r\rOrvr|rr __classcell__rrrCrr%s  1*   !!  rao Warnings -------- This method is experimental as of 3.1, and the API may change. Parameters ---------- location : {'top', 'bottom', 'left', 'right'} or float The position to put the secondary axis. Strings can be 'top' or 'bottom' for orientation='x' and 'right' or 'left' for orientation='y'. A float indicates the relative position on the parent axes to put the new axes, 0.0 being the bottom (or left) and 1.0 being the top (or right). functions : 2-tuple of func, or Transform with an inverse If a 2-tuple of functions, the user specifies the transform function and its inverse. i.e. ``functions=(lambda x: 2 / x, lambda x: 2 / x)`` would be an reciprocal transform with a factor of 2. The user can also directly supply a subclass of `.transforms.Transform` so long as it has an inverse. See :doc:`/gallery/subplots_axes_and_figures/secondary_axis` for examples of making these conversions. Returns ------- ax : axes._secondary_axes.SecondaryAxis Other Parameters ---------------- **kwargs : `~matplotlib.axes.Axes` properties. Other miscellaneous axes parameters. )_secax_docstring)numpyromatplotlib.cbookrFmatplotlib.docstring docstringmatplotlib.tickertickerr5matplotlib.transforms transformsrmatplotlib.axes._baserrrrinterpdupdaterrrrs     ;$