matplotlib.table

表格绘图。

使用工厂功能 table 从文本创建现成的表格。如果您需要更多的控制，请使用 Table 类及其方法。

表格由单元格网格组成，这些单元格按（行、列）编制索引。单元格（0，0）位于左上角。

感谢约翰·吉尔为我们提供了教室和桌子。

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

基类：matplotlib.patches.Rectangle

单元格是 Rectangle 和一些相关的 Text .

作为用户，您很可能不会自己创建单元格。相反，您应该使用 table 工厂功能或 Table.add_cell .

参数:

xy二元语义

单元格左下角的位置。

width浮动

单元格宽度。

height浮动

细胞高度。

edgecolor颜色

单元格边框的颜色。

facecolor颜色

细胞表面颜色。

fill布尔

是否填充单元格背景。

textSTR

单元格文本。

loc{'left'、'center'、'right'}，默认值：'right'

单元格内文本的对齐方式。

fontproperties双关语

定义文本字体属性的dict。支持的键和值是接受的关键字参数 FontProperties .

visible_edgesstr，default:'关闭'

要用线绘制的单元格边：子字符串“BRTL”（底部、右侧、顶部、左侧）或“open”（未绘制边）、“closed”（绘制所有边）、“horizontal”（底部和顶部）、“vertical”（右侧和左侧）之一。

PAD = 0.1

文本和矩形之间的填充。

auto_set_font_size(renderer)

缩小字体大小，直到文本适合单元格宽度。

draw(renderer)

使用给定的渲染器绘制艺术家（及其子对象）。

如果艺术家不可见，则此操作无效 (Artist.get_visible 返回False）。

参数:

渲染器 ： RendererBase 子类。RenderBase子类。

笔记

此方法在Artist子类中被重写。

get_fontsize()

返回单元格字体大小。

get_path()

返回A Path 对于 visible_edges .

get_required_width(renderer)

返回单元格所需的最小宽度。

get_text()

返回单元格 Text 实例。

get_text_bounds(renderer)

将文本边界返回为 （x，y，宽，高） 在表坐标中。

set_figure(fig)

设置 Figure 艺术家所属的实例。

参数:

fig ： Figure图形

set_fontsize(size)

设置文本字体大小。

set_text_props(**kwargs)

更新文本属性。

有效的关键字参数为：

财产	描述
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
animated	布尔
backgroundcolor	颜色
bbox	带有属性的dict patches.FancyBboxPatch
clip_box	Bbox
clip_on	布尔
clip_path	面片或（路径、变换）或无
color 或c	颜色
contains	未知的
figure	Figure
fontfamily 或是家人	fontname，'serif'、'sans-serif'、'cursive'、'fantasy'、'monospace'
fontproperties 或字体或字体属性	font_manager.FontProperties or str or pathlib.Path
fontsize 或大小	浮点或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}
fontstretch 或者伸展	范围0-1000内的数值，'ultra condensed'、'extra condensed'、'condensed'、'semi condensed'、'normal'、'semi expanded'、'expanded'、'extra expanded'、'extra expanded'、'extra expanded'、'extra exp
fontstyle 或风格	'正常'、'斜体'、'斜体'
fontvariant 或变体	“普通”、“小大写”
fontweight 或重量	范围为0-1000、'ultralight'、'light'、'normal'、'regular'、'book'、'medium'、'roman'、'semibold'、'demi bold'、'demi'、'bold'、'heavy'、'extra bold'、'black'的数值。
gid	STR
horizontalalignment 或者哈	“居中”、“右”、“左”
in_layout	布尔
label	对象
linespacing	浮动（字体大小的倍数）
multialignment 或者妈妈	'左'、'右'、'中'
path_effects	AbstractPathEffect
picker	无、布尔或可呼叫
position	（浮标，浮标）
rasterized	布尔或无
rotation	浮动或{'vertical'，'horizontal'}
rotation_mode	无，'默认值'，'定位点'
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text	对象
transform	Transform
url	STR
usetex	布尔或无
verticalalignment 或者弗吉尼亚	‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；
visible	布尔
wrap	布尔
x	浮动
y	浮动
zorder	浮动

set_transform(trans)

设置艺术家变换。

参数:

t ： Transform变换

property visible_edges

要用直线绘制的单元格边缘。

读取此属性将返回“BRTL”（底部、右侧、顶部、左侧）的子字符串。

设置此属性时，可以使用“BRTL”子字符串或{'open'、'closed'、'horizontal'、'vertical'}之一的子字符串。

matplotlib.table.CustomCell

alias of matplotlib.table.Cell

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

基类：matplotlib.artist.Artist

一张单元格表格。

表格由单元格网格组成，这些单元格按（行、列）编制索引。

对于一个简单的表，您将有一个完整的单元格网格，索引范围从（0，0）到（num_rows-1，num_cols-1），其中单元格（0，0）位于左上角。但是，也可以添加索引为负的单元格。不必向每个网格位置添加单元，因此可以创建具有孔的表。

Note ：通常不会从头开始创建空表。而是使用 table 从数据创建表。

参数:

ax ： matplotlib.axes.Axesmatplotlib.axes.Axes

