変数の取り扱い

変数は、すべてのLabvanced実験のバックボーンです。これらは実行時にデータを保存するコンテナであり：参加者の反応、反応時間、刺激条件、正確さのスコア、および研究論理が依存する計算された値を保存します。変数がなければ、実験は記録できず、適応できず、意思決定もできません。値を読み取ったり結果を書き込んだりするすべてのイベントアクションは、変数で動作します。

変数を理解することは、静的実験から完全に動的な分岐研究に移行するための鍵です。変数は、その値が変化したときにイベントをトリガーできます。イベントは変数を更新できます。変数の値は、どの画像が表示されるか、どのタスクブランチが選ばれるか、または参加者が前進するかリダイレクトされるかを制御できます。この変数とイベントの相互作用は、Labvanced実験に柔軟性を与えます。

このセクションでは

変数の紹介

変数とは何か、どのようなデータを保持するのか、なぜすべての実験がそれに依存するのか。変数システムが初めての場合は、こちらから始めてください。

変数の作成

変数を作成するための4つの方法：変数タブ、タスクエディターパネル、オブジェクトプロンプト、またはイベントシステムから。命名規則と各方法が最も便利なときについて説明します。

変数の種類

Labvancedの6種類の変数：システム、ファクター、オブジェクト、カスタム、配列、およびデータフレーム。それぞれのタイプが何を保存し、いつ使用すべきか。

変数の特性

すべての設定の完全なリファレンス：データタイプ、スケール、フォーマット、開始値、リセット動作、記録オプション。このページを使用して、研究デザインに合わせて変数を正しく設定してください。

時系列変数

マウスの位置、視線、または生理的信号などの連続的な測定を記録する方法。記録タイプ、サンプリング方法、エクスポートされたデータの見た目について説明します。

データフレーム変数

CSVをデータフレームとしてアップロードし、ファイル刺激をマッピングし、イベントシステムを使用して行をトライアルごとに読み取る方法。刺激リストと反転対照に標準的なツール。

システム変数

システム変数とは：自動的に作成され、読み取り専用であり、試行番号やRole_Idなどの実験レベルの情報を追跡します。

Role_Id

マルチユーザー研究において各参加者を特定するシステム変数であり、個人情報を収集することなく識別します。

ビルドの前に

変数は研究全体でグローバルです。1つのタスクで作成された変数は、他のすべてのタスクおよびイベントシステムで表示およびアクセス可能です。変数名はユニークでなければなりません：2つの変数が同じ名前を共有することはできません。

最初のタスクを構築する前に、必要な変数をマッピングしてください。「どのデータを収集する必要があるのか？実験はどのような決定を下す必要があるのか？試行やタスクにわたってどの値を追跡する必要があるのか？」明確な計画を持って変数を作成することは、ビルドの中で追加しイベントロジックを再構築するよりもずっと簡単です。

記録されるもの

システム、ファクター、およびオブジェクト変数は自動的に記録されます。カスタム変数は、変数の特性でRecord Variableを有効にし、正しいタイミングで値を書き込むためにイベントシステムにSet / Record Variableアクションを追加するという2つの追加ステップが必要です。

反応時間、マウストラッキング、生理的信号などの時間に敏感な測定については、連続データがどのようにキャプチャされるかを制御する追加のRecord TypeおよびSampling Method設定については時系列変数を参照してください。