Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
numpy
/
lib
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: utils.cpython-310.pyc
o 6��at� � @ sj d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZmZm Z d dl m Z d dl m Z mZmZ d dlZg d�Zdd� Zdd � ZG d d � d �Zd d � Zdd� Zdd� Zdd� Zd1dd�Zdd� Zda da d2dd�Z ej fdd �Z e d�dd ej dfd d ��Z!e d�ej fd d!��Z"i Z#e�$d"ej%�Z&e d� $ d3d%d&��Z'd'd(� Z(d)d*� Z)d+d,� Z*d-d.� Z+d/d0� Z,dS )4� N)� issubclass_� issubsctype� issubdtype)� set_module)�ndarray�ufunc�asarray) r r r � deprecate�deprecate_with_doc� get_include�info�source�who�lookfor� byte_bounds� safe_evalc C sX ddl } | jdu rtj�tj�| j�dd�}|S ddlm} tj�tj�|j�d�}|S )a� Return the directory that contains the NumPy \*.h header files. Extension modules that need to compile against NumPy should use this function to locate the appropriate include directory. Notes ----- When using ``distutils``, for example in ``setup.py``. :: import numpy as np ... Extension('extension_name', ... include_dirs=[np.get_include()]) ... r N�core�include) �numpy� show_config�os�path�join�dirname�__file__� numpy.corer )r �dr � r �1/usr/lib/python3/dist-packages/numpy/lib/utils.pyr s �r c C s || _ | S �N)�__name__)�func�namer r r �_set_function_name1 s r# c @ s" e Zd ZdZddd�Zdd� ZdS )� _Deprecatez� Decorator class to deprecate old functions. Refer to `deprecate` for details. See Also -------- deprecate Nc C s || _ || _|| _d S r )�old_name�new_name�message)�selfr% r& r' r r r �__init__B s z_Deprecate.__init__c sv | j }| j}| j}|du r z�j}W n ty �j}Y nw |du r(d| � nd||f � |dur8� d| 7 � � �fdd�}t||�}�j}|du rN� }nR|�� �d�} t | dd� �} | d � � rj| d | }n't | d �d } | dd� D ]} t | �| kr� n | t | �d 7 } qx|| d� }t � � d | �� d �� |g�}||_z�j} W n ty� Y |S w |j�| � |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 )z1`arrayrange` is deprecated, use `arange` instead!� )� stacklevel)�warnings�warn�DeprecationWarning)�args�kwds��depdocr! r r �newfunc^ s z$_Deprecate.__call__.<locals>.newfunc� r � z )r% r& r' r �AttributeErrorr# �__doc__� expandtabs�split� _get_indent�lstrip�len�textwrap�indentr �__dict__�update)r( r! r0 �kwargsr% r& r' r4 �doc�linesr? �skip�liner r r2 r �__call__G sT � � � z_Deprecate.__call__)NNN)r � __module__� __qualname__r8 r) rG r r r r r$ 6 s r$ c C sD t j}| D ]}t|�� �}|rt|t|�| �}q|t jkr d}|S )zU Determines the leading whitespace that could be removed from all the lines. r )�sys�maxsizer= r< �min)rD r? rF �contentr r r r; � s � r; c O s8 | r| d }| dd� } t | i |��|�S t | i |��S )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. 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.deprecate(np.uint) DeprecationWarning: `uint64` is deprecated! # may vary >>> olduint(6) 6 r r5 N�r$ )r0 rB �fnr r r r � s , r c C s t | d�S )a� Deprecates a function and includes the deprecation in its docstring. 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 `DeprecationWarning` Parameters ---------- msg : str Additional explanation of the deprecation. Displayed in the docstring after the warning. Returns ------- obj : object )r' rN )�msgr r r r � s r c C s� | j }|d d }|d }|d }t| �jj}| }}|du r*|| j| 7 }||fS t||�D ]\}} | dk r@||d | 7 }q/||d | 7 }q/||7 }||fS )a# Returns pointers to the end-points of an array. Parameters ---------- a : ndarray Input array. It must conform to the Python-side of the array interface. Returns ------- (low, high) : tuple of 2 integers The first integer is the first byte of the array, the second integer is just past the last byte of the array. If `a` is not contiguous it will not use every byte between the (`low`, `high`) values. Examples -------- >>> I = np.eye(2, dtype='f'); I.dtype dtype('float32') >>> low, high = np.byte_bounds(I) >>> high - low == I.size*I.itemsize True >>> I = np.eye(2); I.dtype dtype('float64') >>> low, high = np.byte_bounds(I) >>> high - low == I.size*I.itemsize True �datar �strides�shapeNr5 )�__array_interface__r �dtype�itemsize�size�zip) �a�ai�a_data�astrides�ashape�bytes_a�a_low�a_highrS �strider r r r � s �r c C s< | du r t �� j}|j} g }i }| �� D ]D}t| | t�rX| | }t|�}||�� v r6|d|| }d}n|||< |}d}d�t t |j ��} t |j �} |� || | |jj|g� qd} d} d} d}tt|��D ]<}|| }| t|d �k r{t|d �} | t|d �k r�t|d �} | t|d �k r�t|d �} |d r�|t|d �7 }qgt|�dkr�td| �}td| �}td| �}d |d |d |d f }t|d d t|�d d � tt|��D ]9}|| }td|d d |t|d � d |d d |t|d � d |d d |t|d � d |d f � q�td| � dS )a% Print the NumPy arrays in the given dictionary. If there is no dictionary passed in or `vardict` is None then returns NumPy arrays in the globals() dictionary (all NumPy arrays in the namespace). Parameters ---------- vardict : dict, optional A dictionary possibly containing ndarrays. Default is globals(). Returns ------- out : None Returns 'None'. Notes ----- Prints out the name, shape, bytes and type of all of the ndarrays present in `vardict`. Examples -------- >>> a = np.arange(10) >>> b = np.ones(20) >>> np.who() Name Shape Bytes Type =========================================================== a 10 80 int64 b 20 160 float64 Upper bound on total bytes = 240 >>> d = {'x': np.arange(2.0), 'y': np.arange(3.0), 'txt': 'Some str', ... 'idx':5} >>> np.who(d) Name Shape Bytes Type =========================================================== x 2 16 float64 y 3 24 float64 Upper bound on total bytes = 40 Nz (%s)r r5 z x r+ � � z Name %s Shape %s Bytes %s Typer6 r* �=� z%s %s %s %s %s %s %s� z' Upper bound on total bytes = %d)rJ � _getframe�f_back� f_globals�keys� isinstancer �idr �map�strrS �nbytes�appendrU r" �ranger= �int�max�print)�vardict�frame�sta�cacher" �var�idv�namestr�original�shapestr�bytestr�maxname�maxshape�maxbyte� totalbytes�k�val�sp1�sp2�sp3�prvalr r r r sf , �� � � r c C s� t | �}|}| }d}|�|�}|D ]4}||krd} n|} |t |� t | � }||kr?|d t |� }|d d|d | }q|| | }q|S )Nz, � r5 z, r6 r+ )r= r: ) r" � arguments�width� firstwidthr� �newstr�sepstr�arglist�argument�addstrr r r � _split_line� s r� r c C s� t | t� t� g �} | j| ji}| jg}| jg} t|�dkr# ||fS |�d�}|�� D ]&}t|| t j �rR|| j}||vrR|| j}|� |� |� |� |||< q,q)NTr ) � __import__�globals�localsr r@ r= �poprj rk �types� ModuleTyperp )�module�thedict�dictlist� totraverse�thisdict�x�modname�moddictr r r � _makenamedict� s& � ��r� c C st d}d}dd� }t | dt| ��}t |d|�}| j}| jj}td||d� td| j|d� td ||d� td | j|d� td || jj �|d� td || jj �|d� td | jj |d� tdt | j jj�|f |d� tdd|d� |dv r�td|tj|f |d� d} n#|dkr�td||f |d� tjdk} ntd||f |d� tjdk} td|| �|d� td| j |d� d S ) aO Provide information about ndarray obj. Parameters ---------- obj : ndarray Must be ndarray, not checked. output Where printed output goes. Notes ----- Copied over from the numarray module prior to its removal. Adapted somewhat as only numpy is an option now. Called by info. r� c S s | S r r )r� r r r �<lambda>� s z_info.<locals>.<lambda>� __class__r zclass: ��filezshape: z strides: z itemsize: z aligned: z contiguous: z fortran: zdata pointer: %s%sz byteorder: r6 )�endr� )�|rd z%s%s%sF�>z%sbig%s�bigz %slittle%s�littlez byteswap: ztype: %sN)�getattr�typerR rU � byteorderrt rS rV �flags�aligned� contiguous�fortran�hex�ctypes�_as_parameter_�valuerJ ) �obj�output�extra�tic�bp�cls�nmrR �endian�byteswapr r r �_info� s: � r� �L c C sF ddl }ddl}t| d�st| d�r| j} nt| d�r | j} | du r(tt� dS t| t�r5t| |d� dS t| t �r�t du rDt |�\a a d}g }t D ]A}z6t | | } t | �|v rbtd| |d� n|�t | �� td | |d� t| � td | |d� |d 7 }W qJ ty� Y qJw |dkr�td | |d� dS td | |d� dS |�| �s�|�| �r�| j} z t |�| ��} W n ty� d} Y nw t| | �|kr�t| | |�} n| | } td| d |d� t|�| �|d� dS |�| ��r�| j} z t |�| ��} W n t�y d} Y nw t| | �|k�r t| | |�} n| | } td| d |d� |�| �} | du �rFt| d��rEt|�| j�|d� n t|�| �|d� |�| �}dd� |D �}|�r�td|d� |D ]'}t | |d�}|du�r�|� |�|��p|d�\}}td||f |d� �qfdS dS t| d��r�t|�| �|d� dS dS )a� Get help information for a function, class, or module. Parameters ---------- object : object or str, optional Input object or name to get information about. 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 ``stdout``. The object has to be opened in 'w' or 'a' mode. toplevel : str, optional Start search at this level. See Also -------- source, lookfor 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. *** r N�_ppimport_importer�_ppimport_module�_ppimport_attr)r� z+ *** Repeat reference found in %s *** r� z *** Found in %s ***�-r5 zHelp for %s not found.z+ *** Total of %d references found. ***z()r6 r* r) c S s g | ] }|d dkr|�qS )r �_r )�.0�methr r r � <listcomp>h s zinfo.<locals>.<listcomp>z Methods: �Nonez %s -- %sr8 ) �pydoc�inspect�hasattrr� r� r rk r r� rn � _namedictr� � _dictlistrl rt rp �KeyError� isfunction�ismethodr � signature� Exceptionr= r� �getdoc�isclassr) � allmethodsr� �splitdoc)�object�maxwidthr� �toplevelr� r� �numfound�objlistr{ r� r" r� �argstr�doc1�methods�public_methodsr� �thisobj�methstr�otherr r r r � s� 4 � �� �� � � � � �� �r c C sX ddl }ztd|�| � |d� t|�| �|d� W dS ty+ td|d� Y dS w )a� Print or write to a file the source code for a NumPy object. The source code is only returned for objects written in Python. Many functions and classes are defined in C and will therefore not return useful information. Parameters ---------- object : numpy object Input object. This can be any object (function, class, module, ...). output : file object, optional If `output` not supplied then source code is printed to screen (sys.stdout). File object must be created with either write 'w' or append 'a' modes. See Also -------- lookfor, info Examples -------- >>> np.source(np.interp) #doctest: +SKIP In file: /usr/lib/python2.6/dist-packages/numpy/lib/function_base.py def interp(x, xp, fp, left=None, right=None): """.... (full docstring printed)""" if isinstance(x, (float, int, number)): return compiled_interp([x], xp, fp, left, right).item() else: return compiled_interp(x, xp, fp, left, right) The source code is only returned for objects written in Python. >>> np.source(np.array) #doctest: +SKIP Not available for this object. r Nz In file: %s r� z Not available for this object.)r� rt � getsourcefile� getsourcer� )r� r� r� r r r r w s ) �r z[a-z0-9_]+\(.*[,=].*\)TFc s� ddl }t|||�� g }t| ��� �� ��sdS � �� D ] \}\}} } | dv r(q |�� �t�fdd��D ��r<|�|� q ddddd����fd d ��� �fd d �} |j| d � dd� �� } | dt | � g} |ddd� D ]=}� | \�} }dd� �� � �d�D �}z|d � � }t � |�r�|d � � }W n ty� d}Y nw | �d||f � qn|s�| �d� |dur�|�d� | �� dS t | �dkr�|�� }|d� | �� dS td� | �� dS )a� Do a keyword search on docstrings. A list of objects that matched the search is displayed, sorted by relevance. All given keywords need to be found in the docstring for it to be returned as a result, but the order does not matter. Parameters ---------- what : str String containing words to look for. module : str or list, optional Name of module(s) whose docstrings to go through. import_modules : bool, optional Whether to import sub-modules in packages. Default is True. regenerate : bool, optional Whether to re-generate the docstring cache. Default is False. output : file-like, optional File-like object to write the output to. If omitted, use a pager. See Also -------- source, info Notes ----- Relevance is determined only roughly, by checking if the keywords occur in the function name, at the start of a docstring, etc. Examples -------- >>> np.lookfor('binary representation') # doctest: +SKIP Search results for 'binary representation' ------------------------------------------ numpy.binary_repr Return the binary representation of the input number as a string. numpy.core.setup_common.long_double_representation Given a binary dump as given by GNU od -b, look for long double numpy.base_repr Return a string representation of a number in the given base system. ... r N)r� r� c 3 s � | ]}|� v V qd S r r �r� �w)rC r r � <genexpr>� s � zlookfor.<locals>.<genexpr>i� ����)r! �classr� r� c s� d}d� |�� �� �d�d d� �� |t� fdd��D ��7 }|t�fdd��D ��7 }|t�� d 7 }|��|d�7 }|��d � d 7 }|t| d d �7 }|S ) Nr r* rf c � g | ]}|� v rd �qS )�� r r� )� first_docr r r� � z.lookfor.<locals>.relevance.<locals>.<listcomp>c r� )� r r� )r" r r r� r� re r� �.rc �d i����) r �lower�stripr: �sumr= �get�countrs )r" �docstr�kind�index�r)�kind_relevance�whats)r� r" r � relevance� s zlookfor.<locals>.relevancec s �| g� | �R � S r r )rY )rx r� r r �relevance_value s z lookfor.<locals>.relevance_value)�keyzSearch results for '%s'r6 r� ���c S s g | ] }|� � r|� � �qS r )r� )r� rF r r r r� s �zlookfor.<locals>.<listcomp>r* r5 r� z %s %szNothing found.rc )r� �_lookfor_generate_cachern r� r: �items�allrp �sortr r= r� �_function_signature_re�search� IndexError�write�getpagerrt )�whatr� �import_modules� regenerater� r� �foundr" � docstringr� r� r� �s� help_text�ix�doclinesr� �pagerr )rx rC r� r� r� r r � sR / �� � � r c C s� ddl }ddlm} | du rd} t| t�r-zt| � W n ty& i Y S w tj| } n t| t �s7t| t �rIi }| D ] }|� t |||�� q;|S t | �tv rW|sWtt | � S i }|tt | �< i }d}| j| fg} | �r�| �d�\} } t | �|v rzqid|t | �< |d7 }d} |�| ��r�d} z| j} W n ty� d} Y nw |�rt| d ��r| jD ]l}t�|�D ]d}tj�||�}tj�||d �}tj�|�r�|�d �r�|dd � }n tj�|�r�|}nq�|d kr�q�z(tj }tj }z|� t_ |� t_ td| |f � W |t_ |t_ n|t_ |t_ w W q� t �y Y q�w q�t | �D ]f\}}zt |dd| |f �}t |dd�}W n t!�yD d| |f }d}Y nw d|v�rS|�rSd||f }|�"| d ��sdt|t#��rbn�q |�|��sv| du �sv|| v �sv�q | �$d| |f |f� �q n&|�%| ��r�d} t | �D ]\}}| �$d| |f |f� �q�nt| d��r�d} z|�&| �}W n t!�y� d}Y nw |du�r�|| |f|| < | sl|S )a� Generate docstring cache for given module. Parameters ---------- module : str, None, module Module for which to generate docstring cache import_modules : bool Whether to import sub-modules in packages. regenerate : bool Re-generate the docstring cache Returns ------- cache : dict {obj_full_name: (docstring, kind, index), ...} Docstring cache for the module, either cached one (regenerate=False) or newly generated. r N)�StringIOr Tr5 r� r� �__path__z __init__.pyz.py���r) z%s.%sr rH r� r� rG r! )'r� �ior rk rn r� � ImportErrorrJ �modules�list�tuplerA r rl �_lookfor_cachesr r� �ismodule�__all__r7 r� r r �listdirr r �isfile�endswith�stdout�stderr� BaseException� _getmembersr� � NameError� startswithr rp r� r� )r� r r r� r rx �mod�seenr� �stackr" �itemr� �_all�pth�mod_path�this_py�init_py� to_import� old_stdout� old_stderr�n�v� item_name�mod_namerC r r r r . s� � � � � � �� � � � � �Sr c sD dd l }z|�� �}W |S ty! � fdd�t� �D �}Y |S w )Nr c s$ g | ]}t � |�r|t� |�f�qS r )r� r� )r� r� �r+ r r r� � s �z _getmembers.<locals>.<listcomp>)r� � getmembersr� �dir)r+ r� �membersr r8 r r% � s ��r% c C s ddl }|�| �S )a� Protected string evaluation. Evaluate a string containing a Python literal expression without allowing the execution of arbitrary non-literal code. 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...> r N)�ast� literal_eval)r r< r r r r � s , r c C s� | j dkr|S t�| jd|d��}tj�|�r |�d�}|jdkr?|dkr=|dur6| j� tj �|d< |}|S | j� tj �}|S t� |� � �dkrMtj ||< |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 Input data to median function result : Array or MaskedArray Result of median function axis : int Axis along which the median was computed. out : ndarray, optional Output array in which to place the result. Returns ------- median : scalar or ndarray Median or NaN in axes which contained NaN in the input. r r )�axisFTN.) rW �np�isnan�take�ma� isMaskedArray�filled�ndimrU r� �nan� count_nonzero�ravel)rQ �resultr> �outr4 r r r �_median_nancheck� s �� rK c C sr ddl m} m}m} t|�dkrt|�dkrdS d�|�}|D ]}| | r.|d|� d�7 }q |d|� d�7 }q |S )a� Returns a string contains the supported CPU features by the current build. The string format can be explained as follows: - dispatched features that are supported by the running machine end with `*`. - dispatched features that are "not" supported by the running machine end with `?`. - remained features are representing the baseline. r )�__cpu_features__�__cpu_baseline__�__cpu_dispatch__r� r6 �*�?)� numpy.core._multiarray_umathrL rM rN r= r )rL rM rN �enabled_features�featurer r r � _opt_info s rT r )r )NTFN)-r rJ r> r� �rer- �numpy.core.numerictypesr r r �numpy.core.overridesr r r r r r r? r r r# r$ r; r r r r r� r� r� r� r" r� r r r �compile�Ir r r r% r rK rT r r r r �<module> sR L5 9i 3 3 �{ 0 &
Save
Cancel