pandas.Index.get_loc

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

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

Параметры:

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

Возвращает:

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)