pandas.Index.get_loc

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

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

Параметры:

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

Возвращает:

loc : int if unique index, slice if monotonic index, else mask

Примеры

>>> 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)