Ilab logo

MarkEye - Software for automatic marking and display of eye movement traces

This software was developed to address issues in the automatic classification of human and monkey eye movements into saccades, fixations, blinks and smooth pursuits.  MarkEye automatically marks,displays and gives summary statistics about eye movements.  It has been successfully used with both video based eye trackers and magnetic search coil setups.  Inputs, outputs and blink detection are somewhat tailored for our data sources and model of visual attention , but it has also been used successfully in other setups with little or no alteration.  MarkEye is written completely in MATLAB 7.0 and requires the Signal Processing Toolbox.  The command line version has been verified with other versions such as MATLAB 6.5.  

Algorithm 

The basic algorithm is quite simple, but there are some parameters and some additional heuristics that may be tuned or turned off if desired.  See parseinputs.m for a complete list of command line parameters.  

The basic data flow is as follows:
-Look for missing data and blinks
-Low-pass filter and take instantaneous velocity.  
-Low-pass filter and in a sliding window calculate the ratio of the eigenvalues of the x-y eye data.  
-Use a combination of local velocity and ratio of principle axis to determine smooth pursuit, fixation or saccade
-combine pro-saccades into single saccades (optional)
-apply several heuristics such as remove saccades less than xxx degrees and remark events with too short of time based on the events that came before and after.
-display eye trace and summary plots (optional)

Usage

Please see the readme.txt in the main source folder.

Download

The latest source is available for download using SVN.  Please e-mail David J Berg to request access to the source tree.  The software is published under the GNU public licence.  

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.






[Home] - [Research] - [Publications] - [People] - [Facilities] - [Classes] - [Opportunities] - [Events]


Copyright © 2005 by the University of Southern California, iLab and Prof. Laurent Itti