`numpy.concatenate()`

Функция numpy.concatenate() объединяет последовательность массивов вдоль существующей оси. В отличие от stack, не добавляет новую ось.

Сигнатура

numpy.concatenate((a1, a2, ...), axis=0, out=None, dtype=None,
                  casting='same_kind')

Параметры

(a1, a2, ...) — кортеж/список массивов. Должны иметь одинаковую форму по всем осям, кроме axis.
axis — ось объединения. По умолчанию 0. Если None — массивы расплющиваются и склеиваются.
out — массив для записи результата.
dtype — общий тип результата.
casting — правила приведения.

Возвращаемое значение

ndarray с объединёнными данными.

Примеры

Пример 1. Конкатенация двух 1D-массивов.

import numpy as np

a = np.array([1, 2, 3])
b = np.array([4, 5, 6])
print(np.concatenate((a, b)))

[1 2 3 4 5 6]

Пример 2. По строкам 2D-массива (axis=0).

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

[[1 2]
 [3 4]
 [5 6]]

Пример 3. По столбцам (axis=1).

a = np.array([[1, 2], [3, 4]])
b = np.array([[5], [6]])
print(np.concatenate((a, b), axis=1))

[[1 2 5]
 [3 4 6]]

Пример 4. Объединение трёх потоков семплов АЦП.

ch1 = np.array([512, 514, 510])
ch2 = np.array([520, 519, 522])
ch3 = np.array([530, 528, 531])
all_samples = np.concatenate((ch1, ch2, ch3))
print(all_samples)

[512 514 510 520 519 522 530 528 531]

Пример 5. axis=None — расплющивание.

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

[1 2 3 4 5 6]

См. также

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации NumPy (https://numpy.org/doc/stable/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.

numpy.concatenate()