多维扫描路径比较
multimatch-gaze的Python项目详细描述
#多重对视 ##在python中重新实现multimatch工具箱(Dewhurst等人,2012)。
Jarodzka、Holmqvist和Nystróm(2010)提出的多匹配方法, 在Matlab中作为多匹配工具箱实现并由Dewhurst验证 和同事(2012)是一个基于向量的多维方法 计算扫描路径相似性。
有关此软件的完整概述,请查看 [文档](https://multimatch.readthedocs.io/en/latest" rel="nofollow">https://multimatch.readthedocs.io/en/latest)
该方法将二维扫描路径表示为几何矢量 空间:任何扫描路径都是由向量序列构成的,其中向量 表示眼跳,眼跳向量的开始和结束位置表示 固定。两个这样的序列(长度可能不同)在 五维"矢量形状","矢量长度"(囊状振幅) 对于 多维相似性评估(均在[0,1]范围内,0表示 最大相异性和1表示给定度量上的相同扫描路径)。 原始的Matlab工具箱 由Richard Dewhurst博士通过电子邮件提供,并将该方法移植到Python中 目的是为Matlab工具箱提供一个开源的替代方案。
###安装说明
建议使用专用的virtualenv:
< Buff行情> #创建并输入新的虚拟环境(可选) virtualenv–python=python3~/env/multimatch . ~/env/multimatch/bin/activate多重匹配凝视可以通过pip安装。自动安装所有 依赖关系([pandas](https://pandas.pydata.org/),[numpy](https://www.numpy.org/,以及 [argparse](https://docs.python.org/3/library/argparse.html" rel="nofollow">https://docs.python.org/3/library/argparse.html),使用:
< Buff行情> #从pypi安装 pip安装multimatch gaze###支持/贡献
错误报告、反馈或任何其他贡献都是值得赞赏的。 若要报告错误、请求功能或询问问题,请打开 [问题](https://github.com/adswa/multimatch_-gaze/issues/new" rel="nofollow">https://github.com/adswa/multimatch_-gaze/issues/new)。 [拉取请求](https://help.github.com/en/articles/creating-a-pull-request-from-a-fork) 总是受欢迎的。为了在本地运行多匹配凝视的测试套件, 使用[pytest](https://docs.pytest.org/en/latest/),并在 存储库的根目录:
python-mpytest-s-v
有关如何贡献的其他信息,请签出 [投稿.md](https://github.com/adswa/multimatch_-gaze/blob/master/contribution.md)。
###终端中多重匹配凝视的示例用法
所需输入: -带Nx3固定向量的两个标签分隔文件(X坐标在PX中,Y坐标在PX中,持续时间) -屏幕大小(x尺寸,y尺寸)
``多匹配凝视数据/固定向量/段10-SUB-19.tsv数据/固定向量/段10-SUB-01.tsv 1280 720``
可选输入:
如果需要简化扫描路径,请另外指定 -–px中的振幅阈值(-am) -–方向阈值(-di)(度) -–以秒为单位的持续时间阈值(-du)
分组使用示例:
``多匹配凝视数据/固定向量/段10-19.tsv 数据/固定向量/段_10_Sub-01.tsv 1280 720–方向阈值45.0 –持续时间阈值0.3–振幅阈值147.0``
删除AV帮助程序:
由[remodnav]生成的眼球运动事件检测结果(https://github.com/psychoinformatics de/remodnav) 可以通过多重匹配凝视阅读。要指示数据文件是remodnav输出,请提供 --remodnav参数。
``多匹配凝视数据/remodnav_samples/sub-01_task-movie_run-1_events.tsv data/remodnav_samples/sub-01_task-movie_run-2_events.tsv 1280 720–remodnav``
remodnav可以对平滑的追踪动作进行分类。因此,当使用remodnav输出时,用户需要 说明应如何处理这些事件。默认情况下,多重匹配凝视将放弃追求。在一些 然而,在某些情况下,包含追击信息是有用的。例如,移动刺激会 在视觉摄取过程中唤起追击动作。当指定--pursuitkeep参数时,start 扫描路径中将包括追踪的终点。
``多匹配凝视数据/remodnav_samples/sub-01_task-movie_run-1_events.tsv data/remodnav_samples/sub-01_task-movie_run-2_events.tsv 1280 720–remodnav–pursuit keep``
###参考文献:
Dewhurst,R.,Nystróm,M.,Jarodzka,H.,Foulsham,T.,Johansson,R.&; Holmqvist,K.(2012年)。这取决于你如何看待它:扫描路径比较 多维多重匹配,一种基于向量的方法。行为研究 方法,44(4),1079-1100。[doi:10.3758/s13428-012-0212-2.](https://doi.org/10.3758/s13428-012-0212-2)
Dijkstra,E.W.(1959年)。关于与图有关的两个问题的注记。 数学数学,1269-271.[https://doi.org/10.1007/bf01386390"(https://doi.org/10.1007/bf01386390)
Jarodzka,H.,Holmqvist,K.,和Nystróm,M.(编辑)(2010年)。基于向量的, 多维扫描路径相似性度量。在2010年的诉讼中 眼跟踪研究与应用研讨会(第211-218页)。ACM。 [DOI:10.1145/1743666.1743718](https://doi.org/10.1145/1743666.1743718" rel="nofollow">https://doi.org/10.1145/1743666.1743718)