SciPy

numpy.ma.dstack

numpy.ma.dstack(tup) = <numpy.ma.extras._fromnxfunction instance at 0x2112d40>

Stack arrays in sequence depth wise (along third axis).

Takes a sequence of arrays and stack them along the third axis to make a single array. Rebuilds arrays divided by dsplit. This is a simple way to stack 2D arrays (images) into a single 3D array for processing.

Parameters :

tup : sequence of arrays

Arrays to stack. All of them must have the same shape along all but the third axis.

Returns :

stacked : ndarray

The array formed by stacking the given arrays.

See also

vstack
Stack along first axis.
hstack
Stack along second axis.
concatenate
Join arrays.
dsplit
Split array along third axis.

Notes

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

Examples

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

Previous topic

numpy.ma.concatenate

Next topic

numpy.ma.hstack