データフレームのパターン
データフレームは、実験の入力側を管理するためにLabvancedで最も多用途なツールの1つです。このページでは、3つの一般的な研究デザインシナリオへの適用方法を説明します。データフレームの作成と構成に関する技術的リファレンスは、データフレーム変数を参照してください。
シーケンシャル刺激提示
データフレームの最も一般的な使用法は刺激リストです：トライアルごとに1行、各属性（単語、画像ファイル名、条件、正しい反応）ごとに列があります。セッション開始時に行をシャッフルしてトライアルの順序をランダム化します。次に、各トライアルで、現在の行を配列変数に読み取り、その値を使用してオブジェクトのプロパティを設定します：表示されるテキスト、表示される画像、期待される反応。
主要なコンポーネント：
- トライアルごとに1行のデータフレーム
trial_indexから始まる数値変数、0でReset at Trial Startを無効にしたものShuffle Data Frame Entries（行ごとに）を実行するセッション開始イベント- 行ごとに読み取る
Read from / Write to Data Frameを実行するトライアル開始イベント：インデックス変数 =trial_index、配列変数に出力 - 読み取り後の増加アクション：
1をtrial_indexに追加します。
出力配列の各要素は、その行の1列にマッピングされます。Set Object Propertyアクションは、各値をフレーム上の関連オブジェクトに割り当てます。
カウンターバランスのトライアル順序
Shuffle Data Frame Entriesはセッション開始時に実行され、シャッフルは毎回異なるため、すべての参加者は同じセットから抽出されたユニークなトライアル順序を見ます。これは、繰り返しのない参加者内のランダム化です。
特定の条件順序が参加者間で均等に分配されることを保証したい場合、グループ割り当てとデータフレームを組み合わせてLabvancedの参加者間カウンターバランスを利用します。各カウンターバランス順序に対して別のグループを作成し、各グループのデータフレームをその条件シーケンスに従って事前に順序付けします。参加者は順番にグループに割り当てられ、サンプル間で順序のバランスが取られます。
グループベースのカウンターバランスの完全な文書は、ランダム化とバランスの取れた実験デザインを参照してください。
ファイルベースの刺激
刺激がテキストではなく画像や音声ファイルである場合、データフレームの列にファイル名を格納し、インポート時にMap strings to filesを使用して各名前をアップロードされたファイルにリンク付けします。実行時には、Read from / Write to Data Frameアクションがファイル名を返し、Set Object Propertyアクションが画像または音声要素によって表示されるファイルを変更するためにそのファイル名を使用します。
このアプローチは、刺激の定義（CSV）と刺激の配信（イベントロジック）を分離し、イベントシステムに触れずに新しいCSVをアップロードすることで刺激セットを簡単に更新できるようにします。
手順：
- ファイル名を含む列を持つCSVを準備します（例：
image_file）。画像ファイルは別途研究にアップロードします。 - データフレーム変数を作成し、CSVをアップロードします。インポート時に
Map strings to filesとUse first row as headerを有効にします。 - 各トライアルで
Read from / Write to Data Frameを使用してファイル名を配列変数に読み取ります。 - 画像要素を対象とした
Set Object Propertyアクションを追加します：そのソースをファイル名を保持する配列要素に設定します。