numpy.stack#
- numpy.stack(arrays, axis=0, out=None, *, dtype=None, casting='same_kind')[源代码]#
沿新轴连接一系列数组.
axis参数指定结果维度中新轴的索引.例如,如果axis=0,它将是第一个维度,如果axis=-1,它将是最后一个维度.- 参数:
- arraysndarray 序列
每个数组必须具有相同的形状.对于单个ndarray array_like输入,它将被视为数组序列;即,沿第零个轴的每个元素都被视为一个单独的数组.
- axis整数,可选
结果数组中输入数组堆叠的轴.
- outndarray, 可选
如果提供,则为放置结果的目标位置.形状必须正确,与未指定 out 参数时 stack 将返回的形状相匹配.
- dtypestr or dtype
如果提供,则目标数组将具有此 dtype.不能与 out 一起提供.
在 1.24 版本加入.
- casting{‘no’, ‘equiv’, ‘safe’, ‘same_kind’, ‘unsafe’}, 可选
控制可能发生的数据类型转换种类.默认为 ‘same_kind’.
在 1.24 版本加入.
- 返回:
- stackedndarray
堆叠数组比输入数组多一个维度.
参见
concatenate沿现有轴连接一系列数组.
block从嵌套的块列表中组装一个 nd-array.
split将数组分割成一个等大小的子数组列表.
unstack沿轴将数组分割成子数组的元组.
示例
>>> import numpy as np >>> rng = np.random.default_rng() >>> arrays = [rng.normal(size=(3,4)) for _ in range(10)] >>> np.stack(arrays, axis=0).shape (10, 3, 4)
>>> np.stack(arrays, axis=1).shape (3, 10, 4)
>>> np.stack(arrays, axis=2).shape (3, 4, 10)
>>> a = np.array([1, 2, 3]) >>> b = np.array([4, 5, 6]) >>> np.stack((a, b)) array([[1, 2, 3], [4, 5, 6]])
>>> np.stack((a, b), axis=-1) array([[1, 4], [2, 5], [3, 6]])