label_points — ANNOTATE pointer op

• 資料種類:image2d × pairs → image2d

• 呼叫: import fullseye as fs; fs.ledger.label_points(img, points, labels=None, color='reference', font_size=12, pad=3, marker_size=0, scheme='okabe_ito', allow_overlap=False, **text_kw)(要直接呼叫實作,import annotate; annotate.label_points(img, points, labels=None, color='reference', font_size=12, pad=3, marker_size=0, scheme='okabe_ito', allow_overlap=False, **text_kw);從台帳取用則 opsannotate.get("label_points"))

用法

給點群編號或標註。避開重疊放置(避不開則擲出例外)。

Parameters

points : (N,2)

(x,y) 的點列。

labels : sequence or None

各點的文字。None 時為從 1 開始的編號。

marker_size : int

大於 0 時還會在各點打十字標記。

allow_overlap : bool

True 時允許重疊並放在第一個候選位置(預設為 False = 例外)。

Returns

ndarray

Raises

ValueError

點為空 / 非有限 / labels 數量不符 / 在任何候選位置都

與既有標籤重疊(allow_overlap=False 時)。

詳細使用指南

• 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

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

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

同類別(pointer)

arrow · leader_line · crosshair


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

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