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

Un segmento verde finito che unisce i due estremi tracciati

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

Un segmento orizzontale rosso finito e un segmento verticale verde finito

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

Due segmenti indipendenti aggiunti a una LineCollection di Matplotlib

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.