HOWTO · Pandas
Converti l'indice di un DataFrame Pandas in una colonna
Scopri come aggiungere l’indice di un DataFrame pandas come colonna con df.index o reset_index, assegnare un nome alla colonna con rename_axis e convertire i livelli di un MultiIndex in colonne.
In questa pagina
Per aggiungere i valori dell’indice di un DataFrame come normali colonne, usa reset_index(). Il metodo restituisce un nuovo DataFrame con l’indice precedente in una o più colonne e un indice intero predefinito. Se vuoi copiare l’indice in una colonna mantenendo quello esistente, assegna invece df.index a una colonna. Usa rename_axis() prima di reimpostare l’indice se vuoi scegliere il nome della colonna. La stessa operazione reset_index() trasforma ogni livello di un MultiIndex in una colonna.
Aggiungere l’indice come colonna con df.index
Assegnando df.index, i valori dell’indice vengono copiati in una colonna e l’indice del DataFrame rimane invariato. È utile quando ti servono i valori dell’indice sia come etichette delle righe sia come dati. In questo esempio la nuova colonna si chiama index; scegli un’altra etichetta se descrive meglio i tuoi dati. Esegui questo esempio:
Il codice e le etichette o gli output visibili in questa sezione restano in inglese.
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]
I record mostrano i valori copiati, mentre la seconda riga conferma che le etichette originali delle righe sono rimaste invariate. Questa assegnazione non crea un nuovo indice predefinito. Se una colonna ha già il nome scelto, seleziona un’etichetta diversa per evitare di sostituirne i dati.
Aggiungere l’indice come colonna con reset_index
Chiama reset_index() per spostare i valori dell’indice nelle colonne del DataFrame restituito. Se l’indice ha un nome, questo diventa il nome della colonna. Se l’indice non ha nome, pandas usa index quando quel nome è disponibile. L’operazione non modifica il DataFrame originale, a meno che tu non assegni nuovamente il risultato; assegnarlo a una variabile rende esplicita la nuova struttura. Esegui questo esempio:
Il codice e le etichette o gli output visibili in questa sezione restano in inglese.
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']
Per impostazione predefinita, il risultato riceve un nuovo indice intero che parte da zero. Usa reset_index(drop=True) se vuoi reimpostare l’indice senza conservare quello precedente come colonna. Se il nome generato per la colonna dell’indice è già usato, rinomina una delle colonne prima di reimpostare l’indice.
Assegnare un nome alla colonna dell’indice con rename_axis
rename_axis() assegna un nome all’indice e, successivamente, reset_index() usa quel nome per la nuova colonna. Funziona anche quando l’indice di origine non ha un nome. La concatenazione dei metodi restituisce un DataFrame, non una Series, quindi conserva le altre colonne e i relativi valori delle righe. Esegui questo esempio:
Il codice e le etichette o gli output visibili in questa sezione restano in inglese.
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}]
Puoi anche assegnare un nome direttamente quando crei un indice, ma rename_axis() è comodo se il DataFrame esiste già o se vuoi tenere insieme i passaggi della conversione. Per i parametri e il comportamento del valore restituito da reset_index(), consulta il riferimento a DataFrame.reset_index.
Convertire un MultiIndex in colonne
Un MultiIndex memorizza un’etichetta di riga su più livelli. Chiamando reset_index(), ogni livello viene spostato in una colonna distinta, mantenendo le combinazioni e i valori associati. È utile prima di esportare o unire dati che richiedono colonne ordinarie. L’esempio deterministico seguente converte i due livelli con nome:
Il codice e le etichette o gli output visibili in questa sezione restano in inglese.
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}]
Ogni livello dell’indice precedente è ora una colonna separata e sales resta associato alla regione e al codice originali. Se invece devi spostare una colonna ordinaria nell’indice, set_index() esegue la trasformazione inversa, procedendo nella direzione opposta rispetto alle conversioni mostrate qui.