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)