label_points — ANNOTATE `pointer` op

• Data kinds: image2d × pairs → image2d

• Call: 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) (or opsannotate.get("label_points"))

Usage

Number or annotate a set of points. Placed so they do not overlap (an exception if that is impossible).

> The detailed description below is the original text — the summary and the headings are translated.

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` のとき)。

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_gallery — py -3.11 examples/annotate_gallery.py

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

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

Same category (`pointer`)

arrow · leader_line · crosshair

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

label_points — ANNOTATE pointer op