User Manual

Try our online system to get an initial experience of the user interface.

Trail list and Data list

Trial list contains all the trials in the experiment. You can select a trial by mouse click or up/down key. You can also mark a trial as valid or (invalid) by pressing the delete key, or by selecting the menu item Edit->Mark Trial.
Icons before each trial represent drift correct result before current trial.
: means drift is less than 0.5 degree to the drift correction position.
: means drift is greater than 0.5 degree to the drift correction position.
: means no drift correction information before current trial.
Drift information will also be displayed in saccade viewer as a green circle with a green line, indicating the drift correction position and shift.

Triallist    Datalist

Trial list and Data list

Data list contains event information of a trial. The contents will change when you are selecting between different views. As shown in the figure above, labels with even numbers indicate left eye events and with odd numbers, right eye events. All the events are displayed in temporal order. When the user selects an item in the data list, related events will be highlighted in the current view. You can select multiple events in editing mode.

Fixation View

Fixation View is a viewer that displays the fixation events. It will also display the text background based on information from text.html. As shown in the figure below, red rectangles represent word boundaries including space and punctuation, green rectangles represent word boundaries excluding spaces and punctuation, and the yellow line indicates the centre of the word. Users can hide/show these boundaries by selecting sub-items under the Menu View. Fixation View has different behaviours in editing mode compared to viewing mode. In viewing mode, users can play the fixations in temproal order by rotating the mouse wheel. Red dots in the view represent right eye fixation events, while blue indicates left eye events. The size of dots indicate either fixation duration or mean pupil size, or a fixed value. Users can change the meaning by a right mouse click and select the corresponding item in the context menu. If you see a black dot under a fixation, this means that a blink event occurred prior to that fixation. The size of the black dot represents blink duration. Users can active/deactivate blink dots by pressing the button. Users can select a dot by a mouse click and this will highlight the selected dots and dim the rest. Users can also double click the fixation view to zoom in. If the view is already zoomed, a double click will return the view to normal.

Users can press the * button in the top right corner to activate edit mode. In edit mode, you will see an extra data grid view on the bottom. Now, users can select multiple dots by dragging a rectangle or multi-selecting them in the data list. All selected events will be displayed on the data grid view. The data grid view allows users to sort and modify the data manually. To move the selected fixation dots up and down users can always use the mouse wheel directly. If users want to move them left and right, they can hold the Ctrl key while rotating the mouse wheel. To confirm the modification, users should double click the view and this will submit all the modification and then dim all the selected dots. To cancel the modification, just select another trial in the trial list and this will quit edit mode and move the view to the new trial. Remember, modifications will affect all the calculations and take effect immediately, but they do not change the original data unless the user saves the modification by selecting the menu item File->Save.

Saccade View

Saccade view is used to display saccade events. Similar to fixation view, red indicates a right eye event and blue a left eye event. Users can also play the saccade event in temporal order by rotating the mouse wheel.

Playback View

Playback view is designed to playback saccade and fixation events. Users can control the playback speed by rotating the mouse wheel. When the mouse is moved outside the view, the playback will stop immediately until the mouse moves inside view again.

Raw Curve/Raw Pupil Size View

Users can activate these two views by pressing the button in the top right corner. However, this requires that you have already extracted the raw data files and saved them into the xxx.raw folder. To extract raw data, users have to set <rawout> option true in the config.xml. Raw Curve displays the raw eye movement data curve and Raw Pupil Size View displays a line chart of pupil size change based on the raw data. Similar to previous views, red means a right eye event, blue a left eye event.

Fixation Variables List

Fixation Variable List contains all the exported variables, which are defined in the export.xml file. The calculation of these variables is dynamic.

Toolbar Buttons

/ Right/Left Eye buttons: the eye button is used to hide/show right/left eye related events in different views. They also affect the data export. For example, if the right eye in the fixation view is hidden, the export data file will exclude all the right eye events.

Reload button: by pressing this button, Eye map will reload the text.html, export.xml, trial.csv and word.csv. If these file are changed before the reload, all related displays will be updated immediately after reload.

Zoom in button: this is actually a zoom in replay button. It will replay latest zoom in operation. If the fixation view is already zoomed in, the fixation view is returned to normal.

Blink button: As mentioned in the Fixation View, the blink button can show/hide blink events that occurred before a fixation.