NumPy amin()
Summary: in this tutorial, you will learn how to use the numpy amin()
function to find the minimum element in an array.
Introduction to the NumPy amin() function
The
function returns the minimum element of an array or minimum element along an axis. Here’s the syntax of the amin()
function:amin()
numpy.amin(a, axis=None, out=None, keepdims=<no value>, initial=<no value>, where=<no value>)
Code language: Python (python)
The a
function is equivalent to the min()
min()
method of the ndarray
object:
ndarray.min(axis=None, out=None, keepdims=False, initial=<no value>, where=True)
Code language: Python (python)
NumPy amin() function examples
Let’s take some examples of using the amin()
function.
1) Using numpy amin() function on 1-D array example
The following example uses the numpy amin()
function to find the minimum value in a 1-D array:
import numpy as npa = np.array([1, 2, 3])
min = np.amin(a)
print(min)
Code language: Python (python)
Output:
1
Code language: Python (python)
How it works.
First, create a new array that has three numbers 1, 2, and 3:
a = np.array([1, 2, 3])
Code language: Python (python)
Second, find the minimum number using the amin()
function:
min = np.amin(a)
Code language: Python (python)
Third, display the result:
print(min)
Code language: Python (python)
2) Using numpy amin() function on multidimensional array examples
The following example uses the amin()
funciton to find the minimum number in a 2-D array:
import numpy as npa = np.array([
[1, 2],
[3, 4]]
)
min = np.amin(a)
print(min)
Code language: Python (python)
Output:
1
Code language: Python (python)
If you want to find the minimum value on each axis, you can use the axis argument. For example, the following uses the amin()
function to find the minimum value on axis 0:
import numpy as npa = np.array([
[1, 2],
[3, 4]]
)
min = np.amin(a, axis=0)
print(min)
Code language: Python (python)
Output:
[1 2]
Code language: Python (python)
Similarly, you can use the amin()
function to find the minimum value on axis 1:
import numpy as npa = np.array([
[1, 2],
[3, 4]]
)
min = np.amin(a, axis=1)
print(min)
Code language: Python (python)
Output:
[1 3]
Code language: Python (python)
Summary
- Use the numpy
amin()
function to find the minimum element in an array or minimum element along an axis.