HOWTO · Matplotlib

Come ruotare il testo delle etichette delle tacche dell’asse X in Matplotlib

Impara cinque modi per ruotare le etichette delle tacche dell’asse x in Matplotlib e allinearle quando le etichette lunghe si sovrappongono.

In questa pagina

Per ruotare le etichette delle tacche dell’asse x in Matplotlib, passa un angolo, ad esempio rotation=45, a plt.xticks, fig.autofmt_xdate, ax.set_xticklabels, plt.setp oppure ax.tick_params. Un angolo di 45 gradi è un buon punto di partenza quando le etichette orizzontali lunghe si sovrappongono; allinea quelle ruotate con ha="right" per mantenere le estremità vicino alle rispettive tacche. Gli esempi seguenti mostrano quando è utile ciascuna API.

Senza rotazione, i nomi di categoria come i mesi restano orizzontali e occupano l’intera larghezza dell’asse, quindi nomi più lunghi o una figura più stretta fanno sovrapporre le etichette vicine:

Grafico a linee dei valori mensili con etichette orizzontali January, February, March e April che occupano l’intera larghezza dell’asse.

Ruotare le etichette delle tacche dell’asse x con plt.xticks

plt.xticks è un’opzione concisa quando si lavora con pyplot. La parola chiave rotation imposta l’angolo in gradi; per impostazione predefinita, le etichette sono orizzontali. Questo esempio crea un grafico con categorie e ruota le relative etichette di 45 gradi.

import matplotlib.pyplot as plt

months = ["January", "February", "March", "April"]
values = [12, 18, 15, 22]

fig, ax = plt.subplots()
ax.plot(months, values, marker="o")
plt.xticks(rotation=45, ha="right")
ax.grid(True)
fig.tight_layout()

Lo stesso grafico a linee mensile con le etichette ruotate di 45 gradi e allineate a destra, in modo che ogni etichetta termini in corrispondenza della sua tacca.

Usa plt.xticks per apportare rapidamente una modifica agli assi correnti. Se il codice usa già un oggetto Axes, i metodi descritti nelle sezioni seguenti permettono di indicare esplicitamente gli assi interessati.

Ruotare le etichette dell’asse delle date con fig.autofmt_xdate

Nei grafici basati sulle date, fig.autofmt_xdate formatta le etichette delle date della figura e le ruota per migliorarne la leggibilità. Le impostazioni predefinite modificano anche l’allineamento e il margine inferiore; se vuoi un angolo specifico, puoi impostare rotation esplicitamente. Il comportamento dipende dagli assi della figura e dal formato delle date: usa questo metodo per gli assi temporali, non come sostituto generale di ogni impostazione delle etichette delle tacche.

import matplotlib.pyplot as plt
from datetime import date, timedelta

start = date(2024, 1, 1)
dates = [start + timedelta(days=7 * i) for i in range(6)]
values = [3, 5, 4, 7, 6, 9]

fig, ax = plt.subplots()
ax.plot(dates, values, marker="o")
fig.autofmt_xdate(rotation=45)
ax.grid(True)

Grafico a linee con sei date settimanali di gennaio e febbraio 2024 ed etichette di data ruotate di 45 gradi tramite autofmt_xdate.

È una soluzione pratica quando l’asse x contiene date e le relative etichette formattate richiedono rotazione e spaziatura. Per le normali categorie, scegli uno dei metodi per le etichette delle tacche descritti nelle altre sezioni.

Impostare le etichette e ruotarle con ax.set_xticklabels

Usa ax.set_xticklabels quando vuoi specificare sia il testo personalizzato delle etichette sia la loro rotazione. Prima imposta esplicitamente le posizioni delle tacche e fornisci un’etichetta per ciascuna posizione, così ogni stringa resta associata alla tacca prevista. Per ruotare le etichette non serve sostituirle: usa tick_params o plt.setp per mantenere il testo esistente.

import matplotlib.pyplot as plt

positions = [0, 1, 2, 3]
labels = ["North region", "South region", "East region", "West region"]
values = [8, 5, 9, 6]

fig, ax = plt.subplots()
ax.plot(positions, values, marker="o")
ax.set_xticks(positions)
ax.set_xticklabels(labels, rotation=45, ha="right")
ax.grid(True)
fig.tight_layout()

Grafico a linee con etichette personalizzate North region, South region, East region e West region ruotate di 45 gradi e allineate a destra.

Mantieni le posizioni e le etichette nello stesso ordine. Se in seguito cambiano le tacche del grafico, aggiorna le etichette personalizzate in modo che corrispondano.

Impostare le proprietà delle etichette con plt.setp

plt.setp aggiorna le proprietà degli artisti Matplotlib esistenti, inclusi gli oggetti delle etichette delle tacche dell’asse x restituiti da ax.get_xticklabels(). È utile quando le etichette sono già presenti e vuoi modificarne solo l’aspetto.

import matplotlib.pyplot as plt

categories = ["First quarter", "Second quarter", "Third quarter", "Fourth quarter"]
values = [14, 17, 13, 21]

