画像オブジェクト

画像オブジェクトはLabvancedで最も一般的に使用されるオブジェクトの一つであり、研究者が実験中に参加者に静止画像や写真を提示することを可能にします。これは、オブジェクト、シーン、顔などの刺激を表示するために、認知、社会、行動研究で一般的に使用されます。 画像オブジェクトは非常に柔軟で、実験デザインに合わせてさまざまなプロパティや設定でカスタマイズすることができます。研究者は、画像のサイズ、位置、回転、透明度などの側面を制御し、正確な刺激提示を保証します。さらに、画像オブジェクトはイベントを通じて動的に操作でき、高度な論理的相互作用を可能にします。

実験デザインにおける画像オブジェクト

画像オブジェクトを取り扱うには、実験デザイン中にどのように操作するかを知っておくことが重要です。以下では、このオブジェクトを介して画像を追加する方法や、カスタマイズを通じて、またデータフレームやイベントなどのより動的なアプローチを使用してどのように制御できるかについて議論します。 Labvancedは、実験内で画像オブジェクトの提示と動作を制御するための複数の方法を提供しています。これらは以下の方法で実行できます:

• 画像オブジェクトのためのオブジェクトプロパティパネル
• 画像オブジェクトの追加のためのタスクウィザード
• トライアルシステム
• イベント
• ランダム化

まずは、前述のトピックに入る前に、画像がエディタに追加される方法を説明します。

画像オブジェクトの追加

画像オブジェクトを実験に統合するには、オブジェクトメニューに移動し、画像オブジェクトを選択します。

画像オブジェクトのためのオブジェクトプロパティパネル

オブジェクトプロパティパネルは、編集モード中の画面右側に位置しており、画像オブジェクトのすべてのプロパティを編集するためのいくつかのオプションを提供します。画像刺激をアップロードするオプションも含まれています。 以下の画像に示されているように、設定を数回のクリックで制御できる右側のパネルにいくつかのオプションがあります。この画像には「ターゲット画像」と呼ばれる名前を付けました。

これらのオプションの完全な説明については、すべてのプロパティが表形式でリストされている このページのセクション を参照してください。

このパネルを使用してデフォルトのプロパティを設定し、その後 イベントを使用 して新しい値に動的に更新するのは非常に一般的です。たとえば、画像をクリック（トリガー）した際に、画像を5単位右に移動するようにイベントを指定できます。

画像オブジェクトの追加のためのタスクウィザード

スプレッドシート / CSVデータを使用して実験タスクを設定したい場合、タスクウィザードを使用して画像刺激を追加できます。

以下の例では、B列とC列は画像刺激を表しており、タスクウィザードを使用すると自動的に画像オブジェクトに追加されます。

以下の例では、B列とC列は画像刺激を表しており、タスクウィザードを使用すると自動的に画像オブジェクトに追加されます。

このウィザードを使用することで、刺激、イベント、変数、要因、条件、ランダム化、データ記録を含む実験タスクの全体的な構造を、単一のCSVファイルおよび刺激ファイルから作成できます。

トライアルシステムと画像オブジェクト

画像オブジェクトがフレームに追加されると、トライアルシステムを共同で使用して、実験の仮説に基づいて異なるトライアル（タスクのいくつかのユニークな繰り返し）を作成できます。

たとえば、感情を研究しており、トライアルを感情タイプに基づいて分類し、デザインしたい場合、1つのフレームに2つの画像オブジェクトを追加できます。一つは幸せな感情の刺激を、もう一つは悲しい感情の刺激を持っています。その後、「感情」という名前のファクターを追加し、2つのレベル「幸せ」と「悲しい」を設定した後、関連する条件の下で画像刺激をアップロードすると進むことができます。

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

詳細については、トライアルシステムのドキュメントをご覧ください。

イベントシステムと画像オブジェクト

イベントシステムは、次のような動的な方法です：

• 画像がどのように振る舞うかを制御する
• オブジェクトの特定のプロパティを記録する
• データフレームを介して画像刺激を提示する

これらのポイントについて、今から詳しく議論します。

画像の振る舞いを制御する

画像の任意の動作や外観は、イベントを使用して修正できます。

以下の例では、名前が「ターゲット画像」の画像オブジェクト上でマウスクリック（トリガー）を設定し、ターゲット画像のx座標（プロパティ）を+5増加させることを指定します。これはつまり、各クリックごとにx座標が+5増加し、画像が右に移動することになります。

画像オブジェクトからのデータと記録

画像オブジェクトに関連する値を記録するには、Set/Record Variableアクションを使用し、記録したいデータを指定します。

