HOWTO · Pandas
Rinomina colonne in Pandas DataFrame
Questo articolo spiega diversi modi per rinominare le colonne di un DataFrame pandas.
In questa pagina
Pandas offre tre modi pratici per rinominare le colonne di un DataFrame: assegnare un elenco completo tramite DataFrame.columns, mappare solo le etichette da modificare con DataFrame.rename() oppure sostituire l’intero insieme con DataFrame.set_axis(). Scegli in base al fatto che tu debba modificare tutte le etichette o solo alcune.
Scegliere un metodo per rinominare le colonne
Usa DataFrame.rename() per un piccolo gruppo di nomi noti da sostituire. Le etichette non incluse nella mappatura restano invariate: è una soluzione comoda quando devi rinominare solo alcune colonne. Usa DataFrame.columns o DataFrame.set_axis() se hai un’etichetta sostitutiva per ogni colonna. Entrambi i metodi basati su un elenco completo richiedono che il nuovo elenco contenga tante etichette quante sono le colonne del DataFrame.
Rinominare tutte le colonne con DataFrame.columns
Assegna un elenco direttamente all’attributo columns per sostituire tutte le etichette in una volta. L’esempio parte da ['Name', 'Age', 'Marks'] e assegna una nuova etichetta a ciascuna colonna. Le etichette originali sono riportate qui come testo selezionabile; il risultato stampato sotto contiene solo quelle rinominate, ['Name', 'Age', 'Roll_no']. Le etichette restano in inglese, come nel codice e nell’output:
Esegui questo esempio:
import pandas as pd
scores = pd.DataFrame(
[["John", 20, 45], ["Peter", 21, 62], ["Scot", 25, 68]],
columns=["Name", "Age", "Marks"],
)
scores.columns = ["Name", "Age", "Roll_no"]
print(list(scores.columns))
['Name', 'Age', 'Roll_no']
Questo metodo è diretto, ma devi specificare tutte le etichette, comprese quelle che vuoi lasciare invariate. Con un DataFrame molto ampio, può diventare scomodo. Inoltre, l’elenco sostitutivo deve contenere un nome per ogni colonna esistente; altrimenti pandas non può assegnare le etichette.
Rinominare alcune colonne con DataFrame.rename()
Passa un dizionario a columns: ogni chiave è un’etichetta esistente e il relativo valore è quella sostitutiva. L’esempio modifica solo Marks e lascia invariate le altre etichette. Per impostazione predefinita, DataFrame.rename() restituisce un nuovo DataFrame e lascia inalterato quello originale, quindi conserva il risultato. Nell’esempio, le etichette mostrate restano in inglese:
Esegui questo esempio:
import pandas as pd
scores = pd.DataFrame([["John", 20, 45]], columns=["Name", "Age", "Marks"])
renamed = scores.rename(columns={"Marks": "Score"})
print(list(renamed.columns))
['Name', 'Age', 'Score']
In alternativa, inplace=True applica la mappatura al DataFrame esistente. In questo caso, la chiamata restituisce None: non assegnare il valore restituito di nuovo al DataFrame. La mappatura è in genere la scelta più chiara quando devi rinominare solo alcune colonne ed evita di dover mantenere un elenco con tutte le etichette.
Sostituire le etichette delle colonne con DataFrame.set_axis()
DataFrame.set_axis() è un altro modo per sostituire l’intero insieme di etichette delle colonne. Passa l’elenco completo e seleziona l’asse delle colonne. Con il comportamento predefinito, assegna il DataFrame restituito a una variabile. Le etichette mostrate nell’esempio restano in inglese:
Esegui questo esempio:
import pandas as pd
scores = pd.DataFrame([["John", 20, 45]], columns=["Name", "Age", "Marks"])
renamed = scores.set_axis(["Name", "Age", "Score"], axis="columns")
print(list(renamed.columns))
['Name', 'Age', 'Score']
Come per l’assegnazione diretta, l’elenco deve includere tutte le colonne. Questo metodo è utile se il nuovo elenco è già disponibile in una variabile separata o se vuoi integrare la sostituzione in una catena di metodi. Non consente la mappatura selettiva delle vecchie etichette su quelle nuove offerta da DataFrame.rename().
Verificare il risultato e scegliere il metodo giusto
Dopo la modifica, esamina renamed.columns oppure stampa list(renamed.columns) per verificare che le etichette siano quelle desiderate. Il controllo è utile anche prima che il codice successivo faccia riferimento a una colonna per nome: un’etichetta scritta male o non aggiornata non corrisponderà alla colonna rinominata.
In breve, usa DataFrame.rename() per poche etichette selezionate. Scegli DataFrame.columns per sostituire direttamente tutte le etichette, oppure DataFrame.set_axis() quando l’elenco completo si integra bene in una chiamata o in una catena di metodi. Per entrambi i metodi basati su un elenco completo, conta le etichette e mantienile nello stesso ordine delle colonne del DataFrame.