class pandas.IntervalIndex[source]

Immutable Index implementing an ordered, sliceable set. IntervalIndex represents an Index of Interval objects that are all closed on the same side.

New in version 0.20.0.


The indexing behaviors are provisional and may change in a future version of pandas.


data : array-like (1-dimensional)

Array-like containing Interval objects from which to build the IntervalIndex

closed : {‘left’, ‘right’, ‘both’, ‘neither’}, default ‘right’

Whether the intervals are closed on the left-side, right-side, both or neither.

name : object, optional

Name to be stored in the index.

copy : boolean, default False

Copy the meta-data

dtype : dtype or None, default None

If None, dtype will be inferred

..versionadded:: 0.23.0

See also

The base pandas Index type
A bounded slice-like interval; the elements of an IntervalIndex
Function to create a fixed frequency IntervalIndex

cut, qcut


See the user guide for more.


A new IntervalIndex is typically constructed using interval_range():

>>> pd.interval_range(start=0, end=5)
IntervalIndex([(0, 1], (1, 2], (2, 3], (3, 4], (4, 5]]
              closed='right', dtype='interval[int64]')

It may also be constructed using one of the constructor methods: IntervalIndex.from_arrays(), IntervalIndex.from_breaks(), and IntervalIndex.from_tuples().

See further examples in the doc strings of interval_range and the mentioned constructor methods.


left Return the left endpoints of each Interval in the IntervalIndex as
right Return the right endpoints of each Interval in the IntervalIndex as
closed Whether the intervals are closed on the left-side, right-side, both or
length Return an Index with entries denoting the length of each Interval in


from_arrays(left, right[, closed, name, ...]) Construct an IntervalIndex from a a left and right array
from_tuples(data[, closed, name, copy, dtype]) Construct an IntervalIndex from a list/array of tuples
from_breaks(breaks[, closed, name, copy, dtype]) Construct an IntervalIndex from an array of splits
contains(key) Return a boolean indicating if the key is IN the index
Scroll To Top