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_unitsmettra à 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_subplotappel utilisé pour créer chaque sous-parcelle.- gridspec_kw dict, facultatif
Dict avec des mots-clés passés au
GridSpecconstructeur 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.figureappel.
- Retours :
- figure
Figure - hache
Axesou tableau d'axes ax peut être soit un
Axesobjet 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
axet au plurielaxssont préférésaxescar pour ce dernier, il n'est pas clair s'il fait référence à une seuleAxesinstance 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
