トライアルシステム

説明

タスクエディタでは、トライアルシステムは画面の左側にあります。一般的に、トライアルシステムはタスクのいくつかの繰り返し（トライアル）を作成するために使用され、タスク作成プロセスの重要な部分です。

トライアルシステムは主に二つの主要セクションで構成されています：

1. 因子とランダマイゼーション： 興味ある因子に基づいて作成された分類と、実験デザインにおけるランダマイゼーション因子。
2. トライアルと条件： 因子とランダマイゼーションを使用して作成されたトライアルと条件。

因子ツリーがトライアルグループ、因子、またはレベルの変更により編集されると、トライアルと条件の下にある条件テーブルは、因子ツリーの設定に基づいて自動的に更新されます。

---

📌 実践例：実験因子とレベルの設定を1分以内で行う： 下のビデオは、Labvancedで基本的な実験構造を確立するために因子とレベルを利用することがどれほど簡単かを示しています。

因子ツリー

因子ツリーは、タスクの上位階層の構造を変更および修正するために使用できます。具体的には、タスク階層の上位3つの要素を修正するためにあります：

• トライアルグループ（因子とフレームを含む）
• 因子（レベルを含む）
• レベル（条件を作成するために交差する）

以下の画像は、発展した研究におけるこれらのセクションがどのように見えるかを表しています。

エラという名前の因子は、モダンとクラシックという2つのレベルを持つ

トライアルグループ

トライアルグループは、タスク内の概ね似たトライアルのグループを格納するためのコンテナとして機能します。最も重要な点は、トライアルグループ内のすべてのトライアルが同じフレームシーケンスを持ち、同じオブジェクトやイベントを含んでいることです（ただし、オブジェクトやイベントのプロパティはトライアル間で変更されることがあります）。トライアルグループは、トライアルの全体的な構造を設定します。各タスクには少なくとも1つのトライアルグループが必要です。

ほとんどの実験と同様に、非常に異なるタイプのトライアルを混ぜるべきです（例えば、通常のトライアルとキャッチトライアル）。タスク内の複数のトライアルグループを使用して、非常に異なるトライアルを作成し混ぜることができます。

因子

トライアルグループに因子を追加することで、ユーザーは異なるバージョンのトライアルを作成できます。通常、因子の名前は、トライアルで変化する側面を示します（例：刺激の位置、サイズ、画像カテゴリーなど）。因子のレベルは、変化の特性（左/右、小/中/大、幸せ/悲しいなど）を説明します。因子が持つレベルが多いほど、存在するトライアルの変種が増え、より大きな刺激空間が作成されます。これは、因子が全体の刺激空間を拡張するためには、少なくとも2つのレベルを持つ必要があることを意味します。

Labvancedでは、タスク設定中に因子を分割する方法は2通りあります：

1. 因子： 通常、実験の質問/仮説に重要な独立変数であり、エディタの上部セクションの因子の下で作成されます。
2. ランダマイゼーション因子： バイアスを減らすために実験での変動を作成するために導入され、ランダマイゼーションの下で作成されます。

上の画像は次のように設定されています：

• メイン因子 = テキスト条件（表示される単語の種類）
  • レベル1 = Bouba様式
  • レベル2 = Kiki様式
• ランダマイゼーション因子 = pos_correct（正しい画像の位置）
  • レベル1= 左
  • レベル2 = 右

これに基づいて、トライアルと条件テーブルが更新され、上記の因子を交差させて4つの条件が作成され、#トライアル値（第2列）が更新されて各条件に対して5つのトライアルが表示されます。

実装に関する注意 - 実験実行時の固定因子とランダマイゼーション因子の違い： 固定因子は、タスクが実行されるときにより多くのトライアルを生成しますが、ランダム因子は各トライアルの選択肢としてより多くのトライアルの可能性を生成します。例えば、レベル「左」と「右」を持つ因子「位置」が固定されている場合、被験者はトライアルの「左」変種と「右」変種の両方を見ることになります。しかし、因子「位置」がランダムであれば、被験者はトライアルの「左」変種または「右」変種のいずれかを見ることになります。因子のランダマイゼーションに関する詳細は、トライアルランダマイゼーションのセクションを参照してください。

