matplotlib.table

Desenho de tabelas.

Observação

A implementação da tabela no Matplotlib é levemente mantida. Para uma implementação de tabela com mais recursos, você pode tentar blume .

Use a função de fábrica tablepara criar uma tabela pronta a partir de textos. Se precisar de mais controle, use a Tableclasse e seus métodos.

A tabela consiste em uma grade de células, que são indexadas por (linha, coluna). A célula (0, 0) está posicionada no canto superior esquerdo.

Obrigado a John Gill por fornecer a aula e a mesa.

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

Bases:Rectangle

Uma célula é uma Rectanglecom algum associado Text.

Como usuário, você provavelmente não criará células sozinho. Em vez disso, você deve usar a tablefunção de fábrica ou Table.add_cell.

Parâmetros :

xy 2-tupla

A posição do canto inferior esquerdo da célula.

flutuação de largura

A largura da célula.

flutuador de altura

A altura da célula.

cor da borda

A cor da borda da célula.

cor do rosto

A cor da face da célula.

preenchimento bool

Se o plano de fundo da célula está preenchido.

texto str

O texto da célula.

loc {'esquerda', 'centro', 'direita'}, padrão: 'direita'

O alinhamento do texto dentro da célula.

ditado de propriedades da fonte

Um dict definindo as propriedades da fonte do texto. Chaves e valores com suporte são os argumentos de palavra-chave aceitos por FontProperties.

visible_edges str, padrão: 'fechado'

As arestas da célula a serem desenhadas com uma linha: uma substring de 'BRTL' (inferior, direita, superior, esquerda) ou uma de 'aberta' (sem arestas desenhadas), 'fechada' (todas as arestas desenhadas), 'horizontal' (inferior e superior), 'vertical' (direita e esquerda).

PAD = 0,1

Preenchimento entre texto e retângulo.

auto_set_font_size ( renderizador )

Reduza o tamanho da fonte até que o texto caiba na largura da célula.

desenhar ( renderizador )

Desenhe o Artista (e seus filhos) usando o renderizador fornecido.

Isso não tem efeito se o artista não estiver visível ( Artist.get_visible retorna False).

Parâmetros :

subclasse do renderizador .RendererBase

Notas

Este método é substituído nas subclasses Artist.

get_fontsize ( )

Retorna o tamanho da fonte da célula.

get_path ( )

Retorne um Pathpara o visible_edges.

get_required_width ( renderizador )

Retorna a largura mínima necessária para a célula.

get_text ( )

TextRetorne a instância da célula .

get_text_bounds ( renderizador )

Retorne os limites do texto como (x, y, largura, altura) nas coordenadas da tabela.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , angle=<UNSET> , animado=<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> , hachura=<UNSET> ,altura=<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=<UNSET> , zorder=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
angle	desconhecido
animated	bool
antialiasedou aa	bool ou nenhum
bounds	(esquerda, inferior, largura, altura)
capstyle	CapStyleou {'bunda', 'projetando', 'redondo'}
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
color	cor
edgecolorou ec	cor ou nenhum
facecolorou fc	cor ou nenhum
figure	desconhecido
fill	bool
fontsize	desconhecido
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	desconhecido
in_layout	bool
joinstyle	JoinStyleou {'esquadria', 'redondo', 'chanfrado'}
label	objeto
linestyleou ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidthou lw	flutuante ou nenhum
mouseover	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
rasterized	bool
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text_props	desconhecido
transform	desconhecido
url	str
visible	bool
width	desconhecido
x	desconhecido
xy	(flutuar, flutuar)
y	desconhecido
zorder	flutuador

set_figure ( fig )

Defina a Figureinstância à qual o artista pertence.

Parâmetros :

FIGFigure

set_fontsize ( tamanho )

Defina o tamanho da fonte do texto.

set_text_props ( ** kwargs )

Atualize as propriedades do texto.

