pandas.core.groupby.SeriesGroupBy.idxmax

SeriesGroupBy.idxmax(axis=_NoDefault.no_default, skipna=True)[source]

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

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

Параметры:

axis:{0 или ‘index’}

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

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

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

*args, **kwargs

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

Возвращает:

Индекс

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

Исключения:

ValueError

Если серия пустая.

См. также

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