OwlCyberSecurity - MANAGER
Edit File: _base.cpython-38.pyc
U ��]�m � @ s` d dl mZ d dlZd dlZd dlZd dlmZ d dlmZ d dl Z d dl Z d dl Z d dl mZmZ d dlmZmZmZmZ d dl mZ d dlmZ d dlmZ d dl m Z d dl m Z! d dl"m#Z$ d dl%m&Z' d dl(m)Z* d dl+m,Z- d dl.m/Z0 d dl1m2Z2 d dl3m4Z5 d dl6m7Z8 d dl9m:Z:m;Z; e�<e=�Z>d d � Z?G d d � d e@�ZAG d d� de!jB�ZCdS )� �� OrderedDictN)�Real)� attrgetter)�cbook�rcParams)� _OrderedSet� _check_1d�index_of� get_label)� docstring)�cycler�validate_axisbelowc C s� d}d}d}zXt �| �}ztt| ��}W n tk rH |||f Y W S X | |kr^|||fW S d}W n tk rx Y nX d}|t| �k �r�| | }| ||d � tjkr�|dk r�td| ��| ||d � }|d7 }q~|tjk�r|dk r�td| ��|}|d7 }q~|tjk�r6|dk �r(td| ��|}|d7 }q~|t � � k�rh|dk �rZtd| ��|}|d7 }q~|dk�r�|t| �d k �r�t| |d �}t �d � |��}|d7 }q~td | ��q~|dk�r�|dk�r�t d }|dk�r�d }|dk�r�d }|||fS ) a� Convert a MATLAB style color/line style format string to a (*linestyle*, *marker*, *color*) tuple. Example format strings include: * 'ko': black circles * '.b': blue dots * 'r--': red dashed lines * 'C2--': the third color in the color cycle, dashed lines See Also -------- matplotlib.Line2D.lineStyles, matplotlib.colors.cnames All possible styles and color format strings. Nr � z1Illegal format string "%s"; two linestyle symbols� z.Illegal format string "%s"; two marker symbolsz-Illegal format string "%s"; two color symbols�CzC{}z*Unrecognized character %c in format stringzlines.linestyle�None) �mcolorsZto_rgba�str�int� ValueError�len�mlinesZ lineStylesZ lineMarkersZget_named_colors_mapping�formatr )Zfmt� linestyle�marker�colorZfmtint�i�cZcolor_cycle_number� r �7/usr/lib/python3/dist-packages/matplotlib/axes/_base.py�_process_plot_format sv � � � � � r! c @ s� e Zd ZdZd dd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd � Zd d � Zd S )!�_process_plot_var_argsa3 Process variable length arguments to the plot command, so that plot commands like the following are supported:: plot(t, s) plot(t1, s1, t2, s2) plot(t1, s1, 'ko', t2, s2) plot(t1, s1, 'ko', t2, s2, 'r--', t3, e3) an arbitrary number of *x*, *y*, *fmt* are allowed �plotc C s || _ || _| �� d S �N)�axes�command�set_prop_cycle)�selfr% r& r r r �__init__� s z _process_plot_var_args.__init__c C s | j | jd�S )N�r% r& r* �r( r r r � __getstate__� s z#_process_plot_var_args.__getstate__c C s |� � | _| �� d S r$ )�copy�__dict__r' )r( �stater r r � __setstate__� s z#_process_plot_var_args.__setstate__c O sL |s|r t |�dkr*|d d kr*td }n t||�}t�|�| _|j| _d S )Nr r zaxes.prop_cycle)r r r � itertools�cycle� prop_cycler�keys� _prop_keys)r( �args�kwargsr3 r r r r' � s z%_process_plot_var_args.set_prop_cyclec / s, | j jd k r�| j jd k r�|�d| j jj�}| j jdkrB|�d|�}|| j jjkr^| j j�|� |�d| j jj�}| j jdkr�|�d|�}|| j jjkr�| j j�|� dD ] }||kr�td�| j |���q�|s�d S |�dd �� � d k �r fd d �|D �}t |�d k�r d }n�t |�d k�rzzt |d � W n t k �rD d }Y n4X |d |d k �rtt �d�|d �t� d }nd }n t |�dk�r�d }nt d��|�d�d k�r�t�|| || �|d< |}|�r(|d d � |d d � }}|�rt|d t��r||d f7 }|d d � }| �||�E d H �q�d S )N�xunits�polar� thetaunits�yunits�runitsZxyz*{} got an unexpected keyword argument {!r}�datac s g | ]}t �� |��qS r )�mplZ _replacer)�.0�arg�r= r r � <listcomp>� s z3_process_plot_var_args.__call__.<locals>.<listcomp>r r r z�Second argument {!r} is ambiguous: could be a color spec but is in data; using as data. Either rename the entry in data or use three arguments to plot.� zwUsing arbitrary long args with data is not supported due to ambiguity of arguments; use multiple plotting calls instead�label)r% �xaxis�yaxis�pop�units�name� set_units� TypeErrorr r& r r! r r �_warn_external�RuntimeWarning�getr> Z_label_from_arg� isinstancer � _plot_args) r( r6 r7 r8 r; Zpos_onlyZreplacedZlabel_namer_idx�thisr rA r �__call__� sn � ��� � z _process_plot_var_args.__call__c C s d| j krdS t| j�d S )z#Return the next color in the cycle.r �k)r5 �nextr3 r+ r r r �get_next_color� s z%_process_plot_var_args.get_next_colorc K s" | j dkstd��|jf |� d S )Nr# z$set_lineprops only works with "plot"�r& �AssertionError�set)r( �liner7 r r r � set_lineprops� s z$_process_plot_var_args.set_linepropsc K s" | j dkstd��|jf |� d S )N�fillz%set_patchprops only works with "fill"rV )r( Z fill_polyr7 r r r �set_patchprops� s z%_process_plot_var_args.set_patchpropsc C s� | j jd k r^| j jd k r^| j j�|�}| j j�|�}| jdkr^|rN| j �|�}|r^| j �|�}t|�}t|�}|jd |jd kr�t d� |j|j���|j dks�|j dkr�t d� |j|j���|j dkr�|d d �t j f }|j dkr�|d d �t j f }||fS )Nr# r zAx and y must have same first dimension, but have shapes {} and {}r z=x and y can be no greater than 2-D, but have shapes {} and {}r )r% rE rF � update_unitsr& �convert_xunits�convert_yunitsr �shaper r �ndim�npZnewaxis)r( �x�yZbxZbyr r r � _xy_from_xy� s2 � � z"_process_plot_var_args._xy_from_xyc sN | j | }t� fdd�|D ��rFt| j��� }|D ]}|�|d� q2ni }|S )a8 If some keys in the property cycle (excluding those in the set *ignore*) are absent or set to None in the dict *kw*, return a copy of the next entry in the property cycle, excluding keys in *ignore*. Otherwise, don't advance the property cycle, and return an empty dict. c 3 s | ]}� � |d �d kV qd S r$ �rN )r? rS ��kwr r � <genexpr>! s z6_process_plot_var_args._getdefaults.<locals>.<genexpr>N)r5 �anyrT r3 r- rG )r( �ignorerh Z prop_keys� default_dict�pr rg r � _getdefaults s z#_process_plot_var_args._getdefaultsc C s* |D ] }|� |d�dkr|| ||< qdS )zx Add to the dict *kw* the entries in the dict *default* that are absent or set to None in *kw*. Nrf )r( �defaultsrh rS r r r � _setdefaults+ s z#_process_plot_var_args._setdefaultsc C s6 ||�}| � t� |�}| �||� tj||f|�}|S r$ )rn rX rp r �Line2D)r( rc rd rh r7 rl �segr r r � _makeline4 s z _process_plot_var_args._makelinec C s� |� � }|� � }dddddh}|�� D ]\}}|d k r&|�|� q&| �||�}| �||� |�dd �} |�dd � | �||� tjt � ||f�| |�dd�|d d �} | j | f|� | S ) Nr Z markersizeZmarkeredgecolorZmarkerfacecolorZmarkeredgewidthr r[ T�closed)� facecolorr[ rt ) r- �items�addrn rp rN rG �mpatchesZPolygonrb Z column_stackr\ ) r( rc rd rh r7 ZignoresrS �vrl ru rr r r r � _makefill; s* � �z _process_plot_var_args._makefillc C s� g }t |�dkr>t|d t�r>t|d �\}}}|d d� }n t |�dkrTtd��n d\}}}tdd� |D ��rxtd��i }td |||f�D ]\}} | d k r�| ||< q�t |�d kr�t|d �} t|d �} nt|d �\} } | � | | �\} } | j d kr�| j } n|� d d�|d < | j } | jd | jd } }| dk�rV|dk�rV| |k�rVtjddd� tt| |��D ]>}| | d d �|| f | d d �|| f ||�}|�|� �qd|S )Nr ���rC z!third arg must be a format string)NNNc s s | ]}|d kV qd S r$ r )r? ry r r r ri x s z4_process_plot_var_args._plot_args.<locals>.<genexpr>z(x, y, and format string must not be None)r r r r r r# rt Tz2.2zGcycling among columns of inputs with non-matching shapes is deprecated.��message)r rO r r! r rj �zipr r re r& rs rN rz r` r �warn_deprecated�range�max�append)r( �tupr7 �retr r r rh rS ry rc rd �funcZncxZncy�jrr r r r rP k sD � �.z!_process_plot_var_args._plot_argsN)r# )�__name__� __module__� __qualname__�__doc__r) r, r0 r' rR rU rZ r\ re rn rp rs rz rP r r r r r" v s I( 0r" c s� e Zd ZdZe�� Ze�� Ze�� Zdd� Z �dPdd�Z � fd d �Z d d � Z d d� Z dd� Zdd� Zdd� Z�dQdd�Zdd� Zdd� Z�dRd d �Zd d � Zd d!� Zd"d#� Z�dSd%d&�Z�dTd(d)�Z�dUd*d+�Zd,d-� Zd.d/� Z d0d1� Z d2d3� Z d4d5� Z �dVd8d9�Z d:d;� Z!e�"d<�e#d=d>� ��Z$d?d@� Z%dAdB� Z&e&Z'dCdD� Z(e(Z)dEdF� Z*dGdH� Z+dIdJ� Z,�dWdKdL�Z-dMdN� Z.�dXdOdP�Z/dQdR� Z0�dYdSdT�Z1dUdV� Z2dWdX� Z3�dZdYdZ�Z4d[d\� Z5d]d^� Z6d_d`� Z7dadb� Z8dcdd� Z9dedf� Z:dgdh� Z;didj� Z<dkdl� Z=dmdn� Z>dodp� Z?dqdr� Z@dsdt� ZAdudv� ZBdwdx� ZC�d[dydz�ZDd{d|� ZEd}d~� ZFdd�� ZGd�d�� ZHd�d�� ZId�d�� ZJd�d�� ZKd�d�� ZLd�d�� ZM�d\d�d��ZN�d]d�d��ZO�d^d�d��ZPd�d�� ZQ�d_d�d��ZRd�d�� ZSd�d�� ZTd�d�� ZUd�d�� ZVd�d�� ZWd�d�� ZXd�d�� ZYe#d�d�� �ZZeZj[d�d�� �ZZd�d�� Z\d�d�� Z]dddd��d�d��Z^d�d�� Z_d�d�� Z`�d`d�d��Za�dad�d��Zbd�d�� Zcd�d�� Zdeejf�dbd�d���Zgd�d�� Zhd�d�� Zid�d Zjd�dĄ Zkd�dƄ Zld�dȄ Zmd�dʄ Zneojp�dcd�d̈́�Zqd'ddddddΜd�dЄZr�ddd�d҄Zs�ded�dԄZtd�dք Zud�d Zvd�dڄ Zwd�d܄ Zxd�dބ Zy�dfd�d�Zzd�d� Z{d�d� Z|�dgddd�d�d�Z}d�d� Z~d�d� Z�dhd�d�Z��did�d�Z�d�d� Z�d�d� Z��djd�d��Z��dkd�d��Z�d�d�� Z�d�d�� Z�d�d�� Z��dld�d��Z��d �d� Z��dmdd�d��d�d�Z��d�d� Z��d�d� Z��dn�d �d �Z��do�d �d �Z��d �d� Z��d�d� Z��dp�d�d�Z��dq�d�d�Z��dr�d�d�Z��ds�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+�d,� Z��d-�d.� Z��d/�d0� Z��d1�d2� Z��dt�d4�d5�Z��d6�d7� Z��d8�d9� Z��d:�d;� Z��d<�d=� Z��d>�d?� Z��d@�dA� Z��dB�dC� Z��du�dD�dE�Z��dF�dG� Z��dH�dI� Z��dJ�dK� Z��dL�dM� Z��dN�dO� Z�� Z�S (v � _AxesBaseZ rectilinearc C s d� t| �j| jj�S )Nz({0}({1[0]:g},{1[1]:g};{1[2]:g}x{1[3]:g}))r �typer� � _position�boundsr+ r r r �__str__� s �z_AxesBase.__str__NT� c s� t j�� � t|tj�r |� _ntjj|� � _� jjdk sF� jj dk rNt d��� j� � � _ � � _ d� _d� _d� _|� _|� _|dk r�� j�� |� |dk r�� j�� |� � �|� � �|� � �| �dd�� � �� � _� � � |dkr�t d }|� _ |� _ � � t d � d� _!i � _"� �#� d� _$d� _%� �&d � � �'d� |�rP� �(|� | �r`� �)| � � �*| � � j+dk �r�� j+j,�-d � fd d ��� _.� j/dk �r�� j/j,�-d � fdd ��� _0� j1t d �o�t d t d �o�t d t d �o�t d t d �o�t d t d �o t d t d �ot d t d �o*t d t d �o:t d dd � � j1t d �oVt d t d �oft d t d �ovt d t d �o�t d t d �o�t d t d �o�t d t d �o�t d t d �o�t d d!d � d� _2d� _3dS )"a Build an axes in a figure. Parameters ---------- fig : `~matplotlib.figure.Figure` The axes is build in the `.Figure` *fig*. rect : [left, bottom, width, height] The axes is build in the rectangle *rect*. *rect* is in `.Figure` coordinates. sharex, sharey : `~.axes.Axes`, optional The x or y `~.matplotlib.axis` is shared with the x or y axis in the input `~.axes.Axes`. frameon : bool, optional True means that the axes frame is visible. **kwargs Other optional keyword arguments: %(Axes)s Returns ------- axes : `~.axes.Axes` The new `~.axes.Axes` object. r z/Width and height specified must be non-negative�auto�boxr NZ axes_locatorzaxes.facecolorzaxes.axisbelowTzunits finalizec s � j dd�S )NT��scalex��_on_units_changedr r+ r r �<lambda> � z$_AxesBase.__init__.<locals>.<lambda>c s � j dd�S )NT��scaleyr� r r+ r r r� r� z xtick.topzxtick.minor.topz xtick.bottomzxtick.minor.bottomzxtick.labeltopzxtick.labelbottomz ytick.leftzytick.minor.leftz ytick.rightzytick.minor.rightzytick.labelleftzytick.labelright�minor) �top�bottom�labeltop� labelbottom�left�right� labelleft� labelright�whichzxtick.major.topzxtick.major.bottomzytick.major.leftzytick.major.right�major)4�martist�Artistr) rO � mtransforms�Bboxr� � from_bounds�width�heightr �frozen�_originalPositionr% �_aspect� _adjustable�_anchor�_sharex�_sharey�_shared_x_axes�join�_shared_y_axes� set_label� set_figure�set_axes_locatorrN �_gen_axes_spines�spines� _init_axisr � _facecolor�_frameon� set_axisbelow�_rasterization_zorderZ _connected�cla� fmt_xdata� fmt_ydata� set_navigate�set_navigate_mode� set_xscale� set_yscale�updaterE � callbacksZconnectZ_xcidrF Z_ycid� tick_params� _layoutbox� _poslayoutbox) r( �figZrectru Zframeon�sharex�shareyrD �xscale�yscaler7 r r+ r r) � s� ' � � � �z_AxesBase.__init__c sN t � �� }dD ] }d ||< qdD ](}t| |�}| |kr@|�| �nd ||< q |S )N)r� r� �r� r� � _twinned_axes)�superr, �getattr� get_siblings)r( r/ �key� grouper_nameZgrouper�� __class__r r r, ( s � �z_AxesBase.__getstate__c C s8 dD ]"}|� |�}|rt| |�j|� q|| _d| _d S )Nr� T)rG r� r� r. �_stale)r( r/ r� Zsiblingsr r r r0 6 s z_AxesBase.__setstate__c O s | j S )a� Return the axes bounding box in display space; *args* and *kwargs* are empty. This bounding box does not include the spines, ticks, ticklables, or other labels. For a bounding box including these elements use `~matplotlib.axes.Axes.get_tightbbox`. See Also -------- matplotlib.axes.Axes.get_tightbbox matplotlib.axis.Axis.get_tightbbox matplotlib.spines.get_window_extent )�bbox)r( r6 r7 r r r �get_window_extent@ s z_AxesBase.get_window_extentc C sl t �| �| _| jd �| j� | jd �| j� t �| �| _| jd �| j� | jd �| j� | �� dS )zAmove this out of __init__ because non-separable axes don't use itr� r� r� r� N)�maxisZXAxisrE r� Z register_axisZYAxisrF �_update_transScaler+ r r r r� R s z_AxesBase._init_axisc C sT t j�| |� t�| j|j�| _tj� � | _ tj� � | _ t� t�� �| _| �� dS )zt Set the `.Figure` for this `.Axes`. Parameters ---------- fig : `.Figure` N)r� r� r� r� �TransformedBboxr� Z transFigurer� r� �null�dataLimZunit�viewLim�TransformWrapper�IdentityTransform� transScale�_set_lim_and_transforms)r( r� r r r r� \ s � �z_AxesBase.set_figurec C sr t �| j�| _t �t �� �| _t �t �| j | j��| _ | j| j | j | _ t � | j | j�| _ t � | j| j �| _dS )a� Set the *_xaxis_transform*, *_yaxis_transform*, *transScale*, *transData*, *transLimits* and *transAxes* transformations. .. note:: This method is primarily used by rectilinear projections of the `~matplotlib.axes.Axes` class, and is meant to be overridden by new kinds of projection axes that need different transformations and limits. (See `~matplotlib.projections.polar.PolarAxes` for an example.) N)r� ZBboxTransformTor� � transAxesr� r� r� ZBboxTransformFromr� r� Z transLimits� transData�blended_transform_factory�_xaxis_transform�_yaxis_transformr+ r r r r� p s �� � �z!_AxesBase._set_lim_and_transforms�gridc C sF |dkr| j S |dkr$| jd �� S |dkr:| jd �� S td��dS )a� Get the transformation used for drawing x-axis labels, ticks and gridlines. The x-direction is in data coordinates and the y-direction is in axis coordinates. .. note:: This transformation is primarily used by the `~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. r� �tick1r� �tick2r� �unknown value for whichN)r� r� �get_spine_transformr �r( r� r r r �get_xaxis_transform� s z _AxesBase.get_xaxis_transformc C s4 t d }| jdd�t�dd| d | jj� d|fS )a Returns ------- transform : Transform The transform used for drawing x-axis labels, which will add *pad_points* of padding (in points) between the axes and the label. The x-direction is in data coordinates and the y-direction is in axis corrdinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. �xtick.alignmentr� �r� r r{ �H r� �r r� r� �ScaledTranslation�figure�dpi_scale_trans�r( Z pad_pointsZ labels_alignr r r �get_xaxis_text1_transform� s �� �z#_AxesBase.get_xaxis_text1_transformc C s0 t d }| jdd�t�d|d | jj� d|fS )a Returns ------- transform : Transform The transform used for drawing secondary x-axis labels, which will add *pad_points* of padding (in points) between the axes and the label. The x-direction is in data coordinates and the y-direction is in axis corrdinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. r� r� r� r r� r� r� r� r r r �get_xaxis_text2_transform� s �� �z#_AxesBase.get_xaxis_text2_transformc C sF |dkr| j S |dkr$| jd �� S |dkr:| jd �� S td��dS )a� Get the transformation used for drawing y-axis labels, ticks and gridlines. The x-direction is in axis coordinates and the y-direction is in data coordinates. .. note:: This transformation is primarily used by the `~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. r� r� r� r� r� r� N)r� r� r� r r� r r r �get_yaxis_transform� s z _AxesBase.get_yaxis_transformc C s4 t d }| jdd�t�d| d d| jj� |dfS )a Returns ------- transform : Transform The transform used for drawing y-axis labels, which will add *pad_points* of padding (in points) between the axes and the label. The x-direction is in axis coordinates and the y-direction is in data corrdinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. �ytick.alignmentr� r� r{ r� r r� �r r� r� r� r� r� r� r r r �get_yaxis_text1_transform� s �� �z#_AxesBase.get_yaxis_text1_transformc C s0 t d }| jdd�t�|d d| jj� |dfS )a Returns ------- transform : Transform The transform used for drawing secondart y-axis labels, which will add *pad_points* of padding (in points) between the axes and the label. The x-direction is in axis coordinates and the y-direction is in data corrdinates valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} The text vertical alignment. halign : {'center', 'left', 'right'} The text horizontal alignment. Notes ----- This transformation is primarily used by the `~matplotlib.axis.Axis` class, and is meant to be overridden by new kinds of projections that may need to place axis elements in different locations. r� r� r� r� r r� r r� r r r �get_yaxis_text2_transform s �� �z#_AxesBase.get_yaxis_text2_transformc C sZ | j �t�| j�� | j�� �� t| dg �D ](}z|j� � W q, t k rR Y q,X q,d S )N�lines) r� rX r� r� rE � get_transformrF r� Z_transformed_pathZ invalidate�AttributeError�r( rY r r r r� , s ��z _AxesBase._update_transScaleFc C s0 |r| j �� S | �� }|s"| �� | j�� S dS )ae Get a copy of the axes rectangle as a `.Bbox`. Parameters ---------- original : bool If ``True``, return the original position. Otherwise return the active position. For an explanation of the positions see `.set_position`. Returns ------- pos : `.Bbox` N)r� r� �get_axes_locator� apply_aspectr� )r( �original�locatorr r r � get_position6 s z_AxesBase.get_position�bothc C s | j ||d� d| _d| _dS )a� Set the axes position. Axes have two position attributes. The 'original' position is the position allocated for the Axes. The 'active' position is the position the Axes is actually drawn at. These positions are usually the same unless a fixed aspect is set to the Axes. See `.set_aspect` for details. Parameters ---------- pos : [left, bottom, width, height] or `~matplotlib.transforms.Bbox` The new position of the in `.Figure` coordinates. which : {'both', 'active', 'original'}, optional Determines which position variables to change. r� N)� _set_positionr� r� )r( �posr� r r r � set_positionN s z_AxesBase.set_positionc C s\ t |tj�stjj|� }| j�| �D ],}|dkr<|j�|� |dkr$|j �|� q$d| _ dS )z� private version of set_position. Call this internally to get the same functionality of `get_position`, but not to take the axis out of the constrained_layout hierarchy. )r �active)r r TN) rO r� �BboxBaser� r� r� r� r� rX r� �stale)r( r r� �axr r r r g s z_AxesBase._set_positionc C s0 | j �| �D ] }|jdd�}|j|dd� q dS )z� Reset the active position to the original position. This resets the a possible position change due to aspect constraints. For an explanation of the positions see `.set_position`. T�r r r� N)r� r� r r )r( r r r r r �reset_positionw s z_AxesBase.reset_positionc C s || _ d| _dS )z� Set the axes locator. Parameters ---------- locator : Callable[[Axes, Renderer], Bbox] TN)� _axes_locatorr )r( r r r r r� � s z_AxesBase.set_axes_locatorc C s | j S )z* Return the axes_locator. )r r+ r r r r � s z_AxesBase.get_axes_locatorc C s< |� | j� |�� s |�| j� | |_|jr8| j�|� dS )z3set the boilerplate props for artists added to axesN) r� r� Zis_transform_set� set_transformr� r% Z mouseover�_mouseover_setrw �r( �ar r r �_set_artist_props� s z_AxesBase._set_artist_propsc C s t �ddd�S )a� Returns ------- Patch The patch used to draw the background of the axes. It is also used as the clipping path for any data elements on the axes. In the standard axes, this is a rectangle, but in other projections it may not be. Notes ----- Intended to be overridden by new projection types. )� r � �?)rx � Rectangler+ r r r �_gen_axes_patch� s z_AxesBase._gen_axes_patchr �inchesc s t � fdd�dD ��S )a{ Returns ------- dict Mapping of spine names to `Line2D` or `Patch` instances that are used to draw axes spines. In the standard axes, spines are single line segments, but in other projections they may not be. Notes ----- Intended to be overridden by new projection types. c 3 s | ]}|t j�� |�fV qd S r$ )�mspinesZSpineZ linear_spine)r? Zsider+ r r ri � s �z-_AxesBase._gen_axes_spines.<locals>.<genexpr>)r� r� r� r� r )r( Z locations�offsetrH r r+ r r� � s �z_AxesBase._gen_axes_spinesc C s t | d�r| j�� }nd}| j�� }| j�� }| j�� | j�� | j�� D ]\}}|�� qLd| _t � � | _ | j dk r�| j jj | j_ | j jj| j_| j �� \}}| j||d| j �� d� | j jj| j_n2| j�d� z| �dd� W n tk r� Y nX | jdk �rZ| jjj | j_ | jjj| j_| j�� \}} | j|| d| j�� d� | jjj| j_n4| j�d� z| �dd� W n tk �r� Y nX td �r�| j�t� � � td �r�| j�t� � � | j dk�r�d| _ | jdk�r�d| _ td | _ td | _ d| _!d| _"| �#� t$| �| _%t$| d �| _&td | _'g | _(g | _)g | _*g | _+g | _,g | _-t.� | _/g | _0d| _1d| _2g | _3g | _4| �5d� | j5| j'td td d� t6j7td td d�} t8j9ddd| ddd�| _:t8j9ddd| �;� dd d�| _<t8j9ddd| �;� dd d�| _=td } | �>| � d| _?| j:| j<| j=fD ]} | �@| � �q*| �A� | _| j�B| jC� | j�D| jE� | j�Fd � | j�Gd� | j�H| jI� | �J� | j�K| j� | j�K| j� | jL�M� | jN�M� | j �r�| j�O|� | j�O|� | j�r | j�O|� | j�O|� d| _PdS ) zClear the current axes.�patchTNF��emitr� �linearr r zxtick.minor.visiblezytick.minor.visiblez axes.xmarginz axes.ymarginr[ z axes.gridzaxes.grid.whichzaxes.grid.axis)r� �axiszaxes.titlesizezaxes.titleweight)�sizeZweight� �?r r� Zbaseline�center)rc rd �textZfontpropertiesZverticalalignmentZhorizontalalignmentr r� r� z axes.titlepadr )Q�hasattrr# � get_visiblerE rF r� r� rv �ignore_existing_data_limitsr ZCallbackRegistryr� r� r� r� �get_xlim�set_xlim�get_autoscalex_on�_scale� _set_scalerK r� �get_ylim�set_ylim�get_autoscaley_onr �set_minor_locator�mticker�AutoMinorLocator� _autoscaleXon� _autoscaleYon�_xmargin�_ymargin�_tight�_use_sticky_edgesr� r" � _get_lines�_get_patches_for_fillZ_gridOnr �patches�texts�tables�artists�imagesr r � child_axes�_current_image�legend_� collections� containersr� � font_managerZFontProperties�mtextZText�titler- � _left_title� _right_title�_set_title_offset_trans� _autotitleposr r r� r� � set_facecolorr� Z set_edgecolorZ set_linewidthr r� � set_axis_on� set_clip_pathr� Zcleanr� � set_visibler ) r( Z patch_visibleZ xaxis_visibleZ yaxis_visiblerI �spine�x0�x1�y0�y1Zprops�title_offset_points�_titler r r r� � s� � � �� � � � z _AxesBase.claz3.0c C s t | j�S r$ )� frozensetr r+ r r r � mouseover_setR s z_AxesBase.mouseover_setc C s | � � dS )zClear the axes.N)r� r+ r r r �clearW s z_AxesBase.clearc C s | j �� S )z Get the facecolor of the Axes.)r# � get_facecolorr+ r r r ra [ s z_AxesBase.get_facecolorc C s || _ d| _| j�|�S )zm Set the facecolor of the Axes. Parameters ---------- color : color T)r� r r# rS )r( r r r r rS ` s z_AxesBase.set_facecolorc C sN t �d|d | jj�| _| j| j| jfD ] }|�| j | j � |� d� q(dS )z} Set the offset for the title either from rcParams['axes.titlepad'] or from set_title kwarg ``pad``. r r� N) r� r� r� r� ZtitleOffsetTransrN rO rP r r� Z set_clip_box)r( r\ r] r r r rQ m s �z!_AxesBase._set_title_offset_transc O sT |r|rt d��t|�dkr.|d dkr.d}n t||�}| j�|� | j�|� dS )at Set the property cycle of the Axes. The property cycle controls the style properties such as color, marker and linestyle of future plot commands. The style properties of data already added to the Axes are not modified. Call signatures:: set_prop_cycle(cycler) set_prop_cycle(label=values[, label2=values2[, ...]]) set_prop_cycle(label, values) Form 1 sets given `~cycler.Cycler` object. Form 2 creates a `~cycler.Cycler` which cycles over one or more properties simultaneously and set it as the property cycle of the axes. If multiple properties are given, their value lists must have the same length. This is just a shortcut for explicitly creating a cycler and passing it to the function, i.e. it's short for ``set_prop_cycle(cycler(label=values label2=values2, ...))``. Form 3 creates a `~cycler.Cycler` for a single property and set it as the property cycle of the axes. This form exists for compatibility with the original `cycler.cycler` interface. Its use is discouraged in favor of the kwarg form, i.e. ``set_prop_cycle(label=values)``. Parameters ---------- cycler : Cycler Set the given Cycler. *None* resets to the cycle defined by the current style. label : str The property key. Must be a valid `.Artist` property. For example, 'color' or 'linestyle'. Aliases are allowed, such as 'c' for 'color' and 'lw' for 'linewidth'. values : iterable Finite-length iterable of the property values. These values are validated and will raise a ValueError if invalid. Examples -------- Setting the property cycle for a single property: >>> ax.set_prop_cycle(color=['red', 'green', 'blue']) Setting the property cycle for simultaneously cycling over multiple properties (e.g. red circle, green plus, blue cross): >>> ax.set_prop_cycle(color=['red', 'green', 'blue'], ... marker=['o', '+', 'x']) See Also -------- matplotlib.rcsetup.cycler Convenience function for creating validated cyclers for properties. cycler.cycler The original function for creating unvalidated cyclers. zCCannot supply both positional and keyword arguments to this method.r r N)rK r r r@ r' rA )r( r6 r7 Z prop_cycler r r r' y s ? z_AxesBase.set_prop_cyclec C s | j S r$ )r� r+ r r r � get_aspect� s z_AxesBase.get_aspectc C s� t �|d�s t �|d�s t|�}t �|d�s>| jdkr>td��|r`t| j�| �| j�| � �}n| g}|D ] }||_ qj|dkr�| j }| j ||d� |dk r�| j ||d� d| _ dS )a Set the aspect of the axis scaling, i.e. the ratio of y-unit to x-unit. Parameters ---------- aspect : {'auto', 'equal'} or num Possible values: ======== ================================================ value description ======== ================================================ 'auto' automatic; fill the position rectangle with data 'equal' same scaling from data to plot units for x and y num a circle will be stretched such that the height is num times the width. aspect=1 is the same as aspect='equal'. ======== ================================================ adjustable : None or {'box', 'datalim'}, optional If not ``None``, this defines which parameter will be adjusted to meet the required aspect. See `.set_adjustable` for further details. anchor : None or str or 2-tuple of float, optional If not ``None``, this defines where the Axes will be drawn if there is extra space due to aspect constraints. The most common way to to specify the anchor are abbreviations of cardinal directions: ===== ===================== value description ===== ===================== 'C' centered 'SW' lower left corner 'S' middle of bottom edge 'SE' lower right corner etc. ===== ===================== See `.set_anchor` for further details. share : bool, optional If ``True``, apply the settings to all shared Axes. Default is ``False``. See Also -------- matplotlib.axes.Axes.set_adjustable defining the parameter to adjust in order to meet the required aspect. matplotlib.axes.Axes.set_anchor defining the position in case of extra space. �equalr� Z3dzBIt is not currently possible to manually set the aspect on 3D axesN)�shareT)r Z _str_equal�floatrI �NotImplementedErrorrX r� r� r� r� r� �set_adjustable� set_anchorr )r( �aspect� adjustable�anchorrd r% r r r r � set_aspect� s* 5 �� �z_AxesBase.set_aspectc C s | j S r$ )r� r+ r r r �get_adjustable s z_AxesBase.get_adjustablec C sT t jddg|d� |r4t| j�| �| j�| � �}n| g}|D ] }||_q>d| _dS )a� Define which parameter the Axes will change to achieve a given aspect. Parameters ---------- adjustable : {'box', 'datalim'} If 'box', change the physical dimensions of the Axes. If 'datalim', change the ``x`` or ``y`` data limits. share : bool, optional If ``True``, apply the settings to all shared Axes. Default is ``False``. See Also -------- matplotlib.axes.Axes.set_aspect for a description of aspect handling. Notes ----- Shared Axes (of which twinned Axes are a special case) impose restrictions on how aspect ratios can be imposed. For twinned Axes, use 'datalim'. For Axes that share both x and y, use 'box'. Otherwise, either 'datalim' or 'box' may be used. These limitations are partly a requirement to avoid over-specification, and partly a result of the particular implementation we are currently using, in which the adjustments for aspect ratios are done sequentially and independently on each Axes as it is drawn. r� �datalim�rj TN)r �_check_in_listrX r� r� r� r� r )r( rj rd r% r r r r rg s �z_AxesBase.set_adjustablec C s | j S )z� Get the anchor location. See Also -------- matplotlib.axes.Axes.set_anchor for a description of the anchor. matplotlib.axes.Axes.set_aspect for a description of aspect handling. )r� r+ r r r � get_anchorA s z_AxesBase.get_anchorc C sp |t jjks.t|�dks.tdd�t jj� ��|rPt| j�| �| j �| � �}n| g}|D ] }||_ qZd| _ dS )ak Define the anchor location. The actual drawing area (active position) of the Axes may be smaller than the Bbox (original position) when a fixed aspect is required. The anchor defines where the drawing area will be located within the available space. Parameters ---------- anchor : 2-tuple of floats or {'C', 'SW', 'S', 'SE', ...} The anchor position may be either: - a sequence (*cx*, *cy*). *cx* and *cy* may range from 0 to 1, where 0 is left or bottom and 1 is right or top. - a string using cardinal directions as abbreviation: - 'C' for centered - 'S' (south) for bottom-center - 'SW' (south west) for bottom-left - etc. Here is an overview of the possible positions: +------+------+------+ | 'NW' | 'N' | 'NE' | +------+------+------+ | 'W' | 'C' | 'E' | +------+------+------+ | 'SW' | 'S' | 'SE' | +------+------+------+ share : bool, optional If ``True``, apply the settings to all shared Axes. Default is ``False``. See Also -------- matplotlib.axes.Axes.set_aspect for a description of aspect handling. r zargument must be among %sz, TN) r� r� Zcoefsr r r� rX r� r� r� r� r )r( rk rd r% r r r r rh N s + � �z_AxesBase.set_anchorc C sD | � � \}}| �� \}}tt|| �d�}tt|| �d�}|| S )z� Return the aspect ratio of the raw data. Notes ----- This method is intended to be overridden by new projection types. ���KH�9)� get_xbound� get_yboundr� �abs�r( �xmin�xmax�ymin�ymax�xsize�ysizer r r �get_data_ratio� s z_AxesBase.get_data_ratioc C s\ | � � \}}| �� \}}ttt�|�t�|� �d�}ttt�|�t�|� �d�}|| S )z� Return the aspect ratio of the raw data in log scale. Notes ----- Will be used when both axis are in log scale. rr )rs rt r� ru �math�log10rv r r r �get_data_ratio_log� s z _AxesBase.get_data_ratio_logc 0 C s |dkr| j dd�}| �� }| jdkr�| �� | �� }}|dkrN|dkrNd}q�|dkrd|dkrdd}q�|dkrt|dks�|dkr�|dkr�|dkr�t�d||f � d}q�nd}|dkr�| j|d d � dS |d kr�d }n|}| �� � � \}}|| } | j d k�rd| | j k�rt d��|dk�r&|| � � } n || �� } |�� } | �| | | �} | �| �| �� | �d � dS | j|d d � | �� \} }| �� \}}|dk�r�t�| �t�|� } }t�|�t�|� }}tt|| �d�}tt|| �d�}|j\}}}}| || } | | }|| | d }t|�dk �r(dS |dk�rz| j}t�|j�t�|j � }t�|j �t�|j � }d| } d| } n| j}d|j } d|j } || } || } || } || }!|!| }"| | }#d}$d}%| | j!k}&| | j"k}'|&�r�|'�r�t d��|'�r d}(nN| |$k�r<| |%k�r<|#dk�r(|dk �p8|"dk �o8|dk})n|dk})|&�pL|)}(|(�r�d|| }*|*| d }+|*| d },|dk�r�| �#d|+ d|, f� n| �#|+|,f� nTd| | }-|-|!d }.|-|!d }/|dk�r�| �$d|. d|/ f� n| �$|.|/f� dS )aP Adjust the Axes for a specified data aspect ratio. Depending on `.get_adjustable` this will modify either the Axes box (position) or the view limits. In the former case, `.get_anchor` will affect the position. Notes ----- This is called automatically when each Axes is drawn. You may need to call it yourself if you need to update the Axes position and/or view limits before the Figure is drawn. See Also -------- matplotlib.axes.Axes.set_aspect for a description of aspect ratio handling. matplotlib.axes.Axes.set_adjustable defining the parameter to adjust in order to meet the required aspect. matplotlib.axes.Axes.set_anchor defining the position in case of extra space. NTr r9 r& �logr� z:aspect is not supported for Axes with xscale=%s, yscale=%sr r� rc r r� zJAdjustable 'box' is not allowed in a twinned Axes. Use 'datalim' instead.rr r g{�G�zt?g�������?r z>adjustable='datalim' is not allowed when both axes are shared.Fr) � @� $@)%r rb rI � get_xscale� get_yscaler rL r Z get_figureZget_size_inchesr� r� � RuntimeErrorr� r} r� Zshrunk_to_aspectZanchoredrq rs rt r~ r r� ru r� r� rY rX r[ rZ r� r� r� r� � set_ybound� set_xbound)0r( Zpositionri r� r� Zaspect_scale_mode�AZfigWZfigHZ fig_aspectZ box_aspectZpbZpb1rw rx ry rz r{ r| �l�b�w�hZ data_ratioZ y_expanderZdLZdL_widthZ dL_heightZxrZyrZxmargZymargZYsizeZXsizeZXmargZYmargZxmZymZshared_xZshared_yZadjust_yZadjyZycrZ r[ ZxcrX rY r r r r � s� ���� � z_AxesBase.apply_aspectc O s� t |�t |� kr dkrDn n$| �� \}}| �� \}}||||fS |�dd�}t |�dk�r2t|d t��r2|d �� }|dkr�| �� �n�|dkr�| �� �nl|dk�r|dkr�t j d d d � | � d� | � d � | j d d� |dkr�| j ddd� �q|dk�r"| j dddd� | � d � n�|dk�rD| j dd� | � d � n�|dk�rv| j dd� | � d � | j dddd� n�|dk�r| j dddd� | � d � | �� } | �� } tt�| �t�| ��} | j| d | d | g|d d� | j| d | d | g|d d� n td| ��| �� \}}| �� \}}||||fS z |d W n� tk �r� |�dd �}|�d d �}d } |d k�r�|d k�r�d } | j|||| d�\}}|�d d �}|�d d �}d } |d k�r�|d k�r�d } | j|||| d�\}}||||f Y S X |d } t| t��rF| �r| �� n| �� | �� \}}| �� \}}||||fS t | �d k�r\td!��| j| d | d g|d d� | j| d" | d# g|d d� | S )$a� Convenience method to get or set some axis properties. Call signatures:: xmin, xmax, ymin, ymax = axis() xmin, xmax, ymin, ymax = axis([xmin, xmax, ymin, ymax]) xmin, xmax, ymin, ymax = axis(option) xmin, xmax, ymin, ymax = axis(**kwargs) Parameters ---------- xmin, xmax, ymin, ymax : float, optional The axis limits to be set. Either none or all of the limits must be given. This can also be achieved using :: ax.set(xlim=(xmin, xmax), ylim=(ymin, ymax)) option : bool or str If a bool, turns axis lines and labels on or off. If a string, possible values are: ======== ========================================================== Value Description ======== ========================================================== 'on' Turn on axis lines and labels. Same as ``True``. 'off' Turn off axis lines and labels. Same as ``False``. 'equal' Set equal scaling (i.e., make circles circular) by changing axis limits. 'scaled' Set equal scaling (i.e., make circles circular) by changing dimensions of the plot box. 'tight' Set limits just large enough to show all data. 'auto' Automatic scaling (fill plot box with data). 'normal' Same as 'auto'; deprecated. 'image' 'scaled' with axis limits equal to data limits. 'square' Square plot; similar to 'scaled', but initially forcing ``xmax-xmin = ymax-ymin``. ======== ========================================================== emit : bool, optional, default *True* Whether observers are notified of the axis limit change. This option is passed on to `~.Axes.set_xlim` and `~.Axes.set_ylim`. Returns ------- xmin, xmax, ymin, ymax : float The axis limits. See also -------- matplotlib.axes.Axes.set_xlim matplotlib.axes.Axes.set_ylim r r% Tr ZonZoff)rc �tight�scaled�normalr� �image�squarer� z3.1zMPassing 'normal' to axis() is deprecated since %(since)s; use 'auto' instead.r| r� F)r� rc rn ro r� r� r )rj rk r� r� r� r$ z-Unrecognized string %s to axis; try on or offrw Nrx ry rz � z'args must contain [xmin xmax ymin ymax]r rC )r r/ r4 rN rO r �lowerrT � set_axis_offr r �set_autoscale_onrl �autoscale_viewr� rb Zdiffr0 r5 r � IndexError�bool)r( r6 r7 rw rx ry rz r% �sZxlimZylimZ edge_sizer� ry r r r r' = s� 8 � � �� z_AxesBase.axisc C s | j S )z>Return the `Legend` instance, or None if no legend is defined.)rI r+ r r r � get_legend� s z_AxesBase.get_legendc C s t �d| j�S )z2return a list of Axes images contained by the AxesZ AxesImage)r � silent_listrF r+ r r r � get_images� s z_AxesBase.get_imagesc C s t �d| j�S )z,Return a list of lines contained by the Axesrq )r r� r r+ r r r � get_lines� s z_AxesBase.get_linesc C s | j S )zReturn the XAxis instance.)rE r+ r r r � get_xaxis� s z_AxesBase.get_xaxisc C s t �d| j�� �S )z5Get the x grid lines as a list of `Line2D` instances.zLine2D xgridline)r r� rE � get_gridlinesr+ r r r �get_xgridlines� s �z_AxesBase.get_xgridlinesc C s t �d| j�� �S )z5Get the x tick lines as a list of `Line2D` instances.zLine2D xtickline)r r� rE � get_ticklinesr+ r r r �get_xticklines� s �z_AxesBase.get_xticklinesc C s | j S )zReturn the YAxis instance.)rF r+ r r r � get_yaxis� s z_AxesBase.get_yaxisc C s t �d| j�� �S )z5Get the y grid lines as a list of `Line2D` instances.zLine2D ygridline)r r� rF r� r+ r r r �get_ygridlines� s �z_AxesBase.get_ygridlinesc C s t �d| j�� �S )z5Get the y tick lines as a list of `Line2D` instances.zLine2D ytickline)r r� rF r� r+ r r r �get_yticklines� s �z_AxesBase.get_yticklinesc C sN t |tjj�r(|jd | jkrDtd��n || jkrD|| jkrDtd��|| _dS )z�Set the current image. This image will be the target of colormap functions like `~.pyplot.viridis`, and other functions such as `~.pyplot.clim`. The current image is an attribute of the current axes. r z"ContourSet must be in current AxeszAArgument must be an image, collection, or ContourSet in this AxesN)rO r> ZcontourZ ContourSetrJ r rF rH )r( Zimr r r �_sci� s z_AxesBase._scic C s | j S )zZ Helper for :func:`~matplotlib.pyplot.gci`; do not use elsewhere. )rH r+ r r r �_gci s z_AxesBase._gcic C s, t | j�t | j� t | j� t | j� dkS )z� Return *True* if any artists have been added to axes. This should not be used to determine whether the *dataLim* need to be updated, and may not actually be useful for anything. r )r rJ rF r rB r+ r r r �has_data s ����z_AxesBase.has_datac C s< | |_ | j�|� | jj|_| �|� |�| j� d| _|S )a� Add an `~.Artist` to the axes, and return the artist. Use `add_artist` only for artists for which there is no dedicated "add" method; and if necessary, use a method such as `update_datalim` to manually update the dataLim if the artist is to be included in autoscaling. If no ``transform`` has been specified when creating the artist (e.g. ``artist.get_transform() == None``) then the transform is set to ``ax.transData``. T) r% rE r� �remove�_remove_methodr rU r# r r r r r � add_artist s z_AxesBase.add_artistc C s. | |_ tj|_| j�|� | jj|_d| _|S )z� Add an `~.AxesBase` to the axes' children; return the child axes. This is the lowlevel version. See `.axes.Axes.inset_axes`. T) Z_axesr� Z_stale_axes_callbackZstale_callbackrG r� r� r� r )r( r r r r �add_child_axes0 s z_AxesBase.add_child_axesc C sx |� � }|s |�dt| j� � | j�|� | jj|_| �|� |�� dkrX|� | j � |rn| � |� | j �� d| _|S )zW Add a `~.Collection` to the axes' collections; return the collection. z _collection%dNT)r r� r rJ r� r� r� r � get_clip_pathrU r# �update_datalimZ get_datalimr� r )r( Z collectionZautolimrD r r r �add_collectionB s z_AxesBase.add_collectionc C sF | � |� |�� s&|�dt| j� � | j�|� | jj|_d| _|S )zM Add an `~.AxesImage` to the axes' images; return the image. z_image%dT) r r r� r rF r� r� r� r )r( r� r r r � add_imageV s z_AxesBase.add_imagec C s, |� � \}}}}| j�||f||ff� d S r$ )Z get_extentr% r� )r( r� rw rx ry rz r r r �_update_image_limitsb s z _AxesBase._update_image_limitsc C sh | � |� |�� dkr"|�| j� | �|� |�� sH|�dt| j� � | j� |� | jj |_ d| _ |S )zG Add a `~.Line2D` to the axes' lines; return the line. Nz_line%dT) r r� rU r# �_update_line_limitsr r� r r r� r� r� r r r r r �add_linef s z_AxesBase.add_linec C s* | � |� | j�|� | jj|_d| _|S )zE Add a `~.Text` to the axes' texts; return the text. T)r rC r� r� r� r )r( Ztxtr r r � _add_textv s z_AxesBase._add_textc C s� |� � }|jjdkrdS |�� }|| jkr0|}nRt|�| j��r~|| j }| jjrr|�� }|� � \}}|� |�}q�|� |�}n|}|jjdkr�|�| j�\} } | j j || j| | d� d| _dS )zV Figures out the data limit of the given line, updating self.dataLim. r N��updatex�updateyF)�get_path�verticesr( r r� rj �contains_branch_seperatelyZ is_affineZ_get_transformed_pathZ get_transformed_path_and_affineZtransform_path_affineZtransform_pathr� Zupdate_from_pathr. ) r( rY �pathZ line_transZ data_pathZ trans_to_dataZline_trans_pathZna_path�_r� r� r r r r� � s0 ��z _AxesBase._update_line_limitsc C sF | � |� |�� dkr"|�| j� | �|� | j�|� | jj|_|S )zI Add a `~.Patch` to the axes' patches; return the patch. N) r r� rU r# �_update_patch_limitsrB r� r� r� )r( rm r r r � add_patch� s z_AxesBase.add_patchc C s� t |tj�r |�� s |�� s dS |�� j}|jdkr�|�� � |�}|� � | j krh|� � | j }|� |�}|� � � | j �\}}| j|||d� dS )z$update the data limits for patch *p*Nr r� )rO rx r Z get_widthZ get_heightr� r� r( Zget_patch_transform� transformZget_data_transformr� r r� r� )r( r# r� �xysZ patch_to_datar� r� r r r r� � s( �� � ��z _AxesBase._update_patch_limitsc C s0 | � |� | j�|� |�| j� | jj|_|S )zH Add a `~.Table` to the axes' tables; return the table. )r rD r� rU r# r� r� )r( Ztabr r r � add_table� s z_AxesBase.add_tablec C s: |� � }|s |�dt| j� � | j�|� | jj|_|S )zT Add a `~.Container` to the axes' containers; return the container. z _container%d)r r� r rK r� r� r� )r( Z containerrD r r r � add_container� s z_AxesBase.add_containerc C s | � � | j||d� dS )z� Callback for processing changes to axis units. Currently forces updates of data limits and view limits. )r� r� N)�relimr� )r( r� r� r r r r� � s z_AxesBase._on_units_changedc C s� | j �d� | j �tj�� �� � d| _| jD ]}|r>|� � r.| � |� q.| j D ]}|r`|� � rP| � |� qP| j D ]}|r�|� � rr| �|� qrdS )a Recompute the data limits based on current artists. At present, `~.Collection` instances are not supported. Parameters ---------- visible_only : bool Whether to exclude invisible artists. Defaults to False. TN)r� rk Z set_pointsr� r� r� � get_pointsr. r r- r� rB r� rF r� )r( Z visible_onlyrY rm r� r r r r� � s z_AxesBase.relimc C s6 t �|�}t|�sdS | jj|| j||d� d| _dS )as Extend the `~.Axes.dataLim` BBox to include the given points. If no data is set currently, the BBox will ignore its limits and set the bound to be the bounds of the xydata (*xys*). Otherwise, it will compute the bounds of the union of its current data and the data in *xys*. Parameters ---------- xys : 2D array-like The points to include in the data limits BBox. This can be either a list of (x, y) tuples or a Nx2 array. updatex, updatey : bool, optional, default *True* Whether to update the x/y limits. Nr� F)rb Zasarrayr r� Zupdate_from_data_xyr. )r( r� r� r� r r r r� s �z_AxesBase.update_datalimc C s | j �tj�| j |g�� dS )z� Extend the `~.Axes.datalim` BBox to include the given `~matplotlib.transforms.Bbox`. Parameters ---------- bounds : `~matplotlib.transforms.Bbox` N)r� rX r� r� �union)r( r� r r r �update_datalim_bounds& s z _AxesBase.update_datalim_boundsc s0 � fdd�}||� j d|�}||� jd|�}|S )zALook for unit *kwargs* and update the axis instances as necessaryc s� |d kr |S | d k r&|� � s&|�| � |d k r�|�||j�}� jdkr`ddd�}|�|| |�}||jkr�|�|� | d k r�|�| � |S )Nr9 r: r< )r8 r; )Z have_unitsr] rG rH rI rJ )r= r' Z unit_namer7 rH Z polar_unitsr+ r r �_process_single_axis4 s z:_AxesBase._process_unit_info.<locals>._process_single_axisr8 r; �rE rF )r( �xdata�ydatar7 r� r r+ r �_process_unit_info1 s z _AxesBase._process_unit_infoc C s | j �|�d S )zd Return *True* if the given *mouseevent* (in display coords) is in the Axes r )r# �contains�r( Z mouseeventr r r �in_axesQ s z_AxesBase.in_axesc C s | j o | jS )zS Get whether autoscaling is applied for both axes on plot commands �r: r; r+ r r r �get_autoscale_onX s z_AxesBase.get_autoscale_onc C s | j S )zT Get whether autoscaling for the x-axis is applied on plot commands �r: r+ r r r r1 ^ s z_AxesBase.get_autoscalex_onc C s | j S )zT Get whether autoscaling for the y-axis is applied on plot commands �r; r+ r r r r6 d s z_AxesBase.get_autoscaley_onc C s || _ || _dS )z} Set whether autoscaling is applied on plot commands Parameters ---------- b : bool Nr� �r( r� r r r r� j s z_AxesBase.set_autoscale_onc C s || _ dS )z� Set whether autoscaling for the x-axis is applied on plot commands Parameters ---------- b : bool Nr� r� r r r �set_autoscalex_onu s z_AxesBase.set_autoscalex_onc C s || _ dS )z� Set whether autoscaling for the y-axis is applied on plot commands Parameters ---------- b : bool Nr� r� r r r �set_autoscaley_on s z_AxesBase.set_autoscaley_onc C s | j S )a� When autoscaling, whether to obey all `Artist.sticky_edges`. Default is ``True``. Setting this to ``False`` ensures that the specified margins will be applied, even if the plot includes an image, for example, which would otherwise force a view limit to coincide with its data limit. The changing this property does not change the plot until `autoscale` or `autoscale_view` is called. )r? r+ r r r �use_sticky_edges� s z_AxesBase.use_sticky_edgesc C s t |�| _d S r$ )r� r? r� r r r r� � s c C s |dkrt d��|| _d| _dS )aB Set padding of X data limits prior to autoscaling. *m* times the data interval will be added to each end of that interval before it is used in autoscaling. For example, if your data is in the range [0, 2], a factor of ``m = 0.1`` will result in a range [-0.2, 2.2]. Negative values -0.5 < m < 0 will result in clipping of the data range. I.e. for a data range [0, 2], a factor of ``m = -0.1`` will result in a range [0.2, 1.8]. Parameters ---------- m : float greater than -0.5 � � margin must be greater than -0.5TN)r r< r �r( �mr r r � set_xmargin� s z_AxesBase.set_xmarginc C s |dkrt d��|| _d| _dS )aB Set padding of Y data limits prior to autoscaling. *m* times the data interval will be added to each end of that interval before it is used in autoscaling. For example, if your data is in the range [0, 2], a factor of ``m = 0.1`` will result in a range [-0.2, 2.2]. Negative values -0.5 < m < 0 will result in clipping of the data range. I.e. for a data range [0, 2], a factor of ``m = -0.1`` will result in a range [0.2, 1.8]. Parameters ---------- m : float greater than -0.5 r� r� TN)r r= r r� r r r � set_ymargin� s z_AxesBase.set_ymargin)rc rd r� c G s� |r |dk r |dk r t d��n<t|�dkr8|d }}n"t|�dkrN|\}}n |rZt d��|dkr�|dkr�|dk r�t�d|�d �� | j| jfS |dk r�| �|� |dk r�| �|� | j||dk |dk d � dS ) a� Set or retrieve autoscaling margins. The padding added to each limit of the axes is the *margin* times the data interval. All input parameters must be floats within the range [0, 1]. Passing both positional and keyword arguments is invalid and will raise a TypeError. If no arguments (positional or otherwise) are provided, the current margins will remain in place and simply be returned. Specifying any margin changes only the autoscaling; for example, if *xmargin* is not None, then *xmargin* times the X data interval will be added to each end of that interval before it is used in autoscaling. Parameters ---------- *margins : float, optional If a single positional argument is provided, it specifies both margins of the x-axis and y-axis limits. If two positional arguments are provided, they will be interpreted as *xmargin*, *ymargin*. If setting the margin on a single axis is desired, use the keyword arguments described below. x, y : float, optional Specific margin values for the x-axis and y-axis, respectively. These cannot be used with positional arguments, but can be used individually to alter on e.g., only the y-axis. tight : bool or None, default is True The *tight* parameter is passed to :meth:`autoscale_view`, which is executed after a margin is changed; the default here is *True*, on the assumption that when margins are specified, no additional padding to match tick marks is usually desired. Set *tight* to *None* will preserve the previous setting. Returns ------- xmargin, ymargin : float Notes ----- If a previously used Axes method such as :meth:`pcolor` has set :attr:`use_sticky_edges` to `True`, only the limits not set by the "sticky artists" will be modified. To force all of the margins to be set, set :attr:`use_sticky_edges` to `False` before calling :meth:`margins`. NzACannot pass both positional and keyword arguments for x and/or y.r r r zVMust pass a single positional argument for all margins, or one for each margin (x, y).Tzignoring tight=z in get mode�r� r� r� ) rK r r rL r< r= r� r� r� )r( rc rd r� �marginsr r r r� � s* 4 �z_AxesBase.marginsc C s || _ d| _dS )z� Parameters ---------- z : float or None zorder below which artists are rasterized. ``None`` means that artists do not get rasterized based on zorder. TN)r� r )r( �zr r r �set_rasterization_zorder s z"_AxesBase.set_rasterization_zorderc C s | j S )z?Return the zorder value below which artists will be rasterized.)r� r+ r r r �get_rasterization_zorder# s z"_AxesBase.get_rasterization_zorderc C sz |dkrd}d}n8d}d}|dkr2t |�| _| j}|dkrJt |�| _| j}|rX|rXd| _|rf|rfd| _| j|||d� dS )a� Autoscale the axis view to the data (toggle). Convenience method for simple axis view autoscaling. It turns autoscaling on or off, and then, if autoscaling for either axis is on, it performs the autoscaling on the specified axis or axes. Parameters ---------- enable : bool or None, optional True (default) turns autoscaling on, False turns it off. None leaves the autoscaling state unchanged. axis : {'both', 'x', 'y'}, optional which axis to operate on; default is 'both' tight : bool or None, optional If True, set view limits to data limits; if False, let the locator and margins expand the view limits; if None, use tight scaling if the only artist is an image, otherwise treat *tight* as False. The *tight* setting is retained for future autoscaling until it is explicitly changed. NTF�rc r �rd r r r� )r� r: r; r< r= r� )r( �enabler' r� r� r� r r r � autoscale' s z_AxesBase.autoscalec s |dk rt |�� _� jr�� jr(|r(� js8� jr�|r�� jr�dd� � �� D �}t� dd� |D ��}t� dd� |D ��}� � � � � dkr�||dk }� � � � � dkr�||dk }n g g }}� fdd �}||� j� j d d � j� j|� j� ||� j� jd d � j� j|� j� dS )a� Autoscale the view limits using the data limits. You can selectively autoscale only a single axis, e.g., the xaxis by setting *scaley* to *False*. The autoscaling preserves any axis direction reversal that has already been done. If *tight* is *False*, the axis major locator will be used to expand the view limits if rcParams['axes.autolimit_mode'] is 'round_numbers'. Note that any margins that are in effect will be applied first, regardless of whether *tight* is *True* or *False*. Specifying *tight* as *True* or *False* saves the setting as a private attribute of the Axes; specifying it as *None* (the default) applies the previously saved value. The data limits are not updated automatically when artist data are changed after the artist has been added to an Axes instance. In that case, use :meth:`matplotlib.axes.Axes.relim` prior to calling autoscale_view. Nc S s g | ] }|j �qS r )Z sticky_edges�r? �artistr r r rB o s z,_AxesBase.autoscale_view.<locals>.<listcomp>c S s g | ]}|j D ]}|�qqS r )rc )r? �stickyrc r r r rB p s c S s g | ]}|j D ]}|�qqS r )rd )r? r� rd r r r rB q s r� r c s� | r|s d S |� ��} dd� | D �} dd� | D �� t� �rv� fdd�| D �} � fdd�| D �} � } | �| � | �| � tj�| �} d }t�| j�� � s�tj�dd� | D ��}|j| _t�| j �� � s�|d kr�tj�dd� | D ��}|j | _ t | |�\}}|� � }|� ||�\}}t | |�}|�� }|�� }t�t�||�� }t�t�||�� }|j�|||�\}}|�||g�\}}t�|��r�t�|��r�|| | }nd}|�r�||8 }|�r�||7 }|�||g�\}}�j�s�|�||�\}}|||� d S ) Nc S s g | ] }|j �qS r )r� �r? r r r r rB � s zH_AxesBase.autoscale_view.<locals>.handle_single_axis.<locals>.<listcomp>c S s g | ]}t �|��� r|�qS r )rb �isfinite�all�r? �dr r r rB � s c s( g | ] }t �|j��� r|� kr|�qS r )rb r� � intervalxr� r� �Z finite_dlr r rB � s �c s( g | ] }t �|j��� r|� kr|�qS r )rb r� � intervalyr� r� r� r r rB � s �c S s g | ] }|j �qS r �r� r� r r r rB � s c S s g | ] }|j �qS r r� r� r r r rB � s r )r� r �extendr� r r� rb r� r� r� r� r� �get_major_locator� nonsingularr �invertedrj �iscloser2 �limit_range_for_scaler� r> Z view_limits)�scaleZ autoscaleonZ shared_axesZintervalZminposr' Zmargin�stickiesZ set_boundZsharedZdlZx_finiteZy_finite�bbZvlrX rY r r� Z inverse_transZdo_lower_marginZdo_upper_marginZx0tZx1tZdeltar+ r� r �handle_single_axisy sV � z4_AxesBase.autoscale_view.<locals>.handle_single_axisr� Zminposxr� Zminposy)r� r> r� r< r: r= r; � get_childrenrb �arrayr� r� r� r� rE r� r� rF r� )r( r� r� r� r� Z x_stickiesZ y_stickiesr� r r+ r r� T s\ ������ D � �z_AxesBase.autoscale_viewc C s | j | jfS r$ r� r+ r r r �_get_axis_list� s z_AxesBase._get_axis_listc C s* | j dk r | j s t�d� dS | j| j| jf}| j dkrx|D ]4}|�� \}}t�|d�s<d| _ t�d|� dS q<d| _ d}|D �]|}|�� \}}d}|� |df� | j � | �}| j D ]@} | dk r�| � � } | r�| | |�} | �| � n| �� || g }q�d } |D ]r} zPd d g} | j�� d k�s.| j�� | k�r<| j�|�}n | �|�}t| |j�} W n tk �rn d}Y nX �q |�|�j| k �r�| j�� �d | f�d }|� ||f� |�|�j| k �r�| j�� �d d | |�|�j f�\}}|� ||f� t||�}q�|D ] }|�� \}}|� ||f� �qdS )z� Update the title position based on the bounding box enclosing all the ticklabels and x-axis spine and xlabel... Nz2title position was updated manually, not adjustingr FzGnot adjusting title pos because a title was already placed manually: %fTi����r r r� �unknownr r )rR �_log�debugrN rO rP r rb r� r r� r� rG r r rE Zget_label_positionZget_ticks_position� get_tightbboxr� r� rz r ry r� r� r� )r( �rendererZtitlesrN rc rd rz rZ Zaxsr r r r� �choicesr� r� r r r �_update_title_position� sp � � �� � z _AxesBase._update_title_positionc s� |dkr�j j}|dkr td����� s,dS |�d� d�_��� }|r^|�|�}��|� n��� ��� }|� �j � �j r��j s��j �� D ]}|� |� q���|� �j r�|r̈�� D ]}|� |� q�|r�|� �j� |� �j� |� �j� �j j�� �s�fdd�|D �}t|td�d�}�j� � dk �rx|�rx|d j� k �rx|�� � fd d�|D �}� fd d�|D �}ng }�j �r��j �r��j �|� |�r�|D ]} | �|� �q�|� � t � |�|� |� d� d �_ dS ) z*Draw everything (plot lines, axes, labels)NzNo renderer definedr% Tc s" g | ]}|� � r|� jkr|�qS r )Z get_animatedrF �r? r r+ r r rB ; s �z"_AxesBase.draw.<locals>.<listcomp>�zorder)r� r c s g | ]}|j � k r|�qS r �r r ��rasterization_zorderr r rB F s �c s g | ]}|j � kr|�qS r r r r r r rB H s �F)!r� �_cachedRendererr� r- Z open_groupr� r r r� r� r# �axisonr� r� �valuesr r� rN rO rP �canvasZ is_saving�sortedr r� r Zstart_rasterizing�drawZstop_rasterizing�mimageZ _draw_list_compositing_imagesZ close_groupr ) r( r �inframer r rE rW �_axisZartists_rasterizedr r )r r( r r s` � � z_AxesBase.drawc C s& | j jdkrtd��|�| j j� dS )�� This method can only be used after an initial draw which caches the renderer. It is used to efficiently update Axes data (axis ticks, labels, etc are not updated) NzLdraw_artist can only be used after an initial draw which caches the renderer�r� r r r r r r r � draw_artist\ s z_AxesBase.draw_artistc C s* | j jdkrtd��| j| j jdd� dS )r NzPredraw_in_frame can only be used after an initial draw which caches the rendererT)r r r+ r r r �redraw_in_frameg s z_AxesBase.redraw_in_framec C s | j jS r$ )r� r r+ r r r �get_renderer_cacher s z _AxesBase.get_renderer_cachec C s | j S )z.Get whether the axes rectangle patch is drawn.)r� r+ r r r � get_frame_onw s z_AxesBase.get_frame_onc C s || _ d| _dS )zx Set whether the axes rectangle patch is drawn. Parameters ---------- b : bool TN)r� r r� r r r � set_frame_on{ s z_AxesBase.set_frame_onc C s | j S )z� Get whether axis ticks and gridlines are above or below most artists. Returns ------- axisbelow : bool or 'line' See Also -------- set_axisbelow )� _axisbelowr+ r r r � get_axisbelow� s z_AxesBase.get_axisbelowc C sb t |� | _}|dkr d}n$|dkr*d}n|dkr8d}ntd��| �� D ]}|�|� qHd| _dS ) a Set whether axis ticks and gridlines are above or below most artists. This controls the zorder of the ticks and gridlines. For more information on the zorder see :doc:`/gallery/misc/zorder_demo`. Parameters ---------- b : bool or 'line' Possible values: - *True* (zorder = 0.5): Ticks and gridlines are below all Artists. - 'line' (zorder = 1.5): Ticks and gridlines are above patches (e.g. rectangles, with default zorder = 1) but still below lines and markers (with their default zorder = 2). - *False* (zorder = 2.5): Ticks and gridlines are above patches and lines / markers. See Also -------- get_axisbelow Tr) Fg @rY g �?zUnexpected axisbelow valueN)r r r r� Z set_zorderr )r( r� Z axisbelowr r' r r r r� � s z_AxesBase.set_axisbelowr� c K sd t |�r d}tjdddg|d� |dkr@| jj|fd|i|�� |dkr`| jj|fd|i|�� d S ) a� Configure the grid lines. Parameters ---------- b : bool or None, optional Whether to show the grid lines. If any *kwargs* are supplied, it is assumed you want the grid on and *b* will be set to True. If *b* is *None* and there are no *kwargs*, this toggles the visibility of the lines. which : {'major', 'minor', 'both'}, optional The grid lines to apply the changes on. axis : {'both', 'x', 'y'}, optional The axis to apply the changes on. **kwargs : `.Line2D` properties Define the line properties of the grid, e.g.:: grid(color='r', linestyle='-', linewidth=2) Valid *kwargs* are %(_Line2D_docstr)s Notes ----- The axis is drawn as a unit, so the effective zorder for drawing the grid is determined by the zorder of each axis, not by the zorder of the `.Line2D` objects comprising the grid. Therefore, to set grid zorder, use `.set_axisbelow` or, for more control, call the `~matplotlib.axis.Axis.set_zorder` method of each axis. Trc rd r �r' r� r� r� N)r r rp rE r� rF )r( r� r� r' r7 r r r r� � s %z_AxesBase.grid)r' �style� scilimits� useOffset� useLocale� useMathTextc C sD |� � }|� � }|dk rRz|\}}|| d W n ttfk rP td��Y nX |dd� dkrhd} n$|dkrvd} n|d kr�d} ntd ���z�| dk r�|d ks�|d kr�| jjj�| � |d ks�|d kr�| jjj�| � |dk �r(|d ks�|d k�r| jjj�|� |d k�s|d k�r(| jjj�|� |dk �rz|d k�sF|d k�rV| jjj� |� |d k�sj|d k�rz| jjj� |� |dk �r�|d k�s�|d k�r�| jjj� |� |d k�s�|d k�r�| jjj� |� |dk �r |d k�s�|d k�r�| jjj� |� |d k�s|d k�r | jjj� |� W n t k �r> t d��Y nX dS )a! Change the `~matplotlib.ticker.ScalarFormatter` used by default for linear axes. Optional keyword arguments: ============== ========================================= Keyword Description ============== ========================================= *axis* [ 'x' | 'y' | 'both' ] *style* [ 'sci' (or 'scientific') | 'plain' ] plain turns off scientific notation *scilimits* (m, n), pair of integers; if *style* is 'sci', scientific notation will be used for numbers outside the range 10\ :sup:`m` to 10\ :sup:`n`. Use (0,0) to include all numbers. Use (m,m) where m <> 0 to fix the order of magnitude to 10\ :sup:`m`. *useOffset* [ bool | offset ]; if True, the offset will be calculated as needed; if False, no offset will be used; if a numeric offset is specified, it will be used. *useLocale* If True, format the number according to the current locale. This affects things such as the character used for the decimal separator. If False, use C-style (English) formatting. The default setting is controlled by the axes.formatter.use_locale rcparam. *useMathText* If True, render the offset and scientific notation in mathtext ============== ========================================= Only the major ticks are affected. If the method is called when the `~matplotlib.ticker.ScalarFormatter` is not the `~matplotlib.ticker.Formatter` being used, an `AttributeError` will be raised. Nr z*scilimits must be a sequence of 2 integersrC ZsciTZplainFr� z %s is not a valid style valuer rc rd z0This method only works with the ScalarFormatter.) r� r rK rE r� Z formatterZset_scientificrF Zset_powerlimitsZ set_useOffsetZ set_useLocaleZset_useMathTextr ) r( r' r r r! r" r# r� �nZsbr r r �ticklabel_format� sZ * �z_AxesBase.ticklabel_formatc K sP |dk}|dk}|r&| j �� jf |� |r<| j�� jf |� | j|||d� dS )a? Control behavior of major tick locators. Because the locator is involved in autoscaling, `~.Axes.autoscale_view` is called automatically after the parameters are changed. Parameters ---------- axis : {'both', 'x', 'y'}, optional The axis on which to operate. tight : bool or None, optional Parameter passed to `~.Axes.autoscale_view`. Default is None, for no change. Other Parameters ---------------- **kwargs Remaining keyword arguments are passed to directly to the ``set_params()`` method of the locator. Supported keywords depend on the type of the locator. See for example `~.ticker.MaxNLocator.set_params` for the `.ticker.MaxNLocator` used by default for linear axes. Examples -------- When plotting small subplots, one might want to reduce the maximum number of ticks and use tight bounds, for example:: ax.locator_params(tight=True, nbins=4) r� r� r� N)rE r� Z set_paramsrF r� )r( r' r� r7 Z_xZ_yr r r �locator_params= s !z_AxesBase.locator_paramsc K s� t jdddg|d� |dkrbt|�}|�dd� |�dd� |�d d� |�d d� | jjf |� |d kr�t|�}|�d d� |�d d� |�dd� |�dd� | jjf |� dS )aZ Change the appearance of ticks, tick labels, and gridlines. Parameters ---------- axis : {'x', 'y', 'both'}, optional Which axis to apply the parameters to. Other Parameters ---------------- axis : {'x', 'y', 'both'} Axis on which to operate; default is 'both'. reset : bool If *True*, set all parameters to defaults before processing other keyword arguments. Default is *False*. which : {'major', 'minor', 'both'} Default is 'major'; apply arguments to *which* ticks. direction : {'in', 'out', 'inout'} Puts ticks inside the axes, outside the axes, or both. length : float Tick length in points. width : float Tick width in points. color : color Tick color; accepts any mpl color spec. pad : float Distance in points between tick and label. labelsize : float or str Tick label font size in points or as a string (e.g., 'large'). labelcolor : color Tick label color; mpl color spec. colors : color Changes the tick color and the label color to the same value: mpl color spec. zorder : float Tick and label zorder. bottom, top, left, right : bool Whether to draw the respective ticks. labelbottom, labeltop, labelleft, labelright : bool Whether to draw the respective tick labels. labelrotation : float Tick label rotation grid_color : color Changes the gridline color to the given mpl color spec. grid_alpha : float Transparency of gridlines: 0 (transparent) to 1 (opaque). grid_linewidth : float Width of gridlines in points. grid_linestyle : string Any valid `~matplotlib.lines.Line2D` line style spec. Examples -------- Usage :: ax.tick_params(direction='out', length=6, width=2, colors='r', grid_color='r', grid_alpha=0.5) This will make all major ticks be red, pointing out of the box, and with dimensions 6 points by 2 points. Tick labels will also be red. Gridlines will be red and translucent. rc rd r r r� r� Nr� r� r� r� r� r� r� r� )r rp �dictrG rE Zset_tick_paramsrF )r( r' r7 ZxkwZykwr r r r� f s T z_AxesBase.tick_paramsc C s d| _ d| _dS )z| Turn the x- and y-axis off. This affects the axis lines, ticks, ticklabels, grid and axis labels. FTN�r r r+ r r r r� � s z_AxesBase.set_axis_offc C s d| _ d| _dS )z{ Turn the x- and y-axis on. This affects the axis lines, ticks, ticklabels, grid and axis labels. TNr( r+ r r r rT � s z_AxesBase.set_axis_onc C s | j �| j �� � dS )z� Invert the x-axis. See Also -------- xaxis_inverted get_xlim, set_xlim get_xbound, set_xbound N)rE � set_inverted� get_invertedr+ r r r � invert_xaxis� s z_AxesBase.invert_xaxisc C s | j �� S )z� Return whether the x-axis is inverted. The axis is inverted if the left value is larger than the right value. See Also -------- invert_xaxis get_xlim, set_xlim get_xbound, set_xbound )rE r* r+ r r r �xaxis_inverted� s z_AxesBase.xaxis_invertedc C s( | � � \}}||k r ||fS ||fS dS )z� Return the lower and upper x-axis bounds, in increasing order. See Also -------- set_xbound get_xlim, set_xlim invert_xaxis, xaxis_inverted N)r/ )r( r� r� r r r rs � s z_AxesBase.get_xboundc C s� |dkrt �|�r|\}}| �� \}}|dkr2|}|dkr>|}| �� rr||k r`| j||dd� q�| j||dd� n*||k r�| j||dd� n| j||dd� dS )a Set the lower and upper numerical bounds of the x-axis. This method will honor axes inversion regardless of parameter order. It will not change the autoscaling setting (``Axes._autoscaleXon``). Parameters ---------- lower, upper : float or None The lower and upper bounds. If *None*, the respective axis bound is not modified. See Also -------- get_xbound get_xlim, set_xlim invert_xaxis, xaxis_inverted N�r� )rb �iterablers r, r0 �r( r� �upperZ old_lowerZ old_upperr r r r� s z_AxesBase.set_xboundc C s t | jj�S )a� Return the x-axis view limits. Returns ------- left, right : (float, float) The current x-axis limits in data coordinates. See Also -------- set_xlim set_xbound, get_xbound invert_xaxis, xaxis_inverted Notes ----- The x-axis may be inverted, in which case the *left* value will be greater than the *right* value. )�tupler� r� r+ r r r r/ 0 s z_AxesBase.get_xlimc C s4 |dk r0||�}t |t�r,t�|�s,td��|S dS )z� Raise ValueError if converted limits are non-finite. Note that this function also accepts None as a limit argument. Returns ------- The limit value after call to convert(), or None if limit is None. Nz Axis limits cannot be NaN or Inf)rO r rb r� r )r( �limitZconvertZconverted_limitr r r �_validate_converted_limitsG s �z$_AxesBase._validate_converted_limits)rw rx c C s� |dkrt �|�r|\}}|dk r6|dk r2td��|}|dk rR|dk rNtd��|}| j||fd� | �|| j�}| �|| j�}| �� \}}|dkr�|}|dkr�|}| �� dkr�|dkr�t� d� |}|dkr�t� d� |}||kr�t� d |� d �� ||k} | j � � � ||�\}}| j � ||�\}}t||gt| �d �\}}||f| j_|dk �r\t|�| _|�r�| j�d | � | j�| �D ]>} | | k �r|| j| jjd |d� | j| jk�r|| jj�� �q|d| _||fS )a Set the x-axis view limits. .. ACCEPTS: (left: float, right: float) Parameters ---------- left : scalar, optional The left xlim in data coordinates. Passing *None* leaves the limit unchanged. The left and right xlims may be passed as the tuple (*left*, *right*) as the first positional argument (or as the *left* keyword argument). right : scalar, optional The right xlim in data coordinates. Passing *None* leaves the limit unchanged. emit : bool, optional Whether to notify observers of limit change (default: True). auto : bool or None, optional Whether to turn on autoscaling of the x-axis. True turns on, False turns off (default action), None leaves unchanged. xmin, xmax : scalar, optional They are equivalent to left and right respectively, and it is an error to pass both *xmin* and *left* or *xmax* and *right*. Returns ------- left, right : (float, float) The new x-axis limits in data coordinates. See Also -------- get_xlim set_xbound, get_xbound invert_xaxis, xaxis_inverted Notes ----- The *left* value may be greater than the *right* value, in which case the x-axis values will decrease from left to right. Examples -------- >>> set_xlim(left, right) >>> set_xlim((left, right)) >>> left, right = set_xlim(left, right) One limit may be left unchanged. >>> set_xlim(right=right_lim) Limits may be passed in reverse order to flip the direction of the x-axis. For example, suppose *x* represents the number of years before present. The x-axis limits might be set like the following so 5000 years ago is on the left of the plot and the present is on the right. >>> set_xlim(5000, 0) Nz"Cannot pass both `xmin` and `left`z#Cannot pass both `xmax` and `right`)r� r� r z\Attempted to set non-positive left xlim on a log-scaled axis. Invalid limit will be ignored.z]Attempted to set non-positive right xlim on a log-scaled axis. Invalid limit will be ignored.z-Attempting to set identical left == right == �> results in singular transformations; automatically expanding.��reverseZ xlim_changedFr$ T) rb r. rK r� r3 r^ r/ r� r rL rE r� r� r� r r� r� r� r: r� �processr� r� r0 r� r � draw_idler ) r( r� r� r% r� rw rx Zold_leftZ old_rightr6 �otherr r r r0 Y sh D �� � �z_AxesBase.set_xlimc C s | j �� S )zj Return the x-axis scale as string. See Also -------- set_xscale )rE � get_scaler+ r r r r� � s z_AxesBase.get_xscalec K sF | � � }|�| �D ]"}|jj|f|� |�� d|_q| jdd� dS )a� Set the x-axis scale. Parameters ---------- value : {"linear", "log", "symlog", "logit", ...} The axis scale type to apply. **kwargs Different keyword arguments are accepted, depending on the scale. See the respective class keyword arguments: - `matplotlib.scale.LinearScale` - `matplotlib.scale.LogScale` - `matplotlib.scale.SymmetricalLogScale` - `matplotlib.scale.LogitScale` Notes ----- By default, Matplotlib supports the above mentioned scales. Additionally, custom scales may be registered using `matplotlib.scale.register_scale`. These scales can then also be used here. TFr� N)�get_shared_x_axesr� rE r3 r� r r� �r( �valuer7 �gr r r r r� � s z_AxesBase.set_xscalec C s | j j|d�S )z)Return the x ticks as a list of locations�r� )rE � get_ticklocs�r( r� r r r � get_xticks s z_AxesBase.get_xticksc C s | j j||d�}d| _|S )a( Set the x ticks with list of *ticks* Parameters ---------- ticks : list List of x-axis tick locations. minor : bool, optional If ``False`` sets major ticks, if ``True`` sets minor ticks. Default is ``False``. r? T)rE � set_ticksr �r( Zticksr� r� r r r � set_xticks s z_AxesBase.set_xticksc C s t �d| j�� �S )z� Get the major x tick labels. Returns ------- labels : list List of `~matplotlib.text.Text` instances �Text xticklabel)r r� rE �get_majorticklabelsr+ r r r �get_xmajorticklabels s �z _AxesBase.get_xmajorticklabelsc C s t �d| j�� �S )z� Get the minor x tick labels. Returns ------- labels : list List of `~matplotlib.text.Text` instances rF )r r� rE �get_minorticklabelsr+ r r r �get_xminorticklabels& s �z _AxesBase.get_xminorticklabelsc C s t �d| jj||d��S )a� Get the x tick labels as a list of `~matplotlib.text.Text` instances. Parameters ---------- minor : bool, optional If True return the minor ticklabels, else return the major ticklabels. which : None, ('minor', 'major', 'both') Overrides `minor`. Selects which ticklabels to return Returns ------- ret : list List of `~matplotlib.text.Text` instances. rF �r� r� )r r� rE �get_ticklabels�r( r� r� r r r �get_xticklabels2 s ��z_AxesBase.get_xticklabelsc K s4 |dk r|� |� | jj|fd|i|��}d| _|S )a% Set the x-tick labels with list of string labels. Parameters ---------- labels : List[str] List of string labels. fontdict : dict, optional A dictionary controlling the appearance of the ticklabels. The default `fontdict` is:: {'fontsize': rcParams['axes.titlesize'], 'fontweight': rcParams['axes.titleweight'], 'verticalalignment': 'baseline', 'horizontalalignment': loc} minor : bool, optional Whether to set the minor ticklabels rather than the major ones. Returns ------- A list of `~.text.Text` instances. Other Parameters ----------------- **kwargs : `~.text.Text` properties. Nr� T)r� rE �set_ticklabelsr )r( �labels�fontdictr� r7 r� r r r �set_xticklabelsJ s ��z_AxesBase.set_xticklabelsc C s | j �| j �� � dS )z� Invert the y-axis. See Also -------- yaxis_inverted get_ylim, set_ylim get_ybound, set_ybound N)rF r) r* r+ r r r � invert_yaxisn s z_AxesBase.invert_yaxisc C s | j �� S )z� Return whether the y-axis is inverted. The axis is inverted if the bottom value is larger than the top value. See Also -------- invert_yaxis get_ylim, set_ylim get_ybound, set_ybound )rF r* r+ r r r �yaxis_invertedz s z_AxesBase.yaxis_invertedc C s( | � � \}}||k r ||fS ||fS dS )z� Return the lower and upper y-axis bounds, in increasing order. See Also -------- set_ybound get_ylim, set_ylim invert_yaxis, yaxis_inverted N)r4 )r( r� r� r r r rt � s z_AxesBase.get_yboundc C s� |dkrt �|�r|\}}| �� \}}|dkr2|}|dkr>|}| �� rr||k r`| j||dd� q�| j||dd� n*||k r�| j||dd� n| j||dd� dS )a Set the lower and upper numerical bounds of the y-axis. This method will honor axes inversion regardless of parameter order. It will not change the autoscaling setting (``Axes._autoscaleYon``). Parameters ---------- lower, upper : float or None The lower and upper bounds. If *None*, the respective axis bound is not modified. See Also -------- get_ybound get_ylim, set_ylim invert_yaxis, yaxis_inverted Nr- )rb r. rt rT r5 r/ r r r r� � s z_AxesBase.set_yboundc C s t | jj�S )a� Return the y-axis view limits. Returns ------- bottom, top : (float, float) The current y-axis limits in data coordinates. See Also -------- set_ylim set_ybound, get_ybound invert_yaxis, yaxis_inverted Notes ----- The y-axis may be inverted, in which case the *bottom* value will be greater than the *top* value. )r1 r� r� r+ r r r r4 � s z_AxesBase.get_ylim)ry rz c C s� |dkrt �|�r|\}}|dk r6|dk r2td��|}|dk rR|dk rNtd��|}| j||fd� | �|| j�}| �|| j�}| �� \}}|dkr�|}|dkr�|}| �� dkr�|dkr�t� d� |}|dkr�t� d� |}||kr�t� d |� d �� ||k} | j � � � ||�\}}| j � ||�\}}t||gt| �d �\}}||f| j_|dk �r\t|�| _|�r�| j�d | � | j�| �D ]>} | | k �r|| j| jjd |d� | j| jk�r|| jj�� �q|d| _||fS )a Set the y-axis view limits. .. ACCEPTS: (bottom: float, top: float) Parameters ---------- bottom : scalar, optional The bottom ylim in data coordinates. Passing *None* leaves the limit unchanged. The bottom and top ylims may be passed as the tuple (*bottom*, *top*) as the first positional argument (or as the *bottom* keyword argument). top : scalar, optional The top ylim in data coordinates. Passing *None* leaves the limit unchanged. emit : bool, optional Whether to notify observers of limit change (default: ``True``). auto : bool or None, optional Whether to turn on autoscaling of the y-axis. *True* turns on, *False* turns off (default action), *None* leaves unchanged. ymin, ymax : scalar, optional They are equivalent to bottom and top respectively, and it is an error to pass both *ymin* and *bottom* or *ymax* and *top*. Returns ------- bottom, top : (float, float) The new y-axis limits in data coordinates. See Also -------- get_ylim set_ybound, get_ybound invert_yaxis, yaxis_inverted Notes ----- The *bottom* value may be greater than the *top* value, in which case the y-axis values will decrease from *bottom* to *top*. Examples -------- >>> set_ylim(bottom, top) >>> set_ylim((bottom, top)) >>> bottom, top = set_ylim(bottom, top) One limit may be left unchanged. >>> set_ylim(top=top_lim) Limits may be passed in reverse order to flip the direction of the y-axis. For example, suppose ``y`` represents depth of the ocean in m. The y-axis limits might be set like the following so 5000 m depth is at the bottom of the plot and the surface, 0 m, is at the top. >>> set_ylim(5000, 0) Nz$Cannot pass both `ymin` and `bottom`z!Cannot pass both `ymax` and `top`)r� r� r z^Attempted to set non-positive bottom ylim on a log-scaled axis. Invalid limit will be ignored.z[Attempted to set non-positive top ylim on a log-scaled axis. Invalid limit will be ignored.z-Attempting to set identical bottom == top == r4 r5 Z ylim_changedFr$ T) rb r. rK r� r3 r_ r4 r� r rL rF r� r� r� r r� r� r� r; r� r7 r� r� r5 r� r r8 r ) r( r� r� r% r� ry rz Z old_bottomZold_topr6 r9 r r r r5 � sh C �� � �z_AxesBase.set_ylimc C s | j �� S )zj Return the y-axis scale as string. See Also -------- set_yscale )rF r: r+ r r r r� X s z_AxesBase.get_yscalec K sF | � � }|�| �D ]"}|jj|f|� |�� d|_q| jdd� dS )a� Set the y-axis scale. Parameters ---------- value : {"linear", "log", "symlog", "logit", ...} The axis scale type to apply. **kwargs Different keyword arguments are accepted, depending on the scale. See the respective class keyword arguments: - `matplotlib.scale.LinearScale` - `matplotlib.scale.LogScale` - `matplotlib.scale.SymmetricalLogScale` - `matplotlib.scale.LogitScale` Notes ----- By default, Matplotlib supports the above mentioned scales. Additionally, custom scales may be registered using `matplotlib.scale.register_scale`. These scales can then also be used here. TFr� N)�get_shared_y_axesr� rF r3 r� r r� r< r r r r� b s z_AxesBase.set_yscalec C s | j j|d�S )z)Return the y ticks as a list of locationsr? )rF r@ rA r r r � get_yticks� s z_AxesBase.get_yticksc C s | j j||d�}|S )a' Set the y ticks with list of *ticks* Parameters ---------- ticks : list List of y-axis tick locations minor : bool, optional If ``False`` sets major ticks, if ``True`` sets minor ticks. Default is ``False``. r? )rF rC rD r r r � set_yticks� s z_AxesBase.set_yticksc C s t �d| j�� �S )z� Get the major y tick labels. Returns ------- labels : list List of `~matplotlib.text.Text` instances �Text yticklabel)r r� rF rG r+ r r r �get_ymajorticklabels� s �z _AxesBase.get_ymajorticklabelsc C s t �d| j�� �S )z� Get the minor y tick labels. Returns ------- labels : list List of `~matplotlib.text.Text` instances rX )r r� rF rI r+ r r r �get_yminorticklabels� s �z _AxesBase.get_yminorticklabelsc C s t �d| jj||d��S )a� Get the y tick labels as a list of `~matplotlib.text.Text` instances. Parameters ---------- minor : bool If True return the minor ticklabels, else return the major ticklabels which : None, ('minor', 'major', 'both') Overrides `minor`. Selects which ticklabels to return Returns ------- ret : list List of `~matplotlib.text.Text` instances. rX rK )r r� rF rL rM r r r �get_yticklabels� s ��z_AxesBase.get_yticklabelsc K s* |dk r|� |� | jj|fd|i|��S )a$ Set the y-tick labels with list of strings labels. Parameters ---------- labels : List[str] list of string labels fontdict : dict, optional A dictionary controlling the appearance of the ticklabels. The default `fontdict` is:: {'fontsize': rcParams['axes.titlesize'], 'fontweight': rcParams['axes.titleweight'], 'verticalalignment': 'baseline', 'horizontalalignment': loc} minor : bool, optional Whether to set the minor ticklabels rather than the major ones. Returns ------- A list of `~.text.Text` instances. Other Parameters ---------------- **kwargs : `~.text.Text` properties. Nr� )r� rF rO )r( rP rQ r� r7 r r r �set_yticklabels� s ��z_AxesBase.set_yticklabelsc C s | j �|� dS )z� Sets up x-axis ticks and labels that treat the x data as dates. Parameters ---------- tz : string or `tzinfo` instance, optional Timezone. Defaults to :rc:`timezone`. N)rE � axis_date�r( Ztzr r r � xaxis_date� s z_AxesBase.xaxis_datec C s | j �|� dS )z� Sets up y-axis ticks and labels that treat the y data as dates. Parameters ---------- tz : string or `tzinfo` instance, optional Timezone. Defaults to :rc:`timezone`. N)rF r] r^ r r r � yaxis_date� s z_AxesBase.yaxis_datec C s | j dk r| j n | j�� j|�S )z� Return *x* formatted as an x-value. This function will use the `.fmt_xdata` attribute if it is not None, else will fall back on the xaxis major formatter. N)r� rE �get_major_formatter�format_data_short)r( rc r r r � format_xdata s �z_AxesBase.format_xdatac C s | j dk r| j n | j�� j|�S )z� Return *y* formatted as an y-value. This function will use the `.fmt_ydata` attribute if it is not None, else will fall back on the yaxis major formatter. N)r� rF ra rb )r( rd r r r � format_ydata s �z_AxesBase.format_ydatac C s< |dkrd}n | � |�}|dkr&d}n | �|�}d||f S )z;Return a format string formatting the *x*, *y* coordinates.Nz???z x=%s y=%s)rc rd )r( rc rd ZxsZysr r r � format_coord s z_AxesBase.format_coordc C sx | j | jfD ]f}|�� }|dkr>|j}|�t�|j|j�� q |dkrd|j}|�t� |j |j�� q |�t� � � q dS )z� Display minor ticks on the axes. Displaying minor ticks may reduce performance; you may turn them off using `minorticks_off()` if drawing speed is a problem. r� ZsymlogN) rE rF r: r2 r7 r8 Z LogLocator�baseZsubsZSymmetricalLogLocatorZ _transformr9 )r( r r� r� r r r � minorticks_on! s �z_AxesBase.minorticks_onc C s$ | j �t�� � | j�t�� � dS )z!Remove minor ticks from the axes.N)rE r7 r8 Z NullLocatorrF r+ r r r �minorticks_off4 s z_AxesBase.minorticks_offc C s dS )zX Return *True* if this axes supports the zoom box button functionality. Tr r+ r r r �can_zoom; s z_AxesBase.can_zoomc C s dS )zX Return *True* if this axes supports any pan/zoom button functionality. Tr r+ r r r �can_panA s z_AxesBase.can_panc C s | j S )zF Get whether the axes responds to navigation commands �Z _navigater+ r r r � get_navigateG s z_AxesBase.get_navigatec C s || _ dS )z� Set whether the axes responds to navigation toolbar commands Parameters ---------- b : bool Nrk r� r r r r� M s z_AxesBase.set_navigatec C s | j S )zR Get the navigation toolbar button status: 'PAN', 'ZOOM', or None �Z_navigate_moder+ r r r �get_navigate_modeW s z_AxesBase.get_navigate_modec C s || _ dS )z Set the navigation toolbar button status; .. warning:: this is not a user-API function. Nrm r� r r r r� ] s z_AxesBase.set_navigate_modec C s$ | � � \}}| �� \}}||||fS )a� Save information required to reproduce the current view. Called before a view is changed, such as during a pan or zoom initiated by the user. You may return any information you deem necessary to describe the view. .. note:: Intended to be overridden by new projection types, but if not, the default implementation saves the view limits. You *must* implement :meth:`_set_view` if you implement this method. )r/ r4 )r( rw rx ry rz r r r � _get_viewg s z_AxesBase._get_viewc C s, |\}}}}| � ||f� | �||f� dS )am Apply a previously saved view. Called when restoring a view, such as with the navigation buttons. .. note:: Intended to be overridden by new projection types, but if not, the default implementation restores the view limits. You *must* implement :meth:`_get_view` if you implement this method. N)r0 r5 )r( Zviewrw rx ry rz r r r � _set_viewy s z_AxesBase._set_view�inc & C sJ | � � \}}| �� \}} t|�dk�r |\} } } | dkr<d} | dkrJd}n d}d| } | jj} | ||f�\}}| || f�\}}|| }|| }|| d }|| d }| | d | | }| | d | | }||d | ||d | ||d | ||d | g}n t|�d k�r(t�d � d S |\}}}}| j�� } | �||f�\}}| �||f�\}}|�rt|| } } n�||k �r�||k �r�|| } } n || } } | |k �r�|} | |k�r�|} n<||k�r�|| } } n || } } | |k�r�|} | |k �r�|} |�r || } } n�|| k �rR||k �r*|| } } n || } } | |k �rB|} | | k�r�| } n<||k�rh|| } } n || } } | |k�r�|} | | k �r�| } |dk�r�|d k�r�| � | | f� n6|d k�r�| � | | f� n | � | | f� | � | | f� �nZ|dk�rF| � � dk�rFt � || �t � | | � }!t|| |!�| }"t|| |!�| }#n0|| | | }!|!|| | }"|!|| | }#| �� dk�r�t � | | �t � | | � }!t|| |!�| }$t| | |!�| }%n0| | | | }!|!|| | }$|!| | | }%|d k�r| � |"|#f� n6|d k�r*| � |$|%f� n | � |"|#f� | � |$|%f� d S )a� Update view from a selection bbox. .. note:: Intended to be overridden by new projection types, but if not, the default implementation sets the view limits to the bbox directly. Parameters ---------- bbox : 4-tuple or 3 tuple * If bbox is a 4 tuple, it is the selected bounding box limits, in *display* coordinates. * If bbox is a 3 tuple, it is an (xp, yp, scl) triple, where (xp,yp) is the center of zooming and scl the scale factor to zoom by. direction : str The direction to apply the bounding box. * `'in'` - The bounding box describes the view directly, i.e., it zooms in. * `'out'` - The bounding box describes the size to make the existing view, i.e., it zooms out. mode : str or None The selection mode, whether to apply the bounding box in only the `'x'` direction, `'y'` direction or both (`None`). twinx : bool Whether this axis is twinned in the *x*-direction. twiny : bool Whether this axis is twinned in the *y*-direction. rC r r r rq �outr) r� r� zgWarning in _set_view_from_bbox: bounding box is not a tuple of length 3 or 4. Ignoring the view change.Nrc rd r� )r/ r4 r r� r� r rL r� Ztransform_pointr0 r5 r� rb r� �powr� )&r( r� � direction�mode�twinx�twinyZXminZXmaxZYminZYmaxZxpZypZsclZtranD2Crw ry rx rz ZxwidthZywidthZxcenZycenZxzcZyzcZlastxZlastyrc rd ZinverserX rY rZ r[ �alphaZrx1Zrx2Zry1Zry2r r r �_set_view_from_bbox� s� % �� z _AxesBase._set_view_from_bboxc C s8 t j| j�� | j�� | j�� �� | j�� ||d�| _dS )a2 Called when a pan operation has started. *x*, *y* are the mouse coordinates in display coords. button is the mouse button number: * 1: LEFT * 2: MIDDLE * 3: RIGHT .. note:: Intended to be overridden by new projection types. )�lim�trans� trans_inverser� rc rd N)�types�SimpleNamespacer� r� r� r� r� � _pan_start)r( rc rd �buttonr r r � start_pan, s �z_AxesBase.start_panc C s | ` dS )z� Called when a pan operation completes (when the mouse button is up.) .. note:: Intended to be overridden by new projection types. N)r r+ r r r �end_panD s z_AxesBase.end_panc C s� dd� }| j }||j }||j }|| kr6dkr>n ndS |dkrr||||�\}}|j�| | ��|j�} n�|dk�r@z�| | jj }| | jj }||||�\}}| � � dkr�d|| }}t � d ||f�} t � |j|jg�} |j �|j�} | | | | } t�| ��|j�} W n" tk �r< t�d � Y dS X ndS t �| �|j��}| �� �t�}d|| < | �|dd�df � | �|dd�df � dS ) a` Called when the mouse moves during a pan operation. *button* is the mouse button number: * 1: LEFT * 2: MIDDLE * 3: RIGHT *key* is a "shift" key *x*, *y* are the mouse coordinates in display coords. .. note:: Intended to be overridden by new projection types. c S s� | dkr$t |�t |�kr |}q�|}n�| dkr2d}n�| dkr@d}nv| dkr�dt |� t |�k rbd}nTdt |� t |�k r|d}n:t |�t |�kr�|t |� t |� }n|t |� t |� }||fS )NZcontrolrc r rd �shiftr )ru )r� �dx�dyr r r � format_deltasc s" z)_AxesBase.drag_pan.<locals>.format_deltasr Nr rC r� r) r� zOverflow while panning)r rc rd r� Z translatedZ transformedr| r� r� rb rb Zpowerr� rz r{ r� r� � OverflowErrorr rL r� r� Zastype�objectr0 r5 )r( r� r� rc rd r� rm r� r� �resultrx �startZ oldpointsZ newpointsZvalidZpointsr r r �drag_panP s@ � z_AxesBase.drag_panc C sZ | j | j| j| j| j| j�� | �� | j| j | j f| j | j | j | jd k rN| jgng | jf� S r$ )rJ rB r rC rE r� r r� rN rO rP rD rF rG rI r# r+ r r r r� � s" � �z_AxesBase.get_childrenc C s" | j d k r| � | |�S | j�|�S r$ )Z _containsr# r� r� r r r r� � s z_AxesBase.containsc C s | j j|dd�S )zf Return whether *point* (pair of pixel coordinates) is inside the axes patch. r )Zradius)r# �contains_point)r( Zpointr r r r� � s z_AxesBase.contains_pointc C sZ | � � }| jr| js.| j�� D ]}|�|� q | jsL| �� D ]}|�|� q<dd� |D �S )z� Return a default list of artists that are used for the bounding box calculation. Artists are excluded either by not being visible or ``artist.set_in_layout(False)``. c S s g | ]}|� � r|�� r|�qS r )r- Z get_in_layoutr� r r r rB � s �z<_AxesBase.get_default_bbox_extra_artists.<locals>.<listcomp>)r� r r� r� r r� r� )r( rE rW r r r r � get_default_bbox_extra_artists� s z(_AxesBase.get_default_bbox_extra_artistsc C s� g }| � � sdS | �� }|r6|r6|| |�}| �|� n| �� | jrx| j�|�}|r^|�|� | j�|�}|rx|�|� | �|� | � |�} |�| � | �|� | j � � r�|�| j � |�� | j � � r�|�| j � |�� | j � � r�|�| j � |�� |�| � |�� |} | dk�r| � � } | D ]�} | �� } | dk �rZtj�| | �} t�| j| jk��rZ�q | �|�} | dk �r d| j k �r�tjk �r n n*d| j k �r�tjk �r n n |�| � �q tj�dd� |D ��}|S )aD Return the tight bounding box of the axes, including axis and their decorators (xlabel, title, etc). Artists that have ``artist.set_in_layout(False)`` are not included in the bbox. Parameters ---------- renderer : `.RendererBase` instance renderer that will be used to draw the figures (i.e. ``fig.canvas.get_renderer()``) bbox_extra_artists : list of `.Artist` or ``None`` List of artists to include in the tight bounding box. If ``None`` (default), then all artist children of the axes are included in the tight bounding box. call_axes_locator : boolean (default ``True``) If *call_axes_locator* is ``False``, it does not call the ``_axes_locator`` attribute, which is necessary to get the correct bounding box. ``call_axes_locator=False`` can be used if the caller is only interested in the relative size of the tightbbox compared to the axes bbox. Returns ------- bbox : `.BboxBase` bounding box in figure pixel coordinates. See Also -------- matplotlib.axes.Axes.get_window_extent matplotlib.axis.Axis.get_tightbbox matplotlib.spines.Spine.get_window_extent Nr c S s$ g | ] }|j d ks |jd kr|�qS )r )r� r� )r? r� r r r rB 1 s z+_AxesBase.get_tightbbox.<locals>.<listcomp>)r- r r r rE r r� rF r r� rN rO rP r� Z_get_clipping_extent_bboxr� r� � intersectionrb r� Zextentsr� �infr� r� )r( r Zcall_axes_locatorZbbox_extra_artistsr� r r Zbb_xaxisZbb_yaxisZaxbboxZ bbox_artistsr Z clip_extentr� Z_bboxr r r r � sl ( � � � � � �z_AxesBase.get_tightbboxc O sX d|krd|krt d��| jj| �d�f|�|�}| �d� |�d� | j�| |� |S )zN Make a twinx axes of self. This is used for twinx and twiny. r� r� z%Twinned Axes may share only one axis.Trn )r r� Zadd_axesr rg r� r� )r( Zklr7 �ax2r r r �_make_twin_axes5 s z_AxesBase._make_twin_axesc C sb | j | d�}|j�� |j�d� |j�d� |�| �� � | j�� |j� d� |j � d� |S )a� Create a twin Axes sharing the xaxis Create a new Axes instance with an invisible x-axis and an independent y-axis positioned opposite to the original one (i.e. at right). The x-axis autoscale setting will be inherited from the original Axes. To ensure that the tick marks of both y-axes align, see `~matplotlib.ticker.LinearLocator` Returns ------- ax_twin : Axes The newly created Axes instance Notes ----- For those who are 'picking' artists while using twinx, pick events are only called for the artists in the top-most axes. )r� r� F) r� rF Z tick_right�set_label_positionZset_offset_positionr� r1 Z tick_leftrE rV r# �r( r� r r r rv C s z_AxesBase.twinxc C sV | j | d�}|j�� |j�d� |�| �� � | j�� |j�d� |j �d� |S )a� Create a twin Axes sharing the yaxis Create a new Axes instance with an invisible y-axis and an independent x-axis positioned opposite to the original one (i.e. at top). The y-axis autoscale setting will be inherited from the original Axes. To ensure that the tick marks of both x-axes align, see `~matplotlib.ticker.LinearLocator` Returns ------- ax_twin : Axes The newly created Axes instance Notes ----- For those who are 'picking' artists while using twiny, pick events are only called for the artists in the top-most axes. )r� r� F) r� rE Ztick_topr� r� r6 Z tick_bottomrF rV r# r� r r r rw a s z_AxesBase.twinyc C s | j S )z@Return a reference to the shared axes Grouper object for x axes.)r� r+ r r r r; s z_AxesBase.get_shared_x_axesc C s | j S )z@Return a reference to the shared axes Grouper object for y axes.)r� r+ r r r rU � s z_AxesBase.get_shared_y_axes)NTNNr� NN)r� )r� )F)r )r )Nr r )NNF)F)F)N)T)FF)F)TT)NNN)Tr N)NTT)NF)Nr� r )r N)r )NN)NNTF)F)F)FN)NF)NN)NNTF)F)F)FN)NF)N)N)rq NFF)TN)�r� r� r� rI r ZGrouperr� r� r� r� r) r, r0 r� r� r� r� r� r� r� r� r r r� r r r r r� r r r r� r� Z deprecated�propertyr_ r` ra Zget_fcrS Zset_fcrQ r' rb rl rm rg rq rh r} r� r r' r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r1 r6 r� r� r� r� �setterr� r� r� r� r� r� r� r� r r� Zallow_rasterizationr r r r r r r r� r Zdedent_interpdr� r% r& r� r� rT r+ r, rs r� r/ r3 r0 r� r� rB rE rH rJ rN rR rS rT rt r� r4 r5 r� r� rV rW rY rZ r[ r\ r_ r` rc rd re rg rh ri rj rl r� rn r� ro rp ry r� r� r� r� r� r� r� r r� rv rw r; rU � __classcell__r r r� r r� � s� � $ J O ) 8 , M - pFN $, � X ) d ( � " $ ( � ! " � $ J �e r� )DrJ r r1 Zloggingr~ Znumbersr �operatorr r} Znumpyrb Z matplotlibr> r r Zmatplotlib.cbookr r r r r Zmatplotlib.colorsZcolorsr Zmatplotlib.linesr r Zmatplotlib.patchesrB rx Zmatplotlib.artistr� r� Zmatplotlib.transformsZ transformsr� Zmatplotlib.tickerZtickerr8 Zmatplotlib.axisr' r� Zmatplotlib.scaler� ZmscaleZmatplotlib.spinesr� r! Zmatplotlib.font_managerrL Zmatplotlib.textr+ rM Zmatplotlib.imager� r Zmatplotlib.rcsetupr r Z getLoggerr� r r! r� r" r� r� r r r r �<module> s< V &