a
    APÎjEt  ã                   @   s¨   d Z ddlZddlZddlmZ ddlZddlZddlm	Z	m
Z
mZ ddlmZ e e¡ZG dd„ dƒZG dd	„ d	eƒZG d
d„ deƒZG dd„ dƒZG dd„ dƒZdS )aÓ  
:mod:`~matplotlib.gridspec` contains classes that help to layout multiple
`~.axes.Axes` in a grid-like pattern within a figure.

The `GridSpec` specifies the overall grid structure. Individual cells within
the grid are referenced by `SubplotSpec`\s.

Often, users need not access this module directly, and can use higher-level
methods like `~.pyplot.subplots`, `~.pyplot.subplot_mosaic` and
`~.Figure.subfigures`. See the tutorial :ref:`arranging_axes` for a guide.
é    N)ÚIntegral)Ú_apiÚ_pylab_helpersÚ_tight_layout)ÚBboxc                   @   s®   e Zd ZdZd'dd„Zdd„ Zedd„ d	d
�Zedd„ dd
�Zdd„ Z	d(dd„Z
d)dd„Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zedd„ ƒZd d!„ Zd"d"d#dd$œd%d&„ZdS )*ÚGridSpecBasezm
    A base class of GridSpec that specifies the geometry of the grid
    that a subplot will be placed.
    Nc                 C   sf   t |tƒr|dkr td|›�ƒ‚t |tƒr2|dkr@td|›�ƒ‚|| | _| _|  |¡ |  |¡ dS )aŸ  
        Parameters
        ----------
        nrows, ncols : int
            The number of rows and columns of the grid.
        width_ratios : array-like of length *ncols*, optional
            Defines the relative widths of the columns. Each column gets a
            relative width of ``width_ratios[i] / sum(width_ratios)``.
            If not given, all columns will have the same width.
        height_ratios : array-like of length *nrows*, optional
            Defines the relative heights of the rows. Each row gets a
            relative height of ``height_ratios[i] / sum(height_ratios)``.
            If not given, all rows will have the same height.
        r   z/Number of rows must be a positive integer, not z2Number of columns must be a positive integer, not N)Ú
isinstancer   Ú
ValueErrorÚ_nrowsÚ_ncolsÚset_height_ratiosÚset_width_ratios)ÚselfÚnrowsÚncolsÚheight_ratiosÚwidth_ratios© r   úc/mounts/lovelace/software/anaconda3/envs/metadmg/lib/python3.9/site-packages/matplotlib/gridspec.pyÚ__init__    s    ÿÿ
zGridSpecBase.__init__c                 C   sb   t t| jƒƒdkrd| j›�nd}t t| jƒƒdkr@d| j›�nd}dj| jj| j| j|| d�S )Né   z, height_ratios=Ú z, width_ratios=z&{clsname}({nrows}, {ncols}{optionals}))Zclsnamer   r   Ú	optionals)	ÚlenÚsetÚ_row_height_ratiosÚ_col_width_ratiosÚformatÚ	__class__Ú__name__r
   r   )r   Z
