numpy.rollaxis

numpy.rollaxis(a, axis, start=0) [source]

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

Эта функция продолжает поддерживаться для обратной совместимости, но вы должны предпочитать moveaxis. Функция moveaxis была добавлена в NumPy 1.11.

Параметры

andarray

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

axisint

Ось, подлежащая повороту. Позиции других осей не изменяются относительно друг друга.

startint, optional

Когда start <= axis, ось поворачивается назад до тех пор, пока она не окажется в этой позиции. Когда start > axis, ось поворачивается до тех пор, пока она не окажется перед этой позицией. По умолчанию, 0, приводит к «полному» повороту. В следующей таблице описано, как интерпретируются отрицательные значения start.

start	Нормализованная start
-(arr.ndim+1)	вызвать AxisError
-arr.ndim	0
⋮	⋮
-1	arr.ndim-1
0	0
⋮	⋮
arr.ndim	arr.ndim
arr.ndim + 1	вызвать AxisError

Возвращает

resndarray

Для NumPy >= 1.10.0 всегда возвращается представление a. Для более ранних версий NumPy представление a возвращается только в том случае, если порядок осей изменен, в противном случае возвращается входной массив.

См. также

moveaxis

Перемещение осей массива в новые позиции.

roll

Поворот элементов массива на определенное количество позиций вдоль заданной оси.

Примеры

>>> a = np.ones((3,4,5,6))
>>> np.rollaxis(a, 3, 1).shape
(3, 6, 4, 5)
>>> np.rollaxis(a, 2).shape
(5, 3, 4, 6)
>>> np.rollaxis(a, 1, 4).shape
(3, 5, 6, 4)