multimatch 0.1.0

[](https://travis-ci.cn/adswa/multimatch) [](https://codecov.io/gh/adswa/multimatch) [](https://multimatch.readthedocs.io/en/latest/) [](https://badge.fury.io/py/multimatch) [](https://open-source.org.cn/licenses/MIT) [](https://ci.appveyor.com/project/adswa/multimatch)

# multimatch ## MultiMatch工具箱（Dewhurst等人，2012）在Python中的实现。

Jarodzka，Holmqvist和Nyström（2010）提出的MultiMatch方法，在Matlab中作为MultiMatch工具箱实现，并由Dewhurst及其同事（2012）验证，是一种基于向量的、多维度的扫描路径相似度计算方法。

有关此软件的完整概述，请参阅[文档](https://multimatch.readthedocs.io/en/latest)

该方法将扫描路径表示为二维空间中的几何向量：任何扫描路径都是由表示扫视的向量序列组成的，而扫视向量的起始和结束位置代表注视点。在五个维度上比较两个这样的序列（长度可能不同），包括“向量形状”、“向量长度”（扫视幅度）、“向量位置”、“向量方向”和“注视持续时间”，以进行多维相似性评估（所有值均在范围[0, 1]内，其中0表示最大不相似性，1表示在给定度量上具有相同扫描路径）。原始Matlab工具箱由Richard Dewhurst博士通过电子邮件提供，该方法被移植到Python，旨在提供一个开源的Matlab工具箱替代品。

### 安装说明

建议使用专门的虚拟环境

# 创建并进入新的虚拟环境（可选） virtualenv –python=python3 ~/env/multimatch . ~/env/multimatch/bin/activate

multimatch可以通过pip安装。要自动安装multimatch及其所有依赖项，请使用

# 从pyPi安装 pip install multimatch

### 支持/贡献

欢迎提交错误报告、反馈或其他任何贡献。要报告错误、请求功能或提出问题，请打开一个[问题](https://github.com/adswa/multimatch/issues/new）。[拉取请求](https://help.github.com/en/articles/creating-a-pull-request-from-a-fork）始终欢迎。

### 在终端中使用multimatch的示例

所需输入： - 两个包含nx3注视向量的制表符分隔文件（x坐标以像素为单位，y坐标以像素为单位，持续时间）

`` multimatch data/fixvectors/segment_10_sub-19.tsv data/fixvectors/segment_10_sub-01.tsv ``

可选输入： - –screensize: 以像素为单位，提供第一个x和y维度。默认大小为1280 x 720像素

`` multimatch data/fixvectors/segment_10_sub-19.tsv data/fixvectors/segment_10_sub-01.tsv –screensize 1280 720 ``

如果应执行扫描路径简化，请另外指定 - –amplitude-threshold (-am) 以像素为单位 - –direction-threshold (-di) 以度为单位 - –duration-threshold (-du) 以秒为单位

示例使用分组

`` multimatch data/fixvectors/segment_10_sub-19.tsv data/fixvectors/segment_10_sub-01.tsv –direction-threshold 45.0 –duration-threshold 0.3 –amplitude-threshold 147.0 ``

### 参考文献

Dewhurst, R.，Nyström, M.，Jarodzka, H.，Foulsham, T.，Johansson, R. & Holmqvist, K. (2012)。这取决于你如何看待它：使用MultiMatch的多维扫描路径比较，一种基于向量的方法。行为研究方法，44(4)，1079-1100。[doi: 10.3758/s13428-012-0212-2.] (https://doi.org/10.3758/s13428-012-0212-2)

Dijkstra, E. W. (1959)。关于图的两个问题的注释。数值数学，1，269–271。[https://doi.org/10.1007/BF01386390]

Jarodzka, H.，Holmqvist, K.，& Nyström, M. (eds.) (2010)。基于向量的多维扫描路径相似性度量。在第2010年眼动追踪研究与应用研讨会论文集中（第211-218页）。ACM。[doi: 10.1145/1743666.1743718](https://doi.org/10.1145/1743666.1743718)