photometric op• 데이터 종류: images → normalmap
• 호출: import fullseye as fs; fs.ledger.photometric_stereo(images, lights, mask=None, normalize=True, *, lit_only=False, lit_thresh=0.001)(구현을 직접 호출하려면 import photometric; photometric.photometric_stereo(images, lights, mask=None, normalize=True, *, lit_only=False, lit_thresh=0.001), 원장에서 가져오려면 ops3d.get("photometric_stereo"))
• 원장 경유의 반환값: fullseye.ledger.photometric_stereo(...) 는 **선언된 out 형 normalmap 의 값만** 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.photometric_stereo.raw(...) 를 쓰거나 photometric.photometric_stereo 를 직접 호출하세요.
Lambert 광도 스테레오: 알려진 광원 방향의 N 장에서 법선과 알베도를 복원. → (normals HxWx3, albedo HxW).
> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.
I_n = albedo * max(N·L_n, 0)。各画素で g = albedo*N を最小二乗 g = pinv(L) @ I で解き、
albedo=|g|, normal=g/|g|。N>=3 必要。albedo~0 や mask 外の画素は normal=(0,0,1)。
normalize=True で光源ベクトルを単位方向に正規化(render_lambertian と同一規約 = アルベド絶対値が正しく出る)。
強度重み付き光源を使うなら normalize=False にし、合成側も生ベクトルで揃えること。
lit_only(2026-09-04 追加): 付着影(attached shadow)を外して解く。モデルの
max(·, 0) は非線形なので、N·L < 0 の観測(真の値は 0)を線形最小二乗にそのまま入れると
解が偏る ―― 実測: 影も AO も無い球で中央値 9°、点灯している光源だけで解くと
0.000°。既定は False(従来の挙動を変えない)。True にすると画素ごとに
I > lit_thresh の光源だけを使って解き直す。同じ点灯パターンの画素をまとめて
1 回の疑似逆行列で処理するので、追加コストは光源数ぶんのパターン数に比例する程度
(6 灯なら最大 64 群)。点灯光源が 3 未満の画素は全光源の解に戻す(fail-open:
解けない画素を NaN にするより、偏っていても値がある方が下流の積分が壊れない)。
lit_thresh: 「点灯している」とみなす輝度の下限。撮影ノイズより上に置く。
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• photometric_stereo — py -3.11 examples_3d/photometric_stereo.py
normalmap 를 입력으로 받는 것)fuse_to_voxel · render_shaded · phong_shade · matcap_shade · brdf_lommel_seeliger · brdf_hapke · bump_normals_fbm · integrate_normals
photometric)surface_normals · integrate_normals · render_lambertian
*Provenance: photometric.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.