matplotlib.pyplot.subplot_mosaic #

matplotlib.pyplot. subplot_mosaic ( mosaïque , * , sharex = False , sharey = False , width_ratios = None , height_ratios = None , empty_sentinel = '.' , subplot_kw = None , gridspec_kw = None , ** fig_kw ) [source] #

Créez une disposition d'axes basée sur l'art ASCII ou des listes imbriquées.

Il s'agit d'une fonction d'assistance pour créer visuellement des mises en page GridSpec complexes.

Noter

Cette API est provisoire et peut être révisée à l'avenir en fonction des premiers commentaires des utilisateurs.

Voir Composition de figures complexes et sémantiques pour un exemple et une documentation complète sur l'API

Paramètres :

liste mosaïque de la liste de {hashable or nested} ou str

Une disposition visuelle de la façon dont vous souhaitez que vos axes soient disposés sous forme de chaînes. Par exemple

x = [['A panel', 'A panel', 'edge'],
     ['C panel', '.',       'edge']]

produit 4 axes :

'Un panneau' d'une hauteur d'une ligne et s'étendant sur les deux premières colonnes
'edge' qui mesure 2 rangées de haut et se trouve sur le bord droit
'Panneau C' qui en 1 ligne et 1 colonne de large en bas à gauche
un espace vide de 1 ligne et 1 colonne de large en bas au centre

Toutes les entrées de la mise en page peuvent être une liste de listes du même formulaire pour créer des mises en page imbriquées.

Si l'entrée est une chaîne, alors elle doit être de la forme

'''
AAE
C.E
'''

où chaque caractère est une colonne et chaque ligne est une ligne. Cela n'autorise que les étiquettes Axes à un seul caractère et ne permet pas l'imbrication mais est très concis.

sharex, sharey bool, par défaut : False

Si True, l'axe des x ( sharex ) ou l'axe des y ( sharey ) sera partagé entre tous les sous-parcelles. Dans ce cas, la visibilité de l'étiquette de coche et les unités d'axe se comportent comme pour subplots. Si False, l'axe x ou y de chaque sous-parcelle sera indépendant.

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. Commodité pour .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': [...]}

objet empty_sentinel , facultatif

Entrée dans la mise en page pour signifier "laisser cet espace vide". La valeur par défaut est '.'. Notez que si la mise en page est une chaîne, elle est traitée via inspect.cleandocpour supprimer l'espace blanc de début, ce qui peut interférer avec l'utilisation de l'espace blanc comme sentinelle vide.

subplot_kw dict, facultatif

Dictionnaire avec des mots-clés passés à l' Figure.add_subplotappel utilisé pour créer chaque sous-parcelle.

gridspec_kw dict, facultatif

Dictionnaire 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 :

figureFigure: La nouvelle figurine
dict[étiquette, Axes]: Un dictionnaire mappant les étiquettes aux objets Axes. L'ordre des axes est de gauche à droite et de haut en bas de leur position dans la disposition totale.