Os argumentos de palavra-chave válidos são:

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
animated	bool
backgroundcolor	cor
bbox	ditado com propriedades parapatches.FancyBboxPatch
clip_box	desconhecido
clip_on	desconhecido
clip_path	desconhecido
colorou c	cor
figure	Figure
fontfamilyou família	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou fonte ou font_properties	font_manager.FontPropertiesou stroupathlib.Path
fontsizeou tamanho	float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou esticar	{um valor numérico no intervalo de 0 a 1000, 'ultracondensado', 'extracondensado', 'condensado', 'semicondensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleou estilo	{'normal', 'itálico', 'oblíquo'}
fontvariantou variante	{'normal', 'small caps'}
fontweightou peso	{um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'demibold', 'meio', 'negrito', 'pesado', 'extra negrito', 'preto'}
gid	str
horizontalalignmentou ha	{'esquerda', 'centro', 'direita'}
in_layout	bool
label	objeto
linespacing	float (múltiplo do tamanho da fonte)
math_fontfamily	str
mouseover	bool
multialignmentou mãe	{'esquerda', 'direita', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	(flutuar, flutuar)
rasterized	bool
rotation	flutuante ou {'vertical', 'horizontal'}
rotation_mode	{Nenhum, 'padrão', 'âncora'}
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text	objeto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool ou nenhum
verticalalignmentou va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	flutuador
y	flutuador
zorder	flutuador

set_transform ( trans )

Defina a transformação do artista.

Parâmetros :

tTransform

propriedade visible_edges

As bordas da célula a serem desenhadas com uma linha.

A leitura dessa propriedade retorna uma substring de 'BRTL' (inferior, direita, superior, esquerda').

Ao configurar esta propriedade, você pode usar uma substring de 'BRTL' ou uma de {'open', 'closed', 'horizontal', 'vertical'}.

matplotlib.table. CustomCell

pseudônimo deCell

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

Bases:Artist

Uma tabela de células.

A tabela consiste em uma grade de células, que são indexadas por (linha, coluna).

Para uma tabela simples, você terá uma grade completa de células com índices de (0, 0) a (num_rows-1, num_cols-1), na qual a célula (0, 0) está posicionada no canto superior esquerdo. No entanto, você também pode adicionar células com índices negativos. Você não precisa adicionar uma célula para cada posição da grade, então você pode criar tabelas que tenham buracos.

Observação : você geralmente não criará uma tabela vazia do zero. Em vez disso, use tablepara criar uma tabela a partir de dados.

Parâmetros :

machadomatplotlib.axes.Axes

O Axespara plotar a tabela.

loc str

A posição da célula em relação a ax . Este deve ser um dos arquivos codes.

bbox Bboxou nenhum

Uma caixa delimitadora na qual desenhar a tabela. Se não for None , substitui loc .

Outros Parâmetros :

** kwargs

Artistpropriedades.

AXESPAD = 0,02

A borda entre os eixos e a borda da mesa em unidades de eixos.

FONTE = 10

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

Crie uma célula e adicione-a à tabela.

Parâmetros :

linha int

Índice de linha.

col int

Índice da coluna.

*args, **kwargs

Todos os outros parâmetros são passados ​​para Cell.

Devoluções :

Cell

A célula criada.

auto_set_column_width ( col )

Defina automaticamente as larguras de determinadas colunas para tamanhos ideais.

Parâmetros :

col int ou sequência de ints

Os índices das colunas para dimensionar automaticamente.

auto_set_font_size ( valor = True )

Defina automaticamente o tamanho da fonte.

codes = {'melhor': 0, 'inferior': 17, 'inferior esquerdo': 12, 'inferior direito': 13, 'centro': 9, 'centro esquerdo': 5, 'centro direito': 6, ' esquerda': 15, 'centro inferior ': 7, 'esquerda inferior ': 3, 'direita inferior ': 4, 'direita': 14, 'superior': 16, 'superior esquerdo': 11, 'superior direito': 10, 'centro superior ':8, 'superior esquerdo': 2, 'superior direito': 1}

Possíveis valores onde colocar a tabela em relação aos Eixos.

contém ( evento do mouse )

Teste se o artista contém o evento do mouse.

Parâmetros :

evento do mousematplotlib.backend_bases.MouseEvent

Devoluções :

contém bool

Se algum valor está dentro do raio.

detalhes do ditado

Um dicionário específico do artista com detalhes do contexto do evento, como quais pontos estão contidos no raio de seleção. Consulte as subclasses individuais de Artista para obter detalhes.

desenhar ( renderizador )

Desenhe o Artista (e seus filhos) usando o renderizador fornecido.

Isso não tem efeito se o artista não estiver visível ( Artist.get_visible retorna False).

Parâmetros :

subclasse do renderizador .RendererBase

Notas

Este método é substituído nas subclasses Artist.

bordas de propriedade

O valor padrão de visible_edgescélulas recém-adicionadas usando add_cell.

Notas

Atualmente, essa configuração afeta apenas células recém-criadas usando add_cell.

Para alterar as células existentes, você deve definir suas bordas explicitamente:

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

get_celld ( )

Retorna um dict de células no mapeamento da tabela (linha, coluna) para Cells.

Notas

Você também pode indexar diretamente no objeto Tabela para acessar células individuais:

cell = table[row, col]

get_children ( )

Retorna os Artistas contidos na tabela.

get_window_extent ( renderizador = Nenhum )

Obtenha a caixa delimitadora do artista no espaço de exibição.

A largura e a altura da caixa delimitadora não são negativas.

As subclasses devem substituir a inclusão no cálculo "apertado" da caixa delimitadora. O padrão é retornar uma caixa delimitadora vazia em 0, 0.

Tenha cuidado ao usar esta função, os resultados não serão atualizados se a extensão da janela do artista for alterada. A extensão pode mudar devido a quaisquer alterações na pilha de transformação, como alterar os limites dos eixos, o tamanho da figura ou a tela usada (como é feito ao salvar uma figura). Isso pode levar a um comportamento inesperado em que as figuras interativas ficarão bem na tela, mas serão salvas incorretamente.

escala ( xscale , yscale )

Escale as larguras das colunas por xscale e as alturas das linhas por yscale .

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animado=<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> , rasterizado=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> ,url=<UNSET> ,visível=<UNSET> , zorder=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
animated	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
figure	Figure
fontsize	flutuador
gid	str
in_layout	bool
label	objeto
mouseover	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
rasterized	bool
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
transform	Transform
url	str
visible	bool
zorder	flutuador

set_fontsize ( tamanho )

Defina o tamanho da fonte, em pontos, do texto da célula.

Parâmetros :

tamanho flutuante

Notas

Desde que o tamanho automático da fonte não tenha sido desabilitado, o valor será cortado de forma que o texto caiba horizontalmente na célula.

Você pode desativar esse comportamento usando auto_set_font_size.

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

No entanto, não há dimensionamento automático da altura da linha para que o texto exceda o limite da célula.

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 = 'inferior' , bbox= Nenhum , bordas = 'fechado' , ** kwargs )

Adicionar uma tabela a um arquivo Axes.

Pelo menos um entre cellText ou cellColours deve ser especificado. Esses parâmetros devem ser listas 2D, nas quais as listas externas definem as linhas e a lista interna define os valores das colunas por linha. Cada linha deve ter o mesmo número de elementos.

A tabela pode opcionalmente ter cabeçalhos de linha e coluna, que são configurados usando rowLabels , rowColours , rowLoc e colLabels , colColours , colLoc respectivamente.

Para um controle mais refinado sobre as tabelas, use a Tableclasse e adicione-a aos eixos com Axes.add_table.

Parâmetros :

cellText 2D lista de str, opcional

Os textos a serem colocados nas células da tabela.

Nota : As quebras de linha nas strings não são consideradas no momento e farão com que o texto exceda os limites da célula.

cellColours lista 2D de cores, opcional

As cores de fundo das células.

cellLoc {'esquerda', 'centro', 'direita'}, padrão: 'direita'

O alinhamento do texto dentro das células.

lista colWidths de float, opcional

As larguras das colunas em unidades dos eixos. Se não for fornecido, todas as colunas terão uma largura de 1 / ncols .

lista rowLabels de str, opcional

O texto das células do cabeçalho da linha.

rowColours lista de cores, opcional

As cores das células do cabeçalho da linha.

rowLoc {'esquerda', 'centro', 'direita'}, padrão: 'esquerda'

O alinhamento do texto das células do cabeçalho da linha.

lista colLabels de str, opcional

O texto das células do cabeçalho da coluna.

colColours lista de cores, opcional

As cores das células do cabeçalho da coluna.

colLoc {'esquerda', 'centro', 'direita'}, padrão: 'esquerda'

O alinhamento do texto das células do cabeçalho da coluna.

loc str, opcional

A posição da célula em relação a ax . Este deve ser um dos arquivos codes.

bbox Bbox, opcional

Uma caixa delimitadora na qual desenhar a tabela. Se não for None , substitui loc .

bordas substring de 'BRTL' ou {'aberto', 'fechado', 'horizontal', 'vertical'}

As bordas da célula a serem desenhadas com uma linha. Veja também visible_edges.

Devoluções :

Table

A tabela criada.

Outros Parâmetros :

** kwargs

Tablepropriedades.

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
animated	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
figure	Figure
fontsize	flutuador
gid	str
in_layout	bool
label	objeto
mouseover	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
rasterized	bool
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
transform	Transform
url	str
visible	bool
zorder	flutuador