[GitHub] [incubator-mxnet] mikemwx commented on a change in pull request #15456: [Numpy] numpy compatible invert

[GitBox <gi...@apache.org>]

mikemwx commented on a change in pull request #15456: [Numpy] numpy compatible invert
URL: https://github.com/apache/incubator-mxnet/pull/15456#discussion_r302875177
 
 

 ##########
 File path: python/mxnet/ndarray/numpy/_op.py
 ##########
 @@ -1414,6 +1413,48 @@ def rint(x, out=None, **kwargs):
     """
     return _unary_func_helper(x, _npi.rint, _np.rint, out=out, **kwargs)
 
+def invert(x, out=None, **kwargs):
+    """
+    Compute bit-wise inversion, or bit-wise NOT, element-wise.
+    Computes the bit-wise NOT of the underlying binary representation of
+    the integers in the input arrays. This ufunc implements the C/Python operator ~.
+    For signed integer inputs, the two’s complement is returned.
+    In a two’s-complement system negative numbers are represented
+    by the two’s complement of the absolute value.
+    This is the most common method of representing signed integers on computers [1].
+    A N-bit two’s-complement system can represent every integer in the range -2^{N-1} to +2^{N-1}-1.
+
+    Parameters
+    ----------
+    x : ndarray
+        Only integer and boolean types are handled.
+    out : ndarray or None
+        A location into which the result is stored.
+        If provided, it must have the same shape as the input.
+        If not provided or None, a freshly-allocated array is returned.
+
+    Returns
+    -------
+    out : ndarray
+        Bitwisely inverted elements of the original array.
+
+    Examples
+    --------
+    >>> np.invert(np.array([13], dtype=np.uint8))
+    array([242], dtype=uint8)
+
+    Notes
+    -----
+    This function differs from the original `numpy.invert
+    <https://docs.scipy.org/doc/numpy/reference/generated/numpy.invert.html>`_ in
+    the following way(s):
+
+    - only ndarray or scalar is accpted as valid input, tuple of ndarray is not supported
+    - broadcasting to `out` of different shape is currently not supported
+    - when input is plain python numerics, the result will not be stored in the `out` param
+
+    """
+    return _unary_func_helper(x, _npi.invert, _np.invert, out=out, **kwargs)
 
 Review comment:
   Thank you. Resolved.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services