matplotlib.table

表格绘图。

笔记

Matplotlib 中的表实现被轻微维护。对于更有特色的表格实现，您可能希望尝试blume。

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

该表由一个单元格网格组成，这些单元格由（行，列）索引。单元格 (0, 0) 位于左上角。

感谢 John Gill 提供课程和桌子。

类 matplotlib.table。单元格( xy , width , height , * , edgecolor = 'k' , facecolor = 'w' , fill = True , text = '' , loc = None , fontproperties = None , visible_edges = 'closed' )

基地：Rectangle

一个单元格是一个Rectangle与一些相关联的Text。

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

参数：

xy 2 元组

单元格左下角的位置。

宽度浮动

单元格宽度。

高度浮动

单元格高度。

边缘颜色颜色

单元格边框的颜色。

facecolor颜色

细胞面颜色。

填充布尔

是否填充单元格背景。

文字串

单元格文本。

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

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

字体属性字典

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

visible_edges str，默认值：“关闭”

用线条绘制的单元格边缘：“BRTL”（底部、右侧、顶部、左侧）的子字符串，或“开放”（不绘制边缘）、“闭合”（绘制所有边缘）、“水平”之一（底部和顶部），“垂直”（左右）。

垫= 0.1

文本和矩形之间的填充。

auto_set_font_size (渲染器)

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

绘制（渲染器）

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

如果艺术家不可见，这将无效（Artist.get_visible 返回 False）。

参数：

渲染器RendererBase子类。

笔记

此方法在 Artist 子类中被覆盖。

get_fontsize ( )

返回单元格字体大小。

get_path ( )

为. Path_visible_edges

get_required_width (渲染器)

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

get_text ( )

返回单元格Text实例。

get_text_bounds (渲染器)

