matplotlib.pyplot.subplot #

matplotlib.pyplot. sottotrama ( * args , ** kwargs ) [fonte] #

Aggiungi un Asse alla figura corrente o recupera un Asse esistente.

Questo è un wrapper Figure.add_subplotche fornisce un comportamento aggiuntivo quando si lavora con l'API implicita (vedere la sezione delle note).

Firme di chiamata:

subplot(nrows, ncols, index, **kwargs)
subplot(pos, **kwargs)
subplot(**kwargs)
subplot(ax)

Parametri :

*args int, (int, int, index ), o SubplotSpec, default: (1, 1, 1)

La posizione della sottotrama descritta da uno dei

Tre numeri interi ( nrows , ncols , index ). La sottotrama prenderà la posizione dell'indice su una griglia con nrow righe e ncols colonne. l' indice inizia da 1 nell'angolo in alto a sinistra e aumenta verso destra. index può anche essere una tupla doppia che specifica gli indici ( first , last ) (in base 1 e compreso last ) della sottotrama, ad esempio crea una sottotrama che copre i 2/3 superiori della figura.fig.add_subplot(3, 1, (1, 2))
Un numero intero a 3 cifre. Le cifre vengono interpretate come se fossero date separatamente come tre numeri interi a una cifra, cioè fig.add_subplot(235)è uguale a . Si noti che questo può essere utilizzato solo se non ci sono più di 9 sottotrame.fig.add_subplot(2, 3, 5)
A. SubplotSpec_

proiezione {Nessuna, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, opzionale

Il tipo di proiezione della sottotrama ( Axes). str è il nome di una proiezione personalizzata, vedere projections. L'impostazione predefinita Nessuno produce una proiezione 'rettilinea'.

bool polare , predefinito: falso

Se True, equivale a projection='polar'.

sharex, sharey Axes, facoltativo

Condividi la x o la y axiscon sharex e/o sharey. L'asse avrà gli stessi limiti, tick e scala dell'asse degli assi condivisi.

etichetta str

Un'etichetta per gli assi restituiti.

Resi :

axes.SubplotBase, o un'altra sottoclasse diAxes: Gli assi della sottotrama. La classe base degli assi restituiti dipende dalla proiezione utilizzata. È Axesse viene utilizzata la proiezione rettilinea e projections.polar.PolarAxesse viene utilizzata la proiezione polare. Gli assi restituiti sono quindi una sottoclasse della sottotrama della classe base.

Altri parametri :

**kwargs

Questo metodo accetta anche gli argomenti della parola chiave per la classe base axis restituita; ad eccezione dell'argomento della figura . Gli argomenti delle parole chiave per la classe base rettilinea Axessono disponibili nella tabella seguente, ma potrebbero esserci anche altri argomenti delle parole chiave se viene utilizzata un'altra proiezione.

Proprietà	Descrizione
`adjustable`	{'box', 'datalim'}
`agg_filter`	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
`alpha`	scalare o Nessuno
`anchor`	(float, float) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'equal'} o float
`autoscale_on`	bool
`autoscalex_on`	sconosciuto
`autoscaley_on`	sconosciuto
`axes_locator`	Callable[[Assi, Renderer], Bbox]
`axisbelow`	bool o 'linea'
`box_aspect`	float o Nessuno
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch o (Percorso, Trasforma) o Nessuno
`facecolor`o fc	colore
`figure`	`Figure`
`frame_on`	bool
`gid`	str
`in_layout`	bool
`label`	oggetto
`mouseover`	bool
`navigate`	bool
`navigate_mode`	sconosciuto
`path_effects`	`AbstractPathEffect`
`picker`	Nessuno o bool o float o richiamabile
`position`	[sinistra, fondo, larghezza, altezza] o`Bbox`
`prop_cycle`	sconosciuto
`rasterization_zorder`	float o Nessuno
`rasterized`	bool
`sketch_params`	(scala: float, lunghezza: float, casualità: float)
`snap`	bool o Nessuno
`title`	str
`transform`	`Transform`
`url`	str
`visible`	bool
`xbound`	sconosciuto
`xlabel`	str
`xlim`	(in basso: galleggiante, in alto: galleggiante)
`xmargin`	float maggiore di -0,5
`xscale`	sconosciuto
`xticklabels`	sconosciuto
`xticks`	sconosciuto
`ybound`	sconosciuto
`ylabel`	str
`ylim`	(in basso: galleggiante, in alto: galleggiante)
`ymargin`	float maggiore di -0,5
`yscale`	sconosciuto
`yticklabels`	sconosciuto
`yticks`	sconosciuto
`zorder`	galleggiante

Guarda anche

Figure.add_subplot
pyplot.subplots
pyplot.axes
Figure.subplots

Appunti

La creazione di un nuovo Axes eliminerà tutti gli Axes preesistenti che si sovrappongono ad esso oltre a condividere un confine:

import matplotlib.pyplot as plt
# plot a line, implicitly creating a subplot(111)
plt.plot([1, 2, 3])
# now create a subplot which represents the top plot of a grid
# with 2 rows and 1 column. Since this subplot will overlap the
# first, the plot (and its axes) previously created, will be removed
plt.subplot(211)

Se non si desidera questo comportamento, utilizzare invece il Figure.add_subplotmetodo o la pyplot.axesfunzione.

Se non viene passato alcun kwargs ed esiste un Axes nella posizione specificata da args , verrà restituito quell'Axes anziché creare un nuovo Axes.

Se i kwargs vengono passati ed esiste un Axes nella posizione specificata da args , il tipo di proiezione è lo stesso e i kwargs corrispondono agli Axes esistenti, viene restituito l'Axes esistente. Altrimenti viene creato un nuovo Axes con i parametri specificati. Salviamo un riferimento ai kwargs che usiamo per questo confronto. Se uno qualsiasi dei valori in kwargs è mutabile, non rileveremo il caso in cui sono mutati. In questi casi suggeriamo di utilizzare Figure.add_subplote l'API Axes esplicita piuttosto che l'API pyplot implicita.

Esempi

plt.subplot(221)

# equivalent but more general
ax1 = plt.subplot(2, 2, 1)

# add a subplot with no frame
ax2 = plt.subplot(222, frameon=False)

# add a polar subplot
plt.subplot(223, projection='polar')

# add a red subplot that shares the x-axis with ax1
plt.subplot(224, sharex=ax1, facecolor='red')

# delete ax2 from the figure
plt.delaxes(ax2)

# add ax2 to the figure again
plt.subplot(ax2)

# make the first axes "current" again
plt.subplot(221)