設定ファイル（v1）

設定ファイル（v1）#

v1では、DAQ・スキャン・テストの設定を1つのファイルで統一的に管理できます。

クイックスタート#

haniwers-v1 config init コマンドで設定テンプレートを自動生成

$ haniwers-v1 config init
# → hnw.toml が生成されます

または、 src/haniwers/v1/assets/config.toml をコピーして使用してください。

設定の優先順位#

設定は以下の順序で適用されます（上ほど優先度が高い）

  1. CLIオプション：haniwers-v1 daq --port /dev/ttyUSB0

  2. 環境変数：HANIWERS_DEVICE_PORT

  3. 設定ファイル：hnw.toml

  4. デフォルト値：コード内の設定

主要セクション#

[device] - 実際のOSECHI検出器#

[device]
label = "device"
port = "/dev/ttyUSB0"        # シリアルポート
baudrate = 115200            # ボーレート
timeout = 1.0                # タイムアウト（秒）

[mocker] - テスト用（ハードウェア不要）#

[mocker]
label = "mocker"
port = "/dev/null"
csv_path = ""                # CSVからデータを読み込む（空=ランダムデータ）
shuffle = false              # イベント順序をランダム化
speed = 1.0                  # 再生速度（1.0=等速、10.0=10倍速）
jitter = 0.0                 # タイミング揺らぎ（秒）
loop = true                  # CSVの終端に達したら最初に戻る

[sensors.ch1], [sensors.ch2], [sensors.ch3] - センサー設定#

[sensors.ch1]
id = 1
name = "ch1"
label = "top"
center = 300                 # 中心閾値
nsteps = 10                  # 中心から上下各10ステップ
step_size = 1                # 1ステップあたり1単位
threshold = "none"           # スキャン前は "none"、決定後は "280" など

重要

すべてのセンサーは同じ nsteps と step_size を使用する必要があります。センサーごとに異なるのは center（中心値）だけです。

[sampler] - データ処理（推奨）#

[sampler]
label = "sampler"
mode = "count_based"         # または "time_based"
stream_mode = true           # true=長期測定、false=スキャン用
workspace = "."              # 出力ディレクトリ
filename_prefix = "osechi_data"
filename_suffix = ".csv"
events_per_file = 1000       # ファイルあたりイベント数
number_of_files = 10000      # ファイル数上限
max_retry = 3                # リトライ回数（スキャン用）
duration = 10.0              # スキャン時の測定時間（秒）
suppress_threshold = 1000    # ノイズ抑制閾値

[daq] - DAQ設定（非推奨）#

[daq]
label = "daq"
workspace = "."
filename_prefix = "osechi_data"
filename_suffix = ".csv"
events_per_file = 1000
number_of_files = 10000
stream_mode = true

[scan] - スキャン設定（非推奨）#

[scan]
label = "scan"
workspace = "."
filename_prefix = "scan_data"
filename_suffix = ".csv"
events_per_file = 1000
number_of_files = 10000
duration = 10.0
stream_mode = false
suppress_threshold = 1000
max_retry = 3

使用例#

例1：実際のOSECHI検出器でデータ取得#

[device]
port = "/dev/ttyUSB0"

[sensors.ch1]
center = 300

[sensors.ch2]
center = 310

[sensors.ch3]
center = 320

[sampler]
mode = "count_based"
stream_mode = true
events_per_file = 1000

例2：モック機能でテスト（ハードウェア不要）#

[mocker]
csv_path = "data/sample.csv"  # サンプルCSVから再生
speed = 10.0                   # 10倍速で再生

[sampler]
mode = "count_based"
stream_mode = true

例3：閾値スキャン用#

[sampler]
mode = "count_based"
stream_mode = false            # スキャンモード
duration = 10.0                # 各ステップで10秒測定
max_retry = 3
suppress_threshold = 1000

注意点#

  • [daq] と [scan] は非推奨：将来のリリースで削除される予定です。新しい設定には [sampler] を使用してください。

  • センサー設定の統一：すべてのセンサーで nsteps と step_size は同じにする必要があります。

参照#

目次