matplotlib.table

Tabellen zeichnen.

Notiz

Die Tabellenimplementierung in Matplotlib wird leicht gepflegt. Für eine funktionsreichere Tabellenimplementierung möchten Sie vielleicht blume ausprobieren .

Verwenden Sie die Factory-Funktion table, um aus Texten eine fertige Tabelle zu erstellen. Wenn Sie mehr Kontrolle benötigen, verwenden Sie die TableKlasse und ihre Methoden.

Die Tabelle besteht aus einem Raster von Zellen, die durch (Zeile, Spalte) indiziert sind. Die Zelle (0, 0) wird oben links positioniert.

Danke an John Gill für die Bereitstellung der Klasse und des Tisches.

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

Basen:Rectangle

Eine Zelle ist Rectanglemit einigen verknüpften Text.

Als Benutzer werden Sie höchstwahrscheinlich keine Zellen selbst erstellen. Stattdessen sollten Sie entweder die tableWerksfunktion oder verwenden Table.add_cell.

Parameter :

xy 2-Tupel

Die Position der unteren linken Ecke der Zelle.

Breite Schwimmer

Die Zellenbreite.

Höhenschwimmer _

Die Zellenhöhe.

Kantenfarbe Farbe

Die Farbe des Zellenrahmens.

Gesichtsfarbe Farbe

Die Zellgesichtsfarbe.

bool füllen

Ob der Zellhintergrund gefüllt ist.

Textstr _

Der Zellentext.

loc {'links', 'mitte', 'rechts'}, Standard: 'rechts'

Die Ausrichtung des Textes innerhalb der Zelle.

Schriftarteigenschaften dict

Ein Diktat, das die Schrifteigenschaften des Textes definiert. Unterstützte Schlüssel und Werte sind die Schlüsselwortargumente, die von akzeptiert werden FontProperties.

visible_edges str, Standard: 'geschlossen'

Die Zellenkanten, die mit einer Linie gezeichnet werden sollen: eine Teilzeichenfolge von „BRTL“ (unten, rechts, oben, links) oder eine von „offen“ (keine Kanten gezeichnet), „geschlossen“ (alle Kanten gezeichnet), „horizontal“. (unten und oben), 'vertikal' (rechts und links).

PAD = 0,1

Abstand zwischen Text und Rechteck.

auto_set_font_size ( Renderer )

Verkleinern Sie die Schriftgröße, bis der Text in die Zellenbreite passt.

draw ( Renderer )

Zeichnen Sie den Künstler (und seine Kinder) mit dem angegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist ( Artist.get_visible gibt False zurück).

Parameter :

Renderer- RendererBaseUnterklasse.

Anmerkungen

Diese Methode wird in den Artist-Unterklassen überschrieben.

get_fontsize ( )

Gibt die Schriftgröße der Zelle zurück.

get_path ( )

Geben Sie a Pathfür die zurück visible_edges.

get_required_width ( Renderer )

Gibt die minimal erforderliche Breite für die Zelle zurück.

get_text ( )

Gibt die Zelleninstanz zurück Text.

get_text_bounds ( Renderer )

Gibt die Textgrenzen als (x, y, Breite, Höhe) in Tabellenkoordinaten zurück.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , angle=<UNSET > , animation =<UNSET> , antialiased= <UNSET> , bounds=<UNSET> , capstyle=<UNSET> , clip_box=<UNSET > , clip_on=<UNSCHARF> , clip_path=<UNSCHARF> , color=<UNSCHARF> , edgecolor=<UNSCHARF> , facecolor=<UNSCHARF> , fill=<UNSCHARF> , fontsize =<UNSCHARF> , gid=<UNSCHARF> , hatch=<UNSET> ,Höhe=<UNSET> ,in_layout=<UNSET> , joinstyle=<UNSET> , label=<UNSET> , linestyle=<UNSET > ,, mouseover=< UNSET> , path_effects=<UNSET> , picker=< UNSET> , gerastert= <UNSCHARF> , sketch_params=<UNSCHARF> , snap=<UNSCHARF> , text_props=<UNSCHARF> , transform=<UNSCHARF> , url=<UNSCHARF> , visible=<UNSCHARF> , width=<UNSCHARF> , x=<UNSCHARF > , xy=<UNSCHARF> , y=<UNSCHARF> , zorder=<UNSCHARF> )

Legen Sie mehrere Eigenschaften gleichzeitig fest.

Unterstützte Eigenschaften sind

