テキストセグメンテーションオブジェクト

テキストセグメンテーションオブジェクトは、文を単語ごとの興味領域に分割します。CSVアップロード、既存のデータフレーム、または配列変数をテキストソースとしてリンクし、各試行ごとに1文を指定すると、手動でのAOI配置なしに、各単語に自動的に測定ボックスが割り当てられます。ウェブカメラ視線追跡を有効にすると、各単語について5つの視線メトリクスも記録されます。

テキストセグメンテーションオブジェクトの追加

タスクエディタツールバーで、Textグループを開き、現在のフレームにText Segmentation Objectを追加します。これは、Display Text、Display HTML、およびDisplay Variableとともに配置されます。

テキストグループが開いたLabvancedタスクエディタツールバーとテキストセグメンテーションオブジェクトが強調表示されています。

テキストセグメンテーションセットアップウィザード

オブジェクトを追加すると、2つの画面を持つセットアップウィザードが開きます。最初の画面ではテキストソースを設定し、2番目の画面では行の選択方法と記録内容を尋ねます。

最初の画面: テキストソースを設定します。 3つのオプションのいずれかを選択してください：

テキストセグメンテーションセットアップウィザードの最初の画面で、テキストソースを設定するラジオオプションが表示されています。

オプション	機能
`Upload a CSV file of sentences`	ファイルを新しいデータフレームに解析し、試行ごとに1行を表示します。
`Assign text from a variable`	既存のデータフレームまたは1つの試行の単語を保持する配列とリンクします。
`Do not set the text source`	何もリンクせずウィザードを閉じます；後で`Set Text Source…`をオブジェクトプロパティで設定します。

CSVオプションのファイルを選択すると、Additional Optionsダイアログが開き、デフォルトではすべて未チェックの3つのチェックボックスが表示されます：Map strings to files（ここでは無関係です、セルにはファイル名ではなくプレーンテキストが入っています）、Use first row as header（最初の行が最初の文を保持するのではなく、列の名前を付けている場合のみこのチェックを入れます）、およびTranspose data（文が列にまたがっている場合はこのチェックを入れます）。

2番目の画面: 行インデックスと記録。 この画面はソースがリンクされると開き、Text is read from:の下での確認を行います。データフレームソースの場合、試行ごとに行（文）がどのように選択されるかを尋ねます：

オプション	挙動
`Trial_Id`を行インデックスとして使用	無作為化された順序、実験の無作為化によって決定されます。
`Trial_Nr`を行インデックスとして使用	固定順序、試行のシーケンスと一致します。
変数を行インデックスとして選択	表示される行を制御するためのカスタム変数を使用します。

配列ソースはこの質問を完全にスキップします。なぜなら、配列はすでに1つの試行の単語を直接保持しているからです。次に、何を記録するかを尋ねられます。各チェックボックスが何を作成し、生成されるデータのプレビューについては、イベント統合を参照してください。

テキストセグメンテーションセットアップウィザードの2番目の画面で、行インデックスオプションと記録チェックボックスが表示されています。

チェックボックス	デフォルト	作成される内容
`Record the x, y, width and height of every word on each trial`	チェック済み	各フレームの開始時にAOIジオメトリを書き込むデータフレーム変数とイベント。
`Record eyetracking metrics for every word on each trial`	未チェック	各フレームの終了時に滞在時間、注視数、タイミングを記録するデータフレーム変数とイベント。

注意

Record eyetracking metrics for every word on each trialをチェックすると、全タスクのための注視検出も有効になり、注視がフレームの終了時に終わるように設定されるため、メトリクスが書き込まれる時点で単語に対する最後の注視が完了しています。両方の変更は、このオブジェクトに限らずタスク全体に適用され、ウィザードではオプトインする前にこれが明記されます。

セッティングが完了すると、オブジェクトは各セルに1つの単語を描画し、自動的に記録を開始します：

グリッドレイアウトでのテキストセグメンテーションオブジェクトが、刺激文を1セルごとに単語に分割して表示し、フレーム内で記録テキストセグメントAOIsイベントが表示されています。

グリッドレイアウトで描画された刺激文、1セルごとに1単語。右側のイベントパネルの記録テキストセグメンテーションイベントは、各単語のAOIジオメトリを記録する自動生成されたフレーム開始時のトリガです。

オブジェクトプロパティ

以下のすべての設定は、テキストセグメンテーションオブジェクトが選択されているときにオブジェクトプロパティパネルに表示されます。