技術的注意 / 追加情報： トライアルグループには少なくとも1つの固定因子が必要で、それぞれの因子には少なくとも1つのレベルが必要です。Labvancedはこれを自動的に行い、あなたがアクセスして名前を変更できます。この区別は、定義されたトライアルの変種の数には影響しませんが、タスクが実行されるときに被験者が見るトライアルの数には影響します。

ランダマイゼーションとランダマイゼーション因子

ランダマイゼーションセクションは、実験デザインをランダマイズする因子を作成するために使用できるエディタの一部です。一般的な例は、ターゲット刺激の位置をランダムに変更することです。例えば、正しい画像がフレームの左または右側にあるというように。

ランダマイゼーションセクションと提供されている設定の詳細については、こちらのページを参照してください。

因子関連変数

重要なことに、各因子は因子変数にリンクされています。これは、主に二つの理由で便利です。

1. 制御されたイベント： イベントは、特定の条件にカスタマイズされます（例えば、因子「画像カテゴリー」がレベル「家」と等しい場合に何かをするように実験を指示できます）If…Thenイベントを使用します。
2. データ分析： 各トライアルは与えられた因子の値を記録し、後で実験者がデータセットを確認するときに異なる条件を簡単に区別できるようにします。

因子をトライアルグループに追加するとき、既存の因子変数を再利用するか、新しい変数を作成するかを選択できます。因子変数はタスク内またはタスク間でリンクできますが、リンクされた因子変数に変更が入ると、その因子が使用されているすべてのタスクおよびトライアルグループに変更が引き起こされることを知っておくことが重要です。

レベル

レベルは各因子の可能な値であり、各因子の特性を決定します。因子「名詞」は、例えば、3つのレベル「動物/花/食べ物」を持つことができます。この因子がトライアルグループ内の唯一の因子である場合、各レベルについて自動的に条件が作成され、編集中の画面の左下隅にある条件テーブルに表示されます。以下の画像は、因子1とその3つのレベルを示しています。マルチファクターデザインでは、追加の因子とレベルも作成でき、下の画像でも示されています：

複数の因子が作成されると、因子の各レベルは、因子グループ内の他の因子のすべてのレベルと組み合わされます（因子が交差します）。因子「名詞」が3つのレベルを持ち、因子「位置」が2つのレベルを持ち、因子「色」も2つのレベルを持つ3因子デザインでは、合計12条件の交差となります。条件テーブルは、自分が設定した因子とレベルに合わせて自動的に更新されます。以下の画像は、レベル動物の変動として最初の4つの条件を示しています：

使用法： 因子レベルが研究デザインに与える正確な影響を定義するために、因子ツリー内で因子レベルをクリックして、現在のフレームで表示されるオブジェクトを修正できます。変更は、選択した因子が指定されたレベルを持つすべてのトライアルおよび条件に影響します。このアプローチは、刺激の変動が因子のレベルに依存しているが、特定の条件や単一のトライアルには依存していない場合に特に役立ちます。

---

📌 実践例：レベル固有の指示を追加し、レベルを使用したターゲットイメージのランダマイズを設定する： 下の1分のビデオは、Labvancedでレベルを使用して実験に変数を追加する迅速な方法を示しています。ビデオに示されているように、最初にレベルをクリックし、そのレベルに特有の指示を追加することから始めます。例えば、Happyレベルをクリックして、指示「幸せな画像をクリックしてください。」と入力します。そして、次にSadレベルをクリックして「悲しい画像をクリックしてください。」と入力します。その後、ランダマイゼーションの下の右レベルでターゲットイメージの位置を変更すると、単なる数回のクリックで実験構造がすべてのトライアルにわたって自動的に更新される様子を確認できます。

