文本分割对象在 Labvanced 任务编辑器中显示的句子，每个单词周围有一个逐字兴趣区域框

文本分割对象

文本分割对象将一个句子拆分为每个单词的一个兴趣区域。链接 CSV 上传、现有数据框或数组变量作为文本源，每个试验一个句子，且每个单词自动获得自己的测量框，无需手动放置 AOI。启用网络摄像头眼动追踪后，它还记录每个单词的五个注视指标。

内容目录

添加文本分割对象

在任务编辑器工具栏中，打开 Text 组并选择 Text Segmentation Object 以将其添加到当前框架。它与 Display Text、Display HTML 和 Display Variable 并排放置。

Labvanced 任务编辑器工具栏打开文本组并高亮显示文本分割对象

文本分割设置向导

添加对象后会打开一个设置向导，包含两个屏幕：第一个设置文本源，第二个询问如何选择行以及记录什么。

第一个屏幕：设置文本源。 选择以下三种选项之一：

文本分割设置向导的第一个屏幕，显示设置文本源的单选选项

选项操作
Upload a CSV file of sentences将文件解析为新的数据框，每个试验显示一行。
Assign text from a variable链接现有数据框，或持有单个试验单词的数组。
Do not set the text source不链接任何内容而关闭向导；稍后通过 Set Text Source… 在对象属性中进行设置。

为 CSV 选项选择文件时，会打开一个 Additional Options 对话框，带有三个复选框，默认为全部未选中：Map strings to files（在此无关，因为单元格中包含的是纯文本而不是文件名）、Use first row as header（仅当第一行命名列而不是包含第一个句子时选中此项），以及 Transpose data（如果句子跨列而不是按行排列，则选中此项）。

第二个屏幕：行索引和记录。 一旦链接了源，这个屏幕将打开，确认它在 Text is read from: 下。对于数据框源，它还询问每个试验如何选择行（句子）：

选项行为
使用 Trial_Id 作为行索引随机顺序，由实验的随机化决定。
使用 Trial_Nr 作为行索引固定顺序，与试验序列相匹配。
选择一个变量作为行索引使用任何自定义变量来控制显示哪一行。

数组源完全跳过该问题，因为数组已经直接保存了单个试验的单词。然后屏幕询问要记录的内容。有关每个复选框创建的内容和结果数据的预览，请参见 事件集成。

文本分割设置向导的第二个屏幕，显示行索引选项和记录复选框

复选框默认创建内容
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 还会为整个任务启用注视检测，并将注视设置为在帧结束时结束，因此在指标写入时，最后对单词的注视将完成。这两个更改适用于整个任务，而不仅仅是这个对象，向导在您选择之前会说明这一点。

设置完成后，对象将每个单词呈现到一个单元格中并开始自动记录：

文本分割对象在网格布局中显示的刺激句子，每个单元格一个单词，右侧的记录文本分割 AOIs 事件在帧上
一个以网格布局呈现的刺激句子，每个单元格一个单词。右侧事件面板中的 记录文本分割 事件是自动创建的 在帧开始时 触发，记录每个单词的 AOI 几何形状。

对象属性

下面的所有设置在选择文本分割对象时可在 对象属性 面板中找到。

