matplotlib.table

Disegno tabelle.

Nota

L'implementazione della tabella in Matplotlib è leggermente mantenuta. Per un'implementazione della tabella più completa, potresti provare blume .

Usa la funzione factory tableper creare una tabella già pronta dai testi. Se hai bisogno di più controllo, usa la Tableclasse e i suoi metodi.

La tabella consiste in una griglia di celle, che sono indicizzate da (riga, colonna). La cella (0, 0) è posizionata in alto a sinistra.

Grazie a John Gill per aver fornito la classe e il tavolo.

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

Basi:Rectangle

Una cella è un Rectanglecon alcuni associati Text.

Come utente, molto probabilmente non creerai le celle da solo. Invece, dovresti usare la tablefunzione factory o Table.add_cell.

Parametri :

xy 2 tuple

La posizione dell'angolo in basso a sinistra della cella.

larghezza galleggiante

La larghezza della cella.

galleggiante in altezza

L'altezza della cella.

colore bordo

Il colore del bordo della cella.

colore del viso

Il colore della faccia della cella.

riempire bool

Se lo sfondo della cella è pieno.

testo str

Il testo della cella.

loc {'sinistra', 'centro', 'destra'}, predefinito: 'destra'

L'allineamento del testo all'interno della cella.

proprietà dei caratteri dict

Un dict che definisce le proprietà del carattere del testo. Le chiavi e i valori supportati sono gli argomenti delle parole chiave accettati da FontProperties.

visible_edges str, predefinito: 'chiuso'

I bordi della cella da disegnare con una linea: una sottostringa di 'BRTL' (in basso, a destra, in alto, a sinistra) o una tra 'open' (nessun bordo disegnato), 'closed' (tutti i bordi disegnati), 'horizontal' (in basso e in alto), 'verticale' (destra e sinistra).

PAD = 0,1

Riempimento tra testo e rettangolo.

auto_set_font_size ( renderer )

Riduci la dimensione del carattere finché il testo non si adatta alla larghezza della cella.

draw ( renderer )

Disegna l'artista (e i suoi figli) usando il renderer dato.

Questo non ha effetto se l'artista non è visibile ( Artist.get_visible restituisce False).

Parametri :

sottoclasse del renderer .RendererBase

Appunti

Questo metodo è sovrascritto nelle sottoclassi Artist.

get_fontsize ( )

Restituisce la dimensione del carattere della cella.

get_path ( )

Restituisci a Pathper il visible_edges.

get_required_width ( renderer )

Restituisce la larghezza minima richiesta per la cella.

get_text ( )

TextRestituisce l' istanza della cella .

get_text_bounds ( renderer )

Restituisce i limiti del testo come (x, y, larghezza, altezza) nelle coordinate della tabella.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , angle=<UNSET> , animation=<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> , tratteggio=<UNSET> ,altezza=<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=<UNSET> , y=<DISINSERITO> , zorder=<DISINSERITO> )

Imposta più proprietà contemporaneamente.

Le proprietà supportate sono

Proprietà	Descrizione
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	scalare o Nessuno
angle	sconosciuto
animated	bool
antialiasedo aa	bool o Nessuno
bounds	(sinistra, in basso, larghezza, altezza)
capstyle	CapStyleo {'culo', 'sporgente', 'rotondo'}
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
color	colore
edgecoloro ecc	colore o Nessuno
facecoloro fc	colore o Nessuno
figure	sconosciuto
fill	bool
fontsize	sconosciuto
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	sconosciuto
in_layout	bool
joinstyle	JoinStyleo {'mitre', 'round', 'bevel'}
label	oggetto
linestyleo ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidtho lw	float o Nessuno
mouseover	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
rasterized	bool
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
text_props	sconosciuto
transform	sconosciuto
url	str
visible	bool
width	sconosciuto
x	sconosciuto
xy	(galleggiare, galleggiare)
y	sconosciuto
zorder	galleggiante

set_figure ( fig )

Imposta l' Figureistanza a cui appartiene l'artista.

Parametri :

FiguraFigure

set_fontsize ( dimensione )

Imposta la dimensione del carattere del testo.

set_text_props ( ** kwargs )

Aggiorna le proprietà del testo.

Gli argomenti delle parole chiave valide sono:

