Skip to content
Fabio Carrara edited this page Feb 3, 2021 · 26 revisions

MEYE tool is a free and open-source tool to perform pupillometry in real-time (or on videos) in different subjects (human and mice) and in different experimental conditions (head-fixation, virtual reality, 2-photon calcium imaging ...). To access MEYE visit the page

pupillometry.it

Wait until the GUI and the CNN model are finished loading. Once loaded, you can also use MEYE offline without any internet connection. MEYE has been tested on up-to-date versions of Microsoft Edge, Mozilla Firefox and Google Chrome.

We describe the tool UI sections and features below.

DEMOS

The demos section contains three buttons to see prerecorded pupillometry files:

INPUT

This section allows to choose a file from the hard disk or enable real-time input videos:

  • Choose File [allows to load a movie from the hard disk] NOTE: files are not uploaded, they will be loaded locally on the browser.
  • Enable Webcam [allows access to a computer webcam. If there is more than one webcam connected to the computer, the browser will ask which webcam to use.]

MODEL

Dropdown menu that allows choosing different models [coming soon...]

ROI

Region Of Interest management section (In the video is the red square):

  • X, Y: the origin of the ROI in pixels. The lower-left corner
  • Size: The size of the ROI in pixels. The ROI must be squared
  • Track Pupil: [This function allows to enable/disable the pupil's tracking. It is designed to keep the pupil in the middle of the ROI. This function enhances performances and allows tracking the eye's movements.]

You can also adjust ROI size, and position using Drag&Drop commands in the video. The bottom right corner is used to resize the ROI. The upper left corner is designed to resize the ROI.

PREDICTIONS

This section allows adjusting the output of MEYE.

  • Periods (ms): allows deferring each frame's processing. This function is generally used to stabilize framerate.
  • Threshold: This value adjusts the sensibility of the predictions. Lower values are more liberal in the prediction, aiming to overestimate the pupil's real size. Higher values tend to produce masks with a more strict criterion and underestimate the real pupil size.
  • Morphology: enables/disables the Mathematical Morphology postprocessing

TRIGGERS

This section allows controlling the input trigger events during recording or streaming videos. Triggers can be accessed through keystroke: Trigger_1 (T), Trigger_2 (Y).

OPTIONS

  • Clear on Resume: enable/disable clear the recorded data when resuming the video.

PLOT

This section contains the real-time data plot.

  • Auto-Update: enable/disable real-time data plot
  • Show only N last samples: enable/disable real-time plot for only the N last samples
  • Smooth Lines: Visual filter of the traces
  • Update Plot: Manual update of the plot

WARNING: The plot auto-update feature can hugely affect the frame rate. We recommend turning off this feature if real-time and/or high-framerate applications are required. Enabling 'Show only X last samples' greatly reduces the impact on framerate.

DATA

Table with a real-time preview of the acquired data.

  • Auto-Update: enable/disable real-time data table
  • Update Table: Manual update of the table
  • Clear Data: Delete all the acquired data
  • Export to CSV: Write data to CSV file

WARNING: The table auto-update feature can partially affect the frame rate. We recommend turning off this feature if real-time and/or high-framerate applications are required.

Clone this wiki locally