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

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

## 種類分類

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

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

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

| 順序 | ファイル | 内容 |
| --- | --- | --- |
| 1 | [TEST_01_キャリブレーション検証履歴.md](TEST_01_キャリブレーション検証履歴.md) | Step 8-1〜8-13 + Step 8-N 候補の **時系列フル記録**．各イテレーションの仮説／変更／結果／解釈／学び．新規 Step 追加時はここに追記 |
| 2 | [TEST_02_シミュレーション実行記録.md](TEST_02_シミュレーション実行記録.md) | `output/` 配下に蓄積された **実行結果ディレクトリの索引**．「何の試行か・どう再現するか」を辿れる．`output/` は gitignore 対象なので手元になくてもこのドキュメントで網羅 |
| 3 | [TEST_03_輝度マップ形状追跡.md](TEST_03_輝度マップ形状追跡.md) | 数値指標 (CoV / 勾配等) では捉えられない **「形そのもの」を画像比較**．`figures/luminance_map_evolution.png` の比較パネルとセット．`scripts/build_luminance_evolution_panel.py` で生成 |
| 4 | [TEST_07_LEDグループ別動作確認.md](TEST_07_LEDグループ別動作確認.md) | 下/右/左 LED 基板を **単独 ON にして方向性・対称性・線形性の sanity check**．シミュが 3 つの照明源を物理位置どおりにモデル化できているかの基礎健全性確認．Step 8 系キャリブの前提保証 |

### 4 ファイルの使い分け

| 知りたいこと | 読むべきファイル |
| --- | --- |
| 「過去どんな Step を試したか，何が判明したか」 | **TEST_01** |
| 「`output/baseline_spot/` って何のレンダ結果？」 | **TEST_02** |
| 「シミュは形が実機と全然違うのか？」 | **TEST_03**（画像で一目） |
| 「シミュは LED 3 基板を独立に扱えているのか？」 | **TEST_07**（sanity check） |

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

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

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

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

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

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

### 取り込みの位置付け

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

## 関連ディレクトリ

| ディレクトリ | 役割 |
| --- | --- |
| [05_TECH/](../05_TECH/) | 結論集約 (TECH_07〜09) と過程記録 (TECH_01〜06)．キャリブ作業の **方針側** が集まる |
| [04_SPEC/](../04_SPEC/) | ユーザー視点の仕様書．特に [SPEC_04 評価仕様](../04_SPEC/SPEC_04_評価仕様.md) は 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 が主軸）