annotate_markers — ANNOTATE paper op

• 데이터 종류: image2d → image2d

• 호출: import fullseye as fs; fs.ledger.annotate_markers(img, points, labels=None, start=1, radius=9.0, color='emphasis', text_color=None, font_size=11, scheme='okabe_ito', font_path=None, min_contrast=2.0)(구현을 직접 호출하려면 import annotate; annotate.annotate_markers(img, points, labels=None, start=1, radius=9.0, color='emphasis', text_color=None, font_size=11, scheme='okabe_ito', font_path=None, min_contrast=2.0), 원장에서 가져오려면 opsannotate.get("annotate_markers"))

사용법

이미지(image2d)를 돌려줍니다: 번호(또는 짧은 글자)가 든 둥근 마커를 각 점에 놓습니다.

annotate_legend와 같은 start / labels를 넘기면, 그림 안의 번호와범례의 번호가 반드시 일치한다.

Parameters

points : (N, 2)

(x, y). 영상 밖의 점은 ValueError.

labels : sequence of str or None

None이면 start부터 연번.

radius : float

원의 반경[px]. 글자가 들어가지 않으면 ValueError.

Raises

ValueError

점이 비어 있음·비유한·영상 밖, labels의 수 불일치, 글자가 원에 들어가지 않음,

글자색과 원 색의 대비 부족.

자세한 사용 가이드

• figure_annotation 패밀리 가이드

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

• dataset_conventions — 학습 데이터셋 규약 지식 — COCO / YOLO / VOC와 외관 검사의 함정

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• paper_figure — py -3.11 examples/paper_figure.py

타입이 이어지는 다음 연산자(image2d 를 입력으로 받는 것)

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

같은 카테고리(paper)

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


*Provenance: annotate.py — ANNOTATE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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