RABET ユーザーガイド¶

対象読者: 本ガイドは、動物行動の動画をスコアリングし、結果を集計・解析し、評価者間の一致度を評価したい行動科学の研究者を想定している。デスクトップアプリケーションと CSV ファイルに関する基本的な知識のみを前提とする。

範囲: RABET 1.3.2 のすべての機能を網羅している。英語版は別ファイル USER_GUIDE.md として用意されている。

目次¶

はじめに
動画にアノテーションを付ける
複数の記録ファイルを解析する
データを可視化する
評価者間／評価者内の信頼性を評価する
プロジェクトモード
キーボードショートカット一覧
設定ファイルと永続化される設定
CSV ファイル形式
トラブルシューティング
ヘルプと引用

1. はじめに¶

1.1 RABET をダウンロードする¶

RABET は Zenodo を公式の配布元 としており、リリースごとに引用可能な永続 DOI が付与される。

Zenodo（公式）: https://doi.org/10.5281/zenodo.15313025 (コンセプト DOI — 常に最新版を指す)

Zenodo のレコードを開き、使用するプラットフォームに対応するアーカイブをダウンロードする。

プラットフォーム	アセット
Windows	`RABET-Windows-1.3.2.zip`
macOS (Apple Silicon)	`RABET-macOS-arm64-1.3.2.zip`
macOS (Intel)	`RABET-macOS-x86_64-1.3.2.zip`
Linux	`RABET-Linux-x86_64-1.3.2.tar.gz`

同じバイナリのミラーが GitHub Releases でも配布されている。どちらをダウンロードしても中身は同じである。

1.2 RABET を起動する¶

Windows¶

アーカイブ（RABET-Windows-1.3.2.zip）を任意の場所に展開する。デスクトップでも、専用の Tools\ フォルダでも構わない。
展開した RABET フォルダを開き、RABET.exe をダブルクリックする。ショートカットを使いたい場合は同梱の Launch RABET.bat でも構わない。
初回起動時に Windows SmartScreen が「PC が保護されました」と表示することがある。これは実行ファイルがコード署名されていないためである。 詳細情報 → 実行を選んで進める。

macOS¶

CPU アーキテクチャに合うアーカイブを展開する（Apple Silicon = M1/M2/M3/M4、Intel = 2020 年以前の Mac）。
展開した RABET.app を Applications フォルダへ移動する。
バンドルが署名されていないため、初回起動だけ右クリック → 開くで起動する。2 回目以降は通常通り起動できる。

Linux¶

tarball を展開する。

tar -xzf RABET-Linux-x86_64-1.3.2.tar.gz

展開したディレクトリに入り、次のコマンドで起動する。
```
./run_rabet.sh
```
アプリケーションメニューに RABET を登録する場合は、次を実行する。
```
./install_desktop_entry.sh
```

1.3 初回起動時に作成されるフォルダ¶

RABET は初回起動時に、OS のユーザーアプリケーションデータディレクトリ配下に 3 つのフォルダを作成する。

configs/ — アクションマップ、カスタムメトリクス、配色の JSON
logs/ — 実行ログ（rabet_<日付>.log）。トラブルシューティングに使用
projects/ — 新規プロジェクトのデフォルト保存先

具体的なパスは OS により異なる。

