fsim_pair — IMGMETRICS `perceptual` op

• Datenarten: rgbimage × rgbimage → table

• Aufruf: import fullseye as fs; fs.ledger.fsim_pair(ref, dist, data_range: 'float' = 255.0, downsample: 'bool' = True) -> 'dict' (die Implementierung direkt: import iqafsim; iqafsim.fsim_pair(ref, dist, data_range: 'float' = 255.0, downsample: 'bool' = True) -> 'dict'; aus dem Register: opsimgmetrics.get("fsim_pair"))

Verwendung

FSIM und FSIMc in einem Aufruf (die Phasenkongruenz wird pro Bild nur 1-mal berechnet — Evaluatoren und PoCs rufen diese Funktion auf).

Ablauf (Artikel §III): (1) F×F-Mittelung + Dezimierung mit F = max(1, round(min(H, W)/256)) (TID2013 mit 384×512 hat F = 2 → 192×256), (2) Phasenkongruenz PC von Y und Scharr-Gradientenbetrag G ([3 0 −3; 10 0 −10; 3 0 −3]/16), (3) S_PC = (2 PC1 PC2 + T1)/(PC1² + PC2² + T1), S_G = (2 G1 G2 + T2)/(G1² + G2² + T2),

(4) FSIM = Σ S_G S_PC PC_m / Σ PC_m (PC_m = max(PC1, PC2)), (5) FSIMc multipliziert zusätzlich mit dem Realteil der λ = 0.03-ten Potenz des Chroma-Terms I / Q S_I S_Q (T3 = T4 = 200).

Eingabe ist (H, W) oder (H, W, 3) gleicher Form (0–255; Skala per data_range deklarieren). Bei (H, W) gilt FSIMc = FSIM (kein Chroma-Term). TID2013-Autorenwerte: FSIM.txt stammt aus Y′-limited-Graubildern, FSIMc.txt aus Farbbildern (Tabelle im Modul-docstring) -- berechnet man beide aus 1 Farbbild, passt FSIM nicht zu FSIM.txt (max 0.0318). Rückgabe {"fsim", "fsimc", "f"} (f = Dezimierungsfaktor). Bei identischen Eingaben 1. Raises ValueError: Formen verschieden, kleiner als 2×2, Phasenkongruenz in allen Pixeln 0 (flaches Bild: FSIM ist 0/0 und nicht definiert).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie image_difference_metrics

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)

• poc_iqa_fsim_gmsd_vif — py -3.11 examples/poc_iqa_fsim_gmsd_vif.py

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

luma_limited_u8 · rank_data · tid2013_index · tid2013_by_distortion

Gleiche Kategorie (`perceptual`)

fsim · fsimc · gmsd · gmsd_map · vifp · phase_congruency_pc

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

fsim_pair — IMGMETRICS perceptual op