このディレクトリには エンジニア向けの技術設計ドキュメント が集まっている．3 種類のドキュメントが混在するので，最初にこの README で位置付けを確認するのが効率的．
| アイコン | 種類 | 性質 | 読み方 |
|---|
| 🟢 | 現状方針（結論集約） | 永続的，変更時のみ更新 | 「今どうなっているか」を知りたい人はここから |
| 🔵 | 議論の経緯（過程記録） | 履歴的，原則更新しない | 「なぜそうなったか」を辿るためのドキュメント |
SmTIAS-LightSim プロジェクトの 現状の設計判断・取り扱い方針 をここに集約している．「今どうなっているか」を理解したい場合はこの 3 つから読む．
| 順序 | ファイル | 内容 |
|---|
| 1 | TECH_07_LSC取り扱い方針.md | 3 プロジェクト (SmTIAS / SmTIAS-Evaluation / SmTIAS-LightSim) での LSC 役割分担．シミュ側で LSC を扱わない物理的根拠．却下した代替案 3 つの理由 |
| 2 | TECH_08_実機変更とシミュ側対応.md | 実機側 8 項目変更に対するシミュ側 3 層 (シーン定義 / sm-render / sm-evaluate) の対応マッピング．タイプ I (本質構造同一) / タイプ II (許容している構造的差異) の分類 |
| 3 | TECH_09_LEDデータシート調査結果.md | OEM 元 HONGLITRONIC データシート発見と判明事項．配光は Lambertian と数値一致．Step 8-10/8-11 試行の事後評価．SPEC_03 訂正事項 |
| 4 | TECH_10_残差主因候補の網羅整理.md | Step 8-13 で確定した残差 2.63× の主因候補を 5 カテゴリ 18 項目で網羅整理．A1/A9/D1 の検証結果を反映．形改善の最有力は B1 幾何精度に集約．数値改善は A8 反射率 R=0.89 |
| 5 | TECH_11_形状指標の見直しと新指標導入.md | 現状 4 指標 (CoV/勾配/C/P/動径 min/max) は「形」を構造的に区別できない問題を整理し，新 5 指標 (輝度重心/角度半径分解/SSIM/NCC/PCA) の導入を仕様化．過去判断への遡及的注記．「数値の偽物の一致」を防ぐ評価方針 |
| 観点 | 結論 |
|---|
| LSC 補正 | 実機側 (SmTIAS-Evaluation) で順方向適用．シミュ側は扱わない (orthographic で構造的に等価) |
| ガンマ補正 | sm-evaluate で OETF off (実機 DNG が linear) |
| 絶対値スケール調整 | mean アンカー正規化で target_mean=207.82 に揃え |
| LED 配光モデル | area light Lambertian (cos θ) — データシート実測と数値一致 |
| 残差 2.63× の主因候補（優先順） | 形改善: 🥇 B1 筐体幾何精度 / 数値改善: 🥇 A8 反射率 R=0.89．A1/A9/D1 はすべて検証完了でクリア (詳細は TECH_10) |
| 評価指標の方針 | 数値 + 形 + 視覚 の 3 軸．数値 4 指標 (CoV/勾配/C/P/動径 min/max) は形を構造的に区別できないため形 5 指標 (重心/角度半径分解/SSIM/NCC/PCA) を併用 (詳細は TECH_11) |
SmTIAS 撮影アプリ + SmTIAS-Evaluation 解析ツールへの「要求 → 報告 → 回答 → 受領」のハンドオフ記録．読まなくても現状方針 (TECH_07〜09) は理解できるが，「なぜそういう判断になったか」を辿るときに参照する．
[SmTIAS 撮影アプリへの要求と回答]
TECH_01 (要求書) ────→ SmTIAS 実装
│ ↓
TECH_02 (引き継ぎ手順) TECH_03 (実装報告 + SHADING_MODE 相談)
│
↓
TECH_04 (回答書 + SHADING_MODE 判断)
│
↓
★ 結論集約 → TECH_07 LSC 取り扱い方針
[SmTIAS-Evaluation DNG 対応への要求と受領]
TECH_05 (要求書) ────→ SmTIAS-Evaluation 実装
│
↓
TECH_06 (引き継ぎ受領記録)
│
↓
★ 関連結論 → TECH_07 LSC 取り扱い方針
TECH_08 対応マッピング
新しい TECH ドキュメントを追加するときは：
- どのカテゴリか判断: 🟢 結論集約 / 🔵 過程記録
- 連番を継続: TECH_10, TECH_11, ...
- 本 README に追記: 該当カテゴリのリストに 1 行追加
- ファイル命名規則 に従う (../../.claude/rules/docs-naming.md)
