matplotlib.pyplot

matplotlib.pyplotè un'interfaccia basata sullo stato per matplotlib. Fornisce un modo di tracciare implicito, simile a MATLAB. Apre anche le figure sullo schermo e funge da gestore della GUI delle figure.

pyplot è principalmente destinato a grafici interattivi e semplici casi di generazione di grafici programmatici:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)

L'API esplicita orientata agli oggetti è consigliata per grafici complessi, sebbene pyplot sia ancora solitamente utilizzato per creare la figura e spesso gli assi nella figura. Vedere pyplot.figure, pyplot.subplots, e pyplot.subplot_mosaicper creare figure e Axes API per i metodi di tracciamento su un Axes:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

Vedere Matplotlib Application Interfaces (API) per una spiegazione dei compromessi tra le interfacce implicite ed esplicite.

Comandi di plottaggio

acorr	Tracciare l'autocorrelazione di x .
angle_spectrum	Traccia lo spettro degli angoli.
annotate	Annotare il punto xy con il testo text .
arrow	Aggiungi una freccia agli assi.
autoscale	Ridimensiona automaticamente la vista dell'asse rispetto ai dati (attiva/disattiva).
axes	Aggiungi un Axes alla figura corrente e rendilo l'Axes corrente.
axhline	Aggiungi una linea orizzontale attraverso gli assi.
axhspan	Aggiungi una campata orizzontale (rettangolo) attraverso gli assi.
axis	Metodo pratico per ottenere o impostare alcune proprietà dell'asse.
axline	Aggiungi una linea retta infinitamente lunga.
axvline	Aggiungi una linea verticale attraverso gli assi.
axvspan	Aggiungi un'estensione verticale (rettangolo) attraverso gli assi.
bar	Crea un grafico a barre.
bar_label	Etichetta un grafico a barre.
barbs	Traccia un campo 2D di punte.
barh	Crea un grafico a barre orizzontali.
box	Attiva o disattiva la casella degli assi sugli assi correnti.
boxplot	Disegna un grafico a scatola e baffi.
broken_barh	Traccia una sequenza orizzontale di rettangoli.
cla	Cancella gli assi correnti.
clabel	Etichetta un grafico di contorno.
clf	Cancella la cifra corrente.
clim	Imposta i limiti di colore dell'immagine corrente.
close	Chiudere una finestra figura.
cohere	Tracciare la coerenza tra x e y .
colorbar	Aggiungi una barra dei colori a un grafico.
contour	Traccia le curve di livello.
contourf	Traccia i contorni riempiti.
csd	Tracciare la densità cross-spettrale.
delaxes	Rimuove un Axes(predefinito agli assi correnti) dalla sua figura.
draw	Ridisegna la figura corrente.
draw_if_interactive	Ridisegna la figura corrente se in modalità interattiva.
errorbar	Traccia y contro x come linee e/o indicatori con barre di errore allegate.
eventplot	Traccia linee parallele identiche nelle posizioni date.
figimage	Aggiungi un'immagine non ricampionata alla figura.
figlegend	Metti una legenda sulla figura.
fignum_exists	Restituisce se la figura con l'id specificato esiste.
figtext	Aggiungi testo alla figura.
figure	Crea una nuova figura o attiva una figura esistente.
fill	Traccia poligoni pieni.
fill_between	Riempi l'area tra due curve orizzontali.
fill_betweenx	Riempi l'area tra due curve verticali.
findobj	Trova oggetti d'artista.
gca	Ottieni gli assi attuali.
gcf	Ottieni la cifra attuale.
gci	Ottieni l'attuale artista colorabile.
get	Restituisci il valore di una Artistproprietà di o stampali tutti.
get_cmap	Ottieni un'istanza di colormap, impostando per impostazione predefinita i valori rc se name è None.
get_figlabels	Restituisce un elenco di etichette di figure esistenti.
get_fignums	Restituisce un elenco di numeri di figura esistenti.
getp	Restituisci il valore di una Artistproprietà di o stampali tutti.
grid	Configura le linee della griglia.
hexbin	Crea un grafico binning esagonale 2D dei punti x , y .
hist	Calcolare e tracciare un istogramma.
hist2d	Crea un grafico dell'istogramma 2D.
hlines	Traccia linee orizzontali in ogni y da xmin a xmax .
imread	Legge un'immagine da un file in un array.
imsave	Salva un array come file immagine.
imshow	Visualizza i dati come un'immagine, ad esempio su un normale raster 2D.
install_repl_displayhook	Connettersi all'hook di visualizzazione della shell corrente.
ioff	Disabilita la modalità interattiva.
ion	Attiva la modalità interattiva.
isinteractive	Restituisce se i grafici vengono aggiornati dopo ogni comando di tracciamento.
legend	Posiziona una legenda sugli assi.
locator_params	Comportamento di controllo dei principali localizzatori di zecche.
loglog	Crea un grafico con scala logaritmica su entrambi gli assi x e y.
magnitude_spectrum	Tracciare lo spettro di magnitudo.
margins	Imposta o recupera i margini di ridimensionamento automatico.
matshow	Visualizza un array come matrice in una nuova finestra di figura.
minorticks_off	Rimuovi le zecche minori dagli assi.
minorticks_on	Visualizza segni di spunta minori sugli assi.
pause	Esegui il ciclo di eventi della GUI per secondi di intervallo .
pcolor	Crea un grafico pseudocolore con una griglia rettangolare non regolare.
pcolormesh	Crea un grafico pseudocolore con una griglia rettangolare non regolare.
phase_spectrum	Tracciare lo spettro di fase.
pie	Traccia un grafico a torta.
plot	Traccia y contro x come linee e/o marcatori.
plot_date	[ Sconsigliato ] Trama che costringe l'asse a trattare i float come date.
polar	Crea una trama polare.
psd	Tracciare la densità spettrale di potenza.
quiver	Traccia un campo di frecce 2D.
quiverkey	Aggiungi una chiave a un diagramma di faretra.
rc	Imposta la corrente rcParams. gruppo è il raggruppamento per rc, ad esempio, per lines.linewidthil gruppo è lines, per axes.facecolor, il gruppo è axese così via. Il gruppo può anche essere un elenco o una tupla di nomi di gruppi, ad esempio ( xtick , ytick ). kwargs è una coppia nome/valore dell'attributo del dizionario, ad esempio,::.
rc_context	Restituisce un gestore di contesto per modificare temporaneamente rcParams.
rcdefaults	Ripristina rcParamsdallo stile predefinito interno di Matplotlib.
rgrids	Ottieni o imposta le linee della griglia radiale sul grafico polare corrente.
savefig	Salva la cifra corrente.
sca	Imposta l'attuale Axes su ax e l'attuale Figure sul genitore di ax .
scatter	Un grafico a dispersione di y vs.
sci	Imposta l'immagine corrente.
semilogx	Crea un grafico con scala logaritmica sull'asse x.
semilogy	Crea un grafico con scala logaritmica sull'asse y.
set_cmap	Imposta la mappa colori predefinita e la applica all'immagine corrente, se presente.
set_loglevel	Imposta il root logger di Matplotlib e il livello del gestore del root logger, creando il gestore se non esiste ancora.
setp	Impostare una o più proprietà su un Artisto elencare i valori consentiti.
show	Visualizza tutte le figure aperte.
specgram	Traccia uno spettrogramma.
spy	Tracciare il modello di scarsità di un array 2D.
stackplot	Disegna un grafico ad area sovrapposta.
stairs	Una funzione costante graduale come una linea con bordi di delimitazione o un grafico pieno.
stem	Crea un grafico a stelo.
step	Crea una trama a gradini.
streamplot	Disegna linee di flusso di un flusso vettoriale.
subplot	Aggiungi un Asse alla figura corrente o recupera un Asse esistente.
subplot2grid	Crea una sottotrama in una posizione specifica all'interno di una griglia regolare.
subplot_mosaic	Costruisci un layout di Axes basato su ASCII art o elenchi nidificati.
subplot_tool	Avvia una finestra degli strumenti di sottotrama per una figura.
subplots	Crea una figura e una serie di sottotrame.
subplots_adjust	Regola i parametri di layout della sottotrama.
suptitle	Aggiungi un sottotitolo centrato alla figura.
switch_backend	Chiudi tutte le figure aperte e imposta il backend Matplotlib.
table	Aggiungi una tabella a un file Axes.
text	Aggiungi testo agli assi.
thetagrids	Ottieni o imposta le linee della griglia theta sul grafico polare corrente.
tick_params	Modificare l'aspetto delle tacche, delle etichette delle tacche e delle griglie.
ticklabel_format	Configura l' ScalarFormatterusato di default per gli assi lineari.
tight_layout	Regola il riempimento tra e intorno alle sottotrame.
title	Imposta un titolo per gli assi.
tricontour	Disegna linee di contorno su una griglia triangolare non strutturata.
tricontourf	Disegna regioni di contorno su una griglia triangolare non strutturata.
tripcolor	Crea un grafico pseudocolore di una griglia triangolare non strutturata.
triplot	Disegna una griglia triangolare non strutturata come linee e/o indicatori.
twinx	Crea e restituisce un secondo asse che condivide l' asse x .
twiny	Crea e restituisce un secondo asse che condivide l' asse y .
uninstall_repl_displayhook	Disconnettersi dall'hook di visualizzazione della shell corrente.
violinplot	Crea una trama per violino.
vlines	Traccia linee verticali in ogni x da ymin a ymax .
xcorr	Traccia la correlazione incrociata tra x e y .
xkcd	Attiva la modalità di disegno in stile schizzo xkcd .
xlabel	Impostare l'etichetta per l'asse x.
xlim	Ottenere o impostare i limiti x degli assi correnti.
xscale	Imposta la scala dell'asse x.
xticks	Ottieni o imposta le posizioni e le etichette dei tick correnti dell'asse x.
ylabel	Impostare l'etichetta per l'asse y.
ylim	Ottenere o impostare i limiti y degli assi correnti.
yscale	Imposta la scala dell'asse y.
yticks	Ottieni o imposta le posizioni e le etichette dei tick correnti dell'asse y.