ファイル名の記録

場合によっては、実験中にトライアルで提示された画像の正確な名前を記録したいことがあります。それは完全に可能で、設定するのは簡単です！

以下の例では、正しい画像と誤った画像のために画像名を保存します。2つの変数があります–「正しい画像名」と「誤った画像名」、どちらもファイルの名前が文字列形式であるため、「文字列」データを保存します。

オブジェクトを指し示すには、鉛筆アイコンをクリックし、Frame / Task / Objectカテゴリを選択し、Object Propertyを選びます。最初のフィールドではターゲットオブジェクトを選択し、2番目のフィールドではFilenameを選択します。同様に、「誤った画像名」変数については、「誤った」画像オブジェクトにリンクして刺激のファイル名を指し示します。

上記の結果として、試行ごとに画像の特定のファイル名が以下の画像のようにリストされています。

上記の例は、あなたのアカウントにインポートできるこのブーバ-キキ効果に関するサンプル研究から取られています。

ランダム化と画像オブジェクト

ランダム化は、画像提示に関連する別の重要なトピックです。この文脈におけるランダム化については、手元の特定の実験に重く依存するため、多くの方法があります。

画像オブジェクトに関して、ランダム化は通常、ターゲット画像の位置を変更したり、セットからランダムな画像を選択したりすることを含みます。

Labvancedにおけるランダム化とバランスに関する詳細情報については、このページを参照してください。

研究スポットライト: 画像オブジェクトの実行

画像オブジェクトは、特に視覚的認知、記憶、および注意に関する研究において、実験研究で重要な役割を果たします。 Labvancedは、さまざまな分野の研究者がLabvancedの画像オブジェクトを使用して研究を行うことを可能にしました。

視覚的注意の動態: アイ・トラッキング研究

この研究（Calignano et al., 2024）では、意味処理、つまり、単語や物体の意味が、私たちが視覚的な焦点をどこに向けるかにどのように影響するかを探求しました。実在の単語や馴染みのある物体が、非単語や擬似物体よりも注意の関与やターゲットの検出をより効果的にバイアスすることが仮定されました。

参加者は、プライム（後のターゲットへの注意と認知に影響を与える可能性のある初期の手がかり）を提示されました。研究者たちは、Labvancedを使用して、2つのウェブベースのアイ・トラッキング実験を行いました：

• 実験1: 参加者に単語（実在の単語または擬似単語）をプライムとして提示
• 実験2: 画像（実在の物体または擬似物体）をプライムとして提示。

単語（実験1）と画像（実験2）の実験パラダイム; Calignano et al. (2024).

プライムを見た後、彼らはターゲットを見る場所を示す空間的手がかり（有効または無効）を見ました。有効な空間的手がかりはターゲットと同じ位置に表示され、無効な手がかりはターゲットとは異なる位置に表示されます。参加者はターゲットを特定し、ターゲットを見つけたときにキーを押して応答する必要がありました。

収集されたデータには、ターゲット検出の反応時間（ミリ秒）、タスクのパフォーマンスに対する精度率、および注意分析におけるアイ・トラッキングデータが含まれました。

結果は、単語や認識された物体が、タスクとの直接的な関連がなくても、トップダウンプロセスを通じてターゲット検出を強化できることを示しました。

画像オブジェクトのプロパティテーブル

Labvanced内の任意のオブジェクトと同様に、オブジェクトを操作する際に右側パネルに表示される一般的なプロパティとオブジェクト固有のプロパティがあります。以下は、画像オブジェクトオプションに関連する仕様と説明です：

画像オブジェクトの主なプロパティ

プロパティ名	データ型	修正可能か、方法	フレームタイプ	説明
Name	String	はい、テキストボックス	Canvas & Page	オブジェクトの名前。名前は多くの場面でオブジェクトを参照するために使われるため（つまり、イベント内で）、一意である必要があります。
Visibility	Numeric (0-1)	はい、チェックボックス	Canvas	オブジェクトの透明度の値。0の値はオブジェクトが完全に見えなくなり、1の値は完全に見えます。
Active	Boolean (true / false)	はい、チェックボックス	Canvas & Page	オブジェクトがアクティブかつ実験実施中に変更可能かを決定します。falseに設定すると、オブジェクトはアクションを起こしません。

画像オブジェクトの位置・サイズプロパティ

