HOWTO · Pandas
Pandas の行をドロップ
このチュートリアルでは、pandas.DataFrame.drop()メソッドを使って Pandas の行をドロップする方法を説明します。
このページの内容
このチュートリアルでは、pandas.DataFrame.drop() を使って pandas の DataFrame から行を削除する方法を説明します。drop() に渡す値はインデックスラベルです。デフォルトの整数インデックスでは、ラベルが行位置のように見えることがありますが、ラベルが必ず行位置を表すわけではありません。以下の例では、ラベルを直接指定する方法、行位置をラベルに変換する方法、列の条件に一致する行を削除する方法を紹介します。
次の例を実行します。
このセクションのコードと表示されるラベルや出力は英語のままです。
import pandas as pd
people = pd.DataFrame(
{"Name": ["Himansh", "Prateek", "Abhishek", "Vidit", "Anupam"],
"Age": [30, 33, 35, 30, 30]}
)
remaining = people.drop([0, 2])
print(remaining)
インデックスラベルを指定して行を削除する
drop() には、1つのラベルまたはラベルのリストを渡します。上の例ではデフォルトのインデックスが 0 から 4 なので、ラベル 0 と 2 はそれぞれ1行目と3行目を指します。戻り値の DataFrame では、残った行の元のラベルが維持され、pandas が自動的に番号を振り直すことはありません。後続の処理で連番のインデックスが必要なら、reset_index(drop=True) を使います。
独自のインデックスを使う場合は、実際のラベルを渡します。この独立した例では名前をラベルとして使っているため、"A" と "C" が1番目と3番目の項目を選ぶのは、それらのラベルが該当する行に割り当てられている場合に限られます。
このセクションのコードと表示されるラベルや出力は英語のままです。
import pandas as pd
people = pd.DataFrame(
{"Name": ["Himansh", "Prateek", "Abhishek", "Vidit", "Anupam"],
"Age": [30, 33, 35, 30, 30]},
index=["A", "B", "C", "D", "E"],
)
remaining = people.drop(["A", "C"])
print(remaining)
存在しないラベルを指定すると、デフォルトでは KeyError が発生します。ラベルが任意の場合は、errors="ignore" を渡すと存在しないラベルを無視できます。ただし、スペルミスまで見逃すおそれがあるため、意図を理解したうえで使ってください。
行位置を指定して行を削除する
drop() が受け取るのはラベルであり、行位置ではありません。0から始まる行位置を使って行を削除するには、まずインデックスから該当する位置を選び、そのラベルを drop() に渡します。インデックスが独自のものだったり、並べ替えられていたりする場合は、この違いが重要です。次の例だけで手順を確認できます。
このセクションのコードと表示されるラベルや出力は英語のままです。
import pandas as pd
people = pd.DataFrame(
{"Name": ["Himansh", "Prateek", "Abhishek", "Vidit", "Anupam"],
"Age": [30, 33, 35, 30, 30]},
index=["A", "B", "C", "D", "E"],
)
positions = [0, 2]
labels = people.index.take(positions)
remaining = people.drop(labels)
print(remaining)
ここでは、削除する前に位置 0 と 2 をラベル "A" と "C" に変換しています。ラベルがすでに分かっている場合は、前のセクションのように直接指定してください。削除するのではなく選んだ行を残すことが目的なら、位置による選択は iloc でも表せます。
列の値に基づいて行を削除する
条件に一致する行を削除するには、該当行のインデックスラベルを取得して drop() に渡します。この例では、年齢が33以下の行を条件で選びます。その行を削除するため、結果の DataFrame には33歳を超える人が残ります。
このセクションのコードと表示されるラベルや出力は英語のままです。
import pandas as pd
people = pd.DataFrame(
{"Name": ["Himansh", "Prateek", "Abhishek", "Vidit", "Anupam"],
"Age": [31, 33, 35, 36, 34]},
index=["A", "B", "C", "D", "E"],
)
remove_labels = people.index[people["Age"] <= 33]
remaining = people.drop(remove_labels)
print(remaining)
条件によって削除する行を特定できる場合は、この方法が便利です。残す行を示すほうが分かりやすいなら、people[people["Age"] > 33] のようなブール値によるフィルタリングを使います。この条件では、どちらの方法でも同じ行が残ります。「どの行を残すか」が主眼の場合は、フィルタリングのほうが読みやすいことがあります。
DataFrame.drop() の動作とよくある注意点
pandas.DataFrame.drop() はデフォルトで新しい DataFrame を返し、元のオブジェクトは変更しません。各例のように結果を変数に代入するか、後続の式で戻り値を使ってください。inplace=True を指定すると元のオブジェクトが変更され、戻り値は None になります。people = people.drop(...) のように代入するほうが、結果が明確になるため一般に読みやすくなります。
デフォルトでは、drop() はインデックスのラベルを削除します。列ラベルを削除するには、axis="columns" または columns=[...] を指定します。この記事では行ラベルを扱います。デフォルトの整数インデックスではラベルが位置のように見えることがありますが、独自のインデックスを使うとその違いが分かりやすくなります。結果が予想と違う場合は、people.index を確認し、条件が削除したい行を選んでいるか、また drop() の戻り値を使っているかを確かめてください。