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_units
aggiornerà 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_subplot
chiamata utilizzata per creare ogni sottotrama.- gridspec_kw dict, facoltativo
Dict con parole chiave passate al
GridSpec
costruttore utilizzato per creare la griglia su cui sono posizionate le sottotrame.- **fig_kw
Tutti gli argomenti di parole chiave aggiuntivi vengono passati alla
pyplot.figure
chiamata.
- Resi :
- Figura
Figure
- ax
Axes
o matrice di assi ax può essere un singolo
Axes
oggetto 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
ax
e pluralizzatiaxs
sono preferiti rispettoaxes
a quest'ultimo perché per quest'ultimo non è chiaro se si riferisca a una singolaAxes
istanza 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