pandas.arrays.IntervalArray#
- class pandas.arrays.IntervalArray(data, closed=None, dtype=None, copy=False, verify_integrity=True)[源代码][源代码]#
用于闭合在同一边的区间数据的 Pandas 数组。
- 参数:
- 数据类数组(一维)
类似数组的对象(ndarray,
DateTimeArray
,TimeDeltaArray
),包含从中构建IntervalArray的Interval对象。- closed{‘left’, ‘right’, ‘both’, ‘neither’}, 默认 ‘right’
区间是否在左侧、右侧、两侧或不闭合。
- dtypedtype 或 None, 默认 None
如果为 None,dtype 将被推断。
- 复制bool, 默认 False
复制输入数据。
- verify_integritybool, 默认为 True
验证 IntervalArray 是否有效。
属性
将 IntervalArray 中每个 Interval 的左端点作为 Index 返回。
将 IntervalArray 中每个 Interval 的右端点作为 Index 返回。
描述区间包含侧的字符串。
将 IntervalArray 中的每个 Interval 的中点作为 Index 返回。
返回一个索引,其中每个条目表示每个区间的长度。
指示一个区间是否为空,即它不包含任何点。
返回一个布尔值,表示 IntervalArray/IntervalIndex 是否是非重叠且单调的。
方法
from_arrays
(left, right[, closed, copy, dtype])从定义左右边界的两个数组构造。
from_tuples
(数据[, 闭合, 复制, 数据类型])从类似数组的元组构建一个 IntervalArray。
from_breaks
(breaks[, closed, copy, dtype])从分割数组构造一个 IntervalArray。
包含
(其他)检查逐元素区间是否包含该值。
重叠
(其他)检查元素是否与 IntervalArray 中的值重叠。
set_closed
(closed)返回一个在指定侧闭合的相同 IntervalArray。
to_tuples
([na_tuple])返回一个 ndarray(如果 self 是 IntervalArray)或 Index(如果 self 是 IntervalIndex),形式为 (left, right) 的元组。
参见
索引
基本的 pandas Index 类型。
间隔
一个有界的类似切片的区间;IntervalArray 的元素。
interval_range
创建固定频率 IntervalIndex 的函数。
cut
将值分箱到离散区间。
qcut
将值基于排名或样本分位数分入等大小的区间。
备注
更多信息请参见 用户指南。
例子
一个新的
IntervalArray
可以直接从一个类似数组的Interval
对象集合中构造:>>> 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()
和IntervalArray.from_tuples()
。