mxnet.np.concatenate

concatenate(seq, axis=0, out=None)

Join a sequence of arrays along an existing axis.

Parameters
  • a2, .. (a1,) – The arrays must have the same shape, except in the dimension corresponding to axis (the first, by default).

  • axis (int, optional) – The axis along which the arrays will be joined. If axis is None, arrays are flattened before use. Default is 0.

  • out (ndarray, optional) – If provided, the destination to place the result. The shape must be correct, matching that of what concatenate would have returned if no out argument were specified.

Returns

res – The concatenated array.

Return type

ndarray

See also

split()

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

hsplit()

Split array into multiple sub-arrays horizontally (column wise)

vsplit()

Split array into multiple sub-arrays vertically (row wise)

dsplit()

Split array into multiple sub-arrays along the 3rd axis (depth).

stack()

Stack a sequence of arrays along a new axis.

hstack()

Stack arrays in sequence horizontally (column wise)

vstack()

Stack arrays in sequence vertically (row wise)

dstack()

Stack arrays in sequence depth wise (along third dimension)

Examples

>>> a = np.array([[1, 2], [3, 4]])
>>> b = np.array([[5, 6]])
>>> np.concatenate((a, b), axis=0)
array([[1., 2.],
       [3., 4.],
       [5., 6.]])
>>> np.concatenate((a, b.T), axis=1)
array([[1., 2., 5.],
       [3., 4., 6.]])
>>> np.concatenate((a, b), axis=None)
array([1., 2., 3., 4., 5., 6.])