numpy.roll
numpy.roll(a, shift, axis=None) [source]
沿给定轴滚动数组元素。
超出最后位置的元素将在第一个位置重新引入。
参数 ： | a ：array_like 输入数组。 shift ：int 或 int类型的tuple 元素移位的位置数。如果是一个元组， 那么轴必须是一个相同大小的元组， 并且每个给定的轴被相应的数字移动。如果值是int 当axis是int类型的tuple， 那么对所有给定的轴使用相同的值。 axis ：int 或 int类型的tuple, 可选 元素沿其移动的一个或多个轴。 默认情况下， 在移动之前将阵列弄平，然后恢复原始形状。 |
返回值 ： | res ：ndarray 输出数组，shape与a相同。 |
Notes
1.12.0版中的新功能。
支持同时滚动多个维度。
例子
>>> x = np.arange(10)>>> np.roll(x, 2)array([8, 9, 0, 1, 2, 3, 4, 5, 6, 7])>>> np.roll(x, -2)array([2, 3, 4, 5, 6, 7, 8, 9, 0, 1])
>>> x2 = np.reshape(x, (2,5))>>> x2array([[0, 1, 2, 3, 4], [5, 6, 7, 8, 9]])>>> np.roll(x2, 1)array([[9, 0, 1, 2, 3], [4, 5, 6, 7, 8]])>>> np.roll(x2, -1)array([[1, 2, 3, 4, 5], [6, 7, 8, 9, 0]])>>> np.roll(x2, 1, axis=0)array([[5, 6, 7, 8, 9], [0, 1, 2, 3, 4]])>>> np.roll(x2, -1, axis=0)array([[5, 6, 7, 8, 9], [0, 1, 2, 3, 4]])>>> np.roll(x2, 1, axis=1)array([[4, 0, 1, 2, 3], [9, 5, 6, 7, 8]])>>> np.roll(x2, -1, axis=1)array([[1, 2, 3, 4, 0], [6, 7, 8, 9, 5]])