心拍数検出トリガー

概要

Labvancedの心拍数測定は、標準的なウェブカメラを使用して心拍数をリモートで推定する生理的追跡システムです—専門的なハードウェアは必要ありません。

このイベントリスナーは、心拍数検出の更新時にトリガーされます。このトリガーを選択すると、BPM、タイムスタンプ、および信頼スコアを測定できます。

Note: すべての処理はクライアント側で行われ、GDPRに準拠しているため、顔データが外部に送信または保存されることはありません。

Labvancedの感情検出トリガーメニュー。

イベントのトリガーメニューから心拍数検出トリガーを探す。

心拍数データの記録

トリガーを選択し、アクションに名前を付けると、心拍数検出のためのデータを記録する関連イベントを設定するように促すダイアログボックスが表示されます：

Labvancedで心拍数検出を記録する自動化されたイベントの作成。

選択した心拍数検出トリガーにより、心拍数関連の値を記録するイベントを設定するプロンプトが表示されます。Note: このイベントが記録するデータのプレビューについては、下のデータテーブル画像を参照してください。

このイベントを自動生成する結果、以下のアクションが作成されます（下の画像に示す通り）。変数名heartRate_心拍数検出が割り当てられ、データ収集中に記録する値としてトリガー特有の値[BPM,T,C]配列が示されています。

ここから、変数名はVariablesパネルを介してさらに編集でき、トリガー値も異なる値に再割り当てすることができます。トリガー特有の値のさらなるオプションについては、下記のValue-select Menuを参照してください。

Labvancedにおける感情検出のためのトリガーの自動イベント。

上記の画像で示されたステップにおいて、心拍数検出の結果を記録するために自動的に生成されたイベント。

Labvancedで収集された心拍数データのプレビュー

以下は、Labvancedのタスク内で上記のイベントがアクティブな結果として記録されたデータの一例です：

Labvancedで記録された心拍数検出データ

トリガー特有の値[BPM,T,C]を用いて収集されたデータのプレビュー。

心拍数検出の有効化

心拍数検出トリガーが機能するためには、関連設定をTask ControlsとSettingsの両方で有効化および起動する必要があります。以下に説明します。

研究設定 - 心拍数検出を有効にする

Settingsタブで、Physiology → Heart Rate Detectionに移動し、心拍数測定を研究内で有効にするためにチェックボックスにチェックを入れます。

Note: リモート心拍数検出(rPPG)は、時間にわたる加重平均を計算することによって機能し、初期化には10秒以上かかることがあるため、Settingsタブの下に設定があります Initialize RPPG on Study Startを有効にすることで、主要なタスクが開始される前にrPPG測定が準備完了であることを保証します（最初のタスクでRPPGを有効にした場合を除く）。さらに、Wait for heartrate confidenceという追加設定もあり、有効にすると、心拍数検出が指定の信頼レベルに達するまで研究が待機します。実験中に心拍数の信頼度が指定の閾値を下回った場合、研究も一時停止されます。これは心拍数データの信頼性を確保するために有効です。

タスク設定 - 心拍数検出を有効にする

Task EditorのTask Controlsセクションの下で、Physiological Signalsタブに移動し、心拍数検出を特定のタスクでアクティブにするためにチェックボックスをクリックします。

心拍数検出を有効にするためにチェックボックスをクリックすると、心拍数検出データ値を記録するイベントを作成するかどうか、記録を行うフレームを指定するように促すダイアログボックスが表示されます：

タスクコントロールを介して心拍数検出データを記録するイベントを作成する。

心拍数検出のためのデータ記録を自動生成することができ、データ記録が具体的に行われるフレームを指定することも可能です。

トリガー特有の値

心拍数検出トリガーを選択すると、Value-Select Menuで以下のオプションが利用可能です。

Labvancedの変数選択メニューを介してトリガー特有のメニューにアクセスする。

Value-select Menuを介して心拍数検出トリガーのトリガー特有の値にアクセスします。

値	説明
`BPM`	測定された心拍数を示す数値（1分間あたりの拍動数 BPM）。
`Camera Capture Time (T)`	心拍数検出計算を行うために必要な画像スナップショット（すなわちカメラキャプチャ）が行われた時点に基づく調整されたタイムスタンプ値。 Note: トリガータイムスタンプはトリガーが開始された時点の値ですが、アルゴリズムがローカルで画像フレームをキャプチャし、関連する心拍スコアを処理するには数ミリ秒かかります。したがって、`Camera Capture Time T`の値は、使用するためのより正確なタイムスタンプです。
`Confidence (0)`	測定された心拍数値の信頼度を示す0から1までの値。
`[BPM, T, C]`	心拍数（`BPM` - 1分間の拍動数）、カメラキャプチャ時刻（`T`）、および測定の信頼区間（`C`）の値を保持する配列です。このトリガー特有の値が選択された際に収集されるデータの感覚については、上記のデータ記録セクションの画像プレビューを参照してください。
`Trigger Timestamp (Unixtime)`	UNIXTIMEでのトリガータイムスタンプ。 Note: 感情検出が行われた際のより正確な値として、上記で説明したカメラキャプチャTの値を参照してください。
`Trigger Time (From Frame Onset)`	フレームの開始からトリガーが発生した時間（ミリ秒単位）。

心拍数検出トリガーを使用した実用例

リモート心拍数検出（rPPG）デモ

このデモでは、リモート心拍数検出がアクティブになります。関連する値（BPM、タイムスタンプ、及び測定の信頼区間）がリアルタイムで表示されます。

目次