Spec-Zone.ru › pandas 0.25

pandas.Series.idxmax

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

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

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

Параметры:
skipna : bool, default True

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

axis : int, default 0

Для совместимости с DataFrame.idxmax. Избыточно для применения к Series.

*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 ложно и в данных есть значение NA, функция возвращает nan.

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

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.25.0/reference/api/pandas.Series.idxmax.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API