PsychoPy中MonitorTools模块的坐标转换问题解析

问题背景

在PsychoPy视觉实验平台中，当用户尝试以厘米(cm)为单位设置窗口视图位置(viewPos)时，系统会抛出类型错误(TypeError)。这个问题源于MonitorTools模块在坐标转换过程中对数据类型处理不当，导致列表(list)与浮点数(float)之间进行了非法运算。

问题根源分析

该问题的核心在于monitorunittools.py模块中的坐标转换函数未能正确处理输入参数的数据类型。具体表现为：

1. 当用户设置viewPos属性时，系统内部会调用convertToPix函数进行单位转换
2. 在_cm2pix函数中，代码直接将两个列表参数相加(pos + vertices)
3. 在Python中，列表相加执行的是连接(concatenation)操作，而非数学意义上的向量加法
4. 最终导致一个四元素列表被传递给cm2pix函数，而该函数期望接收的是数值类型

技术细节

问题的关键代码段位于monitorunittools.py的_cm2pix函数中：

def _cm2pix(pos, vertices, win):
    return cm2pix(pos + vertices, win.monitor)  # 错误的列表相加方式

正确的实现应该先将列表转换为NumPy数组，再进行向量加法：

def _cm2pix(pos, vertices, win):
    return cm2pix(np.array(pos) + np.array(vertices), win.monitor)  # 正确的向量加法

影响范围

这个问题不仅影响_cm2pix函数，还可能波及其他类似的坐标转换函数，包括：

• _deg2pix
• _pix2pix

唯一不受影响的是_degFlat2pix函数，因为它采用了不同的实现方式。

解决方案

要彻底解决这个问题，需要在MonitorTools模块中进行以下改进：

1. 在所有坐标转换函数中明确输入参数的数据类型要求
2. 在函数内部对输入参数进行适当的数据类型转换
3. 使用NumPy数组代替原生Python列表进行数学运算
4. 添加类型检查确保运算安全

临时解决方案

对于急需解决问题的用户，可以尝试以下临时解决方案：

1. 避免直接使用列表作为viewPos参数
2. 在设置viewPos前，手动将坐标转换为NumPy数组
3. 考虑使用其他不会触发此问题的单位系统

总结

PsychoPy作为一个专业的心理学实验构建平台，其坐标系统的精确性至关重要。这个问题的存在提醒我们，在处理科学计算时，必须特别注意数据类型和运算方式的正确性。开发团队已经注意到这个问题，预计会在后续版本中修复。

对于心理学实验研究者而言，了解这类技术细节有助于更好地设计实验和排查问题，确保实验数据的准确性和可靠性。