
..
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	[add] TECH_10 残差主因候補の網羅整理と Step 8-14 候補 γ D1 ROI 整合検証 — 物理 ROI 差 < 1% でクリア，主因から除外	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

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

[add] TECH_10 残差主因候補の網羅整理と Step 8-14 候補 γ D1 ROI 整合検証 — 物理 ROI 差 < 1% でクリア，主因から除外

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

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

4 months ago

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

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

種類分類

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

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

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

順序	ファイル	内容
1	TEST_01_キャリブレーション検証履歴.md	Step 8-1〜8-13 + Step 8-N 候補の時系列フル記録．各イテレーションの仮説／変更／結果／解釈／学び．新規 Step 追加時はここに追記
2	TEST_02_シミュレーション実行記録.md	`output/` 配下に蓄積された実行結果ディレクトリの索引．「何の試行か・どう再現するか」を辿れる．`output/` は gitignore 対象なので手元になくてもこのドキュメントで網羅
3	TEST_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評価比較.md	REPORT_02	PNG sRGB 経路と DNG linear+LSC 経路の数値比較．ガンマ圧縮で CoV が約 2 倍縮まることを実証．真の linear 比較への移行根拠
TEST_06_外乱光影響評価.md	REPORT_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 ドキュメントを追加するときは：

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