pandas.Series.idxmax

Series.idxmax(axis=0, skipna=True, *args, **kwargs)[source]

Возвращает метку строки с максимальным значением.

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

Параметры:

axis:{0 или ‘index’}

Не используется. Параметр необходим для совместимости с DataFrame.

skipna:bool, по умолчанию True

Исключить значения NA/null. Если весь Series содержит значения NA, результат будет NA.

*args, **kwargs

Дополнительные аргументы и ключевые слова не влияют, но могут быть приняты для совместимости с NumPy.

Возвращает:

Индекс

Метка максимального значения.

Исключения:

ValueError

Если Series пустой.

См. также

numpy.argmax

Возвращает индексы максимальных значений вдоль заданной оси.

DataFrame.idxmax

Возвращает индекс первого вхождения максимального значения по запрошенной оси.

Series.idxmin

Возвращает метку индекса первого вхождения минимального значения.

Примечания

Этот метод является версией для Series метода ndarray.argmax. Этот метод возвращает метку максимума, в то время как ndarray.argmax возвращает позицию. Чтобы получить позицию, используйте series.values.argmax().

Примеры

>>> s = pd.Series(data=[1, None, 4, 3, 4],
...               index=['A', 'B', 'C', 'D', 'E'])
>>> s
A    1.0
B    NaN
C    4.0
D    3.0
E    4.0
dtype: float64

>>> s.idxmax()
'C'

Если skipna False и в данных есть значение NA, функция возвращает nan.

>>> s.idxmax(skipna=False)
nan