numpy.concatenate

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

Объединить последовательность массивов вдоль существующей оси.

Параметры

a1, a2, …sequence of array_like

Массивы должны иметь одинаковую форму, за исключением измерения, соответствующего axis (первое, по умолчанию).

axisint, optional

Ось, вдоль которой будут объединены массивы. Если ось равна None, массивы сглаживаются перед использованием. По умолчанию 0.

outndarray, optional

Если указано, место назначения для размещения результата. Форма должна быть правильной, соответствующей форме, которую вернул бы concatenate, если бы аргумент out не был указан.

Возвращает

resndarray

Объединенный массив.

См. также

ma.concatenate

Функция конкатенации, сохраняющая маски входных данных.

array_split

Разделение массива на несколько подмассивов равного или приблизительно равного размера.

split

Разделение массива на список подмассивов равного размера.

hsplit

Разделение массива на несколько подмассивов по горизонтали (по столбцам).

vsplit

Разделение массива на несколько подмассивов по вертикали (по строкам).

dsplit

Разделение массива на несколько подмассивов по 3-й оси (глубине).

stack

Укладка последовательности массивов вдоль новой оси.

hstack

Укладка массивов в последовательность по горизонтали (по столбцам).

vstack

Укладка массивов в последовательность по вертикали (по строкам).

dstack

Укладка массивов в последовательность по глубине (по третьей размерности).

block

Сборка массивов из блоков.

Примечания

Когда один или несколько массивов, подлежащих конкатенации, являются MaskedArray, эта функция вернёт объект MaskedArray вместо ndarray, но маски входных данных не сохраняются. В случаях, когда ожидается MaskedArray в качестве входных данных, используйте функцию ma.concatenate из модуля masked array.

Примеры

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

Эта функция не сохранит маскирование входных данных MaskedArray.

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