Proprietà	Descrizione
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	scalare o Nessuno
animated	bool
backgroundcolor	colore
bbox	dict con proprietà perpatches.FancyBboxPatch
clip_box	sconosciuto
clip_on	sconosciuto
clip_path	sconosciuto
coloro c	colore
figure	Figure
fontfamilyo famiglia	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertieso font o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo dimensione	float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretcho allungare	{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}
fontstyleo stile	{'normale', 'corsivo', 'obliquo'}
fontvarianto variante	{'normale', 'maiuscoletto'}
fontweighto peso	{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}
gid	str
horizontalalignmento ah	{'sinistra', 'centro', 'destra'}
in_layout	bool
label	oggetto
linespacing	float (multiplo della dimensione del carattere)
math_fontfamily	str
mouseover	bool
multialignmento mamma	{'sinistra', 'destra', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
position	(galleggiare, galleggiare)
rasterized	bool
rotation	float o {'verticale', 'orizzontale'}
rotation_mode	{Nessuno, 'predefinito', 'ancora'}
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
text	oggetto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool o Nessuno
verticalalignmento Va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	galleggiante
y	galleggiante
zorder	galleggiante

set_transform ( trans )

Imposta la trasformazione dell'artista.

Parametri :

tTransform

proprietà bordi_visibili

I bordi della cella da disegnare con una linea.

La lettura di questa proprietà restituisce una sottostringa di 'BRTL' (in basso, a destra, in alto, a sinistra').

Quando si imposta questa proprietà, è possibile utilizzare una sottostringa di 'BRTL' o una di {'open', 'closed', 'horizontal', 'vertical'}.

matplotlib.table. Cella personalizzata

alias diCell

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

Basi:Artist

Una tabella di celle.

La tabella consiste in una griglia di celle, che sono indicizzate da (riga, colonna).

Per una tabella semplice, avrai una griglia completa di celle con indici da (0, 0) a (num_righe-1, num_cols-1), in cui la cella (0, 0) è posizionata in alto a sinistra. Tuttavia, puoi anche aggiungere celle con indici negativi. Non è necessario aggiungere una cella a ogni posizione della griglia, quindi puoi creare tabelle con buchi.

Nota : di solito non creerai una tabella vuota da zero. Utilizzare invece tableper creare una tabella dai dati.

Parametri :

asciamatplotlib.axes.Axes

Il Axesin cui tracciare la tabella.

via loc

La posizione della cella rispetto ad ax . Questo deve essere uno dei file codes.

bbox Bboxo Nessuno

Un riquadro di delimitazione in cui disegnare la tabella. Se non è None , sovrascrive loc .

Altri parametri :

**kwargs

Artistproprietà.

AXESPAD = 0,02

Il confine tra gli assi e il bordo del tavolo in unità di assi.

DIMENSIONE CARATTERE = 10

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

Crea una cella e aggiungila alla tabella.

Parametri :

riga int

Indice di riga.

col int

Indice di colonna.

*args, **kwargs

Tutti gli altri parametri vengono passati a Cell.

Resi :

Cell

La cella creata.

auto_set_column_width ( col )

Imposta automaticamente le larghezze di determinate colonne su dimensioni ottimali.

Parametri :

col int o sequenza di interi

Gli indici delle colonne da ridimensionare automaticamente.

auto_set_font_size ( valore = True )

Imposta automaticamente la dimensione del carattere.

codici = {'migliore': 0, 'basso': 17, 'basso a sinistra': 12, 'basso a destra': 13, 'centro': 9, 'centro sinistra': 5, 'centro destra': 6, ' left': 15, 'lower center': 7, 'lower left': 3, 'lower right': 4, 'right': 14, 'top': 16, 'top left': 11, 'top right': 10, 'superiore al centro':8, 'in alto a sinistra': 2, 'in alto a destra': 1}

Possibili valori dove posizionare la tabella relativa agli Assi.

contiene ( mouseevent )

Verifica se l'artista contiene l'evento del mouse.

Parametri :

mouseeventmatplotlib.backend_bases.MouseEvent

Resi :

contiene bool

Se i valori sono all'interno del raggio.

dettagli dict

Un dizionario specifico dell'artista dei dettagli del contesto dell'evento, ad esempio quali punti sono contenuti nel raggio di selezione. Vedere le singole sottoclassi di artisti per i dettagli.

draw ( renderer )

Disegna l'artista (e i suoi figli) usando il renderer dato.

Questo non ha effetto se l'artista non è visibile ( Artist.get_visible restituisce False).

Parametri :

sottoclasse del renderer .RendererBase

Appunti

Questo metodo è sovrascritto nelle sottoclassi Artist.

margini di proprietà

Il valore predefinito visible_edgesper le celle appena aggiunte utilizzando add_cell.

Appunti

Questa impostazione attualmente influisce solo sulle celle appena create utilizzando add_cell.

Per modificare le celle esistenti, devi impostare i loro bordi in modo esplicito:

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

get_celld ( )

Restituisce un dict di celle nel mapping della tabella (riga, colonna) a Cells.

Appunti

Puoi anche indicizzare direttamente nell'oggetto Tabella per accedere alle singole celle:

cell = table[row, col]

get_children ( )

Restituisce gli Artisti contenuti nella tabella.

get_window_extent ( renderer = None )

Ottieni il riquadro di delimitazione dell'artista nello spazio espositivo.

La larghezza e l'altezza del riquadro di delimitazione non sono negative.

Le sottoclassi dovrebbero sovrascrivere per l'inclusione nel calcolo "stretto" del riquadro di delimitazione. L'impostazione predefinita è restituire un riquadro di delimitazione vuoto a 0, 0.

Fai attenzione quando usi questa funzione, i risultati non si aggiorneranno se l'estensione della finestra dell'artista cambia. L'estensione può cambiare a causa di eventuali modifiche nello stack di trasformazione, come la modifica dei limiti degli assi, la dimensione della figura o la tela utilizzata (come avviene quando si salva una figura). Questo può portare a comportamenti imprevisti in cui le figure interattive appariranno bene sullo schermo, ma verranno salvate in modo errato.

scala ( xscale , yscale )

Ridimensiona le larghezze delle colonne con xscale e le altezze delle righe con yscale .

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation=<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=<DISINSERITO> ,visible=<UNSET> , zorder=<UNSET> )

Imposta più proprietà contemporaneamente.

Le proprietà supportate sono

Proprietà	Descrizione
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	scalare o Nessuno
animated	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
figure	Figure
fontsize	galleggiante
gid	str
in_layout	bool
label	oggetto
mouseover	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
rasterized	bool
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
transform	Transform
url	str
visible	bool
zorder	galleggiante

set_fontsize ( dimensione )

Imposta la dimensione del carattere, in punti, del testo della cella.

Parametri :

dimensione galleggiante

Appunti

Finché la dimensione automatica del carattere non è stata disabilitata, il valore verrà ritagliato in modo tale che il testo si adatti orizzontalmente alla cella.

Puoi disabilitare questo comportamento usando auto_set_font_size.

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

Tuttavia, non esiste un ridimensionamento automatico dell'altezza della riga in modo che il testo possa superare il limite della cella.

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 = 'in basso' , bbox= Nessuno , bordi = 'chiuso' , ** kwargs )

