HOWTO · Pandas
Wie man den Index eines Pandas-DataFrame in eine Spalte umwandelt
Dieses Tutorial zeigt, wie Sie mit df.index oder reset_index den Index eines pandas-DataFrame als Spalte hinzufügen, die Spalte mit rename_axis benennen und die Ebenen eines MultiIndex in Spalten umwandeln.
Auf dieser Seite
Um die Indexwerte eines DataFrame als gewöhnliche Spalten hinzuzufügen, verwenden Sie reset_index(). Die Methode gibt einen neuen DataFrame zurück, in dem der bisherige Index in einer oder mehreren Spalten steht und ein standardmäßiger ganzzahliger Index verwendet wird. Soll eine Kopie des Index neben dem bestehenden Index erhalten bleiben, weisen Sie stattdessen df.index einer Spalte zu. Mit rename_axis() können Sie vor dem Zurücksetzen den Namen der Indexspalte festlegen. Derselbe Aufruf reset_index() wandelt jede Ebene eines MultiIndex in eine Spalte um.
Den Index mit df.index als Spalte hinzufügen
Durch die Zuweisung von df.index werden die Indexwerte in eine Spalte kopiert; der Index des DataFrame bleibt dabei erhalten. Das ist hilfreich, wenn Sie den Index sowohl als Zeilenbeschriftung als auch als Datenwert benötigen. Die neue Spalte heißt hier index; wählen Sie eine andere Bezeichnung, wenn sie Ihre Daten besser beschreibt. Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
import pandas as pd
df = pd.DataFrame({"name": ["Ada", "Lin"], "score": [8, 9]}, index=[101, 102])
df["index"] = df.index
print(df.to_dict(orient="records"))
print("row labels:", df.index.tolist())
[{'name': 'Ada', 'score': 8, 'index': 101}, {'name': 'Lin', 'score': 9, 'index': 102}]
row labels: [101, 102]
Die Datensätze zeigen die kopierten Werte. Die zweite Ausgabezeile bestätigt, dass die ursprünglichen Zeilenbeschriftungen erhalten bleiben. Durch diese Zuweisung entsteht kein neuer Standardindex. Falls bereits eine Spalte den gewählten Namen trägt, wählen Sie eine andere Spaltenbezeichnung, damit diese Daten nicht ersetzt werden.
Den Index mit reset_index als Spalte hinzufügen
Rufen Sie reset_index() auf, um die Indexwerte in die Spalten des zurückgegebenen DataFrame zu übernehmen. Bei einem benannten Index wird dessen Name zum Spaltennamen. Ist der Index unbenannt, verwendet pandas den Namen index, sofern dieser noch verfügbar ist. Der Aufruf ändert den ursprünglichen DataFrame nicht, solange Sie das Ergebnis nicht wieder zuweisen. Wenn Sie das Ergebnis einer Variablen zuweisen, wird die neue Struktur ausdrücklich verfügbar. Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
import pandas as pd
df = pd.DataFrame({"score": [8, 9]}, index=pd.Index([101, 102], name="record_id"))
converted = df.reset_index()
print(converted.to_dict(orient="records"))
print("columns:", converted.columns.tolist())
[{'record_id': 101, 'score': 8}, {'record_id': 102, 'score': 9}]
columns: ['record_id', 'score']
Standardmäßig erhält das Ergebnis einen neuen ganzzahligen Index, der bei null beginnt. Verwenden Sie reset_index(drop=True), wenn Sie den Index zurücksetzen, den bisherigen Index aber nicht als Spalte übernehmen möchten. Falls der erzeugte Name der Indexspalte mit einer vorhandenen Spalte kollidiert, benennen Sie eine der beiden Spalten vor dem Zurücksetzen um.
Den Namen der Indexspalte mit rename_axis festlegen
rename_axis() legt den Namen des Index fest; reset_index() verwendet diesen Namen anschließend für die neue Spalte. Das funktioniert auch, wenn der ursprüngliche Index keinen Namen hat. Die Verkettung gibt einen DataFrame und keine Series zurück, sodass die übrigen Spalten und ihre Zeilenwerte erhalten bleiben. Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
import pandas as pd
df = pd.DataFrame({"city": ["Oslo", "Lima"], "visitors": [12, 7]}, index=[1, 2])
converted = df.rename_axis("site_id").reset_index()
print(converted.to_dict(orient="records"))
[{'site_id': 1, 'city': 'Oslo', 'visitors': 12}, {'site_id': 2, 'city': 'Lima', 'visitors': 7}]
Sie können den Namen auch direkt beim Erstellen eines Index festlegen. rename_axis() ist jedoch praktisch, wenn der DataFrame bereits vorliegt oder die Umwandlungsschritte zusammenhängend dargestellt werden sollen. Angaben zu Parametern und Rückgabeverhalten von reset_index() finden Sie in der Referenz zu DataFrame.reset_index.
Ein MultiIndex in Spalten umwandeln
Ein MultiIndex speichert eine Zeilenbeschriftung auf mehreren Ebenen. Der Aufruf reset_index() überführt jede Ebene in eine eigene Spalte und erhält dabei die Kombinationen und zugehörigen Werte. Das ist nützlich, bevor Sie Daten exportieren oder mit Daten verbinden, die gewöhnliche Spalten erwarten. Das folgende deterministische Beispiel wandelt die beiden benannten Ebenen um:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
import pandas as pd
index = pd.MultiIndex.from_tuples(
[("North", "A"), ("North", "B"), ("South", "A")],
names=["region", "code"],
)
df = pd.DataFrame({"sales": [5, 8, 3]}, index=index)
converted = df.reset_index()
print(converted.to_dict(orient="records"))
[{'region': 'North', 'code': 'A', 'sales': 5}, {'region': 'North', 'code': 'B', 'sales': 8}, {'region': 'South', 'code': 'A', 'sales': 3}]
Jede bisherige Indexebene steht nun in einer eigenen Spalte; sales bleibt der ursprünglichen Region und dem zugehörigen Code zugeordnet. Wenn Sie stattdessen eine gewöhnliche Spalte in den Index verschieben möchten, übernimmt set_index() diese umgekehrte Umwandlung. Sie hat eine andere Richtung als die hier gezeigten Umwandlungen.