Introduction

This toolbox is meant to be both simple and powerful by creating a GUI interface that allows you to interact with your data visually inside the MATLAB environment. On top of being able to manipulate your data with any of the built-in MATLAB functions, there are custom functions included in iEye designed specifically for analyzing and visualizing eye-movement data. However, there is nothing preventing this toolbox from being used for data beyond eye-movements. In fact, our lab also uses it for analyzing reach data in motion capture experiments.

I encourage you to also write your own custom functions for iEye and sharing them with the community. Our lab will be doing the same by posting them on my GitHub page and the NYU Curtis Lab website.

System requirements

To date, iEye has been tested on various linux, OS X, and Windows operating systems without issue. Of course, it does require a working version of MATLAB (or Octave) on your computer.

Installation

We have attempted to make the installation process as straightforward as possible.

1. Get the toolbox. There are basically two options to get iEye onto your computer: (A) Download it here or (B) Clone or fork it via GitHub. This can be done in the terminal by typing the following command:

git clone https://github.com/wemackey/iEye.git

I would suggest the latter, as it then allows you to easily ensure you have the most recent version of the toolbox. This option will also let you share custom code and any alterations and improvements you make to the existing codebase with the rest of the community by pushing code to the main repository.

2. Add it to your MATLAB path. This can be done in MATLAB’s command window by typing the following (where ‘directory’ is the directory you downloaded/cloned iEye):

addpath(genpath('c:/directory'))

3. Run it. Type:

iEye

…into the MATLAB command window and the main iEye interface will load up. You’re good to go!

Screen Shot 2016-02-26 at 11.48.51 AM

File system

The toolbox utilizes two different file formats:

  1. *.MAT files. Eye movement data is stored and manipulated in the default MATLAB *.mat file format.
  2. *.IFG files. The *.ifg file format specifies an iEye configuration file. This file is utilized when importing raw eye movement data directly from an eye tracker (usually in *.edf or *.asc file formats).

Disclaimer

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.