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)