{"id":37828,"date":"2022-11-30T06:44:04","date_gmt":"2022-11-30T06:44:04","guid":{"rendered":"https:\/\/www.askpython.com\/?p=37828"},"modified":"2022-11-30T06:44:48","modified_gmt":"2022-11-30T06:44:48","slug":"numpy-amin","status":"publish","type":"post","link":"https:\/\/www.askpython.com\/python-modules\/numpy\/numpy-amin","title":{"rendered":"NumPy amin – Return the Minimum of Array Elements using Numpy"},"content":{"rendered":"\n

Hello and welcome to this tutorial on Numpy amin<\/strong>. In this tutorial, we will be learning about the NumPy amin() <\/strong>method and also seeing a lot of examples regarding the same. So let us begin!<\/p>\n\n\n\n

Also read: Numpy.subtract(): How to Use Subtract Numbers with NumPy in Python?<\/a><\/em><\/strong><\/p>\n\n\n\n

\n\n\n\n

What is NumPy amin?<\/h2>\n\n\n\n

The amin method in NumPy is a function that returns the minimum of the array elements. It can be the minimum of all the array elements, the minimum of the array elements along the rows, or the minimum of the array elements along the columns. <\/p>\n\n\n\n

We will see the examples for each of these in the upcoming section of this tutorial.<\/p>\n\n\n\n

\n\n\n\n

Syntax of NumPy amin<\/h2>\n\n\n
\nnumpy.amin(a, axis=None, out=None)\n<\/pre><\/div>\n\n\n
Parameter<\/strong><\/td>Description<\/strong><\/td>Required\/Optional<\/strong><\/td><\/tr>
a (array_like)<\/td>Input data.<\/td>Required<\/td><\/tr>
axis<\/td>Axis along which the minimum of the array is to be calculated. It can be axis=0  or axis=1 or axis=None which implies that the minimum of the flattened array is to be returned. <\/td>Optional<\/td><\/tr>
out<\/td>An alternative output array in which to place the result. It must have the same shape as the expected output.<\/td>Optional<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Returns:<\/strong> The minimum element in a<\/em>. If axis=None<\/em>, then the output is a scalar, otherwise, the output is an array.<\/p>\n\n\n\n
\n\n\n\n
Examples of numpy.amin()<\/h2>\n\n\n\n
Let\u2019s get right into the different examples of using numpy.amin() function.<\/p>\n\n\n\n
Using numpy.amin() when the array is 1-dimensional<\/h3>\n\n\n
\nimport numpy as np\n\na = [10, 3, 25]\n\nans = np.amin(a)\nprint("a =", a)\nprint("Minimum of a =", ans)\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\na = [10, 3, 25]\nMinimum of a = 3\n<\/pre><\/div>\n\n\n
Comparing all the elements in the given array, the minimum of 10, 3 and 25 is 3. Hence, 3 are returned.<\/p>\n\n\n\n
\n\n\n\n
Using numpy.amin() when the array contains negative numbers<\/h3>\n\n\n
\nimport numpy as np\n\na = [[-8, 6], [-5, -12]]\n\nans = np.amin(a)\nprint("a =", a)\nprint("Minimum of a =", ans)\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\na = [[-8, 6], [-5, -12]]\nMinimum of a = -12\n<\/pre><\/div>\n\n\n
Comparing all the values in the array, -12 is the minimum element here.<\/p>\n\n\n\n
\n\n\n\n
Using numpy.amin() when the array contains NaN values<\/h3>\n\n\n\n
In Python, NaN stands for Not a Number.<\/p>\n\n\n
\nimport numpy as np\n\na = [26, np.nan, 8, np.nan, -4]\n\nans = np.amin(a)\nprint("a =", a)\nprint("Minimum of a =", ans)\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\na = [26, nan, 8, nan, -4]\nMinimum of a = nan\n<\/pre><\/div>\n\n\n
If the input contains NaNs, then the NumPy amin()<\/code> method always returns nan<\/strong> as output, irrespective of the other elements present in the input array. <\/p>\n\n\n\n
\n\n\n\n
Using numpy.amin() when the array is 2-dimensional<\/h3>\n\n\n
\nimport numpy as np\n\na = [[16, 3], [48, 66]]\n\nans = np.amin(a)\nprint("a =", a)\nprint("Minimum of a =", ans)\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\na = [[16, 3], [48, 66]]\nMinimum of a = 3\n<\/pre><\/div>\n\n\n
In the case of a 2-dimensional array, when no axis is mentioned, the array is first flattened row-wise and then its minimum is calculated. 
In the above example, the flattened array will be [16, 3, 48, 66] and the minimum element in it is 3, hence it is returned by the amin()<\/strong> method.<\/p>\n\n\n\n
\n\n\n\n
Using numpy.amin() to find the minimum along a given axis<\/h3>\n\n\n\n
axis = 0<\/strong><\/p>\n\n\n
\nimport numpy as np\n\na = [[16, 3], [48, 66]]\n# minimum along axis=0\nans = np.amin(a, axis=0)\nprint("a =", a)\nprint("Minimum of a =", ans)\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\na = [[16, 3], [48, 66]]\nMinimum of a = [16  3]\n<\/pre><\/div>\n\n\n
Here, the elements are compared column-wise and their minimum is stored in the output. <\/p>\n\n\n
\nans[0] = minimum(a[0][0], a[1][0]) = minimum(16, 48) = 16\nans[1] = minimum(a[0][1], a[1][1]) = minimum(3, 66) = 3\n<\/pre><\/div>\n\n\n
axis=  1<\/strong><\/p>\n\n\n
\nimport numpy as np\n\na = [[16, 3], [48, 66]]\n# minimum along axis=1\nans = np.amin(a, axis=1)\nprint("a =", a)\nprint("Minimum of a =", ans)\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\na = [[16, 3], [48, 66]]\nMinimum of a = [ 3 48]\n<\/pre><\/div>\n\n\n
Here, the elements are compared row-wise and their minimum is stored in the output. <\/p>\n\n\n
\nans[0] = minimum(a[0][0], a[0][1]) = minimum(16, 3) = 3\nans[1] = minimum(a[1][0], a[1][1]) = minimum(48, 66) = 48\n<\/pre><\/div>\n\n\n
\n\n\n\n
Conclusion<\/h2>\n\n\n\n
That\u2019s all! In this tutorial, we learned about the Numpy amin<\/strong> method and practiced different types of examples using the same.  If you want to learn more about NumPy, feel free to go through our NumPy tutorials<\/a>.<\/p>\n\n\n\n
\n\n\n\n
Reference<\/h2>\n\n\n\n