;>"^Aã@s©dZddlmZmZmZddlZddlmZdgZ dd„Z dd „Z d d „Z d d „Z dd„Zdd„ZGdd„deƒZdS)zEMixin classes for custom array types that don't inherit from ndarray.é)ÚdivisionÚabsolute_importÚprint_functionN)ÚumathÚNDArrayOperatorsMixinc Cs.y|jdkSWntk r)dSYnXdS)z)True when __array_ufunc__ is set to None.NF)Z__array_ufunc__ÚAttributeError)Úobj©r úB/home/birch/.local/lib/python3.5/site-packages/numpy/lib/mixins.pyÚ_disables_array_ufunc s r cs(‡fdd†}dj|ƒ|_|S)z>Implement a forward binary method with a ufunc, e.g., __add__.cst|ƒrtSˆ||ƒS)N)r ÚNotImplemented)ÚselfÚother)Úufuncr r Úfuncs z_binary_method..funcz__{}__)ÚformatÚ__name__)rÚnamerr )rr Ú_binary_methodsrcs(‡fdd†}dj|ƒ|_|S)zAImplement a reflected binary method with a ufunc, e.g., __radd__.cst|ƒrtSˆ||ƒS)N)r r )r r)rr r r s z&_reflected_binary_method..funcz__r{}__)rr)rrrr )rr Ú_reflected_binary_methodsrcs(‡fdd†}dj|ƒ|_|S)zAImplement an in-place binary method with a ufunc, e.g., __iadd__.csˆ||d|fƒS)NÚoutr )r r)rr r r*sz$_inplace_binary_method..funcz__i{}__)rr)rrrr )rr Ú_inplace_binary_method(srcCs(t||ƒt||ƒt||ƒfS)zEImplement forward, reflected and inplace binary methods with a ufunc.)rrr)rrr r r Ú_numeric_methods0s  rcs(‡fdd†}dj|ƒ|_|S)z.Implement a unary special method with a ufunc.cs ˆ|ƒS)Nr )r )rr r r9sz_unary_method..funcz__{}__)rr)rrrr )rr Ú _unary_method7src@szeZdZdZeejdƒZeejdƒZ eej dƒZ eej dƒZ eejdƒZeejdƒZeejdƒ\ZZZeejd ƒ\ZZZeejd ƒ\ZZZeejd ƒ\Z Z!Z"e#j$j%d kreej&d ƒ\Z'Z(Z)eej*dƒ\Z+Z,Z-eej.dƒ\Z/Z0Z1eej2dƒ\Z3Z4Z5eej6dƒZ7e8ej6dƒZ9eej:dƒ\Z;Z<Z=eej>dƒ\Z?Z@ZAeejBdƒ\ZCZDZEeejFdƒ\ZGZHZIeejJdƒ\ZKZLZMeejNdƒ\ZOZPZQeRejSdƒZTeRejUdƒZVeRejWdƒZXeRejYdƒZZdS)ra Mixin defining all operator special methods using __array_ufunc__. This class implements the special methods for almost all of Python's builtin operators defined in the `operator` module, including comparisons (``==``, ``>``, etc.) and arithmetic (``+``, ``*``, ``-``, etc.), by deferring to the ``__array_ufunc__`` method, which subclasses must implement. It is useful for writing classes that do not inherit from `numpy.ndarray`, but that should support arithmetic and numpy universal functions like arrays as described in `A Mechanism for Overriding Ufuncs <../../neps/nep-0013-ufunc-overrides.html>`_. As an trivial example, consider this implementation of an ``ArrayLike`` class that simply wraps a NumPy array and ensures that the result of any arithmetic operation is also an ``ArrayLike`` object:: class ArrayLike(np.lib.mixins.NDArrayOperatorsMixin): def __init__(self, value): self.value = np.asarray(value) # One might also consider adding the built-in list type to this # list, to support operations like np.add(array_like, list) _HANDLED_TYPES = (np.ndarray, numbers.Number) def __array_ufunc__(self, ufunc, method, *inputs, **kwargs): out = kwargs.get('out', ()) for x in inputs + out: # Only support operations with instances of _HANDLED_TYPES. # Use ArrayLike instead of type(self) for isinstance to # allow subclasses that don't override __array_ufunc__ to # handle ArrayLike objects. if not isinstance(x, self._HANDLED_TYPES + (ArrayLike,)): return NotImplemented # Defer to the implementation of the ufunc on unwrapped values. inputs = tuple(x.value if isinstance(x, ArrayLike) else x for x in inputs) if out: kwargs['out'] = tuple( x.value if isinstance(x, ArrayLike) else x for x in out) result = getattr(ufunc, method)(*inputs, **kwargs) if type(result) is tuple: # multiple return values return tuple(type(self)(x) for x in result) elif method == 'at': # no return value return None else: # one return value return type(self)(result) def __repr__(self): return '%s(%r)' % (type(self).__name__, self.value) In interactions between ``ArrayLike`` objects and numbers or numpy arrays, the result is always another ``ArrayLike``: >>> x = ArrayLike([1, 2, 3]) >>> x - 1 ArrayLike(array([0, 1, 2])) >>> 1 - x ArrayLike(array([ 0, -1, -2])) >>> np.arange(3) - x ArrayLike(array([-1, -1, -1])) >>> x - np.arange(3) ArrayLike(array([1, 1, 1])) Note that unlike ``numpy.ndarray``, ``ArrayLike`` does not allow operations with arbitrary, unrecognized types. This ensures that interactions with ArrayLike preserve a well-defined casting hierarchy. .. versionadded:: 1.13 ÚltÚleÚeqÚneÚgtÚgeÚaddÚsubÚmulÚmatmuléZdivÚtruedivÚfloordivÚmodÚdivmodÚpowÚlshiftÚrshiftÚandÚxorÚorÚnegÚposÚabsÚinvertN)[rÚ __module__Ú __qualname__Ú__doc__rÚumÚlessÚ__lt__Ú less_equalÚ__le__ÚequalÚ__eq__Ú not_equalÚ__ne__ÚgreaterÚ__gt__Ú greater_equalÚ__ge__rr Ú__add__Ú__radd__Ú__iadd__ÚsubtractÚ__sub__Ú__rsub__Ú__isub__ÚmultiplyÚ__mul__Ú__rmul__Ú__imul__r#Ú __matmul__Ú __rmatmul__Ú __imatmul__ÚsysÚ version_infoÚmajorZdivideZ__div__Z__rdiv__Z__idiv__Ú true_divideÚ __truediv__Ú __rtruediv__Ú __itruediv__Ú floor_divideÚ __floordiv__Ú __rfloordiv__Ú __ifloordiv__Ú remainderÚ__mod__Ú__rmod__Ú__imod__r(Ú __divmod__rÚ __rdivmod__ÚpowerÚ__pow__Ú__rpow__Ú__ipow__Ú left_shiftÚ __lshift__Ú __rlshift__Ú __ilshift__Ú right_shiftÚ __rshift__Ú __rrshift__Ú __irshift__Ú bitwise_andÚ__and__Ú__rand__Ú__iand__Ú bitwise_xorÚ__xor__Ú__rxor__Ú__ixor__Ú bitwise_orÚ__or__Ú__ror__Ú__ior__rÚnegativeÚ__neg__ÚpositiveÚ__pos__ÚabsoluteÚ__abs__r2Ú __invert__r r r r r?sB L)r5Ú __future__rrrrQZ numpy.corerr6Ú__all__r rrrrrÚobjectrr r r r Ús