pandas.IntervalIndex

classpandas.IntervalIndex(data, closed=None, dtype=None, copy=False, name=None, verify_integrity=True)[source]

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

Параметры:

data:массивоподобный объект (1-мерный)

Массивоподобный объект (ndarray, DateTimeArray, TimeDeltaArray), содержащий объекты Interval, на основе которых создаётся IntervalIndex.

closed:{‘left’, ‘right’, ‘both’, ‘neither’}, по умолчанию ‘right’

Определяет, замкнуты ли интервалы слева, справа, с обеих сторон или ни с одной.

dtype:dtype или None, по умолчанию None

Если None, тип данных будет определён автоматически.

copy:bool, по умолчанию False

Копировать входные данные.

name:object, необязательно

Имя, которое будет сохранено в индексе.

verify_integrity:bool, по умолчанию True

Проверить корректность IntervalIndex.

Атрибуты

closed	Строка, описывающая включённую сторону интервалов.
is_empty	Указывает, является ли интервал пустым, то есть не содержит ли он точек.
is_non_overlapping_monotonic	Возвращает логическое значение, указывающее, что IntervalArray не содержит пересечений и является монотонным.
is_overlapping	Возвращает True, если IntervalIndex содержит пересекающиеся интервалы, иначе False.
values	Возвращает массив, представляющий данные в индексе.

left
right
mid
length

Методы

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

См. также

Index

Базовый тип pandas Index.

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]],
              dtype='interval[int64, right]')

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

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