o li(@snddlZddlZddlmZmZddlmZddl m Z m Z ddl m Z Gddde ZdZejjeddS) N)_api _docstring) _AxesBase_TransformedBoundsLocator)AxiscseZdZdZfddZddZddZdfd d Ze e j dd d d dZ ddZ fddZ ddZddZddZddZZS) SecondaryAxisz4 General class to hold a Secondary_X/Yaxis. c sFtjddg|d||_||_||_d|_|jdkr8tj|jjgdfi||j |_ ddg|_ dd g|_ ntj|jjgd fi||j |_ d dg|_ ddg|_ d |_|||||jdkrj|j n|j }|t|d |j|j d|j|j d |jdkr|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. xy) orientationF)r?-C6?topbottomleftright)rr r r NnoneTg?r)r check_in_list _functions_parent _orientation _ticks_setsuper__init__figurexaxis_axis _locstrings _otherstringsyaxis _parentscale set_location set_functionsset_major_locatormticker NullLocatorset_ticks_positionspines set_visible_pos set_alignment)selfparentr location functionskwargs otheraxis __class__]/home/ubuntu/SoloSpeech/.venv/lib/python3.10/site-packages/matplotlib/axes/_secondary_axes.pyrs2         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 : {'top', 'bottom', 'left', 'right'} Either 'top' or 'bottom' for orientation='x' or 'left' or 'right' for orientation='y' axis. )alignr NrrTF)rrrr(r)rr'set_label_position)r,r6r4r4r5r+9s  zSecondaryAxis.set_alignmentcCst|trtj|j|d|dvrdnd|_nt|tjr!||_ntd|jdd|jdd |||_ |j d krDd|jdd g}n|jdd dg}| t ||j jd 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). )r.)rrr gzlocation must be rz, r z, or a float, not rg|=N) isinstancestrrrrr*numbersReal ValueError_locrset_axes_locatorrr transAxes)r,r.boundsr4r4r5r"Ls&    zSecondaryAxis.set_locationNcs|t|dSN) _set_limsr apply_aspect)r,positionr2r4r5rCvszSecondaryAxis.apply_aspectF)minorcKs*|jj||fd|i|}d|_d|_|S)NrET)r set_ticksstaler)r,tickslabelsrEr0retr4r4r5rF{szSecondaryAxis.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. rr NcSs|SrAr4)rr4r4r5sz-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)r8tuplelencallablerr< _set_scale)r,r/r4r4r5r#s   zSecondaryAxis.set_functionscs ||t|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)rBrPrdraw)r,rendererr2r4r5rQs zSecondaryAxis.drawcCs|jdkr|jj}|j}n |jj}|j}||jkrdS|jr'|j }||dkr.dnd|j dddd|jrE|j t |||_dS)z3 Check if parent has set its scale rNlog functionlogfunctionr)r/)rrr get_scale set_xscaler set_yscaler!rr get_ticklocsrr$r% FixedLocator)r,pscale set_scalerHr4r4r5rPs      zSecondaryAxis._set_scalecCs|jdkr|j}|j}n|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. rrr Nr) rrget_xlimset_xlimget_ylimset_ylimrnparray)r,limsset_limorderneworderr4r4r5rBs    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)r warn_external)r,argsr0r4r4r5 set_aspectszSecondaryAxis.set_aspectcCs|jdkr#|jd|d|jj||jj||jj|dS|jd|d|jj||jj ||j j|dS)z Change the color of the secondary axes and all decorators. Parameters ---------- color : color r)axiscolorsr N) r tick_paramsr(r set_colorrrlabelrrr )r,colorr4r4r5rms zSecondaryAxis.set_colorrA)__name__ __module__ __qualname____doc__rr+r"rCrcopyrrFr#rQrPrBrirm __classcell__r4r4r2r5r s )*  ra 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. Both functions must accept numpy arrays as input. 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)r:numpyra matplotlibrrmatplotlib.tickertickerr%matplotlib.axes._baserrmatplotlib.axisrrrvinterpdupdater4r4r4r5s  p%