pandas.IntervalIndex

class pandas.IntervalIndex(data, closed=None, dtype=None, copy=False, name=None, verify_integrity=True)

不可变的区间索引，其区间在同一侧是闭合的。

Parameters:

dataarray-like (1-dimensional)

用于构建 IntervalIndex 的类数组（ndarray, DateTimeArray TimeDeltaArray ）对象，包含 Interval 对象。

closed{‘left’, ‘right’, ‘both’, ‘neither’}，默认为 ‘right’

区间在左侧、右侧、两侧或两侧是否闭合。

dtypedtype 或 None，默认为 None。

如果为 None，则推断 dtype。

copybool，默认 False

复制输入数据。

nameobject, optional

要存储在索引中的名称。

verify_integritybool, default True

验证 IntervalIndex 是否有效。

参见

Index

pandas Index 的基类。

Interval

有界的、类切片（slice-like）的区间；IntervalIndex 的元素。

interval_range

用于创建固定频率 IntervalIndex 的函数。

cut

将值分箱到离散的区间中。

qcut

根据秩或样本分位数将值分箱到大小相等的区间中。

Notes

更多信息请参阅 user guide 。

Examples

通常使用 interval_range() 构建新的 IntervalIndex：

>>> 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() and IntervalIndex.from_tuples() 。

请参阅 interval_range 以及上述构造方法文档字符串中的更多示例。

Attributes

closed	String describing the inclusive side the intervals.
is_empty	Indicates if an interval is empty, meaning it contains no points.
is_non_overlapping_monotonic	返回一个布尔值，指示 IntervalArray 是否非重叠且单调。
is_overlapping	如果 IntervalIndex 包含重叠的区间，则返回 True，否则返回 False。
values	返回表示 Index 中数据的数组。

left
right
mid
length

Methods

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 相同但在一侧闭合的 IntervalArray。
to_tuples (*args, **kwargs)	返回一个 ndarray（如果 self 是 IntervalArray）或 Index（如果 self 是 IntervalIndex）的元组，形式为 (left, right)。