numpy.ma.stack¶

numpy.ma.stack(arrays,axis=0,out=None) = <numpy.ma.extras._fromnxfunction_seq object>¶

Join a sequence of arrays along a new axis.

Theaxis parameter specifies the index of the new axis in the dimensionsof the result. For example, ifaxis=0 it will be the first dimensionand ifaxis=-1 it will be the last dimension.

New in version 1.10.0.

Parameters:	arrays:sequence of array_like Each array must have the same shape. axis:int, optional The axis in the result array along which the input arrays are stacked. out:ndarray, optional If provided, the destination to place the result. The shape must becorrect, matching that of what stack would have returned if noout argument were specified.
Returns:	stacked:ndarray The stacked array has one more dimension than the input arrays.

See also

concatenate

Join a sequence of arrays along an existing axis.

split

Split array into a list of multiple sub-arrays of equal size.

block

Assemble arrays from blocks.

Notes

The function is applied to both the _data and the _mask, if any.

Examples

>>>arrays=[np.random.randn(3,4)for_inrange(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([2,3,4])>>>np.stack((a,b))array([[1, 2, 3],       [2, 3, 4]])

>>>np.stack((a,b),axis=-1)array([[1, 2],       [2, 3],       [3, 4]])