keypoints_uv_to_points — REPRCONV keypoint op

• 데이터 종류: keypoints → points

• 호출: import reprconv; reprconv.keypoints_uv_to_points(keypoints, z=0.0)(또는 opsreprconv.get("keypoints_uv_to_points"))

사용법

이미지 좌표 `(N,2) = (u, v) → 점군 (N,3) = (z, y, x). keypoints` 의 출구.

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

op 名に軸の約束が書いてあるのは、この repo で `keypoints` を産む

`match3d.project_points が **(u, v) = (列, 行)** を返し、points` を産む

`fuse3d.to_points(voxel)` が (z, y, x) を返すから —— 素直に「先頭 2 列」

として繋ぐと例外も NaN も出ないまま行と列が入れ替わる。ここでは

`y = v、x = u` と明示的に入れ替えて渡す。

:func:points_zyx_to_keypoints_uv と往復して bit 一致(z を渡した向き)。

Args:

keypoints: (N, 2) の (u, v)。

z: 載せる平面の z(スカラ、または (N,) の配列)。

Returns:

(N, 3) float64 の (z, y, x)。

Raises:

ValueError: 形状不正 / 非有限 / z の長さ不一致。

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

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

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

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

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

• representation_roundtrip — py -3.11 examples/representation_roundtrip.py

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

points_zyx_to_keypoints_uv · points_to_position · select_points · flow_apply · points_to_gaussians

같은 카테고리(keypoint)

points_zyx_to_keypoints_uv · keypoints_to_image2d · keypoints_from_image2d · position_to_points · points_to_position

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

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