PupilEXT开源项目使用与部署教程

PupilEXT开源项目使用与部署教程

Open-PupilEXT Official implementation of a free pupillometry platform called PupilEXT proposed in the article "PupilEXT: flexible open-source platform for high resolution pupillometry in vision research". 项目地址: https://gitcode.com/gh_mirrors/op/Open-PupilEXT

1. 项目介绍

PupilEXT 是一个灵活的开源高分辨率瞳孔测量平台，适用于视觉研究。它能够实时记录并分析眼睛图像，以测量瞳孔直径。该平台支持立体摄像头和单摄像头设置，并且可以处理外部记录的图像进行离线分析。PupilEXT 集成了多种领先的开源瞳孔检测算法，并提供了专业的图形用户界面。

2. 项目快速启动

以下是快速启动 PupilEXT 的步骤：

首先，确保你的系统安装了以下依赖项：

• CMake
• Qt 5.15
• Pylon Camera Software Suite（来自 Basler）

然后，克隆项目到本地：

git clone https://github.com/openPupil/Open-PupilEXT.git
cd Open-PupilEXT

接下来，使用 CMake 构建项目：

mkdir build
cd build
cmake ..
make

编译完成后，你可以运行 PupilEXT：

./PupilExt

3. 应用案例和最佳实践

3.1 立体摄像头设置

• 使用两个 Basler acA2040-120um USB3 摄像头
• 配备 KOWA LM50JC3M2 2/3" C-Mount 镜头和 Schneider IF 092 SH 27.0 滤镜
• 连接 STM32 Nucleo F767ZI 或类似硬件触发器
• 推荐使用 IR-照明

3.2 单摄像头设置

• 使用一个 Basler acA2040-120um USB3 摄像头
• 配备 KOWA LM50JC3M2 2/3" C-Mount 镜头和 Schneider IF 092 SH 27.0 红外和近红外彩色滤镜
• 可选连接 STM32 Nucleo F767ZI 或类似硬件触发器
• 推荐使用 IR-照明

3.3 离线分析

• 使用外部记录的图像进行离线分析时，无需摄像头硬件
• 确保安装了 Pylon Camera Software Suite

4. 典型生态项目

PupilEXT 的开源生态系统中，有几个项目值得注意：

• PyPupilEXT：PupilEXT 的 Python 版本，适用于需要脚本化或自动化瞳孔测量流程的用户。
• Pylon：Basler 摄像头的官方软件套件，用于与 USB3 摄像头通信。

确保在实施这些项目时，遵循各自的官方文档和最佳实践指南。

Open-PupilEXT Official implementation of a free pupillometry platform called PupilEXT proposed in the article "PupilEXT: flexible open-source platform for high resolution pupillometry in vision research". 项目地址: https://gitcode.com/gh_mirrors/op/Open-PupilEXT