`numpy.insert()`

Функция numpy.insert() возвращает новый массив со вставленными значениями по заданным индексам вдоль указанной оси. Исходный массив не изменяется.

Сигнатура

numpy.insert(arr, obj, values, axis=None)

Параметры

arr — исходный массив.
obj — индекс или последовательность индексов, перед которыми вставляются значения.
values — вставляемые значения (скаляр или массив; броадкастится при необходимости).
axis — ось. None — массив разворачивается в 1D.

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

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

Примеры

Пример 1. Вставка одного элемента.

import numpy as np

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

[1 2 3 4 5]

Пример 2. Вставка нескольких значений.

a = np.array([10, 20, 30])
print(np.insert(a, [1, 2], [15, 25]))

[10 15 20 25 30]

Пример 3. Вставка строки в матрицу.

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

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

Пример 4. Вставка столбца.

m = np.array([[1, 2], [3, 4]])
print(np.insert(m, 1, [9, 9], axis=1))

[[1 9 2]
 [3 9 4]]

Пример 5. Добавление маркера старта в лог.

log = np.array([22.1, 22.3, 22.5, 22.7])
# В начало вставим «маркер» -1 — начало сессии
marked = np.insert(log, 0, -1.0)
print(marked)

[-1.  22.1 22.3 22.5 22.7]

См. также

Примечание

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

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

numpy.insert()