Fork: 0
hasegawa / SmTIAS-LightSim
Download ZIP 70 commits
Transfer to URL with SHA
SmTIAS-LightSim / docs / 06_TEST /
latest commit fe550b326f
@rintoHasegawa rintoHasegawa authored on 2 Jun
..
README.md [add] docs/05_TECH と docs/06_TEST に README を追加して散らかり感を解消 — 15 ファイル (TECH 9 + TEST 6) がフラットに並んでいたため，性質分類と navigation を README で提供．docs/05_TECH/README.md (85 行): TECH を 🟢 現状方針 (TECH_07/08/09) と 🔵 議論の経緯 (TECH_01-06) に 2 分類．「主な結論 (読まずに済むサマリ)」表で LSC/ガンマ/スケール/配光/残差候補の現状方針を 1 表に集約．経緯マップ (ASCII 図) で TECH_01→04 と TECH_05→06 のハンドオフ往復を視覚化．新規 TECH 追加時のガイドも記載．docs/06_TEST/README.md (70 行): TEST を 🟡 キャリブ作業の中核 (TEST_01/02/03) と 🔵 クローズ済みの試行履歴 (TEST_04 速度最適化中断) と 📋 外部スナップショット (TEST_05/06 MiniTias-Evaluation 由来) に 3 分類．3 ファイルの使い分け表 (「何を知りたい→どのファイル」) を追加．外部スナップショットの取り込み経緯参照あり．ファイル削除・移動はせずナビゲーションのみ追加 (案 A: 過程記録の履歴的価値保持・リンク切れリスク回避)．関連ディレクトリ (04_SPEC / 06_TEST or 05_TECH) への相互参照も配置．新規ドキュメント追加時のガイド (連番継続・GUIDE_03 命名規則準拠) も含める 4 months ago
TEST_01_キャリブレーション検証履歴.md [update] S3 全体完結 — TEST_01 に Step 8-13 正式記録 + Step 8-N 候補を不採用扱いに更新 — TEST_01 §Step 8-13 を Step 8-12 と Step 8-N の間に新規追加: 新方針 (実機 DNG+LSC linear) でのシミュ突合を Step 8-1〜8-12 と同フォーマットで記録．計測結果: シミュ CoV=0.1826 / 勾配=24.65% / 中心-周辺=1.3271 / 動径 min/max=0.6151，実機ターゲット (CoV=0.0695 / 勾配=8.35% / 中心-周辺=1.0911 / 動径 min/max=0.860) と比較して残差 2.63× (TECH_06 で予想した 2.66× とほぼ一致)．背景・仮説・試した変更 (configs/eval_baseline_dng_target.yaml 作成)・期待効果・実際の結果・解釈 (LSC 由来ではなくシミュ物理モデル誤差が主因)・学び (ガンマ圧縮で 2 倍縮める / TEST_03 finding 4 の前提変更 / 過去 Step 8-1〜8-12 試行の意義)・次のアクション (Step 8-14 以降の物理モデル精緻化) を網羅．俯瞰サマリ表に新ターゲット (実測 TARGET 新 DNG+LSC linear: mean=207.82 / CoV=0.0695 / 勾配=8.35% / C/P=1.091) と Step 8-13 結果行を追加．過去 8-3 の 2.1× は PNG sRGB ガンマ圧縮による楽観値であり真の linear 比較では 2.63× が確定基準と明記．§Step 8-N 候補 (LSC 順方向モデル) のヘッダを「未着手」→「不採用 — Step 8-13 で方針確定」に更新し冒頭注記で経緯を歴史的記録として保持．handoff_smtias_lightsim/ ディレクトリは S3 完結のため整理: 参考スクリプト run_uniformity_dng.py のみ reference_measurement/quantitative/reference_scripts/ に移動 (MiniTias-Evaluation 側の正規評価実装 = LSC 順方向適用 + portrait 向き合わせ + ROI 抽出の参考．将来 SHADING_OFF フォールバック発動時の独立検証用)，他は全て SmTIAS-LightSim 側に取り込み済みのため削除．reference_measurement/ は gitignore 対象のため移動・削除自体は git に現れない．S3 全体 (S2 DNG ローダコピー + Step D radial_min_max 統合 + Step C' 新規 baseline config + TECH_07 LSC 方針 + TECH_08 対応マッピング + Step 8-13 計測 + handoff 整理) 完結．次のキャリブ作業は Step 8-14 以降の物理モデル精緻化 (反射率精度・LED 配光・メッシュ幾何) と TECH_04 フォールバック条件 C1 (SHADING_OFF 撮影) の並行検討．CLAUDE.md 進捗欄に S3 全体完結を追記 4 months ago
TEST_02_シミュレーション実行記録.md [add] Step 8-12: Helmholtz 相反原理を Mitsuba 上で実証検証 — schema.py の RenderConfig.integrator に ptracer 追加．configs/scene_baseline_perspective_{path,ptracer}.yaml で perspective sensor + scalar_rgb + spp=4096 比較．bot/top 比が path 2.035 vs ptracer 2.006 で誤差 1.4% で一致＝形は方向独立．絶対値は Mitsuba 実装の正規化差で 1.99× 違うが形（空間パターン）は同じ．副次発見: orthographic + ptracer は Mitsuba 3 で実行不能（Endpoint::sample_direction() 未実装）．方向変更で形を実機に近づける道は無いことが確定し LSC モデル化が唯一の道との結論を強化．TEST_01 Step 8-12・TEST_02 索引・TEST_03 学び 5・CLAUDE.md を更新 4 months ago
TEST_03_輝度マップ形状追跡.md [add] Step 8-12: Helmholtz 相反原理を Mitsuba 上で実証検証 — schema.py の RenderConfig.integrator に ptracer 追加．configs/scene_baseline_perspective_{path,ptracer}.yaml で perspective sensor + scalar_rgb + spp=4096 比較．bot/top 比が path 2.035 vs ptracer 2.006 で誤差 1.4% で一致＝形は方向独立．絶対値は Mitsuba 実装の正規化差で 1.99× 違うが形（空間パターン）は同じ．副次発見: orthographic + ptracer は Mitsuba 3 で実行不能（Endpoint::sample_direction() 未実装）．方向変更で形を実機に近づける道は無いことが確定し LSC モデル化が唯一の道との結論を強化．TEST_01 Step 8-12・TEST_02 索引・TEST_03 学び 5・CLAUDE.md を更新 4 months ago
TEST_04_シミュレーション速度最適化履歴.md [update] 速度最適化ワーク一旦中断 — TEST_04 末尾に中断記録セクション追加．中断時点の正直な評価: 実時間改善ゼロ（B1=508s／B2=56s で不変）．副次成果: DRJIT_LIBLLVM_PATH 消失でサイレントクラッシュしていた問題の発見と恒久対処，JIT 経路診断ログ機構，ベンチ条件ドキュメント，テスト 51 件追加．中断理由: B2 path bake samples=16 は現状ボトルネックではなく，B1 は GPU 無し・CPU 完結・精度据置の制約下で取れる打ち手が限定的．本筋のキャリブ作業（LSC モデル化）に戻ることがプロジェクト目的により近い．再開条件 4 項目を明示: (1) path bake samples を増やすユースケース発生 (2) NVIDIA GPU 利用可 (3) クラウド計算活用判断 (4) キャリブ反復回数増加でバッチ時間が研究進度を圧迫した場合．Speed-2 path bake wavefront 化テンプレートは TEST_04 内に未実施のまま保持し再開時に /implement で即着手可能．CLAUDE.md 開発進捗に中断補足を追記．次のアクション: キャリブ作業（LSC モデル化）に戻る 4 months ago
TEST_05_PNG_DNG評価比較.md [add] MiniTias-Evaluation 引き継ぎ受領 (S1) — TECH_06 受領記録・TEST_05 PNG/DNG 評価比較・TEST_06 外乱光影響評価を新規取り込み．TECH_05 §4 を訂正 (apply_lsc_inverse → apply_lsc_forward)．5 つの重要発見: (1) DNG は LSC 未補正で逆ではなく順方向適用が正しい (TECH_05 §4 訂正済) (2) 過去 Step 8 残差 2.1× はドメイン不一致 — 正しい linear 比較では DNG linear+LSC 0.0689 vs シミュ linear 0.183 = 真の残差 2.66× (3) 新実機ターゲット MiniTIAS_QM_20260601_124500 暗闇撮影 CoV=0.0695 勾配=8.35% 中心/周辺=1.0911 動径 min/max=0.860 (4) 外乱光ロバスト確認: 室内灯 ON/OFF で指標差 < 1% (5) 新指標 calc_radial_min_max_ratio 追加．本 PR はドキュメント取り込みのみ (S1)．コード取り込み (S2: dng_loader.py コピー + 新指標マージ + rawpy 依存追加) と sm-evaluate DNG 対応 + Step 8-13 突合 (S3) は別 /implement パイプラインで実施．handoff_smtias_lightsim ディレクトリは context から書き起こし: PNG/CSV/meta.json バイナリは S3 段階で再取得が必要．CLAUDE.md 開発進捗に Phase 1 完了とハンドオフ受領・5 つの重要発見を追記 4 months ago
TEST_06_外乱光影響評価.md [add] MiniTias-Evaluation 引き継ぎ受領 (S1) — TECH_06 受領記録・TEST_05 PNG/DNG 評価比較・TEST_06 外乱光影響評価を新規取り込み．TECH_05 §4 を訂正 (apply_lsc_inverse → apply_lsc_forward)．5 つの重要発見: (1) DNG は LSC 未補正で逆ではなく順方向適用が正しい (TECH_05 §4 訂正済) (2) 過去 Step 8 残差 2.1× はドメイン不一致 — 正しい linear 比較では DNG linear+LSC 0.0689 vs シミュ linear 0.183 = 真の残差 2.66× (3) 新実機ターゲット MiniTIAS_QM_20260601_124500 暗闇撮影 CoV=0.0695 勾配=8.35% 中心/周辺=1.0911 動径 min/max=0.860 (4) 外乱光ロバスト確認: 室内灯 ON/OFF で指標差 < 1% (5) 新指標 calc_radial_min_max_ratio 追加．本 PR はドキュメント取り込みのみ (S1)．コード取り込み (S2: dng_loader.py コピー + 新指標マージ + rawpy 依存追加) と sm-evaluate DNG 対応 + Step 8-13 突合 (S3) は別 /implement パイプラインで実施．handoff_smtias_lightsim ディレクトリは context から書き起こし: PNG/CSV/meta.json バイナリは S3 段階で再取得が必要．CLAUDE.md 開発進捗に Phase 1 完了とハンドオフ受領・5 つの重要発見を追記 4 months ago
README.md

06_TEST — テスト計画・品質保証 (Test & Quality Assurance Docs)

このディレクトリには 試行・検証の履歴と記録 が集まっている．SmTIAS-LightSim のキャリブレーション作業を中心に，過去の試行を時系列・観点別に追跡する．

種類分類

アイコン種類性質読み方
🟡キャリブ作業の中核（更新中）永続的，新規 Step ごとに追記「過去の試行と現状」を辿る主軸
🔵クローズ済みの試行履歴履歴的，原則更新しない「中断・完了した別軸の試行」を参照する
📋外部スナップショット取り込み済み，更新は元側で元プロジェクト (MiniTias-Evaluation) を参照

🟡 キャリブ作業の中核 — 3 ファイル

SmTIAS-LightSim のシミュ vs 実機キャリブレーションの 主軸記録．Step 8 系の試行を時系列・観点別に追跡する．

順序ファイル内容
1TEST_01_キャリブレーション検証履歴.mdStep 8-1〜8-13 + Step 8-N 候補の 時系列フル記録．各イテレーションの仮説／変更／結果／解釈／学び．新規 Step 追加時はここに追記
2TEST_02_シミュレーション実行記録.mdoutput/ 配下に蓄積された 実行結果ディレクトリの索引．「何の試行か・どう再現するか」を辿れる．output/ は gitignore 対象なので手元になくてもこのドキュメントで網羅
3TEST_03_輝度マップ形状追跡.md数値指標 (CoV / 勾配等) では捉えられない 「形そのもの」を画像比較．figures/luminance_map_evolution.png の比較パネルとセット．scripts/build_luminance_evolution_panel.py で生成

3 ファイルの使い分け

知りたいこと読むべきファイル
「過去どんな Step を試したか，何が判明したか」TEST_01
「output/baseline_spot/ って何のレンダ結果？」TEST_02
「シミュは形が実機と全然違うのか？」TEST_03（画像で一目）

🔵 クローズ済みの試行履歴 — 1 ファイル

ファイル状態内容
TEST_04_シミュレーション速度最適化履歴.md中断Speed-0 ベースライン計測・Speed-1 LLVM JIT 自動検出を完了．Speed-2 path bake wavefront 化はテンプレ保持．再開条件 4 項目を明記

→ 再開条件 (path bake samples を増やすユースケース発生 / NVIDIA GPU 利用可 / クラウド計算活用 / 反復回数増加) に該当した時のみ参照．

📋 外部スナップショット — 2 ファイル

MiniTias-Evaluation で作成された報告書を SmTIAS-LightSim 側にも取り込んだもの．原本は MiniTias-Evaluation 側にあり，バグ修正・追記は元側で行う．本リポジトリは「スナップショット」として保持．

ファイル元側内容
TEST_05_PNG_DNG評価比較.mdREPORT_02PNG sRGB 経路と DNG linear+LSC 経路の数値比較．ガンマ圧縮で CoV が約 2 倍縮まることを実証．真の linear 比較への移行根拠
TEST_06_外乱光影響評価.mdREPORT_03室内灯 ON/OFF で照明均一性指標がほぼ変わらない（差 1% 未満）ことを実証．SmTIAS の自前照明が支配的

取り込みの位置付け

外部スナップショットの取り込み経緯は TECH_06 MiniTias-Evaluation 引き継ぎ受領 に記載．原本リンクの一部は MiniTias-Evaluation リポジトリ起点で，SmTIAS-LightSim 側からは到達しない（リンク切れは許容と各ファイル冒頭に明記）．

関連ディレクトリ

ディレクトリ役割
05_TECH/結論集約 (TECH_07〜09) と過程記録 (TECH_01〜06)．キャリブ作業の 方針側 が集まる
04_SPEC/ユーザー視点の仕様書．特に SPEC_04 評価仕様 は TEST_01 と表裏
figures/TEST_03 等の比較パネル画像．scripts/build_luminance_evolution_panel.py で再生成可能

新規ドキュメント追加のガイド

新しい TEST ドキュメントを追加するときは：

  1. どのカテゴリか判断: 🟡 キャリブ中核 / 🔵 クローズ済み / 📋 外部スナップショット
  2. 連番を継続: TEST_07, TEST_08, ...
  3. 本 README に追記: 該当カテゴリのリストに 1 行追加
  4. 既存 TEST_01〜03 を どう更新するか も検討（特に新規 Step 追加時は TEST_01 が主軸）