watermark_extract — IMGFORENSICS watermark op

• 데이터 종류: image2d → phash

• 호출: import imgforensics; imgforensics.watermark_extract(image, n_bits: 'int', wavelet: 'str' = 'haar', level: 'int' = 1) -> 'np.ndarray'(또는 opsimgforensics.get("watermark_extract"))

사용법

워터마크의 블라인드 추출. bool 의 1-D(`phash` 어휘)를 돌려줍니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

同じ DWT / ブロック分割で中帯域係数の対の大小を読むだけ。原画像も鍵も要らない

—— これは 秘匿ではなく完全性の印であり、鍵が無いので **誰でも消せるし

誰でも書ける**。所有権の主張には使えない。

返りが `phash 語彙なので、埋めたビット列との一致は :func:hash_distance` で

そのまま数えられる(BER = `hash_distance(sent, got) / n_bits`)。

語彙を合わせてあるのはそのため。

PyWavelets 必須(:class:ImportError)。

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

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• image_forensics_audit — py -3.11 examples/image_forensics_audit.py

타입이 이어지는 다음 연산자(phash 를 입력으로 받는 것)

hash_distance · watermark_embed · watermark_capacity

같은 카테고리(watermark)

watermark_embed · watermark_capacity

*Provenance: imgforensics.py — IMGFORENSICS 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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