Python Pandas – IntervalIndexの区間が重複しているかどうかを確認する方法

PythonのPandasライブラリでは、IntervalIndexに含まれる区間同士が重複しているかどうかを確認したい場合があります。そのようなときは、is_overlappingプロパティを使うことで簡単に判定できます。

この記事では、実際のコード例とともに、IntervalIndexの区間重複チェックの手順をわかりやすく解説します。

is_overlappingプロパティとは

is_overlappingは、IntervalIndex内の区間が互いに重なり合っている場合にTrue、重複していない場合にFalseを返すブール型のプロパティです。データ分析において、時間帯や数値範囲の管理を行う際に、区間の重複検出は非常に便利な機能です。

必要なライブラリのインポート

まず、必要なライブラリをインポートします。

import pandas as pd

IntervalIndexの作成

次に、タプルのリストからIntervalIndexを作成します。ここでは「(10, 20)」と「(15, 25)」という2つの区間を持つインデックスを作成します。

interval = pd.IntervalIndex.from_tuples([(10, 20), (15, 25)])

IntervalIndexの表示

作成したIntervalIndexを表示して確認します。

print("IntervalIndex...\n", interval)

区間が重複しているかどうかの確認

is_overlappingプロパティを使って、区間が重複しているかどうかを出力します。

print("\nIs the interval overlapping?\n", interval.is_overlapping)

完全なコード例

以下に、ここまでの手順をまとめた完全なコードを示します。

import pandas as pd

# IntervalIndexを作成
interval = pd.IntervalIndex.from_tuples([(10, 20), (15, 25)])

# IntervalIndexを表示
print("IntervalIndex...\n", interval)

# 各区間の長さを表示
print("\nIntervalIndex length...\n", interval.length)

# 区間が重複しているかどうかを確認
print("\nIs the interval overlapping?\n", interval.is_overlapping)

実行結果

上記のコードを実行すると、以下のような出力が得られます。

IntervalIndex...
IntervalIndex([(10, 20], (15, 25]], dtype='interval[int64, right]')

IntervalIndex length...
Int64Index([10, 10], dtype='int64')

Is the interval overlapping?
True

結果の解説

この例では、「(10, 20]」と「(15, 25]」という2つの区間を作成しました。これらの区間は15〜20の範囲で重なっているため、is_overlappingはTrueを返しています。

もし区間がまったく重ならない場合（例えば「(10, 20]」と「(21, 30]」など）、このプロパティはFalseを返します。

デフォルト設定では、from_tuplesメソッドで作成される区間は右側が閉じた半開区間（right）となる点にも注意してください。区間の端の扱いによって重複判定の結果が変わる可能性があるため、closed引数で区間の開閉を明示的に指定することも推奨されます。