タスクウィザード | クイック実験ビルディングガイド

概要

スプレッドシート / CSVデータを使用して実験的タスクを設定したい場合は、タスクウィザードが実験的タスク作成プロセスを加速するために役立ちます！

タスクウィザードを使用すると、単一のCSVファイルと刺激ファイルから、刺激、イベント、変数、要因、条件、ランダム化、データ記録を含む実験的タスク構造全体を作成できます。タスクウィザードを使用することで、刺激のペアリングやフレーム遷移を選択し、数分で組み込みのランダム化とデータ記録を持つカスタマイズされたタスク構造を持つことができます。

タスクウィザードへのアクセス

タスク作成プロセスの進行状況に応じて、タスクウィザードにアクセスするためのわずかに異なる方法があります。

研究状況	タスクウィザードへのパス
新しい研究	新しい研究を作成 → タスクを設定 → 刺激のアップロードを続ける
既存の研究	既存の研究を開き、研究デザインタブで+ 新しいタスクをクリックして、実験タスクを選択 → 刺激のアップロードを続ける

プログレスバー

実験的タスクウィザードにアクセスすると、タスク準備のためのステップとステージが表示されるダイアログボックスが表示されます:

1. 刺激のアップロード
2. CSVのアップロード
3. 刺激と要因の選択
4. 刺激ペアリング
5. フレームと刺激の配置
6. 遷移

タスクウィザードの機能についての一般的な紹介は、以下のビデオをご覧ください:

タスクウィザードにおける刺激のアップロード

最初のステップとして、実際の刺激ファイルをアップロードします。

1. すべての刺激をアップロード: すべての実験刺激をアップロードするには、ここをクリックしてください（画像、動画などがある場合）。テキスト刺激がある場合は、単純に「次へ」をクリックしてCSVファイルのアップロードに進んでください。後で刺激の割り当て方法について指定します（次のセクションで説明）。注意してください:
   • すべてのファイル拡張子は刺激カテゴリごとに統一されている必要があります! 例えば、異なる列で.jpgと.jpegを切り替えることはできません（下の画像を参照）。
   • ファイルアップローダーの使い方に基づいて、すべてのタスク特定の刺激は単一のフォルダー内にある必要があります。
   • 「OK」をクリックすると、すぐにCSVのアップロードに進むことができます。
2. 次へ（すべての刺激をアップロードしました）: タスクウィザードの次のステージに進みます。

タスクウィザードにおけるCSVのアップロード

刺激をアップロードした後、CSVファイルのアップロードの時間です。次のセクションでは、CSVの設定方法について詳細に説明します。

CSVからタスク設定へ

CSVがタスク作成プロセスでどのように利用されるかの基本的な考え方:

• 行: CSVファイルの各行は、実験タスク内の1つの試行を作成します。下の画像では、デフォルトのプロセスが8つの試行を生成します -もちろん、後で実験デザインのニーズに応じて試行数を変更することもできます。
• 列: 最初の行は、刺激の名前を付けるための列ヘッダーとして使用できます。各列は、別々の刺激要素（画像、動画など）またはデータカテゴリ（次のセクションで説明）でなければなりません。各列は同じ長さでなければならないことに注意してください（すべてのセルが埋まっていること）。

上の画像については、次のセクションでより詳細に説明します。

CSVファイルの準備

じゃあ、CSVファイルにどのような情報を入れるべきか、または入れられるかについて話しましょう。

CSVファイルには、振動、要因、追加情報の3つの異なるデータカテゴリを含めることができます:

データカテゴリ	仕様 / 説明	例
刺激	刺激は、ファイル名（画像、動画、または音声）または単なるテキスト文字列であることができます。注意してください: CSVファイル内のすべての刺激について、対応するオブジェクトが自動的に作成されます。その後、タスクウィザードの後の部分、すなわちフレームと刺激の配置ステップで、参加者に表示されるフレームで好きなように配置する機会があります。正しい拡張子を持つファイル名を使用してください、例: "flower.jpg"	上の画像の A列 は動画刺激タイトルを表します; B-C列 は画像刺激のタイトル; D列 はテキストベースの刺激を表します。
要因	要因はあなたの刺激に対するカテゴリラベルのようなもので、同じ行の刺激に関連するレベル / 値を含める必要があります。 例えば、要因が「歪み」と呼ばれている場合、2つの可能な値「歪んだ」または「正常」があることが考えられ、各行の画像刺激はそのためにそれらの要因の値のいずれかを含むべきです; 歪んだ画像刺激の行は、したがって、「歪んだ」カテゴリを持つことになりますが、通常または制御画像は「正常」カテゴリを持つことになります。 注意: 異なる要因を割り当てるために複数の列を持っても構いませんので、最終的に各行が複数の要因に対する値を含むことができます。例えば、画像刺激 "alice.jpg" に対して、性別という第2の要因を追加することができる場合、値は「女性」となります。その結果、この試行は「歪んだ x 女性」としてカテゴライズされます。これらの組み合わせ要因は後に条件と呼ばれます。	上の画像の F-G列
追加情報	このタイプのデータは、試行ごとに記録したいが、刺激自体でも、要因 / 条件情報でもない追加（刺激）記述子として使用できます。 例えば、どちらの2つの刺激が「正しい」ものであるかをコーディングしたい場合、被験者が与えた回答が正しいかどうかを計算するために、その刺激情報は自動的に記録されます。	上の画像の E列

CSVファイルのアップロード

CSVを作成した後は、アップロードに進むことができます。以下のオプションを含むダイアログボックスが表示されます:

