keypoints_uv_to_points — REPRCONV keypoint op

• Datenarten: keypoints → points

• Aufruf: import fullseye as fs; fs.ledger.keypoints_uv_to_points(keypoints, z=0.0) (die Implementierung direkt: import reprconv; reprconv.keypoints_uv_to_points(keypoints, z=0.0); aus dem Register: opsreprconv.get("keypoints_uv_to_points"))

Verwendung

Bildkoordinaten (N,2) = (u, v) → eine Punktmenge (N,3) = (z, y, x). Der Ausgang aus keypoints.

Die Achsenkonvention steht im op-Namen, weil in diesem repo der Erzeuger von keypoints, match3d.project_points, (u, v) = (Spalte, Zeile) liefert und der Erzeuger von points, fuse3d.to_points(voxel), (z, y, x) liefert -- naiv als "die ersten 2 Spalten" verbunden, werden Zeilen und Spalten ohne Ausnahme und ohne NaN vertauscht. Hier werden y = v und x = u explizit vertauscht weitergegeben.

Der Hin- und Rückweg mit points_zyx_to_keypoints_uv ist bitidentisch (in der Richtung, in der z übergeben wird).

Args:

keypoints: (N, 2) (u, v).

z: z der Ebene, auf die sie gelegt werden (Skalar oder (N,)-Array).

Returns:

(N, 3) float64 (z, y, x).

Raises:

ValueError: ungültige Form / nicht endlich / Länge von z passt nicht.

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• representation_roundtrip — py -3.11 examples/representation_roundtrip.py

Typkompatible Folge-Operatoren (nehmen points als Eingabe)

points_zyx_to_keypoints_uv · points_to_position · select_points · flow_apply · points_to_gaussians

Gleiche Kategorie (keypoint)

points_zyx_to_keypoints_uv · keypoints_to_image2d · keypoints_from_image2d · position_to_points · points_to_position


*Provenance: reprconv.py — REPRCONV Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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