在表格坐标中将文本边界返回为(x, y, width, height) 。

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , angle=<UNSET> , animated=<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> ,孵化=<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=<未设置> , y=<UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
angle	未知
animated	布尔
antialiased或aa	布尔或无
bounds	（左、下、宽、高）
capstyle	CapStyle或 {'butt', 'projecting', 'round'}
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
color	颜色
edgecolor或 ec	颜色或无
facecolor或 fc	颜色或无
figure	未知
fill	布尔
fontsize	未知
gid	字符串
hatch	{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
height	未知
in_layout	布尔
joinstyle	JoinStyle或 {'miter', 'round', 'bevel'}
label	目的
linestyle或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth或 lw	浮动或无
mouseover	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text_props	未知
transform	未知
url	字符串
visible	布尔
width	未知
x	未知
xy	（浮动，浮动）
y	未知
zorder	漂浮

set_figure ( fig )

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

参数：

图Figure

set_fontsize (大小)

设置文本字体大小。

set_text_props ( ** kwargs )

更新文本属性。

有效的关键字参数是：

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
animated	布尔
backgroundcolor	颜色
bbox	具有属性的字典patches.FancyBboxPatch
clip_box	未知
clip_on	未知
clip_path	未知
color或 c	颜色
figure	Figure
fontfamily或家人	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties或字体或字体属性	font_manager.FontProperties或str或pathlib.Path
fontsize或尺寸	浮动或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}
fontstretch或拉伸	{0-1000 范围内的数值，'超压缩'，'超压缩'，'压缩'，'半压缩'，'普通'，'半扩展'，'扩展'，'超扩展', '超膨胀'}
fontstyle或风格	{'正常'，'斜体'，'斜体'}
fontvariant或变体	{'正常', '小型大写字母'}
fontweight或重量	{0-1000 范围内的数值, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', '粗体'，'重'，'超粗体'，'黑色'}
gid	字符串
horizontalalignment或哈	{'左'，'中心'，'右'}
in_layout	布尔
label	目的
linespacing	浮动（字体大小的倍数）
math_fontfamily	字符串
mouseover	布尔
multialignment或马	{'左'，'右'，'中心'}
parse_math	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	（浮动，浮动）
rasterized	布尔
rotation	浮动或{'垂直'，'水平'}
rotation_mode	{无，'默认'，'锚点'}
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text	目的
transform	Transform
transform_rotates_text	布尔
url	字符串
usetex	布尔或无
verticalalignment或 va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	布尔
wrap	布尔
x	漂浮
y	漂浮
zorder	漂浮

set_transform ( trans )

设置艺术家变换。

参数：

吨Transform

属性 可见边缘

用线条绘制的单元格边缘。

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

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

matplotlib.table。CustomCell

的别名Cell

类 matplotlib.table。表( ax , loc = None , bbox = None , ** kwargs )

基地：Artist

一个单元格表。

该表由一个单元格网格组成，这些单元格由（行，列）索引。

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

注意：您通常不会从头开始创建空表。而是用于 table从数据创建表。

参数：

斧头matplotlib.axes.Axes

将Axes表格绘制成。

本地字符串

单元格相对于ax的位置。这一定是其中之一codes。

bboxBbox或无

用于绘制表格的边界框。如果这不是None，这将覆盖loc。

其他参数：

**kwargs

Artist特性。

AXESPAD = 0.02

Axes 和表格边缘之间的边界，以 Axes 为单位。

字体大小= 10

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

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

参数：

行整数

行索引。

col int

列索引。

*args, **kwargs

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

返回：

Cell

创建的单元格。

auto_set_column_width ( col )

自动将给定列的宽度设置为最佳尺寸。

参数：

col int 或整数序列

要自动缩放的列的索引。

auto_set_font_size ( value = True )

自动设置字体大小。

代码= {'最佳'：0，'底部'：17，'左下'：12，'右下'：13，'中心'：9，'左中'：5，'右中'：6，'左：15，“中下”：7，“左下”：3，“右下”：4，“右”：14，“上”：16，“左上”：11，“右上”：10、‘上中’：8, '左上': 2, ' 右上角': 1}

相对于轴放置表格的可能值。

包含( mouseevent )

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

参数：

鼠标事件matplotlib.backend_bases.MouseEvent

返回：

包含布尔

是否有任何值在半径内。

详细信息字典

事件上下文详细信息的艺术家特定字典，例如选择半径中包含哪些点。有关详细信息，请参阅各个 Artist 子类。

绘制（渲染器）

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

如果艺术家不可见，这将无效（Artist.get_visible 返回 False）。

参数：

渲染器RendererBase子类。

笔记

此方法在 Artist 子类中被覆盖。

属性 边缘

visible_edges使用 的新添加单元格的默认值add_cell。

笔记

此设置目前仅影响使用 add_cell.

要更改现有单元格，您必须明确设置它们的边缘：

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

get_celld ( )

将表映射（行、列）中的单元格字典返回到 Cells。

笔记

您还可以直接索引 Table 对象以访问单个单元格：

cell = table[row, col]

get_children ( )

返回表中包含的艺术家。

get_window_extent ( renderer = None )

在显示空间中获取艺术家的边界框。

边界框的宽度和高度是非负的。

子类应覆盖以包含在边界框“紧密”计算中。默认是在 0, 0 处返回一个空的边界框。

使用此功能时要小心，如果艺术家的艺术家窗口范围发生变化，结果将不会更新。由于变换堆栈中的任何更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做的那样），范围可能会发生变化。这可能会导致意外行为，其中交互式图形在屏幕上看起来很好，但会错误地保存。

scale ( xscale , yscale )

按xscale缩放列宽，按yscale缩放行高。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<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> ,变换=<UNSET> ,url=<未设置> ,visible=<UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
animated	布尔
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
figure	Figure
fontsize	漂浮
gid	字符串
in_layout	布尔
label	目的
mouseover	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
zorder	漂浮

set_fontsize (大小)

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

参数：

大小浮动

笔记

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

您可以使用禁用此行为auto_set_font_size。

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

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

matplotlib.table。表（ax， cellText = None， cellColours = None， cellLoc = 'right'， colWidths = None， rowLabels = None， rowColours = None， rowLoc = 'left'， colLabels = None， colColours = None， colLoc = 'center'， loc = '底部' , bbox= None , edges = 'closed' , ** kwargs )

将表添加到Axes.

必须至少指定cellText或cellColours之一。这些参数必须是 2D 列表，其中外部列表​​定义行，内部列表定义每行的列值。每行必须具有相同数量的元素。

该表可以选择具有行和列标题，它们分别使用rowLabels、rowColours、rowLoc和colLabels、colColours、 colLoc 配置。

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

参数：

cellText str 的二维列表，可选

要放置到表格单元格中的文本。

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

cellColours 2D 颜色列表，可选

单元格的背景颜色。

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

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

colWidths 浮点数列表，可选

以轴为单位的列宽。如果没有给出，所有列的宽度都是1 / ncols。

str 的rowLabels列表，可选

行标题单元格的文本。

rowColors颜色列表，可选

行标题单元格的颜色。

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

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

colLabels str 列表，可选

列标题单元格的文本。

colorColours颜色列表，可选

列标题单元格的颜色。

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

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

loc str，可选

单元格相对于ax的位置。这一定是其中之一codes。

bbox Bbox, 可选

用于绘制表格的边界框。如果这不是None，这将覆盖loc。

'BRTL' 或 {'open', 'closed', 'horizo​​ntal', 'vertical'} 的边子串

用线条绘制的单元格边缘。另请参阅 visible_edges。

返回：

Table

创建的表。

其他参数：

**kwargs

Table特性。

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
animated	布尔
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
figure	Figure
fontsize	漂浮
gid	字符串
in_layout	布尔
label	目的
mouseover	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
zorder	漂浮