pandas.Interval

classpandas.Interval

Неизменяемый объект, реализующий интервал, ограниченный с двух сторон, похожий на срез.

Параметры:

left:упорядочиваемый скаляр

Левая граница интервала.

right:упорядочиваемый скаляр

Правая граница интервала.

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

Закрыт ли интервал слева, справа, с обеих сторон или ни с одной. Подробное объяснение см. в примечаниях.

См. также

IntervalIndex

Индекс объектов Interval, все из которых закрыты с одной и той же стороны.

cut

Преобразование непрерывных данных в дискретные интервалы (Категориальный тип с объектами Interval).

qcut

Преобразование непрерывных данных в интервалы (Категориальный тип с объектами Interval) на основе квантилей.

Period

Представляет временной период.

Примечания

Параметры left и right должны быть одного типа, их можно сравнивать и они должны удовлетворять left <= right.

Закрытый интервал (в математике обозначается квадратными скобками) содержит свои конечные точки, т.е. закрытый интервал [0, 5] характеризуется условиями 0 <= x <= 5. Это то, что обозначает closed='both'. Открытый интервал (в математике обозначается круглыми скобками) не содержит своих конечных точек, т.е. открытый интервал (0, 5) характеризуется условиями 0 < x < 5. Это то, что обозначает closed='neither'. Интервалы также могут быть полуоткрытыми или полузакрытыми, т.е. [0, 5) описывается 0 <= x < 5 (closed='left') и (0, 5] описывается 0 < x <= 5 (closed='right').

Примеры

Можно создать интервалы разных типов, например, числовые:

>>> iv = pd.Interval(left=0, right=5)
>>> iv
Interval(0, 5, closed='right')

Можно проверить, принадлежит ли элемент интервалу или содержит ли он другой интервал:

>>> 2.5 in iv
True
>>> pd.Interval(left=2, right=5, closed='both') in iv
True

Можно проверить границы (closed='right', поэтому 0 < x <= 5):

>>> 0 in iv
False
>>> 5 in iv
True
>>> 0.0001 in iv
True

Вычислить его длину

>>> iv.length
5

Можно выполнять операции + и * над интервалом, и операция применяется к каждой из его границ, поэтому результат зависит от типа элементов границ

>>> shifted_iv = iv + 3
>>> shifted_iv
Interval(3, 8, closed='right')
>>> extended_iv = iv * 10.0
>>> extended_iv
Interval(0.0, 50.0, closed='right')

Для создания временного интервала можно использовать метки времени в качестве границ

>>> year_2017 = pd.Interval(pd.Timestamp('2017-01-01 00:00:00'),
...                         pd.Timestamp('2018-01-01 00:00:00'),
...                         closed='left')
>>> pd.Timestamp('2017-01-01 00:00') in year_2017
True
>>> year_2017.length
Timedelta('365 days 00:00:00')

Атрибуты

closed	Строка, описывающая сторону интервала, которая включена.
closed_left	Проверка, закрыт ли интервал слева.
closed_right	Проверка, закрыт ли интервал справа.
is_empty	Указывает, является ли интервал пустым, то есть не содержит ни одной точки.
left	Левая граница интервала.
length	Возвращает длину интервала.
mid	Возвращает середину интервала.
open_left	Проверка, открыт ли интервал слева.
open_right	Проверка, открыт ли интервал справа.
right	Правая граница интервала.

Методы

overlaps(other)

Проверка перекрытия двух объектов Interval.