numpy.subtract

numpy.subtract(x1, x2, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature, extobj]) = <ufunc 'subtract'>

Вычитание аргументов поэлементно.

Параметры:

x1, x2 : array_like Массивы, которые нужно вычесть друг из друга. Если x1.shape != x2.shape, они должны быть совместимы для векторизации (формат результата будет совпадать с форматом векторизации). out : ndarray, None, or tuple of ndarray and None, optional Место, в которое хранится результат. Если указано, оно должно иметь форму, на которую векторизуются входные данные. Если не указано или None, возвращается свежевыделенный массив. Кортеж (возможен только как ключевой аргумент) должен иметь длину, равную количеству выходов. where : array_like, optional Это условие векторизуется по входным данным. В местах, где условие истинно, массив out будет устанавливаться в результат ufunc. В противном случае, массив out сохранит свое исходное значение. Обратите внимание, что если массив out создается по умолчанию out=None, места в нем, где условие ложно, останутся неинициализированными. **kwargs Для других ключевых аргументов см. документацию по ufunc.

Возвращает:

y : ndarray Разность x1 и x2 поэлементно. Это скаляр, если оба x1 и x2 являются скалярами.

Примечания

Эквивалентно x1 - x2 в плане векторизации массивов.

Примеры

>>> np.subtract(1.0, 4.0)
-3.0

>>> x1 = np.arange(9.0).reshape((3, 3))
>>> x2 = np.arange(3.0)
>>> np.subtract(x1, x2)
array([[ 0.,  0.,  0.],
       [ 3.,  3.,  3.],
       [ 6.,  6.,  6.]])