a
:jg[ @ s d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlm Z d dl
m Z d dl Z
g dZe ddd Ze ddd ZG d
d d Zd d
Zdd Zdd Zdd Zdadad#ddZd$ddZe dd%ddZdd Zd d Z d d Z d!d" Z dS )& N)ndarray)
set_module) get_includeinfo show_runtimenumpyc C s ddl m} m}m} ddlm} tjtjt
dg}g g }}|D ]"}| | r\| | qD| | qD| d|||di z ddl m
} || W n ty td Y n0 || d S )
a(
Print information about various resources in the system
including available intrinsic support and BLAS/LAPACK library
in use
.. versionadded:: 1.24.0
See Also
--------
show_config : Show libraries in the system on which NumPy was built.
Notes
-----
1. Information is derived with the help of `threadpoolctl `_
library if available.
2. SIMD related information is derived from ``__cpu_features__``,
``__cpu_baseline__`` and ``__cpu_dispatch__``
r __cpu_features____cpu_baseline____cpu_dispatch__)pprint)Z
numpy_versionpythonunameZsimd_extensions)Zbaselinefound not_found)threadpool_infozWARNING: `threadpoolctl` not found in system! Install it by `pip install threadpoolctl`. Once installed, try `np.show_runtime` again for more detailed build informationN) numpy._core._multiarray_umathr r
r r np __version__sysversionplatformr appendZ
threadpoolctlr extend ImportErrorprint) r r
r r Z config_foundZfeatures_foundZfeatures_not_foundfeaturer r ?/usr/local/lib/python3.9/site-packages/numpy/lib/_utils_impl.pyr s0
r c C sV ddl } | jdu r.tjtj| jdd}n$ddlm} tjtj|jd}|S )aX
Return the directory that contains the NumPy \*.h header files.
Extension modules that need to compile against NumPy may need to use this
function to locate the appropriate include directory.
Notes
-----
When using ``setuptools``, for example in ``setup.py``::
import numpy as np
...
Extension('extension_name', ...
include_dirs=[np.get_include()])
...
Note that a CLI tool ``numpy-config`` was introduced in NumPy 2.0, using
that is likely preferred for build systems other than ``setuptools``::
$ numpy-config --cflags
-I/path/to/site-packages/numpy/_core/include
# Or rely on pkg-config:
$ export PKG_CONFIG_PATH=$(numpy-config --pkgconfigdir)
$ pkg-config --cflags
-I/path/to/site-packages/numpy/_core/include
r N_coreinclude) r Z show_configospathjoindirname__file__ numpy._corer )r dr r r r r I s
r c @ s" e Zd ZdZdddZdd ZdS )
_Deprecatez
Decorator class to deprecate old functions.
Refer to `deprecate` for details.
See Also
--------
deprecate
Nc C s || _ || _|| _d S N)old_namenew_namemessage)selfr* r+ r, r r r __init__~ s z_Deprecate.__init__c
s2 | j }| j}| j}|du r j}|du r2d| n d||f |durR d| 7 t fdd}||_j}|du r }n| d} t | dd }
| d
r|
d | }nNt | d d } | dd D ]$} t | |
kr q| t | d 7 } q|| d }t
d |
d
|g}||_|S ) z:
Decorator call. Refer to ``decorate``.
Nz`%s` is deprecated!z%`%s` is deprecated, use `%s` instead!
c s t j tdd | i |S )N
stacklevel)warningswarnDeprecationWarning)argskwdsZdepdocfuncr r newfunc s z$_Deprecate.__call__..newfunc r z
)r* r+ r, __name__ functoolswraps__doc__
expandtabssplit _get_indentlstriplentextwrapindentr# )
r- r9 r6 kwargsr* r+ r, r: doclinesrG skipliner r8 r __call__ s@
z_Deprecate.__call__)NNN)r=
__module__ __qualname__r@ r. rM r r r r r( r s
r( c C sD t j}| D ]&}t| }|r
t|t|| }q
|t jkr@d}|S )zU
Determines the leading whitespace that could be removed from all the lines.
r )r maxsizerE rD min)rJ rG rL contentr r r rC s
rC c O sL t jdtdd | r:| d }| dd } t| i ||S t| i |S dS )a
Issues a DeprecationWarning, adds warning to `old_name`'s
docstring, rebinds ``old_name.__name__`` and returns the new
function object.
This function may also be used as a decorator.
.. deprecated:: 2.0
Use `~warnings.warn` with :exc:`DeprecationWarning` instead.
Parameters
----------
func : function
The function to be deprecated.
old_name : str, optional
The name of the function to be deprecated. Default is None, in
which case the name of `func` is used.
new_name : str, optional
The new name for the function. Default is None, in which case the
deprecation message is that `old_name` is deprecated. If given, the
deprecation message is that `old_name` is deprecated and `new_name`
should be used instead.
message : str, optional
Additional explanation of the deprecation. Displayed in the
docstring after the warning.
Returns
-------
old_func : function
The deprecated function.
Examples
--------
Note that ``olduint`` returns a value after printing Deprecation
Warning:
>>> olduint = np.lib.utils.deprecate(np.uint)
DeprecationWarning: `uint64` is deprecated! # may vary
>>> olduint(6)
6
b`deprecate` is deprecated, use `warn` with `DeprecationWarning` instead. (deprecated in NumPy 2.0)r0 r1 r r; Nr3 r4 r5 r( )r6 rH fnr r r deprecate s 0 rV c C s t jdtdd t| dS )a
Deprecates a function and includes the deprecation in its docstring.
.. deprecated:: 2.0
Use `~warnings.warn` with :exc:`DeprecationWarning` instead.
This function is used as a decorator. It returns an object that can be
used to issue a DeprecationWarning, by passing the to-be decorated
function as argument, this adds warning to the to-be decorated function's
docstring and returns the new function object.
See Also
--------
deprecate : Decorate a function such that it issues a
:exc:`DeprecationWarning`
Parameters
----------
msg : str
Additional explanation of the deprecation. Displayed in the
docstring after the warning.
Returns
-------
obj : object
rS r0 r1 )r, rT )msgr r r deprecate_with_doc s rX c
C s t | }|}| }d}||}|D ]h}||kr4d} n|} |t | t | }||kr~|d t | }|d d|d | }q"|| | }q"|S )Nz, r; z,
r< r0 )rE rB )
name argumentswidthZ
firstwidthkZnewstrZsepstrZarglistargumentZaddstrr r r _split_line7 s
r_ c C s t | t t g } | j| ji}| jg}| jg}t|dkrw z_info.. __class__r= Nzclass: filezshape: z strides: z
itemsize: z aligned: z contiguous: z fortran: zdata pointer: %s%sz byteorder: r< )endrq )|=z%s%s%sF>z%sbig%sbigz
%slittle%slittlez
byteswap: ztype: %s)getattrtypestridesdtype byteorderr stdoutr shapeitemsizeflagsZaligned
contiguousfortranhexctypesZ_as_parameter_value)
objoutputextraZticbpclsnmrz Zendianbyteswapr r r _infoc s>
r L c C sX ddl }ddl}t| ds$t| dr,| j} nt| dr<| j} |du rJtj}| du r^tt nt| t rxt
| |d nt| t r\t du rt
|\a ad}g }tD ]}zlt | | } t| |v rtd| |d n6|t| td | |d t| td
| |d |d 7 }W q ty( Y q0 q|dkrHtd | |d ntd
| |d n|| st|| r| j}
zt || } W n ty d} Y n0 t|
| |krt|
| |} n|
| } td| d |d t|| |d n\|| r6| j}
zt || } W n ty4 d} Y n0 t|
| |krVt|
| |} n|
| } td| d |d || }
|
du rt| drt|| j |d nt|| |d | | }dd |D }|rTtd|d |D ]J}t | |d}|dur | ||pd\}}td||f |d qn t| drTt|| |d dS )a
Get help information for an array, function, class, or module.
Parameters
----------
object : object or str, optional
Input object or name to get information about. If `object` is
an `ndarray` instance, information about the array is printed.
If `object` is a numpy object, its docstring is given. If it is
a string, available modules are searched for matching objects.
If None, information about `info` itself is returned.
maxwidth : int, optional
Printing width.
output : file like object, optional
File like object that the output is written to, default is
``None``, in which case ``sys.stdout`` will be used.
The object has to be opened in 'w' or 'a' mode.
toplevel : str, optional
Start search at this level.
Notes
-----
When used interactively with an object, ``np.info(obj)`` is equivalent
to ``help(obj)`` on the Python prompt or ``obj?`` on the IPython
prompt.
Examples
--------
>>> np.info(np.polyval) # doctest: +SKIP
polyval(p, x)
Evaluate the polynomial p at x.
...
When using a string for `object` it is possible to get multiple results.
>>> np.info('fft') # doctest: +SKIP
*** Found in numpy ***
Core FFT routines
...
*** Found in numpy.fft ***
fft(a, n=None, axis=-1)
...
*** Repeat reference found in numpy.fft.fftpack ***
*** Total of 3 references found. ***
When the argument is an array, information about the array is printed.
>>> a = np.array([[1 + 2j, 3, -4], [-5j, 6, 0]], dtype=np.complex64)
>>> np.info(a)
class: ndarray
shape: (2, 3)
strides: (24, 8)
itemsize: 8
aligned: True
contiguous: True
fortran: False
data pointer: 0x562b6e0d2860 # may vary
byteorder: little
byteswap: False
type: complex64
r NZ_ppimport_importer_ppimport_module_ppimport_attr)r z+
*** Repeat reference found in %s *** rp z *** Found in %s ***-r; zHelp for %s not found.z+
*** Total of %d references found. ***z()r< r/ r. c S s g | ]}|d dkr|qS )r _r ).0methr r r
- rn zinfo..z
Methods:
Nonez %s -- %sr@ ) pydocinspecthasattrr r r r} r rf r r str _namedictrl _dictlistidr r KeyError
isfunctionismethodr= signature ExceptionrE r_ getdocisclassr. Z
allmethodsrx Zsplitdoc)objectZmaxwidthr toplevelr r ZnumfoundZobjlistZnamestrr rZ r[ ZargstrZdoc1methodsZpublic_methodsr ZthisobjZmethstrotherr r r r s B
r c C s" t jdtdd ddl}|| S )a
Protected string evaluation.
.. deprecated:: 2.0
Use `ast.literal_eval` instead.
Evaluate a string containing a Python literal expression without
allowing the execution of arbitrary non-literal code.
.. warning::
This function is identical to :py:meth:`ast.literal_eval` and
has the same security implications. It may not always be safe
to evaluate large input strings.
Parameters
----------
source : str
The string to evaluate.
Returns
-------
obj : object
The result of evaluating `source`.
Raises
------
SyntaxError
If the code has invalid Python syntax, or if it contains
non-literal code.
Examples
--------
>>> np.safe_eval('1')
1
>>> np.safe_eval('[1, 2, 3]')
[1, 2, 3]
>>> np.safe_eval('{"foo": ("bar", 10.0)}')
{'foo': ('bar', 10.0)}
>>> np.safe_eval('import os')
Traceback (most recent call last):
...
SyntaxError: invalid syntax
>>> np.safe_eval('open("/home/user/.ssh/id_dsa").read()')
Traceback (most recent call last):
...
ValueError: malformed node or string: <_ast.Call object at 0x...>
z`safe_eval` is deprecated. Use `ast.literal_eval` instead. Be aware of security implications, such as memory exhaustion based attacks (deprecated in NumPy 2.0)r0 r1 r N)r3 r4 r5 ast literal_eval)sourcer r r r safe_eval< s 6 r c C sl | j dkr|S | jd|d}t|}tj|r<|d}| sH|S t|tj rX|S tj
|||d |S )a{
Utility function to check median result from data for NaN values at the end
and return NaN in that case. Input result can also be a MaskedArray.
Parameters
----------
data : array
Sorted input data to median function
result : Array or MaskedArray
Result of median function.
axis : int
Axis along which the median was computed.
Returns
-------
result : scalar or ndarray
Median or NaN in axes which contained NaN in the input. If the input
was an array, NaN will be inserted in-place. If a scalar, either the
input itself or a scalar NaN.
r )axisF)where) sizeZtaker isnanmaZ
isMaskedArrayZfilledanyrf ZgenericZcopyto)dataresultr Zpotential_nansnr r r _median_nancheck s
r c C sr ddl m} m}m} t|dkr0t|dkr0dS d|}|D ].}| | r\|d| d7 }q>|d| d7 }q>|S )a
Returns a string containing the CPU features supported
by the current build.
The format of the string can be explained as follows:
- Dispatched features supported by the running machine end with `*`.
- Dispatched features not supported by the running machine
end with `?`.
- Remaining features represent the baseline.
Returns:
str: A formatted string indicating the supported CPU features.
r r rY r< *?)r r r
r rE r# )r r
r Zenabled_featuresr r r r _opt_info s
r c
C s" | j dur| jdu}g }g }g }g }| j D ]d\}}t|d }||d urRd}|| || ||d |t|dk rdn|d q.|s| S t||||| jd} tj | | j
dS | j dur| j \}
} t|
} | jdu r| |
u r| S t | | fS | jdu r| S t | j S dS ) a
Returns the dtype unchanged if it contained no metadata or a copy of the
dtype if it (or any of its structure dtypes) contained metadata.
This utility is used by `np.save` and `np.savez` to drop metadata before
saving.
.. note::
Due to its limitation this function may move to a more appropriate
home or change in the future and is considered semi-public API only.
.. warning::
This function does not preserve more strange things like record dtypes
and user dtypes may simply return the wrong thing. If you need to be
sure about the latter, check the result with:
``np.can_cast(new_dtype, dtype, casting="no")``.
Nr Tr; r0 )namesformatsoffsetstitlesr )align)
fieldsmetadataitems
drop_metadatar rE dictr r r{ Zisalignedstructsubdtyper )
r{ Zfound_metadatar r r r rZ fieldZfield_dtZ structurer r~ Z new_subdtyper r r r s<
r )r )N)Nr Nr ) r! r rF rg rer3 r> r r& r Z numpy._utilsr r r __all__r r r( rC rV rX r_ r r rl r r r r r r r r r r s>
5
(DA2
6 #C*