Finding Peaks: A Deep Dive into NumPy's Maximum Array Operations


link to this section

In data analysis and scientific computing, we often encounter the need to compare two arrays and pick the maximum values element-wise. This operation is essential in various fields, from physics simulations to financial modelling. NumPy, the go-to library for numerical computations in Python, offers a handy function for this purpose: np.maximum . This blog post explores the np.maximum function in NumPy, guiding you through its applications, advantages, and some useful tips.

What is np.maximum ?

link to this section

NumPy's np.maximum function takes two arrays as input and performs an element-wise comparison, returning a new array containing the maxima of each position. It can handle arrays of different shapes, thanks to NumPy's broadcasting rules.


The basic syntax of np.maximum is:

numpy.maximum(x1, x2, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True) 


  • x1 , x2 : Input arrays for comparison.
  • out : A location into which the result is stored.
  • where : A condition on where to apply the operation.
  • The remaining parameters dictate how the operation should be carried out in terms of type casting, memory order, and output data type.

How to Use np.maximum

link to this section

Simple Example

Let’s start with a basic example:

import numpy as np 
# Define two arrays 
arr1 = np.array([1, 3, 5, 7, 9]) 
arr2 = np.array([2, 4, 3, 8, 7]) 

# Find the element-wise maximum between the two 
max_array = np.maximum(arr1, arr2)
# Output: [2 4 5 8 9] 

Broadcasting Example

np.maximum shines with its ability to perform broadcasting, allowing you to compare arrays of different shapes:

# Define a one-dimensional array and a scalar 
arr = np.array([1, 2, 3, 4]) 
scalar = 2 

# The scalar is broadcast to the size of `arr` during the comparison 
broadcast_max = np.maximum(arr, scalar)
#Output: [2 2 3 4] 

Handling NaNs

One of the benefits of np.maximum is its handling of NaN values:

# Arrays with NaN values 
arr_with_nan = np.array([np.nan, 2, np.nan]) 
arr_numbers = np.array([1, -1, 3]) 

# NaNs are treated as missing values and 'ignored' in the comparison 
nan_max = np.maximum(arr_with_nan, arr_numbers)
# Output: [ 1. 2. 3.] 

Performance Considerations

link to this section

Using np.maximum is typically much faster than iterating through the elements of an array using a loop in pure Python. This is due to NumPy's underlying C implementation and its use of vectorized operations.

Practical Applications

link to this section

Some practical applications of np.maximum include:

  • Clipping Values : Ensuring that values in an array do not fall below a certain threshold.
  • Image Processing : Combining images by taking the brighter pixel from a pair of images.
  • Time-Series Analysis : Comparing two time-series datasets to find periods when one exceeds the other.


link to this section

NumPy's np.maximum function is a versatile tool that efficiently compares arrays to extract the maximum values. Its support for broadcasting and its handling of NaN values make it particularly powerful for numerical and scientific computing. By integrating np.maximum into your workflow, you can streamline your data analysis processes, allowing you to focus on gaining insights rather than getting bogged down with low-level implementation details. Whether you're a seasoned data scientist or a novice to numerical computing, np.maximum is a function worth knowing.