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 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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