Eigentum	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
angle	Unbekannt
animated	bool
antialiasedoder äh	bool oder Keine
bounds	(links, unten, Breite, Höhe)
capstyle	CapStyleoder {'hinter', 'vorstehend', 'rund'}
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
color	Farbe
edgecoloroder ec	Farbe oder Keine
facecoloroder FC	Farbe oder Keine
figure	Unbekannt
fill	bool
fontsize	Unbekannt
gid	Str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	Unbekannt
in_layout	bool
joinstyle	JoinStyleoder {'Gehrung', 'rund', 'Fase'}
label	Objekt
linestyleoder ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidthoder lw	Float oder None
mouseover	bool
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
rasterized	bool
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
text_props	Unbekannt
transform	Unbekannt
url	Str
visible	bool
width	Unbekannt
x	Unbekannt
xy	(schweben, schweben)
y	Unbekannt
zorder	schweben

set_figure ( fig )

Legen Sie die FigureInstanz fest, zu der der Künstler gehört.

Parameter :

FeigeFigure

set_fontsize ( Größe )

Stellen Sie die Schriftgröße des Textes ein.

set_text_props ( ** kwargs )

Aktualisieren Sie die Texteigenschaften.

Gültige Schlüsselwortargumente sind:

Eigentum	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
animated	bool
backgroundcolor	Farbe
bbox	Diktat mit Eigenschaften fürpatches.FancyBboxPatch
clip_box	Unbekannt
clip_on	Unbekannt
clip_path	Unbekannt
coloroder c	Farbe
figure	Figure
fontfamilyoder Familie	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesoder font oder font_properties	font_manager.FontPropertiesoder stroderpathlib.Path
fontsizeoder Größe	float oder {'xx-klein', 'x-klein', 'klein', 'mittel', 'groß', 'x-groß', 'xx-groß'}
fontstretchoder dehnen	{ein numerischer Wert im Bereich 0-1000, 'ultra-kondensiert', 'extra-kondensiert', 'kondensiert', 'semi-kondensiert', 'normal', 'semi-expanded', 'expanded', 'extra-expanded ', 'ultra-erweitert'}
fontstyleoder Stil	{'normal', 'kursiv', 'schräg'}
fontvariantoder Variante	{'normal', 'Small-Caps'}
fontweightoder Gewicht	{ein numerischer Wert im Bereich 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'fett', 'schwer', 'extra fett', 'schwarz'}
gid	Str
horizontalalignmentoder ha	{'links', 'mitte', 'rechts'}
in_layout	bool
label	Objekt
linespacing	Float (Vielfaches der Schriftgröße)
math_fontfamily	Str
mouseover	bool
multialignmentoder ma	{'links', 'rechts', 'Mitte'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
position	(schweben, schweben)
rasterized	bool
rotation	float oder {'vertikal', 'horizontal'}
rotation_mode	{Keine, 'Standard', 'Anker'}
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
text	Objekt
transform	Transform
transform_rotates_text	bool
url	Str
usetex	bool oder Keine
verticalalignmentoder va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	schweben
y	schweben
zorder	schweben

set_transform ( trans )

Stellen Sie die Künstlertransformation ein.

Parameter :

tTransform

Eigenschaft sichtbare_Kanten

Die Zellenränder sollen mit einer Linie gezeichnet werden.

Das Lesen dieser Eigenschaft gibt eine Teilzeichenfolge von „BRTL“ (unten, rechts, oben, links) zurück.

Wenn Sie diese Eigenschaft festlegen, können Sie einen Teilstring von „BRTL“ oder einen von {„offen“, „geschlossen“, „horizontal“, „vertikal“} verwenden.

matplotlib.table. CustomCell

Pseudonym vonCell

Klasse matplotlib.table. Tabelle ( ax , loc = None , bbox = None , ** kwargs )

Basen:Artist

Eine Tabelle mit Zellen.

Die Tabelle besteht aus einem Raster von Zellen, die durch (Zeile, Spalte) indiziert sind.

Bei einer einfachen Tabelle haben Sie ein vollständiges Gitter aus Zellen mit Indizes von (0, 0) bis (num_rows-1, num_cols-1), in dem die Zelle (0, 0) oben links positioniert ist. Sie können jedoch auch Zellen mit negativen Indizes hinzufügen. Sie müssen nicht an jeder Rasterposition eine Zelle hinzufügen, sodass Sie Tabellen mit Löchern erstellen können.

Hinweis : Normalerweise erstellen Sie keine leere Tabelle von Grund auf neu. Verwenden Sie stattdessen table, um eine Tabelle aus Daten zu erstellen.

Parameter :

Axtmatplotlib.axes.Axes

Die Axes, in die die Tabelle gezeichnet werden soll.

loc str

Die Position der Zelle in Bezug auf ax . Dies muss einer der sein codes.

bbox Bboxoder Keine

Ein Begrenzungsrahmen, in den die Tabelle gezeichnet werden soll. Wenn dies nicht None ist, überschreibt dies loc .

Andere Parameter :

**Kwarg

ArtistEigenschaften.

AXESPAD = 0,02

Die Grenze zwischen den Axes und der Tischkante in Axes-Einheiten.

SCHRIFTGRÖSSE = 10

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

Erstellen Sie eine Zelle und fügen Sie sie der Tabelle hinzu.

Parameter :

Reihe int

Zeilenindex.

Spalte int

Spaltenindex.

*args, **kwargs

Alle anderen Parameter werden an weitergegeben Cell.

Rückgaben :

Cell

Die erstellte Zelle.

auto_set_column_width ( Spalte )

Stellen Sie die Breiten bestimmter Spalten automatisch auf optimale Größen ein.

Parameter :

col int oder Folge von ints

Die Indizes der automatisch zu skalierenden Spalten.

auto_set_font_size ( value = True )

Schriftgröße automatisch einstellen.

codes = {'best': 0, 'bottom': 17, 'bottom left': 12, 'bottom right': 13, 'center': 9, 'center left': 5, 'center right': 6, ' links': 15, 'unten Mitte': 7, 'unten links': 3, 'unten rechts': 4, 'rechts': 14, 'oben': 16, 'oben links': 11, 'oben rechts': 10, 'obere Mitte':8, 'oben links': 2, 'oben rechts': 1}

Mögliche Werte, wo die Tabelle relativ zu den Achsen platziert werden soll.

enthält ( mouseevent )

Testen Sie, ob der Künstler das Mausereignis enthält.

Parameter :

Mausereignismatplotlib.backend_bases.MouseEvent

Rückgaben :

enthält bool

Ob irgendwelche Werte innerhalb des Radius liegen.

Details Dikt

Ein künstlerspezifisches Wörterbuch mit Details zum Ereigniskontext, z. B. welche Punkte im Auswahlradius enthalten sind. Einzelheiten finden Sie in den einzelnen Artist-Unterklassen.

draw ( Renderer )

Zeichnen Sie den Künstler (und seine Kinder) mit dem angegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist ( Artist.get_visible gibt False zurück).

Parameter :

Renderer- RendererBaseUnterklasse.

Anmerkungen

Diese Methode wird in den Artist-Unterklassen überschrieben.

Grundstückskanten #

Der Standardwert visible_edgesfür neu hinzugefügte Zellen mit add_cell.

Anmerkungen

Diese Einstellung betrifft derzeit nur neu erstellte Zellen mit add_cell.

Um bestehende Zellen zu ändern, müssen Sie deren Kanten explizit setzen:

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

get_celld ( )

Gibt ein Diktat von Zellen in der Tabellenzuordnung (Zeile, Spalte) an Cells zurück.

Anmerkungen

Sie können auch direkt in das Table-Objekt indizieren, um auf einzelne Zellen zuzugreifen:

cell = table[row, col]

get_children ( )

Gibt die in der Tabelle enthaltenen Künstler zurück.

get_window_extent ( renderer = None )

Holen Sie sich den Begrenzungsrahmen des Künstlers in den Anzeigebereich.

Breite und Höhe des Begrenzungsrahmens sind nichtnegativ.

Unterklassen sollten überschrieben werden, um sie in die "enge" Berechnung des Begrenzungsrahmens aufzunehmen. Standardmäßig wird ein leerer Begrenzungsrahmen bei 0, 0 zurückgegeben.

Seien Sie vorsichtig, wenn Sie diese Funktion verwenden, die Ergebnisse werden nicht aktualisiert, wenn sich die Ausdehnung des Künstlerfensters des Künstlers ändert. Die Ausdehnung kann sich aufgrund von Änderungen im Transformationsstapel ändern, z. B. durch Ändern der Achsenbegrenzungen, der Abbildungsgröße oder des verwendeten Zeichenbereichs (wie beim Speichern einer Abbildung). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figuren auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

scale ( xscale , yscale )

Spaltenbreiten um xscale und Zeilenhöhen um yscale skalieren .

set ( * , agg_filter=<UNSCHARF> , alpha=<UNSCHARF > , animation=<UNSCHARF> , clip_box=<UNSCHARF> ,,, fontsize=< UNSCHARF> , gid=<UNSCHARF > , in_layout=<UNSCHARF> , label=<UNSCHARF> , mouseover=<UNSCHARF> ,, picker=< UNSCHARF> , gerastert=<UNSCHARF> , sketch_params=<UNSCHARF> , snap=<UNSCHARF> , transform=<UNSET> ,url=<UNSET> ,sichtbar=<UNSCHARF> , zorder=<UNSCHARF> )

Legen Sie mehrere Eigenschaften gleichzeitig fest.

Unterstützte Eigenschaften sind

Eigentum	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
animated	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
figure	Figure
fontsize	schweben
gid	Str
in_layout	bool
label	Objekt
mouseover	bool
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
rasterized	bool
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
transform	Transform
url	Str
visible	bool
zorder	schweben

set_fontsize ( Größe )

Legen Sie die Schriftgröße des Zellentexts in Punkt fest.

Parameter :

Größe Schwimmer

Anmerkungen

Solange die automatische Schriftgröße nicht deaktiviert wurde, wird der Wert so beschnitten, dass der Text horizontal in die Zelle passt.

Sie können dieses Verhalten mit deaktivieren auto_set_font_size.

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

Es erfolgt jedoch keine automatische Skalierung der Zeilenhöhe, sodass der Text die Zellgrenze überschreiten kann.

matplotlib.table. Tabelle ( ax , cellText = None , cellColours = None , cellLoc = 'right' , colWidths = None , rowLabels = None , rowColours = None , rowLoc = 'left' , colLabels = None , colColours = None , colLoc = 'center' , loc = 'unten' , bbox= None , edges = 'closed' , ** kwargs )

Hinzufügen einer Tabelle zu einer Axes.

Mindestens eine von cellText oder cellColours muss angegeben werden. Diese Parameter müssen 2D-Listen sein, bei denen die äußeren Listen die Zeilen und die inneren Listen die Spaltenwerte pro Zeile definieren. Jede Zeile muss die gleiche Anzahl von Elementen haben.

Die Tabelle kann optional Zeilen- und Spaltenüberschriften haben, die jeweils mit rowLabels , rowColours , rowLoc und colLabels , colColours , colLoc konfiguriert werden.

Verwenden Sie für eine feinkörnigere Kontrolle über Tabellen die TableKlasse und fügen Sie sie mit zu den Achsen hinzu Axes.add_table.

Parameter :

cellText 2D-Liste von str, optional

Die Texte, die in die Tabellenzellen eingefügt werden sollen.

Hinweis : Zeilenumbrüche in den Zeichenfolgen werden derzeit nicht berücksichtigt und führen dazu, dass der Text die Zellgrenzen überschreitet.

cellColours 2D-Farbliste, optional

Die Hintergrundfarben der Zellen.

cellLoc {'links', 'mitte', 'rechts'}, Standard: 'rechts'

Die Ausrichtung des Textes innerhalb der Zellen.

colWidths- Liste von Gleitkommazahlen, optional

Die Spaltenbreiten in Einheiten der Achsen. Wenn nicht angegeben, haben alle Spalten eine Breite von 1 / ncols .

rowLabels Liste von str, optional

Der Text der Zeilenkopfzellen.

rowColours Liste der Farben, optional

Die Farben der Zeilenkopfzellen.

rowLoc {'links', 'mitte', 'rechts'}, Standard: 'links'

Die Textausrichtung der Zeilenkopfzellen.

colLabels Liste von str, optional

Der Text der Spaltenkopfzellen.

colColours Liste der Farben, optional

Die Farben der Spaltenkopfzellen.

colLoc {'links', 'mitte', 'rechts'}, Standard: 'links'

Die Textausrichtung der Spaltenkopfzellen.

loc str, optional

Die Position der Zelle in Bezug auf ax . Dies muss einer der sein codes.

bbox Bbox, optional

Ein Begrenzungsrahmen, in den die Tabelle gezeichnet werden soll. Wenn dies nicht None ist, überschreibt dies loc .

Kanten Teilstring von 'BRTL' oder {'offen', 'geschlossen', 'horizontal', 'vertikal'}

Die Zellenränder sollen mit einer Linie gezeichnet werden. Siehe auch visible_edges.

Rückgaben :

Table

Die erstellte Tabelle.

Andere Parameter :

**Kwarg

TableEigenschaften.

Eigentum	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
animated	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
figure	Figure
fontsize	schweben
gid	Str
in_layout	bool
label	Objekt
mouseover	bool
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
rasterized	bool
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
transform	Transform
url	Str
visible	bool
zorder	schweben