`numpy.append()`

Функция numpy.append() создаёт новый массив, дописывая значения в конец исходного. Возвращает новый объект — исходный массив не изменяется.

Сигнатура

numpy.append(arr, values, axis=None)

Параметры

arr — исходный массив (array_like).
values — значения, которые нужно добавить. Должны быть совместимы по форме с arr по всем осям, кроме axis.
axis — ось, вдоль которой выполняется добавление. По умолчанию None — оба массива «расплющиваются» в одномерные.

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

ndarray — копия arr с дописанными значениями.

Примеры

Пример 1. Добавление одного элемента.

import numpy as np

arr = np.array([1, 2, 3])
print(np.append(arr, 4))

[1 2 3 4]

Пример 2. Добавление списка значений.

arr = np.array([1, 2, 3])
print(np.append(arr, [4, 5, 6]))

[1 2 3 4 5 6]

Пример 3. Добавление строки в 2D-массив.

m = np.array([[1, 2, 3], [4, 5, 6]])
row = np.array([[7, 8, 9]])
print(np.append(m, row, axis=0))

[[1 2 3]
 [4 5 6]
 [7 8 9]]

Пример 4. Добавление столбца.

m = np.array([[1, 2], [3, 4]])
col = np.array([[10], [20]])
print(np.append(m, col, axis=1))

[[ 1  2 10]
 [ 3  4 20]]

Пример 5. Накопление показаний датчика.

log = np.array([], dtype=int)
for sample in [512, 530, 545, 528]:
    log = np.append(log, sample)
print(log)

[512 530 545 528]

См. также

Примечание

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

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

numpy.append()