numpy.percentile() in python
Last Updated :
24 Jan, 2024
numpy.percentile() function used to compute the nth percentile of the given data (array elements) along the specified axis.
Python numpy.percentile() Syntax Function
Syntax: numpy.percentile(arr, n, axis=None, out=None,overwrite_input=False, method=’linear’, keepdims=False, *, interpolation=None)
Parameters :
- arr: Input array or object.
- n: Percentile or sequence of percentiles to compute, which must be between 0 and 100 inclusive.
- axis: Axis along which we want to calculate the percentile value. Otherwise, it will consider arr to be flattened(works on all the axes). axis = 0 means along the column and axis = 1 means working along the row.
- out: Different array in which we want to place the result. The array must have same dimensions as expected output.
- overwrite_input (bool, optional): Specifies the interpolation method used when the desired quantile lies between two data points. Default is ‘linear’.
- keepdims: (bool, optional): If this is set to True, the axes which are reduced are left in the result as dimensions with size one. With this option, the result will broadcast correctly against the original array a.
- interpolation: (str, optional): Deprecated name for the method keyword argument.
Return :nth Percentile of the array (a scalar value if axis is none)or array with percentile values along specified axis.
Python NumPy percentile() Function Examples
Below are some examples by which we can understand how to calculate percentiles in NumPy in Python:
Finding Percentile Value Using NumPy
In this example, a 1D array `arr` is created with values [20, 2, 7, 1, 34]. Using NumPy’s `percentile` function, the 50th, 25th, and 75th percentiles of the array are calculated and printed, providing key statistical measures for the data distribution.
Python3
import numpy as np
arr = [ 20 , 2 , 7 , 1 , 34 ]
print ( "arr : " , arr)
print ( "50th percentile of arr : " ,
np.percentile(arr, 50 ))
print ( "25th percentile of arr : " ,
np.percentile(arr, 25 ))
print ( "75th percentile of arr : " ,
np.percentile(arr, 75 ))
|
Output:
arr : [20, 2, 7, 1, 34]
50th percentile of arr : 7.0
25th percentile of arr : 2.0
75th percentile of arr : 20.0
Get the Percentile Value of 2-D Array Using NumPy
In this example, a 2D array `arr` is created. The np.percentile() function is applied to calculate percentiles both across the flattened array (axis=None) and along axis=0. The 50th and 0th percentiles are computed, providing statistical insights into the data distribution across different dimensions.
Python3
import numpy as np
arr = [[ 14 , 17 , 12 , 33 , 44 ],
[ 15 , 6 , 27 , 8 , 19 ],
[ 23 , 2 , 54 , 1 , 4 , ]]
print ( "\narr : \n" , arr)
print ( "\n50th Percentile of arr, axis = None : " ,
np.percentile(arr, 50 ))
print ( "0th Percentile of arr, axis = None : " ,
np.percentile(arr, 0 ))
print ( "\n50th Percentile of arr, axis = 0 : " ,
np.percentile(arr, 50 , axis = 0 ))
print ( "0th Percentile of arr, axis = 0 : " ,
np.percentile(arr, 0 , axis = 0 ))
|
Output:
arr :
[[14, 17, 12, 33, 44], [15, 6, 27, 8, 19], [23, 2, 54, 1, 4]]
50th Percentile of arr, axis = None : 15.0
0th Percentile of arr, axis = None : 1.0
50th Percentile of arr, axis = 0 : [15. 6. 27. 8. 19.]
0th Percentile of arr, axis = 0 : [14. 2. 12. 1. 4.]
50th Percentile of arr, axis = 1 : [17. 15. 4.]
0th Percentile of arr, axis = 1 : [12. 6. 1.]
Get the Percentile along the Axis in NumPy
In this example, a 2D array `arr` is created. The np.percentile() function is applied along axis=1 to calculate the 50th and 0th percentiles for each row, providing insights into the distribution of values along this axis. The use of `keepdims=True` ensures that the result retains the original dimensionality, maintaining clarity in the output.
Python3
import numpy as np
arr = [[ 14 , 17 , 12 , 33 , 44 ],
[ 15 , 6 , 27 , 8 , 19 ],
[ 23 , 2 , 54 , 1 , 4 , ]]
print ( "\narr : \n" , arr)
print ( "\n50th Percentile of arr, axis = 1 : " ,
np.percentile(arr, 50 , axis = 1 ))
print ( "0th Percentile of arr, axis = 1 : " ,
np.percentile(arr, 0 , axis = 1 ))
print ( "\n0th Percentile of arr, axis = 1 : \n" ,
np.percentile(arr, 50 , axis = 1 , keepdims = True ))
print ( "\n0th Percentile of arr, axis = 1 : \n" ,
np.percentile(arr, 0 , axis = 1 , keepdims = True ))
|
Output:
arr :
[[14, 17, 12, 33, 44], [15, 6, 27, 8, 19], [23, 2, 54, 1, 4]]
0th Percentile of arr, axis = 1 :
[[17.]
[15.]
[ 4.]]
0th Percentile of arr, axis = 1 :
[[12.]
[ 6.]
[ 1.]]
Similar Reads
numpy.ptp() in Python
numpy.ptp()function plays an important role in statistics by finding out Range of given numbers. Range = max value - min value. Syntax : ndarray.ptp(arr, axis=None, out=None) Parameters : arr :input array. axis :axis along which we want the range value. Otherwise, it will consider arr to be flattene
3 min read
numpy.nanpercentile() in Python
numpy.nanpercentile()function used to compute the nth percentile of the given data (array elements) along the specified axis and ignores nan values. Syntax : numpy.nanpercentile(arr, q, axis=None, out=None) Parameters : arr :input array. q : percentile value. axis :axis along which we want to calcul
4 min read
numpy.std() in Python
numpy.std() is a function provided by the NumPy library that calculates the standard deviation of an array or a set of values. Standard deviation is a measure of the amount of variation or dispersion of a set of values. [Tex]\text{Standard Deviation} = \sqrt{\text{mean} \left( (x - x.\text{mean}())^
4 min read
numpy.rint() in Python
The numpy.rint() is a mathematical function that rounds elements of the array to the nearest integer. Syntax : numpy.rint(x[, out]) = ufunc ârintâ) Parameters : array : [array_like] Input array. Return : An array with all array elements being rounded off, having same type and shape as input. Code #1
2 min read
numpy.ceil() in Python
The numpy.ceil() is a mathematical function that returns the ceil of the elements of array. The ceil of the scalar x is the smallest integer i, such that i >= x Syntax : numpy.ceil(x[, out]) = ufunc âceilâ) Parameters : a : [array_like] Input array Return : The ceil of each element with float dat
2 min read
numpy.fabs() in Python
numpy.fabs() function is used to compute the absolute values element-wise. This function returns the absolute values (positive magnitude) of the data in arr. It always return absolute values in floats. Syntax : numpy.fabs(arr, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, u
2 min read
numpy.nanquantile() in Python
numpy.nanquantile(arr, q, axis = None) : Compute the qth quantile of the given data (array elements) along the specified axis, ignoring the nan values. Quantiles plays a very important role in statistics. In the figure given above, Q2 is the median and Q3 - Q1 represents the Interquartile Range of t
4 min read
numpy.floor() in Python
The numpy.floor() function returns the largest integer less than or equal to each element in the input array. It effectively rounds numbers down to the nearest whole number. Let's understand with an example: [GFGTABS] Python import numpy as np a = [0.5, 1.5, 2.5, 3, 4.5, 10.1] res = np.floor(a) prin
1 min read
numpy.round_() in Python
The round_() function in NumPy rounds the elements of an array to a specified number of decimal places. This function is extremely useful when working with floating-point numbers and when precision is important in scientific computing or data analysis. Syntax: numpy.round_(arr, decimals=0, out=None)
3 min read
numpy.trunc() in Python
The numpy.trunc() is a mathematical function that returns the truncated value of the elements of array. The trunc of the scalar x is the nearest integer i which, closer to zero than x. This simply means that, the fractional part of the signed number x is discarded by this function. Syntax : numpy.tr
2 min read