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)