keypoints_from_image2d — REPRCONV `keypoint` op

• Datenarten: image2d → keypoints

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

Verwendung

Ein Zähl-/Antwortbild (H, W) → Bildkoordinaten (N,2) = (u, v). Der Rückweg des Roundtrips.

Teilt die Pixel > threshold mit 8er-Nachbarschaft in Zusammenhangskomponenten und liefert für jede Komponente den intensitätsgewichteten Schwerpunkt. Gewichtet wird, damit bei Antwortbildern, die noch Subpixel-Information enthalten (Korrelationspeaks u. Ä.), der Hin- und Rückweg-Fehler unter die Quantisierung gedrückt werden kann.

Beachten: Der 8er-Zusammenhang ist der Hauptverursacher des Verlusts: 2 Punkte auf benachbarten Pixeln verschmelzen zu 1 Komponente, und der Schwerpunkt wandert in die Mitte der 2 Punkte. selftest misst "Quantisierungsfehler nur gut getrennter Punkte" und "Gesamtfehler einschließlich Verschmelzung" getrennt (vermischt ließe sich nicht mit dem theoretischen Quantisierungswert 0.2887 px vergleichen).

Args:

image2d: (H, W) reelles Bild.

threshold: nur Pixel über diesem Wert werden aufgenommen.

Returns:

(N, 2) float64 (u, v). Die Zeilenreihenfolge ist die Labelreihenfolge von scipy.ndimage.label.

Raises:

ValueError: nicht 2-D / nicht endlich / nicht einmal 1 Pixel über dem Schwellwert.

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 `keypoints` als Eingabe)

keypoints_uv_to_points · keypoints_to_image2d

Gleiche Kategorie (`keypoint`)

keypoints_uv_to_points · points_zyx_to_keypoints_uv · keypoints_to_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).*

keypoints_from_image2d — REPRCONV keypoint op