matplotlib.pyplot.subplot #

matplotlib.pyplot. sous- parcelle ( * args , ** kwargs ) [source] #

Ajoutez un Axe à la figure actuelle ou récupérez un Axe existant.

Il s'agit d'un wrapper Figure.add_subplotqui fournit un comportement supplémentaire lorsque vous travaillez avec l'API implicite (voir la section notes).

Signatures d'appel :

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

Paramètres :

*args int, (int, int, index ), ou SubplotSpec, par défaut : (1, 1, 1)

La position de la sous-parcelle décrite par l'un des

Trois entiers ( nrows , ncols , index ). La sous-parcelle prendra la position d' index sur une grille avec des lignes nrows et des colonnes ncols . l'index commence à 1 dans le coin supérieur gauche et augmente vers la droite. index peut également être un tuple à deux spécifiant les indices ( first , last ) (basés sur 1 et last ) de la sous-parcelle, par exemple, crée une sous-parcelle qui s'étend sur les 2/3 supérieurs de la figure.fig.add_subplot(3, 1, (1, 2))
Un entier à 3 chiffres. Les chiffres sont interprétés comme s'ils étaient donnés séparément comme trois nombres entiers à un chiffre, c'est-à-dire fig.add_subplot(235)qu'ils sont identiques à . Notez que cela ne peut être utilisé que s'il n'y a pas plus de 9 sous-parcelles.fig.add_subplot(2, 3, 5)
Un SubplotSpec.

projection {Aucune, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optionnel

Le type de projection de la sous-parcelle ( Axes). str est le nom d'une projection personnalisée, voir projections. La valeur par défaut Aucun donne une projection "rectiligne".

polaire booléen, par défaut : faux

Si True, équivalent à projection='polar'.

sharex, sharey Axes, facultatif

Partagez le x ou le y axisavec sharex et/ou sharey. L'axe aura les mêmes limites, repères et échelle que l'axe des axes partagés.

étiquette str

Une étiquette pour les axes renvoyés.

Retours :

axes.SubplotBase, ou une autre sous-classe deAxes: Les axes de la sous-parcelle. La classe de base des axes renvoyée dépend de la projection utilisée. C'est Axessi la projection rectiligne est utilisée et projections.polar.PolarAxessi la projection polaire est utilisée. Les axes renvoyés sont alors une sous-classe de sous-parcelle de la classe de base.

Autres paramètres :

**kwargs

Cette méthode prend également les arguments de mot-clé pour la classe de base des axes retournée ; sauf pour l' argument de la figure . Les arguments de mots clés pour la classe de base rectiligne Axespeuvent être trouvés dans le tableau suivant, mais il peut également y avoir d'autres arguments de mots clés si une autre projection est utilisée.

Propriété	La description
`adjustable`	{'box', 'datalim'}
`agg_filter`	une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image
`alpha`	scalaire ou Aucun
`anchor`	(flottant, flottant) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bourdonner
`aspect`	{'auto', 'égal'} ou flottant
`autoscale_on`	bourdonner
`autoscalex_on`	inconnue
`autoscaley_on`	inconnue
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool ou 'ligne'
`box_aspect`	flottant ou Aucun
`clip_box`	`Bbox`
`clip_on`	bourdonner
`clip_path`	Patch ou (chemin, transformation) ou aucun
`facecolor`ou FC	Couleur
`figure`	`Figure`
`frame_on`	bourdonner
`gid`	chaîne
`in_layout`	bourdonner
`label`	objet
`mouseover`	bourdonner
`navigate`	bourdonner
`navigate_mode`	inconnue
`path_effects`	`AbstractPathEffect`
`picker`	Aucun ou bool ou flottant ou appelable
`position`	[gauche, bas, largeur, hauteur] ou`Bbox`
`prop_cycle`	inconnue
`rasterization_zorder`	flottant ou Aucun
`rasterized`	bourdonner
`sketch_params`	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
`snap`	booléen ou Aucun
`title`	chaîne
`transform`	`Transform`
`url`	chaîne
`visible`	bourdonner
`xbound`	inconnue
`xlabel`	chaîne
`xlim`	(en bas : flottant, en haut : flottant)
`xmargin`	flottant supérieur à -0,5
`xscale`	inconnue
`xticklabels`	inconnue
`xticks`	inconnue
`ybound`	inconnue
`ylabel`	chaîne
`ylim`	(en bas : flottant, en haut : flottant)
`ymargin`	flottant supérieur à -0,5
`yscale`	inconnue
`yticklabels`	inconnue
`yticks`	inconnue
`zorder`	flotteur

Voir également

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

Remarques

La création d'un nouvel Axe supprimera tous les Axes préexistants qui le chevauchent au-delà du partage d'une limite :

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)

Si vous ne souhaitez pas ce comportement, utilisez plutôt la Figure.add_subplotméthode ou la fonction.pyplot.axes

Si aucun kwarg n'est transmis et qu'il existe un Axe à l'emplacement spécifié par args , cet Axe sera renvoyé plutôt qu'un nouvel Axe créé.

Si kwargs sont passés et qu'il existe un Axes à l'emplacement spécifié par args , le type de projection est le même et les kwargs correspondent aux Axes existants, alors les Axes existants sont renvoyés. Sinon, un nouvel Axe est créé avec les paramètres spécifiés. Nous enregistrons une référence aux kwargs que nous utilisons pour cette comparaison. Si l'une des valeurs de kwargs est mutable, nous ne détecterons pas le cas où elles sont mutées. Dans ces cas, nous vous suggérons d'utiliser Figure.add_subplotl'API Axes explicite plutôt que l'API pyplot implicite.

Exemples

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)