プロパティ名	データ型	修正可能か、方法	フレームタイプ	説明
X	Numeric (0-幅のフレーム)	はい、テキストまたは矢印	Canvas	オブジェクトのX位置。
Y	Numeric (0-高さのフレーム)	はい、テキストまたは矢印	Canvas	オブジェクトのY位置。
Width	Numeric (0-幅のフレーム)	はい、テキストまたは矢印	Canvas	オブジェクトの幅。
Height	Numeric (0-幅のフレーム)	はい、テキストまたは矢印	Canvas	オブジェクトの高さ。
Anchor	Categorical (1-9)	はい、オプションを選択	Canvas	アンカーはオブジェクトの「位置参照ポイント」を設定します。デフォルトでは、これは左上隅です。

画像オブジェクトのスケール・回転プロパティ

プロパティ名	データ型	修正可能か、方法	フレームタイプ	説明
Scaling	Numeric (0-Inf)	はい、テキストまたは矢印	Canvas	要素のスケール/ズームを変更します。大きな値は要素をズームインします。
Rotation	Numeric (0-359)	はい、テキストまたは矢印	Canvas	オブジェクトの回転を変更します。0はデフォルトの直立位置です。
Keep aspect ratio	Boolean (true / false)	はい、チェックボックス	Canvas	オブジェクトがリサイズされるときに、オブジェクトのアスペクト比が保持されるかどうかを決定します。

画像オブジェクトのスタイル

プロパティ名	データ型	修正可能か、方法	フレームタイプ	説明
Border-Size	Numeric (0-INF)	はい、テキストまたは矢印	Canvas	オブジェクトのボーダーサイズを変更します。0はボーダーが表示されません。
Border-Color	Hex String (Color)	はい、オプションを選択	Canvas	オブジェクトのボーダー色を変更します。
Background (BG)-Color	Hex String (Color)	はい、オプションを選択	Canvas	オブジェクトの背景色を変更します。デフォルトでは、色はありません/透明です。
Roundness	Numeric (0-1)	はい、テキストまたは矢印	Canvas	オブジェクトの丸みを変更します。1は完全に丸いオブジェクト、0は完全に四角いオブジェクトです。
Overflow-X	Categorical (Hidden,Auto,Visible)	はい、オプションを選択	Canvas	オブジェクトがX次元に視覚的なスクロールバーを持つかどうかを決定します。
Overflow-Y	Categorical (Hidden,Auto,Visible)	はい、オプションを選択	Canvas	オブジェクトがY次元に視覚的なスクロールバーを持つかどうかを決定します。
Scroll Margin	Numeric	はい、テキストまたは矢印	Canvas	スクロールバーの余白をパーセントで決定します。
Change CSS Properties	CSSコード	はい、チェックボックスとテキストボックス	Canvas	CSSコードを使用してオブジェクトの外観の一部分を変更します。

プレーヤー内のマウスインタラクション

プロパティ名	データ型	修正可能か、方法	フレームタイプ	説明
Selectable	Boolean (true / false)	はい、チェックボックス	Canvas	オブジェクトが実験の実施中に選択/ハイライト可能かどうかを決定します。
Highlight on Select	Boolean (true / false)	はい、チェックボックス	Canvas	選択されたオブジェクトが視覚的に選択されたことを示すかどうかを決定します（例：ボーダーで）。
Draggable	Boolean (true / false)	はい、チェックボックス	Canvas	オブジェクトが実験の実施中にドラッグ可能かどうかを決定します。
Resizable	Boolean (true / false)	はい、チェックボックス	Canvas	オブジェクトが実験の実施中にリサイズ可能かどうかを決定します。
Track Scroll	Boolean (true / false)	はい、チェックボックスおよび有効化された場合は数値（ScrollPositionX, ScrollPositionY）	Canvas	スクロールバーと共に提示されている場合、スクロールを追跡することを可能にします。

画像プロパティ

プロパティ名	データ型	修正可能か、方法	説明
Filename	String	はい、テキストボックス	ファイルの指定された名前。
Select File (Folder Icon)	Function	はい、アイコンをクリック	フォルダーアイコンをクリックすると、既存のファイルを選択するか、新しいファイルをアップロードして選択するためのファイルマネージャーが開きます。
Stimulus Info	String	はい、テキストボックス	実験の実施中に動的な刺激情報を保存するために使用できる修正可能なプロパティ。
Stretch to Fit Bounding Box	Boolean (true / false)	はい、チェックボックス	有効化されると、画像がバウンディングボックスを完全に埋めるように引き伸ばされます。
Bounding Box Fit	Function	はい、アイコンをクリック	「フィット」をクリックすると、バウンディングボックスが画像の寸法に切り取られます。
Auto Fit Bounding Box with Image	Function	はい、チェックボックス	有効化されると、バウンディングボックスが画像に合わせて自動的に変更されます。