labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
ガイド
ビデオ
ウォークスルー
よくある質問
ニュースレターアーカイブ
ドキュメント
教室
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
ガイド
ビデオ
ウォークスルー
よくある質問
ニュースレターアーカイブ
ドキュメント
教室
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • ガイド
    • はじめに

      • タスクエディタ
      • 刺激提示
      • 反応の正確さ
      • オブジェクト
      • イベント
      • 変数
      • タスクウィザード
      • トライアルシステム
      • 研究デザイン
        • タスク
        • ブロック
        • セッション
        • グループ
    • 特集トピック

      • 実験デザイン
        • スタディの作成
        • データフレームパターン
      • ランダム化とバランス
      • 目の追尾
        • 眼球追跡タスクにおける刺激の提示
        • アイ・トラッキングのキャリブレーション設定の選び方
        • タスクでの視線追跡の設定
        • 視線データの記録とエクスポート
        • 形状を視線追跡の興味領域 (AOI) として使用する
        • 参加者のキャリブレーション体験
      • アンケート
      • デスクトップアプリ
      • サンプル研究
      • 参加者募集
      • APIアクセス
        • REST API
        • Webhook API
        • WebSocket API
      • その他のトピック

        • 正確な刺激タイミング
        • マルチユーザー研究
        • Labvancedにおけるヘッドトラッキング | ガイド
    • メインアプリタブ

      • 概要: メインタブ
      • ダッシュボード
      • 私の研究
      • 共有研究
      • 私のファイル
      • 実験ライブラリ
      • マイアカウント
      • ライセンスとサービス
    • 研究タブ

      • 概要: 研究特有のタブ
      • 研究デザイン
        • タスク
        • ブロック
        • セッション
        • グループ
      • タスクエディタ
        • タスクコントロール
        • 試行システム
        • キャンバスとページフレーム
        • オブジェクト
        • オブジェクトプロパティテーブル
        • 変数
        • システム変数テーブル
        • イベントシステム
        • テキストエディタの機能
        • タスクエディタにおけるアイ・トラッキングのオプション
        • タスクにおける頭追跡
        • マルチユーザー研究
      • 設定
      • 変数
      • メディア
      • テキストと翻訳
      • 開始と参加
      • 被験者管理
      • データビューとエクスポート
        • Dataview と変数 & タスクの選択 (古いバージョン)
        • 録音へのアクセス (古いバージョン)
  • 動画
    • 動画概要
    • Labvancedの始め方
    • タスクの作成
    • 要素動画
    • イベントと変数
    • 高度なトピック
  • ウォークスルー
    • イントロダクション
    • ストループタスク
    • 語彙的決定タスク
    • ポズナー注視キュータスク
    • 変化盲点フリッカーパラダイム
    • 眼球追跡サンプル研究
    • 幼児の眼球追跡研究
    • マウストラッキングによる注目捕捉研究
    • 迅速な系列視覚提示
    • ChatGPT研究
    • 眼球追跡デモ: SVGをAOIとして使用
    • マルチユーザーデモ: 参加者のカーソルを表示
    • ゲームパッド / ジョイスティックコントローラー - 基本セットアップ
    • EEG統合を伴うデスクトップアプリ研究
    • 被験者間のグループバランスと変数設定
  • FAQ
    • 機能
    • サポートポリシーとガイドライン
    • セキュリティとデータプライバシー
    • ライセンス
    • Labvancedの精度
    • プログラム利用とAPI
    • Labvancedのオフライン利用
    • トラブルシューティング
    • 研究作成に関する質問
  • ニュースレターアーカイブ
  • 文書
  • 教室

値選択メニュー

特定のイベントで作業をしていると、ペンアイコンが表示されることに気づくでしょう。これは値選択メニューと呼ばれ、その理由は記録されるべき値や追跡されるべき値の種類を選択して指示できるからです。これは実験設計や設定で必ず使用する非常に強力で重要なオプションです。

このペンアイコン/値選択メニューは、イベントシステムの特定のアクションに対して、下記に示すように、変数の設定/記録アクション、オブジェクトプロパティの設定アクション、要件(If...Then)アクションなど、さまざまな場所に表示されます。

Labvancedの値選択場所。

