アーキテクチャ設計 (Architecture)

                         [Fusion 360]
                              ↓ STL export
    ┌─────────────────────────────────────────────────────────────┐
    │  configs/                                                  │
    │   ├── scene_baseline.yaml   (光源・材料・センサ・評価面定義) │
    │   └── meshes/                                              │
    │       └── *.stl                                            │
    └─────────────────────────────────────────────────────────────┘
                              ↓
    ┌─────────────── render ──────────────┐
    │  scene/builder  →  Mitsuba scene    │
    │  render/runner  →  mi.render(...)   │
    │  render/output  →  PNG / luminance  │
    └──────────────────────────────────────┘
                              ↓
                  output/<scene-id>/
                    ├── render.png
                    └── luminance.npy
                              ↓
    ┌─────────────── evaluate ────────────┐
    │  evaluation/roi      →  ROI抽出     │
    │  uniformity.py       →  CoV / std    │
    │  evaluation/zones    →  3ゾーン      │
    │  evaluation/radial   →  放射プロファ  │
    │  evaluation/visualize → 可視化PNG    │
    └──────────────────────────────────────┘
                              ↓
                  output/<scene-id>/
                    ├── metrics.csv
                    └── figures/
                        ├── luminance_map.png
                        ├── histogram.png
                        ├── radial_profile.png
                        └── zone_map.png

src/sm_tias_lightsim/
├── __init__.py
├── geometry/
│   ├── loader.py        # trimesh で STL 読込・三角形配列取得
│   ├── subdivide.py     # 三角形メッシュ均一分割（最大辺長以下に決定論的に分割）
│   └── transforms.py    # 単位変換 (mm→m)・座標系変換
├── scene/
│   ├── schema.py        # YAML スキーマ定義・バリデーション
│   ├── builder.py       # YAML → Mitsuba scene dict 変換の本体
│   ├── lights.py        # LED 光源 (point / area / spot) のシーン要素生成
│   ├── materials.py     # BSDF（拡散・誘電体・薄膜散乱等）の生成
│   ├── sensors.py       # カメラセンサ (perspective / orthographic) の生成
│   └── paths.py         # YAML からの相対メッシュパス（スイープ生成スクリプト用）
├── render/
│   ├── runner.py        # mi.set_variant（ensure_variant）+ mi.render の実行
│   ├── output.py        # HDR film → PNG / luminance.npy 出力
│   └── pipeline.py      # YAML → レンダ → 保存の一括処理（render_yaml．CLI とスイープの共通本体）
├── runtime/
│   ├── llvm_init.py     # LLVM JIT 初期化（DRJIT_LIBLLVM_PATH 自動探索・variant 経路ログ）
│   └── overrides.py     # 環境変数による実行時上書き（SM_RENDER_VARIANT / SM_DRJIT_THREADS）
├── remote/
│   ├── commands.py      # サーバで実行するシェルコマンドの組み立て（純関数）
│   ├── files.py         # push の送信ファイル選定・除外規則・prune 対象の算出
│   └── transfer.py      # tar over ssh の送受信（pull 展開の安全検査）
├── uniformity.py        # SmTIAS-Evaluation からコピー（Rec.709, CoV, max/min）
├── evaluation/
│   ├── roi.py           # 画像 ROI 抽出（image_pixel 型）
│   ├── zones.py         # 3 ゾーン分析（center / middle / periphery）
│   ├── radial.py        # 放射状プロファイル + 動径 min/max 比
│   ├── oetf.py          # sRGB OETF 順方向適用 + 露出アンカー（シミュ用）
│   ├── normalize.py     # linear mean anchor 正規化（OETF と排他）
│   ├── dng_loader.py    # DNG（RAW）読込（linear raw 取得，実測リファレンス用）
│   ├── shape_metrics.py # 形状指標（輝度重心 / 角度-放射分解 / PCA / SSIM / NCC）
│   ├── visualize.py     # matplotlib による可視化 PNG 出力
│   └── pipeline.py      # 画像 + 評価 YAML → 指標 dict + metrics.csv（+ figures/）の一括処理（evaluate_image）
├── visualize/
│   ├── baker.py         # 各 face 中心の照度ベイク（direct / path モード）
│   ├── projection.py    # orthographic センサ投影の純関数（評価板への輝度投影）
│   └── viewer.py        # PyVista による 3D インタラクティブビューア
└── cli/
    ├── render.py        # `sm-render` エントリポイント
    ├── evaluate.py      # `sm-evaluate` エントリポイント
    ├── visualize.py     # `sm-visualize` エントリポイント
    └── remote.py        # `sm-remote` エントリポイント（研究室サーバでの実行）

[project.scripts]
sm-render = "sm_tias_lightsim.cli.render:main"
sm-evaluate = "sm_tias_lightsim.cli.evaluate:main"
sm-visualize = "sm_tias_lightsim.cli.visualize:main"
sm-remote = "sm_tias_lightsim.cli.remote:main"

# シミュ実行
uv run sm-render --scene configs/scene_baseline.yaml --output output/baseline/

# 評価（シミュ画像）
uv run sm-evaluate --image output/baseline/render.png --config configs/eval_default.yaml --output output/baseline/

# 評価（実測画像）
uv run sm-evaluate --image data/whiteboard_real.png --config configs/eval_default.yaml --output output/real/

# 3D 照度ビューア（キャリブレーション中の調査ツール）
uv run sm-visualize --scene configs/scene_baseline.yaml                       # インタラクティブウィンドウを開く
uv run sm-visualize --scene configs/scene_baseline.yaml --screenshot vis.png  # PNG 保存のみ

# 研究室サーバ（既定 Newton）で回す．手元から送って tmux で実行し，結果を持ち帰る
uv run sm-remote push
uv run sm-remote run --name baseline --gpu 0 -- sm-render --scene configs/scene_baseline.yaml --output output/baseline/
uv run sm-remote pull baseline

SmTIAS-LightSim/
├── src/sm_tias_lightsim/   # 上述
├── configs/
│   ├── scene_baseline.yaml
│   ├── eval_default.yaml
│   └── meshes/             # STL ファイル群
├── output/                 # シミュ・評価結果（.gitignore 対象）
├── tests/
│   ├── test_geometry.py
│   ├── test_scene_builder.py
│   ├── test_uniformity.py
│   └── fixtures/
└── docs/