height_argZ	width_argr   r   r   Ú__repr__9   s    ÿÿÿÿüzGridSpecBase.__repr__c                 C   s   | j S ©N)r
   ©r   r   r   r   Ú<lambda>E   ó    zGridSpecBase.<lambda>zThe number of rows in the grid.)Údocc                 C   s   | j S r!   )r   r"   r   r   r   r#   G   r$   z"The number of columns in the grid.c                 C   s   | j | jfS )zW
        Return a tuple containing the number of rows and columns in the grid.
        )r
   r   r"   r   r   r   Úget_geometryJ   s    zGridSpecBase.get_geometryc                 C   s   d S r!   r   )r   Úfigurer   r   r   Úget_subplot_paramsP   s    zGridSpecBase.get_subplot_paramsr   c                 C   s(   |\}}| ||| …||| …f }|S )a[  
        Create and return a `.SubplotSpec` instance.

        Parameters
        ----------
        loc : (int, int)
            The position of the subplot in the grid as
            ``(row_index, column_index)``.
        rowspan, colspan : int, default: 1
            The number of rows and columns the subplot should span in the grid.
        r   )r   ÚlocÚrowspanÚcolspanZloc1Zloc2Zsubplotspecr   r   r   Únew_subplotspecT   s    zGridSpecBase.new_subplotspecc                 C   s6   |du rdg| j  }nt|ƒ| j kr,tdƒ‚|| _dS )zÂ
        Set the relative widths of the columns.

        *width_ratios* must be of length *ncols*. Each column gets a relative
        width of ``width_ratios[i] / sum(width_ratios)``.
        Nr   zTExpected the given number of width ratios to match the number of columns of the grid)r   r   r	   r   )r   r   r   r   r   r   d   s
    zGridSpecBase.set_width_ratiosc                 C   s   | j S )zo
        Return the width ratios.

        This is *None* if no width ratios have been set explicitly.
        )r   r"   r   r   r   Úget_width_ratiosr   s    zGridSpecBase.get_width_ratiosc                 C   s6   |du rdg| j  }nt|ƒ| j kr,tdƒ‚|| _dS )zÁ
        Set the relative heights of the rows.

        *height_ratios* must be of length *nrows*. Each row gets a relative
        height of ``height_ratios[i] / sum(height_ratios)``.
        Nr   zRExpected the given number of height ratios to match the number of rows of the grid)r
   r   r	   r   )r   r   r   r   r   r   z   s
    zGridSpecBase.set_height_ratiosc                 C   s   | j S )zq
        Return the height ratios.

        This is *None* if no height ratios have been set explicitly.
        )r   r"   r   r   r   Úget_height_ratiosˆ   s    zGridSpecBase.get_height_ratiosc                    sV  |   ¡ \}}|  |¡}|j}|j}|j}|j}|j}	|j}
|| }|| }|||
|d    }|
| }|| t| j	ƒ ‰ ‡ fdd„| j	D ƒ}dg|g|d   }t
 t
 ||g¡j¡}|||	|d    }|	| }|| t| jƒ ‰ ‡ fdd„| jD ƒ}dg|g|d   }t
 t
 ||g¡j¡}||  d¡j\}}||  d¡j\}}||||fS )aì  
        Return the positions of the grid cells in figure coordinates.

        Parameters
        ----------
        fig : `~matplotlib.figure.Figure`
            The figure the grid should be applied to. The subplot parameters
            (margins and spacing between subplots) are taken from *fig*.

        Returns
        -------
        bottoms, tops, lefts, rights : array
            The bottom, top, left, right positions of the grid cells in
            figure coordinates.
        r   c                    s   g | ]}|ˆ  ‘qS r   r   ©Ú.0Úr©Znormr   r   Ú
<listcomp>¯   r$   z3GridSpecBase.get_grid_positions.<locals>.<listcomp>r   c                    s   g | ]}|ˆ  ‘qS r   r   r/   r2   r   r   r3   ·   r$   )éÿÿÿÿé   )r&   r(   ÚleftÚrightÚbottomÚtopÚwspaceÚhspaceÚsumr   ÚnpZcumsumZcolumn_stackÚflatr   ZreshapeÚT)r   Zfigr   r   Zsubplot_paramsr6   r7   r8   r9   r:   r;   Z	tot_widthZ
tot_heightZcell_hZsep_hZcell_heightsZsep_heightsZcell_hsZcell_wZsep_wZcell_widthsZ
sep_widthsZcell_wsÚfig_topsÚfig_bottomsÚ	fig_leftsÚ
fig_rightsr   r2   r   Úget_grid_positions�   s2    
zGridSpecBase.get_grid_positionsc                 C   sZ   |   ¡ D ]B}| ¡ }|durt|dƒr2| ¡  ¡ }| ¡ ||fkr|  S qt||| d�S )zo
        Check if the figure already has a gridspec with these dimensions,
        or create a new one
        NÚget_topmost_subplotspec©r'   )Zget_axesÚget_gridspecÚhasattrrE   r&   ÚGridSpec)r'   r   r   ÚaxÚgsr   r   r   Ú_check_gridspec_exists¿   s    

z#GridSpecBase._check_gridspec_existsc           
   
   C   s¤   |   ¡ \}}dd„ }t|tƒr„z|\}}W n. tyX } ztdƒ|‚W Y d}~n
