brdf_hapke — 3D `render` op

• 데이터 종류: normalmap → image2d

• 호출: import fullseye as fs; fs.ledger.brdf_hapke(normals, light=(0.0, 0.0, 1.0), view=(0.0, 0.0, 1.0), w: 'float' = 0.42, g: 'float' = -0.35, B0: 'float' = 0.87, h: 'float' = 0.01, roughness_deg: 'float' = 26.0) -> 'np.ndarray'(구현을 직접 호출하려면 import render_shade; render_shade.brdf_hapke(normals, light=(0.0, 0.0, 1.0), view=(0.0, 0.0, 1.0), w: 'float' = 0.42, g: 'float' = -0.35, B0: 'float' = 0.87, h: 'float' = 0.01, roughness_deg: 'float' = 26.0) -> 'np.ndarray', 원장에서 가져오려면 ops3d.get("brdf_hapke"))

사용법

Hapke 반사 법칙(충효과 + 다중 산란 + 거시적 거칠기 θ̄)으로 법선 맵에 음영을 넣고 I/F `(H, W)` 를 돌려줍니다.

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

既定値はイトカワの S 型典型値(Kitazato et al. 2008): w=0.42, g=−0.35, B0=0.87,

h=0.01, θ̄=26°。位相角は `light/view` から一定値として求める(平行光・正射影近似)。

fail-closed: 各パラメータの範囲外・法線形状不正は `ValueError`。

:func:brdf_shade の `model='hapke' の薄い包みで、各画素の μ0 = clip(N·L,0,1)`、

`μ = clip(N·V,0,1) と、画面全体で一定の位相角 g = arccos(L·V)`(ラジアン)を

:func:hapke_reflectance に渡し、`I/F = π·r を返す。r` は

`(w/4π)·μ0e/(μ0e+μe)·[(1+B(g))P(g) + H(μ0e)H(μe) − 1]·S` で、多重散乱項 H は常に有効。

• `normals: float (H, W, 3)`、長さ 0 = 背景(出力 0)。単位化は内部で行う。

• `light / view: 面→光源、面→視点の方向(内部で単位化、ゼロ長は ValueError`)。

• `w: 単一散乱アルベド (0, 1]`。

• `g: Henyey-Greenstein の非対称パラメータ、(−1, 1)` の開区間。負で後方散乱。

• `B0 / h: 対向効果(opposition surge)の振幅と角幅。B0 > 0 なのに h == 0` は

`ValueError。B0 = 0` で対向効果なし。

• `roughness_deg`: 巨視的粗さ θ̄ を度で与える(内部で rad に変換)。0 で粗さ補正なし

(μ0e=μ0, μe=μ, S=1)。負・非有限は `ValueError`。

返り値は float64 `(H, W) の I/F で、[0,1]` に正規化しない(負値は 0 に切る)。

影(他の面による遮蔽)は含まないので、必要なら `cast_shadow / shadow_raycast` の

可視性マップを掛ける(`render_regolith は shadow_raycast` と組み合わせる)。

μ0 か μ が 0 以下の画素は 0。

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

• blender_interop — Blender との併用 — 形を作って fullseye で測る(軸・単位・正解データの罠)

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

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

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

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

• itokawa_regolith_hero — py -3.11 examples_3d/itokawa_regolith_hero.py

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

fuse_to_voxel · fit_poly_surface · eval_poly_surface · surface_form_error · background_flatten · polar_unwrap · fit_zernike · matcap_shade

같은 카테고리(`render`)

project_points · render_point_depth · render_volume_projection · render_shaded · ambient_occlusion · cast_shadow · phong_shade · matcap_shade

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

brdf_hapke — 3D render op

사용법