polar_unwrap — 3D `curvilinear` op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.polar_unwrap(image, center=None, r_in=0.0, r_out=None, ntheta=360, nr=64, device='cpu') (die Implementierung direkt: import match3d; match3d.polar_unwrap(image, center=None, r_in=0.0, r_out=None, ntheta=360, nr=64, device='cpu'); aus dem Register: ops3d.get("polar_unwrap"))

• GPU: Dieser Operator hat einen GPU-Pfad (device="cuda")

Verwendung

Wickelt einen Kreisring oder eine Scheibe eines Bildes in ein (θ × r)-Rechteck ab (industriell: Prüfung von Etiketten, Ringen und Rotationskörpern).

Streckt entlang des Umfangs angeordnete Merkmale "vertikal", sodass gewöhnliche 2D-Verfahren (Geradensuche/Korrelation) anwendbar sind. grid_sample. Die θ-Achse hat keinen endpoint (Winkel von Zeile k = k·2π/ntheta) = ein periodisches Gitter, das 0° und 360° nicht doppelt abtastet (erfüllt die Voraussetzung von FFT/zyklischer Korrelation entlang θ. Korrigiert 2026-08-30; die alte Version hatte erste Zeile = letzte Zeile).

Raises ValueError: Eingabe nicht 2-D, kleiner als 2x2 oder NaN/Inf/float32-Überlauf.

Argumente: center=(cy, cx) ist in der Reihenfolge (Zeile, Spalte) (Standard ist die Bildmitte ((H−1)/2, (W−1)/2)). r_in-r_out (Pixel, Standard min(H,W)/2 − 1) wird in nr gleiche Teile geteilt, der Winkel in ntheta gleiche Teile. Ausgabe (ntheta, nr) float32: Winkel von Zeile k θ = k·2π/ntheta, Radius von Spalte j r = r_in + j·(r_out − r_in)/(nr−1), Abtastpunkte sind (cy + r sinθ, cx + r cosθ) (θ=0 ist die +Spaltenrichtung; mit wachsendem θ dreht es in Richtung +Zeile). Außerhalb des Bildes wird mit 0 gefüllt (bilinear).

Nachgelagert: Geradensuche in Zeilenrichtung (θ) und ncc_locate, Drehwinkel per 1-D-Korrelation entlang θ.

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.

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

• curvilinear_proj — py -3.11 examples_3d/curvilinear_proj.py

Typkompatible Folge-Operatoren (nehmen `image2d` als Eingabe)

fuse_to_voxel · fit_poly_surface · eval_poly_surface · surface_form_error · background_flatten · fit_zernike · matcap_shade · antialias

Gleiche Kategorie (`curvilinear`)

cylinder_unwrap · fit_zernike

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

polar_unwrap — 3D curvilinear op