annotate_table — ANNOTATE paper op

Data kinds: image2d × textimage2d

Call: 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) (to call the implementation directly, 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); from the registry, opsannotate.get("annotate_table"))

Usage

> This operator's description has not been translated yet. The original text follows as it is.

画像(image2d)を返す: タブ区切りの文字列をとして描く(半透明の板つき)。

桁幅は :func: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

:data:TABLE_ALIGNS。既定 `"auto"` は数の桁だけ右そろえ。

layout : dict or None

:func:annotate_table_layout の返りを渡すと再計算しない。

**渡した場合、`anchor` などは無視される**(両方渡さないこと)。

Returns

-------

(H,W[,C]) float64

表を描いた複製。入力は書き換えない

Raises

------

ValueError

:func: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

Detailed usage guide

figure_annotation family guide

Background guides (the physics and conventions behind this op)

dataset_conventions — 学習データセット規約の知識 — COCO / YOLO / VOC と外観検査での落とし穴

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

annotate_paper_tourpy -3.11 examples/annotate_paper_tour.py

poc_rotation_invariance_auditpy -3.11 examples/poc_rotation_invariance_audit.py

Ops the type connects to (they accept image2d as input)

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

Same category (paper)

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


*Provenance: annotate.py — ANNOTATE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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