annotate_table — ANNOTATE paper op

• 数据种类:image2d × text → image2d

• 调用: import fullseye as fs; fs.ledger.annotate_table(img, text, xy, anchor='lt', font_size=13, color='neutral', text_color=None, box_color=None, box_alpha=0.72, pad=6, col_gap=None, row_gap=0, align='auto', header=False, grid=False, border=0, border_color=None, font_path=None, scheme='okabe_ito', min_contrast=2.0, bold=False, italic=False, line_spacing=1.15, style=None, layout=None)(要直接调用实现,import annotate; annotate.annotate_table(img, text, xy, anchor='lt', font_size=13, color='neutral', text_color=None, box_color=None, box_alpha=0.72, pad=6, col_gap=None, row_gap=0, align='auto', header=False, grid=False, border=0, border_color=None, font_path=None, scheme='okabe_ito', min_contrast=2.0, bold=False, italic=False, line_spacing=1.15, style=None, layout=None);从台账取用则 opsannotate.get("annotate_table"))

用法

返回图像(image2d):将制表符分隔的字符串绘制成表格(带半透明底板)。

列宽由 annotate_table_layout 用实际字体测量决定。默认的列间距是行高的 0.6 倍,所以改变 font_size 时间距也随之变化。衬板默认半透明(box_alpha=0.72,0 表示无衬板)。

Parameters

box_alpha : float

衬板的不透明度 [0,1]。0 时不绘制衬板。半透明时下方的图会

透出来,所以文字颜色是针对“实际出现在下方的颜色”检查的。

grid : bool

为真时在列与行的边界画浅色线。默认不画(没有线的表格往往

更易读,需要时再加即可)。

header : bool

为真时把第 1 行设为粗体,并在其下画 1 条线。

align : str or sequence

TABLE_ALIGNS。默认 "auto" 只把数字列右对齐。

layout : dict or None

传入 annotate_table_layout 的返回值即不重新计算。

传入时 anchor 等会被忽略(不要两者都传)。

Returns

(H,W[,C]) float64

绘制了表格的副本。不修改输入。

Raises

ValueError

与 annotate_table_layout 相同 + 表格超出图像 +

文字相对于底色低于 min_contrast(不会默默裁掉)。

Examples

>>> import numpy as np, annotate

>>> img = np.zeros((120, 260, 3))

>>> out = annotate.annotate_table(img, "项目\t值\n面积\t12.5\n周长\t9.75",

... (10, 10), header=True)

>>> out.shape

(120, 260, 3)

>>> float(np.abs(out - img).max()) > 0.1

True

详细使用指南

• figure_annotation 族使用指南

背景知识指南(该算子背后的物理与约定)

• dataset_conventions — 训练数据集规范知识 —— COCO / YOLO / VOC 及外观检测中的陷阱

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• annotate_paper_tour — py -3.11 examples/annotate_paper_tour.py

• poc_rotation_invariance_audit — py -3.11 examples/poc_rotation_invariance_audit.py

类型可衔接的下一个算子(可接受 image2d 作为输入)

text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar

同类别(paper)

annotate_leader_layout · annotate_leader · annotate_markers · annotate_legend · annotate_dimension_layout · annotate_dimension · annotate_angle_layout · annotate_angle


*Provenance: annotate.py — ANNOTATE 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.