diff --git "a/docs/04_SPEC/SPEC_02_\347\205\247\346\230\216\345\235\207\344\270\200\346\200\247\350\251\225\344\276\241\343\202\242\343\203\253\343\202\264\343\203\252\343\202\272\343\203\240.md" "b/docs/04_SPEC/SPEC_02_\347\205\247\346\230\216\345\235\207\344\270\200\346\200\247\350\251\225\344\276\241\343\202\242\343\203\253\343\202\264\343\203\252\343\202\272\343\203\240.md" index ecf6dc9..a9ac83f 100644 --- "a/docs/04_SPEC/SPEC_02_\347\205\247\346\230\216\345\235\207\344\270\200\346\200\247\350\251\225\344\276\241\343\202\242\343\203\253\343\202\264\343\203\252\343\202\272\343\203\240.md" +++ "b/docs/04_SPEC/SPEC_02_\347\205\247\346\230\216\345\235\207\344\270\200\346\200\247\350\251\225\344\276\241\343\202\242\343\203\253\343\202\264\343\203\252\343\202\272\343\203\240.md" @@ -74,6 +74,55 @@ 2. 座標は `config/roi_config.json` に保存 3. 同一画角の全画像に同じ ROI を適用(バッチ解析) +### 起動コマンド + +```bash +python scripts/select_roi.py --image data/minitias/whiteboard/<画像ファイル名>.png --config config/roi_config.json --roi minitias.whiteboard +``` + +OpenCV のウィンドウが開くので,マウスで矩形を選択して Enter で確定する.ESC でキャンセル. + +## バッチ解析 (Batch Analysis) + +`scripts/run_uniformity.py` で白板画像を一括解析する.ROI 設定済みであること. + +### 起動コマンド + +```bash +# ディレクトリ内の全画像を一括解析 +python scripts/run_uniformity.py --image data/minitias/whiteboard/ --config config/roi_config.json --roi minitias.whiteboard + +# 単一画像の解析 +python scripts/run_uniformity.py --image data/minitias/whiteboard/<画像ファイル名>.png --config config/roi_config.json --roi minitias.whiteboard +``` + +### 出力 + +- `output/results/summary_uniformity.csv` — 全画像の均一性指標一覧 +- `output/results/<画像名>_uniformity.json` — 各画像の詳細結果 +- `output/figures/<画像名>_luminance_map.png` — 輝度マップ +- `output/figures/<画像名>_histogram.png` — 輝度ヒストグラム + +## 結果の確認 (Result Viewer) + +Streamlit ベースのビューアで解析結果を確認できる. + +### 起動方法 + +```bash +.venv\Scripts\streamlit run scripts/viewer.py +``` + +### 前提条件 + +- `scripts/run_uniformity.py` でバッチ解析が完了していること +- `output/results/summary_uniformity.csv` および `output/figures/` に画像ファイルが存在すること + +### 機能 + +- **全体比較タブ**: 全画像の均一性指標テーブル・統計サマリー・指標の比較グラフ(2×2 棒グラフ) +- **個別画像タブ**: ドロップダウンまたは矢印ボタンで画像を切り替え,元画像(ROI オーバーレイ付き)・輝度マップ・ヒストグラムを横並びで確認 + ## キャリブレーション (Calibration) 照明均一性評価ではカラーキャリブレーションを行わない.輝度の相対的なばらつき(CoV 等)は画像内の比較であり,カメラの色特性のズレが全画素に等しく影響するため,指標の値に影響しない.