这个 Axes 将表格绘制成。

locSTR

单元相对于 ax . 这一定是 codes .

bbox ： Bbox 或无Bbox或无

一个用来绘制表格的边界框。如果不是这样 None ，此重写 loc .

其他参数:

**kwargs

Artist 性质。

AXESPAD = 0.02

轴和工作台边缘之间的边界（以轴为单位）。

FONTSIZE = 10

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

创建一个单元格并将其添加到表中。

参数:

row利息

行索引。

col利息

列索引。

*args, ** 夸克

所有其他参数都传递到 Cell .

返回:

Cell

创建的单元格。

auto_set_column_width(col)

自动将给定列的宽度设置为最佳大小。

参数:

colint或int序列

要自动缩放的列的索引。

auto_set_font_size(value=True)

自动设置字体大小。

codes = {'best': 0, 'bottom': 17, 'bottom left': 12, 'bottom right': 13, 'center': 9, 'center left': 5, 'center right': 6, 'left': 15, 'lower center': 7, 'lower left': 3, 'lower right': 4, 'right': 14, 'top': 16, 'top left': 11, 'top right': 10, 'upper center': 8, 'upper left': 2, 'upper right': 1}

相对于轴放置工作台的可能值。

contains(mouseevent)

测试艺术家是否包含鼠标事件。

参数:

鼠标移动 ： matplotlib.backend_bases.MouseEventmatplotlib.backend_bases.MouseEvent

返回:

contains布尔

是否有任何值在半径范围内。

details双关语

事件上下文详细信息的艺术家专用词典，例如拾取半径中包含哪些点。有关详细信息，请参见各个艺术家子类。

draw(renderer)

使用给定的渲染器绘制艺术家（及其子对象）。

如果艺术家不可见，则此操作无效 (Artist.get_visible 返回False）。

参数:

渲染器 ： RendererBase 子类。RenderBase子类。

笔记

此方法在Artist子类中被重写。

property edges

默认值为 visible_edges 对于新添加的单元格，使用 add_cell .

笔记

此设置当前只影响使用 add_cell .

要更改现有单元格，必须显式设置它们的边：

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

get_celld()

返回表映射中单元格的dict （行，列） 到 Cell S

笔记

也可以直接索引到表对象以访问单个单元格：

cell = table[row, col]

get_children()

返回表中包含的艺术家。

get_window_extent(renderer)

以窗口坐标返回表的边界框。

scale(xscale, yscale)

列宽比例 X标度 排高 大比例尺 .

set_fontsize(size)

设置单元格文本的字体大小（以磅为单位）。

参数:

size浮动

笔记

只要没有禁用自动字体大小，该值就会被剪裁，使文本水平地适合单元格。

可以使用禁用此行为 auto_set_font_size .

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

但是，不会自动缩放行高，因此文本可能会超出单元格边界。

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='bottom', bbox=None, edges='closed', **kwargs)

将表添加到 Axes .

至少有一个 单元格文本 或 细胞色素 必须指定。这些参数必须是二维列表，其中外部列表定义行，内部列表定义每行的列值。每行必须具有相同数量的元素。

该表可以选择具有行和列标题，这些标题是使用 行标签 ， 行颜色 ， 罗洛克 和 协作 ， 颜色 ， 科洛克 分别。

要对表进行更细粒度的控制，请使用 Table 类并将其添加到轴 Axes.add_table .

参数:

cellText二维str列表，可选

要放入表格单元格中的文本。

Note ：当前不考虑字符串中的换行符，这将导致文本超出单元格边界。

cellColours二维颜色列表，可选

单元格的背景色。

cellLoc{'left'、'center'、'right'}，默认值：'right'

单元格内文本的对齐方式。

colWidths浮动列表，可选

以轴为单位的列宽。如果未给定，则所有列的宽度将为 1 / ncols .

rowLabelsstr列表，可选

行标题单元格的文本。

rowColours颜色列表，可选

行标题单元格的颜色。

rowLoc{'left'，'center'，'right'}，默认值：'left'

行标题单元格的文本对齐方式。

colLabelsstr列表，可选

列标题单元格的文本。

colColours颜色列表，可选

列标题单元格的颜色。

colLoc{'left'，'center'，'right'}，默认值：'left'

列标题单元格的文本对齐方式。

loc可选的STR

单元相对于 ax . 这一定是 codes .

bbox ： Bbox 可选Bbox，可选

一个用来绘制表格的边界框。如果不是这样 None ，此重写 loc .

edges“BRTL”或{“open”、“closed”、“horizontal”、“vertical”}的子字符串

要用直线绘制的单元格边缘。另请参见 visible_edges .

返回:

Table

创建的表。

其他参数:

**kwargs

Table 性质。

财产	描述
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
animated	布尔
clip_box	Bbox
clip_on	布尔
clip_path	面片或（路径、变换）或无
contains	未知的
figure	Figure
fontsize	浮动
gid	STR
in_layout	布尔
label	对象
path_effects	AbstractPathEffect
picker	无、布尔或可呼叫
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	STR
visible	布尔
zorder	浮动