Schwartz Shawn T, Yang Haopei, Xue Alice M, He Mingjian
Stanford University, Stanford, United States.
Stanford Memory Laboratory, Stanford, United States.
bioRxiv. 2025 Jun 3:2025.06.01.657312. doi: 10.1101/2025.06.01.657312.
Pupillometry provides a non-invasive window into the mind and brain, particularly as a psychophysiological readout of autonomic and cognitive processes like arousal, attention, stress, and emotional states. Pupillometry research lacks a robust, standardized framework for data preprocessing, whereas in functional magnetic resonance imaging and electroencephalography, researchers have converged on tools such as fMRIPrep, EEGLAB and MNE-Python; these tools are considered the gold standard in the field. Many established pupillometry preprocessing packages and workflows fall short of serving the goal of enhancing reproducibility, especially since most existing solutions lack designs based on Findability, Accessibility, Interoperability, and Reusability (FAIR) principles. To promote FAIR and open science practices for pupillometry research, we developed eyeris, a complete pupillometry preprocessing suite designed to be intuitive, modular, performant, and extensible (https://github.com/shawntz/eyeris). Out-of-the-box, eyeris provides a recommended preprocessing workflow and considers signal processing best practices for tonic and phasic pupillometry. Moreover, eyeris further enables open and reproducible science workflows, as well as quality control workflows by following a well-established file management schema and generating interactive output reports for both record keeping/sharing and quality assurance of preprocessed pupil data prior to formal analysis. Taken together, eyeris provides a robust all-in-one transparent and adaptive solution for high-fidelity pupillometry preprocessing with the aim of further improving reproducibility in pupillometry research.
瞳孔测量术为了解大脑和心智提供了一个非侵入性窗口,特别是作为自主神经和认知过程(如唤醒、注意力、压力和情绪状态)的心理生理读数。瞳孔测量术研究缺乏一个强大的、标准化的数据预处理框架,而在功能磁共振成像和脑电图领域,研究人员已经在诸如fMRIPrep、EEGLAB和MNE-Python等工具上达成了共识;这些工具被认为是该领域的黄金标准。许多已有的瞳孔测量术预处理软件包和工作流程未能达到提高可重复性的目标,特别是因为大多数现有解决方案缺乏基于可查找性、可访问性、互操作性和可重用性(FAIR)原则的设计。为了促进瞳孔测量术研究的FAIR和开放科学实践,我们开发了eyeris,这是一个完整的瞳孔测量术预处理套件,旨在直观、模块化、高效且可扩展(https://github.com/shawntz/eyeris)。开箱即用,eyeris提供了一个推荐的预处理工作流程,并考虑了静态和动态瞳孔测量术的信号处理最佳实践。此外,eyeris通过遵循完善的文件管理模式并生成交互式输出报告,进一步实现了开放和可重复的科学工作流程以及质量控制工作流程,用于记录保存/共享以及在正式分析之前对预处理后的瞳孔数据进行质量保证。总之,eyeris为高保真瞳孔测量术预处理提供了一个强大的一体化透明且自适应的解决方案,旨在进一步提高瞳孔测量术研究的可重复性。