変数
説明
変数は、Labvancedの実験作成プロセスにおいてさまざまな目的で使用できます。変数は、実験者によってエディタ内で生成されたり、実験実行中にさまざまな手段で更新されたりする値を保持および更新します。変数の種類には、システム変数、因子変数、オブジェクト変数、カスタム変数があります。
変数の使用方法を理解することは、Labvancedで実験を構築する上で非常に重要です。変数には多くの機能があり、含まれています：
- データの保存/読み取り: 参加者の応答や反応時間などの記録データは、変数に保存されます。
- データの作成: 特定のシナリオでは、スコアを追加したり、文字列をまとめたりするために、その場で変数を作成する必要があります。
- 実験の流れを制御する: 変数を呼び出すことで、実験の流れを制御することができます。たとえば、スコア変数が特定のしきい値以下であれば、特定のタスクに進むというように。
重要なことに、研究内のすべての変数は定義されており、実験全体でグローバルに使用できます。作成されたすべての変数を見るには、特定の研究の左ナビゲーションパネルの変数タブに移動し、そこに研究のすべての変数が一覧表示されます。
変数とその機能の紹介を含む約5分のビデオをご覧ください：
タスクエディタでの変数の見つけ方
タスクエディタ内では、現在選択されているフレームで使用されている変数が、画面右上のVariablesパネルタブに一覧表示されます。ここでは、各変数がその最も重要なプロパティとともに表示されます：主なカテゴリ、データ型、名前。変数はコピー、削除、選択してさらにプロパティを検査および変更できます。
変数の作成
Labvancedのタスクエディタ内、特にイベントシステム内では、目的を達成するために変数を選択する必要がある場所がいくつかあります。
変数は以下の方法で作成できます：
- タスクエディタ:
- 変数パネル: 上記の画像のように、エディタの左上パネルには、新しい変数を作成する機能を含む変数タブがあります。
- 特定のオブジェクトの追加: 入力オブジェクトやアンケート関連のオブジェクトなど、特定のオブジェクトをエディタに追加すると、自動的に変数を作成するように求められますので、応答を保存できます。
- イベントシステム: イベントシステムで変数を作成すること（データを動的に記録し、実験の動作を制御すること）は、理解する上で不可欠な概念です... 次のセクションで詳細に探求します！
実験デザインのヒント: Labvancedで研究を構築する前に、作成する変数のリストを作成し、何を測定したいのか／いつデータを記録したいのかを考えておくのが一般的に良いアイデアです。
変数とイベント
変数に対する変更はイベントを引き起こす可能性がありますが、その逆も真です：イベントは変数の値を変更することができます。さらに、変数は特定のオブジェクトの状態を直接変更することができます...
たとえば、変数の値がXであれば、画像Yを表示します。変数とイベントは、実験の進行を制御するためにも使用できます。たとえば、参加者がタスクAでX（変数の値）を得た場合、タスクBに進み、それ以外はタスクCに進むというように。
イベントシステムでの変数の作成と使用
ユーザーが制御する変数の使用は、主にイベントロジックに基づいています。イベントシステム内には、変数を選択/呼び出し/作成するための2つの主要メニューがあります：
- "値選択メニュー"
- 緑の"選択"ボタン
これらのメニューは視覚的に異なりますが、同じメニュー（変数選択メニュー）を開いて、変数を選択または作成します。
変数選択メニュー
全体として、変数選択メニューには、「ローカル変数」、「すべての変数」、「新しい変数」の3つの異なるタブがあります。「ローカル変数」では、フレームのローカルワークスペースで定義されたすべての変数（すでにフレームで使用されている）が表示され、選択されます。「すべての変数」では、研究のグローバルリストにあるすべての変数が一覧表示され、選択できます。これらのメニューには、希望する変数を直接見つけるための検索機能があります。「新しい変数」タブは新しい変数を作成（したがって選択）するために使用できます。
データの記録
各変数について、ユーザーはチェックボックスを使用して、その変数の値が記録されるかどうかを決定できます。システム変数、因子変数、およびオブジェクト変数に関しては、記録はデフォルトで有効になります。したがって、データ記録の多くの部分は自動的に機能します。特定のオブジェクトプロパティ、参加者の応答、またはデフォルトで記録されない他の何かを記録することを目指す場合、イベントシステムを使用して変数の値を適切に設定する必要があります。
例：反応時間を記録し、それを変数に保存する
反応時間を記録するためのイベントロジックの短い例を以下に示します：
- フレームに画像を追加します。
- 新しいイベントを作成し、それに名前を付けます。
- 変数値を設定するタイミングを決定するトリガーを定義します。たとえば、選択 --> ユーザー入力 --> マウストリガーを選択します。トリガーアクションをクリックとし、ボタンを左に設定します。ターゲットを追加するための+記号をクリックし、画像をクリック可能なターゲットとして追加します。ウィンドウの下部で次へをクリックします。
- アクションを「変数アクション --> 変数を設定/記録を選択します」そして「選択」ボタンをクリックします。
- 「新しい変数」タブをクリックし、名前（データ型：数値、リセット = true、記録 = true）を付けて新しい変数を作成します。「OK」をクリックします。
- 値選択（ペン）アイコンをクリック --> トリガー（マウス） --> フレーム開始からの時間を選択します。「終了」をクリックします。
これで、画像をクリックした際の反応時間が保存されました。他のプロパティ（どの画像が選択されたかなど）を記録するのも同様の手順で行えます。
変数プロパティ
各変数について、異なるプロパティを指定し、変数の使用目的を要約した短いテキスト説明を提供できます。名前およびデータ型プロパティは必須であり（またフォーマットタイプは配列やデータフレームの場合には重要です）、その他のプロパティはオプションであるか、データ型によって変更できない場合があります。
以下は、すべてのプロパティ、その値、および説明のリストです：
名前
- 説明: 名前は、イベント、オブジェクト、タスクのコピー時、さらにはデータビュー内での変数のハンドルとして使用されます。名前は一意でなければなりません（同じ名前の変数は2つ存在できません）。さもなければ、深刻なエラーが発生する可能性があります！名前プロパティは、システム変数以外のすべての変数で変更できます。
- 可能な値: すべてのASCII文字列。ピリオド（.）は使用しないでください。
データ型
- 説明: 変数のデータ型は、変数が保持できる値の種類を決定します。データ型は、変数に適用できる数学的操作の種類も決定します（数値変数のみで乗算が機能するなど）。
- 可能な値:
- 文字列: 数字、特殊文字などを含む任意のテキストを変数に保存できます。
- 数値: 変数には数値のみを保存できます。
- ブール: 変数は「true」または「false」の値のみを持つことができます。
- カテゴリカル: 変数には固定されたあらかじめ定義されたレベルのセットがあり、レベルの1つが変数の値でなければなりません。主に因子変数で使用されます。
- 日付: 変数は（yyyy/mm/dd）形式の日付値のみを保持できます。
- 時間: 変数は（時間/分/秒）形式の時間値のみを保持できます。
- ファイル: 変数は、画像、ビデオ、音声ファイルのファイルデータを保持できます。
スケール
- 説明: 変数のスケールは、変数の「測定レベル」を決定します。この区別は数値データ型の変数にとって有用であり、変数の値の関係を定義します。このプロパティは、将来のLabvanced拡張（分析モジュールなど）でさらに使用される可能性があります。
- 可能な値:
- 未定義: 選択なし
- 名義: 名義尺度値（カテゴリ）。
- 順序: 順序尺度値（ランク）。
- 間隔: 間隔尺度値（真のゼロポイントがないスケール、例：温度）。
- 比率: 比率尺度値（真のゼロポイントがあるスケール、例：体重）。
フォーマット
- 説明: 変数のフォーマットは、変数が単一（スカラ）値であるか、値の配列であるかを決定します。一部の操作/アクションは配列にのみ適用でき、その他はスカラ変数にのみ適用されます。
- 可能な値:
- スカラ: 変数は単一の値です。
- 配列: 変数は範囲の値を保持します。
- データフレーム: CSVファイルにネストされた複数の変数があります。データフレームを選択すると、CSVデータを指定するためのダイアログボックスが表示され、各列が変数になります。ユーザーは、文字列、数値、ブール、またはファイルのいずれかを変数タイプとして選択できます。
開始値
- 説明: 変数の開始値は、変数のデフォルト/リセット値を決定します。開始値は、各試行の開始時に変数の値を特定の値にリセットするために使用できます。開始値は、変数に情報を永久に保存するためにも使用できます（例：テキスト、画像、ビデオまたは音声データ）。
- 可能な値: データ型によって異なります。リセットアイコンを使用して、開始値を削除します。
- データ形式 "配列"の変数: "配列"変数の場合、開始値を1つだけでなく、値で完全な配列を埋めることも可能です。たとえば、ユーザーは単語のリスト（CSVファイル）、画像、ビデオ、音声ファイルなどを配列変数にアップロードできます。配列内のアイテム/エントリの位置も調整できます。
試行開始時のリセット
- 説明: 「試行開始時にリセット」オプションは、変数が各新しい試行のために開始値にリセットされるかどうかを決定します。通常、このオプションは参加者の応答や反応時間を記録する変数には有効にするべきです。しかし、試行を通じてデータを蓄積する変数（フィードバックやその他の目的のため）や、情報を持続的に保存するデータ配列はリセットすべきではありません。
- 可能な値: チェックされている場合（true）、変数は開始値にリセットされます。チェックが外れている場合（false）、変数はリセットされません。
変数を記録
- 説明: 変数を記録するオプションは、変数が記録されるかどうかを決定します。このオプションが有効なすべての変数は、各試行の終わりに記録されます。
- 可能な値: チェックされている場合（true）、変数は記録されます。チェックが外れている場合（false）、変数は記録されません。
記録タイプ
- 説明: 変数の記録タイプは、試行中の変数のすべての値の変更が記録されるか、各試行の最後の変数の値のみが記録されるかを決定します。すべての変更が記録される場合、各変数の変更はタイムスタンプとともに保存されます。このオプションは時系列データを記録するために使用できます（例：マウスまたは眼球追跡のため）。
- 可能な値:
- すべての変更/時系列: タイムスタンプを含む変数のすべての変更を記録します。
- 最終値のみ: 試行の終わりに変数の最後の値のみを記録します。
変数の種類
システム変数
システム変数は、実験の実行およびデータのエクスポートに重要です。これらは自動的に作成され、変更や削除はできません。システム変数は要件（例：If-Elseアクション）でも非常に便利です。たとえば、特定の試行番号を参照したり、主体カウンターを使用したり、参加者間でのマルチユーザー研究のためにイベントを分けたりするために使用できます。すべてのシステム変数は、Labvancedプラットフォームのメイン変数メニューに表示されます。 システム変数の詳細を学んでください。
因子変数
因子変数は、試行システム内の因子にリンクされた変数です。各因子には、カテゴリカルデータ型の1つのリンク変数があります。因子のレベルは、変数の可能な値の状態でもあります。新しい因子を作成する際に、ユーザーは新しい変数を自動的に作成するか、既存の変数を再利用するかを選択できます。因子変数をリンクする際には、変数/因子レベルへの変更が、すべてのリンクされたタスク/試行グループの試行構造を変更することに留意する必要があります。因子変数は、特定の条件下でのみ実行されるイベントを作成するためにイベントシステムで使用できます（例：因子「画像カテゴリ」が「家」である場合にのみ何かを実行する）。さらに、実験実行の各試行中に、各因子変数には常に新しいレベル値がデータビューに保存されます。このように、データ出力を表示したり、手続きを繰り返したりする際に、各記録された試行の条件を再構築することが容易になります。
オブジェクト変数
オブジェクト変数は、オブジェクトがフレームに追加されると自動的に作成されます。これらの変数のほとんどは、「アンケート項目」の追加から生じます。チェックボックス、リッカートスケール、ドロップダウンなどです。このようなオブジェクトが作成されると、関連付けられた変数の名前を入力するよう求められます。有効な（ユニークな！）名前を入力すると、変数が自動的に作成されます。オブジェクトプロパティビューには、「リンク変数」として関連付けられた変数への参照が表示されます。ここで、別の変数へのリンク/関連付けを変更することもできます。しかし、このオプションは特に注意して使用することをお勧めします。実験実行時に、参加者の応答が変数内に保存されます。オブジェクト変数はデフォルトで記録され、オブジェクト変数のほとんどのプロパティはその機能を確保するために変更できません。
カスタム変数
カスタム変数は、ユーザーによって積極的に作成されます。カスタム変数を作成する理由は非常に多様です。参加者の決定（マウスクリックまたはキーストローク）や反応時間を記録するために使用できます。また、whileループや配列アクションのカウンターまたはインデックスとして、（画像、ビデオ、音声）ファイルデータを保存するために使用することもあります。
変数が使用されずに作成されるか、その使用（オブジェクトまたはイベント）が削除されると、変数は未使用としてリストされます。
配列変数
配列は、上記のスカラ変数とは非常に異なります。配列をスプレッドシートの1列だと考えてください：特定の順序でエントリを保持します。配列を作成する際に、「CSVファイルを使用」の隣のフォルダをクリックして情報の列を含む.csvファイルをアップロードするか、プラスアイコンを使って手動でエントリを追加します。
配列に関連するアクションのリストについては、配列アクションをご覧ください。
データフレーム変数
データフレームは、配列と異なり、配列がスプレッドシートの1列であるのに対して、データフレームは複数の列を持つスプレッドシート全体です。データフレームは文字列（テキスト）、数値、ブール、またはファイル値を保持できますが、データフレームダイアログウィンドウで直接編集することはできません。列やファイルを追加できますが、テキストや数字を入力することはできません：
新しいデータフレームを追加するには、「2D CSVデータをアップロード」をクリックします。データフレームに情報を追加する場合、.csvファイルのみが受け入れられます。ファイルを選択した後、いくつかのインポートオプションが表示されます：
適用されるすべてを選択してください：
- 文字列をファイルにマッピングすると、ファイル名を文字列として含めることができ、その後マップ機能を使用してファイルが保存されているフォルダを指すことができます。これにより、データフレーム内のファイル名の列がフォルダ内の対応するファイルを検索できるようになります。データフレーム内の値が希望のファイル名と正確に一致する場合にのみ機能します。この機能は、列が文字列値で埋められている場合にのみ使用可能です。
- 最初の行をヘッダーとして使用すると、データフレームの最初の行の値を取り、それを各列の変数名として使用します。
- データを転置すると、データフレームがそのままアップロードされます。これは、データフレームにファイル名が含まれていない場合に便利です。
データフレームがすべて文字列値で構成され、フォルダ内のファイル名に対応する場合は、すべての文字列をファイルにマッピング機能を使用して、データフレーム全体をフォルダにマッピングできます。
既存のデータフレームにさらに情報を追加するには、データフレームダイアログボックスの上部で変数/列を追加するオプションを選択します。
データフレームに関連するアクションのリストについては、データフレーム操作をご覧ください。
変数の参照と変数の削除
各変数がどこで使用されているかをよりよく把握するために、変数プロパティパネルの下部にはUSED INと呼ばれるリストがあります。ここには、変数のすべての使用法が記載されており、変数が使用されているフレームへの参照（名前）、その目的（Used as）、および使用が読み取り操作（R）、書き込み操作（W）、またはその両方（RW）であるかどうかが表示されます。変数が使用されているフレームごとに、「ローカルワークスペース」という名前の「使用タイプ」のエントリが使用テーブルに1つ追加されます。フレームのローカルワークスペース内のすべての変数は、その後「ローカル変数」セクションに表示されます。
変数を削除する際は、特に注意が必要です。因子、オブジェクト、またはイベントでまだ使用されている変数を削除すると、深刻な問題が発生し（最悪の場合）、実験全体の構造が崩れる可能性があります。そのため、変数タブでは、1つ以上のローカルワークスペース内に存在する以外の使用がない変数のみを削除できます。ローカルワークスペースにのみ定義されている変数（他に使用がない）は未使用としてリストされ、削除アイコンがその隣に表示されます。