SmTIAS-LightSim

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

開発進捗

現在の進捗: フェーズ 7（実装）— Step 1〜6 完了． 次のアクション: /implement Step 7: 基準設計のキャリブレーション（PLAN_02 参照）

実装済みモジュール:

• 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 可視化（輝度マップ / ヒストグラム / 放射プロファイル / ゾーンマップ）
• src/sm_tias_lightsim/scene/schema.py — Pydantic ベース YAML スキーマ + ローダ
• 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 変換
• 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/） ※ ステップ完了時にここを更新すること．

必須ルール（コード実装時）

Git 運用（GUIDE_04 準拠）

• ブランチ名・コミットメッセージの書式は GUIDE_04 に従う
• コミットは /commit を使用する（push・PR 作成は /commit push）

エージェントチーム（GUIDE_05 準拠）

• 実装は /implement <タスク> で開始する（コーディング → テスト → リファクタリング → ドキュメント更新）
• Phase 1 後に人間が動作確認，Phase 2 でテスト失敗時のみ方針判断
• Phase 2 成功後は Phase 3 → Phase 4 まで自動で進む（Phase 4 で更新がある場合のみ確認）
• テスト・リファクタリングをスキップしない

手動確認が必要な作業（自分で完了させないこと）

以下は実装完了後にユーザーへ報告し，確認・実施を依頼すること．

• 外部サービスの設定（コンソール操作，セキュリティルール変更等）
• 実機・ブラウザでの動作確認
• ストアへのアップロード・リリース作業

ドキュメント

設計・規約に関する情報は docs/ にある． コードを書く前に関連するファイルを読むこと．

01_GUIDE（規約・ルール）

• プロジェクト立ち上げフロー: docs/01_GUIDE/GUIDE_01_プロジェクト立ち上げフロー.md
• ドキュメント作成規約: docs/01_GUIDE/GUIDE_02_ドキュメント作成ガイド.md
• ファイル命名規則: docs/01_GUIDE/GUIDE_03_ファイル命名規則.md
• Git 運用ルール: docs/01_GUIDE/GUIDE_04_Git運用ルール.md
• エージェント運用ルール: docs/01_GUIDE/GUIDE_05_エージェント運用ルール.md
• コーディング規約: docs/01_GUIDE/GUIDE_06_コーディング規約.md
• テスト方針: docs/01_GUIDE/GUIDE_08_テスト方針.md

02_ENV（環境）

• 技術スタック: docs/02_ENV/ENV_01_技術スタック.md
• 環境構築手順: docs/02_ENV/ENV_02_環境構築手順.md
• 管理者用環境構築手順: docs/02_ENV/ENV_03_管理者用環境構築手順.md

03_PLAN（計画）

• 要件定義書: docs/03_PLAN/PLAN_01_要件定義書.md
• 開発ステップ: docs/03_PLAN/PLAN_02_開発ステップ.md

04_SPEC（仕様・設計）

• アーキテクチャ設計: docs/04_SPEC/SPEC_01_アーキテクチャ設計.md
• シーン定義仕様: docs/04_SPEC/SPEC_02_シーン定義仕様.md

05_TECH（技術設計）

06_TEST（テスト）