Aggiungi una tabella a un file Axes.

Deve essere specificato almeno uno tra cellText o cellColours . Questi parametri devono essere elenchi 2D, in cui gli elenchi esterni definiscono le righe e l'elenco interno definisce i valori di colonna per riga. Ogni riga deve avere lo stesso numero di elementi.

La tabella può avere facoltativamente intestazioni di riga e di colonna, configurate utilizzando rispettivamente rowLabels , rowColours , rowLoc e colLabels , colColours , colLoc .

Per un controllo più dettagliato sulle tabelle, usa la Tableclasse e aggiungila agli assi con Axes.add_table.

Parametri :

cellText Elenco 2D di str, facoltativo

I testi da inserire nelle celle della tabella.

Nota : le interruzioni di riga nelle stringhe non sono attualmente prese in considerazione e faranno sì che il testo superi i limiti della cella.

cellColours Elenco di colori 2D, facoltativo

I colori di sfondo delle celle.

cellLoc {'sinistra', 'centro', 'destra'}, predefinito: 'destra'

L'allineamento del testo all'interno delle celle.

colWidths elenco di float, facoltativo

Le larghezze delle colonne in unità degli assi. Se non specificato, tutte le colonne avranno una larghezza di 1 / ncols .

rowLabels elenco di str, facoltativo

Il testo delle celle di intestazione della riga.

rowColours elenco di colori, facoltativo

I colori delle celle di intestazione di riga.

rowLoc {'sinistra', 'centro', 'destra'}, predefinito: 'sinistra'

L'allineamento del testo delle celle dell'intestazione di riga.

colLabels elenco di str, facoltativo

Il testo delle celle dell'intestazione di colonna.

colColors elenco di colori, facoltativo

I colori delle celle dell'intestazione di colonna.

colLoc {'sinistra', 'centro', 'destra'}, predefinito: 'sinistra'

L'allineamento del testo delle celle dell'intestazione di colonna.

loc str, facoltativo

La posizione della cella rispetto ad ax . Questo deve essere uno dei file codes.

bbox Bbox, facoltativo

Un riquadro di delimitazione in cui disegnare la tabella. Se non è None , sovrascrive loc .

edge sottostringa di ' BRTL ' o {'open', 'closed', 'horizontal', 'vertical'}

I bordi della cella da disegnare con una linea. Vedi anche visible_edges.

Resi :

Table

La tabella creata.

Altri parametri :

**kwargs

Tableproprietà.

Proprietà	Descrizione
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	scalare o Nessuno
animated	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
figure	Figure
fontsize	galleggiante
gid	str
in_layout	bool
label	oggetto
mouseover	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
rasterized	bool
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
transform	Transform
url	str
visible	bool
zorder	galleggiante