pandas.IntervalIndex.get_indexer

IntervalIndex.get_indexer(target, method=None, limit=None, tolerance=None)[source]

Вычисление индексатора и маски для нового индекса, используя текущий индекс.

Индексатор должен использоваться в качестве входного параметра для ndarray.take для выравнивания текущих данных с новым индексом.

Параметры

target:Index

method:{None, ‘pad’/’ffill’, ‘backfill’/’bfill’, ‘nearest’}, optional

• по умолчанию: только точные совпадения.

• pad / ffill: найти ПРЕДЫДУЩЕЕ значение индекса, если точного совпадения нет.

• backfill / bfill: использовать СЛЕДУЮЩЕЕ значение индекса, если точного совпадения нет.

• nearest: использовать НАИБОЛЕЕ БЛИЗКОЕ значение индекса, если точного совпадения нет. В случае одинакового расстояния приоритет отдается большему значению индекса.

limit:int, optional

Максимальное количество последовательных меток в target для соответствия неточным совпадениям.

tolerance:optional

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

Возвращаемые значения

indexer:np.ndarray[np.intp]

Целочисленные значения от 0 до n - 1, указывающие, что индекс в этих позициях соответствует соответствующим целевым значениям. Отсутствующие значения в целевом индексе отмечаются -1.

Примечания

Для несоответствующих значений возвращается -1, подробное объяснение см. в примере ниже.

Примеры

>>> index = pd.Index(['c', 'a', 'b'])
>>> index.get_indexer(['a', 'b', 'x'])
array([ 1,  2, -1])

Обратите внимание, что возвращаемое значение представляет собой массив позиций в index, а x, так как оно отсутствует в index, отмечается -1.