pandas.api.extensions.ExtensionArray.argsort

ExtensionArray.argsort(*, ascending=True, kind='quicksort', na_position='last', **kwargs)[source]

Return the indices that would sort this array.

Parameters:

ascending:bool, default True

Whether the indices should result in an ascending or descending sort.

kind:{‘quicksort’, ‘mergesort’, ‘heapsort’, ‘stable’}, optional

Sorting algorithm.

na_position:{‘first’, ‘last’}, default ‘last’

If 'first', put NaN values at the beginning. If 'last', put NaN values at the end.

*args, **kwargs:

Passed through to numpy.argsort().

Returns:

np.ndarray[np.intp]

Array of indices that sort self. If NaN values are contained, NaN values are placed at the end.

See also

numpy.argsort

Sorting implementation used internally.

Examples

>>> arr = pd.array([3, 1, 2, 5, 4])
>>> arr.argsort()
array([1, 2, 0, 4, 3])