ペンアイコンをクリックすると、読み上げるか記入する値を指定するドロップダウンメニューが表示されます。ドロップダウンメニューは、常にトリガー特定の値オプションから始まり、その後、他の5つのカテゴリ(現在の時間、定数値、変数、フレーム/タスク/オプション、操作)に続きます。これらはいずれもそれぞれのオプションを持っています。 これらについては、以下で詳しく説明します。

Labvancedの値選択メニュー

上の画像は、マウストリガーを使用しているときの値選択メニューの外観を示しています。左側の最初のメニュー項目はトリガー特定のカテゴリから始まり、その後の他の5つのカテゴリ(現在の時間など)に移ります。

メニューオプション

以下の表はカテゴリとオプションについての詳細を説明しています:

カテゴリオプション説明
Trigger-specificイベントに対して以前に選択したトリガータイプによって異なります。イベントのために選択したトリガーに基づいて、値選択メニューの先頭に選択肢の特定のリストが表示されます。オプションと説明の完全なリストについては、トリガー特定の値のセクションを参照してください。
Current Time
  • UNIXタイムスタンプ
  • フレームの開始からの時間
時間値を測定および呼び出します。
Constant Value
  • 文字列
  • 数値
  • ブール値
  • カテゴリカル
  • 日付
  • 時間
  • 色
必要な変数のタイプに応じて、文字列や数値のような定数値を割り当てます。これらは時々Arithmeticのような他のオプションと組み合わせてカウンターを作成するために使用されます。
Variable
  • 変数を選択
  • 配列から値を選択
  • データフレームから値を選択
変数を指定または参照したり、配列またはデータフレームから値を選択したりします。
Frame / Task / Object
  • オブジェクトプロパティ
  • フレーム
  • 眼球追跡
  • デバイス
オブジェクトプロパティ、フレーム、(有効な場合の)眼球追跡、およびデバイス(画面のリフレッシュレート)に関連する値を取得します。
Operations
  • 算術
  • 文字列操作
  • 数学操作
変数に指定された変更を加えるために操作を使用します。例えば、変数の値を結合したり、文字列をすべて小文字に変換したり、数学的な操作を実行したりします。

現在の時間値

‘現在の時間’オプションを使用すると、時間に関する値を記録または参照できます。

使用可能なオプションは次のとおりです:

  • UNIXタイムスタンプ
  • フレームの開始からの時間

現在の時間: UNIXタイムスタンプ

この値は、ミリ秒単位のUNIX形式のタイムスタンプを取得します。

現在の時間: フレームの開始からの時間

この値は、フレームの開始から経過した時間を取得します。最も一般的には、これは反応時間に相当します。

定数値

必要な変数のタイプに応じて、文字列や数値のような定数値を割り当てます。これらは時々Arithmeticのような他のオプションと組み合わせてカウンターを作成するために使用されます。

使用可能なオプションは次のとおりです:

  • 文字列
  • 数値
  • ブール値
  • カテゴリカル
  • 日付
  • 時間
  • 色

定数: 文字列

文字列/テキスト値を割り当てます。

定数: 数値

数値/数字値を割り当てます。

定数: ブール値

真または偽の値を割り当てます。

定数: カテゴリカル

レベル値を割り当てます(主に因子用)。

定数: 日付

日付値を割り当てます。

定数: 時間

時間値を割り当てます。

定数: 色

色(16進文字列)値を割り当てます。

変数値

変数を指定または参照したり、配列またはデータフレームから値を選択したりします。使用可能なオプションは次のとおりです:

  • 変数を選択
  • 配列から値を選択
  • データフレームから値を選択

変数を選択

変数を選択して指し示します。

配列から値を選択

配列から値を選択します。

データフレームから値を選択

作成したデータフレームから値を選択します。

フレーム/タスク/オブジェクト値

オブジェクトプロパティ、フレーム、眼球追跡(有効な場合)、およびデバイス(画面のリフレッシュレート)に関連する値を取得します。

  • オブジェクトプロパティ
  • フレーム
  • 眼球追跡
  • デバイス

オブジェクトプロパティ

オブジェクトプロパティを読み取ります。

フレーム

フレーム値オプション説明
Last cached Mouse X Position参加者のマウスの最後のX座標値。
Last cached Mouse Y Position参加者のマウスの最後のY座標値。
Last cached Mouse [X,Y] Array参加者のマウスの最後の[X,Y]座標値を配列形式で。
Frame Nameフレームの名前。

