# haniwers-v1

:::{note}

2025年5月から`haniwers-v1`の作成を開始しました。
ここは`v1`のコマンドを整理するためのページです。

:::

## 利用可能なコマンド

```console
$ haniwers-v1 config  # 設定管理
$ haniwers-v1 init    # プロジェクト初期化
$ haniwers-v1 scan    # 閾値スキャン
$ haniwers-v1 vth     # 閾値設定
$ haniwers-v1 daq     # データ取得
$ haniwers-v1 mock    # モックデータ取得（テスト用）
```

## mock コマンド（開発者向け）

`haniwers-v1 mock` コマンドは、実際のOSECHI検出器なしでデータ取得機能をテストするためのモック機能を提供します。

### 基本的な使い方

**CSVファイルからイベントを再生:**
```bash
$ haniwers-v1 mock --load-from data/recorded_data.csv --events 100
```

**ランダムな合成データを生成:**
```bash
$ haniwers-v1 mock --random --events 500
```

**高速再生（10倍速）:**
```bash
$ haniwers-v1 mock --load-from data/recorded_data.csv --speed 10.0
```

### 主なオプション

- `--load-from PATH`: CSVファイルからイベントを再生
- `--random`: ランダムな合成データを生成
- `--events N`: 取得するイベント数
- `--speed X`: 再生速度（0.1〜100.0、デフォルト: 1.0）
- `--shuffle`: イベント順序をランダム化
- `--seed N`: 乱数シード（再現性確保用）
- `--output-dir PATH`: 出力ディレクトリ（デフォルト: `sandbox/mock/`）
- `--prefix TEXT`: ファイル名プレフィックス（デフォルト: `mock_data`）

### 詳細情報

詳細な使い方や例については、[quickstart guide](../../specs/005-daq-sampler-mocker/quickstart.md) を参照してください。