@rintoHasegawa rintoHasegawa authored 15 days ago
GitHub committed 15 days ago
.claude [fix] ruff check の既存違反 299 件を解消し依存更新の検証スイートに組み込む 15 days ago
.github [update] パッケージ管理を pip + venv から uv へ移行しバージョンを lock で固定 15 days ago
.vscode [add] VSCode 設定を追加し CLAUDE.md の進捗を更新 6 months ago
config [add] 白板撮影データ仕様(SPEC_04)・TIAS白板ROI・SmTIAS-TIAS比較スクリプトを追加 4 months ago
docs [fix] ruff check の既存違反 299 件を解消し依存更新の検証スイートに組み込む 15 days ago
scripts [fix] ruff check の既存違反 299 件を解消し依存更新の検証スイートに組み込む 15 days ago
src [fix] ruff check の既存違反 299 件を解消し依存更新の検証スイートに組み込む 15 days ago
tests [fix] ruff check の既存違反 299 件を解消し依存更新の検証スイートに組み込む 15 days ago
.gitattributes [update] テンプレートリポジトリの変更を同期し GUIDE_10・GUIDE_11 を削除 5 months ago
.gitignore [update] テンプレート最新版を同期し commands を skills へ移行・規約を .claude/rules へ再編 15 days ago
.python-version [update] パッケージ管理を pip + venv から uv へ移行しバージョンを lock で固定 15 days ago
CLAUDE.md [update] テンプレート新構成へ追従し規約の rules 化・開発コマンド整備・Dependabot 設定を追加 15 days ago
README.md [update] パッケージ管理を pip + venv から uv へ移行しバージョンを lock で固定 15 days ago
pyproject.toml [update] パッケージ管理を pip + venv から uv へ移行しバージョンを lock で固定 15 days ago
ruff.toml [fix] ruff check の既存違反 299 件を解消し依存更新の検証スイートに組み込む 15 days ago
uv.lock [update] パッケージ管理を pip + venv から uv へ移行しバージョンを lock で固定 15 days 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 ビューア

セットアップ

uv が必要です(Python 3.12 は uv が用意します).詳細は docs/02_ENV/ENV_02_環境構築手順.md を参照してください.

uv sync                         # uv.lock どおりに .venv を作成

画像データは data/,解析結果は output/ に置きます(どちらも .gitignore 対象).

使い方

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

# DNG(定量モード,LSC 補正あり)
uv run python scripts/run_uniformity_dng.py --image data/smtias/quantitative/xxx.dng

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

# 結果ビューア(Streamlit)
uv run 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)

テスト

uv run pytest

ドキュメント

設計・規約・評価報告は docs/ 以下にカテゴリ別で整理しています(全体の索引は CLAUDE.md).

  • 01_GUIDE/ — 規約・運用ルール(命名規則・Git 運用・コーディング規約・テスト方針 等)
  • 02_ENV/ — 技術スタック・環境構築手順
  • 03_PLAN/ — 要件定義・開発ステップ
  • 04_SPEC/ — アーキテクチャ設計・照明均一性評価アルゴリズム
  • 05_TECH/ — 技術設計(DNG 対応要求仕様)
  • 06_TEST/ — テスト・評価報告(照明均一性 / PNG・DNG 比較 / 外乱光影響)
  • PROGRESS.md — 開発進捗のフルログ