Spec-Zone.ru › pandas 0.23

pandas.Series.argmax

Series.argmax(axis=0, skipna=True, *args, **kwargs) [source]
Deprecated since version 0.21.0:
‘argmax’ is deprecated, use ‘idxmax’ instead. The behavior of ‘argmax’
will be corrected to return the positional maximum in the future. Use ‘series.values.argmax’ to get the position of the maximum now.

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

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

Параметры:

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

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

axis : int, по умолчанию 0

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

*args, **kwargs

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

Возвращает:
idxmax : Index of maximum of values.
Возможные исключения:

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

© 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.23.4/generated/pandas.Series.argmax.html

Spec-Zone.ru

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