• 文字列をファイルにマップ: あなたのファイル名を文字列として含め、次にマップ機能を使用してファイルが保存されているフォルダーを指すことができます。これにより、その列のファイル名が、データフレーム内の値が希望するファイル名と正確に一致する場合にフォルダー内の対応するファイルを検索できるようになります。この機能は、列が文字列値で埋められている場合のみ利用可能です。
• 最初の行をヘッダーとして使用: データフレームの最初の行の値を取得し、それを各列の変数名として使用します。
• データを転置: 単にデータフレームをそのままアップロードします。これは、データフレームにファイル名が含まれていない場合に便利です。

タスクウィザードにおける刺激と要因の選択

CSVファイルのプレビューが表示されます。また、必要に応じてここでCSVファイルを再アップロードすることもできます。

このステップでは、下の画像で示すように上部のフィールドを編集するオプションがあります:

• 名前: 各列の最初のセルが列名である場合は、ここで編集することができます。以下の例では、最初の列が「方向」というタイトル、2番目の列が「度」と名付けられています。
• データタイプ: データタイプは、CSV内の値に基づいて自動的に選択され、特定されます。「本」のアイコンをクリックすると刺激を再割り当てでき、「ゴミ箱」のアイコンをクリックすると列全体が削除されるので、ご注意ください！
• 使用目的: このフィールドは、最も注意を要するフィールドです。この投稿で議論されたデータのカテゴリがどのタイプかを示す必要があります。CSVファイルの準備に従い、以下のように示します:
  • 列1は「要因」として使用されます。この実験デザインでは、単語分類の種類（すなわちBoubaまたはKiki）が正しく特定されているかを評価することを目的としています。
  • 列2は画像ファイルの名前です。
  • 列3は表示されるテキストの文字列です。
  • 列4は、表示される2番目のテキストの文字列です。

進むためには、すべての使用目的フィールドに値を割り当てる必要があります。

その後、緑の「次へ」ボタンが表示され、次のステージに進むことができます。

タスクウィザードにおける刺激ペアリング

ランダム化のためのペアリング
CSVファイルのペアリングされた列は、ランダム化中に一緒にシャッフルされ（その行の関連性はそのまま保持されます）、異なるペアリンググループの列は、参加者ごとに独立してシャッフルされます。言い換えれば、刺激をペアリングすることで、ランダム化中も一緒に保持されます。要因は常に最初のペアリンググループにあり、刺激や情報の列はどこにでも配置できます。少なくとも1つのペアリンググループが必要であり、各グループには少なくとも1つのエントリーが必要です。

タスクウィザードにおけるフレームと刺激の配置

フレーム上の刺激を配置
今、刺激を配置し、試行ごとにいくつのフレームが必要か、そしてどの刺激をどのフレームに配置するかを決定する時が来ました。記録されるデータの種類と遷移については次のセクションで説明します。

タスクウィザードは自動的にCSVファイル内の順序で、各フレームに1種類の刺激（列）を配置します。上の画像は、二つ前のセクションで示したCSVファイルからの出力です。同じフレーム内の刺激はデフォルトで同時に表示され、異なるフレーム内の刺激は試行タイムラインに従って常に連続して表示されます。もちろん、すべては実験のニーズに合わせて編集可能です。

ここでは、タスクウィザードで新しいフレームを作成し、空のフレームを削除し、フレーム間に刺激をドラッグ＆ドロップすることができます（例えば、テキストと画像刺激を画面上で並べたい場合）。刺激のないフレームに固定テキストコンテンツと固定十字を追加することもできます。 フレームと刺激の詳細な編集オプションは、タスクウィザードの基本設定プロセスを完了した後、タスクエディタで利用可能になります。フレームの分岐ロジック、すなわち、試行の中でフレーム間の進行方法も後でエディタで調整できます。例えば、回答が「正しい」場合、そのフィードバックとして「正しい」と表示されるフレームを指定したい場合、これはタスクエディタ内で微調整されます。

📌実践的な例: 刺激を再配置し、固定クロスを追加する: 下の短いビデオでは、全ての3つの刺激を1つのフレームにまとめるためにドラッグ＆ドロップしています。未使用のフレームを削除し、各試行内の刺激の前に来る固定クロスを作成します。

タスクウィザードにおける遷移

フレームを配置した後、フレームの遷移やどのような記録が行われるかを指定する時間です。ここから、すべてのフレームまたは特定のフレームに対してアイートラッキングまたはマウストラッキングをアクティブにするかどうかを選択できます。

下の画像では、frame_1 は指定した 固定時間 で1000ミリ秒持続します。その後、frame_2 は任意の刺激をクリックすると終了します。注意: この研究では、彼らが画像オブジェクトをクリックした場合にフレームを終了させたくないので、その場合は後でタスクエディタ内で画像オブジェクトを選択し、その オブジェクトプロパティ で アクティブ オプションを False に設定して無効にできます。

タスクウィザードは、クリックされたものを記録し、そのデータを変数に保存するよう自動的に設定されています。

ランダム化に関する追加注意事項

ランダム化に関しては、以下の情報に注意してください:

• 試行の順序はデフォルトで完全にランダム化されます。
• よりカスタマイズされた試行の順序（例えば、固定順序、ブロック条件、階段など）は、ランダム化設定ダイアログで設定できます。
• さらなるバランス調整（例えば、刺激の左右バランスなど）は、ランダム化を追加することで行うことができます（下の画像を参照）。
• 被験者間のバランス調整も、グループやランダム化セパレーターを使用することで行えます。[研究デザイン]タブを使用します。
• ランダム化技術については、こちらでさらにお読みいただけます。
• ランダム化についての詳細なビデオはLabvancedでのランダム化についてもご覧いただけます。

ほとんどの研究において、ランダム化はシンプルかつ明確に行えます。しかし、複雑なデザインにおけるランダム化/バランシングについてお手伝いが必要な場合は、メールまたはチャットサポートを通じてお気軽にお問い合わせください！