pandas.IntervalIndex.to_tuples#

IntervalIndex.to_tuples(na_tuple=True)[source]#

Return an ndarray (if self is IntervalArray) or Index (if self is IntervalIndex) of tuples of the form (left, right).

Parameters:

na_tuplebool, default True: If True, return NA as a tuple (nan, nan). If False, just return NA as nan.

Returns:

ndarray or Index

An ndarray of tuples representing the intervals: if self is an IntervalArray.
An Index of tuples representing the intervals: if self is an IntervalIndex.

See also

IntervalArray.to_list: Convert IntervalArray to a list of tuples.
IntervalArray.to_numpy: Convert IntervalArray to a numpy array.
IntervalArray.unique: Find unique intervals in an IntervalArray.

Examples

For pandas.IntervalArray:

>>> idx = pd.arrays.IntervalArray.from_tuples([(0, 1), (1, 2)])
>>> idx
<IntervalArray>
[(0, 1], (1, 2]]
Length: 2, dtype: interval[int64, right]
>>> idx.to_tuples()
array([(0, 1), (1, 2)], dtype=object)

For pandas.IntervalIndex:

>>> idx = pd.interval_range(start=0, end=2)
>>> idx
IntervalIndex([(0, 1], (1, 2]], dtype='interval[int64, right]')
>>> idx.to_tuples()
Index([(0, 1), (1, 2)], dtype='object')