.claude [update] テンプレート同期: 進捗記録の二段構成(CLAUDE.md / docs/PROGRESS.md)を導入 1 month ago
.vscode [add] VSCode 設定を追加し CLAUDE.md の進捗を更新 3 months ago
config [update] プロジェクト名・デバイス名を MiniTIAS から SmTIAS に全面改名 1 month ago
docs [update] リリースに向けたドキュメント整理 1 month ago
scripts [add] 比較図・クリーン動径出力スクリプトを追加 1 month ago
src [update] load_roi_config と DNG 輝度化パイプラインを src/ へ集約 1 month ago
tests [update] load_roi_config と DNG 輝度化パイプラインを src/ へ集約 1 month ago
.gitattributes [update] テンプレートリポジトリの変更を同期し GUIDE_10・GUIDE_11 を削除 2 months ago
.gitignore [update] テンプレートリポジトリの変更を同期し GUIDE_10・GUIDE_11 を削除 2 months ago
CLAUDE.md [update] リリースに向けたドキュメント整理 1 month ago
README.md [update] リリースに向けたドキュメント整理 1 month ago
pyproject.toml [update] バージョンを 1.0.0 に更新(初回リリース) 1 month ago
requirements-dev.txt [add] プロジェクト初期構成を追加 3 months ago
requirements.txt [add] DNG 読み込み I/F(dng_loader)と動径 min/max 比指標を追加 1 month ago
ruff.toml [add] プロジェクト初期構成を追加 3 months ago
README.md

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 を参照してください.