pandas.IntervalIndex

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

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

参数:

数据类数组（一维）

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

关闭{‘left’, ‘right’, ‘both’, ‘neither’}, 默认 ‘right’

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

dtypedtype 或 None, 默认 None

如果为 None，dtype 将被推断。

复制布尔值, 默认为 False

复制输入数据。

名称对象，可选

要存储在索引中的名称。

verify_integrity布尔值, 默认为 True

验证 IntervalIndex 是否有效。

属性

左	返回 IntervalIndex 中区间的左边界。
右	返回 IntervalIndex 中区间的右边界。
闭合	描述区间包含侧的字符串。
中点	返回 IntervalIndex 中每个区间的中间点作为 Index。
长度	计算 IntervalIndex 中每个间隔的长度。
is_empty	指示一个区间是否为空，即它不包含任何点。
is_non_overlapping_monotonic	返回一个布尔值，判断 IntervalArray/IntervalIndex 是否是非重叠且单调的。
is_overlapping	如果 IntervalIndex 有重叠的区间，则返回 True，否则返回 False。
值	返回一个表示索引中数据的数组。

方法

from_arrays(left, right[, closed, name, ...])	从定义左右边界的两个数组构造。
from_tuples(data[, closed, name, copy, dtype])	从类似数组的元组构造一个 IntervalIndex。
from_breaks(breaks[, closed, name, copy, dtype])	从分割数组构造一个 IntervalIndex。
包含(其他)	检查逐元素区间是否包含该值。
重叠(其他)	检查元素是否与 IntervalArray 中的值重叠。
set_closed(closed)	返回一个在指定侧闭合的相同 IntervalArray。
to_tuples([na_tuple])	返回一个 ndarray（如果 self 是 IntervalArray）或 Index（如果 self 是 IntervalIndex），形式为 (left, right) 的元组。

参见

索引

基本的 pandas Index 类型。

间隔

一个有界的类似切片的区间；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 的文档字符串和提到的构造方法中的更多示例。