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