Open In App

numpy.add() in Python

Improve
Improve
Improve
Like Article
Like
Save Article
Save
Share
Report issue
Report

NumPy, the Python powerhouse for scientific computing, provides an array of tools to efficiently manipulate and analyze data. Among its key functionalities lies numpy.add() a potent function that performs element-wise addition on NumPy arrays.

numpy.add() Syntax

Syntax : numpy.add(arr1, arr2, /, out=None, *, where=True, casting=’same_kind’, order=’K’, dtype=None, subok=True[, signature, extobj], ufunc ‘add’) 

Parameters : 

  • arr1 : [array_like or scalar] Input array. 
  • arr2 : [array_like or scalar] Input array. out : [ndarray, optional] A location into which the result is stored.   -> If provided, it must have a shape that the inputs broadcast to.   -> If not provided or None, a freshly-allocated array is returned. 
  • where : [array_like, optional] Values of True indicate to calculate the ufunc at that position, values of False indicate to leave the value in the output alone.
  •  **kwargs :Allows to pass keyword variable length of argument to a function. Used when we want to handle named argument in a function.

Return : [ndarray or scalar] The sum of arr1 and arr2, element-wise. Returns a scalar if both arr1 and arr2 are scalars.

What is numpy.add() in Python?

NumPy’s numpy.add() is a function that performs element-wise addition on NumPy arrays. This means it adds the corresponding elements between two arrays, element by element, instead of treating them as single values. numpy.add() function is used when we want to compute the addition of two arrays. It adds arguments element-wise. If the shape of two arrays is not the same, that is arr1. shape != arr2.shape, they must be broadcastable to a common shape (which may be the shape of one or the other).

Add Elements in Numpy Arrays

Here are the different example of Add Elements in Numpy Array using numpy.add() with different example below:

  • Use numpy.add() on two scalars
  • Use Numpy add with one array and one scalar
  • Add two same-sized Numpy arrays
  • Add differently sized Numpy arrays via broadcasting (i.e., add a vector to a matrix)

Use numpy.add() Function to Add Two Numbers

In this example, we have two scalar values, num1 and num2. The np.add() function is used to add these two scalar values, and the result is printed. The function performs element-wise addition, and the output is the sum of the two scalars.

Python




# numpy.add() function
# when inputs are scalar
 
import numpy as geek
in_num1 = 10
in_num2 = 15
 
print ("1st Input number : ", in_num1)
print ("2nd Input number : ", in_num2)
 
out_num = geek.add(in_num1, in_num2)
print ("output number after addition : ", out_num)


Output

1st Input  number :  10
2nd Input  number :  15
output number after addition  :  25

Use NumPy add with One Array and One Scalar

Here, we have a NumPy array array1 and a scalar value scalar. The np.add() function is applied to add the scalar to each element of the array. This demonstrates the broadcasting capability of NumPy, where the scalar is automatically broadcasted to match the shape of the array.

Python3




import numpy as np
 
# Numpy array and a scalar
array1 = np.array([9, 7, 12])
scalar = 4
 
# Using numpy.add() with an array and a scalar
result = np.add(array1, scalar)
 
print("Result of adding array and scalar:", result)


Output

Result of adding array and scalar: [13 11 16]

NOTE: In-place addition: You can also use the += operator to perform in-place addition of two arrays or a scalar and an array. This modifies the first array instead of creating a new one. 

Add Two Same-sized NumPy Arrays

The numpy.add() function is a part of the NumPy library in Python, and can be used to add two arrays element-wise. Here’s In this example, we have two NumPy arrays, array1 and array2, of the same size. The np.add() function is applied to add the corresponding elements of the two arrays. The result is a new array with the sum of the corresponding elements.

Python3




import numpy as geek
 
# Define two arrays
a = geek.array([1, 2, 3])
b = geek.array([4, 5, 6])
 
# Add the arrays element-wise
c = geek.add(a, b)
 
# Print the result
print(c)


Output

[5 7 9]

Add Differently Sized NumPy Arrays via Broadcasting

Here, we have a 2D NumPy array (matrix) and a 1D NumPy array (vector). The np.add() function is used to add the vector to each row of the matrix, taking advantage of NumPy’s broadcasting feature. The vector is automatically extended to match the size of the matrix, allowing the addition to be performed element-wise.

Python




import numpy as np
 
# NumPy array and a smaller array (vector)
matrix = np.array([[2, -7, 5], [-6, 2, 0]])
vector = np.array([3, 6, 9])
 
# Using numpy.add() to add a vector to a matrix via broadcasting
result = np.add(matrix, vector)
 
print("Result of adding a vector to a matrix via broadcasting:")
print(result)


Output

Result of adding a vector to a matrix via broadcasting:
[[ 5 -1 14]
 [-3  8  9]]


Last Updated : 21 Dec, 2023
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads