dpnp.flip

dpnp.flip(m, axis=None)[source]

Reverse the order of elements in an array along the given axis.

The shape of the array is preserved, but the elements are reordered.

For full documentation refer to numpy.flip.

Parameters:

m ({dpnp.ndarray, usm_ndarray}) -- Input array.
axis (None or int or tuple of ints, optional) -- Axis or axes along which to flip over. The default, axis=None, will flip over all of the axes of the input array. If axis is negative it counts from the last to the first axis. If axis is a tuple of integers, flipping is performed on all of the axes specified in the tuple.

Returns:

out -- A view of m with the entries of axis reversed.

Return type:

dpnp.ndarray

See also

dpnp.flipud: Flip an array vertically (axis=0).
dpnp.fliplr: Flip an array horizontally (axis=1).

Examples

>>> import dpnp as np
>>> A = np.arange(8).reshape((2, 2, 2))
>>> A
array([[[0, 1],
        [2, 3]],
       [[4, 5],
        [6, 7]]])
>>> np.flip(A, 0)
array([[[4, 5],
        [6, 7]],
       [[0, 1],
        [2, 3]]])
>>> np.flip(A, 1)
array([[[2, 3],
        [0, 1]],
       [[6, 7],
        [4, 5]]])
>>> np.flip(A)
array([[[7, 6],
        [5, 4]],
       [[3, 2],
        [1, 0]]])
>>> np.flip(A, (0, 2))
array([[[5, 4],
        [7, 6]],
       [[1, 0],
        [3, 2]]])
>>> A = np.random.randn(3, 4, 5)
>>> np.all(np.flip(A, 2) == A[:, :, ::-1, ...])
array(True)