phase_congruency_pc — IMGMETRICS perceptual op

• 資料種類:image2d → image2d

• 呼叫: import fullseye as fs; fs.ledger.phase_congruency_pc(img, data_range: 'float' = 255.0, nscale: 'int' = 4, norient: 'int' = 4, min_wavelength: 'float' = 6.0, mult: 'float' = 2.0, sigma_onf: 'float' = 0.55, dtheta_on_sigma: 'float' = 1.2, k: 'float' = 2.0, epsilon: 'float' = 0.0001) -> 'np.ndarray'(要直接呼叫實作,import iqafsim; iqafsim.phase_congruency_pc(img, data_range: 'float' = 255.0, nscale: 'int' = 4, norient: 'int' = 4, min_wavelength: 'float' = 6.0, mult: 'float' = 2.0, sigma_onf: 'float' = 0.55, dtheta_on_sigma: 'float' = 1.2, k: 'float' = 2.0, epsilon: 'float' = 0.0001) -> 'np.ndarray';從台帳取用則 opsimgmetrics.get("phase_congruency_pc"))

用法

相位一致性 PC(x) = Σ_o E_o(x) / Σ_o Σ_s A_{s,o}(x) ∈ [0, 1] (Kovesi 1999,FSIM 論文式 4 的慣例:log-Gabor 4 個尺度 × 4 個方向)。

與現有的 phase_congruency(backends_transform2,Riesz/單演版,無方向,旋鈕 a/b)是不同的東西,所以加後綴 _pc。從 E_o = Σ_s [e ē + o ō − |e ō − o ē|] (ē, ō = 該方向總和向量的單位方向,ε = 1e-4 只用於這個單位向量化)中減去 Kovesi 的雜訊閾值 T 並在 0 處截斷:最小尺度 |EO|² 的中位數 → Rayleigh 的平均 −median/ln 0.5 → 雜訊功率 → 含濾波器重疊的雜訊能量平均 + k σ,最後除以 1.7(Kovesi 的經驗法則)。不乘頻率擴展的 sigmoid 權重(FSIM 的式 4 中沒有)。

增益不變:輸入乘以常數 PC 不變 —— 只差 ε 的部分(ε = 1e-4 時最大 3e-5,嚴格與 ε 成正比)。輸入 (H, W)((H, W, 3) 用 Y)。預設值取自 FSIM 論文 §IV-A(λ_min = 6、mult = 2、σ_r = 0.55、σ_θ = π/4/1.2、k = 2)。Raises ValueError:小於 2×2、非有限、data_range ≤ 0。

詳細使用指南

• image_difference_metrics 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_iqa_fsim_gmsd_vif — py -3.11 examples/poc_iqa_fsim_gmsd_vif.py

型別可銜接的下一個運算子(可接受 image2d 作為輸入)

mse · rmse · psnr · ssim · ms_ssim · ssim_map · image_entropy · joint_entropy

同類別(perceptual)

fsim · fsimc · fsim_pair · gmsd · gmsd_map · vifp


*Provenance: iqafsim.py — IMGMETRICS 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.