
文本分割对象
文本分割对象将句子拆分为每个单词一个感兴趣区域。链接一个CSV上传、一个现有的数据框或一个数组变量作为文本源,每次试验一个句子,每个单词自动获得自己的测量框,无需手动AOI放置。启用网络摄像头眼动追踪时,它还记录每个单词的五个注视指标。
添加文本分割对象
在任务编辑器工具栏中,打开Text组并选择Text Segmentation Object将其添加到当前帧中。它与Display Text、Display HTML和Display Variable并排放置。

文本分割设置向导
添加该对象会打开一个包含两个屏幕的设置向导:第一个设置文本源,第二个询问如何选择行以及记录什么。
第一屏:设置文本源。 选择以下三种选项之一:

| 选项 | 功能 |
|---|---|
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还会为整个任务启用注视检测,并将注视设置为在帧结束时结束,因此在度量写入时,单词上的最后注视会完整。此更改适用于整个任务,而不仅限于此对象,并且向导在你选择时会说明这一点。
设置完成后,该对象每个单元格显示一个单词并自动开始记录:

对象属性
以下所有设置均在选择文本分割对象时,在对象属性面板中找到。
| 属性 | 描述 |
|---|---|
Text Source | 链接的CSV、数据框或数组变量。点击Set Text Source…进行重新链接。 |
Row Index | 控制当前试验显示哪一行(句子)的变量。 |
Row Index Offset | 添加到行索引值。Labvanced中的行编号是从1开始的,因此默认值-1将第一个试验映射到第一行。仅在您的行变量计数方式不同的情况下更改此项。 |
Preview Row | 数据框源专用。在编辑时在画布上绘制的句子;不会影响参与者所见,因为那取决于随机化。 |
Recorded Into | 接收对象自己的链接数据的数据框变量。 |
Split cells on whitespace | 当电子表格中已经每列一个单词时默认关闭。开启此选项以自动将每个单元格的文本拆分为单独的单词。 |
Layout | Flow在元素宽度处换行,并记录每个单词自己的字形框。Grid将单词放入等宽列中并记录整个单元格,因此AOIs填充元素而没有间隙或重叠。 |
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…在对象属性中进行设置:一份每行一个句子的电子表格,且在Split cells on whitespace关闭的情况下,每列一个单词,以支持不规则的行长度,较短的行仅测量较少的单词。尾随的标点符号可以保持附加在句子的最后一个单词上,作为自己的单元格。
链接现有的数据框的方式相同,一旦数据框已经存在于实验中,这在需要相同的刺激集为多个对象提供数据时很有用。数组变量是单句研究的最简单选项,因为它完全跳过数据框步骤。
事件集成
两个专用操作记录对象的数据。两者都需要一个Target(持有文本分割对象的帧元素)和一个Variable(接收表格的数据框)。如果在设置向导中勾选相应的框,这两个操作会自动创建。
| 操作 | 记录内容 | 触发时机 |
|---|---|---|
Record Text Segment AOIs | 单词、行和位置/大小几何,每个单词一行。 | 通常在帧开始时,重新测量渲染的单词,以便表格与屏幕上显示的内容匹配。 |
Record Text Segment Eyetracking Metrics | 停留时间、注视总数、总注视持续时间、首次注视时间和平均注视持续时间,每个单词一行。 | 在帧结束时,一旦帧的注视确定。需要启用网络摄像头眼动追踪。 |
一个从未被注视的单词在指标表中仍然保留其行,所有列为零,而不是空单元格。对total_fixations > 0进行过滤后再对时间列取平均,因为零并不能区分“从未看过”和“在帧开始时注视”。
使用文本分割对象和网络摄像头眼动追踪完成阅读研究的一系列事件示例,可以在步骤5:设置试验进展的配套教程中查看。
数据预览
以下图像表示从这两个自动事件中捕获的数据。

开放材料和研究示例
在真实研究中查看文本分割对象:十个句子,每次试验一个,自动记录每个单词的AOI几何和眼动追踪指标。
本研究的完整任务设置、记录的变量和研究应用在自我节奏阅读任务页面中进行了描述。