numpy.ma.MaskedArray.argsort

метод

ma.MaskedArray.argsort(axis=<no value>, kind=None, order=None, endwith=True, fill_value=None, *, stable=False)[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])