環境構築手順 (Environment Setup)

前提条件 (Prerequisites)

• Python 3.11 以上がインストール済みであること
• Git がインストール済みであること
• GitHub CLI (gh) がインストール済みであること
• bash が使えること（Windows では Git for Windows 付属の Git Bash）．Claude Code のフック（.claude/settings.json）は bash .claude/hooks/run_python.sh 経由で Python を起動するため，Python と bash のどちらかが欠けるとリポジトリ外アクセス制限フックがファイル操作をすべてブロックする

日常の開発コマンド（テスト・lint・解析スクリプト）は ENV_04 を参照．

手順 (Steps)

リポジトリのクローン (Clone Repository)

git clone <repository-url>
cd SmTIAS-Evaluation

仮想環境の作成・有効化 (Create Virtual Environment)

python -m venv .venv

• Windows:

.venv\Scripts\activate

• macOS/Linux:

source .venv/bin/activate

依存パッケージのインストール (Install Dependencies)

pip install -r requirements.txt
pip install -r requirements-dev.txt

動作確認 (Verify Installation)

python -c "import cv2, numpy, scipy, pandas, matplotlib, streamlit, skimage, PIL, rawpy; print('OK')"

OK と表示されれば成功．

データディレクトリ (Data Directory)

画像データは data/ ディレクトリに配置する．このディレクトリは .gitignore で管理対象外としている．

data/
├── smtias/          # SmTIAS で撮影した画像
│   └── whiteboard/    # 白板画像
└── tias/              # TIAS で撮影した画像
    └── whiteboard/    # 白板画像

※ ディレクトリ構成は解析の進行に応じて拡張する．

出力ディレクトリ (Output Directory)

解析結果は output/ ディレクトリに出力される．このディレクトリも .gitignore で管理対象外としている．