値選択メニュー
特定のイベントで作業を行うと、ペンのアイコンが表示されます。これは「値選択メニュー」と呼ばれ、記録すべき値や追跡すべき値の種類を選択し指示することができるためです。これは、実験デザインとセットアップに必ず使用する非常に強力なオプションです。
このペンのアイコン/値選択メニューは、"Set / Record Variable" アクション、"Set Object Property" アクション、および要件 (If... Then) アクションなど、イベントシステムの特定のアクションのさまざまな場所で表示されます。
ペンのアイコンをクリックすると、読み取るべきまたは書き込むべき値を指定するドロップダウンメニューが表示されます。**ドロップダウンメニューは常に、トリガー特有の値オプションを最初にリストし、その後、他の5つのカテゴリ（現在の時刻、定数値、変数、フレーム/タスク/オプション、操作）に続きます。これらはそれぞれ独自のオプションを持っています。**これらは以下でさらに詳しく説明されます。
上の画像は、マウストリガーが使用されているときの値選択メニューの外観を示しています。ご覧のとおり、左側の最初のメニュー項目は、トリガー特有のカテゴリから始まり、他の5つのカテゴリ（現在の時刻など）に移行します。
メニューオプション
下の表は、カテゴリとオプションについてさらに説明しています：
| カテゴリ | オプション | 説明 |
|---|---|---|
トリガー特有 | イベントのために以前に選択したトリガーのタイプに依存します。 | あなたがイベントのために選択したトリガーに基づいて、値選択メニューの上部に選択できる特定のオプションのリストが表示されます。オプションと説明の完全なリストについては、トリガー特有の値のセクションを参照してください。 |
現在の時刻 | 時間の値を測定し呼び出します。 | |
定数値 |
| 文字列や数値のような必要な変数の種類に基づいて定数値を割り当てます。これらは、カウンターを作成するために、算術などの他のオプションと組み合わせて使用されることがあります。 |
変数 |
| 変数を指定または参照するか、配列またはデータフレームから値を選択します。 |
フレーム / タスク / オブジェクト |
| オブジェクトプロパティ、フレーム、アイストラッキング（有効になっている場合）、およびデバイス（画面のリフレッシュレート）に関連する値を取得することができます。 |
操作 |
| 操作を使用して、変数の値を結合したり、文字列を小文字に変換したり、数学的操作を実行したりするなど、指定された変更を行います。 |
現在の時間の値
「現在の時間」オプションを使用すると、時間に関する値を記録または参照することができます。
以下のオプションが利用可能です：
現在の時間: UNIXタイムスタンプ
この値は、ミリ秒単位のUNIX形式のタイムスタンプをキャプチャします。
現在の時間: フレーム開始からの時間
この値は、フレームの開始から経過した時間をキャプチャします。多くの場合、これは反応時間に相当します。
定数値
必要な変数の種類に基づいて定数値を割り当てます。これらは、算術のような他のオプションと組み合わせてカウンターを作成するために使用されることがあります。
以下のオプションが利用可能です：
定数: 文字列
文字列/テキスト値を割り当てます。
定数: 数値
数値/数字値を割り当てます。
定数: ブール値
真または偽の値を割り当てます。
定数: カテゴリカル
レベル値（主に要因用）を割り当てます。
定数: 日付
日付値を割り当てます。
定数: 時間
時間値を割り当てます。
定数: 色
色（16進数文字列）値を割り当てます。
変数の値
変数を指定または参照するか、配列またはデータフレームから値を選択します。 以下のオプションが利用可能です：
変数を選択
変数を選択して指し示すことを可能にします。
配列から値を選択
配列から値を選択することを可能にします。
データフレームから値を選択
作成したデータフレームから値を選択することを可能にします。
フレーム / タスク / オブジェクトの値
オブジェクトプロパティ、フレーム、アイストラッキング（有効になっている場合）、およびデバイス（画面のリフレッシュレート）に関連する値を取得することができます。
オブジェクトプロパティ
オブジェクトプロパティを読み取ります。
フレーム
| フレーム値オプション | 説明 |
|---|---|
最後にキャッシュしたマウスX位置 | 参加者のマウスの最後のX座標値。 |
最後にキャッシュしたマウスY位置 | 参加者のマウスの最後のY座標値。 |
最後にキャッシュしたマウス[X,Y]配列 | 参加者のマウスの最後の[X,Y]座標値を配列形式で。 |
フレーム名 | フレームの名前。 |
アイストラッキング
| アイストラッキング値オプション | 説明 |
|---|---|
最後にキャッシュした座標X | 参加者の視線の最後のX座標値。 |
最後にキャッシュした座標Y | 参加者の視線の最後のY座標値。 |
最後にキャッシュした座標[X,Y]配列 | 参加者の視線の最後の[X,Y]座標値を配列形式で。 |
最後にキャッシュした座標+時間[X,Y,T]配列 | 参加者の視線の最後の[X,Y]座標値と、カメラキャプチャT値を含む配列形式。 |
デバイス
- リフレッシュレート: 参加者のデバイスのリフレッシュレート値。
操作
操作を使用して、変数の値を結合したり、文字列を小文字に変換したり、数学的操作を実行するなどの指定された変更を行います。
以下のオプションが利用可能です：
算術
算術演算は、文字列を結合したり、オブジェクトのプロパティを修正したりするなど、さまざまな目的に役立ちます。
本質的に、算術操作は複数の値に対して操作を実行できるようにします。
このオプションを選択すると、追加のペンアイコン（つまり、値選択メニュー）が表示され、加算などの操作のリストが表示されます。
値は、以下の5つの異なる操作を使用して操作できます：
- (+) 加算
- (-) 減算
- (/) 除算
- (*) 乗算
- (%) 割り算
以下の例は、算術操作を使用して「intermediateVar」と呼ばれる新しい文字列変数を作成する方法を示しています。
新しい変数値（「intermediateVar」）は、いくつかの算術操作を使用して、既に作成された変数（「userChatName」と「chatInput」）の組み合わせと、定数文字列値、すなわちセミコロン : と改行 <br>を使用して定義されます。このアクションは、複数のユーザー研究で使用できるユーザーのチャットの効果を生み出します。
文字列操作
| 文字列操作オプション | 説明 |
|---|---|
小文字に変換 | 文字列変数内のすべての文字を小文字に変換します。 → 例: (AAABBB)が(aaabbb)に変換されます。 |
大文字に変換 | 文字列変数内のすべての文字を大文字に変換します。 → 例: (aaabbb)が(AAABBB)に変換されます。 |
リンクに変換 | 変数内の文字列を別のウィンドウで開くURLに変換します。 |
空白を削除 | 文字列変数内の文字間のすべてのスペースを削除します。 → 例: (aaa bbbb cccc)が(aaabbbbccc)に変換されます。 |
空白をトリム | 文字列変数の最初にあるスペースを削除します。 → 例: ( aaabbbcccc)が(aaabbbcccc)に変換されます。 |
部分文字列を置換（正規表現） | 文字列値変数内の特定の文字を置き換えます。 → 例: (aaabbbccc)が_bbb_を_xxx_に置き換え、値が(aaaxxxccc)に変換されます。 |
数学操作
スカラ値に数学操作を実行します。
| 数学操作オプション | 説明 |
|---|---|
abs | 値の絶対数を返します。 |
sqrt | 値の平方根を返します。 |
round | 0から3の小数点以下の桁数で丸められた値を返します。 |
floor | 床値を返します。 |
ceil | 天井値を返します。 |
cos | コサイン値を返します。 |
sin | サイン値を返します。 |
tan | タンジェント値を返します。 |
トリガー特有の値
トリガー特有の値は、特定のイベント内に定義されたトリガーに関連する値を指します。たとえば、イベントにマウストリガーを使用している場合、指定されたアクションが実行される特定の領域（たとえば、Set / Record VariableアクションやSet Object Propertyアクションを使用する場合）で、マウストリガー特有の値を値選択メニュー内で参照できます。
以下の例では、マウストリガー用のトリガー特有の値を使用して、xおよびy値と[X,Y]配列をSet / Record Variableアクションを使って記録しています。
以下は、Labvancedで見つけることができるすべてのトリガー特有の値の種類の表であり、各オプションについての詳細な説明が続きます。
| 名称 | 値オプション概要 |
|---|---|
トリガー (マウス) |
|
トリガー (キーボード) |
|
トリガー (ボタンバー) |
|
トリガー (入力でエンター) |
|
トリガー (スクロール) |
|
トリガー (ゲームパッド/ジョイスティック) |
|
トリガー (アイストラッキング視線) |
|
トリガー (アイストラッキング注視) |
|
トリガー (頭部追跡) |
|
トリガー (タスク初期化時) |
|
トリガー (フレーム初期化時) |
|
トリガー (フレーム開始時) |
|
トリガー (フレーム終了時) |
|
トリガー (変数値が変更されました) |
|
トリガー (メディアオブジェクトトリガー) |
|
トリガー (WebSocketトリガー) |
|
トリガー (OpenAIトリガー) |
|
トリガー (グローバル実験イベント) |
|
トリガー (ユーザーが実験から離れました) |
|
トリガー (マウス) の値
マウストリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (マウス) オプション | 説明 |
|---|---|
マウスX | 現在のマウスX位置をフレーム座標で返します。 |
マウスY | 現在のマウスY位置をフレーム座標で返します。 |
マウス[X,Y]配列 | マウスの[X,Y]座標を配列形式で提供します。 |
刺激名 | イベントを引き起こしたオブジェクトの名前（例: クリックされた画像）。 |
刺激情報 | イベントを引き起こしたオブジェクトの刺激情報。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー (キーボード) の値
キーボードトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (キーボード) オプション | 説明 |
|---|---|
キーのID | トリガーとして押されたキーのID値。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー (ボタンバー) の値
ボタンクリックトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (ボタンバー) オプション | 説明 |
|---|---|
刺激名 | イベントを引き起こしたボタンオブジェクトの名前。 |
刺激情報 | イベントを引き起こしたボタンオブジェクトの刺激情報。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー (入力でエンター) の値
エンター入力トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (入力でエンター) オプション | 説明 |
|---|---|
キーのID | トリガーとして押されたキーのID値。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー (スクロール) の値
スクロールトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (スクロール) オプション | 説明 |
|---|---|
刺激名 | イベントを引き起こしたボタンオブジェクトの名前。 |
刺激情報 | イベントを引き起こしたボタンオブジェクトの刺激情報。 |
スクロール位置X | イベントがトリガーされたときのマウスのXスクロール位置。 |
スクロール位置Y | イベントがトリガーされたときのマウスのYスクロール位置。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー (ゲームパッド/ジョイスティック) の値
ゲームパッド/ジョイスティックトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (ゲームパッド/ジョイスティック) オプション | 説明 |
|---|---|
ゲームパッドデバイスID | 接続されたゲームパッドのIDまたは名前。 |
押下キー（配列） | 押下されたキー。 |
押下または保持キー（配列） | 押下または保持されているキー。 |
解放キー（配列） | 解放されたキー。 |
軸（配列） | 軸の値。 |
ゲームパッドタイムスタンプ（ユニックスタイム） | ユニックスタイムでのゲームパッドタイムスタンプ。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーが発生した時点のユニックスタイムでのタイムスタンプ。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からのユニックスタイムでのタイムスタンプ。 |
トリガー (アイストラッキング視線) の値
アイストラッキング視線トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (アイストラッキング視線) オプション | 説明 |
|---|---|
座標X | 視線のX座標の値。 |
座標Y | 視線のY座標の値。 |
座標[X,Y]配列 | 視線のX,Y座標を配列形式で提供します。 |
刺激名 | 視線トリガーを引き起こした刺激の名前。 |
刺激情報 | 視線トリガーを引き起こした刺激に対する刺激情報。 |
カメラキャプチャ時間T | スナップショットが行われた正確な時間。Labvancedのアイストラッキングパイプラインでは、アルゴリズムとニューラルネットワークが視線計算を行う前にカメラスナップショットが最初に発生します。したがって、カメラキャプチャ時間Tは初期スナップショットが行われたときのUNIXタイムスタンプです。さらに詳しい情報については、アイストラッキング技術ページを参照してください。 |
視線の信頼度C | この値は0から1の範囲で、画像スナップショットに開いた目がある確率を示します。これは本質的に「まばたき検出器」として機能します。さらに詳しい情報については、発表された査読済み論文を参照してください。 |
座標+時間[X,Y,T]配列 | 視線のx/y座標と先述のカメラキャプチャ時間（T）のタイムスタンプを含む配列。 |
座標+時間+信頼度[X,Y, T,C]配列 | 視線のx/y座標、カメラキャプチャ時間（T）、および視線の信頼度（C）を含む配列。 |
トリガータイムスタンプ（ユニックスタイム） | 視線トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー（アイストラッキング注視）値
アイストラッキング注視トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (アイストラッキング注視) オプション | 説明 |
|---|---|
注視重心X | 注視の中心点のX値。 |
注視重心Y | 注視の中心点のY値。 |
注視持続時間 | 検出された注視の持続時間。 |
注視開始時間 | 検出された注視の開始時間。 |
注視終了時間 | 検出された注視の終了時間。 |
注視散布 | 検出された注視内の視線値の散布度を指す。 |
刺激名 | イベントを引き起こしたボタンオブジェクトの名前。 |
刺激情報 | イベントを引き起こしたボタンオブジェクトの刺激情報。 |
[X, Y, Dur, Start, End, Disp] | 注視の重心のx-y値、注視の持続時間、開始時間、終了時間、散布値の配列。 |
トリガータイムスタンプ（ユニックスタイム） | 注視トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | 注視トリガーが発生した際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー (頭部追跡) の値
頭部追跡トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (頭部 追跡) オプション | 説明 |
|---|---|
カメラキャプチャ時間T | カメラがフレームをキャプチャした時間のUNIXタイムスタンプ。 |
頭の回転 | 左から右への頭の回転で、文献では「ヨー」と呼ばれます。 |
頭の傾き | 上から下への頭の傾きで、文献では「ピッチ」と呼ばれます。 |
頭のロール | 頭が左右に転がる動きをキャプチャします。 |
頭位置[X,Y, T]配列 | 頭位置に関連する数値（中心のx-y座標）とタイムスタンプ（T）。 |
鼻位置[X,Y, T]配列 | 鼻の位置に関連する数値（鼻のx-y座標など）とタイムスタンプ（T）をキャプチャします。 |
鼻ベクトル[X,Y, Z, T]配列 | 鼻先からベクトルを投影することで、参加者が画面に注目しているかどうかをテストするのに役立ちます（アイストラッキングが有効になっていない研究において特に重要です）。したがって、鼻が画面外を指すと（参加者が実験に集中していない場合）、Z値は1から0に近づきます。 |
トリガータイムスタンプ（ユニックスタイム） | 頭部追跡が検出されたときにトリガーが発生した時間。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からの時間。 |
トリガー (タスク初期化時) の値
タスク初期化トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (タスク初期化時) オプション | 説明 |
|---|---|
トリガータイムスタンプ（ユニックスタイム） | トリガーのUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (フレーム初期化時) の値
フレーム初期化トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (フレーム初期化時) オプション | 説明 |
|---|---|
試行番号 | フレーム初期化トリガーが発生した試行番号。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーのUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (フレーム開始時) の値
フレーム開始トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (フレーム開始時) オプション | 説明 |
|---|---|
トリガータイムスタンプ（ユニックスタイム） | トリガーのUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (フレーム終了時) の値
フレーム終了トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (フレーム終了時) オプション | 説明 |
|---|---|
合計フレーム時間 | フレームに費やされた合計時間（ミリ秒単位）。 |
トリガータイムスタンプ（ユニックスタイム） | トリガーのUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (変数値が変更されました) の値
変数値変更トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (変数値が変更されました) オプション | 説明 |
|---|---|
新しい変数の値 | 変数の新しい値を指します。 |
トリガータイムスタンプ（ユニックスタイム） | 変数変更トリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | 変数値が変更された際のフレームの開始から経過した時間（ミリ秒単位）。 |
トリガー (メディアオブジェクトトリガー) の値
メディアオブジェクトトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (メディアオブジェクトトリガー) オプション | 説明 |
|---|---|
トリガータイムスタンプ（ユニックスタイム） | メディアオブジェクトトリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (WebSocketトリガー) の値
WebSocketトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (WebSocketトリガー) オプション | 説明 |
|---|---|
メッセージ | どのデータをフィルタリングするかを説明しラベル付けするために使用できるメッセージ。 |
データ | 参加者の選択、タイムスタンプ、マウスのx/y座標など、さまざまなデータタイプを保持できる値。 |
トリガータイムスタンプ（ユニックスタイム） | WebSocketトリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | トリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (OpenAIトリガー) の値
OpenAIトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (OpenAIトリガー) オプション | 説明 |
|---|---|
Chat GPTの回答 | ChatGPTからの回答の値。 |
トリガータイムスタンプ（ユニックスタイム） | OpenAIトリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | OpenAIトリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (グローバル実験イベント) の値
一時停止/再開実験トリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (グローバル実験イベント) オプション | 説明 |
|---|---|
合計フレーム時間 | トリガーの前に割り当てられた合計フレーム時間を指します。 |
グローバルイベントの理由 | トリガーの理由を示す文字列値（例：参加者が研究から離れる）。 |
トリガータイムスタンプ（ユニックスタイム） | グローバルイベントトリガーが発生した時点のUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | グローバルイベントトリガーが発生した際のフレームの開始からの時間（ミリ秒単位）。 |
トリガー (ユーザーが実験から離れました) の値
参加者がマルチユーザー研究から離れるトリガーが使用されると、以下のトリガー特有の値を特定のアクションで使用できます：
| トリガー (ユーザー が実験から離れました) オプション | 説明 |
|---|---|
残りの参加者数 | 研究に残っている参加者の数。 |
トリガータイムスタンプ（ユニックスタイム） | ユーザーが実験から離れた際のトリガーのUNIX時間形式のタイムスタンプ（ミリ秒単位）。 |
トリガー時間（フレーム開始から） | ユーザーが実験から離れた際のフレームの開始からの時間（ミリ秒単位）。 |