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