SmTIAS-Evaluation

SmTIAS（定量撮影モード）の白板画像から 照明均一性 を評価するツール群です． PNG / DNG(RAW_SENSOR) を入力に，各種均一性指標の算出と可視化を行います．

主な機能

均一性指標: CoV・max/min 比・平均/標準偏差
空間解析: 中心/中間/周辺ゾーンの輝度勾配，中心周辺比，動径輝度プロファイル，動径 min/max 比
再現性: 位置合わせ付き SSIM による画像間再現性評価
DNG 対応: RAW_SENSOR DNG を linear で読み込み，meta.json の lscMap によるレンズシェーディング補正を順適用
可視化: 輝度マップ・ヒストグラム・動径プロファイル・ゾーンマップ，Streamlit ビューア

セットアップ

Python 3.11 以上が必要です．詳細は docs/02_ENV/ENV_02_環境構築手順.md を参照してください．

python -m venv .venv
.venv\Scripts\activate          # Windows（macOS/Linux は source .venv/bin/activate）
pip install -r requirements.txt
pip install -r requirements-dev.txt

画像データは data/，解析結果は output/ に置きます（どちらも .gitignore 対象）．

使い方

# PNG（白板画像 1 枚 / ディレクトリ一括）
python scripts/run_uniformity.py --image data/smtias/whiteboard/xxx.png
python scripts/run_uniformity.py --image data/smtias/whiteboard/

# DNG（定量モード，LSC 補正あり）
python scripts/run_uniformity_dng.py --image data/smtias/quantitative/xxx.dng

# ROI 選択（対話的に矩形を選び config/roi_config.json へ保存）
python scripts/select_roi.py --image data/smtias/whiteboard/xxx.png

# 結果ビューア（Streamlit）
streamlit run scripts/viewer.py

ROI は config/roi_config.json のキー（既定 smtias.whiteboard）で指定します．

プロジェクト構成

src/
├── config.py            # ROI 設定の読み込み
├── io/                  # 画像 I/O（PNG / DNG）と DNG 輝度化パイプライン
├── analysis/            # 均一性・空間解析・位置合わせ・再現性
├── export/              # CSV 出力・バッチ集計
└── visualization/       # matplotlib による各種プロット
scripts/                 # 解析ランナー・ビューア・比較図生成
tests/                   # pytest
docs/                    # 規約・設計・報告書（索引は CLAUDE.md）

テスト

python -m pytest

ドキュメント

規約・設計・報告書は docs/ 以下にあります．全体の索引は CLAUDE.md を参照してください．