EyeLink眼动仪分析软件Dataviewer的常见问题

DV hands on

Posted by 陈锐CR on November 7, 2021 | 阅读

EyeLink眼动仪分析软件Dataviewer的常见问题

本文首发在个人博客上(7988888.xyz),此文章中所有链接均通过博客进行访问。

本文内容来源:EyeLink英文支持论坛,本文翻译仅做参考使用。

如何过滤眨眼事件?

It is important to keep in mind that due to the nature of the EyeLink’s parsing algorithm, blinks are always embedded within a saccade. There are several options related to blinks and their associated saccades in the Data Viewer preferences (Preferences tab in the Inspector window -> Data Filters). Some of the setting are Event related and others are Sample related.

EyeLink 解析眼动事件算法的过程中,有些眨眼是嵌入在扫视中的。在DataViewer软件首选项中有几个与眨眼及与扫视相关的选项。一些设置与眼动事件相关,一些设置与采样数据相关。

image-20210727101421937

The Event related properties are:

与眼动事件相关的属性是:

  • Display Blink Saccades - This property will display any saccade event that contains a blink entirely as a blink instead of a saccade leading into and out of a blink.- 此属性将显示整个眨眼事件而不是进入和离开眨眼的扫视事件。
  • Remove Fixation Immediately Before Blink - This property will allow for the exclusion of the fixation before a blink occurs。-此属性勾选是在眨眼发生之前排除注视
  • Remove Fixation Immediately After Blink - This property will allow for the exclusion of the fixation after a blink occurs。-此属性勾选是在发生眨眼后排除注视

These settings can be helpful in selectively excluding unwanted event data surrounding a blink. However if dealing with a larger amount sample data consider these settings as well.

这些设置有助于有选择地排除眨眼周围不需要的事件数据。但是,如果处理大量采样数据,请考虑以下这些设置。

  • Duration to Exclude Before Blink Saccades - This property will exclude the samples prior to the blink event for the specified duration。-此属性是在指定持续时间内排除眨眼事件之前的采样点
  • Duration to Exclude After Blink Saccades - This property will exclude the samples after to the blink event for the specified duration。-此属性是在指定持续时间内排除眨眼事件后的采样点
  • Apply Blink Correction in the Sample Report - This property will mark the excluded samples from the properties above as being IN_BLINK = TRUE in the same report。-此属性会将上述属性中排除的采样点标记为 IN_BLINK = TRUE 的报告中

2.How can I add messages in Data Viewer

如何在DataViewer软件中添加message?

You can add messages in Data Viewer at any point by right clicking anywhere within the Trial View window and selecting the “Add Message” option.

您可以在Trial View窗口下在任意位置通过右键单击“Add Message”选项,在数据中添加消息。

image-20210727105519613

image-20210727105558683

This gives the option to add a new message in either trial relative time, Interest Period relative time, or EDF relative time. If the event time of the message is known, a message can easily be inserted as needed.

这个选项提供了Trial相对时间、兴趣期相对时间或 EDF 相对时间中添加新的message。如果您已经知道实验中的message事件的时间,则可以根据需要插入新的message。

If you have a large number of messages to add, you can use Data Viewer’s Message List feature to add multiple messages at once, on a participant-by-participant basis. Simply right click on the participant in the Inspector window and select Import Message List to select the formatted file containing the imported messages. See the Data Viewer manual (Help Menu -> Contents -> Working with Events, Samples, and Interest Areas -> Messages) to find information about how to format the import message list file.

如果需要添加大量messages,则可以使用Data Viewer软件中的消息列表功能一次添加多条消息。选择需要的数据文件名右键就可以看到-Import Message List。此message需要按照指定的格式进行编写,当然前提是需要知道时间节点。

image-20210727105715817

image-20210727134310611

3.How can I reparse my data with different event parsing parameters?

如何使用不同的事件解析参数重新解析我的数据?

To automatically reparse data for individual trials, subjects, groups, or even the entire viewing session simply right click on the relevant trial or grouping node in the Inspector window and select the “Reparse Eye Events” option. This will reparse the selected item by the current settings defined in the relevant reparsing preferences (Preferences tab in the Inspector window -> Output/Analysis -> Event Reparsing). The preference settings will allow for the data to be parsed by either using EyeLink’s Standard, or High Sensitivity parser, or any custom setting using the provided parameters. Please see Section 5.1 of the Data Viewer User Manual on Event Parsing for more details.

要重新分析单个试次、受试者、组甚至整个查看会话中的数据,只需右键单击事件窗口中的相关试次或分组节点,然后选择“Reparse Eye Events”选项。首选项设置将允许使用 EyeLink 的标准或高灵敏度解析器或使用提供的参数的任何自定义设置来解析数据。有关更多详细信息,请参阅Data Viewer用户手册中有关事件解析的第 5.1 节

image-20210727105903124

