numpy.add
numpy.add(x1, x2, *ufunc_args) = <ufunc 'add'>
Функция add() выполняет поэлементную сумму массивов x1 и x2.
Данная функция эквивалентной команде x1 + x2
и является аналогом оператора +
, который перегружен в NumPy таким образом, что бы сумма выполнялась поэлементно в случае одинаковых форм входных массивов, а в случае разных форм, выполнялся механизм транслирования массивов.
Однако, numpy.add()
является универсальной функцией, т.е. поддерживает целый ряд параметров, которые позволяют оптимизировать ее работу в зависимости от специфики алгоритма, в котором она необходима.
-
- x1, x2 - числа, массивы или подобные массивам объекты
- Входные данные.
- *ufunc_args - аргументы универсальной функции
- Аргументы, позволяющие настроить и оптимизировать работу функции (подробнее см. универсальные функции).
-
- результат - массив NumPy или вещественное число
- Массив чисел, которые являются суумой соответствующих элементов из x1 и x2. Возвращает число, если x1 и x2 являются числами.
Примеры
>>> import numpy as np
>>>
>>> np.add(12, 13)
25
>>>
>>> np.add([1, 2, 3], 10)
array([11, 12, 13])
>>>
>>> a = np.array([1, 2, 3])
>>> np.add(a, a**2)
array([ 2, 6, 12])
>>>
>>> b = np.arange(9).reshape(3, 3)
>>> b
array([[0, 1, 2],
[3, 4, 5],
[6, 7, 8]])
>>>
>>> np.add(a, b)
array([[ 1, 3, 5],
[ 4, 6, 8],
[ 7, 9, 11]])