관리-도구
편집 파일: utils.cpython-37.pyc
B ��Fd� � @ st d dl mZmZmZ d dlZd dlZd dlZd dlZd dlZd dl m Z m Z m Z d dl mZmZmZ d dlZd dlmZmZ dddd d d d d ddddg Zdd � Zdd� ZG dd� de�Zdd � Zdd� Z dd� Z d3dd�Z d d � Z da da!d4d d �Z"ej#fd!d"�Z$dd#ej#d fd$d �Z%ej#fd%d �Z&i a'e�(d&ej)�Z*d5d)d�Z+d*d+� Z,d,d-� Z-G d.d/� d/e�Z.d0d� Z/d1d2� Z0dS )6� )�division�absolute_import�print_functionN)� issubclass_� issubsctype� issubdtype)�ndarray�ufunc�asarray)� getargspec� formatargspecr r r � deprecate�deprecate_with_doc� get_include�info�source�who�lookfor� byte_bounds� safe_evalc C sV ddl } | jdkr.tj�tj�| j�dd�}n$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) �numpyZ show_config�os�path�join�dirname�__file__� numpy.corer )r �dr � r �B/opt/alt/python37/lib64/python3.7/site-packages/numpy/lib/utils.pyr s c C s || _ | S )N)�__name__)�func�namer r r! �_set_function_name4 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 )N)�old_name�new_name�message)�selfr' r( r) r r r! �__init__E s z_Deprecate.__init__c s� | j }| j}| j}ddl�|dkrHy �j}W n tk rF �j}Y nX |dkrZd| � n d||f � |dk rz� d| 7 � � ��fdd�}t||�}�j}|dkr�� }nd�� |g�}||_y �j } W n tk r� Y nX |j � | � |S ) z: Decorator call. Refer to ``decorate``. r Nz`%s` is deprecated!z%`%s` is deprecated, use `%s` instead!� c s �j � tdd� �| |�S )z1`arrayrange` is deprecated, use `arange` instead!� )� stacklevel)�warn�DeprecationWarning)�args�kwds)�depdocr# �warningsr r! �newfuncb s z$_Deprecate.__call__.<locals>.newfuncz ) r' r( r) r4 r" �AttributeErrorr% �__doc__r �__dict__�update) r* r# r1 �kwargsr' r( r) r5 �docr r )r3 r# r4 r! �__call__J s8 z_Deprecate.__call__)NNN)r" � __module__� __qualname__r7 r+ r< r r r r! r& 9 s r& c O s` | rR| d }| dd� } d|kr.|� d�|d< d|krD|� d�|d< t| |�|�S t| |�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. 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) >>> olduint(6) /usr/lib/python2.5/site-packages/numpy/lib/utils.py:114: DeprecationWarning: uint32 is deprecated warnings.warn(str1, DeprecationWarning, stacklevel=2) 6 r � NZnewnamer( �oldnamer' )�popr& )r1 r: �fnr r r! r v s . c C s t | d�S )N)r) )r& )�msgr r r! �<lambda>� � rD c C s� | j }|d d }|d }|d }t| �jj}| }}|dkrN|| j| 7 }nJx@t||�D ]2\}} | dk r|||d | 7 }qZ||d | 7 }qZW ||7 }||fS )a1 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, dtype='G'); I.dtype dtype('complex192') >>> low, high = np.byte_bounds(I) >>> high - low == I.size*I.itemsize True �datar �strides�shapeNr? )Z__array_interface__r �dtype�itemsize�size�zip) �aZaiZa_dataZastridesZashapeZbytes_aZa_lowZa_highrH Zstrider r r! r � s c C sP | dkrt �� j}|j} g }i }x�| �� D ]�}t| | t�r*| | }t|�}||�� krn|d|| }d}n|||< |}d}d�t t |j ��} t |j �} |� || | |jj|g� q*W d} d} d} d}x�tt|��D ]|}|| }| t|d �k r�t|d �} | t|d �k �rt|d �} | t|d �k �r8t|d �} |d r�|t|d �7 }q�W t|�dk�r�td| �}td| �}td| �}d |d |d |d f }t|d d t|�d d � x�tt|��D ]t}|| }td|d d |t|d � d |d d |t|d � d |d d |t|d � d |d f � �q�W 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 40 int32 b 20 160 float64 Upper bound on total bytes = 200 >>> d = {'x': np.arange(2.0), 'y': np.arange(3.0), 'txt': 'Some str', ... 'idx':5} >>> np.who(d) Name Shape Bytes Type =========================================================== y 3 24 float64 x 2 16 float64 Upper bound on total bytes = 40 Nz (%s)r r? z x r- � � z Name %s Shape %s Bytes %s Type� r, �=� z%s %s %s %s %s %s %s� z' Upper bound on total bytes = %d)�sys� _getframe�f_back� f_globals�keys� isinstancer �idr �map�strrH �nbytes�appendrI r$ �range�len�int�max�print)�vardict�frameZsta�cacher$ �varZidv�namestr�originalZshapestrZbytestrZmaxnameZmaxshapeZmaxbyteZ totalbytes�k�valZsp1Zsp2Zsp3Zprvalr r r! r � s^ , c C s� t | �}|}| }d}|�|�}xp|D ]h}||kr6d} n|} |t |� t | � }||kr�|d t |� }|d d|d | }q$|| | }q$W |S )Nz, � r? z, rP r- )r` �split) r$ � arguments�widthZ firstwidthrj �newstrZsepstr�arglistZargumentZaddstrr r r! � _split_line\ s rr r c C s� t | t� t� g �} | j| ji}| jg}| jg}xvt|�dkr>P |�d�}xX|�� D ]L}t|| t j �rR|| j}||krR|| j}|� |� |� |� |||< qRW q0W ||fS )Nr ) � __import__�globals�localsr" r8 r` rA rX rY �types� ModuleTyper^ )�module�thedictZdictlistZ totraverseZthisdict�x�modnameZmoddictr r r! � _makenamedictt s" r| c C sx 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� |dk�rtd|tj|f |d� d} nH|dk�r2td||f |d� tjdk} n td||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. rl c S s | S )Nr )rz r r r! rD � rE z_info.<locals>.<lambda>� __class__r" zclass: )�filezshape: z strides: z itemsize: z aligned: z contiguous: z fortran: zdata pointer: %s%sz byteorder: rP )�endr~ )�|rQ z%s%s%sF�>z%sbig%s�bigz %slittle%s�littlez byteswap: ztype: %sN)�getattr�typerG rI � byteorderrc rH rJ �flagsZaligned� contiguousZfortran�hex�ctypesZ_as_parameter_�valuerT ) �obj�output�extraZticZbp�cls�nmrG ZendianZbyteswapr r r! �_info� s8 r� �L c C sb ddl }ddl}t| d�s$t| d�r,| j} nt| d�r<| j} | dkrPtt� �nt| t�rjt| |d� �n�t| t ��rTt dkr�t |�\a a d}g }x�t D ]�}ylt | | } t | �|kr�td| |d� n6|�t | �� td | |d� t| � td | |d� |d 7 }W q� tk �r Y q�X q�W |dk�r@td | |d� ntd | |d� �n |�| ��r�| j} tt| �� } t| | �|k�r�t| | |�} n| | } td| d |d� t|�| �|d� �n�|�| ��rP| j} d} yZt| d��r2tt| jj�� } | �d�} t| �d k�r2d| d | d < d� | d d� �} W n Y nX t| | �|k�rbt| | |�} n| | } td| d |d� |�| �}|dk�r�t| d��r�t|�| j�|d� nt|�| �|d� |� | �}|g k�r^td|d� xd|D ]\}|d dk�r�q�t | |d�}|dk �r2|� |�|��p*d�\}}td||f |d� �q�W �nt j!d dk �r�t| t"j#��r�td| j$j|d� t|d� t| d��r|tt| j%j�� } | �d�} t| �d k�r�d| d | d < d� | d d� �} nd} t| d��r�d | j& } nd } t| | �|k�r"t| | |�} n| | } td| d |d� |�| j%�}|dk �rht|�| j%�|d� t|�| �|d� nt|�| �|d� n�|�'| ��r@| j} tt| j�� } | �d�} t| �d k�r�d| d | d < d� | d d� �} nd} t| | �|k�rt| | |�} n| | } td| d |d� t|�| �|d� n t| d ��r^t|�| �|d� 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 NZ_ppimport_importer�_ppimport_module�_ppimport_attr)r� z+ *** Repeat reference found in %s *** )r~ z *** Found in %s ***�-r? zHelp for %s not found.z+ *** Total of %d references found. ***rP r, z()r+ z, �(z Methods: �_�Nonez %s -- %srS zInstance of class: r< r$ z%sz<name>r7 )(�pydoc�inspect�hasattrr� r� r rY r r� r\ � _namedictr| � _dictlistrZ rc r^ �KeyError� isfunctionr" r r r` rr �getdoc�isclassr+ �__func__rm r Z allmethodsr� ZsplitdocrT � version_inforv Z InstanceTyper} r< r$ �ismethod)�objectZmaxwidthr� Ztoplevelr� r� ZnumfoundZobjlistrh r� r$ rn �argstrrq Zdoc1�methods�methZthisobjZmethstr�otherr; r r r! r � s� 3 c C sR ddl }y,td|�| � |d� t|�| �|d� W n td|d� Y nX dS )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� rc � getsourcefile� getsource)r� r� r� r r r! r � s (z[a-z0-9_]+\(.*[,=].*\)TFc s� ddl }t|||�� g }t| ��� �� ��s0dS xZ� �� D ]N\}\}} } | dkrRq:d} |�� } x�D ]} | | krdd} P qdW | r:|�|� q:W ddddd����fd d ��� �fd d �}|j|d � dd��� }|dt |� g}x�|ddd� D ]�}� | \} } }dd� | � � �d�D �}y(|d � � }t � |��r@|d � � }W n t k �r\ d}Y nX |�d||f � q�W |�s�|�d� |dk �r�|�d�|�� n4t |�dk�r�|�� }|d�|�� ntd�|�� dS )a� Do a keyword search on docstrings. A list of 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') 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)rx r� TFi� i���)r# �classrx 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, rS c s g | ]}|� krd �qS )�� r )�.0�w)� first_docr r! � <listcomp> s z.lookfor.<locals>.relevance.<locals>.<listcomp>c s g | ]}|� krd �qS )� r )r� r� )r$ r r! r� s rR i����.rO �d i����) r �lower�striprm �sumr` �get�countrb )r$ Zdocstr�kind�index�r)�kind_relevance�whats)r� r$ r! � relevance s zlookfor.<locals>.relevancec s �| f� | �� S )Nr )rM )rf r� r r! �relevance_value s z lookfor.<locals>.relevance_value)�keyzSearch results for '%s'rP r� ���c S s g | ]}|� � r|� � �qS r )r� )r� �liner r r! r� ) s zlookfor.<locals>.<listcomp>r, r? rl z %s %szNothing found.rO )r� �_lookfor_generate_cacher\ r� rm �itemsr^ �sortr r` r� �_function_signature_re�search� IndexError�writeZgetpagerrc )�whatrx �import_modules� regenerater� r� �foundr$ � docstringr� r� �okr; r� r� �sZ help_textZixZdoclinesr� Zpagerr )rf r� r� r� r! r � sT . c C s� ddl }tjd dkr$ddlm} n ddlm} | dkr<d} t| t�rty t| � W n tk rf i S X tj | } n<t| t �s�t| t �r�i }x | D ]}|� t |||�� q�W |S t| �tkr�|s�tt| � S i }|tt| �< i }d}| j| fg} �x�| �r�| �d�\} } t| �|k�rq�d|t| �< |d7 }d} |�| ��rLd } y | j} W n tk �rd d} Y nX |�rlt| d ��rlx�| jD ]�}x�t�|�D ]�}tj�||�}tj�||d �}tj�|��r�|� d ��r�|dd � }ntj�|��r�|}n�q�|dk�r �q�yDtj }tj }z$|� t_ |� t_ td| |f � W d|t_ |t_ X W n t k �r^ �w�Y nX �q�W �q�W x�t | �D ]�\}}y$t!|dd| |f �}t!|dd�}W n& t"k �r� d| |f }d}Y nX d|k�r�|�r�d||f }|�#| d ��s t|t$��rvn�qvn$|�|��s.| dk�s.|| k�s.�qv| �%d| |f |f� �qvW nP|�&| ��r�d} x>t | �D ] \}}| �%d| |f |f� �qfW nt| d��r�d} y|�'| �}W n t"k �r� d}Y nX |dk r�|| |f|| < q�W |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 NrS )�StringIOr Tr? r� rx �__path__z __init__.pyz.py���r+ z%s.%sr" r= r� r� r< r# )(r� rT r� �ior� rY r\ rs � ImportError�modules�list�tupler9 r� rZ �_lookfor_cachesr" rA �ismodule�__all__r6 r� r� r �listdirr r �isfile�endswith�stdout�stderr� BaseException� _getmembersr� � NameError� startswithr r^ r� r� )rx r� r� r� r� rf �mod�seenr� �stackr$ �itemr� Z_all�pthZmod_pathZthis_py�init_pyZ to_importZ old_stdoutZ old_stderr�n�vZ item_name�mod_namer; r r r! r� A s� r� c sF dd l }y|�� �}W n* tk r@ � fdd�t� �D �}Y nX |S )Nr c s$ g | ] }t � |�r|t� |�f�qS r )r� r� )r� rz )r� r r! r� � s z _getmembers.<locals>.<listcomp>)r� � getmembers� Exception�dir)r� r� �membersr )r� r! r� � s r� c @ sx e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd S ) �SafeEvalz� Object to evaluate constant string expressions. This includes strings with lists, dicts and tuples using the abstract syntax tree created by ``compiler.parse``. .. deprecated:: 1.10.0 See Also -------- safe_eval c C s t jdtdd� d S )Nz3SafeEval is deprecated in 1.10 and will be removed.r- )r. )r4 r/ r0 )r* r r r! r+ � s zSafeEval.__init__c C s" |j }t| d|j | j�}||�S )N�visit)r} r� r" �default)r* �noder� r� r r r! r� � s zSafeEval.visitc C s t d|j ��d S )Nz Unsupported source construct: %s)� SyntaxErrorr} )r* r� r r r! r� � s zSafeEval.defaultc C s | � |j�S )N)r� �body)r* r� r r r! �visitExpression s zSafeEval.visitExpressionc C s |j S )N)r� )r* r� r r r! �visitNum s zSafeEval.visitNumc C s |j S )N)r� )r* r� r r r! �visitStr s zSafeEval.visitStrc C s |j S )N)r� )r* r� r r r! � visitBytes s zSafeEval.visitBytesc s t � fdd�t|j|j�D ��S )Nc s$ g | ] \}}� � |�� � |�f�qS r )r� )r� rj r� )r* r r! r� s z&SafeEval.visitDict.<locals>.<listcomp>)�dictrL rX �values)r* r� �kwr )r* r! � visitDict s zSafeEval.visitDictc s t � fdd�|jD ��S )Nc s g | ]}� � |��qS r )r� )r� �i)r* r r! r� s z'SafeEval.visitTuple.<locals>.<listcomp>)r� �elts)r* r� r )r* r! � visitTuple s zSafeEval.visitTuplec s � fdd�|j D �S )Nc s g | ]}� � |��qS r )r� )r� r )r* r r! r� s z&SafeEval.visitList.<locals>.<listcomp>)r )r* r� r )r* r! � visitList s zSafeEval.visitListc C sR dd l }t|j|j�r$| �|j� S t|j|j�r@| �|j� S td|j ��d S )Nr zUnknown unary op: %r)�astrY �op�UAddr� �operand�USubr� )r* r� r r r r! � visitUnaryOp s zSafeEval.visitUnaryOpc C s< |j dkrdS |j dkr dS |j dkr*d S td|j ��d S )N�FalseF�TrueTr� zUnknown name: %s)rZ r� )r* r� r r r! � visitName s zSafeEval.visitNamec C s |j S )N)r� )r* r� r r r! �visitNameConstant* s zSafeEval.visitNameConstantN)r" r= r> r7 r+ r� r� r� r� r� r� r r r r r r r r r 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): ... SyntaxError: Unsupported source construct: compiler.ast.CallFunc r N)r � literal_eval)r r r r r! r . s ,c C s� | j dkr|S t�| || j�} t�| d �}tj�|�rB|�d�}|jdkr�|dkr�tj dt dd� |dk r�| j � tj �|d < |}q�| j � tj �}n>t�|�� �dkr�tj d d t�|�� � t dd� tj ||< |S ) aj 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, sequence of int, None}, optional Axis or axes 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� FTz#Invalid value encountered in medianrS )r. N.z'Invalid value encountered in median forz %d results)rK �npZrollaxis�ndim�isnan�maZ isMaskedArrayZfilledr4 r/ �RuntimeWarningrI r� �nanZ count_nonzeroZravel)rF �resultZaxis�outr� r r r! �_median_nancheck_ s( r )N)r )NTFN)1� __future__r r r r rT rv �rer4 Znumpy.core.numerictypesr r r r r r r r r � numpy.compatr r r� r r% r� r& r r r r rr r� r� r| r� r� r r r� �compile�Ir� r r� r� r� r r r r r r! �<module> sJ ==9 i 3 N3 I1