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:int или float, необязательно

Максимальное расстояние от значения индекса для приближенных совпадений. Значение индекса в соответствующей позиции должно удовлетворять уравнению abs(index[loc] - key) <= tolerance.

Возвращает

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

Примеры

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