matplotlib.table

Dessin de tableaux.

Noter

L'implémentation de la table dans Matplotlib est légèrement maintenue. Pour une implémentation de table plus fonctionnelle, vous pouvez essayer blume .

Utilisez la fonction d'usine tablepour créer un tableau prêt à l'emploi à partir de textes. Si vous avez besoin de plus de contrôle, utilisez la Tableclasse et ses méthodes.

Le tableau se compose d'une grille de cellules, qui sont indexées par (ligne, colonne). La cellule (0, 0) est positionnée en haut à gauche.

Merci à John Gill d'avoir fourni la classe et la table.

classe matplotlib.table. Cell ( xy , width , height , * , edgecolor = 'k' , facecolor = 'w' , fill = True , text = '' , loc = None , fontproperties = None , visible_edges = 'closed' )

Socles :Rectangle

Une cellule est un Rectangleavec des associés Text.

En tant qu'utilisateur, vous ne créerez probablement pas de cellules vous-même. Au lieu de cela, vous devez utiliser la tablefonction factory ou Table.add_cell.

Paramètres :

xy 2-tuple

La position du coin inférieur gauche de la cellule.

flotteur de largeur

La largeur de la cellule.

hauteur flotteur

La hauteur de la cellule.

couleur de bord

La couleur de la bordure de la cellule.

couleur de visage

La couleur de la cellule.

remplir booléen

Indique si l'arrière-plan de la cellule est rempli.

chaîne de texte

Le texte de la cellule.

loc {'gauche', 'centre', 'droite'}, par défaut : 'droite'

L'alignement du texte dans la cellule.

propriétés de la police dict

Un dict définissant les propriétés de police du texte. Les clés et les valeurs prises en charge sont les arguments de mots-clés acceptés par FontProperties.

visible_edges str, par défaut : 'fermé'

Les bords de la cellule à dessiner avec une ligne : une sous-chaîne de 'BRTL' (bas, droite, haut, gauche), ou l'une des options 'ouvert' (pas de bords dessinés), 'fermé' (tous les bords dessinés), 'horizontal' (bas et haut), 'vertical' (droite et gauche).

PAD = 0.1

Remplissage entre le texte et le rectangle.

auto_set_font_size ( moteur de rendu )

Réduisez la taille de la police jusqu'à ce que le texte tienne dans la largeur de la cellule.

draw ( moteur de rendu )

Dessinez l'artiste (et ses enfants) à l'aide du moteur de rendu donné.

Cela n'a aucun effet si l'artiste n'est pas visible ( Artist.get_visible renvoie Faux).

Paramètres :

sous-classe de moteur de rendu .RendererBase

Remarques

Cette méthode est remplacée dans les sous-classes Artist.

get_fontsize ( )

Renvoie la taille de police de la cellule.

get_path ( )

Renvoie un Pathpour le visible_edges.

get_required_width ( moteur de rendu )

Renvoie la largeur minimale requise pour la cellule.

get_text ( )

Renvoie l' Textinstance de cellule.

get_text_bounds ( moteur de rendu )

Renvoie les limites du texte sous la forme (x, y, largeur, hauteur) dans les coordonnées du tableau.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , angle=<UNSET> , animé=<UNSET> , antialiased=<UNSET> , bounds=<UNSET> , capstyle=<UNSET> , clip_box=<UNSET > , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , fill=<UNSET> , fontsize=<UNSET> , gid=<UNSET> , hatch=<UNSET> ,hauteur=<UNSET> ,in_layout=<UNSET> , joinstyle=<UNSET> , label=<UNSET> , linestyle=<UNSET> , linewidth=<UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized= <UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text_props=<UNSET> , transform=<UNSET> , url=<UNSET> , visible=<UNSET> , width=<UNSET> , x=<UNSET > , xy=<DÉSACTIVÉ> , y=<UNSET> , zorder=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