眼球追跡

眼球追跡値オプション説明
Last cached Coordinate X参加者の視線の最後のX座標値。
Last cached Coordinate Y参加者の視線の最後のY座標値。
Last cached Coordinate [X,Y] Array参加者の視線の最後の[X,Y]座標値を配列形式で。
Last cached Coordinate + Time [X,Y,T] Array参加者の視線の最後の[X,Y]座標値に、カメラキャプチャT値を配列形式で追加したもの。

デバイス

  • リフレッシュレート: 参加者のデバイスのリフレッシュレート値。

操作

変数に指定された変更を加えるために操作を使用します。たとえば、変数の値を結合したり、文字列をすべて小文字に変換したり、数学的な操作を実行したりします。

使用可能なオプションは次のとおりです:

  • 算術
  • 文字列操作
  • 数学操作

算術

算術操作は、文字列を結合したりオブジェクトプロパティを変更したりするなど、さまざまな目的に役立ちます。

Labvancedの算術メニュー。

基本的に、算術操作は複数の値に対して操作を実行することを可能にします。

このオプションを選択すると、追加のペンアイコン(つまり、値選択メニュー)が表示され、加算のような操作のリストが表示されます。

Labvancedにおける算術オプションの位置。

値は次の5つの異なる操作を使用して操作できます:

  • (+) 加算
  • (-) 減算
  • (/) 除算
  • (*) 乗算
  • (%) 剰余

以下の例は、新しい文字列変数(緑のボタン内)'intermediateVar'を作成するために算術操作を利用する方法を示しています。

例: 算術演算を使用して新しい文字列変数を作成する。

新しい変数の値('intermediateVar')は、いくつかの算術演算と、以前に作成された変数('userChatName'と'chatInput')の組み合わせ、および定数文字列の値(セミコロン:や改行スペース<br>など)を使用して定義されます。このアクションは、複数のユーザーの研究で使用できるユーザーチャットの効果を作成します。

文字列操作

文字列操作オプション説明
To Lowercase文字列変数内のすべての文字を小文字に変換します。

→ 例: (AAABBB) は (aaabbb) に変換されます。
To Uppercase文字列変数内のすべての文字を大文字に変換します。

→ 例: (aaabbb) は (AAABBB) に変換されます。
To Link変数内の文字列を別のウィンドウで開くURLに変換します。
Remove Whitespaces文字列変数内の文字の間のスペースをすべて削除します。

→ 例: (aaa bbbb cccc) は (aaabbbbccc) に変換されます。
Trim Whitespaces文字列変数の先頭のスペースを削除します。

→ 例: ( aaabbbcccc) は (aaabbbcccc) に変換されます。
Replace Substring Regexp文字列値変数内の特定の文字を置き換えます。

→ 例: (aaabbbccc) は bbb を xxx に置き換え、値は (aaaxxxccc) に変換されます。

数学操作

スカラー値に数学的操作を実行します。

数学操作オプション説明
abs値の絶対数を返します。
sqrt値の平方根を返します。
round小数点以下0〜3桁に丸めた値を返します。
floor切り捨てた値を返します。
ceil切り上げた値を返します。
cosコサイン値を返します。
sinサイン値を返します。
tan正接値を返します。

トリガー特有の値

トリガー特有の値は、特定のイベント内で定義されたトリガーに関連付けられた値を指します。たとえば、イベントにマウストリガーを使用する場合、アクションが指定されている特定の領域(Set / Record VariableアクションやSet Object Propertyアクション)では、マウストリガー特有の値をvalue select menuで参照できます。

以下の例では、マウストリガー特有の値を使用して、Set / Record Variableアクションを使用してx値およびy値、[X,Y]配列を記録しています。

マウス特有のトリガー値がマウストラッキングをキャプチャする方法を示しています。

以下は、Labvancedで見つかるトリガー特有の値のすべてのタイプの表であり、各オプションの詳細な説明が続きます。

