plot op• 데이터 종류: axes × signal × signal → pairs
• 호출: import fullseye as fs; fs.ledger.data_to_pixel(axes, x, y)(구현을 직접 호출하려면 import annotate; annotate.data_to_pixel(axes, x, y), 원장에서 가져오려면 opsannotate.get("data_to_pixel"))
• 원장 경유의 반환값: fullseye.ledger.data_to_pixel(...) 는 선언된 out 형 pairs 의 값만 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.data_to_pixel.raw(...) 를 쓰거나 annotate.data_to_pixel 를 직접 호출하세요.
axes_transform 의 대응으로 데이터 점을 화소 (x, y) 로 옮깁니다.
클립하지 않는다 —— np.clip(v, lo, hi)는 lo > hi(반전 축)일때 조용히 hi를 반환하여, 모든 점이 끝에 달라붙은 "그럴듯한 거짓 그림"이된다(이 repo의 생성기가 실제로 한 번 속았다). 범위 밖을 튕겨내는 것은 plot_series의 clip=True의 일이며, 거기서는 예외로 한다.
(ndarray, ndarray)
px, py(float, 반올림하지 않는다 —— 반올림은 그리는 쪽의 일).
ValueError
log 축에 0 이하의 값을 넘겼을 때(-inf를 "끝"으로 그리는 그림은 거짓이 된다).
x와 y의 길이가 다를 때(아래 참조).
길이 불일치를 거부하는 것은 2026-09-02에 추가했다. 연쇄 퍼저가 이 op을실행할 수 있게 된 직후, 길이가 다른 2개의 signal을 넘기는 경로에서 채굴기가 np.stack의 날것의 ValueError로 떨어져 발각되었다. 그때까지는 x 7점· y 3점이라도 예외를 내지 않고, 길이가 다른 2개를 그대로 반환하고 있었다.
위험한 것은 떨어지는 것이 아니라 떨어지지 않는 것 —— 반환된 2개를 zip하면 3점만이, x의 앞쪽 3개 위치에 그려진다. 점이 사라진 것도, x가어긋난 것도 그림으로는 알 수 없다. 형제인 plot_series는 같은 상황을 "x and y must have the same length"로 거부하고 있었으므로, 같은 족 안에서규율이 갈라져 있었다(한쪽만 고쳐도 재발하는 유형이므로, 문구도 맞춰 두었다).
• dataset_conventions — 학습 데이터셋 규약 지식 — COCO / YOLO / VOC와 외관 검사의 함정
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• annotate_gallery — py -3.11 examples/annotate_gallery.py
• poc_beam_modal_video — py -3.11 examples/poc_beam_modal_video.py
• poc_camera_calibration — py -3.11 examples/poc_camera_calibration.py
• poc_crack_width_timeseries — py -3.11 examples/poc_crack_width_timeseries.py
• poc_motion_magnification — py -3.11 examples/poc_motion_magnification.py
• poc_strain_history — py -3.11 examples/poc_strain_history.py
• poc_structure_4d_deterioration — py -3.11 examples/poc_structure_4d_deterioration.py
• poc_superresolution_limits — py -3.11 examples/poc_superresolution_limits.py
• poc_traffic_counting — py -3.11 examples/poc_traffic_counting.py
• poc_wound_area_tracking — py -3.11 examples/poc_wound_area_tracking.py
• poc_xyt_event_surface — py -3.11 examples/poc_xyt_event_surface.py
pairs 를 입력으로 받는 것)label_points · annotate_invert_path · filled_polygon
plot)axes_transform · nice_ticks · axes_frame · grid_lines · ticks · plot_series
*Provenance: annotate.py — ANNOTATE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.