d}~0 0 t |||dƒ|||dƒg||f¡\}}	n|||| dƒ\}}	t| ||	ƒS )z,Create and return a `.SubplotSpec` instance.c                 S   s¨   | }t | tƒr<|  |¡\}}}||kr2||d fS tdƒ‚nh| dk rL| | } d|   kr`|k rln n| | fS |d ur�td|› d|› d|› �ƒ‚ntd|› d|› �ƒ‚d S )Nr   z=GridSpec slice would result in no space allocated for subplotr   zindex z is out of bounds for axis z with size z) is out of bounds for GridSpec with size )r   ÚsliceÚindicesÚ
IndexError)ÚkeyÚsizeZaxisÚorig_keyÚstartÚstopÚ_r   r   r   Ú
_normalizeØ   s&    


ÿÿ

ÿz,GridSpecBase.__getitem__.<locals>._normalizezUnrecognized subplot specNr   r   )r&   r   Útupler	   r=   Zravel_multi_indexÚSubplotSpec)
r   rP   r   r   rV   Zk1Zk2ÚerrÚnum1Únum2r   r   r   Ú__getitem__Ô   s    
 þ
zGridSpecBase.__getitem__FT)ÚsharexÚshareyÚsqueezeÚ
subplot_kwc                C   sn  | j }|du rtdƒ‚t|tƒs,|r(dnd}t|tƒsB|r>dnd}tjg d¢||d� |du rbi }| ¡ }tj| j	| j
ftd�}t| j	ƒD ]p}t| j
ƒD ]`}d|d ||d	f |d	|f d
œ}	|	| |d< |	| |d< |j| ||f fi |¤Ž|||f< q˜qŠ|dv �r |jD ]}
|
jdd� �q|dv �rD|jD ]}
|
jdd� �q0|�rf|jdk�r^| ¡ S | ¡ S |S dS )z‘
        Add all subplots specified by this `GridSpec` to its parent figure.

        See `.Figure.subplots` for detailed documentation.
        NzIGridSpec.subplots() only works for GridSpecs created with a parent figureÚallÚnone)ra   ÚrowÚcolrb   FT)r]   r^   )Zdtype)r   r   r   )rb   ra   rc   rd   r]   r^   )rd   ra   T)Zskip_non_rectangular_axes)rc   ra   r   )r'   r	   r   Ústrr   Zcheck_in_listÚcopyr=   Úemptyr
   r   ÚobjectÚrangeZadd_subplotr>   Z_label_outer_xaxisZ_label_outer_yaxisrQ   Úitemr_   )r   r]   r^   r_   r`   r'   Zaxarrrc   rd   Zshared_withrJ   r   r   r   Úsubplotsù   sF    


ÿÿ
ÿÿ



zGridSpecBase.subplots)NN)N)r   r   )r   Ú
__module__Ú__qualname__Ú__doc__r   r    Úpropertyr   r   r&   r(   r,   r   r-   r   r.   rD   ÚstaticmethodrL   r\   rk   r   r   r   r   r      s.   
ÿÿ

/
%ÿr   c                	       sN   e Zd ZdZd‡ fdd„	Zg d¢Zdd„ Zddd	„Zd
d„ Zddd„Z	‡  Z
S )rI   a  
    A grid layout to place subplots within a figure.

    The location of the grid cells is determined in a similar way to
    `.SubplotParams` using *left*, *right*, *top*, *bottom*, *wspace*
    and *hspace*.

    Indexing a GridSpec instance returns a `.SubplotSpec`.
    Nc                    sB   || _ || _|| _|| _|| _|	| _|| _tƒ j|||
|d� dS )að  
        Parameters
        ----------
        nrows, ncols : int
            The number of rows and columns of the grid.

        figure : `.Figure`, optional
            Only used for constrained layout to create a proper layoutgrid.

        left, right, top, bottom : float, optional
            Extent of the subplots as a fraction of figure width or height.
            Left cannot be larger than right, and bottom cannot be larger than
            top. If not given, the values will be inferred from a figure or
            rcParams at draw time. See also `GridSpec.get_subplot_params`.

        wspace : float, optional
            The amount of width reserved for space between subplots,
            expressed as a fraction of the average axis width.
            If not given, the values will be inferred from a figure or
            rcParams when necessary. See also `GridSpec.get_subplot_params`.

        hspace : float, optional
            The amount of height reserved for space between subplots,
            expressed as a fraction of the average axis height.
            If not given, the values will be inferred from a figure or
            rcParams when necessary. See also `GridSpec.get_subplot_params`.

        width_ratios : array-like of length *ncols*, optional
            Defines the relative widths of the columns. Each column gets a
            relative width of ``width_ratios[i] / sum(width_ratios)``.
            If not given, all columns will have the same width.

        height_ratios : array-like of length *nrows*, optional
            Defines the relative heights of the rows. Each row gets a
            relative height of ``height_ratios[i] / sum(height_ratios)``.
            If not given, all rows will have the same height.

        ©r   r   N)	r6   r8   r7   r9   r:   r;   r'   Úsuperr   )r   r   r   r'   r6   r8   r7   r9   r:   r;   r   r   ©r   r   r   r   9  s    *
þzGridSpec.__init__©r6   r8   r7   r9   r:   r;   c                 K   s˜   |  ¡ D ].\}}|| jv r(t| ||ƒ qt|› d�ƒ‚qtjj ¡ D ]N}|jj	j
D ]>}| ¡ durR| ¡  ¡ }| ¡ | krR| | ¡  |j	¡¡ qRqDdS )a  
        Update the subplot parameters of the grid.

        Parameters that are not explicitly given are not changed. Setting a
        parameter to *None* resets it to :rc:`figure.subplot.*`.

        Parameters
        ----------
        left, right, top, bottom : float or None, optional
            Extent of the subplots as a fraction of figure width or height.
        wspace, hspace : float, optional
            Spacing between the subplots as a fraction of the average subplot
            width / height.
        z is an unknown keywordN)ÚitemsÚ_AllowedKeysÚsetattrÚAttributeErrorr   ZGcfZfigsÚvaluesZcanvasr'   ÚaxesZget_subplotspecrE   rG   Z_set_positionÚget_position)r   ÚkwargsÚkÚvZ
figmanagerrJ   Ússr   r   r   Úupdateq  s    
ÿzGridSpec.updatec                    sX   |du r(dd„ ˆ j D ƒ}tf i |¤Ž}nt |j¡}|jf i ‡ fdd„ˆ j D ƒ¤Ž |S )a:  
        Return the `.SubplotParams` for the GridSpec.

        In order of precedence the values are taken from

        - non-*None* attributes of the GridSpec
        - the provided *figure*
        - :rc:`figure.subplot.*`

        Note that the ``figure`` attribute of the GridSpec is always ignored.
        Nc                 S   s   i | ]}|t jd |  “qS )úfigure.subplot.)ÚmplÚrcParams©r0   r}   r   r   r   Ú
<dictcomp>š  s   ÿz/GridSpec.get_subplot_params.<locals>.<dictcomp>c                    s   i | ]}|t ˆ |ƒ“qS r   ©Úgetattrr„   r"   r   r   r…      r$   )rv   ÚSubplotParamsrf   Úsubplotparsr€   )r   r'   Úkwr‰   r   r"   r   r(   �  s    ÿ zGridSpec.get_subplot_paramsc                    s   ‡ fdd„ˆ j D ƒS )z¯
        Return a list of the names of the subplot parameters explicitly set
        in the GridSpec.

        This is a subset of the attributes of `.SubplotParams`.
        c                    s   g | ]}t ˆ |ƒr|‘qS r   r†   r„   r"   r   r   r3   «  r$   z<GridSpec.locally_modified_subplot_params.<locals>.<listcomp>)rv   r"   r   r"   r   Úlocally_modified_subplot_params¤  s    z(GridSpec.locally_modified_subplot_paramsçHáz®Gñ?c              
   C   sP   |du r|  ¡ }tj||jtj|j| d�|||||d�}|rL| jf i |¤Ž dS )a  
        Adjust subplot parameters to give specified padding.

        Parameters
        ----------
        figure : `.Figure`
            The figure.
        renderer :  `.RendererBase` subclass, optional
            The renderer to be used.
        pad : float
            Padding between the figure edge and the edges of subplots, as a
            fraction of the font-size.
        h_pad, w_pad : float, optional
            Padding (height/width) between edges of adjacent subplots.
            Defaults to *pad*.
        rect : tuple (left, bottom, right, top), default: None
            (left, bottom, right, top) rectangle in normalized figure
            coordinates that the whole subplots area (including labels) will
            fit into. Default (None) is the whole figure.
        N)Z	grid_spec)ÚpadÚh_padÚw_padÚrect)Z_get_rendererr   Zget_tight_layout_figurerz   Zget_subplotspec_listr€   )r   r'   Úrendererr�   rŽ   r�   r�   r|   r   r   r   Útight_layout­  s    
ýzGridSpec.tight_layout)	NNNNNNNNN)N)NrŒ   NNN)r   rl   rm   rn   r   rv   r€   r(   r‹   r’   Ú__classcell__r   r   rs   r   rI   /  s   	    ý6
	  ÿrI   c                       s4   e Zd ZdZd	‡ fdd„	Zd
dd„Zdd„ Z‡  ZS )ÚGridSpecFromSubplotSpeczx
    GridSpec whose subplot layout parameters are inherited from the
    location specified by a given SubplotSpec.
    Nc                    sL   || _ || _t|tƒr|| _ntdƒ‚| j ¡ j| _tƒ j	||||d� dS )ak  
        Parameters
        ----------
        nrows, ncols : int
            Number of rows and number of columns of the grid.
        subplot_spec : SubplotSpec
            Spec from which the layout parameters are inherited.
        wspace, hspace : float, optional
            See `GridSpec` for more details. If not specified default values
            (from the figure or rcParams) are used.
        height_ratios : array-like of length *nrows*, optional
            See `GridSpecBase` for details.
        width_ratios : array-like of length *ncols*, optional
            See `GridSpecBase` for details.
        zVsubplot_spec must be type SubplotSpec, usually from GridSpec, or axes.get_subplotspec.rq   N)
Ú_wspaceÚ_hspacer   rX   Ú_subplot_specÚ	TypeErrorrG   r'   rr   r   )r   r   r   Zsubplot_specr:   r;   r   r   rs   r   r   r   Ò  s    
ÿ
þz GridSpecFromSubplotSpec.__init__c           	      C   s‚   | j dur| j n|dur |jjntjd }| jdur:| jn|durJ|jjntjd }| j |¡}|j	\}}}}t
||||||d�S )z1Return a dictionary of subplot layout parameters.Nzfigure.subplot.hspacezfigure.subplot.wspace)r6   r7   r8   r9   r:   r;   )r–   r‰   r;   r‚   rƒ   r•   r:   r—   r{   Zextentsrˆ   )	r   r'   r;   r:   Zfigboxr6   r8   r7   r9   r   r   r   r(   ò  s    þþþz*GridSpecFromSubplotSpec.get_subplot_paramsc                 C   s
   | j  ¡ S )zY
        Return the topmost `.SubplotSpec` instance associated with the subplot.
        )r—   rE   r"   r   r   r   rE     s    z/GridSpecFromSubplotSpec.get_topmost_subplotspec)NNNN)N)r   rl   rm   rn   r   r(   rE   r“   r   r   rs   r   r”   Í  s     ý 
r”   c                   @   s¸   e Zd ZdZd&dd„Zdd„ Zedd„ ƒZed	d
„ ƒZ	e	j
dd
„ ƒZ	dd„ Zdd„ Zedd„ ƒZedd„ ƒZdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zd d!„ Zd"d#„ Zd$d%„ ZdS )'rX   a]  
    The location of a subplot in a `GridSpec`.

    .. note::

        Likely, you will never instantiate a `SubplotSpec` yourself. Instead,
        you will typically obtain one from a `GridSpec` using item-access.

    Parameters
    ----------
    gridspec : `~matplotlib.gridspec.GridSpec`
        The GridSpec, which the subplot is referencing.
    num1, num2 : int
        The subplot will occupy the *num1*-th cell of the given
        *gridspec*.  If *num2* is provided, the subplot will span between
        *num1*-th cell and *num2*-th cell **inclusive**.

        The index starts from 0.
    Nc                 C   s   || _ || _|| _d S r!   )Ú	_gridspecrZ   r[   )r   ÚgridspecrZ   r[   r   r   r   r     s    zSubplotSpec.__init__c              
   C   s6   |   ¡ › d| jj› d| jj› d| jj› d| jj› d�
S )Nú[ú:z, ú])rG   r*   rS   rT   r+   r"   r   r   r   r    "  s    
ÿÿþþzSubplotSpec.__repr__c           	      C   s`  t |ƒdkrv|\}t|tƒr |S t|tƒs8td|›�ƒ‚zttt|ƒƒ\}}}W q¢ tyr   td|›�ƒd‚Y q¢0 n,t |ƒdkrŽ|\}}}ntj	ddt |ƒd�‚t
 | ||¡}|du rÆt
