numpy.ma.stack

ma.stack = <numpy.ma.extras._fromnxfunction_seq object>

沿着新轴连接一系列数组。

axis 参数指定结果维度中新轴的索引。例如，如果 axis=0，它将是第一维，如果 axis=-1，它将是最后一维。

参数：

arraysndarray 序列

每个数组必须具有相同的形状。对于单个 ndarray array_like 输入，它将被视为数组序列；即，沿第零轴的每个元素都被视为一个单独的数组。

axisint，可选

结果数组中沿其堆叠输入数组的轴。

outndarray，可选

如果提供，则为放置结果的目标位置。形状必须正确，与如果没有指定 out 参数则 stack 将返回的形状匹配。

dtypestr 或 dtype

如果提供，则目标数组将具有此 dtype。不能与out一起提供。

版本 1.24 中的新功能。

casting{'no', 'equiv', 'safe', 'same_kind', 'unsafe'}，可选

控制可以发生哪种数据转换。默认为 'same_kind'。

版本 1.24 中的新功能。

返回：

stackedndarray

堆叠后的数组比输入数组多一维。

另请参阅

concatenate

沿着现有轴连接一系列数组。

block

从嵌套的块列表组装一个 nd 数组。

split

将数组拆分为多个大小相等的子数组列表。

unstack

沿着轴将数组拆分为子数组元组。

备注

该函数同时应用于 _data 和 _mask（如果有）。

示例

>>> 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]])