TurkerGaze 使用指南
项目概述
TurkerGaze 是一个基于网络摄像头的眼动追踪系统,用于通过众包方式收集大规模眼动数据。该项目由普林斯顿视觉团队开发,并在MIT许可下发布。它主要解决传统眼动追踪技术因依赖专业设备而导致的高昂成本和数据收集限制问题。本文档将指导您了解项目结构、启动文件以及配置文件的使用。
1. 项目目录结构及介绍
以下是TurkerGaze项目的主要目录结构及其简介:
/demo
: 包含演示文件,如imglist.json
示例,展示了用于自由观看('gaze')和记忆测试('memory')的图片列表。/scripts
: 可能存放安装或脚本工具,如安装脚本。/src
: 核心源代码所在位置,包含了实现眼动追踪功能的JavaScript文件。bundle.js
: 编译后的JavaScript文件,可能用于浏览器端运行。index.html
: 主入口页面,启动眼动追踪任务的网页。package.json
: Node.js项目配置文件,列出了项目依赖和可执行脚本。visualizer.html
: 数据可视化页面,用来展示收集到的眼动追踪结果。webpack.config.js
: 如果项目使用了Webpack作为构建工具,这个文件用于配置Webpack的编译规则。
2. 项目的启动文件介绍
启动核心:index.html
项目的主要启动点是index.html
文件。这不仅是Web应用的首页,也负责加载必要的JavaScript逻辑来启动眼动追踪任务。要运行此项目,你需要先确保有一个本地Web服务器环境,然后通过访问这个HTML文件开始游戏式的任务。
为了启动服务,可以遵循以下步骤:
- 在项目根目录中,运行安装命令:
npm install
- 接着,启动本地服务器:
npm start
- 访问提示的本地地址,通常类似于
http://localhost:port
,即可开始使用。
3. 项目的配置文件介绍
关键配置文件:imglist.json
虽然项目的核心配置可能直接嵌入在代码或特定脚本中,但提供的一个关键外部配置文件例子是imglist.json
。这个文件不是项目的一部分,但其结构展示了一个如何组织图像列表以供实验使用的示范。它包含两个关键字段:
gaze
: 这部分列出的图片是给参与者自由观看的。memory
: 列出的图片则是用于记忆测试的环节。
这种配置允许研究者定制眼动实验的内容,通过修改这些列表,可以控制参与者将看到哪些刺激图像。
总结, TurkerGaze项目通过简洁的架构设计使得大规模在线眼动数据的收集变得可行。理解并适当地利用上述提到的文件和步骤,就能够顺利部署和运行自己的实验。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考