numpy.ma.argsort

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

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

Параметры

axisint, optional

Ось, по которой производится сортировка. Если None, по умолчанию, используется уплощенный массив.

Изменено в версии 1.13.0: Ранее по умолчанию было -1, но это было ошибкой. В будущем по умолчанию будет -1, как изначально предполагалось. До тех пор, ось должна быть указана явно при arr.ndim > 1, чтобы избежать FutureWarning.

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

Используемый алгоритм сортировки.

orderlist, optional

Когда a является массивом с определенными полями, этот аргумент указывает, какие поля сравнивать в первую, вторую и т. д. очередь. Не все поля необходимо указывать.

endwith{True, False}, optional

Выполнять ли обработку пропущенных значений (если таковые имеются) как наибольших значений (True) или наименьших значений (False). Когда массив содержит значения без маскирования в тех же крайних пределах типа данных, порядок этих значений и значений с маской не определен.

fill_value{var}, optional

Значение, используемое во внутренней работе для маскированных значений. Если fill_value не равно None, оно заменяет endwith.

Возвращает

index_arrayndarray, int

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

См. также

MaskedArray.sort

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

lexsort

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

numpy.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])