numpy.ma.argsort

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

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

Параметры:

axisint, необязательно

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

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

kind{‘quicksort’, ‘mergesort’, ‘heapsort’, ‘stable’}, необязательно

Алгоритм сортировки.

orderсписок, необязательно

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

endwith{True, False}, необязательно

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

fill_valueскаляр или None, необязательно

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

stablebool, необязательно

Только для совместимости с np.argsort. Игнорируется.

Возвращает:

index_arrayndarray, int

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

См. также

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