pandas.Interval

class pandas.Interval

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

Добавлен в версии 0.20.0.

Параметры:

left : упорядочиваемый скаляр Левая граница интервала. right : упорядочиваемый скаляр Правая граница интервала. closed : {‘left’, ‘right’, ‘both’, ‘neither’}, по умолчанию ‘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

Вы можете проверить границы (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')

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

>>> 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')

А также можно создавать строковые интервалы

>>> volume_1 = pd.Interval('Ant', 'Dog', closed='both')
>>> 'Bee' in volume_1
True

Атрибуты

closed	Закрыт ли интервал слева, справа, с обеих сторон или ни с одной стороны
closed_left	Проверка, закрыт ли интервал слева.
closed_right	Проверка, закрыт ли интервал справа.
left	Левая граница интервала
length	Возвращает длину интервала
mid	Возвращает середину интервала
open_left	Проверка, открыт ли интервал слева.
open_right	Проверка, открыт ли интервал справа.
right	Правая граница интервала