名前値オプション - 概要
Trigger (Mouse)
  • マウス X
  • マウス Y
  • マウス [X,Y] 配列
  • 刺激名
  • 刺激情報
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Keyboard)
  • キーのID
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Button Bar)
  • 刺激名
  • 刺激情報
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Enter On Input)
  • キーのID
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Scroll)
  • 刺激名
  • 刺激情報
  • スクロール位置 X
  • スクロール位置 Y
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Gamepad/ Joystick)
  • ゲームパッドデバイスID
  • 押されたキー (配列)
  • 押したまたは保持されたキー (配列)
  • 放されたキー (配列)
  • 軸 (配列)
  • ゲームパッドタイムスタンプ (ユニックス時間)
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Eyetracking Gaze)
  • 座標 X
  • 座標 Y
  • 座標 [X,Y] 配列
  • 刺激名
  • 刺激情報
  • カメラキャプチャ時間 T
  • 視線信頼度 C
  • 座標 + 時間 [X,Y, T] 配列
  • 座標 + 時間 + 信頼度 [X,Y, T,C] 配列
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Eyetracking Fixation)
  • 注視セントロイド X
  • 注視セントロイド Y
  • 注視の持続時間
  • 注視開始時間
  • 注視終了時間
  • 注視の分散
  • 刺激名
  • 刺激情報
  • [X,Y, Dur, Start, End, Disp]
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Head Tracking)
  • カメラキャプチャ時間 T
  • 頭の回転
  • 頭の傾き
  • 頭のロール
  • 頭の位置 [X,Y, T] 配列
  • 鼻の位置 [X,Y, T] 配列
  • 鼻のベクトル [X,Y, Z, T] 配列
  • トリガータイムスタンプ (ユニックス時間)
  • フレーム開始からのトリガー時間
Trigger (Emotion Detection)
  • 最大感情
  • 最大感情スコア
  • バレンススコア
  • 喚起スコア
  • カメラキャプチャ時間 T
  • [最大感情, スコア, T] 配列
  • [バレンス, 喚起, T] 配列
  • [すべての感情, T] 配列
  • [すべての感情, バレンス, 喚起, T] 配列
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (On Task Initialization)
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (On Frame Init)
  • 試行番号
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (on Frame Start)
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (On Frame End)
  • 総フレーム時間
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Variable Value Changed)
  • 変数の新しい値
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Media Object Trigger)
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Websocket Trigger)
  • メッセージ
  • データ
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (OpenAI Trigger)
  • チャットGPTの回答
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (Global Experiment Event)
  • 総フレーム時間
  • グローバルイベントの理由
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)
Trigger (User Leaves Experiment)
  • 残りの参加者数
  • トリガータイムスタンプ (ユニックス時間)
  • トリガー時間 (フレーム開始から)

トリガー(マウス)値

マウストリガーが使用される場合、特定のアクションを実行するときに呼び出すことができるトリガー特有の値は以下のとおりです:

利用可能なマウストリガー値オプション

トリガー(マウス)オプション説明
Mouse Xフレーム座標での現在のマウスX位置を返します。
Mouse Yフレーム座標での現在のマウスY位置を返します。
Mouse [X,Y] Array配列形式のマウス[X,Y]座標。
Stimulus Nameイベントをトリガーしたオブジェクトの名前(例:どの画像がクリックされたか)。
Stimulus Infoイベントをトリガーしたオブジェクトの刺激情報。
Trigger Timestamp (Unixtime)トリガーが発生した時刻のUnix時間形式のタイムスタンプ(ミリ秒含む)。
Trigger Time (From Frame Onset)フレーム開始からトリガーが発生するまでの経過時間(ミリ秒単位)。

トリガー (キーボード) 値

キーボードトリガーが使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

トリガー (キーボード) オプション説明
Id of Keyトリガーとして押されたキーのID値。
Trigger Timestamp (Unixtime)トリガーが発生した時刻のUnix Time形式のタイムスタンプ(ミリ秒付き)。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生するまでに経過した時間(ミリ秒)。

トリガー (ボタンバー) 値

ボタンクリックトリガーが使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

トリガー (ボタンバー) オプション説明
Stimulus Nameイベントをトリガーしたボタンオブジェクトの名前。
Stimulus Infoイベントをトリガーしたボタンオブジェクトの刺激情報。
Trigger Timestamp (Unixtime)トリガーが発生した時刻のUnix Time形式のタイムスタンプ(ミリ秒付き)。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生するまでに経過した時間(ミリ秒)。

トリガー (入力時のEnter) 値

入力時のEnterトリガーが使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

トリガー (入力時のEnter) オプション説明
Id of Keyトリガーとして押されたキーのID値。
Trigger Timestamp (Unixtime)トリガーが発生した時刻のUnix Time形式のタイムスタンプ(ミリ秒付き)。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生するまでに経過した時間(ミリ秒)。

