# 環境構築手順 (Environment Setup)

## 前提条件 (Prerequisites)

- Python 3.11 以上がインストール済みであること
- Git がインストール済みであること
- GitHub CLI (`gh`) がインストール済みであること

## 手順 (Steps)

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

```bash
git clone <repository-url>
cd SmTIAS-Evaluation
```

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

```bash
python -m venv .venv
```

- Windows:

```bash
.venv\Scripts\activate
```

- macOS/Linux:

```bash
source .venv/bin/activate
```

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

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

### 動作確認 (Verify Installation)

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

`OK` と表示されれば成功．

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

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

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

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

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

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