matplotlib.pyplot.subplots #
- matplotlib.pyplot. sous- parcelles ( nrows = 1 , ncols = 1 , * , sharex = False , sharey = False , squeeze = True , width_ratios = None , height_ratios = None , subplot_kw = None , gridspec_kw = None , ** fig_kw ) [source] #
Créez une figure et un ensemble de sous-parcelles.
Ce wrapper utilitaire facilite la création de dispositions communes de sous-parcelles, y compris l'objet figure englobant, en un seul appel.
- Paramètres :
- nrows, ncols int, par défaut : 1
Nombre de lignes/colonnes de la grille de sous-parcelles.
- sharex, sharey bool ou {'none', 'all', 'row', 'col'}, par défaut : False
Contrôle le partage des propriétés entre les axes x ( sharex ) ou y ( sharey ) :
Vrai ou "tous" : l'axe des x ou des y sera partagé entre tous les sous-parcelles.
Faux ou 'aucun' : chaque axe x ou y de sous-parcelle sera indépendant.
'row' : chaque ligne de sous-parcelle partagera un axe des x ou des y.
'col' : chaque colonne de sous-parcelle partagera un axe des x ou des y.
Lorsque les sous-parcelles ont un axe des x partagé le long d'une colonne, seules les étiquettes de coche x de la sous-parcelle inférieure sont créées. De même, lorsque les sous-parcelles ont un axe y partagé le long d'une ligne, seules les étiquettes de coche y de la première sous-parcelle de colonne sont créées. Pour activer ultérieurement les ticklabels d'autres sous-parcelles, utilisez
tick_params
.Lorsque les sous-parcelles ont un axe partagé qui a des unités, l'appel
set_units
mettra à jour chaque axe avec les nouvelles unités.- presser booléen, par défaut : Vrai
Si True, les dimensions supplémentaires sont extraites du tableau renvoyé de
Axes
:si un seul sous-parcelle est construit (nrows=ncols=1), l'objet Axes unique résultant est renvoyé sous forme de scalaire.
pour les sous-parcelles Nx1 ou 1xM, l'objet renvoyé est un tableau d'objets numpy 1D d'objets Axes.
pour NxM, les sous-parcelles avec N>1 et M>1 sont renvoyées sous forme de tableau 2D.
Si False, aucune compression n'est effectuée : l'objet Axes renvoyé est toujours un tableau 2D contenant des instances Axes, même s'il finit par être 1x1.
- width_ratios semblable à un tableau de longueur ncols , facultatif
Définit les largeurs relatives des colonnes. Chaque colonne obtient une largeur relative de . S'il n'est pas indiqué, toutes les colonnes auront la même largeur. Équivalent à .
width_ratios[i] / sum(width_ratios)
gridspec_kw={'width_ratios': [...]}
- height_ratios type tableau de longueur nrows , facultatif
Définit les hauteurs relatives des lignes. Chaque ligne obtient une hauteur relative de . S'il n'est pas indiqué, toutes les lignes auront la même hauteur. Commodité pour .
height_ratios[i] / sum(height_ratios)
gridspec_kw={'height_ratios': [...]}
- subplot_kw dict, facultatif
Dict avec des mots-clés passés à l'
add_subplot
appel utilisé pour créer chaque sous-parcelle.- gridspec_kw dict, facultatif
Dict avec des mots-clés passés au
GridSpec
constructeur utilisé pour créer la grille sur laquelle les sous-parcelles sont placées.- **fig_kw
Tous les arguments de mots clés supplémentaires sont passés à l'
pyplot.figure
appel.
- Retours :
- figure
Figure
- hache
Axes
ou tableau d'axes ax peut être soit un
Axes
objet unique, soit un tableau d'objets Axes si plusieurs sous-parcelles ont été créées. Les dimensions du tableau résultant peuvent être contrôlées avec le mot-clé squeeze, voir ci-dessus.Les idiomes typiques pour gérer la valeur de retour sont :
# 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)
Les noms
ax
et au plurielaxs
sont préférésaxes
car pour ce dernier, il n'est pas clair s'il fait référence à une seuleAxes
instance ou à une collection de ceux-ci.
- figure
Voir également
Exemples
# 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)
Exemples utilisant matplotlib.pyplot.subplots
#

Distribution discrète sous forme de graphique à barres horizontales

Mappage des propriétés des marqueurs aux données multivariées

Créer une chronologie avec des lignes, des dates et du texte

Démonstration de corrélation croisée et automatique

Normalisations de la palette de couleurs SymLogNorm

Mélangez la transparence avec la couleur dans les images 2D

Tracé de contour de données irrégulièrement espacées

Contrôle des limites de vue à l'aide des marges et des sticky_edges

Redimensionner les axes avec une disposition contrainte

Redimensionner les axes avec une disposition serrée

Libellés des figures : suptitle, supxlabel, supylabel

Combinaison de deux sous-parcelles à l'aide de sous-parcelles et de GridSpec

Création de plusieurs sous-parcelles à l'aide de plt.subplots

Centiles sous forme de graphique à barres horizontales

Personnalisation de l'artiste dans les boîtes à moustaches

Boîtes à moustaches avec couleurs de remplissage personnalisées

Comparaison entre tracé en boîte et tracé en violon

Tracer une ellipse de confiance d'un ensemble de données bidimensionnel

Différentes façons de spécifier les barres d'erreur

Y compris les limites supérieure et inférieure dans les barres d'erreur

Création de boîtes à partir de barres d'erreur à l'aide de PatchCollection

Utilisation d'histogrammes pour tracer une distribution cumulative

Quelques fonctionnalités de la fonction histogramme (hist)

Démo des différents paramètres de type d'histogramme de la fonction d'histogramme

La fonction histogramme (hist) avec plusieurs ensembles de données

Étiquetage des tiques à l'aide de la notation d'ingénierie

Rendre des équations mathématiques à l'aide de TeX

Contrôle par programme de l'ajustement des sous-parcelles

Création d'une palette de couleurs à partir d'une liste de couleurs

Collection Line, Poly et RegularPoly avec mise à l'échelle automatique

Feuille de style des méthodes bayésiennes pour les hackers

Contrôle de la position et de la taille des barres de couleur avec les axes d'encart

Image animée à l'aide d'une liste d'images précalculée

Les événements d'entrée et de sortie des figures/axes

Construire des histogrammes à l'aide de Rectangles et de PolyCollections

Formatage des graduations de date à l'aide de ConciseDateFormatter

Placer des graduations de date à l'aide de règles de récurrence

Formateur de ticks personnalisé pour les séries chronologiques

Définir les étiquettes de graduation par défaut de l'axe y à droite

Définition d'étiquettes de graduation à partir d'une liste de valeurs

Déplacer les étiquettes de graduation de l'axe des x vers le haut

Sélectionner des index d'une collection à l'aide du sélecteur de polygones

Tutoriel sur les barres de couleurs personnalisées