トリガー (スクロール) 値

スクロールトリガーが使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

トリガー (スクロール) オプション説明
Stimulus Nameイベントをトリガーしたボタンオブジェクトの名前。
Stimulus Infoイベントをトリガーしたボタンオブジェクトの刺激情報。
Scroll Position Xイベントがトリガーされた時のマウスのX軸のスクロール位置。
Scroll Position Yイベントがトリガーされた時のマウスのY軸のスクロール位置。
Trigger Timestamp (Unixtime)スクロールトリガーが発生した時刻のUnix Time形式のタイムスタンプ(ミリ秒付き)。
Trigger Time (From Frame Onset)フレームの開始からスクロールトリガーが発生するまでに経過した時間(ミリ秒)。

トリガー (ゲームパッド/ジョイスティック) 値

[[ゲームパッド/ジョイスティックトリガー]]が使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

ゲームパッドトリガーメニューオプション

トリガー (ゲームパッド/ジョイスティック) オプション説明
Gamepad Device Id接続されたゲームパッドのIDまたは名前。
Pressed Keys (Array)押されたキー。
Pressed OR Hold Keys (Array)押されたまたは保持されたキー。
Released Keys (Array)放されたキー。
Axes (Array)軸の値。
Gamepad Timestamp (Unixtime)ゲームパッドのタイムスタンプ(Unix Time)。
Trigger Timestamp (Unixtime)トリガーが発生した時刻のUnix Timeのタイムスタンプ。
Trigger Time (From Frame Onset)フレームの開始に関連してトリガーが発生した時刻のUnix Timeのタイムスタンプ。

トリガー (視線追跡) 値

視線追跡トリガーが使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

視線トリガー値オプション

トリガー (視線追跡) オプション説明
Coordinate X視線のX座標の値。
Coordinate Y視線のY座標の値。
Coordinate [X,Y] Array配列形式の視線座標X,Y。
Stimulus Name視線トリガーを開始した刺激の名前。
Stimulus Info視線トリガーを開始した刺激の後ろにある刺激情報。
Camera Capture Time Tスナップショットが発生した正確な時間。Labvancedの視線追跡パイプラインでは、カメラスナップショットが最初に発生し、その後にアルゴリズムとニューラルネットワークが視線計算を行います。したがって、Camera Capture Time Tは、初回のスナップショットが発生した時刻のUNIXタイムスタンプです。私たちのウェブカメラベースの視線追跡の技術に関する詳細は、視線追跡技術ページを参照してください。
Gaze Confidence Cこの値は0から1の範囲で、画像スナップショットに開いている目があるという信頼性と確率を示し、基本的には「まばたき検出器」として機能します。詳細については、発表された査読付き論文を参照してください。
Coord. + Time [X,Y,T] Array視線のx/y座標と、上記のカメラキャプチャ時間(T)のタイムスタンプを含む配列。
Coord. + Time + Confidence [X,Y, T,C] Array視線のx/y座標と、上記のカメラキャプチャ時間(T)と視線の信頼度(C)を含む配列。
Trigger Timestamp (Unixtime)視線トリガーが発生した時刻のUnix Time形式のタイムスタンプ(ミリ秒付き)。
Trigger Time (From Frame Onset)フレームの開始から視線トリガーが発生するまでに経過した時間(ミリ秒)。

詳細を学ぶ: 眼球追跡を有効にし、視線データを記録し、実践的な例については、専用の視線追跡トリガーページをご覧ください。

トリガー(視線追跡固定) 値

視線追跡固定トリガーが使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

トリガー (視線追跡固定) オプション説明
Fixation Centroid X固定の中心点をX値として示す。
Fixation Centroid Y固定の中心点をY値として示す。
Fixation Duration検出された固定の持続時間。
Fixation Start Time検出された固定の開始時間。
Fixation End Time検出された固定の終了時間。
Fixation Dispersion検出された固定内での視線値の分散の程度を示す。
Stimulus Nameイベントをトリガーしたボタンオブジェクトの名前。
Stimulus Infoイベントをトリガーしたボタンオブジェクトの刺激情報。
[X, Y, Dur, Start, End, Disp]固定の重心のx-y値、固定の持続時間、開始時間、終了時間、および分散値を含む配列。
Trigger Timestamp (Unixtime)固定トリガーが発生した時刻のUnix Time形式のタイムスタンプ(ミリ秒付き)。
Trigger Time (From Frame Onset)フレームの開始から固定トリガーが発生するまでに経過した時間(ミリ秒)。

