matplotlib.pyplot.subplots #
- matplotlib.pyplot. subplots ( nrows = 1 , ncols = 1 , * , sharex = False , sharey = False , squeeze = True , width_ratios = None , height_ratios = None , subplot_kw = None , gridspec_kw = None , ** fig_kw ) [fonte] #
Crea una figura e una serie di sottotrame.
Questo wrapper di utilità rende conveniente creare layout comuni di sottotrame, incluso l'oggetto figura che lo racchiude, in una singola chiamata.
- Parametri :
- nrows, ncols int, predefinito: 1
Numero di righe/colonne della griglia della sottotrama.
- sharex, sharey bool o {'none', 'all', 'row', 'col'}, default: False
Controlla la condivisione delle proprietà tra gli assi x ( sharex ) o y ( sharey ):
True o 'all': l'asse x o y sarà condiviso tra tutte le sottotrame.
Falso o 'nessuno': ogni asse x o y della sottotrama sarà indipendente.
'riga': ogni riga della sottotrama condividerà un asse x o y.
'col': ogni colonna della sottotrama condividerà un asse x o y.
Quando le sottotrame hanno un asse x condiviso lungo una colonna, vengono create solo le etichette di segno di spunta x della sottotrama inferiore. Allo stesso modo, quando le sottotrame hanno un asse y condiviso lungo una riga, vengono create solo le etichette di spunta y della prima sottotrama di colonna. Per attivare successivamente i ticklabel di altre sottotrame, utilizzare
tick_params.Quando le sottotrame hanno un asse condiviso con unità, la chiamata
set_unitsaggiornerà ogni asse con le nuove unità.- squeeze bool, predefinito: vero
Se True, le dimensioni extra vengono escluse dall'array restituito di
Axes:se viene costruita solo una sottotrama (nrows=ncols=1), il singolo oggetto Axes risultante viene restituito come scalare.
per le sottotrame Nx1 o 1xM, l'oggetto restituito è un array di oggetti numpy 1D di oggetti Axes.
per NxM, le sottotrame con N>1 e M>1 vengono restituite come matrice 2D.
Se False, non viene eseguita alcuna compressione: l'oggetto Axes restituito è sempre un array 2D contenente istanze di Axes, anche se finisce per essere 1x1.
- width_ratios simile a un array di lunghezza ncols , facoltativo
Definisce le larghezze relative delle colonne. Ogni colonna ottiene una larghezza relativa di . Se non specificato, tutte le colonne avranno la stessa larghezza. Equivalente a .
width_ratios[i] / sum(width_ratios)gridspec_kw={'width_ratios': [...]}- height_ratios simile a un array di length nrows , facoltativo
Definisce le altezze relative delle righe. Ogni riga ottiene un'altezza relativa di . Se non indicato, tutte le righe avranno la stessa altezza. Convenienza per .
height_ratios[i] / sum(height_ratios)gridspec_kw={'height_ratios': [...]}- subplot_kw dict, facoltativo
Dict con parole chiave passate alla
add_subplotchiamata utilizzata per creare ogni sottotrama.- gridspec_kw dict, facoltativo
Dict con parole chiave passate al
GridSpeccostruttore utilizzato per creare la griglia su cui sono posizionate le sottotrame.- **fig_kw
Tutti gli argomenti di parole chiave aggiuntivi vengono passati alla
pyplot.figurechiamata.
- Resi :
- Figura
Figure - ax
Axeso matrice di assi ax può essere un singolo
Axesoggetto o un array di oggetti Axes se è stata creata più di una sottotrama. Le dimensioni dell'array risultante possono essere controllate con la parola chiave squeeze, vedi sopra.I modi di dire tipici per gestire il valore restituito sono:
# using the variable ax for single a Axes fig, ax = plt.subplots() # using the variable axs for multiple Axes fig, axs = plt.subplots(2, 2) # using tuple unpacking for multiple Axes fig, (ax1, ax2) = plt.subplots(1, 2) fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2)
I nomi
axe pluralizzatiaxssono preferiti rispettoaxesa quest'ultimo perché per quest'ultimo non è chiaro se si riferisca a una singolaAxesistanza oa una raccolta di questi.
- Figura
Esempi
# First create some toy data: x = np.linspace(0, 2*np.pi, 400) y = np.sin(x**2) # Create just a figure and only one subplot fig, ax = plt.subplots() ax.plot(x, y) ax.set_title('Simple plot') # Create two subplots and unpack the output array immediately f, (ax1, ax2) = plt.subplots(1, 2, sharey=True) ax1.plot(x, y) ax1.set_title('Sharing Y axis') ax2.scatter(x, y) # Create four polar axes and access them through the returned array fig, axs = plt.subplots(2, 2, subplot_kw=dict(projection="polar")) axs[0, 0].plot(x, y) axs[1, 1].scatter(x, y) # Share a X axis with each column of subplots plt.subplots(2, 2, sharex='col') # Share a Y axis with each row of subplots plt.subplots(2, 2, sharey='row') # Share both X and Y axes with all subplots plt.subplots(2, 2, sharex='all', sharey='all') # Note that this is the same as plt.subplots(2, 2, sharex=True, sharey=True) # Create figure number 10 with a single subplot # and clears it if it already exists. fig, ax = plt.subplots(num=10, clear=True)
Esempi che utilizzano matplotlib.pyplot.subplots#
Distribuzione discreta come grafico a barre orizzontali
Personalizzazione degli stili delle linee tratteggiate
Mappatura delle proprietà dei marcatori ai dati multivariati
Creazione di una sequenza temporale con linee, date e testo
Regolazione interattiva dell'intervallo della mappa dei colori
Contornare lo spazio delle soluzioni delle ottimizzazioni
Controllo dei limiti di visualizzazione utilizzando margins e sticky_edges
Etichette delle figure: suptitle, supxlabel, supylabel
Combinazione di due sottotrame utilizzando sottotrame e GridSpec
Creazione di più sottotrame utilizzando plt.subplots
Tracciare un'ellisse di confidenza di un set di dati bidimensionale
Compresi i limiti superiore e inferiore nelle barre di errore
Creazione di caselle dalle barre di errore utilizzando PatchCollection
Utilizzo di istogrammi per tracciare una distribuzione cumulativa
Alcune caratteristiche della funzione istogramma (hist).
Demo delle diverse impostazioni histtype della funzione istogramma
La funzione dell'istogramma (hist) con più insiemi di dati
Etichettatura delle zecche utilizzando la notazione ingegneristica
Rendering di equazioni matematiche utilizzando TeX
Dimostrazione predefinita della rotazione del testo
Controllo programmatico della regolazione della sottotrama
Creazione di una mappa di colori da un elenco di colori
Collezione Line, Poly e RegularPoly con ridimensionamento automatico
Metodi bayesiani per il foglio di stile degli hacker
Visualizzazione dei canali RGB utilizzando RGBAxes
Aggiunta di una barra dei colori agli assi interni
Controllo della posizione e delle dimensioni delle barre dei colori con Inset Axes
Immagine animata utilizzando un elenco precalcolato di immagini
Cambiare i colori delle linee che intersecano una scatola
Costruire istogrammi usando Rectangles e PolyCollections
Ombreggiatura personalizzata in un grafico di superficie 3D
Grafico radar (noto anche come ragno o mappa stellare)
Etichettatura del segno di spunta della barra dei colori
Formattazione dei segni di spunta della data utilizzando ConciseDateFormatter
Posizionamento dei segni di spunta della data utilizzando le regole di ricorrenza
Formattatore tick personalizzato per serie temporali
Imposta le etichette di spunta dell'asse y predefinite sulla destra
Impostazione delle etichette di spunta da un elenco di valori
Sposta le etichette dei segni di spunta sull'asse x in alto
Seleziona gli indici da una raccolta utilizzando il selettore di poligoni