Propriété	La description
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
angle	inconnue
animated	bourdonner
antialiasedou aa	booléen ou Aucun
bounds	(gauche, bas, largeur, hauteur)
capstyle	CapStyleou {'bout', 'en saillie', 'rond'}
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
color	Couleur
edgecolorou ce	couleur ou Aucun
facecolorou FC	couleur ou Aucun
figure	inconnue
fill	bourdonner
fontsize	inconnue
gid	chaîne
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	inconnue
in_layout	bourdonner
joinstyle	JoinStyleou {'onglet', 'rond', 'biseau'}
label	objet
linestyleou ls	{'-', '--', '-.', ':', '', (décalage, on-off-seq), ...}
linewidthou lw	flottant ou Aucun
mouseover	bourdonner
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
text_props	inconnue
transform	inconnue
url	chaîne
visible	bourdonner
width	inconnue
x	inconnue
xy	(flotter, flotter)
y	inconnue
zorder	flotteur

set_figure ( figure )

Définissez l' Figureinstance à laquelle appartient l'artiste.

Paramètres :

figureFigure

set_fontsize ( taille )

Définissez la taille de police du texte.

set_text_props ( ** kwargs )

Mettez à jour les propriétés du texte.

Les arguments de mots clés valides sont :

Propriété	La description
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
animated	bourdonner
backgroundcolor	Couleur
bbox	dict avec des propriétés pourpatches.FancyBboxPatch
clip_box	inconnue
clip_on	inconnue
clip_path	inconnue
colorou c	Couleur
figure	Figure
fontfamilyou famille	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou police ou font_properties	font_manager.FontPropertiesou stroupathlib.Path
fontsizeou taille	flottant ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou étirer	{une valeur numérique dans la plage 0-1000, 'ultra-condensé', 'extra-condensé', 'condensé', 'semi-condensé', 'normal', 'semi-élargi', 'élargi', 'extra-élargi ', 'ultra-élargi'}
fontstyleou style	{'normal', 'italique', 'oblique'}
fontvariantou variante	{'normal', 'petites majuscules'}
fontweightou poids	{une valeur numérique dans la plage 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'gras', 'lourd', 'extra gras', 'noir'}
gid	chaîne
horizontalalignmentou ha	{'gauche', 'centre', 'droite'}
in_layout	bourdonner
label	objet
linespacing	flottant (multiple de la taille de la police)
math_fontfamily	chaîne
mouseover	bourdonner
multialignmentou maman	{'gauche', 'droite', 'centre'}
parse_math	bourdonner
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
position	(flotter, flotter)
rasterized	bourdonner
rotation	flottant ou {'vertical', 'horizontal'}
rotation_mode	{Aucun, 'par défaut', 'ancre'}
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
text	objet
transform	Transform
transform_rotates_text	bourdonner
url	chaîne
usetex	booléen ou Aucun
verticalalignmentou va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bourdonner
wrap	bourdonner
x	flotteur
y	flotteur
zorder	flotteur

set_transform ( trans )

Définissez la transformation de l'artiste.

Paramètres :

tTransform

propriété visible_edges

Les bords de la cellule à dessiner avec une ligne.

