Ë
|
Kñúhí ã óº d Z g d¢ZdZddlZddlZddlZ ddlmZ ddl
|
Z
|
ddl Z ddl Z ddl ZddlmZ ddlmZ dd lmZmZmZmZmZmZ dd
|
lm Z m Z m Z dd lm Z m Z m!Z!m"Z" dd l#m$Z$m%Z% dd l&m'Z' ddl(m)Z)m*Z*m+Z+m,Z, dIdZ- e%d« dJdddd« Z. dJddddZ/ e%d« d « Z0d Z1 e%d« e
|
jd d « « Z&dKdZ3d Z4d Z5d Z6d Z7d Z8dLd Z9 e9« dMd « Z: dIdd!d"Z; e$e;d¬#« dddd d ejx dddddd f dd!d$« Z=d% Z>d& Z?d' Z@d( ZA G d) d*« ZB e%d« dNd+« ZC e%d« dOd,« ZD G d- d.« ZE G d/ d0« ZF G d1 d2« ZG G d3 d4« ZH G d5 d6eH« ZI G d7 d8eH« ZJ G d9 d:« ZK G d; d<« ZLdPd=ZMe"e!e ej gZOd> ZPd? ZQddde=fd@ZR dQdAZS e$eSd¬#« dQdB« ZT e9« dC « ZUddde=fdDZV dQdEZW e$eWd¬#« dQdF« ZX eYe=dGe=« ZZ ej¶ eVeZ¬H« Z\ ej¶ eReZ¬H« Z]y# e$ r
|
ddl mZ Y =w xY w)RzXArray printing function
|
|
$Id: arrayprint.py,v 1.9 2005/09/13 13:58:44 teoliphant Exp $
|
|
)Ú array2stringÚ array_strÚ
|
array_reprÚset_printoptionsÚget_printoptionsÚ printoptionsÚformat_float_positionalÚformat_float_scientificÚrestructuredtexté N)Ú get_identé )Ú numerictypes)Úany)ÚarrayÚdatetime_as_stringÚ datetime_dataÚdragon4_positionalÚdragon4_scientificÚndarray)ÚasarrayÚ concatenateÚerrstate)Ú
|
complex128ÚflexibleÚfloat64Úint_)Úarray_function_dispatchÚ
|
set_module)Úformat_options)ÚabsoluteÚisfiniteÚisinfÚisnatc ód t t « j « « D ci c] \ } } | | | }} } |t |« |d< g d¢}| |dgz vr$t ddj d |D « « z « |dvr t d« |
|
d u rt j |d
|
< n|
|
d k( r4t j d |
|
d t d ¬« t j |d
|
< nQ|
|
dk( rd|d
|
< nF|
|
dk( rd|d
|
< n;|
|
dk( rd|d
|
< n0|
|
dk( rd|d
|
< n%|
|
dk( rd|d
|
< n|
|
nt j dd ¬« |Et |t j « s t d« t j |« r t d« | t# j$ | « |d < |S |S c c} } w # t $ r}t d « |d}~ww xY w) zm
|
Make a dictionary out of the non-None arguments, plus conversion of
|
*legacy* and sanity checks.
|
NÚsuppress)ÚfixedÚuniqueÚmaxprecÚ maxprec_equalz floatmode option must be one of ú, c 3 ó( K | ]
|
}d | d yw)ú"N© )Ú.0Úms úIH:\Change_password\venv_build\Lib\site-packages\numpy/_core/arrayprint.pyú <genexpr>z%_make_options_dict.<locals>.<genexpr>J s è ø Ò";° Q q c¨¤8Ñ";ùs )Nú-ú+ú z+sign option must be one of ' ', '+', or '-'FÚlegacyzPassing `legacy=z` is deprecated.é ©Ú
|
stacklevelú1.13éq ú1.21éy ú1.25é} ú2.1éÉ ú2.2éÊ z\legacy printing option can currently only be '1.13', '1.21', '1.25', '2.1', '2.2' or `False`zthreshold must be numericzIthreshold must be non-NAN, try sys.maxsize for untruncated representationÚ precisionz precision must be an integer)ÚlistÚlocalsÚitemsÚboolÚ
|
ValueErrorÚjoinÚsysÚmaxsizeÚwarningsÚwarnÚ FutureWarningÚ
|
isinstanceÚnumbersÚNumberÚ TypeErrorÚnpÚisnanÚoperatorÚindex)rC Ú thresholdÚ edgeitemsÚ linewidthr% ÚnanstrÚinfstrÚsignÚ formatterÚ floatmoder5 Ú override_reprÚkÚvÚoptionsÚmodesÚes r0 Ú_make_options_dictre 9 sí ô !%¤V£X§^¡^Ó%5Ó 6×H1¸!¹-q!tÐHGÑHàÐÜ " 8n
|
Ñâ ;EØ Ñ&ÜÐ;Ø Ñ";°UÔ";Ó;ñ<ó =ð =ð Ð(Ñ(ÜÐFÓGÐGà Ü KKÒØ 5 Ü Ø vjÐ(8Ð 9Ü aõ
|
ô KKÒØ 6Ò Ø ÒØ 6Ò Ø ÒØ 6Ò Ø ÒØ 5 Ø ÒØ 5 Ø ÒØ Ø ä ð .Ø:;õ =ð Ð ä)¤W§^¡^Ô4ÜÐ 7Ó8Ð 8Ü 88IÔ Ü ð Jó Kð Kð Ð ð CÜ#+§>¡>°)Ó#<GKÑ ð N7Nùók Iøôd ò CÜÐ :Ó;ÀÐ Bûð Cús" ¥
|
F°FÅ3F Æ F/Æ F*Æ*F/Únumpy©r5 r_ c
|
ó2 t | ||||||||| |
|
| ¬« y)a
|
Set printing options.
|
|
These options determine the way floating point numbers, arrays and
|
other NumPy objects are displayed.
|
|
Parameters
|
----------
|
precision : int or None, optional
|
Number of digits of precision for floating point output (default 8).
|
May be None if `floatmode` is not `fixed`, to print as many digits as
|
necessary to uniquely specify the value.
|
threshold : int, optional
|
Total number of array elements which trigger summarization
|
rather than full repr (default 1000).
|
To always use the full repr without summarization, pass `sys.maxsize`.
|
edgeitems : int, optional
|
Number of array items in summary at beginning and end of
|
each dimension (default 3).
|
linewidth : int, optional
|
The number of characters per line for the purpose of inserting
|
line breaks (default 75).
|
suppress : bool, optional
|
If True, always print floating point numbers using fixed point
|
notation, in which case numbers equal to zero in the current precision
|
will print as zero. If False, then scientific notation is used when
|
absolute value of the smallest number is < 1e-4 or the ratio of the
|
maximum absolute value to the minimum is > 1e3. The default is False.
|
nanstr : str, optional
|
String representation of floating point not-a-number (default nan).
|
infstr : str, optional
|
String representation of floating point infinity (default inf).
|
sign : string, either '-', '+', or ' ', optional
|
Controls printing of the sign of floating-point types. If '+', always
|
print the sign of positive values. If ' ', always prints a space
|
(whitespace character) in the sign position of positive values. If
|
'-', omit the sign character of positive values. (default '-')
|
|
.. versionchanged:: 2.0
|
The sign parameter can now be an integer type, previously
|
types were floating-point types.
|
|
formatter : dict of callables, optional
|
If not None, the keys should indicate the type(s) that the respective
|
formatting function applies to. Callables should return a string.
|
Types that are not specified (by their corresponding keys) are handled
|
by the default formatters. Individual types for which a formatter
|
can be set are:
|
|
- 'bool'
|
- 'int'
|
- 'timedelta' : a `numpy.timedelta64`
|
- 'datetime' : a `numpy.datetime64`
|
- 'float'
|
- 'longfloat' : 128-bit floats
|
- 'complexfloat'
|
- 'longcomplexfloat' : composed of two 128-bit floats
|
- 'numpystr' : types `numpy.bytes_` and `numpy.str_`
|
- 'object' : `np.object_` arrays
|
|
Other keys that can be used to set a group of types at once are:
|
|
- 'all' : sets all types
|
- 'int_kind' : sets 'int'
|
- 'float_kind' : sets 'float' and 'longfloat'
|
- 'complex_kind' : sets 'complexfloat' and 'longcomplexfloat'
|
- 'str_kind' : sets 'numpystr'
|
floatmode : str, optional
|
Controls the interpretation of the `precision` option for
|
floating-point types. Can take the following values
|
(default maxprec_equal):
|
|
* 'fixed': Always print exactly `precision` fractional digits,
|
even if this would print more or fewer digits than
|
necessary to specify the value uniquely.
|
* 'unique': Print the minimum number of fractional digits necessary
|
to represent each value uniquely. Different elements may
|
have a different number of digits. The value of the
|
`precision` option is ignored.
|
* 'maxprec': Print at most `precision` fractional digits, but if
|
an element can be uniquely represented with fewer digits
|
only print it with that many.
|
* 'maxprec_equal': Print at most `precision` fractional digits,
|
but if every element in the array can be uniquely
|
represented with an equal number of fewer digits, use that
|
many digits for all elements.
|
legacy : string or `False`, optional
|
If set to the string ``'1.13'`` enables 1.13 legacy printing mode. This
|
approximates numpy 1.13 print output by including a space in the sign
|
position of floats and different behavior for 0d arrays. This also
|
enables 1.21 legacy printing mode (described below).
|
|
If set to the string ``'1.21'`` enables 1.21 legacy printing mode. This
|
approximates numpy 1.21 print output of complex structured dtypes
|
by not inserting spaces after commas that separate fields and after
|
colons.
|
|
If set to ``'1.25'`` approximates printing of 1.25 which mainly means
|
that numeric scalars are printed without their type information, e.g.
|
as ``3.0`` rather than ``np.float64(3.0)``.
|
|
If set to ``'2.1'``, shape information is not given when arrays are
|
summarized (i.e., multiple elements replaced with ``...``).
|
|
If set to ``'2.2'``, the transition to use scientific notation for
|
printing ``np.float16`` and ``np.float32`` types may happen later or
|
not at all for larger values.
|
|
If set to `False`, disables legacy mode.
|
|
Unrecognized strings will be ignored with a warning for forward
|
compatibility.
|
|
.. versionchanged:: 1.22.0
|
.. versionchanged:: 2.2
|
|
override_repr: callable, optional
|
If set a passed function will be used for generating arrays' repr.
|
Other options will be ignored.
|
|
See Also
|
--------
|
get_printoptions, printoptions, array2string
|
|
Notes
|
-----
|
`formatter` is always reset with a call to `set_printoptions`.
|
|
Use `printoptions` as a context manager to set the values temporarily.
|
|
Examples
|
--------
|
Floating point precision can be set:
|
|
>>> import numpy as np
|
>>> np.set_printoptions(precision=4)
|
>>> np.array([1.123456789])
|
[1.1235]
|
|
Long arrays can be summarised:
|
|
>>> np.set_printoptions(threshold=5)
|
>>> np.arange(10)
|
array([0, 1, 2, ..., 7, 8, 9], shape=(10,))
|
|
Small results can be suppressed:
|
|
>>> eps = np.finfo(float).eps
|
>>> x = np.arange(4.)
|
>>> x**2 - (x + eps)**2
|
array([-4.9304e-32, -4.4409e-16, 0.0000e+00, 0.0000e+00])
|
>>> np.set_printoptions(suppress=True)
|
>>> x**2 - (x + eps)**2
|
array([-0., -0., 0., 0.])
|
|
A custom formatter can be used to display array elements as desired:
|
|
>>> np.set_printoptions(formatter={'all':lambda x: 'int: '+str(-x)})
|
>>> x = np.arange(3)
|
>>> x
|
array([int: 0, int: -1, int: -2])
|
>>> np.set_printoptions() # formatter gets reset
|
>>> x
|
array([0, 1, 2])
|
|
To put back the default options, you can use:
|
|
>>> np.set_printoptions(edgeitems=3, infstr='inf',
|
... linewidth=75, nanstr='nan', precision=8,
|
... suppress=False, threshold=1000, formatter=None)
|
|
Also to temporarily override options, use `printoptions`
|
as a context manager:
|
|
>>> with np.printoptions(precision=2, suppress=True, threshold=5):
|
... np.linspace(0, 10, 10)
|
array([ 0. , 1.11, 2.22, ..., 7.78, 8.89, 10. ], shape=(10,))
|
|
rg N)Ú_set_printoptions) rC rW rX rY r% rZ r[ r] r\ r^ r5 r_ s r0 r r z s( ôp i ¨I°yÀ(Ø f i°°yØ #°=öBó c
|
óÔ t | ||||||||| |
|
« } || d< | | d< t j « | z } | j | « | d dk( rd| d< t j | « S )Nr] r_ r5 r: r2 r\ )re r ÚgetÚupdateÚset)rC rW rX rY r% rZ r[ r] r\ r^ r5 r_ Únew_optÚ updated_opts r0 ri ri 7 s
ô ! ¨I°yÀ)Ø!)¨6°6¸4ÀØ!*¨Fó4Gð %GKÑØ ,GOÑ ä ×$Ñ$Ó&¨Ñ0KØ×ÑwÔ à8Ñ Ò#Ø ! FÑä × Ñ kÓ *Ð*rj c ó t j « j « } ddddddddd d
|
t j d i| d | d < | S ) ak
|
Return the current print options.
|
|
Returns
|
-------
|
print_opts : dict
|
Dictionary of current print options with keys
|
|
- precision : int
|
- threshold : int
|
- edgeitems : int
|
- linewidth : int
|
- suppress : bool
|
- nanstr : str
|
- infstr : str
|
- sign : str
|
- formatter : dict of callables
|
- floatmode : str
|
- legacy : str or False
|
|
For a full description of these options, see `set_printoptions`.
|
|
See Also
|
--------
|
set_printoptions, printoptions
|
|
Examples
|
--------
|
>>> import numpy as np
|
|
>>> np.get_printoptions()
|
{'edgeitems': 3, 'threshold': 1000, ..., 'override_repr': None}
|
|
>>> np.get_printoptions()['linewidth']
|
75
|
>>> np.set_printoptions(linewidth=100)
|
>>> np.get_printoptions()['linewidth']
|
100
|
|
r: r9 r< r; r> r= r@ r? rB rA Fr5 )r rl ÚcopyrJ rK )Úoptss r0 r r K sZ ôT × Ñ Ó × $Ñ $Ó &Dà VS& # v¨s°EØ UCKK ðð 8nñDNð Krj c ó0 t j « d S )z'Return the legacy print mode as an int.r5 )r rl r- rj r0 Ú_get_legacy_print_moderu } s ä × Ñ Ó Ñ )Ð)rj c / ó K t | i |¤} t « t j |« y# t j |« w xY ww)a Context manager for setting print options.
|
|
Set print options for the scope of the `with` block, and restore the old
|
options at the end. See `set_printoptions` for the full description of
|
available options.
|
|
Examples
|
--------
|
>>> import numpy as np
|
|
>>> from numpy.testing import assert_equal
|
>>> with np.printoptions(precision=2):
|
... np.array([2.0]) / 3
|
array([0.67])
|
|
The `as`-clause of the `with`-statement gives the current print options:
|
|
>>> with np.printoptions(precision=2) as opts:
|
... assert_equal(opts, np.get_printoptions())
|
|
See Also
|
--------
|
set_printoptions, get_printoptions
|
|
N)ri r r Úreset)ÚargsÚkwargsÚtokens r0 r r sA è ø ô8 tÐ . vÑ .Eð$Ü Ó Ò ä× Ñ UÕ#ø× Ñ UÕ#üs A 1 A ±AÁA c óH t |« }|| j k( r| | S | j | d|z kD rNt t | ||t
|
j d| z « t | ||t
|
j | d z « f|¬« S t | ||t
|
j dd z « S )z·
|
Keep only the N-D corners (leading and trailing edges) of an array.
|
|
Should be passed a base-class ndarray, since it makes no guarantees about
|
preserving subclasses.
|
é N)Úaxis)ÚlenÚndimÚshaper Ú_leading_trailingrS Ú index_exp)ÚarX rV r} s r0 r r ¦ s¤ ô u:DØ qvv~Øxàwwt}q9}Ò$ÜÜ a ¨E´B·L±LÀÀ)Ð4LÑ,LÓ MÜ a ¨E´B·L±LÀ)ÀÀÐ4MÑ,MÓ Nð
|
ð ôð ô
|
! I¨u´r·|±|ÁA°Ñ/FÓGÐGrj c óP t | « t u rd}nd}|j | « S )z@ Object arrays containing lists should be printed unambiguously z
|
list({!r})z{!r})ÚtyperD Úformat)ÚoÚfmts r0 Ú_object_formatr º s% ä Aw$ØàØ ::a=Ðrj c ó t | t j t j f« rt | j « « S t | « S ©N)rO rS Ústr_Úbytes_ÚreprÚitem©Úxs r0 Ú repr_formatr  s2 Ü!bggryyÐ)Ô*ÜAFFH~Ð Ü 7Nrj c ó t | t j t j f« rt | j « « S t | « S r )rO rS r r Ústrr r s r0 Ú
|
str_formatr Ç s2 Ü!bggryyÐ)Ô*Ü1668}Ð Ü q6Mrj c óB fd fd fd fd fd fd fd fdd d
|
d d }d } |Ï|j « D
|
cg c]
|
}
|
||
|
|
|
} }
|
d| v r#|j « D ] } | |d « || < d| v rdD ] } | |d « || < d| v rdD ] } | |d « || < d| v rdD ] } | |d « || < d| v r | |d « |d< |j « D ] } | | v s | || « || < |S c c}
|
w )Nc ó t « S r )Ú
|
BoolFormat©Údatas r0 ú<lambda>z!_get_formatdict.<locals>.<lambda>Ó s ø
|
4Ó( rj c ó t « S r )Ú IntegerFormat)r r\ s r0 r z!_get_formatdict.<locals>.<lambda>Ô s ø } T¨4Ó0 rj c ó& t ¬« S ©N©r5 ©ÚFloatingFormat©r r^ r5 rC r\ r% s r0 r z!_get_formatdict.<locals>.<lambda>Õ s ø Ø )Y¨°$¸vôG rj c ó& t ¬« S r r¡ r£ s r0 r z!_get_formatdict.<locals>.<lambda>× s ø ^Ø )Y¨°$¸vô G rj c ó& t ¬« S r ©ÚComplexFloatingFormatr£ s r0 r z!_get_formatdict.<locals>.<lambda>Ù s ø Ô 5Ø )Y¨°$¸vô!G rj c ó& t ¬« S r r¦ r£ s r0 r z!_get_formatdict.<locals>.<lambda>Û s ø Ô$9Ø )Y¨°$¸vô%G rj c ó t ¬« S r )ÚDatetimeFormat)r r5 s r0 r z!_get_formatdict.<locals>.<lambda>Ý s ø N¨4¸Ô ? rj c ó t « S r )ÚTimedeltaFormatr s r0 r z!_get_formatdict.<locals>.<lambda>Þ s ø _¨TÓ 2 rj c ó t S r )r r- rj r0 r z!_get_formatdict.<locals>.<lambda>ß s . rj c ó t S r )r r- rj r0 r z!_get_formatdict.<locals>.<lambda>à s
|
rj c ó t S r )r r- rj r0 r z!_get_formatdict.<locals>.<lambda>á s K rj ) rG ÚintÚfloatÚ longfloatÚ complexfloatÚlongcomplexfloatÚdatetimeÚ timedeltaÚobjectÚvoidÚnumpystrc ó fdS )Nc ó S r r- r s r0 r z3_get_formatdict.<locals>.indirect.<locals>.<lambda>æ s ø q rj r- r s `r0 Úindirectz!_get_formatdict.<locals>.indirectå s ø ÛÐrj ÚallÚint_kind)r° Ú
|
float_kind)r± r² Ú complex_kind)r³ r´ Ústr_kindr¹ )Úkeys) r rC r^ r% r\ r5 r] ry Ú
|
formatdictr¼ r` ÚfkeysÚkeys `````` r0 Ú_get_formatdictrÆ Ì s ý ó )Ü0÷Gð G÷Gð G÷Gð G÷ Gð Gä?Û2Ù(Ù"Ù'ñ )Jò&ð Ð Ø %NNÓ ,ÖIq° ¸!± Ñ0HÐIÐIØ E>Ø!Ó(ò =Ù"*¨9°UÑ+;Ó"<
|
3ð =à Ñ Ø ò BÙ"*¨9°ZÑ+@Ó"A
|
3ð Bà 5Ñ Ø-ò DÙ"*¨9°\Ñ+BÓ"C
|
3ð Dà UÑ "Ø;ò FÙ"*¨9°^Ñ+DÓ"E
|
3ð Fà Ñ Ù%-¨i¸
|
Ñ.CÓ%DJzÑ "Ø ??Ó$ò ;CØe|Ù"*¨9°S©>Ó":
|
3ð ;ð Ðùò' Js Á
|
D Á(D c óò | j }|j }t | fi |¤}|
|
|d « S t |t j
|
« r
|
|d « S t |t j « r.t |t j « r
|
|d « S |d « S t |t j « r.t |t j « r
|
|d « S |d « S t |t j « r.t |t j « r
|
|d « S |d « S t |t j t j f« r
|
|d « S t |t j « r
|
|d « S t |t j « r
|
|d
|
« S t |t j « r,|j" t% j& | fi |¤S |d « S |d « S ) z;
|
find the right formatting function for the dtype_
|
r¹ rG r¶ r° r² r± r´ r³ rµ r· r¸ )Údtyper
rÆ Ú
|
issubclassÚ_ntrG ÚintegerÚ timedelta64ÚfloatingÚ
|
longdoubleÚcomplexfloatingÚ clongdoubler r Ú
|
datetime64Úobject_r¸ ÚnamesÚStructuredVoidFormatÚ from_data)r rb Údtype_Údtypeobjrà s r0 Ú_get_format_functionrØ þ sÁ ð ZZFØ{{HÜ Ñ1¨Ñ1JØÐØ%z*Ñ%Ó'Ð'Ü HchhÔ 'Ø!z&Ñ!Ó#Ð#Ü HckkÔ *Ü h¤§¡Ô 0Ø*:kÑ*Ó,Ð ,à$:eÑ$Ó&Ð &Ü HcllÔ +Ü h¤§¡Ô /Ø*:kÑ*Ó,Ð ,à&:gÑ&Ó(Ð (Ü Hc× 1Ñ 1Ô 2Ü h¤§¡Ô 0Ø1:Ð 0Ñ1Ó3Ð 3à-:nÑ-Ó/Ð /Ü Hsxx¬¯©Ð 4Ô 5Ø%z*Ñ%Ó'Ð'Ü HcnnÔ -Ø%z*Ñ%Ó'Ð'Ü HckkÔ *Ø#z(Ñ#Ó%Ð%Ü HchhÔ 'Ø <<Ð #Ü'×1Ñ1°$ÑB¸'ÑBÐ Bà%:fÑ%Ó'Ð 'à%z*Ñ%Ó'Ð'rj c ó fd}|S )a
|
Like the python 3.2 reprlib.recursive_repr, but forwards *args and **kwargs
|
|
Decorates a function such that if it calls itself with the same first
|
argument, it returns `fillvalue` instead of recursing.
|
|
Largely copied from reprlib.recursive_repr
|
c ó^ t « t j « fd« }|S )Nc óÄ t | « t « f}|v rS j |« | g|¢i |¤j |« S # j |« w xY wr )Úidr ÚaddÚdiscard)Úselfrx ry rÅ ÚfÚ fillvalueÚ repr_runnings r0 Úwrapperz>_recursive_guard.<locals>.decorating_function.<locals>.wrapper4 sc ø äT(IKÐ'CØlÑ"Ø Ð Ø × Ñ SÔ !ð *ÙÐ/ Ò/¨Ñ/à ×$Ñ$ SÕ)ø ×$Ñ$ SÕ)ús ¯ A Á A )rn Ú functoolsÚwraps)rà rã râ rá s ` @r0 Údecorating_functionz-_recursive_guard.<locals>.decorating_function1 s, ú Üu ä Ó õ *ó
|
ð *ð rj r- )rá ræ s ` r0 Ú_recursive_guardrç ' s ø ôð Ð rj r4 Ú c óþ t | « }| j dk( r|} | j |d kD rd}t ||d « }nd}t |fi |¤}d}|dt |« z z }t | ||d |||d ||d « }|S ) Nr- rW ú...rX rè r4 rY r5 )r r Úsizer rØ r~ Ú _formatArray) r rb Ú separatorÚprefixr Úsummary_insertÚformat_functionÚnext_line_prefixÚlsts r0 Ú _array2stringró E s¨ ô
|
1:DØww"}Ø àvv Ñ$Ò$Ø Ü w¨{Ñ';Ó<àô +¨4Ñ;°7Ñ;Oð Ðàc &kÑ)Ñ)Ðä
|
q/¨7°;Ñ+?Ø'¨°G¸KÑ4HØ% w¨xÑ'8ó :Cð Jrj r c ó | fS r r- )r Úmax_line_widthrC Úsuppress_smallrí rî Ústyler] rW rX r\ r^ Úsuffixr5 s r0 Ú_array2string_dispatcherrù b s ð 4Krj )Úmodulec ó t ||| ||dd|
|
|| | « }t j « j « }|j |« |d dk rS|t
|
j u rt }| j dk( rZ| j j D || j « « S |t
|
j ur t j dt d¬« |d dkD r|dxx t | « z cc< | j d k( ry
|
t# | |||« S ) a
|
Return a string representation of an array.
|
|
Parameters
|
----------
|
a : ndarray
|
Input array.
|
max_line_width : int, optional
|
Inserts newlines if text is longer than `max_line_width`.
|
Defaults to ``numpy.get_printoptions()['linewidth']``.
|
precision : int or None, optional
|
Floating point precision.
|
Defaults to ``numpy.get_printoptions()['precision']``.
|
suppress_small : bool, optional
|
Represent numbers "very close" to zero as zero; default is False.
|
Very close is defined by precision: if the precision is 8, e.g.,
|
numbers smaller (in absolute value) than 5e-9 are represented as
|
zero.
|
Defaults to ``numpy.get_printoptions()['suppress']``.
|
separator : str, optional
|
Inserted between elements.
|
prefix : str, optional
|
suffix : str, optional
|
The length of the prefix and suffix strings are used to respectively
|
align and wrap the output. An array is typically printed as::
|
|
prefix + array2string(a) + suffix
|
|
The output is left-padded by the length of the prefix string, and
|
wrapping is forced at the column ``max_line_width - len(suffix)``.
|
It should be noted that the content of prefix and suffix strings are
|
not included in the output.
|
style : _NoValue, optional
|
Has no effect, do not use.
|
|
.. deprecated:: 1.14.0
|
formatter : dict of callables, optional
|
If not None, the keys should indicate the type(s) that the respective
|
formatting function applies to. Callables should return a string.
|
Types that are not specified (by their corresponding keys) are handled
|
by the default formatters. Individual types for which a formatter
|
can be set are:
|
|
- 'bool'
|
- 'int'
|
- 'timedelta' : a `numpy.timedelta64`
|
- 'datetime' : a `numpy.datetime64`
|
- 'float'
|
- 'longfloat' : 128-bit floats
|
- 'complexfloat'
|
- 'longcomplexfloat' : composed of two 128-bit floats
|
- 'void' : type `numpy.void`
|
- 'numpystr' : types `numpy.bytes_` and `numpy.str_`
|
|
Other keys that can be used to set a group of types at once are:
|
|
- 'all' : sets all types
|
- 'int_kind' : sets 'int'
|
- 'float_kind' : sets 'float' and 'longfloat'
|
- 'complex_kind' : sets 'complexfloat' and 'longcomplexfloat'
|
- 'str_kind' : sets 'numpystr'
|
threshold : int, optional
|
Total number of array elements which trigger summarization
|
rather than full repr.
|
Defaults to ``numpy.get_printoptions()['threshold']``.
|
edgeitems : int, optional
|
Number of array items in summary at beginning and end of
|
each dimension.
|
Defaults to ``numpy.get_printoptions()['edgeitems']``.
|
sign : string, either '-', '+', or ' ', optional
|
Controls printing of the sign of floating-point types. If '+', always
|
print the sign of positive values. If ' ', always prints a space
|
(whitespace character) in the sign position of positive values. If
|
'-', omit the sign character of positive values.
|
Defaults to ``numpy.get_printoptions()['sign']``.
|
|
.. versionchanged:: 2.0
|
The sign parameter can now be an integer type, previously
|
types were floating-point types.
|
|
floatmode : str, optional
|
Controls the interpretation of the `precision` option for
|
floating-point types.
|
Defaults to ``numpy.get_printoptions()['floatmode']``.
|
Can take the following values:
|
|
- 'fixed': Always print exactly `precision` fractional digits,
|
even if this would print more or fewer digits than
|
necessary to specify the value uniquely.
|
- 'unique': Print the minimum number of fractional digits necessary
|
to represent each value uniquely. Different elements may
|
have a different number of digits. The value of the
|
`precision` option is ignored.
|
- 'maxprec': Print at most `precision` fractional digits, but if
|
an element can be uniquely represented with fewer digits
|
only print it with that many.
|
- 'maxprec_equal': Print at most `precision` fractional digits,
|
but if every element in the array can be uniquely
|
represented with an equal number of fewer digits, use that
|
many digits for all elements.
|
legacy : string or `False`, optional
|
If set to the string ``'1.13'`` enables 1.13 legacy printing mode. This
|
approximates numpy 1.13 print output by including a space in the sign
|
position of floats and different behavior for 0d arrays. If set to
|
`False`, disables legacy mode. Unrecognized strings will be ignored
|
with a warning for forward compatibility.
|
|
Returns
|
-------
|
array_str : str
|
String representation of the array.
|
|
Raises
|
------
|
TypeError
|
if a callable in `formatter` does not return a string.
|
|
See Also
|
--------
|
array_str, array_repr, set_printoptions, get_printoptions
|
|
Notes
|
-----
|
If a formatter is specified for a certain type, the `precision` keyword is
|
ignored for that type.
|
|
This is a very flexible function; `array_repr` and `array_str` are using
|
`array2string` internally so keywords with the same name should work
|
identically in all three functions.
|
|
Examples
|
--------
|
>>> import numpy as np
|
>>> x = np.array([1e-16,1,2,3])
|
>>> np.array2string(x, precision=2, separator=',',
|
... suppress_small=True)
|
'[0.,1.,2.,3.]'
|
|
>>> x = np.arange(3.)
|
>>> np.array2string(x, formatter={'float_kind':lambda x: "%.2f" % x})
|
'[0.00 1.00 2.00]'
|
|
>>> x = np.arange(3)
|
>>> np.array2string(x, formatter={'int':lambda x: hex(x)})
|
'[0x0 0x1 0x2]'
|
|
Nr5 r: r- zT'style' argument is deprecated and no longer functional except in 1.13 'legacy' moder| r7 rY r z[])re r rl rr rm rS Ú_NoValuer r rÈ rÓ r rL rM ÚDeprecationWarningr~ rë ró )r rõ rC rö rí rî r÷ r] rW rX r\ r^ rø r5 Ú overridesrb s r0 r r k sù ôt # 9¨i¸Ø#1°>À4ÈØ#'¨°I¸vóGIô × Ñ Ó"×'Ñ'Ó)GØ NN9Ô àxÑCÒ Ø BKKÑ ÜEà 77b=QWW]]Ð 2Ù?Ð "Ø bkkÑ !ä ð 6ä(°Qõ 8ð xÑ3Ò Ø Ó ¤ F£ Ñ+Ó ð vv{Øä G Y°Ó 7Ð7rj c ó¸ t |« t |« z |kD }|dkD rt |« t |« k rd}|r| |j « dz z } |}||z }| |fS )Nr: Fú
|
)r~ Úrstrip)ÚsÚlineÚwordÚ
|
line_widthrñ r5 Ú
|
needs_wraps r0 Ú _extendLiner ! sf ÜTS YÑ&¨Ñ3JØ |ä t9Ð ,Ó-Ò -Ø JáØ T[[]TÑ !Ñ!Ø ØDLDØ d7Nrj c óÎ |j « }t |« dk( s|dk rt | |||||« S t d |D « « }t |« |z |kD r8t |« t |« kD r!| |j « dz z } ||d z }|}nt |« dz }||d z }|dd D ] }| |j « dz z } ||z } |t |d « z
|
} || dz z }| |fS ) zS
|
Extends line with nicely formatted (possibly multi-line) string ``word``.
|
r r: c 3 ó2 K | ] }t |« y wr ©r~ )r. r s r0 r1 z%_extendLine_pretty.<locals>.<genexpr>7 s è ø Ò6¨#d)Ñ6ùó r r r4 Néÿÿÿÿ)Ú
|
splitlinesr~ r Úmaxr )
|
r r r r rñ r5 ÚwordsÚmax_word_lengthÚindentÚ suffix_lengths
|
r0 Ú_extendLine_prettyr / s ð OOÓ EÜ
|
5zQ& C-Ü1d D¨*Ð6FÈÓOÐOäÑ6°Ô6Ó6OÜ D OÑ# jÒ0Ü IÐ ,Ó-Ò -Ø T[[]TÑ !Ñ!Ø %¨¡(Ñ*Ø!äTS Ø aÑàac
|
ò Ø T[[]TÑ !Ñ!Ø}ð ð $¤c¨%°©)£nÑ4MØMCÑ Ñ Dà d7Nrj c óP fd d||¬« dS # dw xY w)zgformatArray is designed for two modes of operation:
|
|
1. Full output
|
|
2. Summarized output
|
|
c ó t | « }j |z
|
}|dk( r | « S |dz }dk r|}n|t d« z
|
}j | }xr dz |k }|r} }
|
nd} |}
|
d} |dk( rdk r |t j « « z
|
} n/|t t j « « t d« « z
|
} |} t | « D ]( } | |fz ||« }t | | || |« \ } } | z } * |r#t | | | |« \ } } dk r| dz } n| z } t |
|
dd « D ]) } | | fz ||« }t | | || |« \ } } | z } + dk r|} | d
|
z ||« }t | | || |« \ } } | | z } n£d} j « d |dz
|
z z }t | « D ] } | |fz ||« }| ||z |z z } |r dk r | |z d z z } n | |z |z z } t |
|
dd « D ] } | | fz ||« }| ||z |z z } | d
|
z ||« }| ||z z } d | t |« d z dz } | S )z¼
|
By using this local function, we don't need to recurse with all the
|
arguments. Since this function is not created recursively, the cost is
|
not significant
|
r r4 r: ú]r| rè r r* r )r r z,
|
ú[N)r~ r r r r Úranger r )rV Úhanging_indentÚ
|
curr_widthr} Ú axes_leftÚnext_hanging_indentÚ
|
next_widthÚa_lenÚ show_summaryÚ leading_itemsÚtrailing_itemsr Ú
|
elem_widthr Úir Úline_sepÚnestedr Ú
|
edge_itemsrð r5 Úrecurserrí rï s r0 r' z _formatArray.<locals>.recurserS s= ø ô 5zØFFTM à >Ù" 1 U¡8Ó,Ð ,ð -¨sÑ 2ÐØ S=Ø#Jà#¤c¨#£hÑ.Jà Ø%Ò@¨!¨j©.¸5Ñ*@ Ù Ø &MØ 'Nà MØ "Nð ð >à}Ø '¬#¨i×.>Ñ.>Ó.@Ó*AÑ A
|
à '¬#Ü ×(Ñ(Ó*Ó+¬S°«Xó+ñ
|
ð "DÜ=Ó)ò "Ù ¨¨¡ Ð.AÀ:ÓNÜ,ØtT :¨~¸vóG4à Ñ!ð "ñ Ü%Øt^¨Z¸ Èó4ð S=ØDLDàIÑ%Dä>¨1¨bÓ1ò "Ù ¨!¨¨¡ Ð/BÀJÓOÜ,ØtT :¨~¸vóG4à Ñ!ð "ð }à '
|
ÙE EMÐ+>À
|
ÓKDÜ(Ø4z¨>¸6óCGAtð IAð AØ ×'Ñ'Ó)¨D°IÀ±MÑ,BÑBHä=Ó)ò 8Ù!ØQDLÐ"5°zóð ^ fÑ,¨xÑ7Ñ7ð 8ñ ØS=ð ¨.Ñ8¸6ÑAÑAAà ¨.Ñ8¸8ÑCÑCAä>¨1¨bÓ1ò 8Ù! %¨A¨2¨%¡-Ð1DØ",ó.à^ fÑ,¨xÑ7Ñ7ð 8ñ
|
e emÐ-@À*ÓMFØ &Ñ(Ñ (Að !CÓ'Ð(Ð)Ñ )¨CÑ /Ørj r- )rV r r Nr- ) r rð r rñ rí r& rï r5 r' s `` ````@r0 rì rì J s2 þ ÷fò fðP ábØ'7Ø#-ô/ð ø4ús
|
! ¡%c ó2 | y| dk rt | d« | S )Nr r z must be >= 0)rH )r Únames r0 Ú_none_or_positive_argr* Æ s( ØyØØ1uÜD6 Ð/Ó0Ð0Ø Hrj c ó* e Zd ZdZddddZd Zd Zy)r¢ z' Formatter for subtypes of np.floating Nr c óN t |t « r|rdnd}|| _ | j dk r|j dk7 r|dk( rd}|| _ |dk( rd | _ n|| _ t | j
|
d« | _ || _ || _ d| _ d| _
|
| j |« y ) Nr3 r2 r: r- r4 r' rC F) rO rG Ú_legacyr r^ rC r* rö r\ Ú
|
exp_formatÚlarge_exponentÚ
|
fillFormat)rß r rC r^ rö r\ r5 s r0 Ú__init__zFloatingFormat.__init__Ï s ô dDÔ !Ù 3 CDà Ø <<3Ò àzzRÒ D¨C¢KØà"Ø Ò Ø !DNà &DNä.¨t¯~©~¸{ÓKà ,ÔØ Ø Ø #ÔØ Õ rj c óö |t |« }t ||dk7 « }t |« dk7 r¬t j |« }t j
|
|« } j dk rd}n6dt dt j |j « j « z }t d¬« 5 ||k\ s j s|dk s||z d kD rd
|
_ d d d « t |« dk( r,d _ d _ d _ d _ d
|
_ d _ nà j rúd \ j& dk( s j dk rd\ fd|D « }t) d |D « \ }} }
|
t) d |D « \ } } t d |
|
D « « dz
|
_ d _ t d | D « « _ j _ _ j dk rd _ nt d | D « « _ j dz j z _ nÚd \ j& dk( rd\ fd|D « }t) d |D « \ } } j dk rdt d | D « « z _ nt d | D « « _ t d | D « « _ d _ _ j& d v r j x _ _ d _ nd _ d _ j dkD rB j* d!k( r3t- t j. |« « s xj dz c_ |j0 |j0 k7 r j* d"k7 xs t- |t3 |« dk « } j dz }t5 j6 « }t j t |d# « |z
|
t |d$ « | z |z
|
« _ y y # 1 sw Y xY w)%Nr rB g ×Ag $@é Úignore)Úoverg-C ëâ6?g @@Tú.r )r6 Tr& r: )r` Fc 3 ól K | ]+ }t |j j d k( ¬« - yw)r3 )rC r' Útrimr\ N)r rC r\ ©r. r rß r8 r' s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr> s= øè ø ò *àô ' q°D·N±NØ&,°4¸d¿i¹iÈ3Ñ>N÷Pð Pñ *ùs 14c 3 ó> K | ] }|j d « yw)rd N)Ú partition©r. r s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr> s è ø Ò*JÀ¨1¯;©;°s×+;Ñ*Jùó c 3 ó> K | ] }|j d « yw©r6 N©Úsplitr< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr> s è ø Ò'H¸¨¯©°¯ Ñ'Hùr= c 3 ó2 K | ] }t |« y wr r
|
r< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr> s è ø Ò 9¨1¤ A§Ñ 9ùr r r` c 3 ó2 K | ] }t |« y wr r
|
r< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr> ó è ø Ò ;¨A¤ Q§Ñ ;ùr r6 c 3 ó2 K | ] }t |« y wr r
|
r< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr> ó è ø Ò#=¨q¤C¨§FÑ#=ùr r| c
|
3 ón K | ], }t |j d j dk( ¬« . yw)Tr3 )rC Ú
|
fractionalr' r8 r\ N)r rC r\ r9 s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr> sA øè ø ò *ð ô ' q°D·N±NØ26Ø.4¸4Ø,0¯I©I¸Ñ,<÷>ð >ñ *ùs 25c 3 ó> K | ] }|j d « ywr? r@ r< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr>% s è ø Ò'C¸¨¯©°¯ Ñ'Cùr= c 3 óP K | ] }t |j d « « yw)z-+N)r~ Úlstripr< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr>' s è ø Ò'NÀ¬¨A¯H©H°T«N×(;Ñ'Nùs $&c 3 ó2 K | ] }t |« y wr r
|
r< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr>) rF r c 3 ó2 K | ] }t |« y wr r
|
r< s r0 r1 z,FloatingFormat.fillFormat.<locals>.<genexpr>* rD r )r& r) r4 r2 rZ r[ ) r! r r~ rS r Úminr- ÚfinforÈ rC r rö r. Úpad_leftÚ pad_rightr8 Úexp_sizer' Ú
|
min_digitsr^ Úzipr\ r Úsignbitrë r" r rl )rß r Ú finite_valsÚ abs_non_zeroÚmax_valÚmin_valÚexp_cutoff_maxÚstrsÚ frac_strsÚ_Úexp_strsÚint_partÚ frac_partÚneginfÚoffsetÚcurrent_optionsr8 r' s ` @@r0 r0 zFloatingFormat.fillFormaté s ú à8 D>Ñ* ô ¨K¸1Ñ,<Ñ =Ó> Ü |Ó Ò !Üff\Ó*GÜff\Ó*GØ||sÒ"Ø!%ð "%¤c¨!¬R¯X©X°d·j±jÓ-A×-KÑ-KÓ&LÑ!LÜxÔ(ñ +ØnÒ,°T×5HÒ5HØ 6Ò)¨W°wÑ->ÀÒ-FØ&*DO÷ +ô {Ó qÒ Ø DMØ DNØDIØ DMØ DKØ "DOØ __Ø$LD&Ø~~ Ò(¨D¯L©L¸CÒ,?Ø ) fõ*à (ô*Dô &)Ñ*JÀTÔ*JÐ%KÑ "Iq(Ü"%Ñ'H¸iÔ'HÐ"IÑ HiÜ Ñ 9°Ô 9Ó 9¸AÑ =DMàDIÜ Ñ ;°Ô ;Ó ;DNØ "nnDOØ DKð ||sÒ"Ø ! ô !$Ñ#=°HÔ#=Ó = à !]]¨QÑ .°· ± Ñ ?DNà$LD&Ø~~ Ò(Ø ) fõ*ð )ô *Dô
|
#&Ñ'C¸dÔ'CÐ"DÑ HiØ||sÒ"Ø !¤CÑ'NÀXÔ'NÓ$NÑ N ä #Ñ#=°HÔ#=Ó = Ü Ñ ;°Ô ;Ó ;DNØ DMØ DKà~~Ð!;Ñ;Ø37·>±>ÐA ¤ Ø à Ø"#à <<#Ò àyyCÒ ¬¬B¯J©J°{Ó,CÔ(DØ Ñ" ð 99 ×(Ñ(Ò (ØYY #Ñ%ÒC¬¨T´%¸³+Ñ->ÀÑ-BÓ)CFØ^^ aÑ'FÜ ,× 0Ñ 0Ó 2OÜ Ø s ?°8Ñ#<Ó =ÀÑ FÜO HÑ-Ó.°Ñ7¸&Ñ@ó DMð )÷I +ñ +ús Â/&O.Ï.O8c ó$ t j |« s«t d¬« 5 t j « }t j
|
|« r | j dk( rdnd}||d z }n"|dk rdn| j dk( rdnd}||d z }d | j | j z d
|
z t |« z
|
z |z cd d d « S | j r\t || j | j | j | j | j dk( | j | j ¬ « S t# || j | j | j d | j | j dk( | j | j ¬ « S # 1 sw Y ÎxY w)Nr4 )Úinvalidr3 rè rZ r r2 r[ r4 r )rC rS r' r8 r\ rP Ú
|
exp_digitsT)rC rS r' rH r8 r\ rP rQ )rS r! r r rl rT r\ rP rQ r~ r. r rC rS r' r8 rR r )rß r rc r\ Úrets r0 Ú__call__zFloatingFormat.__call__D s\ Ü{{1~Ü (Ô+ñ
|
Ü"0×"4Ñ"4Ó"6Ü88A;Ø"&§)¡)¨sÒ"23¸DØ °Ñ!:Ñ:Cà"# a¢%3°D·I±IÀÒ4D©SÈ"DØ °Ñ!:Ñ:CØØMM D§N¡NÑ2°QÑ6¼¸S»ÑAñàñ÷
|
ñ
|
ð ??Ü% aØ04·±Ø15· ± Ø-1¯[©[Ø+/¯9©9Ø+/¯9©9¸Ñ+;Ø/3¯}©}Ø15· ± ô@ð @ô & aØ04·±Ø15· ± Ø-1¯[©[Ø15Ø+/¯9©9Ø+/¯9©9¸Ñ+;Ø/3¯}©}Ø04·±ô@ð @÷-
|
ð
|
ús ¢BFÆF©F)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r1 r0 rh r- rj r0 r¢ r¢ Í s Ù1ð Ø ô ò4Yóv @rj r¢ c
|
ó¼ t |d« }t |d« }t |d« }t |d« }|dkD r|dkD r||kD r t d« t | |||||||¬« S )aÿ
|
|
Format a floating-point scalar as a decimal string in scientific notation.
|
|
Provides control over rounding, trimming and padding. Uses and assumes
|
IEEE unbiased rounding. Uses the "Dragon4" algorithm.
|
|
Parameters
|
----------
|
x : python float or numpy floating scalar
|
Value to format.
|
precision : non-negative integer or None, optional
|
Maximum number of digits to print. May be None if `unique` is
|
`True`, but must be an integer if unique is `False`.
|
unique : boolean, optional
|
If `True`, use a digit-generation strategy which gives the shortest
|
representation which uniquely identifies the floating-point number from
|
other values of the same type, by judicious rounding. If `precision`
|
is given fewer digits than necessary can be printed. If `min_digits`
|
is given more can be printed, in which cases the last digit is rounded
|
with unbiased rounding.
|
If `False`, digits are generated as if printing an infinite-precision
|
value and stopping after `precision` digits, rounding the remaining
|
value with unbiased rounding
|
trim : one of 'k', '.', '0', '-', optional
|
Controls post-processing trimming of trailing digits, as follows:
|
|
* 'k' : keep trailing zeros, keep decimal point (no trimming)
|
* '.' : trim all trailing zeros, leave decimal point
|
* '0' : trim all but the zero before the decimal point. Insert the
|
zero if it is missing.
|
* '-' : trim trailing zeros and any trailing decimal point
|
sign : boolean, optional
|
Whether to show the sign for positive values.
|
pad_left : non-negative integer, optional
|
Pad the left side of the string with whitespace until at least that
|
many characters are to the left of the decimal point.
|
exp_digits : non-negative integer, optional
|
Pad the exponent with zeros until it contains at least this
|
many digits. If omitted, the exponent will be at least 2 digits.
|
min_digits : non-negative integer or None, optional
|
Minimum number of digits to print. This only has an effect for
|
`unique=True`. In that case more digits than necessary to uniquely
|
identify the value may be printed and rounded unbiased.
|
|
.. versionadded:: 1.21.0
|
|
Returns
|
-------
|
rep : string
|
The string representation of the floating point value
|
|
See Also
|
--------
|
format_float_positional
|
|
Examples
|
--------
|
>>> import numpy as np
|
>>> np.format_float_scientific(np.float32(np.pi))
|
'3.1415927e+00'
|
>>> s = np.float32(1.23e24)
|
>>> np.format_float_scientific(s, unique=False, precision=15)
|
'1.230000071797338e+24'
|
>>> np.format_float_scientific(s, exp_digits=4)
|
'1.23e+0024'
|
rC rP rf rS r ú2min_digits must be less than or equal to precision)rC r' r8 r\ rP rf rS )r* rH r )r rC r' r8 r\ rP rf rS s r0 r r g sv ôL & i°Ó=IÜ$ X¨zÓ:HÜ& z°<Ó@JÜ& z°<Ó@JØA~) a-¨J¸Ò,BÜÐMÓNÐNÜ a¨9¸VØ#'¨d¸XØ)3À
|
ô Lð Lrj c óâ t |d« }t |d« }t |d« }t |d« }|s|dk( r t d« |dkD r|dkD r||kD r t d« t | ||||||||¬« S ) a¥
|
Format a floating-point scalar as a decimal string in positional notation.
|
|
Provides control over rounding, trimming and padding. Uses and assumes
|
IEEE unbiased rounding. Uses the "Dragon4" algorithm.
|
|
Parameters
|
----------
|
x : python float or numpy floating scalar
|
Value to format.
|
precision : non-negative integer or None, optional
|
Maximum number of digits to print. May be None if `unique` is
|
`True`, but must be an integer if unique is `False`.
|
unique : boolean, optional
|
If `True`, use a digit-generation strategy which gives the shortest
|
representation which uniquely identifies the floating-point number from
|
other values of the same type, by judicious rounding. If `precision`
|
is given fewer digits than necessary can be printed, or if `min_digits`
|
is given more can be printed, in which cases the last digit is rounded
|
with unbiased rounding.
|
If `False`, digits are generated as if printing an infinite-precision
|
value and stopping after `precision` digits, rounding the remaining
|
value with unbiased rounding
|
fractional : boolean, optional
|
If `True`, the cutoffs of `precision` and `min_digits` refer to the
|
total number of digits after the decimal point, including leading
|
zeros.
|
If `False`, `precision` and `min_digits` refer to the total number of
|
significant digits, before or after the decimal point, ignoring leading
|
zeros.
|
trim : one of 'k', '.', '0', '-', optional
|
Controls post-processing trimming of trailing digits, as follows:
|
|
* 'k' : keep trailing zeros, keep decimal point (no trimming)
|
* '.' : trim all trailing zeros, leave decimal point
|
* '0' : trim all but the zero before the decimal point. Insert the
|
zero if it is missing.
|
* '-' : trim trailing zeros and any trailing decimal point
|
sign : boolean, optional
|
Whether to show the sign for positive values.
|
pad_left : non-negative integer, optional
|
Pad the left side of the string with whitespace until at least that
|
many characters are to the left of the decimal point.
|
pad_right : non-negative integer, optional
|
Pad the right side of the string with whitespace until at least that
|
many characters are to the right of the decimal point.
|
min_digits : non-negative integer or None, optional
|
Minimum number of digits to print. Only has an effect if `unique=True`
|
in which case additional digits past those necessary to uniquely
|
identify the value may be printed, rounding the last additional digit.
|
|
.. versionadded:: 1.21.0
|
|
Returns
|
-------
|
rep : string
|
The string representation of the floating point value
|
|
See Also
|
--------
|
format_float_scientific
|
|
Examples
|
--------
|
>>> import numpy as np
|
>>> np.format_float_positional(np.float32(np.pi))
|
'3.1415927'
|
>>> np.format_float_positional(np.float16(np.pi))
|
'3.14'
|
>>> np.format_float_positional(np.float16(0.3))
|
'0.3'
|
>>> np.format_float_positional(np.float16(0.3), unique=False, precision=10)
|
'0.3000488281'
|
rC rP rQ rS r z4precision must be greater than 0 if fractional=Falsero )rC r' rH r8 r\ rP rQ rS )r* rH r ) r rC r' rH r8 r\ rP rQ rS s r0 r r ¸ s ô\ & i°Ó=IÜ$ X¨zÓ:HÜ% i°Ó=IÜ& z°<Ó@JÙ ) q.Üð ,ó -ð -àA~) a-¨J¸Ò,BÜÐMÓNÐNÜ a¨9¸VØ)3¸$Ø#'°(Ø(1¸jô Jð Jrj c ó e Zd ZddZd Zy)r c ó. |j dkD rwt j |« }t j |« }t t |« « }|dk( r|dk rd}|dk\ r |dv r|dz }t |t t |« « « }nd}d| | d| _ y )Nr r4 r2 z+ r z{:zd})rë rS r rN r~ r r )rß r r\ Údata_maxÚdata_minÚdata_max_str_lenÚ max_str_lens r0 r1 zIntegerFormat.__init__ s Ø 99q=Üvvd|HÜvvd|HÜ "¤3 x£=Ó 1Ð Øs{x¨!|ØØ1} ¨¡ Ø AÑ%Ð Ü Ð .Ü !¤# h£-Ó 0ó2Kð KØD6 + ¨cÐ2 rj c ó8 | j j |« S r )r ©rß r s r0 rh zIntegerFormat.__call__$ s Ø{{×!Ñ! !Ó$Ð$rj N)r2 ©rj rk rl r1 rh r- rj r0 r r s ó 3ó %rj r c ó e Zd Zd Zd Zy)r c ó@ |j dk7 rd| _ y d| _ y )Nr- z TrueÚTrue)r Útruestr)rß r ry s r0 r1 zBoolFormat.__init__( s ð #'§*¡*°Ò"2w ¸ rj c ó" |r | j S dS )NÚFalse)r} rx s r0 rh zBoolFormat.__call__- s Ù t||Ð- gÐ-rj Nry r- rj r0 r r ' s ò?ó
|
.rj r c ó& e Zd ZdZ ddddZd Zy)r§ z. Formatter for subtypes of np.complexfloating Nr c óÊ t |t « r|rdnd}|x}}|dk rd}d}t |j |||||¬« | _ t |j
|
|||d|¬« | _ y )Nr3 r2 r: r) r( )r\ r5 )rO rG r¢ ÚrealÚ real_formatÚimagÚ imag_format) rß r rC r^ rö r\ r5 Úfloatmode_realÚfloatmode_imags r0 r1 z ComplexFloatingFormat.__init__3 sr ô dDÔ !Ù 3 CDà*3Ð3 Ø S=Ø ,NØ &Nä)Ø FFI~¨~Øfô
|
Ôô *Ø FFI~¨~ØVô
|
Õrj c óÆ | j |j « }| j |j « }t |j « « }|d | dz ||d z }||z S )NÚj)r r r
r r~ r )rß r Úrr# Úsps r0 rh z ComplexFloatingFormat.__call__G s^ Ø × Ñ QVVÓ $Ø × Ñ QVVÓ $ô _Ø crFSL1RS6Ñ !à1u rj ri )rj rk rl rm r1 rh r- rj r0 r§ r§ 1 s Ù8àð
|
Ø'+ô
|
ó(rj r§ c ó e Zd Zd Zd Zd Zy)Ú_TimelikeFormatc
|
ó |t |« }t |« dkD rct t | j t j |« « « t | j t j
|
|« « « « }nd}t |« |j k r t |d« }d| d| _ dj |« | _ y )Nr é ú%r z'NaT')
|
r# r~ r Ú_format_non_natrS rN rë Ú_formatÚrjustÚ_nat)rß r Únon_natrv s r0 r1 z_TimelikeFormat.__init__S s¡ Ød |Ñ$Ü w<!Ò ä c $×"6Ñ"6´r·v±v¸g³Ó"GÓ HÜ ! $×"6Ñ"6´r·v±v¸g³Ó"GÓ HóJKð KÜ w<$))Ò #ä k¨1Ó-KØ;- qÐ) ØMM +Ó. rj c ó t r )ÚNotImplementedErrorrx s r0 r z _TimelikeFormat._format_non_nata s ä!Ð!rj c ól t |« r | j S | j | j |« z S r )r# r r r rx s r0 rh z_TimelikeFormat.__call__e s- Ü 8Ø99Ð à<< $×"6Ñ"6°qÓ"9Ñ9Ð 9rj N)rj rk rl r1 r rh r- rj r0 r r R s ò /ò "ó:rj r c ó4 e Zd Z d fd Z fdZd Z xZS )rª c óÐ |4|j j dk( rt |j « d }nd}|d}|| _ || _ || _ || _ t | ! |« y )NÚMr r Únaive) rÈ Úkindr ÚtimezoneÚunitÚcastingr5 Úsuperr1 )rß r r r r r5 Ú __class__s r0 r1 zDatetimeFormat.__init__m sh ø ð <Øww||sÒ"Ü$ Q§W¡WÓ-¨aÑ0àà Ð Ø HØ Ø Ø Ø ô ÑÕrj c ób | j dk r| j |« S t | |« S )Nr: )r5 r r¡ rh )rß r r¢ s r0 rh zDatetimeFormat.__call__ s0 ø Ø ;;#Ò Ø×'Ñ'¨Ó*Ð *ÜwÑ Ó"Ð"rj c ób dt || j | j | j ¬« z S )Nz'%s')r r r )r r r r rx s r0 r z DatetimeFormat._format_non_nat
s. ØÔ*¨1Ø)-¯©Ø-1¯]©]Ø,0¯L©Lô:ñ :ð :rj )NNÚ same_kindF)rj rk rl r1 rh r Ú __classcell__)r¢ s @r0 rª rª l s ø Ø<GØ õ ô&#ö
|
:rj rª c ó e Zd Zd Zy)r¬ c ó6 t |j d« « S )NÚi8)r Úastyperx s r0 r z TimedeltaFormat._format_non_nat s Ü188D>Ó"Ð"rj N)rj rk rl r r- rj r0 r¬ r¬ s ó#rj r¬ c ó e Zd Zd Zd Zd Zy)ÚSubArrayFormatc ó: || _ |d | _ |d | _ y )NrW rX )rð rW r& )rß rð rb s r0 r1 zSubArrayFormat.__init__ s" Ø .Ô Ø Ñ-Ø! +Ñ.rj c óh |j | j kD rdnd| _ | j |« S )Nrê rè )rë rW rï Ú format_array)rß r s r0 rh zSubArrayFormat.__call__ s, Ø'(§v¡v°·±Ò'>eÀBÔØ× Ñ Ó#Ð#rj c ó t j |« dk( r| j |« S | j r|j d d| j
|
z kD ri|d | j
|
D cg c] }| j |« c}| j gz || j
|
d D cg c] }| j |« c}z }n |D cg c] }| j |« }}ddj |« z dz S c c}w c c}w c c}w )Nr r| r r* r )rS r rð rï r r& r¯ rI )rß r Úa_Ú formatteds r0 r¯ zSubArrayFormat.format_array só Ü 771:?Ø×'Ñ'¨Ó*Ð *à × Ò 1§7¡7¨1¡:°°D·O±OÑ0CÒ#Cà12Ð3C°D·O±OÐ1DÖE¨2×"Ñ" 2Õ&ÒEØ×&Ñ&Ð'ñ(à34°d·o±oÐ5EÐ5FÐ3GÖH¨R4×$Ñ$ RÕ(ÒHñIñ ð :;Ö;°2×*Ñ*¨2Õ.Ð;IÐ;àTYYyÓ)Ñ)¨CÑ/Ð/ùò FùâHùò <s Á&C3 C8ÃC=N)rj rk rl r1 rh r¯ r- rj r0 r¬ r¬ s ò/ò
|
$ó 0rj r¬ c ó, e Zd ZdZd Zed « Zd Zy)rÔ zô
|
Formatter for structured np.void objects.
|
|
This does not work on structured alias types like
|
np.dtype(('i4', 'i2,i2')), as alias scalars lose their field information,
|
and the implementation relies upon np.void.__getitem__.
|
c ó || _ y r )Úformat_functions)rß rµ s r0 r1 z StructuredVoidFormat.__init__³ s
|
Ø 0Õ rj c óÜ g }|j j D ]J }t || fi |¤}|j | j dk7 r t |fi |¤}|j |« L | |« S )zª
|
This is a second way to initialize StructuredVoidFormat,
|
using the raw data as input. Added to avoid changing
|
the signature of __init__.
|
r- )rÈ rÓ rØ r r¬ Úappend)Úclsr rb rµ Ú
|
field_namerð s r0 rÕ z StructuredVoidFormat.from_data¶ sy ð ÐØ **×*Ñ*ò 5JÜ 2°4¸
|
Ñ3CÑ OÀwÑ OOØzz*Ñ%×+Ñ+¨rÒ1Ü"0° Ñ"LÀGÑ"LØ × #Ñ # OÕ 4ð 5ñ
|
Ð#Ó$Ð$rj c óÂ t || j « D cg c] \ }} ||« }}}t |« dk( r d|d dS ddj |« dS c c}}w )Nr ú(r z,)r* ú))rT rµ r~ rI )rß r Úfieldrð Ú
|
str_fieldss r0 rh z StructuredVoidFormat.__call__Å sv ô +.¨a°×1FÑ1FÓ*G÷
|
á&ñ EÕ "ð
|
|
ñ
|
ô z?aÒ Øz !}o RÐ(Ð (àtyy Ó,Ð-¨QÐ/Ð /ùó
|
s AN)rj rk rl rm r1 Ú classmethodrÕ rh r- rj r0 rÔ rÔ « s% ñò1ð ñ %ó ð %ó 0rj rÔ c ó2 t j « j « }|d dk r% t j t | « fi |¤| « S |j d« i |d< |d j dt « t j t | « fi |¤| « }|s|S t | « }|j j dd« dz |j z }t j t j | j f« }| d| d |d
|
S ) z½
|
Implements the repr for structured-void scalars. It is called from the
|
scalartypes.c.src code, and is placed here because it uses the elementwise
|
formatters defined above.
|
r5 r> r] r¿ rf rS r6 r» z, dtype=r¼ )r rl rr rÔ rÕ r Ú
|
setdefaultr r
rk Úreplacerj rS rÈ r¸ )r Úis_reprrb Úval_reprr¸ Úcls_fqnÚ
|
void_dtypes r0 Ú_void_scalar_to_stringrÇ Ð s ô × Ñ Ó"×'Ñ'Ó)GàxÑCÒ ØBÔ#×-Ñ-¬e°A«hÑB¸'ÑBÀ1ÓEÐEà{{;Ó Ð'Ø ! Ñ Ø KÑ×#Ñ# L´#Ô6ØBÔ#×-Ñ-¬e°A«hÑB¸'ÑBÀ1ÓEHÙ ØÜ
|
q'CØnn×$Ñ$ W¨dÓ3°cÑ9¸C¿L¹LÑHGÜ277 A§G¡GÐ,Ó-JØYaz ¨*¨ °qÐ 9Ð9rj c óô t j | « } t j « d dk r | j t j
|
k( ry| j y| j sy| j t v S )a@
|
Determine if the given dtype is implied by the representation
|
of its values.
|
|
Parameters
|
----------
|
dtype : dtype
|
Data type
|
|
Returns
|
-------
|
implied : bool
|
True if the dtype is implied by the representation of its values.
|
|
Examples
|
--------
|
>>> import numpy as np
|
>>> np._core.arrayprint.dtype_is_implied(int)
|
True
|
>>> np.array([1, 2, 3], int)
|
array([1, 2, 3])
|
>>> np._core.arrayprint.dtype_is_implied(np.int8)
|
False
|
>>> np.array([1, 2, 3], np.int8)
|
array([1, 2, 3], dtype=int8)
|
r5 r: F) rS rÈ r rl r
rG rÓ ÚisnativeÚ _typelessdata)rÈ s r0 Údtype_is_impliedrË ê sc ô6 HHUOEÜ×ÑÓHÑ%¨Ò,°·±¼r¿w¹wÒ1FØð {{Ð Øð >>Øà :: Ð &Ð&rj c óª t | « j t j j k7 r t | « S | j
|
t | « S t | j t « rdt | « dS | j }| j sdt | « dS |r.|d j « r|j « s t |« }|S )zñ
|
Convert a dtype to a short form which evaluates to the same dtype.
|
|
The intent is roughly that the following holds
|
|
>>> from numpy import *
|
>>> dt = np.int64([1, 2]).dtype
|
>>> assert eval(dtype_short_repr(dt)) == dt
|
ú'r ) r
Ú__repr__rS rÈ r rÓ r rÉ r r) rÉ ÚisalphaÚisalnum)rÈ Útypenames r0 Údtype_short_reprrÒ s¯ ô E{×Ñrxx× 0Ñ 0Ò0äE{ÐØ {{Ð ä5zÐÜ EJJ¤Ô )à3u:,aÐ Ð àzzHØ >>ð 3u:,aÐ Ð á !×,Ñ,Ô.°8×3CÑ3CÔ3EÜ>Ø Orj c ó
|
t j « }|d }| || « S ||d }t | « t urt | « j }nd}|dz }|d dk r?| j
|
dk( r0| j j st | j « « } n || |||d|d ¬
|
« } g }
|
| j d k( r| j
|
d k7 s|d d kD r0| j |d kD r |
|
j d| j
|
« t | j « r| j d k( r'|
|
j dt | j « « |
|
s|| z d z S || z dz } dj |
|
« d z } t | « | j! d« dz z
|
} d}|d dk r6t# | j j t$ « r7ddt |« z z }n%| t | « z dz |kD rddt |« z z }| |z | z S )zEInternal version of array_repr() that allows overriding array2string.r_ rY r r» r5 r: r- r* r¼ )rø r )r éÒ rW zshape=zdtype=ú,r r r4 )r rl r
r rj r rÈ rÓ r r rë r· rË rÒ rI r~ ÚrfindrÉ r )Úarrrõ rC rö r rc r_ Ú
|
class_namerî rò ÚextrasÚarr_strÚ extra_strÚ last_line_lenÚspacers r0 Ú_array_repr_implementationrÞ 4 sù ô %×(Ñ(Ó*OØ# OÑ4MØÐ Ù SÓ!Ð!àÐ Ø(¨Ñ5ä CyÑ Ü#Y×'Ñ'
|
à
|
à #Ñ FØÑ! SÒ(Ø IIO C§I¡I§O¢OÜ388:Ó á3 ° ¸>Ø °ô5ð
|
FØ Q 399¨Ò,Ø Ñ)¨CÒ/Ø?¨;Ñ7Ò7Ø syykÐ*Ô+Ü CIIÔ &¨#¯(©(°aª-Ø Ô /°· ± Ó :Ð ;Ð<Ô=á Ø|cÑ!Ð!àslSÑ GØ &Ó! CÑ'Iô L G§M¡M°$Ó$7¸!Ñ$;Ñ<MØ FØxÑ CÒ'Ü ciinn¤hÔ /ØC¤# f£+Ñ -Ñ-FØ Y Ñ '¨!Ñ +¨nÒ <Øc &kÑ)Ñ)à VÑ iÑ 'Ð'rj c ó | fS r r- ©r× rõ rC rö s r0 Ú_array_repr_dispatcherrá j s à 6Mrj c ó t | |||« S )a(
|
Return the string representation of an array.
|
|
Parameters
|
----------
|
arr : ndarray
|
Input array.
|
max_line_width : int, optional
|
Inserts newlines if text is longer than `max_line_width`.
|
Defaults to ``numpy.get_printoptions()['linewidth']``.
|
precision : int, optional
|
Floating point precision.
|
Defaults to ``numpy.get_printoptions()['precision']``.
|
suppress_small : bool, optional
|
Represent numbers "very close" to zero as zero; default is False.
|
Very close is defined by precision: if the precision is 8, e.g.,
|
numbers smaller (in absolute value) than 5e-9 are represented as
|
zero.
|
Defaults to ``numpy.get_printoptions()['suppress']``.
|
|
Returns
|
-------
|
string : str
|
The string representation of an array.
|
|
See Also
|
--------
|
array_str, array2string, set_printoptions
|
|
Examples
|
--------
|
>>> import numpy as np
|
>>> np.array_repr(np.array([1,2]))
|
'array([1, 2])'
|
>>> np.array_repr(np.ma.array([0.]))
|
'MaskedArray([0.])'
|
>>> np.array_repr(np.array([], np.int32))
|
'array([], dtype=int32)'
|
|
>>> x = np.array([1e-6, 4e-7, 2, 3])
|
>>> np.array_repr(x, precision=6, suppress_small=True)
|
'array([0.000001, 0. , 2. , 3. ])'
|
|
)rÞ rà s r0 r r o s ô\ &Ø ^Y¨ó 8ð 8rj c óN t | t « r t | « S t | « S r )rO Úbytesr r )ra s r0 Ú_guarded_repr_or_strrå ¡ s ä!UÔÜAwÜ q6Mrj c ó< t j « d dk r>| j dk( r/| j j st | j « « S | j dk( r)t t j j | d« « S || |||dd« S )zDInternal version of array_str() that allows overriding array2string.r5 r: r- r4 rè ) r rl r rÈ rÓ r r rå rS r Ú __getitem__)r rõ rC rö r s r0 Ú_array_str_implementationrè ¨ s ô ×ÑÓ XÑ&¨#Ò-Ø GGrM !§'¡'§-¢-Ü1668}Ð ð
|
ww"}ô $¤B§J¡J×$:Ñ$:¸1¸bÓ$AÓBÐBá >¨9°nÀcÈ2Ó NÐNrj c ó | fS r r- ©r rõ rC rö s r0 Ú_array_str_dispatcherrë ¼ s à 4Krj c ó t | |||« S )a|
|
Return a string representation of the data in an array.
|
|
The data in the array is returned as a single string. This function is
|
similar to `array_repr`, the difference being that `array_repr` also
|
returns information on the kind of array and its data type.
|
|
Parameters
|
----------
|
a : ndarray
|
Input array.
|
max_line_width : int, optional
|
Inserts newlines if text is longer than `max_line_width`.
|
Defaults to ``numpy.get_printoptions()['linewidth']``.
|
precision : int, optional
|
Floating point precision.
|
Defaults to ``numpy.get_printoptions()['precision']``.
|
suppress_small : bool, optional
|
Represent numbers "very close" to zero as zero; default is False.
|
Very close is defined by precision: if the precision is 8, e.g.,
|
numbers smaller (in absolute value) than 5e-9 are represented as
|
zero.
|
Defaults to ``numpy.get_printoptions()['suppress']``.
|
|
See Also
|
--------
|
array2string, array_repr, set_printoptions
|
|
Examples
|
--------
|
>>> import numpy as np
|
>>> np.array_str(np.arange(3))
|
'[0 1 2]'
|
|
)rè rê s r0 r r Á s ôJ %Ø >9 nó 6ð 6rj Ú __wrapped__)r ) NNNNNNNNNNNN)
|
NNNNNNNNNN)r- )rê )r4 rè )NTr` FNNN)NTTr` FNNN)T)NNN)^rm Ú__all__Ú __docformat__rä rP rJ Ú_threadr Ú ImportErrorÚ _dummy_threadÚ
|
contextlibrU rL rf rS rè r rÊ Ú fromnumericr Ú
|
multiarrayr r r r r r Únumericr r r r r r r rþ r r r r Úumathr r! r" r# re r ri r ru Úcontextmanagerr 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Ç rG rÊ rË rÒ rÞ rá r rå rè rë r ÚgetattrÚ_array2string_implÚpartialÚ_default_array_strÚ_default_array_reprr- rj r0 ú<module>rþ s ðñò
|
Að # ó Û Û
|
ð(Ý!ó Û Û ã å !Ý ÷÷ ÷ 4Ñ 3ß =Ó =ß :Ý (ß 3Ó 3ð BFØJNØIMØ%)ó>ñB GÓØ?CØ;?ØGKðyBð $°4óyBó ðyBðx AEØ<@ØHLð+ð !%°Dô+ñ( GÓñ.ó ð.òb*ñ
|
GÓØ ×Ññ $ó ó ð $óDHò(òò
|
ò
|
0òd&(óR ñ< Óòó ðð: +/Ø48Ø.2Ø:>ð ð
|
ô ñ Ð1¸'ÔBØ#'°4Ø $°¸BØ{{¨d¸dØ d°dÀ2ðr8ð ó r8ó Cðr8òj ò ò6zòx ÷W@ñ W@ñt GÓØADØBFØ'+òMLó ðMLñ` GÓØ6:Ø<AØFJòYJó ðYJ÷v%ñ %÷&.ñ .÷ ñ ÷B:ñ :ô4 :_ô :ô@#oô #÷
|
0ñ 0÷4"0ñ "0óJ:ð. w
|
¨C¯H©HÐ5 ò''òT ðB !¨DÀØ!ó3(ðn BFóñ
|
Ð/¸Ô@ò.8ó Að.8ñb Óñó ðð ¨$¸tØ!óOð* @Dóñ
|
Ð.°wÔ?ò%6ó @ð%6ñR \¨=¸,ÓGÐ Ø&Y×&Ñ&Ð'@Ø4FôHÐ à'i×'Ñ'Ð(BØ5GôIÑ øð_6 ò (ß'Ð'ð(ús I É IÉI
|
