pandas.Index.asof_locs

Index.asof_locs(where, mask)[source]

Возвращает местоположения (индексы) меток в индексе.

Как и в pandas.Index.asof(), если метка (определённая запись в where) отсутствует в индексе, выбирается последняя метка индекса до переданной метки, и возвращается её индекс.

Если все метки в индексе находятся позже, чем метка в where, возвращается -1.

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

Parameters:

where:Index

Индекс, содержащий массив временных меток.

mask:np.ndarray[bool]

Массив булевых значений, обозначающих, где значения в исходных данных не NA.

Returns:

np.ndarray[np.intp]

Массив местоположений (индексов) меток из индекса, которые соответствуют возвращаемым значениям pandas.Index.asof() для каждого элемента в where.

См. также

Index.asof

Возвращает метку из индекса или, если она отсутствует, предыдущую.

Примеры

>>> idx = pd.date_range('2023-06-01', periods=3, freq='D')
>>> where = pd.DatetimeIndex(['2023-05-30 00:12:00', '2023-06-01 00:00:00',
...                           '2023-06-02 23:59:59'])
>>> mask = np.ones(3, dtype=bool)
>>> idx.asof_locs(where, mask)
array([-1,  0,  1])

Мы можем использовать mask для игнорирования определённых значений в индексе во время вычисления.

>>> mask[1] = False
>>> idx.asof_locs(where, mask)
array([-1,  0,  0])