occlusion_edges — 3D range_image op

• Datenarten: depth → image2d

• Aufruf: import fullseye as fs; fs.ledger.occlusion_edges(depth, rel_thresh=0.05) (die Implementierung direkt: import range_image; range_image.occlusion_edges(depth, rel_thresh=0.05); aus dem Register: ops3d.get("occlusion_edges"))

Verwendung

Detektiert Tiefensprünge (die Vorder-/Hintergrundgrenze = Verdeckungskanten). → bool HxW.

Eine Verdeckungskante ist eine Unstetigkeit (step) der Tiefe, keine Neigung (slope). Eine gleichmäßig geneigte Fläche ist stetig und enthält keine Verdeckung, darf also nicht markiert werden. Der Gradient erster Ordnung (=Tiefe/Pixel) ist die Neigung selbst und kann Stufe und Hang nicht unterscheiden (und ihn mit einem Anteil der absoluten Tiefe zu vergleichen, ist dimensional inkonsistent).

Daher wird pro Achse die Differenz zweiter Ordnung (entspricht dem diskreten Laplace-Operator) d[i+1]-2*d[i]+d[i-1] verwendet. Bei gleichmäßiger Neigung (Tiefe in der Nachbarschaft linear) ist die zweite Differenz ≈ 0, bei einer fronto-parallelen Stufe auf beiden Seiten groß. Pixel, deren auf die lokale Tiefe normierter relativer Tiefensprung rel_thresh überschreitet, gelten als Grenze.

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• blender_interop — Zusammen mit Blender — Form bauen, mit fullseye messen (Fallstricke: Achsen, Einheiten, Referenzdaten)

• depth_sensors — Tiefensensoren — Messprinzipien, Werte realer Geräte, wie Messlücken entstehen

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)

• range_image — py -3.11 examples_3d/range_image.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

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

Gleiche Kategorie (range_image)

depth_to_organized_points · normals_from_depth · bearing_angle_image


*Provenance: range_image.py — 3D 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.