Alternatively, reparsing can be done manually by re-categorizing events in the Temporal Graph view of the Trial View window by using the “Add / Edit Event Mode”

也可以通过使用“添加/编辑事件模式”在“Trial View”窗口的“时间图”视图中重新分类事件来手动完成重新解析

4.How can I manually create / edit events?

如何手动创建/编辑事件?

The “Add / Edit Events Mode” feature in the Temporal Graph view toolbar will allow for manual marking or editing of events.

时间图视图工具栏中的“添加/编辑事件模式”功能允许手动标记或编辑事件。

image-20210727110145036

When this mode is enabled, click and drag within the Temporal Graph view will generate or modify events. Note that it can be useful to toggle the visibility of samples to allow for visualization of the velocity, acceleration, pupil size, and the gaze traces to judge where the start and end these events. Similarly, the “Sample Info” tool can be enabled to visualize raw data corresponding to the current time point where the mouse is hovering over.

启用此模式后,在 Temporal Graph 视图中单击并拖动将生成或修改事件。请注意,切换采样信息的可见性以允许可视化速度、加速度、瞳孔大小和凝视轨迹以判断这些事件的开始和结束位置非常有用。同样,可以启用“Sample Info”工具来可视化与鼠标悬停在当前时间点相对应的原始数据。

5、完成数据收集后,如何添加/编辑试次变量?

在大多数实验情况下,试次的变量均由实验程序自动发送到数据结果文件中,但是在某些情况下,可能会存在遗漏或后期想要重新分组试次类型的情况,因此需要设置新的试次变量类型,那么在DV中如何操作呢?

操作方法:

可以通过试次变量值管理器(Analysis—Trial Variable Manager)创建新的试次变量。

image-20210727142130017

创建了新的试次变量,就可以通过手动输入数据或通过复制粘贴到“试验变量值”中来编辑试次变量(label),Analysis—Trial Variable Value Editor。

image-20210727142113512

6、为什么在“Trial Report”或“Sample Report”中看不到任何瞳孔大小数据?

默认情况下,较早版本的Data Viewer不会从EDF文件中加载Sample采样点数据,因此,在Trial 或 Sample Report中可能会缺少瞳孔大小数据。

解决方法:确保在Preference中的Data Loading——Load Sample是勾选上的。

image-20210727142055542

最后,重新加载所有数据文件。

7、从原始数据收集位置移动数据时,如何移动我的数据?

如果要将数据从一台计算机移动到另一台计算机进行数据分析,则最好将整个实验项目文件夹从一个位置复制到另一位置,而不是仅移动EDF文件。原因在于EDF不包含任何数据分析时所需的背景图像/视频,兴趣区域集或任何其它补充文件(因此会存在黑屏情况)。因此,为了正确加载数据,需要移动整个项目文件夹,以便Data Viewer可以将它们用于可视化和其它功能。

另一种方法是将所有EDF文件导入单个Data Viewer查看会话,然后可以将其保存和打包(File—package)。它将创建一个DVZ文件,可以轻松地将其传输到另一个位置,DVZ文件将包含所需依赖项文件。

对于某些领域的研究,有时候会删除或者是合并某些注视点的数据,这就需要相应的方法和规则来进行计算。

Data Viewer软件提供两种注视数据清洗方法:
一、Fixation Filter preferences 注视过滤偏好

image-20210727141950764

在DV的Preference选择中可以点击Data Filters即可查看它的属性框,您可以通过“Merge Nearby Fixations”、“Fixation Merging Amplitude Threshold”和“Fixation Duration Threshold”等的数据过滤器参数设置过滤掉小的注视点数据。如果勾选Merge Nearby Fixations选项,当注视时间短于Fixation Duration Threshold的参数设置时,邻近的注视在Fixation Merging Amplitude Threshold所设定的距离范围内,便会与邻近的注视合并一起。

Merge Nearby Fixations:如果选中,邻近的注视点数据将被合并。合并的前提是注视的持续时间必须小于注视持续时间阈值,并且必须在目标注视的1 ° 之内。这些默认阈值在“Fixation Merging Amplitude Threshold”和“Fixation Duration Threshold”字段中设置。如果不选择“Merge Nearby Fixations”,但设置了注视持续时间阈值,则低于阈值的注视将被隐藏而不是合并。***注意: 注视合并不能被撤消,请在应用此选项之前为数据备份。

Fixation Merging Amplitude Threshold:设置注视合并的振幅阈值,默认值为1.0 °

Fixation Duration Threshold:设置注视合并或隐藏的持续时间阈值。

更多参数设置,可参考手册4.1.1版本以上的8.6 Data Filters Preferences章节

二、Four-stage Fixation Cleaning 四阶段注视清洗

请注意,此选项在大多数情况下只有在阅读领域的研究中可以使用到,并不适合所有的研究领域。

