keypoints_uv_to_points — REPRCONV keypoint op

Data kinds: keypointspoints

Call: import reprconv; reprconv.keypoints_uv_to_points(keypoints, z=0.0) (or opsreprconv.get("keypoints_uv_to_points"))

Usage

Image coordinates `(N,2) = (u, v) → a point set (N,3) = (z, y, x). The exit from keypoints`.

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

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

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

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

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

`y = vx = 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 の長さ不一致。

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)

representation_roundtrippy -3.11 examples/representation_roundtrip.py

Ops the type connects to (they accept points as input)

points_zyx_to_keypoints_uv · points_to_position · select_points · flow_apply · points_to_gaussians

Same category (keypoint)

points_zyx_to_keypoints_uv · keypoints_to_image2d · keypoints_from_image2d · position_to_points · points_to_position


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

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