変数の取り扱い

変数は、Labvanced実験の中核を成すものです。参加者の応答、反応時間、刺激条件、正確さスコア、そして研究の論理が依存する計算値など、ランタイムでデータを格納するコンテナです。変数がなければ、実験は記録できず、適応もできず、意思決定もできません。値を読み取ったり結果を書き込んだりするすべてのイベントアクションは、変数で動作しています。

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

このセクションでは

変数の紹介

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

変数の作成

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

変数のタイプ

Labvancedの6種類の変数：システム、ファクター、オブジェクト、カスタム、配列、およびデータフレーム。それぞれのタイプが保存するものと使用するべきタイミング。

変数のプロパティ

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

時系列変数

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

データフレーム変数

CSVをデータフレームとしてアップロードし、ファイル刺激をマッピングし、イベントシステムを使用して試行ごとに行を読み取る方法。刺激リストやカウンターバランスのための標準ツール。

システム変数

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

Role_Id

個人情報を収集せずに、マルチユーザー研究で各参加者を識別するシステム変数。

構築する前に

変数は研究全体にわたってグローバルです。あるタスクで作成された変数は、他のすべてのタスクや研究全体のイベントシステムで可視化され、アクセス可能です。変数名は一意でなければなりません：2つの変数が同じ名前を共有することはできません。

最初のタスクを構築する前に、必要な変数をマッピングします。次の問を考えてください：どのデータを収集する必要がありますか？実験はどのような意思決定をする必要がありますか？試行やタスクにわたって追跡する必要のある値は何ですか？明確な計画のもとで変数を作成することは、構築中に追加してイベントの論理を再設計するよりもはるかに容易です。

何が記録されるか

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

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