o
    ho.                     @   s~   d dl Z d dlZd dlmZmZmZ d dlmZ	 d dl
mZmZ d dlmZ d dlmZ G dd deZdZejjed	 dS )
    N)_api
_docstring
transforms)	_AxesBase_TransformedBoundsLocator)Axis)	Transformc                       s   e Zd ZdZd fdd	Zdd ZdddZd fd	d
	Ze	e
jdddddZdd Z fddZdd Zdd Zdd Zdd Z  ZS )SecondaryAxisz4
    General class to hold a Secondary_X/Yaxis.
    Nc           	         sN  t jddg|d || _|| _|| _d| _| jjdd}| jdkr=t j|g dfi | | j	| _
ddg| _d	d
g| _nt j|g dfi | | j| _
d
d	g| _ddg| _d| _| || | | | jdkrn| jn| j	}|t  |d | j| j d | j| j d | jdk r| jddd | _| | jd  d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.
        xy)orientationF)root)r         ?   -C6?topbottomleftright)r   r   r   r   NnoneTg      ?r   )r   check_in_list
_functions_parent_orientation
_ticks_set
get_figuresuper__init__xaxis_axis_locstrings_otherstringsyaxis_parentscaleset_locationset_functionsset_major_locatormtickerNullLocatorset_ticks_positionspinesset_visible_posset_alignment)	selfparentr   location	functions	transformkwargsfig	otheraxis	__class__ s/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/matplotlib/axes/_secondary_axes.pyr      s4   






zSecondaryAxis.__init__c                 C   sx   t j| j|d || jd kr| jddd | _| j| jd  d | j| jd  d | j| | j| dS )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   Nr   r   TF)r   r   r!   r+   r,   r    r*   set_label_position)r/   r;   r9   r9   r:   r.   <   s   zSecondaryAxis.set_alignmentc                 C   s   t jtjdf|d t|tr!t j| j|d |dv rdnd| _nt|t	j
r+|| _ntd| jd d	| jd
 d||| _| jdkrZd| jddg}|durYt| jj|}n| jddd
g}|durmt|| jj}|du ru| jj}| t|| 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).

        transform : `.Transform`, optional
            Transform for the location to use. Defaults to
            the parent's ``transAxes``, so locations are normally relative to
            the parent axes.

            .. versionadded:: 3.9
        N)r3   )r1   )r   r   r   g        zlocation must be r   z, r   z, or a float, not r
   g|=)r   check_isinstancer   r   
isinstancestrr   r!   r-   numbersReal
ValueError_locr   blended_transform_factoryr   	transAxesset_axes_locatorr   )r/   r1   r3   boundsr9   r9   r:   r%   O   s:   

zSecondaryAxis.set_locationc                    s   |    t | d S N)	_set_limsr   apply_aspect)r/   positionr7   r9   r:   rJ      s   zSecondaryAxis.apply_aspectF)minorc                K   s*   | j j||fd|i|}d| _d| _|S )NrL   T)r    	set_ticksstaler   )r/   tickslabelsrL   r4   retr9   r9   r:   rM      s   zSecondaryAxis.set_ticksc                    s   t  trt dkrt d rt d r | _n"t  tr+ j fddf| _n du r9dd dd f| _ntd|   dS )	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.
           r   r   c                    s      | S rH   )invertedr3   r
   r2   r9   r:   <lambda>   s    z-SecondaryAxis.set_functions.<locals>.<lambda>Nc                 S   s   | S rH   r9   rT   r9   r9   r:   rV      s    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)	r>   tuplelencallabler   r   r3   rB   
_set_scale)r/   r2   r9   rU   r:   r&      s   



zSecondaryAxis.set_functionsc                    s    |    |   t | dS )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)rI   rZ   r   draw)r/   rendererr7   r9   r:   r[      s   	zSecondaryAxis.drawc                 C   s   | j dkr| jj }| j}n	| jj }| j}|| jkrdS | jr'| j	
 }||dkr.dnd| jddd d | jrE| j	t| || _dS )z3
        Check if parent has set its scale
        r
   Nlogfunctionlogfunctionr   rU   )r   r   r   	get_scale
set_xscaler#   
set_yscaler$   r   r    get_ticklocsr   r'   r(   FixedLocator)r/   pscale	set_scalerO   r9   r9   r:   rZ      s   



zSecondaryAxis._set_scalec                 C   s   | j dkr| j }| j}n| j }| j}|d |d k }| jd t|}|d |d k }||kr;|ddd }|| dS )z
        Set the limits based on parent limits and the convert method
        between the parent and this secondary Axes.
        r
   r   r   Nr   )	r   r   get_xlimset_xlimget_ylimset_ylimr   nparray)r/   limsset_limorderneworderr9   r9   r:   rI      s   


zSecondaryAxis._set_limsc                 O   s   t d dS )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/   argsr4   r9   r9   r:   
set_aspect   s   zSecondaryAxis.set_aspectc                 C   sL   | j | j }|j|d | j D ]}|j|u r|| q|j| dS )z
        Change the color of the secondary Axes and all decorators.

        Parameters
        ----------
        color : :mpltype:`color`
        )colorsN)	_axis_mapr   set_tick_paramsr+   valuesaxis	set_colorlabel)r/   colorrx   spiner9   r9   r:   ry     s   

zSecondaryAxis.set_colorrH   )__name__
__module____qualname____doc__r   r.   r%   rJ   r   copyr   rM   r&   r[   rZ   rI   rs   ry   __classcell__r9   r9   r7   r:   r	      s    +
@
%r	   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.

transform : `.Transform`, optional
    If specified, *location* will be
    placed relative to this transform (in the direction of the axis)
    rather than the parent's axis. i.e. a secondary x-axis will
    use the provided y transform and the x transform of the parent.

    .. versionadded:: 3.9

Returns
-------
ax : axes._secondary_axes.SecondaryAxis

Other Parameters
----------------
**kwargs : `~matplotlib.axes.Axes` properties.
    Other miscellaneous Axes parameters.
)_secax_docstring)r@   numpyrk   
matplotlibr   r   r   matplotlib.tickertickerr(   matplotlib.axes._baser   r   matplotlib.axisr   matplotlib.transformsr   r	   r   interpdregisterr9   r9   r9   r:   <module>   s      -