||| d�}t|tƒ�rt |ƒd	k�rtd
d„ |D ƒƒ�std|› �ƒ‚|\}}nDt|tƒ�r0|dk �s0||| k�rHtd|| › d|›�ƒ‚| }}||d |… S )zÂ
        Construct a `.SubplotSpec` from a parent `.Figure` and either

        - a `.SubplotSpec` -- returned as is;
        - one or three numbers -- a MATLAB-style subplot specifier.
        r   z>Single argument to subplot must be a three-digit integer, not Né   Zsubplotz1 or 3)ZtakesÚgivenrF   r5   c                 s   s   | ]}t |tƒV  qd S r!   )r   r   )r0   Únr   r   r   Ú	<genexpr>F  r$   z1SubplotSpec._from_subplot_args.<locals>.<genexpr>z3Subplot specifier tuple must contain integers, not z(num must be an integer with 1 <= num <= z, not )r   r   rX   r   r	   ÚmapÚintre   r   Znargs_errorrI   rL   rW   ra   )	r'   ÚargsÚargÚrowsÚcolsÚnumrK   ÚiÚjr   r   r   Ú_from_subplot_args'  sP    

ÿÿÿÿþ
ÿ
$ÿÿzSubplotSpec._from_subplot_argsc                 C   s   | j d u r| jS | j S r!   )Ú_num2rZ   r"   r   r   r   r[   W  s    zSubplotSpec.num2c                 C   s
   || _ d S r!   )r¬   )r   Úvaluer   r   r   r[   [  s    c                 C   s   | j S r!   )r™   r"   r   r   r   rG   _  s    zSubplotSpec.get_gridspecc                 C   s    |   ¡  ¡ \}}||| j| jfS )a  
        Return the subplot geometry as tuple ``(n_rows, n_cols, start, stop)``.

        The indices *start* and *stop* define the range of the subplot within
        the `GridSpec`. *stop* is inclusive (i.e. for a single cell
        ``start == stop``).
        )rG   r&   rZ   r[   )r   r¦   r§   r   r   r   r&   b  s    zSubplotSpec.get_geometryc                 C   s$   |   ¡ j}t| j| | j| d ƒS )z6The rows spanned by this subplot, as a `range` object.r   )rG   r   ri   rZ   r[   )r   r   r   r   r   r*   m  s    
