SmTIAS-LightSim

MiniTIAS（スマートフォン舌画像撮影装置）の照明均一性を実機制作前に検討するための光散乱シミュレーションツール． LED 配置・ディフューザー形状を仮想的に変えながら，MiniTIAS-Evaluation と同じ指標（CoV／3 ゾーン分析等）で均一性を定量評価できるようにする．

開発進捗

現在の進捗: フェーズ 7（実装）— Step 1〜7 完了，Step 8（基準設計キャリブレーション）進行中． Step 8 進捗: spp 校正（128→1024、ノイズ/物理差を切り分け）→ 反射率スイープ（0.75〜0.92、弱い二次レバーと判明）→ 手法訂正: シミュ linear と実測 sRGB を直接突合していた交絡を発見．標準 sRGB OETF 順方向適用＋実測 mean アンカーで見かけ差の 約 2/3 が符号化ドメイン不一致だったと判明．寄与順は OETF（最大）＞ ISP レンズシェーディング（残差主因候補）＞反射率（小）．残差 1.6〜1.9 倍は調整せず正直に保持．副次: max_depth=8 は勾配を過大評価（キャリブは depth≥12）．SPEC_03「キャリブレーション経過」参照．次のアクション: ① OETF 順方向適用を sm-evaluate へ正規実装（/implement、現状 throwaway スクリプト）．② 残差に LSC 順方向モデル（物理動機づけ低自由度形）を当てる．

実装済みモジュール:

src/sm_tias_lightsim/uniformity.py — Rec.709 輝度変換 + CoV/std/max-min（MiniTias-Evaluation コピー）
src/sm_tias_lightsim/evaluation/zones.py — 正規化楕円距離マップ + 3 ゾーン分類 + ゾーン別統計
src/sm_tias_lightsim/evaluation/radial.py — 20 ビン放射状輝度プロファイル
src/sm_tias_lightsim/evaluation/roi.py — image_pixel 型矩形 ROI 抽出（2D/3D 配列対応）
src/sm_tias_lightsim/evaluation/visualize.py — matplotlib 可視化（輝度マップ / ヒストグラム / 放射プロファイル / ゾーンマップ）．MiniTias-Evaluation 互換スタイル（hot cmap，zone_map は luminance 背景 + 境界線）
src/sm_tias_lightsim/scene/schema.py — Pydantic ベース YAML スキーマ + ローダ．SensorConfig は perspective / orthographic 両対応
src/sm_tias_lightsim/geometry/loader.py — STL 読込（trimesh）+ LoadedMesh データクラス
src/sm_tias_lightsim/geometry/transforms.py — mm⇄m 単位スケール変換
src/sm_tias_lightsim/scene/{lights,materials,sensors}.py — Mitsuba emitter / BSDF / sensor dict 変換（sensors は orthographic 対応）
scripts/select_white_board.py — 実測 PNG で白色板境界を OpenCV GUI で選択（Step 8 キャリブ用）
scripts/visualize_roi_3d.py — 評価板 STL に ROI を 3D 投影（PyVista，Step 8 キャリブ用）
src/sm_tias_lightsim/scene/builder.py — SceneConfig → Mitsuba scene dict（PLY 一時ファイル経由）
src/sm_tias_lightsim/render/runner.py — variant 管理 + mi.render 実行
src/sm_tias_lightsim/render/output.py — PNG / luminance.npy 出力
src/sm_tias_lightsim/cli/render.py — sm-render CLI（YAML → PNG / luminance.npy）
src/sm_tias_lightsim/cli/evaluate.py — sm-evaluate CLI（PNG / luminance.npy → metrics.csv + figures/）
src/sm_tias_lightsim/visualize/baker.py — 各 face 中心の直接照度ベイク（shadow ray + cosine + 距離減衰）
src/sm_tias_lightsim/visualize/viewer.py — PyVista 3D ビューア（メッシュ着色 + LED + センサ + 座標軸）
src/sm_tias_lightsim/cli/visualize.py — sm-visualize CLI（YAML → 3D 表示 / screenshot） ※ ステップ完了時にここを更新すること．