プロパティ	説明
`Text Source`	リンクされたCSV、データフレーム、または配列変数。`Set Text Source…`をクリックして再リンクします。
`Row Index`	現在の試行で表示される行（文）を制御する変数。
`Row Index Offset`	行インデックス値に追加されます。行番号はLabvancedでは1ベースなので、デフォルトの-1は最初の試行を最初の行にマッピングします。この値を変更するのは、その行変数が異なるカウント方式で計算されている場合だけです。
`Preview Row`	データフレームソースのみ。編集中にキャンバスに描画される文; 参加者が見るものには影響しません、ランダム化に依存しているためです。
`Recorded Into`	オブジェクトのリンクデータを受け取るデータフレーム変数。
`Split cells on whitespace`	スプレッドシートにすでに各列に1単語が保持されているときは、デフォルトでオフです。各セルのテキストを自動的に別々の単語に分割するには、有効にしてください。
`Layout`	`Flow`は、要素の幅で単語を折り返し、各単語の独自のグリフボックスを記録します。`Grid`は、単語を等幅の列に配置し、全セルを記録するため、AOIは要素にギャップや重なりなくタイルになります。
`Max Rows`	要素が警告を表示するまでに許可される最大数の折り返し行。
`Columns`	グリッドレイアウトのみ。行あたりの単語数。`0`は、`Max Rows`内のテキストにフィットする少ない列を使用します。
`Word Alignment`	グリッドレイアウトのみ。各単語のグリフをセル内で水平および垂直に配置します。記録されたAOIは常に完全なセルであるため、これに影響はありません。
`Gap Between Cells` / `Margin Between Words`	フレーム単位のXおよびY間隔。グリッドレイアウトでは`Gap Between Cells`、フローレイアウトでは`Margin Between Words`とラベル付けされています。
`AOI Padding`	フローレイアウトのみ。各単語の記録されたボックスをそのグリフを超えて成長させ、フレーム単位で各側に拡張します。グリッドレイアウトでは使用できず、ボックスを成長させると次の単語のセルが重なります。
`Font`	描画される単語のフォントファミリー、サイズ、および色。
`Sentence Alignment`	フローレイアウトのみ。要素内の全文の水平および垂直の配置。
`Show AOI boxes in player`	チェックすると、研究中に各単語のAOIボックスを画面に描画します。構築中のカバレッジを確認するのに便利です。
`Stimulus Info`	現在の刺激に関するノートのための自由入力フィールドで、参加者には表示されません。

テキストソースのリンク

CSVからデータフレームへのパスは、既存の刺激セットを持ってくる最も迅速な方法です。これは、セットアップウィザードの最初のステップを通じて行われるか、後でオブジェクトプロパティのSet Text Source…を通じて行われます：1行に1文が含まれるスプレッドシートと、Split cells on whitespaceがオフの場合は1列に1単語がインポートされます。ラグド行長がサポートされており、短い行は測定される単語が少ないだけです。後続の句読点は、文の最後の単語にそのまま接続しているセルのままにすることができます。

既存のデータフレームにリンクする場合も、データフレームがすでに実験内に存在する場合は同様に機能します。これは、同じ刺激セットが複数のオブジェクトに供給される際に便利です。配列変数は、単一文の研究において最もシンプルなオプションであり、データフレームステップを完全にスキップします。

イベント統合

2つの専用アクションがオブジェクトのデータを記録します。どちらもTarget（テキストセグメンテーションオブジェクトを保持するフレーム要素）とVariable（テーブルを受信するデータフレーム）が必要です。これらのアクションは、セットアップウィザードで対応するボックスをチェックすると自動的に作成されます。

アクション	記録する内容	実行タイミング
`Record Text Segment AOIs`	単語、行、および位置/サイズジオメトリ、単語ごとに1行。	通常はフレーム開始時に、描画された単語を再測定し、テーブルが画面上の内容と一致します。
`Record Text Segment Eyetracking Metrics`	滞在時間、合計注視数、合計注視時間、最初の注視までの時間、平均注視時間、単語ごとに1行。	フレームの終了時、フレームの注視が最終的なものであるとき。ウェブカメラ視線追跡が有効である必要があります。

決して注視されなかった単語は、メトリクステーブル内の行を持ち、すべての列にゼロが入ります。空のセルではありません。時間列を平均する前にtotal_fixations > 0でフィルタリングしてください。なぜなら、ゼロは「決して見られなかった」と「フレーム開始時点で正確に注視されていた」を区別しません。

テキストセグメンテーションオブジェクトを使用してウェブカメラ視線追跡を行い、試行間の進行をしましょう。例は、ステップ5: 試行の進行をセットアップするで確認できます。

データプレビュー

以下の画像は、これら2つの自動化されたイベントからキャプチャされたデータを表します。

記録されたテキストセグメンテーションAOIのAOIジオメトリテーブル：各単語のインデックス、テキスト、行、および境界ボックス（x, y, width, height）で、文の単語ごとに1行があります。

記録されたテキストセグメンテーション視線追跡メトリクステーブル：各単語ごとの滞在時間、注視数、タイミングが含まれ、上記のAOIテーブルの同じword_indexで一致します。

テキストセグメンテーションオブジェクト

目次