条件

前述のように、条件は因子レベルの数と交差によって決まります。各条件は、そのトライアルグループ内のすべての因子の値（因子レベル）によって明確に定義されます。

条件は条件テーブルの下にリストされています - 次のセクションを参照してください。

使用法： 個々の条件に変更を加えるために、ユーザーは条件テーブルを介して条件をクリックし、キャンバス上のオブジェクトに変更を加えることができます。行った変更は、選択した条件にのみ適用されます（すなわち、その条件内のすべてのトライアル）。これは、一度にトライアルの集合に変更を加えるための正確な方法です。

---

📌 実践例 – 特定のレベルとオブジェクトに刺激をアップロード： 下のビデオでは、関連条件に画像刺激をアップロードすることで実験デザインを発展させる様子を示しています。

トライアルに画像を追加することに関する詳細については、[このセクション]を参照してください。(#generate-trials-by-adding-stimuli)

条件テーブル

条件テーブルは、タスク階層の中間層を修正するために使用でき、特に条件とトライアルに関わります。タスクの階層的な性質のために、因子レベルの交差は各トライアルグループの条件を個別に生成します。これらは、タスクエディタの左下隅にある条件テーブルに表示されます。因子に変更が加わると、条件テーブルは自動的に更新されます。各条件に対して、トライアルの数を個別に定義できます。また、一部の条件は全く表示されないように0に設定することもできます。

以下は列タイトルとその説明です：

• 条件： 特定の条件番号で、それをクリックすると、その中に含まれる特定のトライアルにアクセスできます。
• #トライアル： 特定の条件内のトライアルの数。ここで条件ごとのトライアルの数を設定できます。
• トライアルID： トライアルIDは、あなたが第2列に指定したトライアルの数に合わせて自動的に更新されます。
• 条件グループ： 作成した因子に基づく条件グループを指します。
• 因子1（感情）= この列は、あなたが作成した因子の名前を引き受けます。その下には、異なるレベルがリストされています。
• 因子2（ターゲット位置）= あなたが作成した2番目の因子の名前を引き受け、そのそれぞれのレベルが続きます。
  • 注: ここでの因子列は、あなたの実験デザインとあなたの研究の特有の因子を反映するように自動的に拡張されます。

デフォルトトライアルに関する情報については、次のセクションを参照してください。

デフォルトトライアル

条件テーブルはトライアルグループごとにグループ化されており、各トライアルグループには条件テーブル内に正確に1つの「デフォルトトライアル」があります。デフォルトトライアルは、各トライアルグループの最初の行にあり、条件の上にあります。

全体として、デフォルトトライアルを修正すると、トライアルグループ内のすべてのトライアルが同じ「デフォルト」値にリセットされ、トライアルグループ内のすべてのトライアルが同時に選択され、編集されます。これは、全体のフレーム構造の大まかな定義に役立ちます。

---

📌 実践例 – すべてのトライアルにフィクセーションクロスを追加： 下のビデオは、デフォルトトライアルを介してフィクセーションクロスフレームを追加することが他のすべての条件とトライアルにも自動的に適用される様子を示しています。

トライアル

トライアルは条件内にあり、トライアルシステム階層の最も基本的な単位です。各条件はデフォルトで1つのトライアルで作成されます。条件ごとのトライアルの数は、条件テーブルで調整できます。

使用法： 一つの条件内に複数のトライアルが存在する場合、「条件テーブル」で条件を開く（展開する）ことで、個々のトライアルを選択できます。その後のキャンバスやオブジェクトへの変更は、この特定のトライアルにのみ適用されます。

刺激を追加してトライアルを生成

トライアル構造は、ファイルマネージャーと統合されたマルチセレクト機能を介して自動的に作成することもできます。これは、変動が異なる刺激内容（異なる画像、ビデオ、音声など）によって生成される場合に便利です。これを行うには、画像、ビデオ、または音声オブジェクト（コンテナ）を選択し、オブジェクトプロパティパネルのフォルダーアイコンを介してファイルマネージャーを開きます。その後、複数の（2つ以上の）画像/ビデオ/音声ファイルを選択し、右下の「割り当て」アイコン（矢印付きのグリッドシンボル）をクリックします。

新しいメニューが開き、これらの複数選択されたファイルをどのように使用するかが尋ねられます。ここでは、いくつかのサブオプションを伴う3つの主要な選択肢があり、下の画像に示されています：

上の画像はオプションAを示しています。トライアルと条件テーブルで選択されている条件2に割り当てることを指定しています。

A. トライアル：ファイルをトライアルに割り当てる

• 既存のトライアルにファイルを割り当てる： 画像/ビデオ/音声ファイルは、選択した条件内の既存のトライアルに割り当てられます。
• 選択されたファイルの数だけトライアルを作成する： 画像/ビデオ/音声ファイルは、選択された条件のトライアルの数にマッチします。選択されたファイルの数だけ1つのトライアルが存在します。条件内の以前のトライアルは削除されます。因子を作成した場合、画像がアップロードされる条件を指定することもできます（上の画像の通り）。
• 選択された各ファイルに新しいトライアルを作成する： 選択された画像/ビデオ/音声ファイルごとに、選択された条件に新しいトライアルが追加されます。新しいトライアルは既存のトライアルに追加されます。

B. 条件：ファイルを条件に割り当てる

• このオプションは、選択された因子グループと既存の条件にファイルを割り当てます。

C. 因子レベル：ファイルを因子レベルに割り当てる

• 既存の因子レベルにファイルを割り当てる： 画像/ビデオ/音声ファイルは、選択された因子内の既存のレベルに割り当てられます。
• 既存の因子内に新しいレベルを作成する： 各画像/ビデオ/音声ファイルに対して、選択された因子に新しいレベルが追加されます。新しいレベルは既存のものに追加されます。
• 新しい因子と新しいレベルを作成する： 新しい因子が作成されます。各画像/ビデオ/音声ファイルに対して、この新しい因子に新しいレベルが追加されます。選択されたファイルごとに1つの因子レベルが存在します。

全体の割り当て方法を選択した後、どのファイルをどのトライアル、条件、または因子レベルに割り当てるかを決定できます。それぞれのメニューには、選択されたファイルのリスト（右）と割り当て項目のリスト（左）が表示されます。その後、右から左に個々のファイルをドラッグ＆ドロップして、どのファイルをどのトライアル、条件、または因子レベルに関連付けるかを手動で決定できます。ただし、「自動割り当て」ボタンを使用すると、すべてのファイルが自動的にランダムな順序で割り当てられます。この方法で、刺激の関連付けを迅速に設定できます。

📌 例：エディタ内のオブジェクトを使用してファイルをトライアルに割り当てる： 下のビデオは、トライアルシステム内の画像オブジェクトをクリックして刺激をLabvancedにアップロードする方法の例を示しています。

トライアルの操作

因子グループ、因子、レベル、条件、トライアルが設定され、フレームとオブジェクトが追加されると、次のステップは、オブジェクトプロパティを使用して要素を微調整し、異なるトライアルに異なる刺激の変種が表示されるようにすることです。これは、各変得で適切な修正レベルを選択することが中心的に重要です。全体として、修正には4つのレベルがあります：

• トライアルグループ修正（デフォルトトライアルを使用）： 選択されたトライアルグループ内のすべてのトライアルを変更します。
• 因子レベル修正： 選択された因子が選択された因子レベルを持つすべての条件（およびそれらの内部のトライアル）を変更します。
• 条件修正： 選択された条件内のすべてのトライアルを変更します。
• トライアル修正： 選択されたトライアルのみを変更します。