`numpy.subtract()`

Функция np.subtract поэлементно вычисляет x1 - x2. Эквивалент оператора -, но как ufunc поддерживает все стандартные параметры (out, where, dtype). Работает с broadcasting.

Сигнатура

numpy.subtract(x1, x2, /, out=None, *, where=True, dtype=None)

Параметры

x1, x2 — массивы (или скаляры) совместимых форм.
out — необязательный выходной массив.
where — условная маска.

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

Массив поэлементной разности; форма определяется правилами broadcasting.

Примеры

Пример 1. Вычитание двух массивов.

import numpy as np

a = np.array([10, 20, 30, 40])
b = np.array([1, 2, 3, 4])
print(np.subtract(a, b))

[ 9 18 27 36]

Пример 2. Вычитание скаляра (центрирование).

data = np.array([5.0, 7.0, 6.5, 4.5])
centered = np.subtract(data, np.mean(data))
print(np.round(centered, 2))

[-0.75  1.25  0.75 -1.25]

Пример 3. Вычитание baseline из сигнала.

raw = np.array([520, 518, 521, 519, 522])
baseline = 510
delta = np.subtract(raw, baseline)
print(delta)

[10  8 11  9 12]

Пример 4. Broadcasting матрица минус вектор.

m = np.array([[10, 20, 30],
              [40, 50, 60]])
v = np.array([1, 2, 3])
print(np.subtract(m, v))

[[ 9 18 27]
 [39 48 57]]

Пример 5. Разность между двумя последовательными измерениями (numpy.diff равен subtract соседних).

t = np.array([100, 105, 112, 120, 130])
delta = np.subtract(t[1:], t[:-1])
print(delta)

[ 5  7  8 10]

См. также

Примечание

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

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

numpy.subtract()