G8c|)ddlZddlmZmZddlmZddlm Z m Z ddl m Z Gdde Z dZejj!ey) N)_api _docstring) _AxesBase_TransformedBoundsLocator)AxisceZdZdZfdZdZdZdfd Zeje jddddZ d Z fd Z d Zd Zd ZdZxZS) SecondaryAxisz4 General class to hold a Secondary_X/Yaxis. c ||_||_||_d|_|jdk(rKt ||jj gdfi||j|_ddg|_ ddg|_ nY|jdk(rJt ||jj gd fi||j|_ddg|_ ddg|_ d |_ |j||j||jdk(r |j}n |j}|jt!j"|j%d |j&|jj)d|j&|jj)d |j*d kr|jd d d|_ |j-|jdy )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)rr rr NnoneTg?r) _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)selfparent orientationlocation functionskwargs otheraxis __class__s A/usr/lib/python3/dist-packages/matplotlib/axes/_secondary_axes.pyrzSecondaryAxis.__init__s$ '    # G T\\002D O ODJ %x0D "('!2D    # % G T\\002D O ODJ '0D "'!2D   (# 9%    # I I##G$7$7$9:$$V, D&&'33E: D$$%11$7 99s?#//"5D  4++A./ctj|j|||jdk(r|jddd|_|j|jdj d|j|jdj d|j j ||j j|y)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. )alignr NrrTF)r check_in_listrr)r*rr(set_label_position)r-r8s r5r,zSecondaryAxis.set_alignment;s 4++59 D$$Q' '#//"5D  D$$Q'(44T: D$$Q'(44U; %%e, %%e,r6ct|trF|dvrd|_nA|dvrd|_n5td|jdd|jdd |||_||_|j d k(rd|jdd g}n|jdd dg}|jt||jjy ) 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). )rrr )rrgzlocation must be rz, r z, or a float, not r g|=N) isinstancestrr+ ValueErrorr_locrset_axes_locatorrr transAxes)r-r0boundss r5r#zSecondaryAxis.set_locationNs h $++ //  '(8(8(;'>b''*--?|MNN!DI    #B.FiiE1-F  %fdll.D.D E Gr6cD|jt| |yN) _set_limsr apply_aspect)r-positionr4s r5rFzSecondaryAxis.apply_aspectys  X&r6F)minorc b|jj||fd|i|}d|_d|_|S)NrHT)r set_ticksstaler)r-tickslabelsrHr2rets r5rJzSecondaryAxis.set_ticks~s7"djj""5&HHH  r6ct|tr2t|dk(r$t|drt|dr||_n| ddf|_n t d|j y)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 Nc|SrDr s r5z-SecondaryAxis.set_functions..sr6c|SrDrRrSs r5rTz-SecondaryAxis.set_functions..sar6zfunctions 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)r<tuplelencallablerr> _set_scale)r-r1s r5r$zSecondaryAxis.set_functionssl" y% (S^q-@1&8IaL+A(DO  *K8DO@A A r6cd|j|jt| |i|y)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)rErYrdraw)r-argsr2r4s r5r[zSecondaryAxis.draws*    d%f%r6c6|jdk(r0|jjj}|j}|jdk(r0|jj j}|j }|jk(ry|dk(rd}nd}|jr|jj}||jddd|jr.|jjtj||_y) z3 Check if parent has set its scale r rNlog functionlogfunctionr)r1)rrr get_scale set_xscaler! set_yscaler"rr get_ticklocsrr%r& FixedLocator)r-pscale set_scaledefscalerLs r5rYzSecondaryAxis._set_scales    #\\''113FI    #\\''113FI T&& &  U?$H!H ??JJ++-E (doodd&;< ?? JJ ( ()=)=e)D E#r6c~|jdk(r&|jj}|j}|jdk(r&|jj }|j }d|dk}|j dtj|}|d|dk}||k7r|ddd}|y)z Set the limits based on parent limits and the convert method between the parent and this secondary axes. r rrr Nr) rrget_xlimset_xlimget_ylimset_ylimrnparray)r-limsset_limorderneworders r5rEzSecondaryAxis._set_limss    #<<((*DmmG    #<<((*DmmGQ$q'!!tq!"((4.17T!W$ u ":D r6c.tjdy)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-r\r2s r5 set_aspectzSecondaryAxis.set_aspects FGr6c,|jdk(r|jd||jjj ||jj j ||j jj |y|jd||jjj ||jjj ||jjj |y)z Change the color of the secondary axes and all decorators. Parameters ---------- color : color r )axiscolorsrN) r tick_paramsr)r set_colorrrlabelrrr!)r-colors r5r{zSecondaryAxis.set_colors    #   #e  4 KK   ( ( / KKOO % %e , JJ   & &u -   #e  4 KK   & &u - KK   ' ' . JJ   & &u -r6rD)__name__ __module__ __qualname____doc__rr,r#rFrcopyrrJr$r[rYrErvr{ __classcell__)r4s@r5r r sj+0Z-&)GV' Z__T^^$U% B &#B&H.r6r a 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)numpyrn matplotlibrrmatplotlib.tickertickerr&matplotlib.axes._baserrmatplotlib.axisrr rinterpdupdaterRr6r5rsF'#F w.Iw.t$J +;