|
Server : Apache System : Linux server112.speedpacket.com 3.10.0-962.3.2.lve1.5.36.el7.x86_64 #1 SMP Mon May 18 02:16:06 EDT 2020 x86_64 User : equistyl ( 1341) PHP Version : 8.1.30 Disable Function : NONE Directory : /lib64/python2.7/site-packages/numpy/ |
Upload File : |
�
E�`Qc @ s� d Z d d d d d d d g Z d d l Z d d l Z d d
l m Z m Z m Z m Z m
Z
d d l m Z m
Z
y d d l Z Wn e k
r� d Z n Xe d k r� d � Z e Z e Z e Z e Z d d
l m Z e Z nE d d l j j Z e j � Z [ e j Z d � Z e e d d � Z d � Z d d d d d d g Z! d � Z" d e f d � � YZ# i Z$ d d d d d � Z% e d k r�e Z& i Z' d � Z( e& j) e& j* e& j+ e& j, e& j- f d f e& j. e& j/ e& j0 e& j1 e& j2 f d f e& j3 e& j4 f d f g Z5 xE e5 D]= \ Z6 Z7 x. e6 D]& Z8 e( e8 d e7 e& j9 e8 � f � q+WqWe: e& j+ d � Z; d � Z< d! � Z= d d" � Z d# � Z n d S($ s
============================
``ctypes`` Utility Functions
============================
See Also
---------
load_library : Load a C library.
ndpointer : Array restype/argtype with verification.
as_ctypes : Create a ctypes array from an ndarray.
as_array : Create an ndarray from a ctypes array.
References
----------
.. [1] "SciPy Cookbook: ctypes", http://www.scipy.org/Cookbook/Ctypes
Examples
--------
Load the C library:
>>> _lib = np.ctypeslib.load_library('libmystuff', '.') #doctest: +SKIP
Our result type, an ndarray that must be of type double, be 1-dimensional
and is C-contiguous in memory:
>>> array_1d_double = np.ctypeslib.ndpointer(
... dtype=np.double,
... ndim=1, flags='CONTIGUOUS') #doctest: +SKIP
Our C-function typically takes an array and updates its values
in-place. For example::
void foo_func(double* x, int length)
{
int i;
for (i = 0; i < length; i++) {
x[i] = i*i;
}
}
We wrap it using:
>>> lib.foo_func.restype = None #doctest: +SKIP
>>> lib.foo.argtypes = [array_1d_double, c_int] #doctest: +SKIP
Then, we're ready to call ``foo_func``:
>>> out = np.empty(15, dtype=np.double)
>>> _lib.foo_func(out, len(out)) #doctest: +SKIP
t load_libraryt ndpointert testt ctypes_load_libraryt c_intpt as_ctypest as_arrayi����N( t integert ndarrayt dtypet deprecatet array( t _flagdictt flagsobjc O s t d � � d S( s�
Dummy object that raises an ImportError if ctypes is not available.
Raises
------
ImportError
If ctypes is not available.
s ctypes is not available.N( t ImportError( t argst kwds( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt _dummyA s
( t intpc
C s� t j d k r+ d d l } | j d � n t j j | � d } | sd d l m } | � } | | g } t j
d d k r� | d t � } | | k s� | j d | | � q� n t j
d
k r� | j d d | � q
t j
d k r
| j d d
| � q
n | g } t j j | � } t j j | � sFt j j | � } n | } d } xN | D]F }
y$ t j j | |
� } t j | SWqYt k
r�} | } qYXqYW| � d S( Ns 1.0.1i����sA All features of ctypes interface may not work with ctypes < 1.0.1i ( t get_shared_lib_extensioni s 3.2t
is_python_exti t win32s %s.dllt darwins %s.dylib( t ctypest __version__t warningst warnt ost patht splitextt numpy.distutils.misc_utilR t syst versiont Truet insertt platformt abspatht isdirt dirnamet Nonet joint cdllt OSError(
t libnamet loader_pathR t extR t so_extt libname_extt so_ext2t libdirt exct lnt libpatht e( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyR Y s:
c C s) d } x | D] } | t | 7} q
W| S( Ni ( R ( t flaglistt numt val( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt _num_fromflags� s
t C_CONTIGUOUSt F_CONTIGUOUSt ALIGNEDt WRITEABLEt OWNDATAt UPDATEIFCOPYc C s? g } x2 t D]* } t | } | | @r
| j | � q
q
W| S( N( t
_flagnamesR t append( R7 t rest keyt value( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt _flags_fromnum� s
t _ndptrc B s/ e Z d � Z e d � � Z e d � � Z RS( c C s
t | � S( s� This method is called when this class is used as the .restype
asttribute for a shared-library function. It constructs a numpy
array from a void pointer.( R ( t self( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt _check_retval_� s c C sU i | j j d 6| d 6d d 6| j d 6d d 6| j j d d d 6| j t f d
6S( Nt descrt __reft stridest shapei R i i t typestrt data( t _dtype_RI R' t _shape_RD t False( RG ( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt __array_interface__� s
c C s t | t � s t d � � n | j d k rU | j | j k rU t d | j � � n | j d k r� | j | j k r� t d | j � � n | j d k r� | j | j k r� t d t
| j � � � n | j d k r| j j
| j @| j k rt d t | j � � � n | j S( Ns argument must be an ndarrays array must have data type %ss array must have %d dimension(s)s array must have shape %ss array must have flags %s( t
isinstanceR t TypeErrorRO R' R t _ndim_t ndimRP RL t strt _flags_t flagsR7 RE R ( t clst obj( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt
from_param� s ( t __name__t
__module__RH t propertyRR t classmethodR\ ( ( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyRF � s c C sq | d k r t | � } n d } | d k r� t | t � rN | j d � } nQ t | t t f � rx | } t | � } n' t | t � r� | j } t | � } n | d k r� y) g | D] } | j
� j � ^ q� } Wn t d � � n Xt
| � } q� n y t | | | | f SWn t k
r'n X| d k r=d } n' | j r[t t | � � } n | j } | d k r�| d | 7} n | d k ry# g | D] } t | � ^ q�} Wn) t k
r�t | � g } | f } n Xt | � } | d d j | � 7} n | d k r(| d d j | � 7} n g } t d | t f i | d 6| d 6| d
6| d 6� } | t | <| S(
sC
Array-checking restype/argtypes.
An ndpointer instance is used to describe an ndarray in restypes
and argtypes specifications. This approach is more flexible than
using, for example, ``POINTER(c_double)``, since several restrictions
can be specified, which are verified upon calling the ctypes function.
These include data type, number of dimensions, shape and flags. If a
given array does not satisfy the specified restrictions,
a ``TypeError`` is raised.
Parameters
----------
dtype : data-type, optional
Array data-type.
ndim : int, optional
Number of array dimensions.
shape : tuple of ints, optional
Array shape.
flags : str or tuple of str
Array flags; may be one or more of:
- C_CONTIGUOUS / C / CONTIGUOUS
- F_CONTIGUOUS / F / FORTRAN
- OWNDATA / O
- WRITEABLE / W
- ALIGNED / A
- UPDATEIFCOPY / U
Returns
-------
klass : ndpointer type object
A type object, which is an ``_ndtpr`` instance containing
dtype, ndim, shape and flags information.
Raises
------
TypeError
If a given array does not satisfy the specified restrictions.
Examples
--------
>>> clib.somefunc.argtypes = [np.ctypeslib.ndpointer(dtype=np.float64,
... ndim=1,
... flags='C_CONTIGUOUS')]
... #doctest: +SKIP
>>> clib.somefunc(np.array([1, 2, 3], dtype=np.float64))
... #doctest: +SKIP
t ,s invalid flags specificationt anys _%ddt _t xs ndpointer_%sRO RP RU RX N( R' t _dtypeRS RW t splitt intR RE R
R7 t stript upperRT R9 t _pointer_type_cachet KeyErrort namest idt tupleR( t typeRF ( R RV RL RY R7 Rd t namet strshapet klass( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyR � s^ 4 )
#
c s^ y | j Wn t k
r n Xd St | � j � | t � <� f d � } t | � | _ d S( s� Given a ctypes simple type, construct and attach an
__array_interface__ property to it if it does not yet have one.
Nc sM i d � f g d 6| d 6d d 6d
d 6d d 6� d 6t j | � t f d 6S( Nt RI RJ RK RL i R RM RN ( ( R' t ctt addressofRQ ( RG ( RM ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyRR = s ( RR t AttributeErrorRe RW t
_typecodesR_ ( t simple_typeR RR ( ( RM s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt prep_simple2 s
t it ut fs %c%di c s� y | j Wn t k
r n Xd Sg � | } x/ t | � t k r` � j | j � | j } q2 Wt � � � | � j } | d � | d � � � � f d � } t | � | _ d S( s� Given a ctypes array type, construct and attach an
__array_interface__ property to it if it does not yet have one.
NRI RM c sD i � d 6| d 6d d 6� d 6d d 6� d 6t j | � t f d 6S( NRI RJ RK RL i R RM RN ( R' Rt Ru RQ ( RG ( RI RL RM ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyRR k s
( RR Rv Ro t _ARRAY_TYPERA t _length_t _type_Rn R_ ( t
array_typet obt aiRR ( ( RI RL RM s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt
prep_arrayY s
c C s y | j Wn t k
r n Xd S| j } t t | � � } i d d 6| j d 6t j | � t f d 6| d 6} | | _ d S( s� Given a ctypes pointer object, construct and
attach an __array_interface__ property to it if it does not
yet have one.
Ni R RM RN RL ( RR Rv t contentsRe Ro RW Rt Ru RQ ( t pointer_objRL R� R t inter( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt prep_pointerw s
c C sd t | � } y | j Wn: t k
rS t | d � rF t | | � qT t | � n Xt | d t �S( s Create a numpy array from a ctypes array or a ctypes POINTER.
The numpy array shares the memory with the ctypes object.
The size parameter must be given if converting from a ctypes POINTER.
The size parameter is ignored if converting from a ctypes array
R� t copy( Ro RR Rv t hasattrR� R� R RQ ( R[ RL t tp( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyR � s
c C s� | j } | d r" t d � � n | d d k rA t d � � n | d \ } } | rf t d � � n t | d } x) | d d
d
d � D] } | | } q� W| j | � } | | _ | S( s� Create and return a ctypes object from a numpy array. Actually
anything that exposes the __array_interface__ is accepted.RK s strided arrays not supportedR i s, only __array_interface__ version 3 supportedRN s readonly arrays unsupportedRM RL Ni����( RR RT Rw t from_addresst __keep( R[ R� t addrt readonlyR� t dimt result( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyR � s
(> t __doc__t __all__R R t numpyR R R Re R
R t numpy.core.multiarrayR R
R R R' R R R R R R R t objectt _ndptr_baset numpy.core._internalt coret _internalt nict _getintp_ctypet c_void_pR9 R@ RE RF Rj R Rt Rw Ry t c_bytet c_shortt c_intt c_longt
c_longlongt c_ubytet c_ushortt c_uintt c_ulongt c_ulonglongt c_floatt c_doublet simple_typest typest codeR� t sizeofRo R} R� R� ( ( ( s5 /usr/lib64/python2.7/site-packages/numpy/ctypeslib.pyt <module>3 s\ (
, )f ''
(