pandas.arrays.IntervalArray

class pandas.arrays.IntervalArray [source]

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

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

Параметры:

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

См. также

Index

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

Interval

Ограниченный интервал, похожий на срез; элементы IntervalArray.

interval_range

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

cut

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

qcut

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

Примечания

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

Примеры

Новый IntervalArray может быть создан напрямую из массивоподобного объекта Interval:

>>> pd.arrays.IntervalArray([pd.Interval(0, 1), pd.Interval(1, 5)])
IntervalArray([(0, 1], (1, 5]],
              closed='right',
              dtype='interval[int64]')

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

Атрибуты

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

Методы

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