変数を設定 / 記録するアクション
Set / Record Variable アクションは、それを含むイベントが発火する瞬間に変数に値を書き込みます。それはイベントシステムの Variable Actions カテゴリにあり、Labvancedで最も一般的なアクションです：ほぼすべての記録された行動測定とほぼすべての変数駆動条件は、いずれかの時点で通過します。
概要
変数が存在するようになったら、Set / Record Variable が実際に値を得る方法です：反応時間、参加者の選択、ランニングスコア、マウスの動きからの座標ペア。これがなければ、変数は研究全体を通して開始値のままです。
一般的な使用事例
Set / Record Variable は、単純なボタン押しタスクから完全な生理学的記録に至るまで、ほぼすべての研究カテゴリで現れます。
- 行動測定の記録: 反応時間、正確性スコア、または入力された応答を変数に保存し、エクスポートされたデータに表示します。
- カウンターの構築: トリガーが発火するたびに変数を1増加させ、完了した試行、犯したエラー、またはボタンクリックをカウントします。
- トリガー特有の値のキャプチャ: マウスのX/Y座標や視線位置など、トリガーが提供する値を直接変数に書き込みます。
- 条件付きロジックの駆動: 後の
Requirement Actionが次に実行される研究の分岐を決定するために確認する変数を設定します。
必要な知識
このアクションに飛び込む前に、これらのページに記載されている変数作成の基本機能とその特性を理解しておくことをお勧めします。
仕組み
Set / Record Variable にアクセスするには、タスクエディターの イベントシステム を開き、新しいイベントを作成します。 Add Action → Variable Actions の下で、Set / Record Variable を選択します。
単純なダイアログが現れ、方程式として読む二つの部分があります：
| オプション | 説明 |
|---|---|
Select (緑のボタン) | 等号の左側に値を保存すべき変数を選択します。このダイアログを離れることなく新しい変数をここで作成することもできます。 |
| ペンアイコン | 等号の右側で、新しい値が実際に何であるかを定義するために 値選択メニュー を開きます：定数、他の変数の現在の値、トリガー特有の値、または算術式です。 |
これがアクション全体です：変数を選択して新しい値を定義するだけです。ダイアログには固定文として、「記録は試行の最後に行われます」と表示されます：アクションが実行されると、変数の値はクライアント上で即座に更新されますが、その値は試行の最後にサーバーに送信されて記録され、個々の変化ごとにではありません。
実際のシナリオ：カウンターを構築する。 Labvancedに組み込まれた特別な「カウンター」変数はありませんが、任意の変数がそれとして機能できます。あなたの研究に合う任意の名前の数値変数を作成し（例えば trial_count や error_count）、その変数の新しい値を自身にプラス1に設定するために、値選択メニューの Arithmetic オプションを使用します。これは、Labvancedのタスク全体で試行カウンター、エラーカウンター、クリックカウンターの背後にあるメカニズムと同じですので、このような設定がどのように機能するのかを理解することが、このアクションの背後にある能力を把握する上で重要です。
タスクを構築する際には、特定のデータタイプをキャプチャするためにイベントが自動的に作成されるかどうか尋ねられるダイアログボックスが表示されることがあります。これに同意すると、トリガーと Set / Record Variable アクションの両方が既に設定された状態で構築されます。同じアクションとダイアログが上にカバーされています。
ワークフローヒント
- 構築する前に変数を計画する: 構築を始める前に、研究でキャプチャする必要のあるすべてのデータを把握し、それを保存するために作成する必要がある変数の一般的なアイデアを持っていることを確認してください。
Set / Record Variableではその計画が実行されるため、事前に決定することで、ビルドの途中でイベントを再構築することを避けられます。 - 再構築するのではなく、類似のアクションを再利用する: 同じトリガーの下あるいは研究の他の場所に、すでに類似の
Set / Record Variableアクションがある場合は、Copy to Clipboardを使って必要な場所に貼り付け、ターゲット変数や値を少し編集するだけで済みます。再度、Selectと値選択メニューをゼロからクリックする必要はありません。 - 一緒に属するアクションをグループ化する: 複数の
Set / Record Variableアクションが通常一緒に行われる場合、それらを収めるAction Groupを中心にイベント設計を計画してください。後で全体のセットを移動またはコピーする方が、各アクションを個別に処理するよりも速いです。 - まず自動イベント設定を確認する: 目の追跡、感情検出、心拍数などのいくつかのケースでは、Labvancedがトリガーとその
Set / Record Variableアクションを自動的に構築する提案をすることがあります。手動で同じことを設定する前に、そのダイアログが利用可能かどうかを確認してください。
研究と例のシナリオ
公開されたLabvancedタスクからの二つの実際の例、一つは単一の反応をスコアリングし、もう一つは連続した動きを記録します。
フランカー課題における正確性をスコアリング
フランカー課題 のMain_task_desktop_Flanker タスク、フレーム3 (Response Window）、内部の Requirement Action が Response Recording & Progression イベントの中で押されたキーがターゲット方向と一致するかどうかをチェックします。一致する場合、Set / Record Variable が accuracy 変数を 1 に設定します。
マウス軌跡データの記録
Web Bridge のマウス追跡設定は、Set / Record Variable を使用して、マウスの動きごとに Mouse [Name, Info, X, Y] Array トリガー特有の値を変数に書き込みます。形式をArray に、記録タイプをTime series に、サンプリング方法をrecord all (allow repeated duplicates) に設定し、最新のものだけでなくすべての動きをキャプチャします。
