Newer
Older
SmTIAS-LightSim / docs / 06_TEST / 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 が主軸)