numpy.rollaxis#

numpy.rollaxis(a, axis, start=0)[源代码]#

将指定的轴向后滚动,直到它位于给定的位置.

此函数继续支持向后兼容,但您应优先使用 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: 沿给定轴将数组元素滚动一定数量的位置.

示例

>>> import numpy as np
>>> 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)