numpy.ma.argsort#

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

返回一个 ndarray,其中包含沿指定轴排序数组的索引。掩码值会事先用 fill_value 填充。

参数:
axisint, 可选

用于排序的轴。如果为 None(默认值),则使用展平后的数组。

kind{'quicksort', 'mergesort', 'heapsort', 'stable'}, 可选

使用的排序算法。

orderlist, 可选

a 是定义了字段的数组时,此参数指定首先比较哪些字段,其次比较哪些字段,等等。并非所有字段都需要指定。

endwith{True, False}, 可选

缺失值(如果有)是否应被视为最大值 (True) 或最小值 (False)。当数组在数据类型的相同极端包含未掩码的值时,这些值和掩码值的排序是未定义的。

fill_value标量或 None, 可选

内部用于掩码值的值。如果 fill_value 不是 None,它将覆盖 endwith

stable布尔值, 可选

仅用于与 np.argsort 兼容。被忽略。

返回:
index_arrayndarray, int

沿指定轴对 a 进行排序的索引数组。换句话说,a[index_array] 会生成已排序的 a

另请参阅

ma.MaskedArray.sort

描述使用的排序算法。

lexsort

使用多个键的间接稳定排序。

numpy.ndarray.sort

原地排序。

注意

有关不同排序算法的说明,请参阅 sort

示例

>>> import numpy as np
>>> 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])