numpy.ma.argsort

numpy.ma.argsort(a, axis=<no value>, kind='quicksort', order=None, endwith=True, fill_value=None) [source]

Возвращает массив индексов, которые сортируют массив вдоль указанной оси. Маскированные значения заполняются предварительно, чтобы fill_value.

Параметры:

axis : int, optional Ось, вдоль которой сортировать. Если None, по умолчанию, используется уплощенная матрица. Изменено в версии 1.13.0: Ранее значение по умолчанию было задокументировано как -1, но это было ошибкой. В будущем значение по умолчанию будет изменено на -1, как изначально предполагалось. До тех пор, ось должна быть задана явно при arr.ndim > 1, чтобы избежать предупреждения FutureWarning. kind : {‘quicksort’, ‘mergesort’, ‘heapsort’, ‘stable’}, optional Алгоритм сортировки. order : list, optional Если a является массивом с определенными полями, этот аргумент указывает, какие поля сравнивать в первую, вторую и т. д. очередь. Не все поля необходимо указывать. endwith : {True, False}, optional Нужно ли обрабатывать отсутствующие значения (если таковые имеются) как наибольшие значения (True) или наименьшие значения (False). Когда массив содержит не замаскированные значения в тех же крайних точках типа данных, порядок этих значений и значений, отмеченных как маскированные, не определён. fill_value : {var}, optional Значение, используемое внутри для маскированных значений. Если fill_value не равно None, оно заменяет endwith.

Возвращает:

index_array : ndarray, int Массив индексов, которые сортируют a вдоль указанной оси. Другими словами, a[index_array] возвращает отсортированный a.

См. также

MaskedArray.sort

Описание алгоритмов сортировки, которые используются.

lexsort

Неявная устойчивая сортировка с несколькими ключами.

ndarray.sort

Сортировка на месте.

Примечания

См. sort для заметок об алгоритмах сортировки.

Примеры

>>> a = np.ma.array([3,2,1], mask=[False, False, True])
>>> a
masked_array(data = [3 2 --],
             mask = [False False  True],
       fill_value = 999999)
>>> a.argsort()
array([1, 0, 2])