SciPy

numpy.flip

numpy.flip(m, axis)[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.

New in version 1.12.0.

Parameters:

m : array_like

Input array.

axis : integer

Axis in array, which entries are reversed.

Returns:

out : array_like

A view of m with the entries of axis reversed. Since a view is returned, this operation is done in constant time.

See also

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

Notes

flip(m, 0) is equivalent to flipud(m). flip(m, 1) is equivalent to fliplr(m). flip(m, n) corresponds to m[...,::-1,...] with ::-1 at position n.

Examples

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

Previous topic

numpy.unique

Next topic

numpy.fliplr