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):將以 Tab 分隔的字串繪製成表格(帶半透明底板)。

欄寬由 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.