numpy.rollaxis

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

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

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

Параметры

andarray

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

axisint

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

startint, необязательно

Когда 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)