panel_grid — ANNOTATE compose op

• 資料種類:image2d → image2d

• 呼叫: import fullseye as fs; fs.ledger.panel_grid(panels, labels=None, ncols=3, pad=10, label_h=32, background=0.05, title=None, title_h=0, font_size=15, min_font_size=9, font_path=None, text_color=None, border=0, border_color='neutral', scheme='okabe_ito', style=None)(要直接呼叫實作,import annotate; annotate.panel_grid(panels, labels=None, ncols=3, pad=10, label_h=32, background=0.05, title=None, title_h=0, font_size=15, min_font_size=9, font_path=None, text_color=None, border=0, border_color='neutral', scheme='okabe_ito', style=None);從台帳取用則 opsannotate.get("panel_grid"))

用法

把面板排成網格,並在每個框下鋪一條標籤帶(montage / 印樣表)。

6 個產生器各自持有不同的實作,是本 repo 中重複最多的圖的元件。這裡的做法:

• 不放大 —— 小的面板放在中央,以空白填補。拉伸的話, 看起來就像「有並不存在的解析度」。

• 標籤先量測再繪製 —— 放不下就縮小,還不行就拋出例外(由 text_box 的邊界檢查捕捉)。

• 儲存格尺寸取所有面板的最大尺寸,網格一律是矩形。

Parameters

panels : sequence of ndarray

要排列的影像((H,W) / (H,W,C),尺寸可以各不相同)。

通道排列必須一致。

labels : sequence of str or None

各面板的標題。label_h 為 0 時不繪製。

ncols : int

行數。列數為 ceil(n/ncols)。

title : str or None

整體的標題(title_h 為 0 時自動預留 font_size+14)。

Returns

ndarray

新的合成影像(float [0,1])。尺寸為

W = 2*pad + ncols*cw + (ncols-1)*pad,

H = title_h + 2*pad + nrows*(ch+label_h) + (nrows-1)*pad。

Raises

ValueError

panels 為空 / 通道不一致 / ncols < 1 / 負的空白 /

labels 的數量不符。

詳細使用指南

• figure_annotation 族使用指南

背景知識指南(該運算子背後的物理與規範)

• dataset_conventions — 訓練資料集規範知識 —— COCO / YOLO / VOC 及外觀檢測中的陷阱

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

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

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• annotate_paper_tour — py -3.11 examples/annotate_paper_tour.py

型別可銜接的下一個運算子(可接受 image2d 作為輸入)

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

同類別(compose)

zoom_inset · compare_frame


*Provenance: annotate.py — ANNOTATE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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