OS	場所
Windows	`%APPDATA%\RABET\`
macOS	`~/Library/Application Support/RABET/`
Linux	`~/.config/RABET/`

RABET は各ファイルダイアログで最後に使ったディレクトリも記憶し、次回以降そこを既定として開く。

1.4 メインウィンドウの構成¶

アプリケーションウィンドウは次のように構成されている。

┌──────────────────────────────────────────────────────────────────┐
│  File   Edit   View   Log   Help                                 │  ← メニューバー
├──────────────────────────────────────────────────────────────────┤
│  [Annotation] [Analysis] [Visualization] [Reliability] [Project] │  ← モードタブ
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│                  （アクティブなモードのメイン画面）                 │
│                                                                  │
├──────────────────────────────────────────────────────────────────┤
│  ステータスバー：簡易メッセージ、現在ファイル、録画状態               │
└──────────────────────────────────────────────────────────────────┘

モードタブ は RABET の 5 つの主要ワークフローに対応する。View メニューから、またはタブを直接クリックして、いつでも切り替えられる。アクティブなモードは強調表示される。

2. 動画にアノテーションを付ける¶

Annotation ビューは RABET の中核となる作業画面である。ビデオプレイヤー、タイムライン、録画操作パネル、アクションマップパネルがひとつの画面にまとまっている。

┌───────────────────────────────────────────────────────────────────┐
│                                                  │ アクションマップ │
│            ビデオプレイヤー（フレーム精度）         │ ┌────┬───────┐ │
│                                                  │ │キー│  行動  │ │
│                                                  │ ├────┼───────┤ │
│                                                  │ │ o  │Attack │ │
│                                                  │ │ j  │Side.  │ │
│                                                  │ │... │ ...   │ │
├──────────────────────────────────────────────────│ └────┴───────┘ │
│  録画操作 — 時間設定、Start / Pause / Stop        │ [Add][Edit]    │
├──────────────────────────────────────────────────────────────────┤
│  タイムライン — 色分けされたイベント、再生ヘッド                     │
└──────────────────────────────────────────────────────────────────┘

2.1 動画を開く¶

3 つの同等な方法がある。

メニュー: File → Open Video
最近開いた動画: File → Open Recent Video — 直近 10 件を一覧表示
ドラッグ&ドロップ: 動画ファイルを RABET ウィンドウの任意の場所にドラッグする。自動的に Annotation モードへ切り替わる。

標準的な拡張子（.mp4、.mov、.avi、.mkv、.webm、.m4v、.wmv、 .flv、.ts）は拡張子で受け付ける。録画ソフトが独自の拡張子（標準 MP4 コンテナに .video を付けるなど）を使っている場合でも、RABET はマジックナンバー判定と PyAV による試験的なオープンの 2 段階フォールバックを持っているため、ファイルの中身が有効な動画なら開ける。

オープン後は最初のフレームが表示され、再生ヘッドは 0 にリセットされる。

2.2 アクションマップ・パネル¶

アクションマップは キーボードの 1 キー を 行動ラベル に対応付ける。録画中は、マップされたキーを押すと行動イベントが開始し、同じキーを離すと終了する。

デフォルトのマッピング（configs/default_action_map.json から読み込み）:

キー	行動
`o`	Attack bites
`j`	Sideways threats
`p`	Tail rattles
`q`	Chasing
`a`	Social contact
`e`	Self-grooming
`t`	Locomotion
`r`	Rearing

Annotation ビューの右側にあるアクションマップ・パネルには、アクティブなマップが編集可能なテーブルとして表示される。テーブル下のボタンで次の操作ができる。

Add — 新しい「キー → 行動」マッピングを追加する。キー欄は英数字 1 文字を受け付ける。既存のマッピングを上書きするときは確認ダイアログが出る。
Edit — 選択した行の行動ラベルを変更する。
Remove — マッピングを削除する。既に記録済みのアノテーション は削除されない。

マップの保存・読み込み:

File → Save Action Map で現在のマップを .json ファイルに保存する。
File → Load Action Map で保存済みのマップを読み込む（現在のマップは置き換えられる）。
File → Reset Action Map to Default で組み込みデフォルトに戻す。

2.3 動画のコントロール¶

操作	ショートカット
再生 / 一時停止の切替	`Space`
指定ステップ分だけ進む	`→`（右矢印）
指定ステップ分だけ戻る	`←`（左矢印）

ステップ幅と再生レートは、ビデオフレーム下のコントロール帯で変更できる。ステップ幅のデフォルトは 1 フレームだが、一時停止中の粗い移動には 5 フレームや 10 フレームを使うのも便利である。

現在の再生位置はビデオ下に hh:mm:ss.ms 形式で表示される。録画セッション中は、同じ場所にセッション開始からの 相対時刻 も表示される。

2.4 記録セッションの設定¶

タイムライン上部の Recording controls パネルで、テスト時間を hh:mm:ss 形式の入力欄に入れる（例: 00:05:00 で 5 分間）。

Preserve on rewind（巻き戻し時にイベントを保持）チェックボックスがオンの場合、再生ヘッドが「まだ押されている最中」のイベントの開始時刻を逆方向に超えても、そのイベントは保持される。オフ（デフォルト）の場合は破棄される。「行動を数秒早くマークしすぎた」と気づいたときに便利である。

2.5 録画の状態遷移¶

        Start Recording                   Pause
   IDLE ─────────────────► WAITING ──► RECORDING ─► PAUSED
    ▲                                    ▲   │       │
    │                                    │   │ Resume│
    │                                    └───┴───────┘
    │                                    │
    │           Stop / 時間経過           │
    └────────────────────────────────────┘

Recording controls パネルの視覚的な手がかり:

状態	ボタン表示	状態色
アイドル	Start Recording（緑）	（無表示）
待機中	Cancel（グレー）	青
録画中	Pause（オレンジ）	赤
一時停止	Resume（緑）／Stop（赤）	オレンジ

録画の典型的な流れ:

動画を開いてテスト時間を設定する。
Start Recording をクリックする。状態が Waiting に変わる。
動画を再生する（Space）。再生ヘッドが動き始めた瞬間にセッションが開始（状態 → Recording）し、その時刻が全イベントの基準時刻となる。
行動キーを押してイベントを記録する。キーを離すとイベントが終了する。
途中で中断したいときは Pause を押す。再生も停止する。Resume で再開できる。
テスト時間が経過するか、Stop を押すとセッションが終了する。

セッションが終了すると動画も自動的に一時停止される。プロジェクト内から録画を開始していた場合は、自動保存のあと Project タブに自動で戻る。

2.6 タイムラインビュー¶

Annotation ビュー下部のタイムラインには、記録された全イベントが色分けされたバーで表示される。垂直線の再生ヘッドが動画と連動する。

主な操作:

ズームイン／ズームアウト — ズームボタン、またはタイムライン上でのマウスホイール
イベントを選択 — クリックする。選択がハイライトされ、開始時刻と終了時刻がステータスバーに表示される。
選択中のイベントを削除 — Delete または Backspace
最後に記録したイベントを取り消す — Edit → Undo Last Annotation または Ctrl + Z。RecordingStart の合成マーカーは取り消し対象から除外される。

タイムラインは再生中に再生ヘッドが画面内に収まるよう自動でスクロールする。

2.7 アノテーションを保存する¶

File → Export Annotations を選ぶと、次の 3 セクションから成る CSV ファイルを書き出す。

メタデータ — RABET バージョン、テスト時間
イベントログ — Event, Onset, Offset（秒、小数点以下 4 桁）
行動別サマリー — Behavior, Duration, Frequency

完全な仕様は CSV_FORMAT.md を参照のこと。

保存先に既にファイルがある場合、上書き確認ダイアログが出る。「いいえ」を選ぶとダイアログが再表示され、別の名前を選べる。RABET がデータを無断で消すことはない。

2.8 アノテーションを読み込む¶

File → Import Annotations で過去に書き出した CSV を読み込む。

File → Recent Annotations には直近 10 件のアノテーションファイルが並ぶ。

イベントが既にロードされている状態で別ファイルを読み込むと、確認ダイアログが表示され、確認後に既存のアノテーションがクリアされる。

3. 複数の記録ファイルを解析する¶

Analysis ビューは複数のアノテーション CSV をひとつの表に集計し、スクリプトを書かずに動物・条件・反復セッション間の比較ができる。

┌────────────────────────────────────────────────────────────────┐
│ [Load Files]  [Configure Metrics]   ✓ Enable interval (60 sec) │
├────────────────────────────────────────────────────────────────┤
│ ┌────────────────┬─────────────────────────────────────────┐  │
│ │   Summary      │  Intervals                              │  │
│ ├────────────────┴─────────────────────────────────────────┤  │
│ │ animal_id │ Attack Latency │ Total Aggression │ ...      │  │
│ │ rat-01    │ 18.43          │ 92.11            │ ...      │  │
│ │ rat-02    │ 25.92          │ 71.30            │ ...      │  │
│ │ ...                                                       │  │
│ └───────────────────────────────────────────────────────────┘  │
│ [Copy to Clipboard]  [Export CSV]  [Visualize Files]           │
└────────────────────────────────────────────────────────────────┘

3.1 CSV ファイルを読み込む¶

2 通りの方法がある。

Load Files ボタンから 1 つ以上の CSV を選択
ウィンドウに CSV をドラッグ&ドロップ

RABET は各ファイルをパースし、ファイル名のステム部分をデフォルトの animal_id として抽出する。続いて、現在のメトリクス設定に従って集計する。パースに失敗したファイルはログに警告が出力されてスキップされる。

3.2 Summary タブ¶

Summary タブには次の列が並ぶ（1 行 = 1 ファイル）。

animal_id
行動ごとに <行動> Duration と <行動> Frequency の 2 列ずつ
カスタムメトリクスの列（§3.4）

Duration はセッション全体での合計時間（秒）、Frequency はイベント回数である。

Copy to Clipboard で表全体をクリップボードにコピーする。Excel、JASP、 R、SPSS のいずれにも直接ペーストできる形式である。

3.3 Intervals タブ — 時間ビン解析¶

Enable interval analysis にチェックを入れると、各セッションを一定長の時間ウィンドウ（デフォルト 60 秒）に分割する。Intervals タブは (animal, interval) のペアごとに 1 行を表示する。

解釈の重要ポイント:

Duration は当該インターバルと 重なる秒数。2 つのインターバルに跨る行動は、それぞれに按分される。
Frequency は 開始時刻 がインターバル内に入る行動の数。複数のインターバルに跨る行動でも 1 回しかカウントされない。

このため、累積率プロットには Duration、イベント数の統計には Frequency が適している。

3.4 カスタムメトリクスの設定¶

Configure Metrics ボタンでメトリクスエディタを開く。2 種類のメトリクスを扱える。

Latency メトリクス（潜時）¶

セッション開始から、指定した行動の 最初の発生 までの秒数である。デフォルト設定では:

Attack Latency — 最初の Attack bites イベントまでの潜時

必要に応じて好きなだけ追加でき（例: Sideways threats Latency）、個別に有効／無効を切り替えられる。

Total-time メトリクス（合計時間）¶

指定した行動セットの Duration の合計である。デフォルト設定では:

Total Aggression — Attack bites + Sideways threats + Tail rattles
Chasing
Total Aggression (without tail-rattles) — Attack bites + Sideways threats + Chasing

各 Total-time メトリクスに含める行動は編集可能なので、研究に合った合計（例: Exploration = Locomotion + Rearing）を定義できる。

3.5 結果をエクスポートする¶

Copy to Clipboard はアクティブなタブを TSV（タブ区切り）形式でクリップボードに書き出す。スプレッドシートに直接ペースト可能である。
Export CSV は Summary 表を summary_table.csv として保存する。インターバル解析が有効な場合は summary_intervals.csv も一緒に書き出す。
Visualize Files は、現在読み込んでいるファイルを引き継いだまま Visualization タブへ切り替える。

4. データを可視化する¶

Visualization ビューはラスタープロットを描画する。1 行 = 1 動物／1 ファイル、1 ティック = 1 イベント、色は行動で分かれる。

4.1 ラスタープロットの基本¶

アノテーション CSV を読み込む（または Analysis から Visualize Files で来る）と、各ファイルが 1 つの横軸トラックになる。イベントは開始時刻の位置に色付きの縦バーで表示される。

複数ファイルを初めて読み込んだとき、見やすさのため デフォルトでは最初のファイルのみ が表示される。残りのファイルは右側のファイル一覧にチェックが入っていない状態で並ぶ。

4.2 フィルタリング¶

2 つのチェックボックス群で表示を制御する。

ファイル／個体 — 各動物トラックの表示／非表示
行動 — 各行動色の表示／非表示。色見本（スウォッチ）が行動ラベルの横に表示される。

サブセット（攻撃行動のみ、条件 A の動物のみ、など）に絞り込む際に、データを読み直す必要はない。

4.3 色をカスタマイズする¶

行動名横の色スウォッチをクリックするとカラーピッカーが開く。選択した色は即座に適用され、configs/custom_color_map.json に保存されるので、再起動後も維持される。

デフォルトの配色に戻すには、RABET を閉じてから custom_color_map.json を削除すればよい。

4.4 グリッドと軸範囲¶

垂直グリッド／水平グリッド — 個別にトグル
グリッド色 — グリッド色スウォッチをクリックして変更
Max range — 横軸の最大値（秒）を指定する。5 分セッションと 10 分セッションを並べて比較するとき、短い方が伸びてしまうのを防げる。

4.5 プロットを書き出す¶

Export で現在の表示を PNG／SVG／PDF で保存する。拡張子から自動判別される。拡張子を省いた場合は、ダイアログのフィルタで選んだ形式が適用される。

5. 評価者間／評価者内の信頼性を評価する¶

Reliability ビューは RABET 自身の出力から一致度メトリクスを計算する。 2 つのモードがあり、ビュー上部のモードバーから切り替える。

5.1 Reliability タブの役割¶

評価者間信頼性 — 2 人の評価者が同じ動画をコーディングし、両者の数値がどれくらい一致しているかを知りたい場合に使う。
評価者内信頼性 — 1 人の評価者が同じ動画を時間を空けて 2 回コーディングし、自分自身の一貫性を確かめたい場合に使う。

同じ Reliability タブで両方を扱える。RABET は 2 つの CSV が同じ評価者か違う評価者かを区別しない。

5.2 Summary モード¶

必要な入力。 Analysis ビューから書き出した summary_table.csv を 2 ファイル（評価者ごと、またはラウンドごとに 1 つずつ）。各行が 1 個体に対応し、animal_id で識別される。

手順。

Reliability ビューに切り替える（View → Reliability）。
Summary mode を選ぶ。
Load Summary CSV A で 1 つ目のファイルを読み込む。
Load Summary CSV B で 2 つ目のファイルを読み込む。
RABET は animal_id で 2 ファイルの動物を突き合わせ、メトリクス単位 で次を計算する。
ICC(2,1) — Two-way random, 単一測定の級内相関係数
Pearson r — 線形相関係数
平均絶対差 — 突合した動物に対する |A − B| の平均メトリクスごとの散布図も自動で描画される。

出力。 結果テーブルは Cicchetti (1994) のバンドで色分けされる。

ICC	解釈	色
≥ 0.75	優秀	緑
0.50 – 0.75	中〜良	橙
< 0.50	不良	赤

Export Results でテーブルを CSV として保存できる。

片方のファイルにしか登場しない動物は、テーブル下の Unmatched animals に列挙される。意図しないファイル間の不一致を見落とさないための表示である。

5.3 Detailed モード¶

必要な入力。 同じ動画 をコーディングした 2 つのアノテーション CSV。開始時刻と終了時刻が直接比較できる必要がある。

手順。

Reliability ビューで Detailed mode を選ぶ。
アノテーション CSV A と B を読み込む。
bin width（時間ビン幅、秒）を設定する。1 秒は瞬間的な行動コーディングでよく使われるデフォルト値である。
RABET は各アノテーション系列を「時間ビンごとの行動ベクトル」に変換し、両ファイルに現れる すべての行動 について次を計算する。
Cohen's κ — 偶然の一致を補正した一致度
Krippendorff's α — 名義尺度として計算したアルファ
生の一致率 — 両評価者が一致するビンの割合
ペアワイズ・イベントラスタが行動ごとに 2 段で重ね描きされ、不一致区間が一目でわかる。

κ は Landis & Koch (1977) のバンドで色分けされる。

κ	解釈	色
≥ 0.70	高い一致	緑
0.40 – 0.70	中程度	橙
< 0.40	不良	赤

Krippendorff's α も同じバンドを使う。

5.4 解釈の指針¶

色分けは スクリーニングの目安 であり、文脈に応じた判断の代替ではない。

Cicchetti の ICC バンド（不良／中／良／優秀の閾値 0.4 / 0.59 / 0.74）は臨床測定の文脈で提案されたものである。行動科学の慣例はおおむね近いが分野ごとに揺れがある。
Landis & Koch の κ バンドは広く引用されるが目安として提案されたものに過ぎない。密で変化の早い行動では、優秀な評価者でも 0.4–0.6 に落ち着くことがよくある。

期待より低い一致が出たときは、Detailed モードのラスタオーバーレイ で原因を素早く特定できる。多くは、一方の評価者が常に 1–2 秒遅れて開始しているといった一定のオフセット、または一方が細分化しているカテゴリの混同である。

5.5 R での再現性チェック¶

docs/reliability/compute_agreement.R は Summary モードの統計量（ICC(2,1) は psych::ICC、Pearson r は cor、平均絶対差）を再現する独立した R スクリプトである。サニティチェックや、RABET の一致度値を R の解析パイプラインへ組み込む用途に使える。

source("docs/reliability/compute_agreement.R")
compute_agreement("rater_a_summary.csv", "rater_b_summary.csv")

6. プロジェクトモード¶

RABET の プロジェクト は、関連するアセットをひとまとめにするディレクトリ + 小さなマニフェストファイルの組み合わせである。

スコアリング対象の動画
スコアリング結果の アノテーション CSV
スコアリングに用いた アクションマップ
保存した 解析結果（サマリーテーブル、インターバルテーブル等）

実験に多数の動画があり、進捗を 1 か所で把握したいときに便利である。

6.1 新規プロジェクトの作成¶

View → Project で Project モードに切り替える。
New Project をクリックする。
親ディレクトリ、プロジェクト名、（任意の）説明文を入力する。

RABET はプロジェクト用サブディレクトリと空のマニフェストファイルを作成する。Project ビューには（まだ空の）ツリーが表示される。

6.2 ファイルを追加する¶

Add Video、Add Annotation、Add Action Map、Add Analysis の各ボタンでファイルピッカーが開く。

確認ダイアログで プロジェクトディレクトリにコピー するか（再現性が高くなり、プロジェクトが自己完結する）、参照のみ （ファイルは元の場所に残す）を選べる。
何度でも追加できる。マニフェストは追加のたびに自動保存される。

6.3 プロジェクト内からアノテーションを付ける¶

ツリー内の動画を選んで Annotate をクリックする。RABET は次を行う。

Annotation ビューに切り替え
選んだ動画を読み込み
アノテーションをプロジェクトディレクトリ内のファイルに保存

セッションが終わると Project ビューへ自動で戻り、新しいアノテーションがツリーに表示される。

アノテーションのファイル名は人間が読める形式（例: rat-01_2026-05-21_001.csv）になっている。

6.4 プロジェクトの保存と再オープン¶

保存は暗黙的に行われる。Add / Remove / Annotate のたびにマニフェストが書き直される。
Open Project でプロジェクトディレクトリを指定する。
Close Project はメモリ上のプロジェクト状態をクリアし、Project ビューを開始画面に戻す。

プロジェクトを開いた状態で、そのプロジェクトのアノテーションパスと衝突するような動画を別途読み込もうとすると、RABET は警告を出してプロジェクトのアノテーションパスが無断で再利用されることを防ぐ。

7. キーボードショートカット一覧¶

Help → Show Shortcuts（F1）で現在のショートカットダイアログを開くと、組み込みショートカットと現在の行動キーマップが表示される。参考として、組み込み のショートカットは次の通りである。

ショートカット	動作
`Space`	動画の再生／一時停止を切替
`→`	設定したステップ幅だけ前進
`←`	設定したステップ幅だけ後退
`Ctrl + Z`	直前に記録したアノテーションを取り消し
`Delete` または `Backspace`	選択中のタイムラインイベントを削除
`F1`	ショートカット一覧ダイアログを開く
（マップされた任意のキー）	録画中に対応する行動を記録

行動キーはアクションマップから取得される。マップ自体はアクションマップ・パネルで編集できる（§2.2 参照）。

8. 設定ファイルと永続化される設定¶

8.1 ユーザーデータの保存場所¶

OS	パス
Windows	`%APPDATA%\RABET\`
macOS	`~/Library/Application Support/RABET/`
Linux	`~/.config/RABET/`

このルートディレクトリ配下に次のファイルが配置される。

configs/default_action_map.json — 組み込みデフォルト（初回起動後は変更されない）
configs/user_action_map.json — 編集中のアクションマップ。起動時に読み込まれるのはこちら
configs/default_metrics.json — 潜時／合計時間メトリクスの設定
configs/custom_color_map.json — 行動別のラスタープロット用色設定
logs/rabet_<日付>.log — 実行ログ

8.2 永続化される UI 設定¶

ウィンドウの位置とサイズ、最後に開いたビュー、テスト時間、ステップ幅、再生レート、Preserve on rewind フラグ、インターバル解析の設定、最近開いたファイル一覧、各ファイルダイアログの直近ディレクトリは、起動間で保持される。

8.3 デフォルトに戻す¶

手早くリセットしたい場合:

アクションマップ: File → Reset Action Map to Default
カスタム色: configs/custom_color_map.json を削除
すべて: RABET を終了し、上記の RABET アプリケーションデータフォルダ全体を削除

9. CSV ファイル形式¶

RABET は 3 種類の CSV を書き出す。

アノテーション CSV — Annotation ビューから File → Export Annotations で出力。メタデータ、イベントログ、行動別サマリーの 3 セクション。
サマリー CSV（summary_table.csv）— Analysis ビューから出力。 1 行 = 1 動物。カスタムメトリクス列を含む。
インターバルサマリー CSV（summary_intervals.csv）— Analysis ビューでインターバル解析が有効なときに出力。1 行 = 1 (動物, インターバル) ペア。

3 種類とも RABET Version メタデータを含み、下流ツールがどのバージョンの RABET が書き出したかを判別できる。時刻は秒単位、小数点以下 4 桁、文字コードは UTF-8 である。

完全な仕様と最小限の pandas パーサーは CSV_FORMAT.md を参照のこと。

10. トラブルシューティング¶

「VLC では再生できるのに、RABET では開けない」¶

RABET 1.3.2 は次のいずれかを満たすファイルを受け付ける。

拡張子がホワイトリストに入っている
ファイルの先頭バイトが既知の動画コンテナと一致する（filetype ライブラリで判定）
PyAV が試験的なオープンに成功する

3 段階すべてに失敗した場合のみエラーを出す。最後の手段として FFmpeg で変換してみるとよい。

ffmpeg -i input.unknown -c copy output.mp4

「Reliability タブの数値が空白／None になる」¶

Reliability タブは pingouin、scipy、statsmodels、krippendorff に依存する。配布版バイナリにはこれらが同梱されている。ソースから動かす場合は次でインストールする。

pip install pingouin krippendorff

logs/rabet_<日付>.log にこれらに関する ImportError が出ている場合は配布版から欠落している可能性があるので、ログを添付してイシューを作成してほしい。

「巻き戻したらイベントが消えた」¶

デフォルトでは、再生ヘッドが「まだ押されている最中」のイベントの開始位置を逆方向に超えると、その途中イベントは破棄される。Recording controls パネルの Preserve on rewind にチェックを入れると保持されるようになる。

「macOS の初回起動時にフォント警告が出る」¶

macOS では起動時のフォントスキャンで一部のシステムフォントが読み込めない旨が表示されることがある。実用上は無害である。matplotlib の他のフォントデータベースは正常に読み込まれ、RABET のウィジェットは Qt のデフォルトフォントを使う。

ログファイルの場所¶

Log → View Logs でログディレクトリが OS のファイルマネージャで開く。最新のファイルは rabet_<本日>.log である。30 日より古いログを一括削除したい場合は Log → Clean Up Logs を使う。

11. ヘルプと引用¶

ヘルプとバグ報告¶

Issues: https://github.com/mi2e-K/RABET/issues
問題を報告する際は、アプリケーションのバージョン（Help → About）と該当する logs/ のログファイルを添付してほしい。

RABET の引用¶

機械可読な引用情報は CITATION.cff に格納されている。人間が読む形式では次のように引用する。

Mitsui, K. (2026). RABET — Real-time Animal Behavior Event Tagger (Version 1.3.2). https://github.com/mi2e-K/RABET doi:10.5281/zenodo.15313025

上の DOI は コンセプト DOI で、常に Zenodo 上の最新リリースに解決される。各個別リリースにはそれぞれ独自のバージョン固有 DOI も付与される。

RABET を解説する tool paper を準備中である。公開後は、Zenodo のデポジットに加えて（もしくは代わりに）論文の引用も併用してほしい。