background_flatten — 3D `surface_fit` op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.background_flatten(image, degree=2) (die Implementierung direkt: import match3d; match3d.background_flatten(image, degree=2); aus dem Register: ops3d.get("background_flatten"))

Verwendung

Passt eine Fläche niedriger Ordnung (ungleichmäßige Beleuchtung) an und subtrahiert sie = Shading-Korrektur. → flattened.

Passt fit_poly_surface(degree) (Standard 2. Ordnung) an ein (H,W)-Bild mit x = Spalte, y = Zeile an und gibt image − fit als float64 zurück. Die Ausgabe hat einen Mittelwert von fast 0 und enthält negative Werte (für Anzeige oder Schwellwertbildung das min abziehen oder eine Konstante addieren). Ist der Vordergrund groß, wird auch der Fit vom Vordergrund gezogen und dieser abgetragen (sicherer ist, auf Punkten ohne Vordergrund fit_poly_surface → mit eval_poly_surface subtrahieren). Nur Graustufen-2-D (3-D scheitert). NaN lässt lstsq scheitern.

Verwendung: Vorverarbeitung vor der Schwellwertbildung, Beleuchtungskorrektur von mit polar_unwrap abgewickelten Ringbildern.

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• blas_threads_and_memory — Warum Matrixzerlegungen langsam sind — BLAS-Threads, Caches, Speicherlayout

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)

• geometry_metrology — py -3.11 examples_3d/geometry_metrology.py

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

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

Gleiche Kategorie (`surface_fit`)

fit_poly_surface · eval_poly_surface · surface_form_error

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

background_flatten — 3D surface_fit op