zSubplotSpec.rowspanc                 C   s4   |   ¡ j}t| j| | j| gƒ\}}t||d ƒS )z9The columns spanned by this subplot, as a `range` object.r   )rG   r   ÚsortedrZ   r[   ri   )r   r   Úc1Úc2r   r   r   r+   s  s    
zSubplotSpec.colspanc                 C   s   | j jdkS ©Nr   )r*   rS   r"   r   r   r   Úis_first_row|  s    zSubplotSpec.is_first_rowc                 C   s   | j j|  ¡ jkS r!   )r*   rT   rG   r   r"   r   r   r   Úis_last_row  s    zSubplotSpec.is_last_rowc                 C   s   | j jdkS r±   )r+   rS   r"   r   r   r   Úis_first_col‚  s    zSubplotSpec.is_first_colc                 C   s   | j j|  ¡ jkS r!   )r+   rT   rG   r   r"   r   r   r   Úis_last_col…  s    zSubplotSpec.is_last_colc                 C   s‚   |   ¡ }| ¡ \}}t | j| jg||f¡\}}| |¡\}}}	}
||  ¡ }||  ¡ }|	|  ¡ }|
|  ¡ }t	 
||||¡S )zJ
        Update the subplot position from ``figure.subplotpars``.
        )rG   r&   r=   Zunravel_indexrZ   r[   rD   ÚminÚmaxr   Zfrom_extents)r   r'   rš   r   r   r¦   r§   rA   r@   rB   rC   Z
