numpy.roll#

numpy.roll(a, shift, ось=None)[источник]#

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

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

Параметры:

aarray_like: Входной массив.
shiftint или кортеж ints: Количество позиций, на которые сдвигаются элементы. Если кортеж, то ось должен быть кортежем того же размера, и каждая из заданных осей сдвигается на соответствующее число. Если int, в то время как ось является кортежем целых чисел, то одно и то же значение используется для всех указанных осей.
осьint или кортеж ints, опционально: Ось или оси, вдоль которых сдвигаются элементы. По умолчанию массив сглаживается перед сдвигом, после чего восстанавливается исходная форма.

Возвращает:

resndarray: Выходной массив с той же формой, что и a.

Смотрите также

rollaxis: Прокрутите указанную ось назад, пока она не окажется в заданной позиции.

Примечания

Поддерживает одновременное прокатывание по нескольким измерениям.

Примеры

>>> import numpy as np
>>> 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]])
>>> np.roll(x2, (1, 1), axis=(1, 0))
array([[9, 5, 6, 7, 8],
       [4, 0, 1, 2, 3]])
>>> np.roll(x2, (2, 1), axis=(1, 0))
array([[8, 9, 5, 6, 7],
       [3, 4, 0, 1, 2]])