HERMES - PupilLabs Core

Support package to interface the Pupil Labs Core commercial smartglasses in HERMES.

Options

core

Obtains all data generated by the OEM Pupil Capture application, i.e. video, gaze, blinks, fixations, etc.

Pros

• Simple out-of-the-box install
• Visual configuration in the OEM GUI
• Network API through ZeroMQ to other LAN devices

Cons

• Lower video frame rate
• Heavy resource utilization for constrained devices (w/ or w/o GUI)
• More difficult to add custom realtime gaze processing
• Reprocessing gaze data in setups with poor realtime results with OEM algorithms (because of occlusions, reflections, shape face) don't guarantee better results on lossy videos

uvc

Interfaces cameras directly using pyuvc. Follow these instructions on Windows to update the USB driver of the device to work as expected.

Pros

• Full stable frame rate
• Safe against accidental cable disconnection (just plug back in)
• Low resource utilization
• Cross-platform
• Constrained device friendly
• Flexibility to add own realtime algorithms

Cons

• Doesn't provide out-of-the-box GUI for camera lighting settings
• Requires custom realtime algorithms if gaze data is desired

Installation

Both options available under the same namespace hermes.pupillabs package upon installation, as PupilCoreProducer or PupilUvcProducer, respectively.

From PyPI

pip install pysio-hermes-pupillabs

From source

git clone https://github.com/maximyudayev/hermes-pupillabs.git
pip install -e hermes-pupillabs

Usage

Using the device follows the standard configuration file specification process of HERMES nodes.

Citation

When using any parts of this repository outside of its intended use, please cite the parent project HERMES.