pandas.Series.idxmin

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

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

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

Параметры:

axis:{0 или ‘индекс’}

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

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

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

*args, **kwargs

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

Возвращает:

Индекс

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

Возбуждает:

ValueError

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

См. также

numpy.argmin

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

DataFrame.idxmin

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

Series.idxmax

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

Примечания

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

Примеры

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

>>> s.idxmin()
'A'

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

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