o g, @sdZgdZdZddlZddlZddlZzddlmZWney+ddl mZYnwddl Z ddl m ZddlmZmZmZmZdd l mZdd lmZmZmZmZmZmZdd lmZdd lmZmZm Z dd l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(m)Z)ddl*m+Z+ddl,Z,ddl-Z-ddl.Z.    doddZ/e)d   dpdddddZ0   dpdddddZ1e)dddZ2ddZ3e)de.j4ddZ*dqdd Z5d!d"Z6d#d$Z7d%d&Z8d'd(Z9d)d*Z:drd,d-Z;e;dsd0d1Z<    dodd2d3d4Z=e(e=dd5dddd.d/e j>dddddd/f dd2d6d7Z?d8d9Z@d:d;ZAdd?ZCGd@dAdAZDe)d C  dtdEdFZEe)d B D dudGdHZFGdIdJdJZGGdKdLdLZHGdMdNdNZIGdOdPdPZJGdQdRdReJZKGdSdTdTeJZLGdUdVdVZMGdWdXdXZNdvdYdZZOe#e$e%ejPgZQd[d\ZRd]d^ZSddde?fd_d`ZT dwdadbZUe(eUdd5dwdcddZVe;dedfZWddde?fdgdhZX dwdidjZYe(eYdd5dwdkdlZZe[e?dme?Z\ej]eXe\dnZ^ej]eTe\dnZ_dS)xzXArray printing function $Id: arrayprint.py,v 1.9 2005/09/13 13:58:44 teoliphant Exp $ ) array2string array_str array_reprset_printoptionsget_printoptions printoptionsformat_float_positionalformat_float_scientificrestructuredtextN) get_ident) numerictypes)absoluteisinfisfiniteisnat) multiarray)arraydragon4_positionaldragon4_scientificdatetime_as_string datetime_datandarray)any) concatenateasarrayerrstate)longlongintcint_float64 complex128flexible)array_function_dispatch set_module)format_optionsc  CsddttD} |durt|| d<gd} | | dgvr/tdddd | D|d vr7td | d urAtj| d <nF| d krWtj d| dt ddtj| d <n0| dkr`d| d <n'| dkrid| d <n| dkrrd| d <n| dkr{d| d <n | durntj ddd|durt |t j stdt|rtd|durz t|| d<W| Sty}ztd|d}~ww| S)zm Make a dictionary out of the non-None arguments, plus conversion of *legacy* and sanity checks. cSsi|] \}}|dur||qSN).0kvr'r'P/var/www/html/api-tag/env/lib/python3.10/site-packages/numpy/_core/arrayprint.py ;sz&_make_options_dict..Nsuppress)fixeduniquemaxprec maxprec_equalz floatmode option must be one of , css|]}d|VqdS)z"{}"Nformat)r(mr'r'r+ Cz%_make_options_dict..)N-+ z+sign option must be one of ' ', '+', or '-'FlegacyzPassing `legacy=z` is deprecated. stacklevel1.13q1.21y1.25}z2.1zUlegacy printing option can currently only be '1.13', '1.21', '1.25', '2.1, or `False`zthreshold must be numericzIthreshold must be non-NAN, try sys.maxsize for untruncated representation precisionzprecision must be an integer)listlocalsitemsbool ValueErrorjoinsysmaxsizewarningswarn FutureWarning isinstancenumbersNumber TypeErrornpisnanoperatorindex)rF threshold edgeitems linewidthr-nanstrinfstrsign formatter floatmoder; override_reproptionsmodeser'r'r+_make_options_dict2s\            rfnumpyr;rbc  Cs$t|||||||||| | | d dS)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 `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,)) rhN)_set_printoptions) rFrZr[r\r-r]r^r`r_rar;rbr'r'r+rqs  5  rc  Cs`t|||||||||| | } || d<| | d<t| B} | | | ddkr+d| d<t| S)Nr`rbr;r@r8r_)rfr%getupdateset)rFrZr[r\r-r]r^r`r_rar;rbnew_opt updated_optr'r'r+ri*s      ricCs2t}ddddddtjdi|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@r?rBrArDrCFr;)r%rjcopyrMrN)optsr'r'r+r>s *rcCs tdS)z'Return the legacy print mode as an int.r;)r%rjr'r'r'r+_get_legacy_print_modeos rqc os6t|i|}z tVWt|dSt|w)aContext 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)rirr%reset)argskwargstokenr'r'r+rts  rr'c Cst|}||jkr ||S|j|d|kr5tt|||tjd|t|||tj| df|dSt|||tjddS)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)lenndimshaper_leading_trailingrV index_exp)ar[rYrwr'r'r+r{s r{cCs t|tur d}nd}||S)z@ Object arrays containing lists should be printed unambiguously z list({!r})z{!r})typerGr4)ofmtr'r'r+_object_formats  rcC&t|tjtjfrt|St|Sr&)rRrVstr_bytes_repritemxr'r'r+ repr_format rcCrr&)rRrVrrstrrrr'r'r+ str_formatrrc sfddfddfddfddfddfddfddfd dd dd dd dd }dd} dur‡fddD} d| vrp|D] } | d|| <qed| vrdD] } | d|| <qvd| vrdD] } | d|| <qd| vrdD] } | d|| <qd| vr| d|d<|D]} | | vr| | || <q|S)NctSr&) BoolFormatr'datar'r+z!_get_formatdict..cs tSr&) IntegerFormatr')rr_r'r+rs ctdSNr;FloatingFormatr'rrar;rFr_r-r'r+r crrrr'rr'r+rrcrrComplexFloatingFormatr'rr'r+rrcrrrr'rr'r+rrcs tdSr)DatetimeFormatr')rr;r'r+rs crr&)TimedeltaFormatr'rr'r+rrcStSr&)rr'r'r'r+rcSrr&)rr'r'r'r+rrcSrr&)rr'r'r'r+rr) rJintfloat longfloat complexfloatlongcomplexfloatdatetime timedeltaobjectvoidnumpystrcs fddS)NcsSr&r'r'rr'r+rrz3_get_formatdict..indirect..r'rr'rr+indirect z!_get_formatdict..indirectcsg|] }|dur|qSr&r')r(r))r`r'r+ sz#_get_formatdict..allint_kind)r float_kind)rr complex_kind)rrstr_kindr)keys) rrFrar-r_r;r`rt formatdictrfkeyskeyr')rrar`r;rFr_r-r+_get_formatdictsD      rcKsL|j}|j}t|fi|}|dur|dSt|tjr"|dSt|tjr8t|tjr3|dS|dSt|tjrNt|tj rI|dS|dSt|tj rdt|tj r_|dS|d St|tj tj frr|dSt|tjr}|d St|tjr|d St|tjr|jdurtj|fi|S|d S|dS) z; find the right formatting function for the dtype_ NrrJrrrrrrrrr)dtyper~r issubclass_ntrJinteger timedelta64floating longdoublecomplexfloating clongdoublerr datetime64object_rnamesStructuredVoidFormat from_data)rrcdtype_dtypeobjrr'r'r+_get_format_functions<                        r...csfdd}|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 cs$ttfdd}|S)Nc sTt|tf}|vr S|z|g|Ri|W|S|wr&)idr adddiscard)selfrsrtr)f fillvalue repr_runningr'r+wrapper&s z>_recursive_guard..decorating_function..wrapper)rl functoolswraps)rrr)rrr+decorating_function#s z-_recursive_guard..decorating_functionr')rrr'rr+_recursive_guards rr:c Cst|}|jdkr |}|j|dkrd}t||d}nd}t|fi|}d}|dt|7}t|||d|||d||d}|S) Nr'rZrr[rr:r\r;)rrzsizer{rrx _formatArray) r}rc separatorprefixrsummary_insertformat_functionnext_line_prefixlstr'r'r+ _array2string7s   rrc C|fSr&r')r}max_line_widthrFsuppress_smallrrstyler`rZr[r_rasuffixr;r'r'r+_array2string_dispatcherTsr)modulec  Cst||| ||dd| || | }t}|||ddkr8|tjur&t}|jdkr7|j j dur7|| Sn |tjurEt j dtdd|ddkrU|dt| 8<|jd kr\d St||||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]' Nr;r@r'zT'style' argument is deprecated and no longer functional except in 1.13 'legacy' modervr=r\r z[])rfr%rjrorkrV_NoValuerrzrrrrOrPDeprecationWarningrxrr)r}rrFrrrrr`rZr[r_rarr; overridesrcr'r'r+r]s,        rcCsXt|t||k}|dkrt|t|krd}|r$||d7}|}||7}||fS)Nr@F )rxrstrip)slineword line_widthrr; needs_wrapr'r'r+ _extendLinesrc Cs|}t|dks|dkrt||||||Stdd|D}t|||krAt|t|krA||d7}||d}|}n t|d}||d7}|ddD]}||d7}||}qS|t|d } || d7}||fS) zS Extends line with nicely formatted (possibly multi-line) string ``word``. r r@cs|]}t|VqdSr&rx)r(rr'r'r+r6)z%_extendLine_pretty..rr r:N) splitlinesrxrmaxr) rrrrrr;wordsmax_word_lengthindent suffix_lengthr'r'r+_extendLine_pretty!s"     rcs4fddz d||dWdSdw)zgformatArray is designed for two modes of operation: 1. Full output 2. Summarized output cst|}j|}|dkr|S|d}dkr|}n|td}j|}o0d|k}|r8} } nd} |} d} |dkr׈dkrO|t} n |tttd} |} t| D]}||f||}t| | || |\} } | 7} qb|rt| | | |\} } dkr| d7} n| 7} t| dd D]}|| f||}t| | || |\} } | 7} qdkr|} |d ||}t| | || |\} } | | 7} ngd} d |d}t| D]}||f||}| |||7} q|rdkr | |d 7} n| ||7} t| dd D]}|| f||}| |||7} q|d ||}| ||7} d | t|dd} | 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 r:r@]rvrr r2r)rrz, [N)rxryrzrrrangerr)rYhanging_indent curr_widthrw axes_leftnext_hanging_indent next_widtha_len show_summary leading_itemstrailing_itemsr elem_widthrirline_sepnestedr} edge_itemsrr;recurserrrr'r+rEs                 z_formatArray..recurserr')rYrrNr')r}rrrrrrr;r'rr+r<s h rcCs&|durdS|dkrtd||S)Nrr z{} must be >= 0)rKr4)rnamer'r'r+_none_or_positive_args rc@s0eZdZdZd ddddZddZd d ZdS) rz' Formatter for subtypes of np.floating FNrcCst|tr |r dnd}||_|jdkr|jdkr|dkrd}||_|dkr)d|_n||_t|jd|_||_||_d|_ d|_ | |dS) Nr9r8r@r'r:r/rFF) rRrJ_legacyrzrarFrrr_ exp_formatlarge_exponent fillFormat)rrrFrarr_r;r'r'r+__init__s   zFloatingFormat.__init__cs |t|}t||dk}t|dkrGt|}t|}tdd|dks5js8|dks5||dkr8d_Wdn1sBwYt|dkr`d_ d_ d_ d _ d_ d_nۈjrd \jd ksqjd krud \fdd|D}tdd|D\}}} tdd|D\} } tdd| Dd_ d_ tdd| D_j__ jd krd_ n tdd| D_ j dj_ ngd \jd krd \fdd|D}tdd|D\} } jd kr dtdd| D_ n tdd| D_ tdd| D_ d _ _ jdvr5j __d_ nd_ d_jd krVjdkrVtt|sVj d7_ |j|jkrjd kplt|t|dk} j d} t}tj t|d!| t|d"| | _ dSdS)#Nr ignore)overgחAg-C6?g@@T.r)rTr.r@)r)Fc3s*|]}t|jjdkdVqdS)r9)rFr/trimr_N)rrFr_r(rrrr/r'r+r6s  z,FloatingFormat.fillFormat..cs|]}|dVqdS)reN) partitionr(rr'r'r+r6r7csrrNsplitr r'r'r+r6r7csrr&rr r'r'r+r6rr r)csrr&rr r'r'r+r6rr<csrr&rr r'r'r+r6rrvc 3s,|]}t|jdjdkdVqdS)Tr9)rF fractionalr/rr_N)rrFr_rrr'r+r6 scsrr!r"r r'r'r+r6r7css|] }t|dVqdS)z-+N)rxlstripr r'r'r+r6scsrr&rr r'r'r+r6rcsrr&rr r'r'r+r6r)r.r1r:r8r]r^)rrrxrVrminrrrpad_left pad_rightrexp_sizer/ min_digitsrarziprFr_rsignbitrrr%rj)rr finite_vals abs_non_zeromax_valmin_valstrs frac_strs_exp_strsint_part frac_partneginfoffsetcurrent_optionsr'rr+rs              zFloatingFormat.fillFormatc Cs t|sXtddFt}t|r$|jdkrdnd}||d}n|dkr*dn|jdkr1dnd}||d}d |j|jd t ||WdS1sSwY|j rpt ||j |j |j|j|jdk|j|jd St||j |j |jd |j|jdk|j|jd S)Nr)invalidr9rr]r r8r^r:r )rFr*r/rr_r' exp_digitsT)rFr*r/r$rr_r'r()rVrrr%rjrWr_r'r(rxrrrFr*r/rr)r)rrr9r_retr'r'r+__call__1sD       zFloatingFormat.__call__F)__name__ __module__ __qualname____doc__rrr=r'r'r'r+rs  VrTr)Fc Cs`t|d}t|d}t|d}t|d}|dkr$|dkr$||kr$tdt||||||||dS)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' rFr'r;r*r 2min_digits must be less than or equal to precision)rFr/rr_r'r;r*)rrKr)rrFr/rr_r'r;r*r'r'r+rTs F   rc Csvt|d}t|d}t|d}t|d}|s|dkrtd|dkr.|dkr.||kr.tdt|||||||||d 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' rFr'r(r*r z4precision must be greater than 0 if fractional=FalserC)rFr/r$rr_r'r(r*)rrKr) rrFr/r$rr_r'r(r*r'r'r+rs N    rc@seZdZdddZddZdS)rr8cCs|jdkr5t|}t|}tt|}|dkr|dkrd}|dkr+|dvr+|d7}t|tt|}nd}d||d|_dS)Nr r:r8z+ r z{:zd})rrVrr&rxrr4)rrr_data_maxdata_mindata_max_str_len max_str_lenr'r'r+rs     zIntegerFormat.__init__cCs |j|Sr&r3rrr'r'r+r=rzIntegerFormat.__call__N)r8r?r@rArr=r'r'r'r+rs  rc@seZdZddZddZdS)rcKs|jdkr d|_dSd|_dS)Nr'z TrueTrue)rztruestr)rrrtr'r'r+rszBoolFormat.__init__cCs|r|jSdS)NFalse)rKrHr'r'r+r=zBoolFormat.__call__NrIr'r'r'r+rs rc@s*eZdZdZ d ddddZddZdS) rz. Formatter for subtypes of np.complexfloating FNrc Csbt|tr |r dnd}|}}|dkrd}d}t|j|||||d|_t|j|||d|d|_dS)Nr9r8r@r1r0)r_r;)rRrJrreal real_formatimag imag_format) rrrFrarr_r;floatmode_realfloatmode_imagr'r'r+r s     zComplexFloatingFormat.__init__cCsH||j}||j}t|}|d|d||d}||S)Nj)rOrNrQrPrxr)rrrr spr'r'r+r=4s   zComplexFloatingFormat.__call__r>)r?r@rArBrr=r'r'r'r+rs rc@$eZdZddZddZddZdS)_TimelikeFormatcCs~|t|}t|dkr#tt|t|t|t|}nd}t||jkr1t|d}d||_d ||_ dS)Nr z%{}sz'NaT') rrxr_format_non_natrVr&rr4_formatrjust_nat)rrnon_natrGr'r'r+r@s   z_TimelikeFormat.__init__cCstr&)NotImplementedErrorrHr'r'r+rZNsz_TimelikeFormat._format_non_natcCst|r|jS|j||Sr&)rr]r[rZrHr'r'r+r=Rsz_TimelikeFormat.__call__N)r?r@rArrZr=r'r'r'r+rX?s rXcs6eZdZ  d fdd ZfddZdd ZZS) rN same_kindFcs\|dur|jjdkrt|jd}nd}|durd}||_||_||_||_t|dS)NMr rnaive) rkindrtimezoneunitcastingr;superr)rrrerdrfr; __class__r'r+rZs zDatetimeFormat.__init__cs |jdkr ||St|S)Nr@)r;rZrgr=rHrhr'r+r=ms   zDatetimeFormat.__call__cCsdt||j|j|jdS)N'%s')rerdrf)rrerdrfrHr'r'r+rZrs zDatetimeFormat._format_non_nat)NNr`F)r?r@rArr=rZ __classcell__r'r'rhr+rYs  rc@seZdZddZdS)rcCst|dS)Ni8)rastyperHr'r'r+rZzrMzTimedeltaFormat._format_non_natN)r?r@rArZr'r'r'r+rys rc@rW)SubArrayFormatcKs||_|d|_|d|_dS)NrZr[)rrZr)rrrcr'r'r+rs zSubArrayFormat.__init__cCs |j|jkrdnd|_||S)Nrr)rrZr format_array)rr}r'r'r+r=s zSubArrayFormat.__call__cst|dkr |Sjr;|jddjkr;fdd|djDjgfdd|j dD}n fdd|D}dd|d S) Nr rvcg|]}|qSr'ror(a_rr'r+rz/SubArrayFormat.format_array..crpr'rqrrrtr'r+rrucrpr'rqrrrtr'r+rrurr2r)rVryrrrzrrL)rr} formattedr'rtr+ros zSubArrayFormat.format_arrayN)r?r@rArr=ror'r'r'r+rn~s rnc@s,eZdZdZddZeddZddZdS) rz 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__. cCs ||_dSr&)format_functions)rrwr'r'r+rs zStructuredVoidFormat.__init__cKsXg}|jjD]!}t||fi|}|j|jdkr"t|fi|}||q||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')rrrrzrnappend)clsrrcrw field_namerr'r'r+rs  zStructuredVoidFormat.from_datacCs@ddt||jD}t|dkrd|dSdd|S)NcSsg|]\}}||qSr'r')r(fieldrr'r'r+rsz1StructuredVoidFormat.__call__..r z({},)r z({})r2)r+rwrxr4rL)rr str_fieldsr'r'r+r=s   zStructuredVoidFormat.__call__N)r?r@rArBr classmethodrr=r'r'r'r+rs   rcCst}|ddkrtjt|fi||S|ddur$i|d<|ddttjt|fi||}|s=|St|}|j ddd|j }t 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. r;rDr`NrrgrVr(z, dtype=))r%rjrorrr setdefaultrr~r@replacer?rVrr)ris_reprrcval_reprrycls_fqn void_dtyper'r'r+_void_scalar_to_strings  rcCsLt|}tddkr|jtjkrdS|jdurdS|js!dS|jtvS)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) r;r@FN) rVrr%rjr~rJrisnative _typelessdata)rr'r'r+dtype_is_implieds   rcCst|jtjjkr t|S|jdurt|St|jtr"dt|S|j }|j s.dt|S|r>|d r:| 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 Nrjr ) r~__repr__rVrrrrrr"rrisalphaisalnum)rtypenamer'r'r+dtype_short_reprs     rc Cst}|d}|dur||S|dur|d}t|tur$t|j}nd}|d}|ddkr@|jdkr@|jjs@t| } n |||||d |d d } g} |j d krW|jd ksd|ddkrm|j |dkrm| d|jt |jrw|j d kr| dt |j| s|| d S|| d} d | d } t| | dd} d}|ddkrt|jjtrddt|}n| t| d|krddt|}| || S)zEInternal version of array_repr() that allows overriding array2string.rbNr\rr~r;r@r'r2r)rr )r rZzshape=zdtype=,rr r:)r%rjr~rr?rzrrrrrrxrrrLrxrfindrr")arrrrFrrr9rb class_namerrextrasarr_str extra_str last_line_lenspacerr'r'r+_array_repr_implementation!sH         rcCrr&r'rrrFrr'r'r+_array_repr_dispatcherWrcCt||||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. ])' )rrr'r'r+r\s.rcCst|tr t|St|Sr&)rRbytesrr)r*r'r'r+_guarded_repr_or_strs rcCs\tddkr|jdkr|jjst|S|jdkr%ttj |dS|||||ddS)zDInternal version of array_str() that allows overriding array2string.r;r@r'r:r) r%rjrzrrrrrrVr __getitem__)r}rrFrrr'r'r+_array_str_implementations   rcCrr&r'r}rrFrr'r'r+_array_str_dispatcherrrcCr)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]' )rrr'r'r+rs%r __wrapped__)r) NNNNNNNNNNNN) NNNNNNNNNN)r')r)r:r)NTr)FNNN)NTTr)FNNN)T)NNN)`rB__all__ __docformat__rrSrM_threadr ImportError _dummy_threadrgrVrr rumathrrrrrrrrrrr fromnumericrnumericrrrrrrr r!r"rr#r$rr%rXrO contextlibrfrrirrqcontextmanagerr{rrrrrrrrrrrrrrrrrrrrrXrrrnrrrJrrrrrrrrrrgetattr_array2string_implpartial_default_array_str_default_array_reprr'r'r'r+s        ?9  0  "2 )  6| P [ !  %*! 7  1     )