Altri comandi

connect	Associa la funzione func agli eventi .
disconnect	Disconnettere la richiamata con id cid .
get_current_fig_manager	Restituisce il gestore della figura corrente.
ginput	Blocco chiamata per interagire con una figura.
new_figure_manager	Crea una nuova istanza del gestore di figure.
waitforbuttonpress	Blocco chiamata per interagire con la figura.

Mappe dei colori

Le mappe dei colori sono disponibili tramite il registro delle mappe dei colori matplotlib.colormaps. Per comodità questo registro è disponibile in pyplotas

matplotlib.pyplot. mappe dei colori

Contenitore per mappe di colori note a Matplotlib per nome.

Sperimentale

Mentre prevediamo che l'API sia definitiva, la contrassegniamo formalmente come sperimentale per 3.5 perché vogliamo mantenere l'opzione per adattare ancora l'API per 3.6 in caso di necessità.

L'istanza del registro universale è matplotlib.colormaps. Non dovrebbe essere necessario che gli utenti istanzino ColormapRegistryse stessi.

L'accesso in lettura utilizza un'interfaccia simile a un dict che mappa i nomi in Colormaps:

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

I messaggi restituiti Colormapsono copie, in modo che la loro modifica non cambi la definizione globale della mappa dei colori.

Ulteriori colormap possono essere aggiunte tramite ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

Inoltre, ci sono funzioni di scorciatoia per impostare le mappe dei colori incorporate; eg plt.viridis()è equivalente a plt.set_cmap('viridis').

matplotlib.pyplot. color_sequences

Contenitore per sequenze di colori note a Matplotlib per nome.

L'istanza del registro universale è matplotlib.color_sequences. Non dovrebbe essere necessario che gli utenti istanzino ColorSequenceRegistry se stessi.

L'accesso in lettura utilizza un'interfaccia simile a un dict che associa i nomi agli elenchi di colori:

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

Gli elenchi restituiti sono copie, in modo che la loro modifica non modifichi la definizione globale della sequenza di colori.

Ulteriori sequenze di colori possono essere aggiunte tramite ColorSequenceRegistry.register:

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])