La lecture de cette propriété renvoie une sous-chaîne de 'BRTL' (bas, droite, haut, gauche').

Lors de la définition de cette propriété, vous pouvez utiliser une sous-chaîne de 'BRTL' ou l'une de {'open', 'closed', 'horizontal', 'vertical'}.

matplotlib.table. CellulePersonnalisée

pseudonyme deCell

classe matplotlib.table. Table ( ax , loc = None , bbox = None , ** kwargs )

Socles :Artist

Un tableau de cellules.

Le tableau se compose d'une grille de cellules, qui sont indexées par (ligne, colonne).

Pour un tableau simple, vous aurez une grille complète de cellules avec des indices de (0, 0) à (num_rows-1, num_cols-1), dans laquelle la cellule (0, 0) est positionnée en haut à gauche. Cependant, vous pouvez également ajouter des cellules avec des indices négatifs. Vous n'avez pas besoin d'ajouter une cellule à chaque position de la grille, vous pouvez donc créer des tableaux qui ont des trous.

Remarque : Vous ne créerez généralement pas une table vide à partir de zéro. Utilisez plutôt tablepour créer une table à partir de données.

Paramètres :

hachematplotlib.axes.Axes

Le Axesdans lequel tracer le tableau.

rue loc

La position de la cellule par rapport à ax . Ce doit être l'un des codes.

bbox Bboxou Aucun

Une zone de délimitation dans laquelle dessiner le tableau. Si ce n'est pas None , cela remplace loc .

Autres paramètres :

**kwargs

ArtistPropriétés.

AXESPAD = 0.02

La frontière entre les Axes et le bord de la table en unités Axes.

TAILLE POLICE = 10

add_cell ( row , col , * args , ** kwargs )

Créez une cellule et ajoutez-la au tableau.

Paramètres :

ligne entière

Indice de ligne.

col entier

Indice de colonne.

*args, **kwargs

Tous les autres paramètres sont transmis à Cell.

Retours :

Cell

La cellule créée.

auto_set_column_width ( col )

Définissez automatiquement les largeurs de colonnes données sur des tailles optimales.

Paramètres :

col entier ou suite d'entiers

Les indices des colonnes à mettre à l'échelle automatiquement.

auto_set_font_size ( valeur = True )

Définir automatiquement la taille de la police.

codes = {'best' : 0, 'bottom' : 17, 'bottom left' : 12, 'bottom right' : 13, 'center' : 9, 'center left' : 5, 'center right' : 6, ' gauche' : 15, 'bas centre' : 7, 'bas gauche' : 3, 'bas droite' : 4, 'droite' : 14, 'haut' : 16, 'haut gauche' : 11, 'haut droite' : 10, 'centre supérieur ' :8, 'en haut à gauche' : 2, 'en haut à droite' : 1}

Valeurs possibles où placer la table par rapport aux Axes.

contient ( mouseevent )

Teste si l'artiste contient l'événement mouse.

Paramètres :

événement de sourismatplotlib.backend_bases.MouseEvent

Retours :

contient booléen

Indique si des valeurs se trouvent dans le rayon.

dictée des détails

Un dictionnaire spécifique à l'artiste des détails du contexte de l'événement, tels que les points contenus dans le rayon de sélection. Voir les sous-classes individuelles d'artistes pour plus de détails.

draw ( moteur de rendu )

Dessinez l'artiste (et ses enfants) à l'aide du moteur de rendu donné.

Cela n'a aucun effet si l'artiste n'est pas visible ( Artist.get_visible renvoie Faux).

Paramètres :

sous-classe de moteur de rendu .RendererBase

Remarques

Cette méthode est remplacée dans les sous-classes Artist.

bords de propriété

La valeur par défaut de visible_edgespour les cellules nouvellement ajoutées à l'aide de add_cell.

Remarques

Ce paramètre n'affecte actuellement que les cellules nouvellement créées à l'aide de add_cell.

Pour modifier des cellules existantes, vous devez définir explicitement leurs bords :

for c in tab.get_celld().values():
    c.visible_edges = 'horizontal'

get_celld ( )

Renvoie un dict de cellules dans le mappage de table (ligne, colonne) à Cells.

Remarques

Vous pouvez également indexer directement dans l'objet Table pour accéder à des cellules individuelles :

cell = table[row, col]

get_children ( )

Renvoie les Artistes contenus par la table.

get_window_extent ( moteur de rendu = Aucun )

Obtenez la boîte englobante de l'artiste dans l'espace d'affichage.

La largeur et la hauteur de la boîte englobante sont non négatives.

Les sous-classes doivent être remplacées pour être incluses dans le calcul « serré » de la boîte englobante. La valeur par défaut est de renvoyer une boîte englobante vide à 0, 0.

Soyez prudent lorsque vous utilisez cette fonction, les résultats ne seront pas mis à jour si l'étendue de la fenêtre d'artiste de l'artiste change. L'étendue peut changer en raison de toute modification de la pile de transformation, telle que la modification des limites des axes, de la taille de la figure ou du canevas utilisé (comme cela se fait lors de l'enregistrement d'une figure). Cela peut entraîner un comportement inattendu où les figures interactives s'afficheront correctement à l'écran, mais ne seront pas enregistrées correctement.

échelle ( xscale , yscale )

Mettez à l' échelle les largeurs de colonne par xscale et les hauteurs de ligne par yscale .

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , fontsize=<UNSET> , gid=<UNSET > , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> ,url=<UNSET> ,visible=<UNSET> , zorder=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

Propriété	La description
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
animated	bourdonner
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
figure	Figure
fontsize	flotteur
gid	chaîne
in_layout	bourdonner
label	objet
mouseover	bourdonner
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
visible	bourdonner
zorder	flotteur

set_fontsize ( taille )

Définissez la taille de la police, en points, du texte de la cellule.

Paramètres :

flotteur de taille

Remarques

Tant que la taille de police automatique n'a pas été désactivée, la valeur sera tronquée de sorte que le texte tienne horizontalement dans la cellule.

Vous pouvez désactiver ce comportement en utilisant auto_set_font_size.

>>> the_table.auto_set_font_size(False)
>>> the_table.set_fontsize(20)

Cependant, il n'y a pas de mise à l'échelle automatique de la hauteur de ligne afin que le texte puisse dépasser la limite de la cellule.

matplotlib.table. table ( ax , cellText = None , cellColours = None , cellLoc = 'right' , colWidths = None , rowLabels = None , rowColours = None , rowLoc = 'left' , colLabels = None , colColours = None , colLoc = 'center' , loc = 'bas' , bbox= Aucun , bords = 'fermé' , ** kwargs )

Ajouter un tableau à un Axes.

Au moins un parmi cellText ou cellColours doit être spécifié. Ces paramètres doivent être des listes 2D, dans lesquelles les listes externes définissent les lignes et la liste interne définit les valeurs de colonne par ligne. Chaque ligne doit avoir le même nombre d'éléments.

Le tableau peut éventuellement avoir des en-têtes de ligne et de colonne, qui sont configurés à l'aide de rowLabels , rowColours , rowLoc et colLabels , colColours , colLoc respectivement.

Pour un contrôle plus précis des tables, utilisez la Tableclasse et ajoutez-la aux axes avec Axes.add_table.

Paramètres :

cellText Liste 2D de str, facultatif

Les textes à placer dans les cellules du tableau.

Remarque : les sauts de ligne dans les chaînes ne sont actuellement pas pris en compte et entraîneront le texte dépassant les limites des cellules.

cellColours Liste de couleurs 2D, facultative

Les couleurs de fond des cellules.

cellLoc {'gauche', 'centre', 'droite'}, par défaut : 'droite'

L'alignement du texte dans les cellules.

colWidths liste de float, facultatif

Les largeurs de colonne en unités des axes. Si non spécifié, toutes les colonnes auront une largeur de 1 / ncols .

rowLabels liste de str, facultatif

Le texte des cellules d'en-tête de ligne.

rowColours liste de couleurs, facultative

Les couleurs des cellules d'en-tête de ligne.

rowLoc {'gauche', 'centre', 'droite'}, par défaut : 'gauche'

L'alignement du texte des cellules d'en-tête de ligne.

colLabels liste de str, facultatif

Le texte des cellules d'en-tête de colonne.

colColours liste de couleurs, facultative

Les couleurs des cellules d'en-tête de colonne.

colLoc {'gauche', 'centre', 'droite'}, par défaut : 'gauche'

L'alignement du texte des cellules d'en-tête de colonne.

loc str, facultatif

La position de la cellule par rapport à ax . Ce doit être l'un des codes.

bbox Bbox, en option

Une zone de délimitation dans laquelle dessiner le tableau. Si ce n'est pas None , cela remplace loc .

sous-chaîne des bords de 'BRTL' ou {'open', 'closed', 'horizontal', 'vertical'}

Les bords de cellule à dessiner avec une ligne. Voir aussi visible_edges.

Retours :

Table

Le tableau créé.

Autres paramètres :

**kwargs

TablePropriétés.

Propriété	La description
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
animated	bourdonner
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
figure	Figure
fontsize	flotteur
gid	chaîne
in_layout	bourdonner
label	objet
mouseover	bourdonner
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
visible	bourdonner
zorder	flotteur