pandas.Index.get_loc

Index.get_loc(key, method=None, tolerance=None) [source]

Получение целочисленной позиции, среза или булевой маски для запрошенного метки.

Параметры:

ключ : метка метод : {None, ‘pad’/’ffill’, ‘backfill’/’bfill’, ‘nearest’}, необязательно по умолчанию: только точные совпадения. pad / ffill: найти ПРЕДЫДУЩЕЕ значение индекса, если точного совпадения нет. backfill / bfill: использовать СЛЕДУЮЩЕЕ значение индекса, если точного совпадения нет nearest: использовать НАИБОЛЕЕ БЛИЗКОЕ значение индекса, если точного совпадения нет. Связанные расстояния разрываются, отдавая предпочтение большему значению индекса. tolerance : необязательно Максимальное расстояние от значения индекса для неточных совпадений. Значение индекса в соответствующей позиции должно удовлетворять уравнению abs(index[loc] - key) <= tolerance. Tolerance может быть скалярным значением, которое применяется к одному и тому же tolerance ко всем значениям, или списком, который применяет переменный tolerance к каждому элементу. Список включает список, кортеж, массив, Series и должен иметь тот же размер, что и индекс, а его тип данных должен точно соответствовать типу индекса. Новое в версии 0.17.0. Новое в версии 0.21.0: (списковый tolerance)

Возвращает:

loc : целое число, если индекс уникален, срез, если индекс монотонный, иначе маска

Примеры

>>> unique_index = pd.Index(list('abc'))
>>> unique_index.get_loc('b')
1

>>> monotonic_index = pd.Index(list('abbc'))
>>> monotonic_index.get_loc('b')
slice(1, 3, None)

>>> non_monotonic_index = pd.Index(list('abcb'))
>>> non_monotonic_index.get_loc('b')
array([False,  True, False,  True], dtype=bool)