This is documentation for an old release of SciPy (version 0.11.0). Read this page Search for this page in the documentation of the latest stable release (version 1.15.1).

scipy.stats.scoreatpercentile

scipy.stats.scoreatpercentile(a, per, limit=(), interpolation_method='fraction')

Calculate the score at the given per percentile of the sequence a.

For example, the score at per=50 is the median. If the desired quantile lies between two data points, we interpolate between them, according to the value of interpolation. If the parameter limit is provided, it should be a tuple (lower, upper) of two values. Values of a outside this (closed) interval will be ignored.

The interpolation_method parameter supports three values, namely fraction (default), lower and higher. Interpolation is done only, if the desired quantile lies between two data points i and j. For fraction, the result is an interpolated value between i and j; for lower, the result is i, for higher the result is j.

Parameters :

a : ndarray

Values from which to extract score.

per : scalar

Percentile at which to extract score.

limit : tuple, optional

Tuple of two scalars, the lower and upper limits within which to compute the percentile.

interpolation : {‘fraction’, ‘lower’, ‘higher’}, optional

This optional parameter specifies the interpolation method to use, when the desired quantile lies between two data points i and j:

• fraction: i + (j - i)*fraction, where fraction is the

  fractional part of the index surrounded by i and j.

-lower: i. - higher: j.

Returns :

score : float

Score at percentile.

See also

percentileofscore

Examples

>>> from scipy import stats
>>> a = np.arange(100)
>>> stats.scoreatpercentile(a, 50)
49.5