fig_bottomZfig_topZfig_leftZ	fig_rightr   r   r   r{   ˆ  s    ÿ
zSubplotSpec.get_positionc                 C   s"   |   ¡ }t|dƒr| ¡ S | S dS )zX
        Return the topmost `SubplotSpec` instance associated with the subplot.
        rE   N)rG   rH   rE   )r   rš   r   r   r   rE   ˜  s    
z#SubplotSpec.get_topmost_subplotspecc                 C   s8   | j | j| jft|dtƒ ƒt|dtƒ ƒt|dtƒ ƒfkS )z}
        Two SubplotSpecs are considered equal if they refer to the same
        position(s) in the same `GridSpec`.
        r™   rZ   r[   )r™   rZ   r[   r‡   rh   )r   Úotherr   r   r   Ú__eq__¢  s    þÿzSubplotSpec.__eq__c                 C   s   t | j| j| jfƒS r!   )Úhashr™   rZ   r[   r"   r   r   r   Ú__hash__­  s    zSubplotSpec.__hash__c                 K   s   t ||| fi |¤ŽS )aÑ  
        Create a GridSpec within this subplot.

        The created `.GridSpecFromSubplotSpec` will have this `SubplotSpec` as
        a parent.

        Parameters
        ----------
        nrows : int
            Number of rows in grid.

        ncols : int
            Number of columns in grid.

        Returns
        -------
        `.GridSpecFromSubplotSpec`

        Other Parameters
        ----------------
        **kwargs
            All other parameters are passed to `.GridSpecFromSubplotSpec`.

        See Also
        --------
        matplotlib.pyplot.subplots

        Examples
        --------
        Adding three subplots in the space occupied by a single subplot::

            fig = plt.figure()
            gs0 = fig.add_gridspec(3, 1)
            ax1 = fig.add_subplot(gs0[0])
            ax2 = fig.add_subplot(gs0[1])
            gssub = gs0[2].subgridspec(1, 3)
            for i in range(3):
                fig.add_subplot(gssub[0, i])
        )r”   )r   r   r   r|   r   r   r   Úsubgridspec°  s    (zSubplotSpec.subgridspec)N)r   rl   rm   rn   r   r    rp   r«   ro   r[   ÚsetterrG   r&   r*   r+   r²   r³   r´   rµ   r{   rE   r¹   r»   r¼   r   r   r   r   rX   	  s0   

/




rX   c                   @   s$   e Zd ZdZddd„Zddd„ZdS )	rˆ   zM
    Parameters defining the positioning of a subplots grid in a figure.
    Nc                 C   s:   dD ]}t | |tjd|› � ƒ q|  ||||||¡ dS )au  
        Defaults are given by :rc:`figure.subplot.[name]`.

        Parameters
        ----------
        left : float
            The position of the left edge of the subplots,
            as a fraction of the figure width.
        right : float
            The position of the right edge of the subplots,
            as a fraction of the figure width.
        bottom : float
            The position of the bottom edge of the subplots,
            as a fraction of the figure height.
        top : float
            The position of the top edge of the subplots,
            as a fraction of the figure height.
        wspace : float
            The width of the padding between subplots,
            as a fraction of the average Axes width.
        hspace : float
            The height of the padding between subplots,
            as a fraction of the average Axes height.
        rt   r�   N)rw   r‚   rƒ   r€   )r   r6   r8   r7   r9   r:   r;   rP   r   r   r   r   à  s    zSubplotParams.__init__c                 C   s°   |dur|n| j |dur|n| jkr,tdƒ‚|dur8|n| j|durH|n| jkrXtdƒ‚|durf|| _ |durt|| _|dur‚|| _|dur�|| _|durž|| _|dur¬|| _dS )zY
        Update the dimensions of the passed parameters. *None* means unchanged.
        Nzleft cannot be >= rightzbottom cannot be >= top)r6   r7   r	   r8   r9   r:   r;   )r   r6   r8   r7   r9   r:   r;   r   r   r   r€   þ  s(    ÿÿzSubplotParams.update)NNNNNN)NNNNNN)r   rl   rm   rn   r   r€   r   r   r   r   rˆ   Û  s     ÿ
  ÿrˆ   )rn   rf   ÚloggingÚnumbersr   Únumpyr=   Z
matplotlibr‚   r   r   r   Zmatplotlib.transformsr   Ú	getLoggerr   Ú_logr   rI   r”   rX   rˆ   r   r   r   r   Ú<module>   s"   
   < S