numpy.roll

numpy.roll(a, shift, axis=None) [source]

Сдвиг элементов массива вдоль заданной оси.

Элементы, которые сдвигаются за пределы последней позиции, вводятся снова в первую.

Параметры

aarray_like

Вводной массив.

shiftint or tuple of ints

Количество позиций, на которое сдвигаются элементы. Если это кортеж, то axis также должен быть кортежем такой же длины, и каждая из заданных осей сдвигается на соответствующее число. Если целое число, а axis — кортеж целых чисел, то одно и то же значение используется для всех заданных осей.

axisint or tuple of ints, optional

Ось или оси, вдоль которых происходит сдвиг элементов. По умолчанию массив сжимается в одномерный, после чего сдвигается, а затем восстанавливается исходная форма.

Возвращает

resndarray

Массив вывода с той же формой, что и a.

См. также

rollaxis

Сдвинуть указанную ось назад до заданной позиции.

Примечания

Введено в версии 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))
>>> x2
array([[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]])