B ]t\=K@sddlZddlmZddlmZmZmZddlmZm Z m Z m Z m Z m Z mZmZmZmZddlmZmZGdddeZGdd d eZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZ GdddeZ!GdddeZ"Gd d!d!eZ#Gd"d#d#eZ$Gd$d%d%eZ%Gd&d'd'eZ&Gd(d)d)eZ'Gd*d+d+eZ(ee"e%e(d,Z)d-d.Z*d/d0Z+e,e+j-d1d2.e*ie+_-d3d4Z/d5d6Z0ej1j2d2.d7d8e*De03d9dS):N)ma)cbook docstringrcParams) NullFormatterScalarFormatterLogFormatterSciNotationLogitFormatter NullLocator LogLocator AutoLocatorAutoMinorLocatorSymmetricalLogLocator LogitLocator) TransformIdentityTransformc@s(eZdZdZddZddZddZdS) ScaleBasea@ The base class for all scales. Scales are separable transformations, working on a single dimension. Any subclasses will want to override: - :attr:`name` - :meth:`get_transform` - :meth:`set_default_locators_and_formatters` And optionally: - :meth:`limit_range_for_scale` cCs tdS)zq Return the :class:`~matplotlib.transforms.Transform` object associated with this scale. N)NotImplementedError)selfr/lib/python3.7/site-packages/matplotlib/scale.py get_transformszScaleBase.get_transformcCs tdS)z Set the :class:`~matplotlib.ticker.Locator` and :class:`~matplotlib.ticker.Formatter` objects on the given axis to match this scale. N)r)raxisrrr#set_default_locators_and_formatters"sz-ScaleBase.set_default_locators_and_formatterscCs||fS)z Returns the range *vmin*, *vmax*, possibly limited to the domain supported by this scale. *minpos* should be the minimum positive value in the data. This is used by log scales to determine a minimum value. r)rvminvmaxminposrrrlimit_range_for_scale*szScaleBase.limit_range_for_scaleN)__name__ __module__ __qualname____doc__rrrrrrrr src@s,eZdZdZdZddZddZddZd S) LinearScalez# The default linear scale. linearcKsdS)Nr)rrkwargsrrr__init__<szLinearScale.__init__cCsf|t|t|t|jdkr6tdsH|jdkrVtdrV|t n |t dS)zd Set the locators and formatters to reasonable defaults for linear scaling. xzxtick.minor.visibleyzytick.minor.visibleN) set_major_locatorr set_major_formatterrset_minor_formatterr axis_namerset_minor_locatorr r )rrrrrr?s   z/LinearScale.set_default_locators_and_formatterscCstS)zy The transform for linear scaling is just the :class:`~matplotlib.transforms.IdentityTransform`. )r)rrrrrNszLinearScale.get_transformN)rrr r!namer%rrrrrrr"5s r"c@s6eZdZdZdZdZdZd ddZddZdd Z d S) LogTransformBaseTclipcCst|ddd||_dS)NTF)r0mask)rr%_clip)rnonposrrrr%\s zLogTransformBase.__init__c CsJtjddd2t|}|t|j}|jrr?r)rrrrr@sz InvertedLogTransformBase.__str__N) rrr rArBrCrDr=r@rrrrrEws rEc@seZdZdZddZdS)Log10Transformg$@cCstS)N)InvertedLog10Transform)rrrrinvertedszLog10Transform.invertedN)rrr r:rIrrrrrGsrGc@seZdZdZddZdS)rHg$@cCstS)N)rG)rrrrrIszInvertedLog10Transform.invertedN)rrr r:rIrrrrrHsrHc@seZdZdZddZdS) Log2Transformg@cCstS)N)InvertedLog2Transform)rrrrrIszLog2Transform.invertedN)rrr r:rIrrrrrJsrJc@seZdZdZddZdS)rKg@cCstS)N)rJ)rrrrrIszInvertedLog2Transform.invertedN)rrr r:rIrrrrrKsrKc@seZdZejZddZdS)NaturalLogTransformcCstS)N)InvertedNaturalLogTransform)rrrrrIszNaturalLogTransform.invertedN)rrr r7er:rIrrrrrLsrLc@seZdZejZddZdS)rMcCstS)N)rL)rrrrrIsz$InvertedNaturalLogTransform.invertedN)rrr r7rNr:rIrrrrrMsrMc@seZdZdddZddZdS) LogTransformr0cCst||||_dS)N)r.r%r:)rr:r3rrrr%s zLogTransform.__init__cCs t|jS)N)InvertedLogTransformr:)rrrrrIszLogTransform.invertedN)r0)rrr r%rIrrrrrOs rOc@seZdZddZddZdS)rPcCst|||_dS)N)rEr%r:)rr:rrrr%s zInvertedLogTransform.__init__cCs t|jS)N)rOr:)rrrrrIszInvertedLogTransform.invertedN)rrr r%rIrrrrrPsrPc@sXeZdZdZdZeZeZeZeZe Z e Z e Z e Z e Z ddZddZddZd d Zd S) LogScalea A standard logarithmic scale. Care is taken so non-positive values are not plotted. For computational efficiency (to push as much as possible to Numpy C code in the common cases), this scale provides different transforms depending on the base of the logarithm: - base 10 (:class:`Log10Transform`) - base 2 (:class:`Log2Transform`) - base e (:class:`NaturalLogTransform`) - arbitrary base (:class:`LogTransform`) r9cKs|jdkr0|dd}|dd}|dd}n$|dd}|d d}|d d}t|rntd d ||d kr~td|dks|dkrtd|dkr|||_n<|dkr|||_n&|tj kr| ||_n| |||_||_ ||_ dS)a  *basex*/*basey*: The base of the logarithm *nonposx*/*nonposy*: {'mask', 'clip'} non-positive values in *x* or *y* can be masked as invalid, or clipped to a very small positive number *subsx*/*subsy*: Where to place the subticks between each major tick. Should be a sequence of integers. For example, in a log10 scale: ``[2, 3, 4, 5, 6, 7, 8, 9]`` will place 8 logarithmically spaced minor ticks between each major tick. r&basexg$@subsxNZnonposxr0baseysubsyZnonposyzrprovided too many kwargs, can only pass {'basex', 'subsx', nonposx'} or {'basey', 'subsy', nonposy'}. You passed z{!r})r1r0z/nonposx, nonposy kwarg must be 'mask' or 'clip'rr/z#The log base cannot be <= 0 or == 1g@)r+poplen ValueErrorr>rG _transformrJr7rNrLrOr:subs)rrr$r:rZr3rrrr%s.       zLogScale.__init__cCsR|t|j|t|j|t|j|j|t|j|jdk ddS)zb Set the locators and formatters to specialized versions for log scaling. N)Z labelOnlyBase)r(r r:r)rr,rZr*)rrrrrr s z,LogScale.set_default_locators_and_formatterscCs|jS)z Return a :class:`~matplotlib.transforms.Transform` instance appropriate for the given logarithm base. )rY)rrrrrszLogScale.get_transformcCs.t|sd}|dkr|n||dkr(|n|fS)z6 Limit the domain to positive values. gYnr)r7isfinite)rrrrrrrrs zLogScale.limit_range_for_scaleN)rrr r!r-r.rGrHrJrKrLrMrOrPr%rrrrrrrrQs 1 rQc@s4eZdZdZdZdZdZddZddZddZ d S) SymmetricalLogTransformr/TcCs@t|||_||_||_|d|jd|_t||_dS)Ng?) rr%r: linthreshlinscale _linscale_adjr7r9 _log_base)rr:r^r_rrrr%1s  z SymmetricalLogTransform.__init__cCsvt|}tj||j |jdd}||j|jtt||j|j}|j rnt |j ||j|S|SdS)NF)copy) r7signr masked_insider^r`r9absrar1anywhere)rr;rcmaskedr9rrrr=9s   z,SymmetricalLogTransform.transform_non_affinecCst|j|j|jS)N)InvertedSymmetricalLogTransformr:r^r_)rrrrrIGs z SymmetricalLogTransform.invertedN) rrr rArBrCrDr%r=rIrrrrr\+sr\c@s4eZdZdZdZdZdZddZddZddZ d S) rir/TcCsLt|t|||}||_||_|||_||_|d|jd|_dS)Ng?r]) rr%r\r:r^Z transform invlinthreshr_r`)rr:r^r_symlogrrrr%Rs   z(InvertedSymmetricalLogTransform.__init__cCsrt|}tj||j |jdd}||jt|j|||j|j}|j rjt |j ||j|S|SdS)NF)rb) r7rcrrdrjr^rFr:r`r1rfrg)rr;rcrhZexprrrr=[s     z4InvertedSymmetricalLogTransform.transform_non_affinecCst|j|j|jS)N)r\r:r^r_)rrrrrIgsz(InvertedSymmetricalLogTransform.invertedN) rrr rArBrCrDr%r=rIrrrrriLs  ric@s4eZdZdZdZeZeZddZddZddZ d S) SymmetricalLogScaleah The symmetrical logarithmic scale is logarithmic in both the positive and negative directions from the origin. Since the values close to zero tend toward infinity, there is a need to have a range around zero that is linear. The parameter *linthresh* allows the user to specify the size of this range (-*linthresh*, *linthresh*). rkcKs|jdkr<|dd}|dd}|dd}|dd }n0|d d}|d d}|d d}|d d }|d kr|td|dkrtd|dkrtd|||||_||_||_||_||_dS)a" *basex*/*basey*: The base of the logarithm *linthreshx*/*linthreshy*: A single float which defines the range (-*x*, *x*), within which the plot is linear. This avoids having the plot go to infinity around zero. *subsx*/*subsy*: Where to place the subticks between each major tick. Should be a sequence of integers. For example, in a log10 scale: ``[2, 3, 4, 5, 6, 7, 8, 9]`` will place 8 logarithmically spaced minor ticks between each major tick. *linscalex*/*linscaley*: This allows the linear range (-*linthresh* to *linthresh*) to be stretched relative to the logarithmic range. Its value is the number of decades to use for each half of the linear range. For example, when *linscale* == 1.0 (the default), the space used for the positive and negative halves of the linear range will be equal to one decade in the logarithmic range. r&rRg$@Z linthreshxg@rSNZ linscalexg?rTZ linthreshyrUZ linscaleyz#'basex/basey' must be larger than 1gz('linthreshx/linthreshy' must be positivez''linscalex/linthreshy' must be positive) r+rVrXr\rYr:r^r_rZ)rrr$r:r^rZr_rrrr%{s,        zSymmetricalLogScale.__init__cCsH|t||t|j|t||j|t dS)zn Set the locators and formatters to specialized versions for symmetrical log scaling. N) r(rrr)rr:r,rZr*r)rrrrrrs   z7SymmetricalLogScale.set_default_locators_and_formatterscCs|jS)zE Return a :class:`SymmetricalLogTransform` instance. )rY)rrrrrsz!SymmetricalLogScale.get_transformN) rrr r!r-r\rir%rrrrrrrlls 6 rlc@s>eZdZdZdZdZdZd ddZddZdd Z d d Z d S)LogitTransformr/Tr1cCs$t|||_ddd||_dS)NTF)r0r1)rr%_nonposr2)rr3rrrr%s zLogitTransform.__init__c CsNtjdddt|d|}WdQRX|jrJd||dk<d|d|k<|S)z,logit transform (base 10), masked or clippedr4)r5r6r/Niri)r7r8Zlog10r2)rr;r<rrrr=s   z#LogitTransform.transform_non_affinecCs t|jS)N)LogisticTransformrn)rrrrrIszLogitTransform.invertedcCsdt|j|jrdndS)Nz{}({!r})r0r1)r>r?rr2)rrrrr@s zLogitTransform.__str__N)r1) rrr rArBrCrDr%r=rIr@rrrrrms  rmc@s>eZdZdZdZdZdZd ddZddZdd Z d d Z d S)ror/Tr1cCst|||_dS)N)rr%rn)rr3rrrr%s zLogisticTransform.__init__cCsddd| S)zlogistic transform (base 10)g?r/ r)rr;rrrr=sz&LogisticTransform.transform_non_affinecCs t|jS)N)rmrn)rrrrrIszLogisticTransform.invertedcCsdt|j|jS)Nz{}({!r}))r>r?rrn)rrrrr@szLogisticTransform.__str__N)r1) rrr rArBrCrDr%r=rIr@rrrrros roc@s6eZdZdZdZd ddZddZdd Zd d Zd S) LogitScalez Logit scale for data between zero and one, both excluded. This scale is similar to a log scale close to zero and to one, and almost linear around 0.5. It maps the interval ]0, 1[ onto ]-infty, +infty[. logitr1cCs|dkrtdt||_dS)z *nonpos*: {'mask', 'clip'} values beyond ]0, 1[ can be masked as invalid, or clipped to a number very close to 0 or 1 )r1r0z/nonposx, nonposy kwarg must be 'mask' or 'clip'N)rXrmrY)rrr3rrrr%szLogitScale.__init__cCs|jS)z< Return a :class:`LogitTransform` instance. )rY)rrrrrszLogitScale.get_transformcCs8|t|t|tdd|tdS)NT)minor)r(rr)r r,r*)rrrrrrs  z.LogitScale.set_default_locators_and_formatterscCs2t|sd}|dkr|n||dkr,d|n|fS)zH Limit the domain to values between 0 and 1 (excluded). gHz>rr/)r7r[)rrrrrrrrs z LogitScale.limit_range_for_scaleN)r1) rrr r!r-r%rrrrrrrrqs  rq)r#r9rkrrcCsttS)N)sorted_scale_mappingrrrrget_scale_names(srvcKs8|}|dkrd}|tkr(td|t||f|S)zC Return a scale class by name. ACCEPTS: [ %(names)s ] Nr#zUnknown scale type '%s')lowerrurX)scalerr$rrr scale_factory,s  rynamesz | cCs|t|j<dS)zd Register a new kind of scale. *scale_class* must be a subclass of :class:`ScaleBase`. N)rur-) scale_classrrrregister_scale>sr|cCszg}xjtD]`}t|}|d||dt|jj}ddd|dD}|||dq Wd|S)zF Helper function for generating docstrings related to scales. z '%s'cSsg|] }d|qS)z %s r).0r&rrr Qsz"get_scale_docs.. ) rvruappendrdedentr%r!joinsplit)Zdocsr-r{Z class_docsrrrget_scale_docsGs    rcCsg|] }t|qSr)repr)r~r&rrrrYsr)rxZ scale_docs)4Znumpyr7rZ matplotlibrrrZmatplotlib.tickerrrrr r r r r rrZmatplotlib.transformsrrobjectrr"r.rErGrHrJrKrLrMrOrPrQr\rirlrmrorqrurvryrr!rr|rZinterpdupdaterstriprrrrsH 0)!!   k! W-