fig, ax = plt.subplots()
ax.plot(categories, values, marker="o")
plt.setp(ax.get_xticklabels(), rotation=45, ha="right")
ax.grid(True)
fig.tight_layout()

Grafico a linee dei valori trimestrali con le etichette ruotate di 45 gradi e allineate a destra tramite plt.setp.

In questo esempio, rotation modifica l’angolo e ha imposta l’allineamento orizzontale. Le proprietà vengono aggiornate sugli oggetti correnti delle etichette delle tacche, senza sostituirne il testo.

Impostare la rotazione delle etichette dell’asse x con ax.tick_params

ax.tick_params imposta le proprietà delle tacche, delle relative etichette e delle linee della griglia per un asse specifico. Passa axis="x" e la parola chiave minuscola labelrotation per ruotare le etichette dell’asse x mantenendone invariati il testo e le posizioni.

import matplotlib.pyplot as plt

categories = ["Planning", "Development", "Review", "Delivery"]
values = [2, 5, 3, 6]

fig, ax = plt.subplots()
ax.plot(categories, values, marker="o")
ax.tick_params(axis="x", labelrotation=45)
ax.grid(True)
fig.tight_layout()

Grafico a linee di quattro fasi di progetto con le etichette ruotate di 45 gradi tramite la parola chiave labelrotation di tick_params.

Usa questa forma a livello di asse quando hai già un riferimento Axes. La parola chiave si scrive labelrotation, tutta in minuscolo.

Allineare le etichette delle tacche ruotate

La rotazione modifica l’angolo, mentre l’allineamento orizzontale determina quale parte dell’etichetta si trova in corrispondenza della tacca. Con ha="right", l’estremità destra dell’etichetta coincide con la tacca; con ha="left", coincide l’estremità sinistra; con ha="center", coincide il punto centrale. Per le etichette ruotate di 45 gradi che si estendono a sinistra delle tacche, l’allineamento a destra è una scelta comune. Prova le diverse opzioni in base alla lunghezza delle etichette e alla disposizione del grafico.

import matplotlib.pyplot as plt

positions = [0, 1, 2, 3]
labels = ["January", "February", "March", "April"]
values = [4, 7, 5, 8]
alignments = ["right", "left", "center"]

fig, axes = plt.subplots(1, 3, figsize=(10, 3))
for ax, alignment in zip(axes, alignments):
    ax.plot(positions, values, marker="o")
    ax.set_xticks(positions)
    ax.set_xticklabels(labels, rotation=45, ha=alignment)
    ax.set_title(f'ha="{alignment}"')
    ax.grid(True)
fig.tight_layout()

Tre grafici a linee affiancati che confrontano etichette a 45 gradi con allineamento orizzontale right, left e center.

Scegli l’allineamento in base al punto in cui vuoi ancorare ciascuna etichetta. Se le etichette sono ancora troppo ravvicinate, oltre a ruotarle puoi aumentare la larghezza della figura o abbreviare il testo.

Gestire etichette tagliate ed errori di conteggio delle etichette

Restano due possibili fallimenti anche quando la rotazione in sé funziona. Primo, ax.set_xticklabels sostituisce il testo delle etichette, quindi il numero di etichette deve essere uguale al numero di posizioni delle tacche. Passare tre etichette per quattro posizioni fa fallire la chiamata prima che venga disegnato qualsiasi elemento:

import matplotlib.pyplot as plt

positions = [0, 1, 2, 3]
labels = ["North", "South", "East"]
values = [8, 5, 9, 6]

fig, ax = plt.subplots()
ax.plot(positions, values, marker="o")
ax.set_xticks(positions)
ax.set_xticklabels(labels, rotation=45, ha="right")

La chiamata termina con questo errore:

ValueError: The number of FixedLocator locations (4), usually from a call to set_ticks, does not match the number of labels (3).

Aggiunga l’etichetta mancante in modo che le due sequenze abbiano la stessa lunghezza, nello stesso ordine. Se deve solo ruotare il testo esistente, preferisca plt.setp o ax.tick_params: mantengono le etichette correnti, quindi questa discrepanza non può verificarsi.

Secondo, la rotazione cambia l’angolo ma non crea spazio sotto l’asse. Esegua il rendering dell’esempio set_xticklabels qui sopra senza la chiamata a fig.tight_layout() e le etichette ruotate supereranno il bordo inferiore della figura: in un rendering di dimensioni predefinite si estendono circa 31 pixel oltre il bordo e vengono tagliate a metà del testo:

Grafico a linee con etichette di regione a 45 gradi tagliate sul bordo inferiore della figura perché non è stato applicato tight_layout.

fig.tight_layout() ricalcola il riquadro della figura in modo che ogni etichetta trovi spazio; misurate allo stesso modo, le etichette terminano allora esattamente sul bordo della figura, senza nulla all’esterno. fig.autofmt_xdate esegue lo stesso tipo di regolazione dei margini per gli assi di data. Se dopo la regolazione del layout le etichette continuano a collidere, accorci il testo delle etichette o allarghi la figura invece di aumentare l’angolo.