pandas.IntervalIndex

class pandas.IntervalIndex [source]

Неизменяемый индекс интервалов, которые закрыты с одной и той же стороны.

Введено в версии 0.20.0.

Предупреждение

Поведение индексирования предварительное и может измениться в будущей версии pandas.

Параметры:

data : array-like (1-dimensional) Массивоподобный объект, содержащий объекты Interval, из которых должен быть построен IntervalIndex. closed : {‘left’, ‘right’, ‘both’, ‘neither’}, default ‘right’ Указывает, закрыты ли интервалы слева, справа, с обеих сторон или ни с какой стороны. dtype : dtype or None, default None Если None, тип данных будет определен автоматически. Введено в версии 0.23.0. copy : bool, default False Копировать входные данные. name : object, optional Имя, которое должно храниться в индексе. verify_integrity : bool, default True Проверить, является ли IntervalIndex допустимым.

См. также

Index

Базовый тип индекса pandas.

Interval

Ограниченный интервал типа срез; элементы IntervalIndex.

interval_range

Функция для создания IntervalIndex с фиксированной частотой.

cut

Разбиение значений на дискретные интервалы.

qcut

Разбиение значений на интервалы равной длины на основе ранга или квантилей выборки.

Примечания

Дополнительную информацию см. в руководстве пользователя.

Примеры

Новый IntervalIndex обычно создается с помощью interval_range():

>>> pd.interval_range(start=0, end=5)
IntervalIndex([(0, 1], (1, 2], (2, 3], (3, 4], (4, 5]],
              closed='right',
              dtype='interval[int64]')

Его также можно создать с помощью одного из методов конструктора: IntervalIndex.from_arrays(), IntervalIndex.from_breaks() и IntervalIndex.from_tuples().

Дополнительные примеры см. в строках документации interval_range и упомянутых методах конструктора.

Атрибуты

left	Возвращает левые точки каждого интервала в IntervalIndex в виде индекса
right	Возвращает правые точки каждого интервала в IntervalIndex в виде индекса
closed	Указывает, закрыты ли интервалы слева, справа, с обеих сторон или ни с какой стороны
mid	Возвращает середину каждого интервала в IntervalIndex в виде индекса
length	Возвращает индекс со значениями, обозначающими длину каждого интервала в IntervalIndex
is_non_overlapping_monotonic	Возвращает True, если IntervalIndex неперекрывается (нет интервалов, имеющих общие точки) и является либо монотонно возрастающим, либо монотонно убывающим, иначе False
is_overlapping	Возвращает True, если IntervalIndex содержит перекрывающиеся интервалы, иначе False.
values	Возвращает данные IntervalIndex в виде IntervalArray.

Методы

from_arrays(left, right[, closed, name, …])	Создает из двух массивов, определяющих левую и правую границы.
from_tuples(data[, closed, name, copy, dtype])	Создает IntervalIndex из массивоподобного объекта кортежей
from_breaks(breaks[, closed, name, copy, dtype])	Создает IntervalIndex из массива разбиений.
overlaps(other)	Проверяет поэлементно, пересекается ли интервал со значениями в IntervalIndex.
set_closed(closed)	Возвращает IntervalIndex, идентичный текущему, но закрытый со стороны, указанной в параметре closed.
to_tuples([na_tuple])	Возвращает индекс кортежей вида (left, right)
contains(key)	Возвращает логическое значение, указывающее, содержится ли ключ в индексе.