matplotlib.pyplot.table

matplotlib.pyplot.table(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 添加一个表格。

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

该表格可以选择性地包含行和列标题，这些标题分别使用 rowLabels、rowColours、rowLoc 和 colLabels、colColours、colLoc 进行配置。

要对表格进行更精细的控制，请使用 Table 类，并通过 Axes.add_table 将其添加到 Axes 中。

参数:

cellTextstr 或 pandas.DataFrame 的二维列表，可选

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

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

cellColours二维 颜色 列表，可选

单元格的背景颜色。

cellLoc{'右', '中', '左'}

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

colWidths浮点数列表，可选

以 Axes 为单位的列宽。如果未给出，所有列的宽度将为 1 / ncols。

rowLabels字符串列表，可选

行标题单元格的文本。

rowColours 颜色 列表，可选

行标题单元格的颜色。

rowLoc{'左', '中', '右'}

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

colLabels字符串列表，可选

列标题单元格的文本。

colColours 颜色 列表，可选

列标题单元格的颜色。

colLoc{'中', '左', '右'}

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

loc字符串，默认值：'bottom'

单元格相对于 ax 的位置。这必须是 codes 中的一个。

bboxBbox 或 [xmin, ymin, width, height]，可选

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

edges{'闭合', '开放', '水平', '垂直'} 或 'BRTL' 的子字符串

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

返回:

表格

创建的表格。

其他参数:

**kwargs

Table 属性。

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	浮点数或 None
animated	布尔值
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
figure	Figure or SubFigure
fontsize	浮点数
gid	str
in_layout	布尔值
label	object
mouseover	布尔值
path_effects	list of AbstractPathEffect
picker	None 或 布尔值 或 浮点数 或 可调用对象
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	str
visible	布尔值
zorder	浮点数

备注

注意

这是 pyplot 包装器，对应 axes.Axes.table。

使用 matplotlib.pyplot.table 的示例

表格演示

表格演示