323 lines
36 KiB
Plaintext
323 lines
36 KiB
Plaintext
|
Ë
|
|||
|
|
†R j,i ã óV — d Z ddlZddlZddlZddlZddlmZmZ ddl m
|
|||
|
|
Z
|
|||
|
|
m Z m Z m
|
|||
|
|
Z
|
|||
|
|
mZmZmZmZmZmZmZ ddlmZmZ G d„ d« Z G d„ d e« Z G d
|
|||
|
|
„ d e« Z G d „ d
|
|||
|
|
e« Z G d„ de« Z G d„ de« Z G d„ de« Z G d„ de « Z G d„ de« Z G d„ de« Z! G d„ de« Z" G d „ d e« Z# G d „ d e« Z$ G d „ d!e« Z% G d"„ d#e« Z& G d$„ d%e« Z' G d&„ d'e« Z(ee e"e%e(ee d(œZ)d)„ Z*d*„ Z+e+j r1e+j d+d,jY e-e. e*« « « iz e+_ d-„ Z/d.„ Z0ejb je d/d,jY e*« D � cg c]
|
|||
|
|
} e.| « ‘Œ c} « z e0« jg « ¬0« yc c} w )1a²
|
|||
|
|
Scales define the distribution of data values on an axis, e.g. a log scaling.
|
|||
|
|
|
|||
|
|
The mapping is implemented through `.Transform` subclasses.
|
|||
|
|
|
|||
|
|
The following scales are built-in:
|
|||
|
|
|
|||
|
|
.. _builtin_scales:
|
|||
|
|
|
|||
|
|
============= ===================== ================================ =================================
|
|||
|
|
Name Class Transform Inverted transform
|
|||
|
|
============= ===================== ================================ =================================
|
|||
|
|
"asinh" `AsinhScale` `AsinhTransform` `InvertedAsinhTransform`
|
|||
|
|
"function" `FuncScale` `FuncTransform` `FuncTransform`
|
|||
|
|
"functionlog" `FuncScaleLog` `FuncTransform` + `LogTransform` `InvertedLogTransform` + `FuncTransform`
|
|||
|
|
"linear" `LinearScale` `.IdentityTransform` `.IdentityTransform`
|
|||
|
|
"log" `LogScale` `LogTransform` `InvertedLogTransform`
|
|||
|
|
"logit" `LogitScale` `LogitTransform` `LogisticTransform`
|
|||
|
|
"symlog" `SymmetricalLogScale` `SymmetricalLogTransform` `InvertedSymmetricalLogTransform`
|
|||
|
|
============= ===================== ================================ =================================
|
|||
|
|
|
|||
|
|
A user will often only use the scale name, e.g. when setting the scale through
|
|||
|
|
`~.Axes.set_xscale`: ``ax.set_xscale("log")``.
|
|||
|
|
|
|||
|
|
See also the :ref:`scales examples <sphx_glr_gallery_scales>` in the documentation.
|
|||
|
|
|
|||
|
|
Custom scaling can be achieved through `FuncScale`, or by creating your own
|
|||
|
|
`ScaleBase` subclass and corresponding transforms (see :doc:`/gallery/scales/custom_scale`).
|
|||
|
|
Third parties can register their scales by name through `register_scale`.
|
|||
|
|
é N)Ú_apiÚ
|
|||
|
|
_docstring) Ú
|
|||
|
|
NullFormatterÚScalarFormatterÚLogFormatterSciNotationÚLogitFormatterÚ NullLocatorÚ
|
|||
|
|
LogLocatorÚ AutoLocatorÚAutoMinorLocatorÚSymmetricalLogLocatorÚ AsinhLocatorÚ LogitLocator)Ú TransformÚIdentityTransformc ó( — e Zd ZdZd„ Zd„ Zd„ Zd„ Zy)Ú ScaleBasea
|
|||
|
|
The base class for all scales.
|
|||
|
|
|
|||
|
|
Scales are separable transformations, working on a single dimension.
|
|||
|
|
|
|||
|
|
Subclasses should override
|
|||
|
|
|
|||
|
|
:attr:`name`
|
|||
|
|
The scale's name.
|
|||
|
|
:meth:`get_transform`
|
|||
|
|
A method returning a `.Transform`, which converts data coordinates to
|
|||
|
|
scaled coordinates. This transform should be invertible, so that e.g.
|
|||
|
|
mouse positions can be converted back to data coordinates.
|
|||
|
|
:meth:`set_default_locators_and_formatters`
|
|||
|
|
A method that sets default locators and formatters for an `~.axis.Axis`
|
|||
|
|
that uses this scale.
|
|||
|
|
:meth:`limit_range_for_scale`
|
|||
|
|
An optional method that "fixes" the axis range to acceptable values,
|
|||
|
|
e.g. restricting log-scaled axes to positive values.
|
|||
|
|
c ó — y)a‰
|
|||
|
|
Construct a new scale.
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
The following note is for scale implementers.
|
|||
|
|
|
|||
|
|
For back-compatibility reasons, scales take an `~matplotlib.axis.Axis`
|
|||
|
|
object as first argument. However, this argument should not
|
|||
|
|
be used: a single scale object should be usable by multiple
|
|||
|
|
`~matplotlib.axis.Axis`\es at the same time.
|
|||
|
|
N© ©ÚselfÚaxiss úS/home/antigravity/intellecton/venv/lib/python3.12/site-packages/matplotlib/scale.pyÚ__init__zScaleBase.__init__D ó � ó c ó — t « ‚)zL
|
|||
|
|
Return the `.Transform` object associated with this scale.
|
|||
|
|
©ÚNotImplementedError©r s r Ú
|
|||
|
|
get_transformzScaleBase.get_transformR s
|
|||
|
|
€ ô "Ó#Ð#r c ó — t « ‚)zi
|
|||
|
|
Set the locators and formatters of *axis* to instances suitable for
|
|||
|
|
this scale.
|
|||
|
|
r r s r Ú#set_default_locators_and_formattersz-ScaleBase.set_default_locators_and_formattersX s
|
|||
|
|
€ ô
|
|||
|
|
"Ó#Ð#r c ó
|
|||
|
|
— ||fS )zú
|
|||
|
|
Return the range *vmin*, *vmax*, restricted to the
|
|||
|
|
domain supported by this scale (if any).
|
|||
|
|
|
|||
|
|
*minpos* should be the minimum positive value in the data.
|
|||
|
|
This is used by log scales to determine a minimum value.
|
|||
|
|
r ©r ÚvminÚvmaxÚminposs r Úlimit_range_for_scalez ScaleBase.limit_range_for_scale_ s € ð �TˆzÐr N)Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__Ú__doc__r r! r# r) r r r r r . s „ ñò* ò $ò $ór r c ó& — e Zd ZdZdZd„ Zd„ Zd„ Zy)Ú LinearScalez#
|
|||
|
|
The default linear scale.
|
|||
|
|
Úlinearc ó — y)z
|
|||
|
|
Nr r s r r zLinearScale.__init__q r r c óˆ — |j t « « |j t « « |j t « « |j dk( rt j d s"|j dk( r-t j d r|j t « « y |j t « « y ©NÚxzxtick.minor.visibleÚyzytick.minor.visible© Úset_major_locatorr Úset_major_formatterr Úset_minor_formatterr Ú axis_nameÚmplÚrcParamsÚset_minor_locatorr r r s r r# z/LinearScale.set_default_locators_and_formattersx ó… € à × Ñ œ{›}Ô-Ø × Ñ ¤ Ó!2Ô3Ø × Ñ ¤ £ Ô1à �N‰N˜cÒ !¤c§l¡lÐ3HÒ&IØ—‘ #Ò%¬#¯,©,Ð7LÒ*MØ × "Ñ "Ô#3Ó#5Õ 6à × "Ñ "¤;£=Õ 1r c ó — t « S )z€
|
|||
|
|
Return the transform for linear scaling, which is just the
|
|||
|
|
`~matplotlib.transforms.IdentityTransform`.
|
|||
|
|
)r r s r r! zLinearScale.get_transform„ s
|
|||
|
|
€ ô
|
|||
|
|
!Ó"Ð"r N)r* r+ r, r- Únamer r# r! r r r r/ r/ j s „ ñð €Dò ò
|
|||
|
|
2ó#r r/ c ó6 ‡ — e Zd ZdZdxZZˆ fd„Zd„ Zd„ Zˆ xZ S )Ú
|
|||
|
|
FuncTransformzi
|
|||
|
|
A simple transform that takes and arbitrary function for the
|
|||
|
|
forward and inverse transform.
|
|||
|
|
é c ó€ •— t ‰| � « t |« rt |« r|| _ || _ yt d« ‚)a£
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
forward : callable
|
|||
|
|
The forward function for the transform. This function must have
|
|||
|
|
an inverse and, for best behavior, be monotonic.
|
|||
|
|
It must have the signature::
|
|||
|
|
|
|||
|
|
def forward(values: array-like) -> array-like
|
|||
|
|
|
|||
|
|
inverse : callable
|
|||
|
|
The inverse of the forward function. Signature as ``forward``.
|
|||
|
|
z,arguments to FuncTransform must be functionsN)Úsuperr ÚcallableÚ_forwardÚ_inverseÚ
|
|||
|
|
ValueError)r ÚforwardÚinverseÚ __class__s €r r zFuncTransform.__init__” s9 ø€ ô ‰ÑÔÜ �GÔ ¤¨'Ô!2Ø #ˆDŒMØ #ˆD�Mä Ð KÓLÐ Lr c ó$ — | j |« S ©N)rG ©r Úvaluess r Útransform_non_affinez"FuncTransform.transform_non_affine© s € Ø�}‰}˜VÓ$Ð$r c óB — t | j | j « S rN )rB rH rG r s r ÚinvertedzFuncTransform.inverted¬ s € Ü ˜TŸ]™]¨D¯M©MÓ:Ð:r ©
|
|||
|
|
r* r+ r, r- Ú
|
|||
|
|
input_dimsÚ output_dimsr rQ rS Ú
|
|||
|
|
__classcell__©rL s @r rB rB Œ s$ ø„ ñð
|
|||
|
|
!Ð €J�ôMò*%ö;r rB c ó& — e Zd ZdZdZd„ Zd„ Zd„ Zy)Ú FuncScalezN
|
|||
|
|
Provide an arbitrary scale with user-supplied function for the axis.
|
|||
|
|
Úfunctionc ó4 — |\ }}t ||« }|| _ y)a•
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
axis : `~matplotlib.axis.Axis`
|
|||
|
|
The axis for the scale.
|
|||
|
|
functions : (callable, callable)
|
|||
|
|
two-tuple of the forward and inverse functions for the scale.
|
|||
|
|
The forward function must be monotonic.
|
|||
|
|
|
|||
|
|
Both functions must have the signature::
|
|||
|
|
|
|||
|
|
def forward(values: array-like) -> array-like
|
|||
|
|
N)rB Ú
|
|||
|
|
_transform)r r Ú functionsrJ rK Ú transforms r r zFuncScale.__init__· s! € ð %ш�Ü! '¨7Ó3ˆ Ø#ˆ�r c ó — | j S )z7Return the `.FuncTransform` associated with this scale.©r] r s r r! zFuncScale.get_transformÉ ó € à�‰Ð r c óˆ — |j t « « |j t « « |j t « « |j dk( rt j d s"|j dk( r-t j d r|j t « « y |j t « « y r3 r6 r s r r# z-FuncScale.set_default_locators_and_formattersÍ r> r N)r* r+ r, r- r@ r r! r# r r r rZ rZ ° s „ ñð €Dò$ò$ ó
|
|||
|
|
2r rZ c ó: ‡ — e Zd ZdxZZdˆ fd„ Zd„ Zd„ Zd„ Zˆ xZ S )Ú LogTransformrC c ó˜ •— t ‰| � « |dk s|dk( r t d« ‚|| _ t j
|
|||
|
|
dddœ|¬« | _ y )Nr rC z#The log base cannot be <= 0 or == 1TF©ÚclipÚmask©Ú nonpositive)rE r rI Úbaser Ú
|
|||
|
|
check_getitemÚ_clip)r rl rk rL s €r r zLogTransform.__init__Ý sK ø€ Ü
|
|||
|
|
‰ÑÔØ �1Š9˜ š Ü Ð BÓCÐ C؈Œ Ü×'Ñ'Ø 5Ñ )°{ôDˆ�
|
|||
|
|
r c ó† — dj t | « j | j | j rd« S d« S )Nz {}(base={}, nonpositive={!r})rh ri )ÚformatÚtyper* rl rn r s r Ú__str__zLogTransform.__str__å sA € Ø.×5Ñ5Ü �‹J× Ñ §¡°d·j²j¨FóNð NØFLóNð Nr c ó¾ — t j dd¬« 5 t j t j dt j dt j
|
|||
|
|
ij
|
|||
|
|
| j « }|r ||« }n7t j |« }|t j | j « z }| j rd||dk < d d d « |S # 1 sw Y S xY w)NÚignore©ÚdivideÚinvalidé é
|
|||
|
|
éüÿÿr ) ÚnpÚerrstateÚeÚlogÚlog2Úlog10Úgetrl rn )r rP r~ Úouts r rQ z!LogTransform.transform_non_affineé s¦ € ä
|
|||
|
|
�[‰[ °(Ô
|
|||
|
|
;ñ )Ü—4‘4œŸ™ ¤B§G¡G¨R´·±Ð:×>Ñ>¸t¿y¹yÓIˆCÙÙ˜&“k‘ä—f‘f˜V“n�Ø”r—v‘v˜dŸi™iÓ(Ñ(�Ø�zŠzð $)��F˜a‘KÑ ÷# )ð$ ˆ
|
|||
|
|
÷% )ð$ ˆ
|
|||
|
|
ús ˜B0CÃC c ó, — t | j « S rN )ÚInvertedLogTransformrl r s r rS zLogTransform.invertedÿ s € Ü# D§I¡IÓ.Ð.r )rh ©
|
|||
|
|
r* r+ r, rU rV r rr rQ rS rW rX s @r re re Ú s# ø„ Ø Ð €J�õDòNòö,/r re c ó8 ‡ — e Zd ZdxZZˆ fd„Zd„ Zd„ Zd„ Zˆ xZ S )r„ rC c ó0 •— t ‰| � « || _ y rN )rE r rl )r rl rL s €r r z InvertedLogTransform.__init__ s ø€ Ü
|
|||
|
|
‰ÑÔ؈� r c óL — t | « j › d| j › d�S )Nz(base=ú))rq r* rl r s r rr z InvertedLogTransform.__str__
|
|||
|
|
s$ € Ü�t“*×%Ñ%Ð& f¨T¯Y©Y¨K°qÐ9Ð9r c óB — t j | j |« S rN )r{ Úpowerrl rO s r rQ z)InvertedLogTransform.transform_non_affine
|
|||
|
|
s € Ü�x‰x˜Ÿ ™ 6Ó*Ð*r c ó, — t | j « S rN )re rl r s r rS z InvertedLogTransform.inverted s € ܘDŸI™IÓ&Ð&r r… rX s @r r„ r„ s! ø„ Ø Ð €J�ôò:ò+ö'r r„ c óH — e Zd ZdZdZddddœd„Z ed„ « Zd „ Zd
|
|||
|
|
„ Z d „ Z
|
|||
|
|
y) ÚLogScalezT
|
|||
|
|
A standard logarithmic scale. Care is taken to only plot positive values.
|
|||
|
|
r~ ry Nrh )rl Úsubsrk c ó4 — t ||« | _ || _ y)a£
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
axis : `~matplotlib.axis.Axis`
|
|||
|
|
The axis for the scale.
|
|||
|
|
base : float, default: 10
|
|||
|
|
The base of the logarithm.
|
|||
|
|
nonpositive : {'clip', 'mask'}, default: 'clip'
|
|||
|
|
Determines the behavior for non-positive values. They can either
|
|||
|
|
be masked as invalid, or clipped to a very small positive number.
|
|||
|
|
subs : sequence of int, default: None
|
|||
|
|
Where to place the subticks between each major tick. 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.
|
|||
|
|
N)re r] r� )r r rl r� rk s r r zLogScale.__init__ s € ô ' t¨[Ó9ˆŒØˆ� r c ó. — | j j S rN ©r] rl r s r ú<lambda>zLogScale.<lambda>- ó € § ¡ ×!5Ñ!5€ r c óV — |j t | j « « |j t | j « « |j t | j | j « « |j t | j | j d u¬« « y )N)Ú
|
|||
|
|
labelOnlyBase)r7 r
|
|||
|
|
rl r8 r r= r� r9 r s r r# z,LogScale.set_default_locators_and_formatters/ sx € à × Ñ œz¨$¯)©)Ó 4Ô5Ø × Ñ Ô!8¸¿¹Ó!CÔDØ × Ñ œz¨$¯)©)°T·Y±YÓ ?Ô@Ø × Ñ Ü # D§I¡IØ37·9±9ÀDÐ3Hô
|
|||
|
|
Kõ Lr c ó — | j S )z6Return the `.LogTransform` associated with this scale.ra r s r r! zLogScale.get_transform8 rb r c óV — t j |« sd}|dk r|n||dk r|fS |fS )z$Limit the domain to positive values.gYóø n¥r ©r{ Úisfiniter% s r r) z LogScale.limit_range_for_scale< s> € ä�{‰{˜6Ô"؈Fà !š)‘¨Ø !š)�ð/ð /Ø)-ð/ð /r ) r* r+ r, r- r@ r Úpropertyrl r# r! r) r r r rŽ rŽ s7 „ ñð €Dà%'¨dÀô ñ& Ñ5Ó 6€DòLò ó/r rŽ c ó2 — e Zd ZdZdZdd„Zed„ « Zd„ Zy)Ú FuncScaleLogzu
|
|||
|
|
Provide an arbitrary scale with user-supplied function for the axis and
|
|||
|
|
then put on a logarithmic axes.
|
|||
|
|
Ú functionlogc óV — |\ }}d| _ t ||« t |« z | _ y)aä
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
axis : `~matplotlib.axis.Axis`
|
|||
|
|
The axis for the scale.
|
|||
|
|
functions : (callable, callable)
|
|||
|
|
two-tuple of the forward and inverse functions for the scale.
|
|||
|
|
The forward function must be monotonic.
|
|||
|
|
|
|||
|
|
Both functions must have the signature::
|
|||
|
|
|
|||
|
|
def forward(values: array-like) -> array-like
|
|||
|
|
|
|||
|
|
base : float, default: 10
|
|||
|
|
Logarithmic base of the scale.
|
|||
|
|
N)r� rB re r] )r r r^ rl rJ rK s r r zFuncScaleLog.__init__M s- € ð" %ш�؈Œ Ü'¨°Ó9¼LÈÓ<NÑNˆ�r c óB — | j j j S rN )r] Ú_brl r s r rl zFuncScaleLog.baseb s € à�‰×!Ñ!×&Ñ&Ð&r c ó — | j S )z3Return the `.Transform` associated with this scale.ra r s r r! zFuncScaleLog.get_transformf rb r N)ry ) r* r+ r, r- r@ r r› rl r! r r r r� r� E s- „ ñð
|
|||
|
|
€DóOð* ñ'ó ð'ó r r� c ó2 ‡ — e Zd ZdxZZˆ fd„Zd„ Zd„ Zˆ xZS )ÚSymmetricalLogTransformrC c ó •— t ‰| � « |dk r t d« ‚|dk r t d« ‚|dk r t d« ‚|| _ || _ || _ |d| j dz z
|
|||
|
|
z | _ t j |« | _ y )Nç ð?z 'base' must be larger than 1ç z 'linthresh' must be positivez'linscale' must be positiveéÿÿÿÿ)
|
|||
|
|
rE r rI rl Ú linthreshÚlinscaleÚ
|
|||
|
|
_linscale_adjr{ r~ Ú _log_base)r rl r© rª rL s €r r z SymmetricalLogTransform.__init__n s† ø€ Ü
|
|||
|
|
‰ÑÔØ �3Š;Ü Ð ;Ó<Ð <Ø ˜Ò Ü Ð ;Ó<Ð <Ø �sŠ?Ü Ð :Ó;Ð ;؈Œ Ø"ˆŒØ ˆŒ
|
|||
|
|
Ø &¨#°· ± ¸R±Ñ*?Ñ @ˆÔÜŸ™ › ˆ�r c óŽ — t j |« }t j dd¬« 5 t j |« | j z | j
|
|||
|
|
t j || j z « | j z z z }|| j k }d d d « | | j
|
|||
|
|
z |< |S # 1 sw Y Œ xY w©Nrt ru )r{ Úabsr| Úsignr© r« r~ r¬ ©r rP Úabs_ar‚ Úinsides r rQ z,SymmetricalLogTransform.transform_non_affine| sª € Ü—‘�v“ˆÜ
|
|||
|
|
�[‰[ °(Ô
|
|||
|
|
;ñ -Ü—'‘'˜&“/ D§N¡NÑ2Ø×"Ñ"Ü—‘�u˜tŸ~™~Ñ-Ó.°· ± Ñ?ñ@ñAˆCð ˜dŸn™nÑ,ˆF÷ -ð
|
|||
|
|
˜V‘n t×'9Ñ'9Ñ9ˆˆF‰ ؈
|
|||
|
|
÷
|
|||
|
|
-ð -ús A/B;Â;Cc óX — t | j | j | j « S rN )Ú InvertedSymmetricalLogTransformrl r© rª r s r rS z SymmetricalLogTransform.inverted† s" € Ü.¨t¯y©y¸$¿.¹.Ø/3¯}©}ó>ð >r © r* r+ r, rU rV r rQ rS rW rX s @r r¤ r¤ k s ø„ Ø Ð €J�ô &ò ö>r r¤ c ó2 ‡ — e Zd ZdxZZˆ fd„Zd„ Zd„ Zˆ xZS )rµ rC c óÆ •— t ‰| � « t |||« }|| _ || _ |j |« | _ || _ |d| j dz z
|
|||
|
|
z | _ y )Nr¦ r¨ ) rE r r¤ rl r© r_ Ú invlinthreshrª r« )r rl r© rª ÚsymlogrL s €r r z(InvertedSymmetricalLogTransform.__init__Ž s^ ø€ Ü
|
|||
|
|
‰ÑÔÜ(¨¨y¸(ÓCˆØˆŒ Ø"ˆŒØ "× ,Ñ ,¨YÓ 7ˆÔØ ˆŒ
|
|||
|
|
Ø &¨#°· ± ¸R±Ñ*?Ñ @ˆÕr c óŠ — t j |« }t j dd¬« 5 t j |« | j z t j
|
|||
|
|
| j || j z | j z
|
|||
|
|
« z }|| j k }d d d « | | j z |< |S # 1 sw Y Œ xY wr® ) r{ r¯ r| r° r© r‹ rl r« r¹ r± s r rQ z4InvertedSymmetricalLogTransform.transform_non_affine— s© € Ü—‘�v“ˆÜ
|
|||
|
|
�[‰[ °(Ô
|
|||
|
|
;ñ 0Ü—'‘'˜&“/ D§N¡NÑ2Ü—‘˜Ÿ™Ø § ¡ Ñ/°$×2DÑ2DÑDóFñGˆCð ˜d× /Ñ /Ñ/ˆF÷ 0ð
|
|||
|
|
˜V‘n t×'9Ñ'9Ñ9ˆˆF‰ ؈
|
|||
|
|
÷
|
|||
|
|
0ð 0ús A-B9Â9Cc óX — t | j | j | j « S rN )r¤ rl r© rª r s r rS z(InvertedSymmetricalLogTransform.inverted¡ s$ € Ü& t§y¡yØ'+§~¡~°t·}±}óFð Fr r¶ rX s @r rµ rµ ‹ s ø„ Ø Ð €J�ôBòöFr rµ c óh — e Zd ZdZdZdddddœd„Z ed „ « Z ed
|
|||
|
|
„ « Z ed „ « Z d „ Z
|
|||
|
|
d
|
|||
|
|
„ Z y)ÚSymmetricalLogScaleac
|
|||
|
|
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*).
|
|||
|
|
|
|||
|
|
See :doc:`/gallery/scales/symlog_demo` for a detailed description.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
base : float, default: 10
|
|||
|
|
The base of the logarithm.
|
|||
|
|
|
|||
|
|
linthresh : float, default: 2
|
|||
|
|
Defines the range ``(-x, x)``, within which the plot is linear.
|
|||
|
|
This avoids having the plot go to infinity around zero.
|
|||
|
|
|
|||
|
|
subs : sequence of int
|
|||
|
|
Where to place the subticks between each major tick.
|
|||
|
|
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.
|
|||
|
|
|
|||
|
|
linscale : float, optional
|
|||
|
|
This allows the linear range ``(-linthresh, 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º ry rx NrC )rl r© r� rª c ó6 — t |||« | _ || _ y rN )r¤ r] r� )r r rl r© r� rª s r r z SymmetricalLogScale.__init__Ê s € Ü1°$¸ À8ÓLˆŒØˆ� r c ó. — | j j S rN r’ r s r r“ z SymmetricalLogScale.<lambda>Î r” r c ó. — | j j S rN )r] r© r s r r“ z SymmetricalLogScale.<lambda>Ï s € d§o¡o×&?Ñ&?€ r c ó. — | j j S rN )r] rª r s r r“ z SymmetricalLogScale.<lambda>Ð s € T§_¡_×%=Ñ%=€ r c ó4 — |j t | j « « « |j t | j
|
|||
|
|
« « |j
|
|||
|
|
t | j « | j « « |j t « « y rN )
|
|||
|
|
r7 r
|
|||
|
|
r! r8 r rl r= r� r9 r r s r r# z7SymmetricalLogScale.set_default_locators_and_formattersÒ sq € à × Ñ Ô 4°T×5GÑ5GÓ5IÓ JÔKØ × Ñ Ô!8¸¿¹Ó!CÔDØ × Ñ Ô 4°T×5GÑ5GÓ5IØ59·Y±Yó @ô Aà × Ñ ¤ £ Õ1r c ó — | j S )zAReturn the `.SymmetricalLogTransform` associated with this scale.ra r s r r! z!SymmetricalLogScale.get_transformÚ rb r ) r* r+ r, r- r@ r r› rl r© rª r# r! r r r r¾ r¾ ¦ sJ „ ñ ðB €Dà%'°1¸4È!ô ñ Ñ5Ó 6€DÙÑ?Ó@€IÙÑ=Ó>€Hò2ó r r¾ c ó6 ‡ — e Zd ZdZdxZZˆ fd„Zd„ Zd„ Zˆ xZ S )ÚAsinhTransformz<Inverse hyperbolic-sine transformation used by `.AsinhScale`rC c óP •— t ‰| � « |dk r t d« ‚|| _ y )Nr§ z8Scale parameter 'linear_width' must be strictly positive)rE r rI Ú linear_width©r rÈ rL s €r r zAsinhTransform.__init__ã s0 ø€ Ü
|
|||
|
|
‰ÑÔØ ˜3Ò Ü ð 9ó :ð
|
|||
|
|
:à (ˆÕr c ó` — | j t j || j z « z S rN )rÈ r{ ÚarcsinhrO s r rQ z#AsinhTransform.transform_non_affineê s' € Ø× Ñ ¤2§:¡:¨f°t×7HÑ7HÑ.HÓ#IÑIÐIr c ó, — t | j « S rN )ÚInvertedAsinhTransformrÈ r s r rS zAsinhTransform.invertedí s € Ü% d×&7Ñ&7Ó8Ð8r rT rX s @r rÆ rÆ ß s ø„ ÙFØ Ð €J�ô)òJö9r rÆ c ó6 ‡ — e Zd ZdZdxZZˆ fd„Zd„ Zd„ Zˆ xZ S )rÍ z4Hyperbolic sine transformation used by `.AsinhScale`rC c ó0 •— t ‰| � « || _ y rN )rE r rÈ rÉ s €r r z InvertedAsinhTransform.__init__õ s ø€ Ü
|
|||
|
|
‰ÑÔØ (ˆÕr c ó` — | j t j || j z « z S rN )rÈ r{ ÚsinhrO s r rQ z+InvertedAsinhTransform.transform_non_affineù s' € Ø× Ñ ¤2§7¡7¨6°D×4EÑ4EÑ+EÓ#FÑFÐFr c ó, — t | j « S rN )rÆ rÈ r s r rS z InvertedAsinhTransform.invertedü ó € Ü ˜d× /Ñ /Ó0Ð0r rT rX s @r rÍ rÍ ñ s ø„ Ù>Ø Ð €J�ô)òGö1r rÍ c ód ‡ — e Zd ZdZdZddddddddd œZd
|
|||
|
|
d d d
|
|||
|
|
œˆ fd„
|
|||
|
|
Z ed„ « Zd„ Z d„ Z
|
|||
|
|
ˆ xZ S )Ú
|
|||
|
|
AsinhScaleaì
|
|||
|
|
A quasi-logarithmic scale based on the inverse hyperbolic sine (asinh)
|
|||
|
|
|
|||
|
|
For values close to zero, this is essentially a linear scale,
|
|||
|
|
but for large magnitude values (either positive or negative)
|
|||
|
|
it is asymptotically logarithmic. The transition between these
|
|||
|
|
linear and logarithmic regimes is smooth, and has no discontinuities
|
|||
|
|
in the function gradient in contrast to
|
|||
|
|
the `.SymmetricalLogScale` ("symlog") scale.
|
|||
|
|
|
|||
|
|
Specifically, the transformation of an axis coordinate :math:`a` is
|
|||
|
|
:math:`a \rightarrow a_0 \sinh^{-1} (a / a_0)` where :math:`a_0`
|
|||
|
|
is the effective width of the linear region of the transformation.
|
|||
|
|
In that region, the transformation is
|
|||
|
|
:math:`a \rightarrow a + \mathcal{O}(a^3)`.
|
|||
|
|
For large values of :math:`a` the transformation behaves as
|
|||
|
|
:math:`a \rightarrow a_0 \, \mathrm{sgn}(a) \ln |a| + \mathcal{O}(1)`.
|
|||
|
|
|
|||
|
|
.. note::
|
|||
|
|
|
|||
|
|
This API is provisional and may be revised in the future
|
|||
|
|
based on early user feedback.
|
|||
|
|
Úasinh)rx )rx é )rx é )rx r× é )r× é )é i )é r× rØ rÙ ry rÚ é@ i r¦ ry Úauto)rÈ rl r� c óÒ •— t ‰| � |« t |« | _ t |« | _ |dk( r+| j j | j
|
|||
|
|
« | _ y|| _ y)a
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
linear_width : float, default: 1
|
|||
|
|
The scale parameter (elsewhere referred to as :math:`a_0`)
|
|||
|
|
defining the extent of the quasi-linear region,
|
|||
|
|
and the coordinate values beyond which the transformation
|
|||
|
|
becomes asymptotically logarithmic.
|
|||
|
|
base : int, default: 10
|
|||
|
|
The number base used for rounding tick locations
|
|||
|
|
on a logarithmic scale. If this is less than one,
|
|||
|
|
then rounding is to the nearest integer multiple
|
|||
|
|
of powers of ten.
|
|||
|
|
subs : sequence of int
|
|||
|
|
Multiples of the number base used for minor ticks.
|
|||
|
|
If set to 'auto', this will use built-in defaults,
|
|||
|
|
e.g. (2, 5) for base=10.
|
|||
|
|
rÞ N) rE r rÆ r] ÚintÚ_baseÚauto_tick_multipliersr� Ú_subs)r r rÈ rl r� ÚkwargsrL s €r r zAsinhScale.__init__& sS ø€ ô( ‰Ñ˜Ô Ü(¨ Ó6ˆŒÜ˜“YˆŒ
|
|||
|
|
Ø �6Š>Ø ×3Ñ3×7Ñ7¸¿
|
|||
|
|
¹
|
|||
|
|
ÓCˆD�Jà ˆD�Jr c ó. — | j j S rN )r] rÈ r s r r“ zAsinhScale.<lambda>B s € ¨¯ © ×)EÑ)E€ r c ó — | j S rN ra r s r r! zAsinhScale.get_transformD s € Ø�‰Ð r c óX — |j t | j | j ¬« t | j | j | j ¬« t « ¬« | j dkD r%|j
|
|||
|
|
t | j « « y |j
|
|||
|
|
d« y )N)rl )rl r� )Ú
|
|||
|
|
major_locatorÚ
|
|||
|
|
minor_locatorÚminor_formatterrC z{x:.3g})Úsetr rÈ rá rã r r8 r r s r r# z.AsinhScale.set_default_locators_and_formattersG s� € Ø �‰œ|¨D×,=Ñ,=Ø15·±ô =ä +¨D×,=Ñ,=Ø15·±Ø15·±ô =ô "/£ ð ô 2ð �:‰:˜Š>Ø × $Ñ $Ô%<¸T¿Z¹ZÓ%HÕ Ià × $Ñ $ YÕ /r ) r* r+ r, r- r@ râ r r› rÈ r! r# rW rX s @r rÕ rÕ sW ø„ ñð0 €Dð Ø Ø Ø Ø Ø Ø Øñ Ðð .1ؘvö ñ8 Ñ EÓF€Lò ö
|
|||
|
|
0r rÕ c ó: ‡ — e Zd ZdxZZdˆ fd„ Zd„ Zd„ Zd„ Zˆ xZ S )ÚLogitTransformrC c ó| •— t ‰| � « t j ddg|¬« || _ dddœ| | _ y )Nri rh rj TFrg )rE r r Ú
|
|||
|
|
check_in_listÚ _nonpositivern ©r rk rL s €r r zLogitTransform.__init__W s< ø€ Ü
|
|||
|
|
‰ÑÔÜ ×јF FÐ+¸ÕEØ 'ˆÔØ "¨EÑ2°;Ñ?ˆ�
|
|||
|
|
r c óÌ — t j dd¬« 5 t j |d|z
|
|||
|
|
z « }ddd« | j rd|dk < d|d|k < S # 1 sw Y Œ'xY w)z,logit transform (base 10), masked or clippedrt ru rC Nrz r iè )r{ r| r€ rn )r rP r‚ s r rQ z#LogitTransform.transform_non_affine] sd € ä
|
|||
|
|
�[‰[ °(Ô
|
|||
|
|
;ñ 2Ü—(‘(˜6 Q¨¡ZÑ0Ó1ˆC÷ 2à �:Š:Ø $ˆC�˜!‘ Ñ Ø #ˆC��V‘ Ñ Øˆ
|
|||
|
|
÷ 2ð 2ús ˜ AÁA#c ó, — t | j « S rN )ÚLogisticTransformrð r s r rS zLogitTransform.invertedf s € Ü ×!2Ñ!2Ó3Ð3r c óL — t | « j › d| j ›d�S ©Nú(r‰ ©rq r* rð r s r rr zLogitTransform.__str__i ó' € Ü�t“*×%Ñ%Ð& a¨×(9Ñ(9Ð'<¸AÐ>Ð>r ©ri ©
|
|||
|
|
r* r+ r, rU rV r rQ rS rr rW rX s @r rí rí T s" ø„ Ø Ð €J�õ@ò ò4ö?r rí c ó: ‡ — e Zd ZdxZZdˆ fd„ Zd„ Zd„ Zd„ Zˆ xZ S )rô rC c ó0 •— t ‰| � « || _ y rN )rE r rð rñ s €r r zLogisticTransform.__init__p s ø€ Ü
|
|||
|
|
‰ÑÔØ 'ˆÕr c ó — ddd| z z z S )z logistic transform (base 10)r¦ rC ry r rO s r rQ z&LogisticTransform.transform_non_affinet s € à�a˜" ˜w™-Ñ'Ñ(Ð(r c ó, — t | j « S rN )rí rð r s r rS zLogisticTransform.invertedx rÓ r c óL — t | « j › d| j ›d�S rö rø r s r rr zLogisticTransform.__str__{ rù r rú rû rX s @r rô rô m s! ø„ Ø Ð €J�õ(ò)ò1ö?r rô c ó6 — e Zd ZdZdZd dddœd„Zd„ Zd„ Zd „ Zy
|
|||
|
|
) Ú
|
|||
|
|
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[.
|
|||
|
|
Úlogitz \frac{1}{2}F©Úone_halfÚ use_overlinec ó@ — t |« | _ || _ || _ y)a…
|
|||
|
|
Parameters
|