属性描述
Text Source连接的 CSV、数据框或数组变量。单击 Set Text Source… 以重新链接。
Row Index控制当前试验中显示的行（句子）的变量。
Row Index Offset添加到行索引值。行号在 Labvanced 中是从 1 开始的，因此默认值 -1 将第一个试验映射到第一行。仅在您的行变量计数方式不同的情况下更改此项。
Preview Row仅数据框源。在编辑时要在画布上绘制的句子；不影响参与者看到的内容，因为那取决于随机化。
Recorded Into接收对象自己链接数据的数据框变量。
Split cells on whitespace默认情况下关闭，当电子表格中已经每列一个单词时。开启后会自动将每个单元格文本拆分为单独的单词。
LayoutFlow 在元素宽度处换行单词，并记录每个单词的自身字形框。 Grid 将单词放入等宽列中，并记录整个单元格，因此 AOIs 将元素拼接在一起而没有间隙或重叠。
Max Rows元素允许的最大换行行数，在编辑器中显示警告之前。
Columns仅网格布局。每行单词数。 0 使用尽可能少的列以适应文本在 Max Rows 内。
Word Alignment仅网格布局。每个单词字形在其单元格内的水平和垂直对齐。不会改变记录的 AOI，记录的总是整个单元格。
Gap Between Cells / Margin Between WordsX 和 Y 间距，以帧单位表示。在网格布局中标记为 Gap Between Cells，在流布局中标记为 Margin Between Words。
AOI Padding仅流布局。扩展每个单词的记录框，超出其字形，以帧单位表示。网格布局中不可用，因为扩展框会与下一个单词的单元格重叠。
Font渲染单词的字体系列、大小和颜色。
Sentence Alignment仅流布局。整个句子在元素内的水平和垂直对齐。
Show AOI boxes in player选中时，在研究期间在屏幕上绘制每个单词的 AOI 框，便于在构建时检查覆盖情况。
Stimulus Info用于当前刺激的注释的自由文本字段，不向参与者展示。

链接文本源

CSV 转数据框路径是将现有刺激集导入最快的方式，无论是通过设置向导的第一步还是稍后通过 Set Text Source… 在对象属性中进行设置：一张每行一个句子的电子表格，并且关闭 Split cells on whitespace 时，列中每个单词导入时支持不规则行长度，较短的行只是测量较少的单词。尾随标点符号可以作为其自己的单元格附加到句子的最后一个单词。

链接现有数据框的方式相同，前提是数据框已存在于实验中，实用于同一刺激集提供多个对象。当需要进行单句研究时，数组变量是最简单的选项，因为它完全跳过数据框步骤。

事件集成

两个专用操作记录对象的数据。两者都需要一个 Target（持有文本分割对象的框架元素）和一个 Variable（接收表格的数据框）。如果在设置向导中选中相应的框，将自动创建这两个操作。

操作记录内容何时触发
Record Text Segment AOIs单词、行和位置/尺寸几何形状，每个单词一行。通常在帧开始时，重新测量显示的单词，以便表格与屏幕上显示的内容匹配。
Record Text Segment Eyetracking Metrics停留时间、总注视次数、总注视持续时间、首次注视时间和平均注视持续时间，每个单词一行。在帧结束时，一旦帧的注视是最终的。需要启用网络摄像头眼动追踪。

从未注视过的单词在指标表中保留其行，所有列中的值为零，而不是空单元格。在对时间列进行平均处理之前，在 total_fixations > 0 上过滤，因为零并不能区分“从未看过”和“恰好在帧开始时注视过”。

使用文本分割对象及网络摄像头眼动追踪的阅读研究周围添加的事件示例，以及在试验之间进行进展的过程，详见同行随附的逐步操作指南的 步骤 5：设置试验进展。

数据预览

以下图像表示通过这两个自动事件捕获的数据。

通过记录文本分割 AOIs 记录的 AOI 几何数据框，每个单词一行
来自 记录文本分割 AOIs 的 AOI 几何表：每个单词的索引、文本、行和边界框（x、y、width、height），每个单词一行。
通过记录文本分割眼动追踪指标记录的眼动追踪指标数据框，每个单词一行
来自 记录文本分割眼动追踪指标 的眼动追踪指标表：每个单词的停留时间、注视计数和时序，与上面的 AOI 表通过相同的 word_index 匹配。

开放材料和研究示例

自定进度阅读研究（文本分割对象 - 演示）

在真实研究中查看文本分割对象：十个句子，每个试验一个，逐字兴趣区域和眼动追踪指标自动记录。

进一步阅读

文本分割技术概述页

文本分割技术

能力概述：机制、数据输出和研究用例。

使用文本分割对象构建阅读研究的逐步演示

构建阅读研究

一个真实的词频阅读研究，逐步使用该对象构建。

所有对象

Labvanced 实验编辑器中所有可用对象的完整索引。