gray op• Datenarten: image → image
• Aufruf: fullseye.apply(img, "invert", a=0.5, b=0.5) (das 2-D-Modell ist ein Bild plus zwei skalare Regler a,b∈[0,1])
• HALCON-Äquivalent: invert_image (Bedeutung und Parameter sind in der HALCON-Referenz nachzulesen)
*Die Abbildung ist die tatsächliche Ausgabe auf einer synthetischen 128×128-Eingabe. Links Eingabe, rechts Ausgabe. Punktwolken als Draufsicht-Streudiagramm (Helligkeit = z), 1-D-Reihen als Linie, Volumen als Maximum-Projektion entlang z, Videos als mittleres Bild, komplexe Bilder als Betrag; Rückgabewerte, die kein Bild ergeben, werden als Werte gezeigt.*
*Regler a ändert die Ausgabe nicht (gemessen: identisch bei 0,1 / 0,5 / 0,9).*
*Regler b ändert die Ausgabe nicht (gemessen: identisch bei 0,1 / 0,5 / 0,9).*
Auf anderen Bildern (synthetische Szene / Foto / Münzen. Obere Reihe: Eingaben, untere Reihe: deren Ausgaben. Regler auf Standard):
▸ invert: andere Eingaben (Doku-Website)
*Die 4. Spalte ist eine Farb-Eingabe (H,W,3). Dieser Op verarbeitet Farbe, ohne Kanäle zu vermischen (er faltet den Farbkanal nicht als dritte Raumachse).*
Tonwertumkehr (Negativ-Positiv-Umkehrung). Entspricht HALCONs invert_image (Invert an image.).
Gibt lediglich 1 - clip(v,0,1) zurück. a, b werden nicht verwendet.
• Die Eingabe wird zuerst auf [0,1] geclippt und dann invertiert, daher werden Werte außerhalb des Bereichs nach der Sättigung invertiert (1.3 → 0, -0.2 → 1). Arrays, deren Wertebereich nicht [0,1] ist, in einer früheren Stufe normieren.
• Der Rückgabewert ist ein float in der Form der Eingabe, Wertebereich [0,1]. NaN läuft durch clip hindurch und wird als NaN zurückgegeben (es ist ein direkt in ops.py registriertes Op, daher greift der Guard des Backends nicht - um nicht-endliche Werte abzufangen, über fullseye.apply mit on_error="raise" gehen).
• 2 Mal angewendet ergibt es das Original (Involution). Auf eine region angewendet tauscht es Vordergrund/Hintergrund, doch für regions gibt es invert_region (Komplement).
• Einsatzzwecke: Invertieren, bevor ein dunkles Objekt mit threshold als "helle Seite" erfasst wird; das dunkle Residuum von dc_rpca_sparse oder die schwarzen Linien von xpil_contour zu einem positiven Signal machen; das "innen dunkler" einer Distanztransformation als "innen heller" umdeuten.
• Leitfaden zur Familie gallery2d_gray_arith
• 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.
Das Programm unten ist nachweislich lauffähig (gleiche Eingabe wie die Abbildung). In der Studio-Hilfe wird dieser Block zu Schaltflächen, die es sofort laden und ausführen.
invert 0.50 0.50
▸ Diese Pipeline laden · Laden & ausführen
• gallery2d_gray_arith — py -3.11 examples/gallery2d_gray_arith.py
• genspark_external_review — py -3.11 examples/genspark_external_review.py
• poc_tacscalib_sphere_lut — py -3.11 examples/poc_tacscalib_sphere_lut.py
image als Eingabe)identity · gaussian · mean_box · bilateral · unsharp · median · min_filter · max_filter
gray)gamma · quantize_uniform · quantize_lloyd_max · quantization_error · dither_ordered · dither_floyd_steinberg · companding_mu_law · banding_map
*Provenance: ops.py — 2D 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.