HOWTO · Matplotlib
Come disegnare una linea arbitraria in Matplotlib
Disegna segmenti di linea finiti in Matplotlib con plot(), hlines(), vlines() e LineCollection.
In questa pagina
Per disegnare un singolo segmento di linea finito in Matplotlib, passa a Axes.plot() le coordinate dei suoi due estremi. Usa hlines() o vlines() quando il segmento è orizzontale o verticale, e usa LineCollection quando hai molti segmenti indipendenti. Queste API usano coordinate dei dati; axhline(), axvline() e axline() risolvono un problema diverso, cioè una linea che attraversa gli assi o una linea infinita.
Gli esempi usano Python con Matplotlib. Installa Matplotlib con python -m pip install matplotlib se non è già disponibile. Ogni esempio eseguibile salva un file PNG, così può essere verificato in un ambiente non interattivo; sostituisci savefig() con plt.show() quando vuoi una finestra interattiva.
Disegnare un segmento finito con plot()
Per un segmento da (x1, y1) a (x2, y2), passa a plot() una sequenza di due valori x e una sequenza di due valori y. Matplotlib collega i valori nelle stesse posizioni, quindi la prima coppia x/y è un estremo e la seconda è l’altro.
import matplotlib.pyplot as plt
fig, ax = plt.subplots()
ax.plot([3, 5], [1, 6], color="tab:green", marker="o")
ax.set(xlabel="x", ylabel="y", title="Finite segment with plot()")
fig.savefig("plot-segment.png", dpi=120)
print("saved: plot-segment.png")
saved: plot-segment.png
Il marcatore rende visibili i due estremi. Aggiungi altre coppie di valori solo quando vuoi creare una polilinea: plot() collega i punti consecutivi invece di creare segmenti indipendenti.
Disegnare segmenti finiti orizzontali o verticali
Usa hlines(y, xmin, xmax) per un segmento orizzontale e vlines(x, ymin, ymax) per un segmento verticale. La coordinata mantenuta costante è il primo argomento; gli altri due argomenti sono gli estremi finiti nelle coordinate dei dati.
import matplotlib.pyplot as plt
fig, ax = plt.subplots()
ax.hlines(3, 2, 5, color="tab:red")
ax.vlines(6, 1, 5, color="tab:green")
ax.set(xlim=(0, 7), ylim=(0, 6), xlabel="x", ylabel="y")
fig.savefig("horizontal-vertical-segments.png", dpi=120)
print("saved: horizontal-vertical-segments.png")
saved: horizontal-vertical-segments.png
Qui il segmento rosso va da (2, 3) a (5, 3), mentre quello verde va da (6, 1) a (6, 5). I limiti espliciti rendono chiaro l’intervallo dei dati previsto ed evitano di interpretare una linea ritagliata come un segmento più corto.
Non sostituire una linea di riferimento che attraversa gli assi
axhline() e axvline() sono utili linee di riferimento, ma si estendono lungo una direzione dell’area degli assi invece di usare due estremi nelle coordinate dei dati. Analogamente, axline() rappresenta una linea infinita che passa per punti o usa una pendenza. Usa una di queste API solo quando questo comportamento è quello richiesto dal grafico.
import matplotlib.pyplot as plt
fig, ax = plt.subplots()
segment = ax.hlines(3, 2, 5, color="tab:red")
reference = ax.axhline(3, color="0.35", linestyle="--")
assert segment.get_segments()[0].tolist() == [[2.0, 3.0], [5.0, 3.0]]
assert reference.get_transform() is ax.get_yaxis_transform()
print("hlines endpoints: [2.0, 3.0] to [5.0, 3.0]")
print("axhline uses axes-relative x coordinates")
hlines endpoints: [2.0, 3.0] to [5.0, 3.0]
axhline uses axes-relative x coordinates
L’asserzione mostra la differenza: hlines() conserva estremi finiti nelle coordinate dei dati, mentre axhline() usa coordinate relative agli assi per la propria estensione orizzontale. Questa distinzione è importante quando fai zoom, modifichi i limiti o esporti un grafico.
Disegnare molti segmenti indipendenti con LineCollection
Quando servono molti segmenti disconnessi, crea una LineCollection a partire da una sequenza di segmenti composti da due punti e aggiungila a un asse. Chiamare autoscale() dopo add_collection() include la raccolta nella scala degli assi; imposta invece limiti espliciti quando un intervallo di visualizzazione fisso fa parte del grafico.
import matplotlib.pyplot as plt
from matplotlib.collections import LineCollection
segments = [[(1, 10), (6, 9)], [(1, 7), (3, 6)]]
collection = LineCollection(segments, colors=["tab:red", "tab:green"])
fig, ax = plt.subplots()
ax.add_collection(collection)
ax.autoscale()
ax.set(xlabel="x", ylabel="y", title="Two independent segments")
fig.savefig("line-collection.png", dpi=120)
print("segments: 2")
print("saved: line-collection.png")
segments: 2
saved: line-collection.png
LineCollection è adatta a molti segmenti perché li raggruppa in un’unica raccolta. Non collega la fine di un segmento all’inizio del successivo; questa è la differenza fondamentale rispetto al passaggio di una sequenza di punti più lunga a plot().
Scegliere l’API adatta alla geometria
Scegli plot() per un segmento o un percorso connesso, hlines() e vlines() per segmenti finiti paralleli agli assi e LineCollection per un gruppo di segmenti indipendenti. Preferisci axhline() o axvline() solo per una guida che attraversa gli assi e ricorda che axline() è infinita.
Per i dettagli sui parametri e sulle opzioni di stile, consulta la documentazione ufficiale di plot(), hlines(), vlines() e LineCollection. Gli esempi precedenti sono stati eseguiti con Matplotlib 3.11.2 nel container Polyglot locale registrato.