对于一些阅读研究,您可能想要应用更精确的注视清洗算法。 比如,删除注视时间过短或过长的注视数据,或者是不在文字兴趣区内数据,亦或者是合并某些相邻的注视点数据。

如何操作?

当我们导入数据后,在需要的节点上通过右键即可看到Perform 4-stage Fixation Cleaning选项,通常情况下,我们会对所有被试的数据进行统一操作,因此,我们需要在Inspector属性窗中的最上面的总节点(.evs)上右键选择该选项(如下图)

image-20210727141825444

弹出以下对话框:

image-20210727141840756

点击“?”即可查看对应的设置标准。

image-20210727141856609

接下来,我们谈谈四阶段的含义和默认设置。

STAGE 1:Within each interest area (typically a word in reading studies), Data Viewer checks whether each fixation’s duration is shorter or equal to the Stage 1 Duration Threshold. For those short fixations, the software further checks the duration and distance of the fixations immediately before and after the current fixation. The fixation will be merged to one of its neighboring fixations if the neighbour’s duration is longer than the threshold value and its distance along the x-axis (in degrees) from the current fixation is shorter or equal to the Stage 1 Distance Threshold. If both the previous and next fixations meet the above criteria, the current fixation will be merged to the longer of the two. Uncheck the “Stage 1” box to skip this stage.

第一阶段:在每个兴趣区域(通常是阅读研究中的一个单词) ,Data Viewer会检查每个注视的持续时间是否小于或等于第一阶段持续时间阈值(默认参数是40ms)。如果该注视点没有超过设置的时间阈值,软件会进一步检查当前注视之前和之后注视的持续时间和距离阈值。

如果相邻注视点的持续时间大于时间阈值,且其与当前注视点的 x 轴距离(以度为单位)小于或等于第一阶段距离阈值,则注视点将与其相邻注视点合并。如果前一个和后一个注视都符合上述标准,当前的注视将合并到两个之中时间更长的注视点。取消选中“阶段1”框跳过这个阶段

STAGE 2:This stage is similar to STAGE 1 except that different fixation Duration and Distance Threshold values are used. For this stage to be effective, a shorter duration and a larger distance threshold should be used compared to Stage 1. Uncheck the “Stage 2” box to skip this stage.

第二阶段:这个阶段类似于 STAGE 1,只是使用了不同的注视持续时间和距离阈值。为了使这一阶段有效,与第一阶段相比,应该使用更短的持续时间和更大的距离阈值。取消选中“阶段2”框跳过这个阶段

STAGE 3:Data Viewer searches for interest areas that include at least three fixations shorter than the Stage 3 Duration Threshold value and no fixations longer than the Duration Threshold. In such cases the shorter fixations are merged into a single fixation. Uncheck the “Stage 3” box to skip this stage.

第三阶段:Data Viewer软件搜索兴趣区域,包括至少三个注视时间不超过第三阶段持续时间阈值的注视区域。在这种情况下,将较短的注视合并成一个注视。取消选中“阶段3”框跳过这个阶段

STAGE 4:Data Viewer deletes every fixation shorter than or equal to the Stage 4 Minimum Duration threshold, or longer than or equal to the Stage 4 Maximum Duration threshold. Uncheck the “Stage 4” box to skip this stage.

第四阶段:Data Viewer删除每个小于或等于第四阶段最小的持续时间阈值(默认140ms),或大于或等于第四阶段最大的持续时间阈值的注视(默认800ms)。取消选中“阶段4”框跳过这个阶段

If the “Delete Fixations Outside Interest Areas” box is checked, this will remove all fixations falling outside of any interest area.

如果选中“Delete Fixations Outside Interest Areas”框,将删除任何兴趣区域之外的所有注视点

请注意: 如果没有定义兴趣区域,选中此选项将导致所有的注视点被删除。

当确定好以上参数设置后,点击Start会弹出以下对话框,操作是不可逆的。(请注意备份数据)

image-20210727141916211

当数据操作完成,即可才保存的.evs平台下output文件夹下找到相对应的文档cleaning.txt

image-20210727141931414

一张图读懂 “陈锐星球”

微信 公众号 B站 知乎 CSDN


谢谢大家观看,如有帮助,来个喜欢或者关注吧!


本文作者:陈锐

博客地址 : 陈锐博客
知乎地址 : 知乎专栏
B站地址 : B站主页
书店地址 : 书店主页
简书地址 : 简书主页
CSDN地址 : csdn主页


版权声明:本文由 陈锐CR 在 2021年11月07日发表。本博客文章作者为陈锐CR时均采用属于个人原创撰写,未经许可,禁止在任何媒介以任何形式复制、发行本文章,如需转载,请查看About联系方式,非商业转载请注明出处,不得用于商业目的。
文章题目及链接:《EyeLink眼动仪分析软件Dataviewer的常见问题》



☛您的打赏是我创作的动力☚


  相关文章:

「游客及非Github用户留言」:

%
UP
博客已运行