詳細を学ぶ: 固定検出を有効にし、固定データを記録し、実践的な例については、専用の視線追跡固定トリガーページをご覧ください。

トリガー (頭部追跡) 値

頭部追跡トリガーが使用されると、特定のアクションを実行する際に呼び出すことができる以下のトリガー固有の値があります:

トリガー (頭部 追跡) オプション説明
Camera Capture Time Tカメラがフレームをキャプチャした時刻、すなわちフレームキャプチャが発生したUnixタイムスタンプ。これは、どのような処理が行われる前に画像/フレームがキャプチャされた時間です。
Head Turn左から右への頭の回転、文献ではこれをヨーと呼びます。
Head Tilt上から下への頭の傾き、文献ではこれをピッチと呼びます。
Head Roll側面からの頭の回転の動きをキャプチャします。
Head Position [X,Y, T] Arrayこの配列は頭の位置に関連する数値をキャプチャし、中心のx-y座標とタイムスタンプ変数(T)を含みます。
Nose Position [X,Y, T] Arrayこの配列は特に鼻の位置に関連する数値をキャプチャし、鼻の位置のx-y座標と、測定が行われたときのタイムスタンプ変数(T)を含みます。
Nose Vector [X,Y, Z, T] Arrayこの計測は鼻の先端からベクトルを投影することによって行われ、参加者が画面に注目しているかどうかをテストするのに役立ちます(特に視線追跡が有効でない研究では重要です)。したがって、鼻が画面外を向くと(すなわち、参加者が実験に注目していない場合)、Z値は1から減少し、0に近づきます。
Trigger Timestamp (Unixtime)トリガーが発生した時間的点。これは、頭部追跡が検出され、トリガーがシステム内で発生したことを考慮します。本質的には、画像/フレームが処理される時間であり、この値は参加者のグラフィックスカードに大きく影響されます。理論的には、これはできるだけTの値に近いべきです。
Trigger Time from Frame Onsetフレームの開始時に関するトリガーが発生した時間値。

トリガー (感情検出) 値

感情検出トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (感情検出) オプション説明
Max Emotion検出された最大の感情。この文字列値には以下のパラメータが含まれます: angry, contempt, disgust, fear, happy, neutral, sad, surprise。
Max Emotion Score検出された Max Emotion のスコア。
Valence Scoreバレンス検出の数値スコア。
Arousal Score検出された覚醒の数値スコア。
Camera Capture Time T画像スナップショットが発生したときに基づく調整されたタイムスタンプ値。 注: これは Trigger Timestamp よりも感情検出が発生したときのより正確なタイムスタンプです。アルゴリズムはトリガーが開始された後に画像をキャプチャして処理するために数ミリ秒を必要とします。
[Max Emotion, Score, T] Array配列:最大感情(文字列ラベル)、スコア(数値)、カメラキャプチャT(ユニクスタイム)。
[Valence, Arousal, T] Array配列:バレンス(数値)、覚醒(数値)、カメラキャプチャT(ユニクスタイム)。
[All Emotions, T] Arrayすべての8つの感情とカメラキャプチャTのスコアを記録します。 注: 8つの感情スコアは互いに関連しており、合計は1になります。
[All Emotions, Valence, Arousal, T] Arrayすべての8つの感情、バレンス、覚醒、およびカメラキャプチャTのスコアを記録します。 注: 8つの感情スコアは互いに関連しており、合計は1になります。
Trigger Timestamp (Unixtime)ユニクスタイムでのトリガータイムスタンプ。より正確なタイミング値についてはCamera Capture Time Tを参照してください。
Trigger Time (From Frame Onset)フレーム発生からトリガーが発生するまでの時間(ミリ秒)。

トリガー (タスク初期化時) 値

タスク初期化トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (タスク初期化時) オプション説明
Trigger Timestamp (Unixtime)ミリ秒単位のトリガーのUnixタイムスタンプ。
Trigger Time (From Frame Onset)フレーム発生からトリガーが発生したときのミリ秒単位の時間。

トリガー (フレーム初期化時) 値

