data_to_pixel — ANNOTATE `plot` op

• 데이터 종류: axes × signal × signal → pairs

• 호출: import annotate; annotate.data_to_pixel(axes, x, y)(또는 opsannotate.get("data_to_pixel"))

사용법

:func:axes_transform 의 대응으로 데이터 점을 화소 `(x, y)` 로 옮깁니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

クリップしない ―― `np.clip(v, lo, hi) は lo > hi`(反転軸)の

とき黙って `hi` を返し、全点が端に貼り付いた「もっともらしい嘘の図」に

なる(この repo の生成器で実際に一度騙されている)。範囲外を弾くのは

:func:plot_series の `clip=True` の仕事で、そこでは例外にする。

Returns

-------

(ndarray, ndarray)

`px, py`(float、丸めない ―― 丸めは描画側の仕事)。

Raises

------

ValueError

log 軸に 0 以下の値を渡したとき(-inf を「端」として描く図は嘘になる)。

`x と y` の長さが違うとき(下記)。

Notes

-----

長さの不一致を拒否するのは 2026-09-02 に足した。連鎖ファザーがこの op を

実行できるようになった直後、長さの違う 2 本の signal を渡す経路で採掘器が

`np.stack の生の ValueError で落ちて発覚した。それまでは x` 7 点・

`y` 3 点でも例外を出さず、長さの違う 2 本をそのまま返していた。

危ないのは落ちることではなく、落ちないこと ―― 返った 2 本を `zip` すると

3 点だけが、x の先頭 3 つの位置に描かれる。点が消えたことも、x が

ずれたことも図からは分からない。兄弟の :func:plot_series は同じ状況を

`"x and y must have the same length"` で拒否していたので、**同じ族の中で

規律が割れていた**(片方だけ直しても再発する型なので、文言も揃えてある)。

자세한 사용 가이드

• figure_annotation 패밀리 가이드

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

• 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

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

label_points · filled_polygon

같은 카테고리(`plot`)

axes_transform · nice_ticks · axes_frame · grid_lines · ticks · plot_series

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

data_to_pixel — ANNOTATE plot op

사용법