perceptual op• Data kinds: rgbimage × rgbimage → table
• Call: import fullseye as fs; fs.ledger.fsim_pair(ref, dist, data_range: 'float' = 255.0, downsample: 'bool' = True) -> 'dict' (implementation को सीधे call करना हो तो import iqafsim; iqafsim.fsim_pair(ref, dist, data_range: 'float' = 255.0, downsample: 'bool' = True) -> 'dict', registry से लेना हो तो opsimgmetrics.get("fsim_pair"))
FSIM और FSIMc एक साथ (phase congruency 1 image पर केवल 1 बार गणना होती है — evaluator और PoC इसी को call करते हैं)।
प्रक्रिया (paper §III): (1) F = max(1, round(min(H, W)/256)) से F×F औसत + decimation (TID2013 के 384×512 में F = 2 → 192×256), (2) Y की phase congruency PC और Scharr ([3 0 −3; 10 0 −10; 3 0 −3]/16) gradient magnitude G, (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 में chroma I / Q के S_I S_Q (T3 = T4 = 200) की λ = 0.03 घात का real part गुणा किया जाता है।
input समान shape का (H, W) या (H, W, 3) है (0–255; पैमाना data_range से घोषित करें)। (H, W) होने पर FSIMc = FSIM (chroma term नहीं होता)। TID2013 के लेखक मान: FSIM.txt Y′ limited grey images से है, FSIMc.txt रंगीन images से (module docstring की तालिका) -- 1 रंगीन image से दोनों निकालने पर FSIM वाला FSIM.txt से मेल नहीं खाता (max 0.0318)। return value {"fsim", "fsimc", "f"} (f = decimation factor)। समान input पर 1। Raises ValueError: shape अलग, 2×2 से छोटा, phase congruency सभी pixels पर 0 (समतल image: FSIM 0/0 है और परिभाषित नहीं)।
• image_difference_metrics family guide
• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।
• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।
• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।
• poc_iqa_fsim_gmsd_vif — py -3.11 examples/poc_iqa_fsim_gmsd_vif.py
table को input के रूप में लेते हैं)luma_limited_u8 · rank_data · tid2013_index · tid2013_by_distortion
perceptual)fsim · fsimc · gmsd · gmsd_map · vifp · phase_congruency_pc
*Provenance: iqafsim.py — IMGMETRICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.