pandas.arrays.IntervalArray

class pandas.arrays.IntervalArray(data, closed=None, dtype=None, copy=False, verify_integrity=True)

Pandas 数组，用于存储同侧闭合的区间数据。

Parameters:

dataarray-like (1-dimensional)

用于从 Interval 对象构建 IntervalArray 的类数组对象（ndarray, DateTimeArray TimeDeltaArray ）。

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

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

dtypedtype 或 None，默认为 None。

如果为 None，则推断 dtype。

copybool，默认 False

复制输入数据。

verify_integritybool, default True

验证 IntervalArray 是否有效。

参见

Index

pandas Index 的基类。

Interval

一个边界划分的类切片区间；IntervalArray 的元素。

interval_range

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

cut

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

qcut

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

Notes

更多信息请参阅 user guide 。

Examples

可以直接从 Interval 对象的类数组对象构建一个新的 IntervalArray：

>>> pd.arrays.IntervalArray([pd.Interval(0, 1), pd.Interval(1, 5)])
<IntervalArray>
[(0, 1], (1, 5]]
Length: 2, dtype: interval[int64, right]

也可以使用构造方法之一构建：IntervalArray.from_arrays() IntervalArray.from_breaks() and IntervalArray.from_tuples() 。

Attributes

left	返回 IntervalArray 中每个 Interval 的左端点，作为一个 Index。
right	返回 IntervalArray 中每个 Interval 的右端点，作为一个 Index。
closed	String describing the inclusive side the intervals.
mid	返回 IntervalArray 中每个 Interval 的中点，作为一个 Index。
length	返回一个 Index，其中包含每个 Interval 的长度。
is_empty	Indicates if an interval is empty, meaning it contains no points.
is_non_overlapping_monotonic	返回一个布尔值，指示 IntervalArray 是否非重叠且单调。

Methods

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