OwlCyberSecurity - MANAGER
Edit File: ticker.cpython-38.pyc
U ��]Ul � @ s d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z ddlm Z e� e �ZdZdd� ZG d d � d e�ZG d d � d e�ZG d d� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�Z G d d � d e�Z G d!d"� d"e �Z G d#d$� d$e �Z G d%d&� d&e �Z G d'd(� d(e�Z!G d)d*� d*e�Z"G d+d,� d,e�Z#G d-d.� d.e�Z$G d/d0� d0e$�Z%G d1d2� d2e$�Z&G d3d4� d4e$�Z'G d5d6� d6e$�Z(e �)d7�d8d9� �Z*e �)d7�G d:d;� d;e��Z+G d<d=� d=e$�Z,dfd@dA�Z-G dBdC� dC�Z.G dDdE� dEe$�Z/e �)dF�dgdHdI��Z0e �)dF�dhdJdK��Z1dLdM� Z2didNdO�Z3dPdQ� Z4dRdS� Z5dTdU� Z6dVdW� Z7dXdY� Z8G dZd[� d[e$�Z9G d\d]� d]e$�Z:G d^d_� d_e$�Z;G d`da� dae/�Z<G dbdc� dce$�Z=G ddde� dee$�Z>dS )ja� Tick locating and formatting ============================ This module contains classes to support completely configurable tick locating and formatting. Although the locators know nothing about major or minor ticks, they are used by the Axis class to support major and minor tick locating and formatting. Generic tick locators and formatters are provided, as well as domain specific custom ones. Default Formatter ----------------- The default formatter identifies when the x-data being plotted is a small range on top of a large offset. To reduce the chances that the ticklabels overlap, the ticks are labeled as deltas from a fixed offset. For example:: ax.plot(np.arange(2000, 2010), range(10)) will have tick of 0-9 with an offset of +2e3. If this is not desired turn off the use of the offset on the default formatter:: ax.get_xaxis().get_major_formatter().set_useOffset(False) set the rcParam ``axes.formatter.useoffset=False`` to turn it off globally, or set a different formatter. Tick locating ------------- The Locator class is the base class for all tick locators. The locators handle autoscaling of the view limits based on the data limits, and the choosing of tick locations. A useful semi-automatic tick locator is `MultipleLocator`. It is initialized with a base, e.g., 10, and it picks axis limits and ticks that are multiples of that base. The Locator subclasses defined here are :class:`AutoLocator` `MaxNLocator` with simple defaults. This is the default tick locator for most plotting. :class:`MaxNLocator` Finds up to a max number of intervals with ticks at nice locations. :class:`LinearLocator` Space ticks evenly from min to max. :class:`LogLocator` Space ticks logarithmically from min to max. :class:`MultipleLocator` Ticks and range are a multiple of base; either integer or float. :class:`FixedLocator` Tick locations are fixed. :class:`IndexLocator` Locator for index plots (e.g., where ``x = range(len(y))``). :class:`NullLocator` No ticks. :class:`SymmetricalLogLocator` Locator for use with with the symlog norm; works like `LogLocator` for the part outside of the threshold and adds 0 if inside the limits. :class:`LogitLocator` Locator for logit scaling. :class:`OldAutoLocator` Choose a `MultipleLocator` and dynamically reassign it for intelligent ticking during navigation. :class:`AutoMinorLocator` Locator for minor ticks when the axis is linear and the major ticks are uniformly spaced. Subdivides the major tick interval into a specified number of minor intervals, defaulting to 4 or 5 depending on the major interval. There are a number of locators specialized for date locations - see the `dates` module. You can define your own locator by deriving from Locator. You must override the ``__call__`` method, which returns a sequence of locations, and you will probably want to override the autoscale method to set the view limits from the data limits. If you want to override the default locator, use one of the above or a custom locator and pass it to the x or y axis instance. The relevant methods are:: ax.xaxis.set_major_locator(xmajor_locator) ax.xaxis.set_minor_locator(xminor_locator) ax.yaxis.set_major_locator(ymajor_locator) ax.yaxis.set_minor_locator(yminor_locator) The default minor locator is `NullLocator`, i.e., no minor ticks on by default. Tick formatting --------------- Tick formatting is controlled by classes derived from Formatter. The formatter operates on a single tick value and returns a string to the axis. :class:`NullFormatter` No labels on the ticks. :class:`IndexFormatter` Set the strings from a list of labels. :class:`FixedFormatter` Set the strings manually for the labels. :class:`FuncFormatter` User defined function sets the labels. :class:`StrMethodFormatter` Use string `format` method. :class:`FormatStrFormatter` Use an old-style sprintf format string. :class:`ScalarFormatter` Default formatter for scalars: autopick the format string. :class:`LogFormatter` Formatter for log axes. :class:`LogFormatterExponent` Format values for log axis using ``exponent = log_base(value)``. :class:`LogFormatterMathtext` Format values for log axis using ``exponent = log_base(value)`` using Math text. :class:`LogFormatterSciNotation` Format values for log axis using scientific notation. :class:`LogitFormatter` Probability formatter. :class:`EngFormatter` Format labels in engineering notation :class:`PercentFormatter` Format labels as a percentage You can derive your own formatter from the Formatter base class by simply overriding the ``__call__`` method. The formatter class has access to the axis view and data limits. To control the major and minor tick label formats, use one of the following methods:: ax.xaxis.set_major_formatter(xmajor_formatter) ax.xaxis.set_minor_formatter(xminor_formatter) ax.yaxis.set_major_formatter(ymajor_formatter) ax.yaxis.set_minor_formatter(yminor_formatter) See :doc:`/gallery/ticks_and_spines/major_minor_demo` for an example of setting major and minor ticks. See the :mod:`matplotlib.dates` module for more information and examples of using date locators and formatters. � N)�rcParams)�cbook)� transforms) � TickHelper� Formatter�FixedFormatter� NullFormatter� FuncFormatter�FormatStrFormatter�StrMethodFormatter�ScalarFormatter� LogFormatter�LogFormatterExponent�LogFormatterMathtext�IndexFormatter�LogFormatterSciNotation�LogitFormatter� EngFormatter�PercentFormatter�OldScalarFormatter�Locator� IndexLocator� FixedLocator� NullLocator� LinearLocator� LogLocator� AutoLocator�MultipleLocator� MaxNLocator�AutoMinorLocator�SymmetricalLogLocator� LogitLocator�OldAutoLocatorc C s d| S )Nz\mathdefault{%s}� )�sr# r# �3/usr/lib/python3/dist-packages/matplotlib/ticker.py� _mathdefault� s r& c @ sF e Zd Zddd�Zdd� Zdd� Zdd � Zd d � Zd d � Zdd� Z dS )� _DummyAxisr c C s" t j�� | _t j�� | _|| _d S �N)� mtransformsZBbox�unit�dataLim�viewLim�_minpos)�self�minposr# r# r% �__init__� s z_DummyAxis.__init__c C s | j jS r( �r, � intervalx�r. r# r# r% �get_view_interval� s z _DummyAxis.get_view_intervalc C s ||f| j _d S r( r1 �r. �vmin�vmaxr# r# r% �set_view_interval� s z _DummyAxis.set_view_intervalc C s | j S r( )r- r3 r# r# r% � get_minpos� s z_DummyAxis.get_minposc C s | j jS r( �r+ r2 r3 r# r# r% �get_data_interval� s z _DummyAxis.get_data_intervalc C s ||f| j _d S r( r: r5 r# r# r% �set_data_interval� s z _DummyAxis.set_data_intervalc C s dS )N� r# r3 r# r# r% �get_tick_space� s z_DummyAxis.get_tick_spaceN)r ) �__name__� __module__� __qualname__r0 r4 r8 r9 r; r< r> r# r# r# r% r' � s r' c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � ZdS ) r Nc C s || _ d S r( )�axis)r. rB r# r# r% �set_axis� s zTickHelper.set_axisc K s | j d krtf |�| _ d S r( )rB r' �r. �kwargsr# r# r% �create_dummy_axis� s z TickHelper.create_dummy_axisc C s | j �||� d S r( )rB r8 r5 r# r# r% r8 � s z TickHelper.set_view_intervalc C s | j �||� d S r( )rB r< r5 r# r# r% r< � s z TickHelper.set_data_intervalc C s | � ||� | �||� d S r( )r8 r< r5 r# r# r% � set_bounds� s zTickHelper.set_bounds) r? r@ rA rB rC rF r8 r< rG r# r# r# r% r � s r c @ sV e Zd ZdZg Zddd�Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dS )r z= Create a string based on a tick value and location. Nc C s t d��dS )z Return the format for tick value *x* at position pos. ``pos=None`` indicates an unspecified location. �Derived must overrideN��NotImplementedError�r. �x�posr# r# r% �__call__� s zFormatter.__call__c s � � |� � fdd�t|�D �S )z1Return the tick labels for all the ticks at once.c s g | ]\}}� ||��qS r# r# )�.0�i�valuer3 r# r% � <listcomp> s z*Formatter.format_ticks.<locals>.<listcomp>)�set_locs� enumerate)r. �valuesr# r3 r% � format_ticks s zFormatter.format_ticksc C s | � |�S )zl Returns the full string representation of the value with the position unspecified. )rN �r. rQ r# r# r% � format_data s zFormatter.format_datac C s | � |�S )z| Return a short string version of the tick value. Defaults to the position-independent long value. )rX rW r# r# r% �format_data_short s zFormatter.format_data_shortc C s dS )N� r# r3 r# r# r% � get_offset s zFormatter.get_offsetc C s || _ d S r( )�locs�r. r\ r# r# r% rS s zFormatter.set_locsc C s |S )a{ Some classes may want to replace a hyphen for minus with the proper unicode symbol (U+2212) for typographical correctness. The default is to not replace it. Note, if you use this method, e.g., in :meth:`format_data` or call, you probably don't want to use it for :meth:`format_data_short` since the toolbar uses this for interactive coord reporting and I doubt we can expect GUIs across platforms will handle the unicode correctly. So for now the classes that override :meth:`fix_minus` should have an explicit :meth:`format_data_short` method r# �r. r$ r# r# r% � fix_minus s zFormatter.fix_minusc C s dS )z6Subclasses may want to override this to set a locator.Nr# )r. �locatorr# r# r% � _set_locator+ s zFormatter._set_locator)N) r? r@ rA �__doc__r\ rN rV rX rY r[ rS r_ ra r# r# r# r% r � s r c @ s" e Zd ZdZdd� Zddd�ZdS )r z� Format the position x to the nearest i-th label where ``i = int(x + 0.5)``. Positions where ``i < 0`` or ``i > len(list)`` have no tick labels. Parameters ---------- labels : list List of labels. c C s || _ t|�| _d S r( )�labels�len�n)r. rc r# r# r% r0 : s zIndexFormatter.__init__Nc C s0 t |d �}|dk s || jkr"dS | j| S dS )z� Return the format for tick value `x` at position pos. The position is ignored and the value is rounded to the nearest integer, which is used to look up the label. � �?r rZ N)�intre rc )r. rL rM rP r# r# r% rN > s zIndexFormatter.__call__)N�r? r@ rA rb r0 rN r# r# r# r% r 0 s r c @ s e Zd ZdZddd�ZdS )r z) Always return the empty string. Nc C s dS )z9 Returns an empty string for all inputs. rZ r# rK r# r# r% rN P s zNullFormatter.__call__)N)r? r@ rA rb rN r# r# r# r% r L s r c @ s2 e Zd ZdZdd� Zd dd�Zdd� Zd d � ZdS ) r zQ Return fixed strings for tick labels based only on position, not value. c C s || _ d| _dS )zK Set the sequence of strings that will be used for labels. rZ N)�seq� offset_string)r. ri r# r# r% r0 [ s zFixedFormatter.__init__Nc C s( |dks|t | j�krdS | j| S dS )a# Returns the label that matches the position regardless of the value. For positions ``pos < len(seq)``, return `seq[i]` regardless of `x`. Otherwise return empty string. `seq` is the sequence of strings that this object was initialized with. NrZ )rd ri rK r# r# r% rN b s zFixedFormatter.__call__c C s | j S r( �rj r3 r# r# r% r[ p s zFixedFormatter.get_offsetc C s || _ d S r( rk )r. Zofsr# r# r% �set_offset_strings s z FixedFormatter.set_offset_string)N)r? r@ rA rb r0 rN r[ rl r# r# r# r% r W s r c @ s" e Zd ZdZdd� Zddd�ZdS )r z� Use a user-defined function for formatting. The function should take in two inputs (a tick value ``x`` and a position ``pos``), and return a string containing the corresponding tick label. c C s || _ d S r( ��func)r. rn r# r# r% r0 s zFuncFormatter.__init__Nc C s | � ||�S )zq Return the value of the user defined function. `x` and `pos` are passed through as-is. rm rK r# r# r% rN � s zFuncFormatter.__call__)Nrh r# r# r# r% r w s r c @ s" e Zd ZdZdd� Zddd�ZdS )r z� Use an old-style ('%' operator) format string to format the tick. The format string should have a single variable format (%) in it. It will be applied to the value (not the position) of the tick. c C s || _ d S r( ��fmt�r. rp r# r# r% r0 � s zFormatStrFormatter.__init__Nc C s | j | S )zw Return the formatted label string. Only the value `x` is formatted. The position is ignored. ro rK r# r# r% rN � s zFormatStrFormatter.__call__)Nrh r# r# r# r% r � s r c @ s" e Zd ZdZdd� Zddd�ZdS )r z� Use a new-style format string (as used by `str.format()`) to format the tick. The field used for the value must be labeled `x` and the field used for the position must be labeled `pos`. c C s || _ d S r( ro rq r# r# r% r0 � s zStrMethodFormatter.__init__Nc C s | j j||d�S )z� Return the formatted label string. `x` and `pos` are passed to `str.format` as keyword arguments with those exact names. )rL rM )rp �formatrK r# r# r% rN � s zStrMethodFormatter.__call__)Nrh r# r# r# r% r � s r c @ s, e Zd ZdZddd�Ze�d�dd� �ZdS ) r z. Tick location is a plain old number. Nc C s� | j �� \}}t|�dk r.|t|�kr.d| S t|| �}|dk rFdn&|dkrRdn|dkr^dn|d krjd nd }|| }|�d �}t|�d kr�|d �d��d�} |d d �dd�} |d dd� �d�} d| | | f }n|�d��d�}|S )z| Return the format for tick val `x` based on the width of the axis. The position `pos` is ignored. � ��@�%d�{�G�z�?�%1.3e� �%1.3f� �%1.2f� j�@�%1.1f�%1.1e�e� r �0�.�+rZ N�%se%s%s) rB r4 �absrg �splitrd �rstrip�replace�lstrip) r. rL rM Zxmin�xmax�drp r$ �tup�mantissa�sign�exponentr# r# r% rN � s& � zOldScalarFormatter.__call__�3.1c C s� t |�dk r |t|�kr d| S |dk r.d}n<|dk r<d}n.|dkrJd}n |d krXd }n|d krfd }nd}|| }|�d �}t|�dkr�|d �d��d�}|d d �dd�}|d d d� �d�}d|||f }n|�d��d�}|S )zP Formats the value `x` based on the size of the axis range `d`. rs rt ru rv 皙�����?rx r{ r} ry r| rw rz r~ r r r� r� r� rZ Nr� )r� rg r� rd r� r� r� ) r. rL r� rp r$ r� r� r� r� r# r# r% � pprint_val� s, z OldScalarFormatter.pprint_val)N)r? r@ rA rb rN r � deprecatedr� r# r# r# r% r � s r c @ s� e Zd ZdZd-dd�Zdd� Zdd� Zeeed �Zd d � Z d d � Z ee e d �Z dd� Z dd� Z ee e d �Zdd� Zd.dd�Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Ze�d(�d)d*� �Z d+d,� Z dS )/r a Format tick values as a number. Tick value is interpreted as a plain old number. If ``useOffset==True`` and the data range is much smaller than the data average, then an offset will be determined such that the tick labels are meaningful. Scientific notation is used for ``data < 10^-n`` or ``data >= 10^m``, where ``n`` and ``m`` are the power limits set using ``set_powerlimits((n,m))``. The defaults for these are controlled by the ``axes.formatter.limits`` rc parameter. Nc C s~ |d krt d }t d | _| �|� t d | _|d kr>t d }| �|� d| _d| _d| _t d | _|d krtt d }|| _ d S ) Nzaxes.formatter.useoffsetz axes.formatter.offset_threshold� text.usetex�axes.formatter.use_mathtextr rZ Tzaxes.formatter.limits�axes.formatter.use_locale) r �_offset_threshold� set_useOffset�_usetex�set_useMathText�orderOfMagnituderr � _scientific� _powerlimits� _useLocale)r. � useOffset� useMathText� useLocaler# r# r% r0 s zScalarFormatter.__init__c C s | j S r( )� _useOffsetr3 r# r# r% � get_useOffset s z ScalarFormatter.get_useOffsetc C s& |dkrd| _ || _n d| _|| _ d S )N)TFr F)�offsetr� �r. �valr# r# r% r� s z ScalarFormatter.set_useOffset��fget�fsetc C s | j S r( )r� r3 r# r# r% � get_useLocale" s z ScalarFormatter.get_useLocalec C s |d krt d | _n|| _d S )Nr� )r r� r� r# r# r% � set_useLocale% s z ScalarFormatter.set_useLocalec C s | j S r( �� _useMathTextr3 r# r# r% �get_useMathText- s z ScalarFormatter.get_useMathTextc C s |d krt d | _n|| _d S �Nr� �r r� r� r# r# r% r� 0 s z ScalarFormatter.set_useMathTextc C s$ t d st d s|S |�dd�S dS )�7 Replace hyphens with a unicode minus. r� zaxes.unicode_minus�-u −N)r r� r^ r# r# r% r_ 8 s zScalarFormatter.fix_minusc C sh t | j�dkrdS || j d| j }t�|�dk r8d}| jrPt�| j |f�}n | j | }| � |�S dS )zI Return the format for tick value `x` at position `pos`. r rZ � $@�:�0�yE>N) rd r\ r� r� �npr� r� �locale� format_stringrr r_ )r. rL rM �xpr$ r# r# r% rN A s zScalarFormatter.__call__c C s t |�| _dS )z� Turn scientific notation on or off. See Also -------- ScalarFormatter.set_powerlimits N)�boolr� )r. �br# r# r% �set_scientificQ s z ScalarFormatter.set_scientificc C s t |�dkrtd��|| _dS )am Sets size thresholds for scientific notation. Parameters ---------- lims : (min_exp, max_exp) A tuple containing the powers of 10 that determine the switchover threshold. Numbers below ``10**min_exp`` and above ``10**max_exp`` will be displayed in scientific notation. For example, ``formatter.set_powerlimits((-3, 4))`` sets the pre-2007 default in which scientific notation is used for numbers less than 1e-3 or greater than 1e4. See Also -------- ScalarFormatter.set_scientific r z%'lims' must be a sequence of length 2N)rd � ValueErrorr� )r. Zlimsr# r# r% �set_powerlimits[ s z ScalarFormatter.set_powerlimitsc C s8 | j rt�d|f�S t|tjj�r,|jr,dS d| S dS )�M Return a short formatted string representation of a number. �%-12grZ N)r� r� r� � isinstancer� ZmaZ MaskedArray�maskrW r# r# r% rY r s z!ScalarFormatter.format_data_shortc C s2 | j rt�d|f�}nd| }| �|�}| �|�S )zG Return a formatted string representation of a number. z%1.10e)r� r� r� �_formatSciNotationr_ )r. rQ r$ r# r# r% rX } s zScalarFormatter.format_datac C s� t | j�dkrdS d}| js"| jr�d}d}| jrN| �| j�}| jdkrNd| }| jr|| js`| jrr| �d| j �}n d| j }| jr�|dkr�dt|� }d�d|t|�df�}n8| jr�|dkr�d| }d�d||df�}nd�||f�}| � |�S )z: Return scientific notation, plus offset. r rZ r� ry z1e%dz\times%s�$) rd r\ r� r� rX r� r� r& �joinr_ )r. r$ Z offsetStrZ sciNotStrr# r# r% r[ � s0 zScalarFormatter.get_offsetc C s6 || _ t| j �dkr2| jr"| �� | �� | �� dS )z1 Set the locations of the ticks. r N)r\ rd r� �_compute_offset�_set_order_of_magnitude� _set_formatr] r# r# r% rS � s zScalarFormatter.set_locsc s` | j }t| j�� �\}}t�|�}|||k||k@ }t|�sHd| _d S |�� |� � }}||ksz|d krv|kr�n n d| _d S tt t |��t t |��g�\�� t � d|�}t�t �� ��}dt� �fdd�t�|d�D �� }� � d| dk�r dt� �fdd�t�|d�D �� }| jd } � d| d| k�rV|� d| d| nd| _d S ) Nr rw c 3 s* | ]"}�d | � d | kr|V qdS )ry Nr# �rO �oom�Zabs_maxZabs_minr# r% � <genexpr>� s �z2ScalarFormatter._compute_offset.<locals>.<genexpr>���ry ru c 3 s. | ]&}� d | �d | dkr|V qdS )ry rw Nr# r� r� r# r% r� � s �)r\ �sortedrB r4 r� �asarrayrd r� �min�maxr� �float�math�copysign�ceil�log10�next� itertools�countr� ) r. r\ r6 r7 ZlminZlmaxr� Zoom_maxr� re r# r� r% r� � s, $$ � �z ScalarFormatter._compute_offsetc C s( | j sd| _d S | jd | jd kr0dkrDn n| jd | _d S t| j�� �\}}t�| j�}|||k||k@ }t� |�}t |�s�d| _d S | j r�t � t �|| ��}n@|d |d kr�|d }n|d }|dkr�d}nt � t �|��}|| jd k�r|| _n || jd k�r || _nd| _d S )Nr rw r� )r� r� r� r� rB r4 r� r� r\ r� rd r� r� �floorr� )r. r6 r7 r\ r� r� r# r# r% r� � s4 $ z'ScalarFormatter._set_order_of_magnitudec C s8 t | j�dk r | j| j�� �}n| j}t�|�| j d| j }t�|�}|dkrbt� t� |��}|dkrnd}t | j�dk r�|d d� }t t � t �|���}t dd| �}dd| }|dkr�t� |tj||d � �� � |k r�|d8 }q�q�q�|d7 }d t|� d | _| j�r d | j | _n| j�r4d t| j� | _d S ) Nr r� r rw ���� ���MbP?ry )�decimalsz%1.�f�$%s$)rd r\ rB r4 r� r� r� r� Zptpr� r� rg r� r� r� �round�strrr r� r� r& )r. Z_locsr\ Z loc_rangeZ loc_range_oomZsigfigsZthreshr# r# r% r� � s0 zScalarFormatter._set_formatr� c C sJ || j d| j }t�|�dk r&d}| jr<t�| j|f�S | j| S d S )Nr� r� r )r� r� r� r� r� r� r� rr )r. rL r� r# r# r% r� " s zScalarFormatter.pprint_valc C s | j r t�� d }t�� d }nd}d}|�d�}z�|d �d��|�}|d d �|d �}|d dd � �d�}| js~| jr�|d kr�|d kr�d }|r�d ||f }|r�|r�d ||f W S d ||f W S nd|||f �d�}|W S W n t k � r� | Y S X d S )N� decimal_point� positive_signr� r� r~ r r� rw rZ �1z 10^{%s%s}z %s{\times}%s�%s%sr� ) r� r� � localeconvr� r� r� r� r� r� � IndexError)r. r$ r� r� r� Z significandr� r� r# r# r% r� , s, z"ScalarFormatter._formatSciNotation)NNN)N) r? r@ rA rb r0 r� r� �propertyr� r� r� r� r� r� r� r_ rN r� r� rY rX r[ rS r� r� r� r r� r� r� r# r# r# r% r � s2 '%# r c @ sp e Zd ZdZddd�Zdd� Zd d � Zdd d �Zd d� Zd dd�Z dd� Z dd� Z e � d�dd� �Zdd� ZdS ) r a Base class for formatting ticks on a log or symlog scale. It may be instantiated directly, or subclassed. Parameters ---------- base : float, optional, default: 10. Base of the logarithm used in all calculations. labelOnlyBase : bool, optional, default: False If True, label ticks only at integer powers of base. This is normally True for major ticks and False for minor ticks. minor_thresholds : (subset, all), optional, default: (1, 0.4) If labelOnlyBase is False, these two numbers control the labeling of ticks that are not at integer powers of base; normally these are the minor ticks. The controlling parameter is the log of the axis data range. In the typical case where base is 10 it is the number of decades spanned by the axis, so we can call it 'numdec'. If ``numdec <= all``, all minor ticks will be labeled. If ``all < numdec <= subset``, then only a subset of minor ticks will be labeled, so as to avoid crowding. If ``numdec > subset`` then no minor ticks will be labeled. linthresh : None or float, optional, default: None If a symmetric log scale is in use, its ``linthresh`` parameter must be supplied here. Notes ----- The `set_locs` method must be called to enable the subsetting logic controlled by the ``minor_thresholds`` parameter. In some cases such as the colorbar, there is no distinction between major and minor ticks; the tick locations might be set manually, or by a locator that puts ticks at integer powers of base and at intermediate locations. For this situation, disable the minor_thresholds logic by using ``minor_thresholds=(np.inf, np.inf)``, so that all ticks will be labeled. To disable labeling of minor ticks when 'labelOnlyBase' is False, use ``minor_thresholds=(0, 0)``. This is the default for the "classic" style. Examples -------- To label a subset of minor ticks when the view limits span up to 2 decades, and all of the ticks when zoomed in to 0.5 decades or less, use ``minor_thresholds=(2, 0.5)``. To label all minor ticks when the view limits span up to 1.5 decades, use ``minor_thresholds=(1.5, 1.5)``. r� FNc C s@ t |�| _|| _|d kr*td r&d}nd}|| _d | _|| _d S )N�_internal.classic_mode�r r )rw 皙�����?)r� �_base� labelOnlyBaser �minor_thresholds� _sublabels� _linthresh)r. �baser� r� � linthreshr# r# r% r0 � s zLogFormatter.__init__c C s || _ dS )z� Change the *base* for labeling. .. warning:: Should always match the base used for :class:`LogLocator` N�r� �r. r� r# r# r% r� � s zLogFormatter.basec C s || _ dS )z� Switch minor tick labeling on or off. Parameters ---------- labelOnlyBase : bool If True, label ticks only at integer powers of base. N)r� )r. r� r# r# r% � label_minor� s zLogFormatter.label_minorc C s� t �| jd �rd| _dS | j}|dkrNz| j�� j}W n tk rL Y nX | j� � \}}||krn|| }}|dkr�|dkr�dh| _dS | j }|dk �rd}|| k r�t || �}|t � || �t � |� 7 }||k�r6t||�}|t � || �t � |� 7 }n4t � |�t � |� }t � |�t � |� }t|| �}|| jd k�rPdh| _nV|| jd k�r�t jddt|�d d |d�} tt �| ��| _ntt �d|d ��| _dS )z� Use axis view limits to control which ticks are labeled. The *locs* parameter is ignored in the present algorithm. r Nrw r )r� )r� Zisinfr� r� r� rB Z get_transformr� �AttributeErrorr4 r� r� r� �logr� r� Zlogspacerg �setr� �arange) r. r\ r� r6 r7 r� �numdecZrhsZlhs�cr# r# r% rS � sB zLogFormatter.set_locsc C s8 |dkrd| }n"|dk r$d| }n| � ||| �}|S )N�' z%1.0erw �� _pprint_val)r. rL r6 r7 r$ r# r# r% �_num_to_string� s zLogFormatter._num_to_stringc C s� |dkr dS t |�}| j}t�|�t�|� }t|�}|rDt�|�nt�|�}t�||| �}| jrn|sndS | j dk r�|| j kr�dS | j � � \}} t j || dd�\}} | �||| �} | �| �S )z5 Return the format for tick val *x*. � r� rZ N皙�����?��expander)r� r� r� r� �is_close_to_intr� r� r� r� r� rB r4 r) � nonsingularr� r_ ) r. rL rM r� �fx� is_x_decader� �coeffr6 r7 r$ r# r# r% rN � s zLogFormatter.__call__c C s& | j }d| _ t�| �|��}|| _ |S )NF)r� r Z strip_mathrN )r. rQ r� r# r# r% rX s zLogFormatter.format_datac C s d| S )r� r� r# rW r# r# r% rY s z LogFormatter.format_data_shortr� c O s | j ||�S r( r� �r. �argsrE r# r# r% r� s zLogFormatter.pprint_valc C s� t |�dk r |t|�kr d| S |dk r,dn&|dkr8dn|dkrDdn|d krPd nd }|| }|�d �}t|�d kr�|d �d��d�}t|d �}|r�d||f }q�|}n|�d��d�}|S )Nrs rt ru rv rw rx ry rz r{ r| r} r~ r r r� r� z%se%d)r� rg r� rd r� )r. rL r� rp r$ r� r� r� r# r# r% r� s$ � zLogFormatter._pprint_val)r� FNN)N)N)r? r@ rA rb r0 r� r� rS r� rN rX rY r r� r� r� r# r# r# r% r J s 9 � < r c @ s e Zd ZdZdd� ZdS )r �J Format values for log axis using ``exponent = log_base(value)``. c C sl t �|�t �| j� }t|�dkr,d| }n<t|�dk rBd| }n&t �|| �t �| j� }| �||�}|S )Nr� z%1.0grw )r� r� r� r� r� )r. rL r6 r7 r r$ �fdr# r# r% r� 3 s z#LogFormatterExponent._num_to_stringN)r? r@ rA rb r� r# r# r# r% r / s r c @ s" e Zd ZdZdd� Zddd�ZdS )r r c C s, |rd|||f S dt d|||f � S dS )�&Return string for non-decade locationsz $%s%s^{%.2f}$r� z %s%s^{%.2f}N)r& )r. � sign_stringr� r �usetexr# r# r% �_non_decade_formatD s �z'LogFormatterMathtext._non_decade_formatNc C s^ t d }t d }|dkr,|r dS dtd� S |dk r8dnd}t|�}| j}t�|�t�|� }t|�}|rtt�|�nt� |�} t�||| �} |r�t|�}| j r�|s�dS | j d k r�| | j kr�dS |d d kr�d | } nd | } t�|�|k �r|�rd� ||�S d� td� ||���S n@|�s0| � || ||�S |�rDd|| |f S dtd|| |f � S d S )z_ Return the format for tick value *x*. The position *pos* is ignored. r� zaxes.formatter.min_exponentr z$0$r� r� r� rZ Nrw r� rt z%sz ${0}{1:g}$z${0}$z{0}{1:g}z $%s%s^{%d}$z %s%s^{%d})r r& r� r� r� r� r r� r� r� r� r� rr r ) r. rL rM r �min_expr r� r r r� r r� r# r# r% rN L sB �z LogFormatterMathtext.__call__)N)r? r@ rA rb r rN r# r# r# r% r ? s r c @ s e Zd ZdZdd� ZdS )r zL Format values following scientific notation in a logarithmic axis. c C sb t |�}t�|�}|| || }t|�r2t|�}|rFd||||f S dtd||||f � S dS )r z$%s%g\times%s^{%d}$r� z%s%g\times%s^{%d}N)r� r� r� r r� r& )r. r r� r r r� r� r r# r# r% r � s � �z*LogFormatterSciNotation._non_decade_formatN)r? r@ rA rb r r# r# r# r% r � s r c @ s" e Zd ZdZddd�Zdd� ZdS )r z2 Probability formatter (using Math text). Nc C s� d}d| krdkr(n n d� |�}n^|dk rVt|�rJd� t�|��}q�d� |�}n0td| �rxd� t�d| ��}nd � d| �}|S ) NrZ ru g�G�z��?z{:.2f}z$10^{{{:.0f}}}$z${:.5f}$rw z$1-10^{{{:.0f}}}$z $1-{:.5f}$)rr � is_decader� r� �r. rL rM r$ r# r# r% rN � s zLogitFormatter.__call__c C s d| S )z:return a short formatted string representation of a numberr� r# rW r# r# r% rY � s z LogitFormatter.format_data_short)N)r? r@ rA rb rN rY r# r# r# r% r � s r c @ s� e Zd ZdZdddddddd d d d d dddddd�Zd(ddd�dd�Zdd� Zdd � Zeeed �Z d d � Z d d!� Z ee e d �Z d"d#� Z d)d$d%�Zd&d'� ZdS )*r z� Formats axis values using engineering prefixes to represent powers of 1000, plus a specified unit, e.g., 10 MHz instead of 1e7. �y�z�ar� �pre � µ�mrZ �k�M�G�T�P�E�Z�Y)i��i��i��i�i�i����i�������r r� � r= � � � � � N� )r r� c C s* || _ || _|| _| �|� | �|� dS )a� Parameters ---------- unit : str (default: "") Unit symbol to use, suitable for use with single-letter representations of powers of 1000. For example, 'Hz' or 'm'. places : int (default: None) Precision with which to display the number, specified in digits after the decimal point (there will be between one and three digits before the decimal point). If it is None, the formatting falls back to the floating point format '%g', which displays up to 6 *significant* digits, i.e. the equivalent value for *places* varies between 0 and 5 (inclusive). sep : str (default: " ") Separator used between the value and the prefix/unit. For example, one get '3.14 mV' if ``sep`` is " " (default) and '3.14mV' if ``sep`` is "". Besides the default behavior, some other useful options may be: * ``sep=""`` to append directly the prefix/unit to the value; * ``sep="\N{THIN SPACE}"`` (``U+2009``); * ``sep="\N{NARROW NO-BREAK SPACE}"`` (``U+202F``); * ``sep="\N{NO-BREAK SPACE}"`` (``U+00A0``). usetex : bool (default: None) To enable/disable the use of TeX's math mode for rendering the numbers in the formatter. useMathText : bool (default: None) To enable/disable the use mathtext for rendering the numbers in the formatter. N)r* �places�sep� set_usetexr� )r. r* r) r* r r� r# r# r% r0 � s $ zEngFormatter.__init__c C s | j S r( )r� r3 r# r# r% � get_usetex� s zEngFormatter.get_usetexc C s |d krt d | _n|| _d S )Nr� )r r� r� r# r# r% r+ � s zEngFormatter.set_usetexr� c C s | j S r( r� r3 r# r# r% r� � s z EngFormatter.get_useMathTextc C s |d krt d | _n|| _d S r� r� r� r# r# r% r� s z EngFormatter.set_useMathTextc C s t �| |�S )r� )r r_ r^ r# r# r% r_ s zEngFormatter.fix_minusc C sD d| � |�| jf }| jr:|�| j�r:|d t| j� � }| �|�S )Nr� )� format_engr* r* �endswithrd r_ r r# r# r% rN s zEngFormatter.__call__c C s d}| j dkrdn d�| j �}|dk r0d}| }|dkrVtt�t�|�d �d �}nd}d}t�|t| j �t | j ��}|| d | }t t t||���d kr�|t | j �k r�|d }|d7 }| j t|� }| j s�| jr�d j|| j||d �}nd j|| j||d �}|S )ux Formats a number in engineering notation, appending a letter representing the power of 1000 of the original number. Some examples: >>> format_eng(0) # for self.places = 0 '0' >>> format_eng(1000000) # for self.places = 1 '1.0 M' >>> format_eng("-1e-6") # for self.places = 2 '-1.00 µ' rw N�gz.{:d}fr r� r� r� r� �� z${mant:{fmt}}${sep}{prefix})�mantr* �prefixrp z{mant:{fmt}}{sep}{prefix})r) rr rg r� r� r� r� �clipr� � ENG_PREFIXESr� r� r� r� r� r* )r. Znumr� rp Zpow10r1 r2 Z formattedr# r# r% r- s> � � �zEngFormatter.format_eng)rZ Nr( )N)r? r@ rA rb r4 r0 r, r+ r� r r� r� r� r_ rN r- r# r# r# r% r � s> �� * r c @ sN e Zd ZdZddd�Zddd �Zd d � Zd d � Zedd� �Z e j dd� �Z dS )r a� Format numbers as a percentage. Parameters ---------- xmax : float Determines how the number is converted into a percentage. *xmax* is the data value that corresponds to 100%. Percentages are computed as ``x / xmax * 100``. So if the data is already scaled to be percentages, *xmax* will be 100. Another common situation is where `xmax` is 1.0. decimals : None or int The number of decimal places to place after the point. If *None* (the default), the number will be computed automatically. symbol : string or None A string that will be appended to the label. It may be *None* or empty to indicate that no symbol should be used. LaTeX special characters are escaped in *symbol* whenever latex mode is enabled, unless *is_latex* is *True*. is_latex : bool If *False*, reserved LaTeX characters in *symbol* will be escaped. �d N�%Fc C s |d | _ || _|| _|| _d S )Nr� )r� r� �_symbol� _is_latex)r. r� r� �symbolZis_latexr# r# r% r0 d s zPercentFormatter.__init__c C s, | j �� \}}t|| �}| �| �||��S )zP Formats the tick as a percentage with the appropriate scaling. )rB r4 r� r_ � format_pct)r. rL rM Zax_minZax_max� display_ranger# r# r% rN j s zPercentFormatter.__call__c C s� | � |�}| jdkr`| � |�}|dkr,d}qft�dt�d| � �}|dkrRd}qf|dk rfd}n| j}dj|t|�d�}|| j S )a� Formats the number as a percentage number with the correct number of decimals and adds the percent symbol, if any. If `self.decimals` is `None`, the number of digits after the decimal point is set based on the `display_range` of the axis as follows: +---------------+----------+------------------------+ | display_range | decimals | sample | +---------------+----------+------------------------+ | >50 | 0 | ``x = 34.5`` => 35% | +---------------+----------+------------------------+ | >5 | 1 | ``x = 34.5`` => 34.5% | +---------------+----------+------------------------+ | >0.5 | 2 | ``x = 34.5`` => 34.50% | +---------------+----------+------------------------+ | ... | ... | ... | +---------------+----------+------------------------+ This method will not be very good for tiny axis ranges or extremely large ones. It assumes that the values on the chart are percentages displayed on a reasonable scale. Nr � @� z{x:0.{decimals}f})rL r� )�convert_to_pctr� r� r� r� rr rg r9 )r. rL r; Z scaled_ranger� r$ r# r# r% r: s s zPercentFormatter.format_pctc C s d|| j S )Ng Y@)r� )r. rL r# r# r% r> � s z PercentFormatter.convert_to_pctc C s< | j }|sd}n(td r8| js8dD ]}|�|d| �}q"|S )z� The configured percent symbol as a string. If LaTeX is enabled via :rc:`text.usetex`, the special characters ``{'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'}`` are automatically escaped in the string. rZ r� z \#$%&~_^{}�\)r7 r r8 r� )r. r9 �specr# r# r% r9 � s zPercentFormatter.symbolc C s || _ d S r( )r7 )r. r9 r# r# r% r9 � s )r5 Nr6 F)N) r? r@ rA rb r0 rN r: r> r� r9 �setterr# r# r# r% r J s / r c @ sd e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z dd� ZdS )r z� Determine the tick locations; Note that the same locator should not be used across multiple `~matplotlib.axis.Axis` because the locator stores references to the Axis data and view limits. r0 c C s t d��dS )a� Return the values of the located ticks given **vmin** and **vmax**. .. note:: To get tick locations with the vmin and vmax values defined automatically for the associated :attr:`axis` simply call the Locator instance:: >>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4] rH NrI r5 r# r# r% � tick_values� s zLocator.tick_valuesc K s t �dtt| �� � dS )z� Do nothing, and raise a warning. Any locator class not supporting the set_params() function will call this. z/'set_params()' not defined for locator of type N)r �_warn_externalr� �typerD r# r# r% � set_params� s ��zLocator.set_paramsc C s t d��dS )�!Return the locations of the ticksrH NrI r3 r# r# r% rN � s zLocator.__call__c C s0 t |�| jkr,td�t |�|d |d ���|S )zUraise a RuntimeError if Locator attempts to create more than MAXTICKS locszOLocator attempting to generate {} ticks from {} to {}: exceeds Locator.MAXTICKSr r� )rd �MAXTICKS� RuntimeErrorrr r] r# r# r% �raise_if_exceeds� s �zLocator.raise_if_exceedsc C s t j||dd�S )z0Expand a range as needed to avoid singularities.r r �r) r )r. Zv0Zv1r# r# r% r � s zLocator.nonsingularc C s t �||�S )z� Select a scale for the range from vmin to vmax. Subclasses should override this method to change locator behaviour. rJ r5 r# r# r% � view_limits� s zLocator.view_limitsc C s | j | j�� � S )zautoscale the view limits)rK rB r4 r3 r# r# r% � autoscale s zLocator.autoscalec C s� | � }t |�}| j�� \}}tj||dd�\}}|dkrR|t|d |d � }nt|| �}|| d }||7 }||7 }| jj||dd� d S ) z*Pan numticks (can be positive or negative)r r r r rw g @T��ignoreN)rd rB r4 r) r r� r8 )r. Znumsteps�ticks�numticksr6 r7 �stepr� r# r# r% �pan s z Locator.panc C sX | j �� \}}tj||dd�\}}t|| �}d| | }| j j|| || dd� dS )z>Zoom in/out on axis; if direction is >0 zoom in, else zoom outr r r� TrM N)rB r4 r) r r� r8 )r. � directionr6 r7 ZintervalrQ r# r# r% �zoom s z Locator.zoomc C s dS )�1refresh internal information based on current limNr# r3 r# r# r% �refresh s zLocator.refreshN)r? r@ rA rb rG rB rE rN rI r rK rL rR rT rV r# r# r# r% r � s r c @ s2 e Zd ZdZdd� Zd dd�Zdd� Zd d � ZdS ) r z� Place a tick on every multiple of some base number of points plotted, e.g., on every 5th point. It is assumed that you are doing index plotting; i.e., the axis is 0, len(data). This is mainly useful for x ticks. c C s || _ || _dS )z<place ticks on the i-th data points where (i-offset)%base==0N�r� r� �r. r� r� r# r# r% r0 , s zIndexLocator.__init__Nc C s |dk r|| _ |dk r || _dS )z"Set parameters within this locatorNrW rX r# r# r% rE 1 s zIndexLocator.set_paramsc C s | j �� \}}| �||�S �rF )rB r; rB �r. �dmin�dmaxr# r# r% rN 8 s zIndexLocator.__call__c C s | � t�|| j |d | j��S )Nrw )rI r� r� r� r� r5 r# r# r% rB = s �zIndexLocator.tick_values)NN�r? r@ rA rb r0 rE rN rB r# r# r# r% r % s r c @ s4 e Zd ZdZd dd�Zd dd�Zdd� Zd d � ZdS ) r an Tick locations are fixed. If nbins is not None, the array of possible positions will be subsampled to keep the number of ticks <= nbins +1. The subsampling will be done so as to include the smallest absolute value; for example, if zero is included in the array of possibilities, then it is guaranteed to be one of the chosen ticks. Nc C s( t �|�| _|d k r t|d�nd | _d S )Nr )r� r� r\ r� �nbins)r. r\ r^ r# r# r% r0 M s zFixedLocator.__init__c C s |dk r|| _ dS ��#Set parameters within this locator.N)r^ )r. r^ r# r# r% rE Q s zFixedLocator.set_paramsc C s | � d d �S r( �rB r3 r# r# r% rN V s zFixedLocator.__call__c C s� | j dkr| jS ttt�t| j�| j ��d�}| jdd|� }td|�D ]4}| j|d|� }t�|�� � t�|�� � k rJ|}qJ| � |�S )z�" Return the locations of the ticks. .. note:: Because the values are fixed, vmin and vmax are not used in this method. Nrw ) r^ r\ r� rg r� r� rd �ranger� r� rI )r. r6 r7 rQ rO rP Zticks1r# r# r% rB Y s zFixedLocator.tick_values)N)Nr] r# r# r# r% r B s r c @ s e Zd ZdZdd� Zdd� ZdS )r z No ticks c C s | � d d �S r( ra r3 r# r# r% rN s s zNullLocator.__call__c C s g S )z�" Return the locations of the ticks. .. note:: Because the values are Null, vmin and vmax are not used in this method. r# r5 r# r# r% rB v s zNullLocator.tick_valuesN)r? r@ rA rb rN rB r# r# r# r% r n s r c @ sD e Zd ZdZddd�Zddd�Zdd� Zd d � Zd d � Zd d� Z dS )r a Determine the tick locations The first time this function is called it will try to set the number of ticks to make a nice tick partitioning. Thereafter the number of ticks will be fixed so that interactive navigation will be nice Nc C s || _ |dkri | _n|| _dS )zX Use presets to set locs based on lom. A dict mapping vmin, vmax->locs N)rP �presets�r. rP rc r# r# r% r0 � s zLinearLocator.__init__c C s |dk r|| _ |dk r || _dS r_ )rc rP rd r# r# r% rE � s zLinearLocator.set_paramsc C s | j �� \}}| �||�S rY �rB r4 rB r5 r# r# r% rN � s zLinearLocator.__call__c C s| t j||dd�\}}||k r&|| }}||f| jkrB| j||f S | jd krT| �� | jdkrbg S t�||| j�}| �|�S )Nr r r )r) r rc rP � _set_numticksr� ZlinspacerI )r. r6 r7 �ticklocsr# r# r% rB � s zLinearLocator.tick_valuesc C s d| _ d S )N� )rP r3 r# r# r% rf � s zLinearLocator._set_numticksc C s� ||k r|| }}||kr*|d8 }|d7 }t d dkr�tt�|| �t�t| jd d���\}}||dk 8 }t| jd d�| }t�|| �| }t�|| �| }t� ||�S )�+Try to choose the view limits intelligentlyrw �axes.autolimit_mode� round_numbersrf ) r �divmodr� r� r� rP r� r� r) r )r. r6 r7 r� Z remainder�scaler# r# r% rK � s � zLinearLocator.view_limits)NN)NN) r? r@ rA rb r0 rE rN rB rf rK r# r# r# r% r � s r �3.0c C s t | | �dk S �N绽���|�=)r� )rL r r# r# r% �closeto� s rq c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dS )�BasezEthis solution has some hacks to deal with floating point inaccuraciesc C s |dkrt d��|| _d S )Nr z'base' must be positive)r� r� r� r# r# r% r0 � s z Base.__init__c C sB t || j�\}}t|d�r8t|| j d�s8|d | j S || j S )z'return the largest multiple of base < xr rw �rl r� rq �r. rL r� r r# r# r% �lt� s zBase.ltc C s8 t || j�\}}t|| j d�r.|d | j S || j S )z(return the largest multiple of base <= xrw rs rt r# r# r% �le� s zBase.lec C s< t || j�\}}t|| j d�r.|d | j S |d | j S )z(return the smallest multiple of base > xrw r rs rt r# r# r% �gt� s zBase.gtc C sB t || j�\}}t|d�r4t|| j d�s4|| j S |d | j S )z)return the smallest multiple of base >= xr rw rs rt r# r# r% �ge� s zBase.gec C s | j S r( r� r3 r# r# r% �get_base� s z Base.get_baseN) r? r@ rA rb r0 ru rv rw rx ry r# r# r# r% rr � s rr c @ s: e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd S )r zQ Set a tick on each integer multiple of a base within the view interval. � �?c C s t |d�| _d S )Nr �� _Edge_integer�_edger� r# r# r% r0 � s zMultipleLocator.__init__c C s |dk rt |d�| _dS )r` Nr r{ r� r# r# r% rE s zMultipleLocator.set_paramsc C s | j �� \}}| �||�S rY re r5 r# r# r% rN s zMultipleLocator.__call__c C sb ||k r|| }}| j j}| j �|�| }|| d| | }|| t�|d �| }| �|�S )Nr� r� )r} rQ rx r� r� rI )r. r6 r7 rQ re r\ r# r# r% rB s zMultipleLocator.tick_valuesc C sb t d dkrN| j�|�| jj }| j�|�| jj }||krV|d8 }|d7 }n|}|}t�||�S )ze Set the view limits to the nearest multiples of base that contain the data. rj rk rw )r r} rv rQ rx r) r )r. r[ r\ r6 r7 r# r# r% rK s zMultipleLocator.view_limitsN)rz � r? r@ rA rb r0 rE rN rB rK r# r# r# r% r � s r rw r5 c C sj t || �}|| d }t |�| |k r.d}n t�dt�t |��d |�}dt�|| �d }||fS )Nr r ry rw )r� r� r� r� )r6 r7 re Z thresholdZdvZmeanvr� rm r# r# r% � scale_range' s r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) r| z� Helper for MaxNLocator, MultipleLocator, etc. Take floating point precision limitations into account when calculating tick locations as integer multiples of a step. c C s$ |dkrt d��|| _t|�| _dS )z� *step* is a positive floating-point interval between ticks. *offset* is the offset subtracted from the data limits prior to calculating tick locations. r z'step' must be positiveN)r� rQ r� �_offset)r. rQ r� r# r# r% r0 9 s z_Edge_integer.__init__c C sN | j dkr:t�| j | j �}tdd|d �}td|�}nd}t|| �|k S )Nr rp ry r# g<Nё\��?)r� r� r� rQ r� r� r� )r. Zms�edgeZdigitsZtolr# r# r% rq D s z_Edge_integer.closetoc C s. t || j�\}}| �|| j d�r*|d S |S )z"Return the largest n: n*step <= x.rw �rl rQ rq rt r# r# r% rv N s z_Edge_integer.lec C s. t || j�\}}| �|| j d�r&|S |d S )z#Return the smallest n: n*step >= x.r rw r� rt r# r# r% rx U s z_Edge_integer.geN)r? r@ rA rb r0 rq rv rx r# r# r# r% r| 2 s r| c @ sl e Zd ZdZeddddddd�Zdd� Zed d � �Zed d � �Z d d� Z dd� Z dd� Z dd� Z dd� ZdS )r z< Select no more than N intervals at nice locations. ry NFr )r^ �steps�integer� symmetric�prune� min_n_ticksc O sP |r:d|krt jddd� |d |d< t|�dkr:td��| jf | j|�� dS ) aX Parameters ---------- nbins : int or 'auto', optional, default: 10 Maximum number of intervals; one less than max number of ticks. If the string `'auto'`, the number of bins will be automatically determined based on the length of the axis. steps : array-like, optional Sequence of nice numbers starting with 1 and ending with 10; e.g., [1, 2, 4, 5, 10], where the values are acceptable tick multiples. i.e. for the example, 20, 40, 60 would be an acceptable set of ticks, as would 0.4, 0.6, 0.8, because they are multiples of 2. However, 30, 60, 90 would not be allowed because 3 does not appear in the list of steps. integer : bool, optional, default: False If True, ticks will take only integer values, provided at least `min_n_ticks` integers are found within the view limits. symmetric : bool, optional, default: False If True, autoscaling will result in a range symmetric about zero. prune : {'lower', 'upper', 'both', None}, optional, default: None Remove edge ticks -- useful for stacked or ganged plots where the upper tick of one axes overlaps with the lower tick of the axes above it, primarily when :rc:`axes.autolimit_mode` is ``'round_numbers'``. If ``prune=='lower'``, the smallest tick will be removed. If ``prune == 'upper'``, the largest tick will be removed. If ``prune == 'both'``, the largest and smallest ticks will be removed. If ``prune == None``, no ticks will be removed. min_n_ticks : int, optional, default: 2 Relax *nbins* and *integer* constraints if necessary to obtain this minimum number of ticks. r^ r� z�Calling MaxNLocator with positional and keyword parameter *nbins* is considered an error and will fail in future versions of matplotlib.��messager rw z6Keywords are required for all arguments except 'nbins'N)r r� rd r� rE �default_paramsr r# r# r% r0 h s '� �zMaxNLocator.__init__c C s� t �| �std��t �| �} t �t �| �dk�sH| d dksH| d dk rPtd��| d dkrjt �d| f�} | d dkr�t �| df�} | S )NzSsteps argument must be an increasing sequence of numbers between 1 and 10 inclusiver r� ry rw )r� �iterabler� r� �anyZdiff�hstack)r� r# r# r% �_validate_steps� s , zMaxNLocator._validate_stepsc C s( d| d d� | d| d f}t �|�S )Nr� r� ry rw )r� r� )r� Zflightsr# r# r% � _staircase� s zMaxNLocator._staircasec K s d|kr*|� d�| _| jdkr*t| j�| _d|kr>|� d�| _d|krn|� d�}|dk rh|dkrhtd��|| _d|kr�td |� d��| _d |kr�|� d �}|dkr�t� d d d d ddddddg �| _ n | � |�| _ | � | j �| _ d|kr�|� d�| _|�r|�� \}}tjdd|� �d� dS )a Set parameters for this locator. Parameters ---------- nbins : int or 'auto', optional see `.MaxNLocator` steps : array-like, optional see `.MaxNLocator` integer : bool, optional see `.MaxNLocator` symmetric : bool, optional see `.MaxNLocator` prune : {'lower', 'upper', 'both', None}, optional see `.MaxNLocator` min_n_ticks : int, optional see `.MaxNLocator` r^ �autor� r� N)�upper�lower�bothz/prune must be 'upper', 'lower', 'both', or Noner� rw r� g �?r � @r� � r= r" � ry r� r� z4MaxNLocator.set_params got an unexpected parameter: r� )�pop�_nbinsrg � _symmetricr� �_pruner� � _min_n_ticksr� �arrayZ_stepsr� r� �_extended_steps�_integer�popitemr �warn_deprecated)r. rE r� r� �key�_r# r# r% rE � s8 � " �zMaxNLocator.set_paramsc C s� | j dkr<| jdk r6t�| j�� td| jd �d�}qBd}n| j }t|||�\}}|| }|| }|| | }| j| } | j r�| dk t� | t� | � �dk B } | | } t� | |k�d d } t d dk�r t| t| ��D ]2} | | } || | } | | | }||kr� �q q�tt| d ��D ]�} | | } | j �rZt�|�t�|� | jd k�rZtd| �} || | } t| |�}|�|| �}|�|| �}t�||d �| | }||k||k@ �� }|| jk�r �qΐq || S ) z� Generate a list of tick locations including the range *vmin* to *vmax*. In some applications, one or both of the end locations will not be needed, in which case they are trimmed off elsewhere. r� Nrw r= r� r rj rk )r� rB r� r3 r> r� r� r r� r� r� r� Znonzeror rb rd �reversedr� r� r| rv rx r� �sum)r. r6 r7 r^ rm r� Z_vminZ_vmaxZraw_stepr� ZigoodZisteprQ Z best_vminZ best_vmaxr� ZlowZhighrO Znticksr# r# r% � _raw_ticks� sN � � zMaxNLocator._raw_ticksc C s | j �� \}}| �||�S r( re r5 r# r# r% rN s zMaxNLocator.__call__c C s� | j r tt|�t|��}| }tj||ddd�\}}| �||�}| j}|dkr\|dd � }n*|dkrr|d d� }n|dkr�|dd� }| �|�S ) N�vIh�%<=g�+����=�r Ztinyr� rw r� r� r� )r� r� r� r) r r� r� rI )r. r6 r7 r\ r� r# r# r% rB # s$ � zMaxNLocator.tick_valuesc C s` | j r tt|�t|��}| }tj||ddd�\}}td dkrT| �||�ddg S ||fS d S )Ng�-���q=r� r� rj rk r r� )r� r� r� r) r r r� rZ r# r# r% rK 4 s � zMaxNLocator.view_limits)r? r@ rA rb �dictr� r0 � staticmethodr� r� rE r� rN rB rK r# r# r# r% r ] s$ �4 0<r r� ry c C s0 | dkr| S t �t �| �t �|� �}|| S )z#floor x to the nearest lower decader� )r� r� r� �rL r� Zlxr# r# r% � decade_downB s r� c C s. | dkr |S t �t �| �t �|� �}|| S )z#ceil x to the nearest higher decader� )r� r� r� r� r# r# r% � decade_upK s r� c C s4 t jdddddd� | dkr(t| d �S t| d �S ) Nrn r� z`nearest_long`Zfunctionz`round`)Zremoval�nameZobj_typeZ alternativer rf )r r� rg �rL r# r# r% � nearest_longT s � r� c C s< t �| �sdS | dkrdS t �t �| ��t �|� }t|�S )NFr� T)r� �isfiniter� r� r r� r# r# r% r \ s r c C s@ | dkr | S | dk r"t | |� S |t�t�| �t�|� � S )z� Return the largest integer power of *base* that's less or equal to *x*. If *x* is negative, the exponent will be *greater*. r )�_decade_greater_equalr� r� r� �rL r� r# r# r% �_decade_less_equale s �r� c C s@ | dkr | S | dk r"t | |� S |t�t�| �t�|� � S )z� Return the smallest integer power of *base* that's greater or equal to *x*. If *x* is negative, the exponent will be *smaller*. r )r� r� r� r� r� r# r# r% r� p s �r� c C s4 | dk rt | |� S t| |�}|| kr0|| }|S )z� Return the largest integer power of *base* that's less than *x*. If *x* is negative, the exponent will be *greater*. r )�_decade_greaterr� )rL r� Zlessr# r# r% � _decade_less{ s r� c C s4 | dk rt | |� S t| |�}|| kr0||9 }|S )z� Return the smallest integer power of *base* that's greater than *x*. If *x* is negative, the exponent will be *smaller*. r )r� r� )rL r� Zgreaterr# r# r% r� � s r� c C s t | t�| � �dk S ro )r� r� r� r� r# r# r% r � s r c @ sT e Zd ZdZddd�Zddd �Zd d � Zd d � Zdd� Zdd� Z dd� Z dd� Z dS )r z3 Determine the tick locations for log axes r� �rz r� Nc C s> |dkrt d rd}nd}| �|� | �|� || _|| _dS )a Place ticks on the locations : subs[j] * base**i Parameters ---------- subs : None, string, or sequence of float, optional, default (1.0,) Gives the multiples of integer powers of the base at which to place ticks. The default places ticks only at integer powers of the base. The permitted string values are ``'auto'`` and ``'all'``, both of which use an algorithm based on the axis view limits to determine whether and how to put ticks between integer powers of the base. With ``'auto'``, ticks are placed only between integer powers; with ``'all'``, the integer powers are included. A value of None is equivalent to ``'auto'``. Nr� r$ r� )r r� �subs�numdecsrP �r. r� r� r� rP r# r# r% r0 � s zLogLocator.__init__c C sD |dk r| � |� |dk r$| �|� |dk r2|| _|dk r@|| _dS r_ )r� r� r� rP r� r# r# r% rE � s zLogLocator.set_paramsc C s t |�| _dS )zW set the base of the log scaling (major tick every base**i, i integer) N)r� r� r� r# r# r% r� � s zLogLocator.basec C sJ |dkrd| _ n6t|t�r6|dkr.td| ��|| _ ntj|td�| _ dS )zO set the minor ticks for the log scaling every base**i*subs[j] Nr� )�allr� z2A subs string must be 'all' or 'auto'; found '%s'.)Zdtype)�_subsr� r� r� r� r� r� )r. r� r# r# r% r� � s �zLogLocator.subsc C s | j �� \}}| �||�S rY re r5 r# r# r% rN � s zLogLocator.__call__c s� | j dkr0| jd k r*t�| j�� dd�}q6d}n| j }| j}t| jd�r�| jjjdkr�t � t � |�t � |� �}t� || j |�}|| }|S |dkr�| jd k r�| j�� }|dks�t�|�s�td��t�d||� ||k r�|| }}t � |�t � |� }t � |�t � |� }t �|�t � |� } t| jt��r�| jdk�r>d nd } | d k�sV|d k �rz| jdk�rlt�g �S t�d g�� n t� | |�� n| j� td �r�tt � | |d �d�n| d | d } t� �dk�p�t� �dk�o� d d k} t� t �|�| t � |�d| | �}t| d��rZ| j� � � |�}| �r�| dk�rNt� t� � |��}n t�g �}nB| �r�| dk�r�t� � fdd�|| D ��}n t�g �}n|| }t�d|� t� �dk�r�| dk�r�||k||k@ �!� dk�r�t"� �#||�S | �$|�S d S )Nr� r r= �axes�polarr� zAData has no positive values, and therefore can not be log-scaled.zvmin %s vmax %sr< rz ry r� r� rw r � _transformc s g | ] }� | �qS r# r# )rO Z decade_start�r� r# r% rR , s z*LogLocator.tick_values.<locals>.<listcomp>z ticklocs %r)%rP rB r� r3 r> r� �hasattrr� r� r� r� r� r� r� r9 r� r� �_log�debugr� r� r� r� r� r r� rd r� �inverted� transform�ravel�outerZ concatenater� r rB rI ) r. r6 r7 rP r� �decadesrg Zlog_vminZlog_vmaxr� Z_first�strideZ have_subsr# r� r% rB � s| � � �( � � ��zLogLocator.tick_valuesc C sx | j }| �||�\}}| jjjdkrLt�t�|�t�|� �}||| j }t d dkrpt || j �}t || j �}||fS )ri r� rj rk ) r� r rB r� r� r� r� r� r� r r� r� )r. r6 r7 r� r# r# r% rK = s zLogLocator.view_limitsc C s� t �|�rt �|�sdS ||kr*|| }}|dkr@t�d� dS | j�� }t �|�sXd}|dkrd|}||kr�t|| j�}t|| j�}||fS )N)rw ry r z@Data has no positive values, and therefore cannot be log-scaled.gY�� n�) r� r� r rC rB r9 r� r� r� )r. r6 r7 r/ r# r# r% r M s$ � zLogLocator.nonsingular)r� r� r� N)NNNN) r? r@ rA rb r0 rE r� r� rN rB rK r r# r# r# r% r � s Yr c @ s< e Zd ZdZd dd�Zddd�Zdd� Zd d � Zd d � ZdS )r z= Determine the tick locations for symmetric log axes Nc C sb |dk r|j | _|j| _n&|dk r8|dk r8|| _|| _ntd��|dkrRdg| _n|| _d| _dS )z> place ticks on the location= base**i*subs[j] Nz?Either transform, or both linthresh and base, must be provided.rz r$ )r� r� r� r� r� r� rP )r. r� r� r� r� r# r# r% r0 i s z SymmetricalLogLocator.__init__c C s |dk r|| _ |dk r || _dS r_ )rP r� )r. r� rP r# r# r% rE | s z SymmetricalLogLocator.set_paramsc C s | j �� \}}| �||�S rY re r5 r# r# r% rN � s z SymmetricalLogLocator.__call__c sR | j � | j}||k r || }}d } }}|| k rTd}|| kr�d}||kr�d}nT|dk r�|dkrvd}||kr~d}q�||gS n(||k r�||kr�d}d}q�||gS nd}� fdd�}|r�|r�||| d �}q�|| | d �}nd}|�r|�r|||d �} n|||d �} nd} |d |d | d | d } |�rD| d7 } t| | jd d�} g } |�r�| �d� t�|d |d | �d d d� � |�r�| �d � |�r�| �� t�| d | d | � � | jd k�r�t�d � �} n t� | j�} t | �dk�s| d d k�r>g }| D ]*}|dk�r*|�|� n|�| | � �qn| }| � t� |��S ) NFTr c s< t �t �| �t �� � �} t �t �|�t �� � �}| |fS r( )r� r� r� r� )�lo�hi�r� r# r% � get_log_range� s z8SymmetricalLogLocator.tick_values.<locals>.get_log_rangerw r� r� r� r< rz ) r� r� r� rP �extendr� r� �appendr� r� rd rI r� )r. r6 r7 �tZhas_aZhas_bZhas_cr� Za_rangeZc_rangeZ total_ticksr� r� r� rg Zdecader# r� r% rB � sx �� z!SymmetricalLogLocator.tick_valuesc C sd | j }||k r|| }}td dkrTt||�}t||�}||krTt||�}t||�}t�||�}|S )ri rj rk )r� r r� r� r� r� r) r )r. r6 r7 r� �resultr# r# r% rK � s z!SymmetricalLogLocator.view_limits)NNNN)NNr~ r# r# r# r% r d s jr c @ s< e Zd ZdZddd�Zddd�Zdd � Zd d � Zd d � ZdS )r! z5 Determine the tick locations for logit axes Fc C s || _ dS )z4 place ticks on the logit locations N��minor�r. r� r# r# r% r0 s zLogitLocator.__init__Nc C s |dk r|| _ dS r_ r� r� r# r# r% rE s zLogitLocator.set_paramsc C s | j �� \}}| �||�S rY re r5 r# r# r% rN s zLogitLocator.__call__c C s� t | jd�r"| jjjdkr"td��| �||�\}}t�|d| �}t�|d| �}t�|�}t� |�}| j s�g }|dkr�t� |t d|d ��}|� d| � |d kr�|kr�n n |�d� |dkr�t� td|�|d � }|� dd| � n�g }|d k�r<t� |t d|��}t�t� d d�d| ��� }|� |� |d k�rT|k�rnn n|� d d d dddg� |d k�r�t� td |�|d � }dt�t� d d�d| ��� }|� |� | �t�|��S )Nr� r� z%Polar axis cannot be logit scaled yetrw r� r ry rf r� r 皙�����?g333333�?r� g333333�?gffffff�?g�������?)r� rB r� r� rJ r r� r� r� r� r� r� r� r� r� r� r� r� rI r� )r. r6 r7 Z decade_minZ decade_maxrg ZexpoZnewticksr# r# r% rB s: zLogitLocator.tick_valuesc C s� d}t �|�rt �|�s |S ||kr.|| }}| jd k rR| j�� }t �|�sV|S nd}|dkrb|}|dkrrd| }||kr�d| dd| fS ||fS )N)�H�����z>g�P���?r� r rw r� )r� r� rB r9 )r. r6 r7 Z initial_ranger/ r# r# r% r A s" zLogitLocator.nonsingular)F)N) r? r@ rA rb r0 rE rN rB r r# r# r# r% r! s (r! c @ s e Zd ZdZdd� ZdS )r z� Dynamically find major tick positions. This is actually a subclass of `~matplotlib.ticker.MaxNLocator`, with parameters *nbins = 'auto'* and *steps = [1, 2, 2.5, 5, 10]*. c C s@ t d rd}ddddg}nd}dddddg}tj| ||d � d S ) z� To know the values of the non-public parameters, please have a look to the defaults of `~matplotlib.ticker.MaxNLocator`. r� r= rw r r= ry r� r� )r^ r� N)r r r0 )r. r^ r� r# r# r% r0 f s zAutoLocator.__init__N)r? r@ rA rb r0 r# r# r# r% r ` s r c @ s* e Zd ZdZd dd�Zdd� Zdd� ZdS ) r z� Dynamically find minor tick positions based on the positions of major ticks. The scale must be linear with major ticks evenly spaced. Nc C s || _ dS )z� *n* is the number of subdivisions of the interval between major ticks; e.g., n=2 will place a single minor tick midway between major ticks. If *n* is omitted or None, it will be set to 5 or 4. N)�ndivs)r. re r# r# r% r0 y s zAutoMinorLocator.__init__c C s | j �� dkr t�d� g S | j �� }z|d |d }W n tk rR g Y S X | jdkr�dt�|�d }t� |ddd d g�� � r�d }q�d }n| j}|| }| j � � \}}||kr�|| }}|d }|| | d | } || | d | } t� | | |�| } | � | �S ) rF r� z5AutoMinorLocator does not work with logarithmic scalerw r Nry rz r� � @r� r= r� )rB Z get_scaler rC Zget_majorticklocsr� r� r� r� Ziscloser� r4 r� rI ) r. Z majorlocsZ majorstepZmajorstep_no_exponentr� Z minorstepr6 r7 Zt0ZtminZtmaxr\ r# r# r% rN � s. zAutoMinorLocator.__call__c C s t dt| � ��d S �Nz(Cannot get tick locations for a %s type.�rJ rD r5 r# r# r% rB � s �z AutoMinorLocator.tick_values)N)r? r@ rA rb r0 rN rB r# r# r# r% r t s )r c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dS )r" zo On autoscale this class picks the best MultipleLocator to set the view limits and the tick locs. c C s t � | _d S r( )r �_locatorr3 r# r# r% r0 � s zOldAutoLocator.__init__c C s | � � | �| �� �S rY )rV rI r� r3 r# r# r% rN � s zOldAutoLocator.__call__c C s t dt| � ��d S r� r� r5 r# r# r% rB � s �zOldAutoLocator.tick_valuesc C s> | j �� \}}tj||dd�\}}t|| �}| �|�| _dS )rU r r N)rB r4 r) r r� � get_locatorr� �r. r6 r7 r� r# r# r% rV � s zOldAutoLocator.refreshc C s& t || �}| �|�| _| j�||�S )ri )r� r� r� rK r� r# r# r% rK � s zOldAutoLocator.view_limitsc C s� t |�}|dkrtd�}nvzt�|�}W n tk rD td��Y nX t�|�}d| }|d| krj|}n |d| kr�|d }n|d }t|�}|S ) z)pick the best locator based on a distancer r� z'AutoLocator illegal data interval rangery r= r r< r� )r� r r� r� � OverflowErrorrH r� )r. r� r` ZldZfldr� Zticksizer# r# r% r� � s zOldAutoLocator.get_locatorN) r? r@ rA rb r0 rN rB rV rK r� r# r# r# r% r" � s r" )rw r5 )ry )ry )ry )?rb r� Zloggingr� r� Znumpyr� Z matplotlibr r r r) Z getLoggerr? r� �__all__r& �objectr' r r r r r r r r r r r r r r r r r r r r r r r� rq rr r r r| r r� r� r� r r� r� r� r� r r r r! r r r" r# r# r# r% �<module> s� ' > A X fA tg ,I )- + f J !\=