numpy.concatenate

numpy.concatenate((a1, a2, ...), axis=0, out=None)

沿现有轴加入一系列阵列。

Parameters:
a1, a2, … : sequence of array_like
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. 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 : ndarray
The concatenated array.

Notes:
当要连接的一个或多个数组是MaskedArray时，此函数将返回一个MaskedArray对象而不是ndarray，但输入掩码不会保留。 在需要使用MaskedArray作为输入的情况下，请改用masked array模块中的ma.concatenate函数。

Examples

import numpy as np
>>> 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]])
a = np.ma.arange(3)
>>> a
masked_array(data = [0 1 2],
             mask = False,
       fill_value = 999999)

This function will not preserve masking of MaskedArray inputs.

>>> a[1] = np.ma.masked
>>> a
masked_array(data = [0 -- 2],
             mask = [False  True False],
       fill_value = 999999)

>>> b = np.arange(2, 5)
>>> b
array([2, 3, 4])
>>> np.concatenate([a, b])
masked_array(data = [0 1 2 2 3 4],
             mask = False,
       fill_value = 999999)

>>> np.ma.concatenate([a, b])
masked_array(data = [0 -- 2 2 3 4],
             mask = [False  True False False False False],
       fill_value = 999999)