フレーム初期化トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (フレーム初期化時) オプション説明
TrialNrフレーム初期化トリガーが発生した時のトライアル番号。
Trigger Timestamp (Unixtime)ミリ秒単位のトリガーのUnixタイムスタンプ。
Trigger Time (From Frame Onset)フレーム発生からトリガーが発生した時のミリ秒単位の時間。

トリガー (フレーム開始時) 値

フレーム開始トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (フレーム開始時) オプション説明
Trigger Timestamp (Unixtime)ミリ秒単位のトリガーのUnixタイムスタンプ。
Trigger Time (From Frame Onset)フレーム発生からトリガーが発生した時のミリ秒単位の時間。

トリガー (フレーム終了時) 値

フレーム終了トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (フレーム終了時) オプション説明
Total Frame Timeフレームに費やされた合計時間(ミリ秒)。
Trigger Timestamp (Unixtime)ミリ秒単位のトリガーのUnixタイムスタンプ。
Trigger Time (From Frame Onset)フレーム発生からトリガーが発生した時のミリ秒単位の時間。

トリガー (変数値が変更された時) 値

変数値変更トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (変数値変更時) オプション説明
New Value in Variable変数の新しい値を参照します。
Trigger Timestamp (Unixtime)変数変更トリガーが発生したときのUnix Time形式のタイムスタンプ(ミリ秒単位)。
Trigger Time (From Frame Onset)フレーム発生の始まりから変数値変更が発生するまでの経過時間(ミリ秒単位)。

トリガー (メディアオブジェクトトリガー) 値

メディアオブジェクトトリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (メディアオブジェクトトリガー) オプション説明
Trigger Timestamp (Unixtime)メディアオブジェクトトリガーが発生したときのUnix Time形式のタイムスタンプ(ミリ秒単位)。
Trigger Time (From Frame Onset)フレーム発生の始まりからメディアオブジェクトトリガーが発生するまでの経過時間(ミリ秒単位)。

トリガー (Websocket トリガー) 値

WebSocket トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (Websocket トリガー) オプション説明
Message受信側が異なるデータ型をフィルターできるようにする説明およびラベルのメッセージ。
Data参加者の選択、タイムスタンプ、マウス x/y 座標など、異なるデータ型を保持できる値。
Trigger Timestamp (Unixtime)Websocket トリガーが発生したときのUnix Time形式のタイムスタンプ(ミリ秒単位)。
Trigger Time (From Frame Onset)フレーム発生の始まりからWebSocket トリガーが発生するまでの経過時間(ミリ秒単位)。

トリガー (OpenAI トリガー) 値

OpenAI トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (OpenAI トリガー) オプション説明
Chat GPT AnswerChatGPT からの回答の値。
Trigger Timestamp (Unixtime)OpenAI トリガーが発生したときのUnix Time形式のタイムスタンプ(ミリ秒単位)。
Trigger Time (From Frame Onset)フレーム発生の始まりからOpenAI トリガーが発生するまでの経過時間(ミリ秒単位)。

トリガー (グローバル実験イベント) 値

一時停止 / 実験再開トリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (グローバル実験イベント) オプション説明
Total Frame Timeトリガーの前に割り当てられた合計フレーム時間を参照します。
Reason for Global Eventトリガーの理由を示す文字列値(例:参加者が研究を離れた)。
Trigger Timestamp (Unixtime)グローバルイベントトリガーが発生したときのUnix Time形式のタイムスタンプ(ミリ秒単位)。
Trigger Time (From Frame Onset)フレーム発生の始まりからグローバルイベントトリガーが発生するまでの経過時間(ミリ秒単位)。

トリガー (ユーザーが実験を離れた時) 値

参加者がマルチユーザー研究を離れたトリガー が使用されると、特定のアクションを扱う際に呼び出すことができるトリガー固有の値は以下のとおりです:

トリガー (ユーザー が 実験を 離れた時) オプション説明
Remaining Number of Participants 研究に残っている参加者の数。
Trigger Timestamp (Unixtime)ユーザーが実験を離れた時に発生したトリガーのUnix Time形式のタイムスタンプ(ミリ秒単位)。
Trigger Time (From Frame Onset)フレーム発生の始まりからユーザーが実験を離れるトリガーが発生するまでの経過時間(ミリ秒単位)。