Home

EyeLink Data Viewer User's Manual

1. EyeLink Data Viewer 2002 2010 SR Research Ltd 140 Acceleration Trace Scaling Factor and Velocity Trace Scaling Factor Set the scaling factor for the acceleration and velocity data so that these two traces can be displayed appropriately in this view Message Triangle Width Message Triangle Height Button Triangle Width and Button Triangle Height Set the width and height of the symbols for message and button events Background Color and Ruler color Set the colors for background and ruler of the temporal graph view Split Y axis If true 0 appear in the middle of the screen positive values on the top and negative values at the bottom otherwise a descending scale is used with large values on the Y axis appearing at the bottom of the screen Note this setting will only be effective when the data are loaded in a new viewing session X Trace Highlighted Y Trace Highlighted and Pupil Trace Highlighted Whether or not by default the X trace y trace and pupil trace are highlighted Initial Visible Sample Count Total number of initially visible samples in the temporal graph view window the default is 5000 Use X Position for Fixation Location If checked use the X position to indicate the position of a fixation event in the temporal graph view otherwise use the Y position EyeLink Data Viewer 2002 2010 SR Research Ltd 141 8 9 Animation Preferences The parameters related to the an
2. Data Loading Output Analysis Data Filters Data Views Use Right Eye if Binoc Include Hidden Everts 7 Display samples Display Messages Display Buttons Display IAs qos Defaut Viewing Sessi DPrograrm FilesiSR Re Defaut Data File Direct GoProgram FilesisR Re Detant lA File Directory Progra FilesiSR Re Defaut Image Directory DPrograrm Files isk Re Detant Report Directory Pragram Files tsk Re Default Display Width 024 Default Display Height 768 O e J e recording which eye s data is to be displayed right eye if checked left eye if unchecked Include Hidden Events Whether or not to include hidden events in Trial Views and Output Reports Display Samples Display Fixations Display Saccades Display Blinks Display Messages Display Buttons and Display IAs Whether or not to display samples fixations saccades blinks messages buttons and interest areas when the data file is first loaded by default only fixations and interest areas are displayed Default Viewing Session File Directory Default Data File Directory Default IA File Directory Default Image Directory and Default Report Directory Set default directories for accessing viewing session files data file loading interest area images loading saving and data output These settings can be changed by clicking on the cur
3. cccccssseesssceeeeeceeeeeeseeeeceeeeeaeeeees 121 Tak SSME Tempere a a a a a 121 Koe Tee 9 9 e r a E A 121 Boa Picie Tempie eeen aa E AT A ee 122 Tad ByebData gt LCenplie eas E A eee ees 122 LIS GOW Widow Template zir a aa 123 TIE C OnTOk Hemp eeen nanan serachadet neers dtaaathnteereesah eek ianen 123 Td Dynamic Template osceann dvadateaeaincnadeicudiisededs tes acteeiiedenctees 124 173 89 Comm simple Templie sachets sess nsatenn stu yucatan acteeuaudyavadade tend sts qasledeenvetaust 124 Bede Oer Temp Ate S eaa actos otra E E eee 124 Be HTM Ce yc UN Si Srae toneg heen tant tie en artes ronment erp gd eee ie te ttediens 125 8 1 General el dH el 0S hc en ee eae eee 126 82 Data loadin Prel reie Sse A A 127 8 3 QUMI Ts ANALY SI Sea tone E E 129 8 4 Pata Fiter PreTre nC E Soene E A etic 133 8 5 General Trak View Pret erences crisare a a aioe 135 8 6 Spatiak Overlay View Preferences ene arsine A E 137 8 7 mape Sesmientation Preleren CO Serisi hea sedinhabahiaieousevianees 139 8 8 Temporal Graph Preferentes wasceacecua ttaxsiiecdleaatausdasasednlasnenn T 140 8 9 Ammam Pro rere NCE Sasra E A A 142 EyeLink Data Viewer 2002 2010 SR Research Ltd v List of Figures Figure 4 1 Viewer Display after Loading the Sample Picture edf File ee 10 Figure 4 2 Components of the Inspector Window Left Data Tab Right Preference Bt o eter E er er en 12 Proure 452 Hine Trial View W IC OW Scares scete Sorecxdit
4. BUTTON FIXATION SACCADE MESSAGE or NO_MATCH q RT_START_TIME Start time in milliseconds since EyeLink EyeLink Data Viewer 2002 2010 SR Research Ltd 67 re tracker was activated of RT definition for a trial RUN COUNT Total runs of fixations 1n the trial two consecutive fixations in the same interest area belong to the same run SACCADE COUNT Total number of saccades in the trial SAMPLE_COUNT Total number of samples in the trial START_TIME Timestamp when the trial recording starts in milliseconds since EyeLink tracker was activated VISITED_INTEREST_AREA COUNT Reports total number of unique interest areas visited in the trial 1 e RUN COUNT without replacement TRIAL_LABEL Label of the trial Besides these default variables additional trial variables will be listed if they have been defined in the EDF file or created during the viewing session see section 6 1 1 on trial variable manager 6 5 3 Using Trial Report Please note that in the above table outputs for all of the variables marked with an will change as different interest period filters are used For example the output for a trial filtered by a reaction time period may be different from a full trial output as the former only include a subset of the full trial data in the report Therefore please make sure that you have the right setting for the interest period filter when creating you own reports see figure below see al
5. Include Hidden Events in Relative Previous Next Variables Treat Hidden Events as Missing Values in Relative Previous Mest Variables Place Quotes 3 Around String Text variables Reset Cancel Next Figure 6 22 Variables in a Saccade Report 6 8 Interest Area Report Interest area report provides a columnar output of eye movement data for each interest area in a trial Each row of the report represents an interest area arranged in an ascending order of the interest area ID 6 8 1 Obtaining an Interest Area Report To obtain an interest area report 1 From the application menus choose Analysis gt Report gt Interest Area Report EyeLink Data Viewer 2002 2010 SR Research Ltd 80 ea EyeLink Data iewer File Edit Analysis Window Help Reports Recording Event Sequence Data Ale Trial Variable Manager Fixation Report Ctrl F a Insped Saccade Report EP Data Trial Variable value Editor Reaction Time Manager Interest 4rea Report Trial Report Initialize Reaction Time Events Ctrl T esLUnititl Sample Report A text 7 A Message Report B CI Trial 1 J P r E Ed Trial 2 i 184 AUT heh Phone Figure 6 23 Creating an Interest Area Report 2 In the following output report dialog Select the variables in the list of available output variables left panel and press gt gt to enter the variables into the list of selected output variables
6. 1 6 Data Output and Analysis Both Spatial Overlay and Temporal Graph trial views can be saved as JPEG images for illustrative purposes A series of output reports can be run for a Data Viewer session The Fixation Output Report generates one row for each visible fixation within the Data Viewer A set of output variables can be selected with each variable output as a column in the report Fixation report variables include start and end time duration average position interest area identifier etc A set of relative variables is also available including the previous and next fixations position angle distance and direction The Saccade Output Report generates one row for each visible saccade within the Data Viewer A set of output variables can be selected with each variable output as a column in the report Saccade output report variables include start and end time start and end position amplitude angle direction average and peak velocity etc A set of relative variables is also available including the previous and next saccades start and end position etc EyeLink Data Viewer 2002 2010 SR Research Ltd 3 The Interest Area Output Report generates one row for each interest area in every trial loaded in the Data Viewer Variables include the interest area identifier label fixation index list number fixations summed dwell time and proportions of fixations and dwell time in the interest area relative to the trial The Tria
7. Toggle Button Event Visibility oe Toggle Sample Visibility ol Toggle Interest Area Visibility 4 2 2 Cloning a Trial View From the menu choose Window Clone Window This allows for example both the temporal graph and spatial overlay views to be shown at the same time on the desktop You can tile the windows together Note that event selection in one view will automatically cause the same events to be selected in the other view 4 2 3 Tiling Cascading Windows To arrange all open trial view windows from the menu select Window gt Tile or Window Cascade Figure 4 3 shows an example of tiling three open trial view spatial overlay temporal graph and animation modes windows EyeLink Data Viewer 2002 2010 SR Research Ltd 16 15 x blejs aia Boo Ba Bs wm ololo ala x ajajaa P Trial View picture Trial 1 Data i Preferences AE Untitled evs E A picture ey wo Trial 2 i Ox lt gt Fixation 8ms Saccade 472ms os Trial iew picture Trial 1 lt gt Fixation 528ms gt Saccade 664ms lt gt Fixation 684 ms o 1602 T Saccade 1128ms ms 801 2404 3206 4008 4809 lt gt Fixation 1160ms 2p TP Saccade 1404ms 68 941 lt gt Fixation 1416ms 44 T Saccade 1668ms 16 lt gt Fixation 1692ms lt gt Saccade 1880ms 4 a eee 5611 7214 8016 8817 6412 gt Fixation 1900ms 40 Sac
8. a Interest Area Output Report x Selected variables RECORDING SESSION LABEL Available Variables QATA FILE ae E E_USED IA AREA 1A AVERAGE FIM PUPIL SIZE IA BOTTOM oe a A DWELL TIME IA WELL TIME IA FIRST FIXATION DURATION 14 FIRST FIMATION INDEX 14 FIRST FIMATION RUN INDE R 4 b Definiton Duell time 1 6 Summation of the duration across all fixations on the current interest area Exclude Trial String Include Hidden Events in Relative Previous Next Variables Treat Hidden Events as Missing Values in Relative Previous Mexe Variables Place Quotes 9 Around String Text Variables Reset Cancel Next Figure 6 24 Variables in an Interest Area Report EyeLink Data Viewer 2002 2010 SR Research Ltd 81 e To remove variables from the output list simply select the variables and press lt lt e To change the order in which the variables are listed simply select one variable and use the or F button to move it to the desired position Repeat this step until all variables are in the right position e Data Viewer supports exporting and importing of variable selection across viewing sessions For example the user may go through each of the output reports to configure the selection of variables in an intended order Export the variable selection into a property file by clicking on the Export Variable Selection button E For all future
9. of A_RUN_ID fixation s made towards the current interest area If the current interest area does not have a previous run of fixation s on it this variable will have a value of 1 CURRENT_FIX_INTEREST_ARE Horizontal offset of the current fixation relative to A_X_OFFSET the center of the interest area If the fixation falls into multiple interest areas returns the offset value relative to the first relevant interest area only Returns a missing value for freehand interest areas A_Y_ OFFSET center of the interest area definition CURRENT_FIX_LABEL Label of the current fixation CURRENT _ FIX _MSG COUNT Number of visible messages associated with the current fixation event This number will not exceed the Maximum Message Variables for Eye Event set in the Output Analysis Preference Settings CURRENT _ FIX _MSG_TEXT_ Text string for messages associated with the current fixation CURRENT_FIX_MSG_TIME_ Trial time of the message CURRENT_FIX_ NEAREST Nearest interest area the current fixation 1s _INTEREST AREA assigned to CURRENT_FIX_NEAREST Distance in degrees of visual angle between the _INTEREST_AREA_ DISTANCE current fixation point and the center of the nearest interest area the current fixation 1s associated with _INTEREST AREA LABEL fixation 1s associated with CURRENT_FIX_REFIX_INTERE Whether this trial has a previous fixation in a ST_AREA different run that had the same interest area as the
10. truth F5 F6 and 6 pathless F9 gt F10 EyeLink Data Viewer 2002 2010 SR Research Ltd 90 6 9 Sample Output Report Sample output report provides a columnar output of eye movement data for each eye sample in a trial The sample report option will not be available if the samples are not loaded into a viewing session As in the other reports sample output report only outputs samples that fall within the active interest period for the trial 6 9 1 Loading Samples into a Viewing Session Version 1 7 of Data Viewer introduced a change to optimize the viewer performance by not loading the samples by default see revision history To make sample data available to a viewing session you will need to first change the data loading preferences and then reload the EDf file 1 Before loading any EDF files please go to Start gt Programs gt SR Research gt EyeLink gt Data Viewer to start the software 2 Once the application starts up click Preferences tab and go to Data Loading preferences Check the Load Samples option If you want this changes to be persistent over future viewing sessions you may consider saving this as default setting This can be done by selecting the topmost preference tree node clicking the right mouse buttons and selecting Save Properties as Defaults 3 Once you have done step 2 this will make the properties persist over future data viewing sessions Now start loading in the
11. BMP JPG or TIFF a bmp file will be created by default if no file extension is specified Properties for a fixation map can be configured through the Output Analysis preferences settings EyeLink Data Viewer 2002 2010 SR Research Ltd 51 ar EyeLink Data iewer Fie Edit Analysis Window Help Untitled evs B picture y Clean of ED Trial 2 Se Trial 3 Delete H Fa mierea 4r Openin New Window Create Fixation Map Select Trial Background Image TE Fixation Orns TP Fixation 528m TE Fixation 6S4ms gt Fixation 1160ms E sian ae ere E Figure 6 5 Creating a Fixation Map EyeLink Data Viewer supports creating a fixation map based on the duration of fixations count of fixations percent of fixations and percent of dwell time across the display This is configurable through the Type 1 Duration 2 Count 3 Count Density 4 Duration Density option of the Output Analysis preferences settings If a duration or duration density type is selected the height of the Gaussian is weighted by the duration of the individual fixations for a count based or a count density fixation map the height of the Gaussian is the same for every fixation The map activity is averaged based on trial count pooled across subjects 1 e a map based on 1 trial that has 1 fixation will have a same fixation output as a map based on 10 trials each trial with 1 fixation at same location The title of the fixation map indicates
12. Default TRIAL RESULT Description This message defines the end of a trial for the viewer This is different than the end of recording message END that is logged when the trial recording ends The viewer will not parse any messages events or samples that exist in the data file after this message The command identifier can be changed in the data loading preference settings Format TRIAL RESULT lt possible trial result values gt Example MSG 3383842 TRIAL_RESULT 0 Note If the trial end message is not found or if no trial end message is defined for the viewing session the END message is used to indicate the end of a trial for the Viewer 7 2 Pre Trial Message Commands The following message commands if defined MUST be sent to the EyeLink data file prior to the Trial Start message defined above 1 e outside the scope of a trial as defined for the viewer If they are sent during trial recording these messages will not be interpreted 7 2 1 Trial Variable Labels Identifier Default TRIAL _ VAR LABELS Description This message allows the definition of the labels to be used for trial variables within the viewer The command identifier can be changed in the data loading preference settings Format TRIAL VAR LABELS lt trial variable list gt EyeLink Data Viewer 2002 2010 SR Research Ltd 105 Example MSG 3363553 TRIAL_VAR_LABELS TRIAL_VAR_1 TRIAL_VAR_2 TRIAL_VAR_3 7 2 2 Display Coordinates Identifier DISPLA
13. Drit Corrects FIONS e er E 28 EyeLink Data Viewer 2002 2010 SR Research Ltd wu 5 2 3 1 Drift correcting a Group of Selected Fixations 2 00 0 eeeeeeeeeeeeeeeees 28 5 2 3 2 Precise Drift Correction of a Single Fixation 00 cccceesssseeeeeeeees 29 32 329 Ceann Fix au Ons as esis eawidintelus Manure O 30 5 3 ETO AS Secrets st A N om Aetna su secur EET OA E E EE 31 Zo Wher eine SIC ad S sea hatiaae nce rishaden aanaceies Ganriae ets 32 DA BUKEN S sass cctdnuas cacetengudede awn a e EA E O 32 5 5 MESSI ES E vetucendtncnvasaceegene sey 33 Jod Ampon Messa LIS oea a E E sad taacedieiameseletrantcuctenene 35 JO BUMO EVOM eene EN 36 5 7 SMPS enaa a a a a er eee een 37 5 8 TAES TATEA S ni a E 38 5 8 1 Manually Creating Interest Areas ssesssseeesssssssseceresssssssccrressssssseceressssss 39 5 8 2 Creating Interest Area Image Segmentation ssesoeeessssssoeeresssssssseerrssss 4 5 8 Savine Interest Arca S csr etic a a aes aemaeeta ese aae 4 5 8 4 Importing Interest Area File for a specific trial ccccccccsssseeseeeeeeeeeeees 42 5 8 5 Emptying Interest Area Set for a trial 00 ccccssesseeecccecceeeeeeeeeceeeeeeneas 42 5 5 0 Loading Interest Area Template asosan E aeweia tans 42 5 8 7 Using Interest Arca 1 Sip aves senso stateic ve cent iate lec asus a a eae 42 5 8 8 Automatic Trial Image Interest Area Set Association ccceeeeeeeceeeeeeeees 43 5 8 9 Deleting Interest Area Templates norisi opriep ans
14. Each RGB value should be an integer between 0 and 255 Format V DRAWLINE lt red gt lt blue gt lt green gt lt x_start gt lt y_start gt lt x_end gt lt y_end gt Note lt x_start gt x coordinate of the starting point lt y_start gt y coordinate of the starting point lt x_end gt x coordinate of the end position lt y_end gt y coordinate of the ending position Example MSG 9441901 V DRAWLINE 255 0 0 100 100 300 400 This draws a red line connecting 100 100 and 300 400 7 3 4 3 Drawing a Rectangle Identifier DRAWBOX Description This command draws a framed rectangle with the color specified by the red blue green integer values specified in the command Each RGB value should be an integer between 0 and 255 Format EyeLink Data Viewer 2002 2010 SR Research Ltd 111 IV DRAWBOX lt red gt lt blue gt lt green gt lt top gt lt left gt lt right gt lt bottom gt Note Left top right and bottom refer to the x y coordinates of the top left and bottom right corners of rectangle Example MSG 9441901 V DRAWBOX 0 255 0 200 300 400 500 This draws a green rectangle frame with the top left corner at 200 300 and the bottom right corner at 400 500 7 3 4 4 Drawing a Filled Rectangle Identifier FILLBOX Description This command draws a filled rectangle with the color specified by the red blue green integer values specified in the command Each RGB value should be
15. F9 IA SECOND FIXATION F5 DURATION IA_SELECTIVE _REGRESSION_PATH F8 _DURATION Take interest area 6 pathless for example IA_REGRESSION_PATH_DURATION includes the first pass fixations on the interest area F4 F5 time spent in previous parts of the sentence following regressive eye movements F6 F7 and time due to refixations coming from the left before the eyes move past the interest area F8 The calculation of IA_SELECTIVE_REGRESSION_PATH_DURATION only includes the first run fixation on the interest area F4 F5 and the refixations on the interest area F8 before the eyes enter next interest area with a higher A_ID land IA_FIRST_FIX_ PROGRESSIVE checks whether later interest areas have been visited before the first fixation enters the current interest area Therefore this variable would be 0 for the interest area is because it was fixated on Fixation 7 while Fixations 4 and 5 were on later part of the sentence pathless I A_REGRESSION_OUT checks whether at least one regression was made from the current interest area to previous parts of the sentence prior to leaving that interest area in a forward direction Therefore the transition from F5 F6 makes this flag true for the interest area 6 labeled as pathless IA _REGRESSION_IN checks whether a given interest area received at least one regression from later parts of the sentence Therefore this is true for both interest areas 3
16. WAS approached by gravelled driveways Value Mame est jas 41 Custo alze mage Mame Mapping Sac_blur jpg a 5 8 9 Deleting Interest Area Templates Interest area templates can be deleted from IA template list In the Treeview panel of the Inspector window locate the Interest Area Templates folder where all of the interest area templates are loaded Select the target interest area template from the list click the right mouse button and select Delete If the deleted interest area template is being used by a trial the Interest Area Set property of that trial will be set to Empty Interest Area Set er Inspector l TE Data i Preferences Untitled evs A picture LA Trial 4 CI Trial 2 CI Triak 3 Interest Area Templates mest jas EO test iss EO test ias EO test4 ias Ho Empty Interest Area Set Delete Import Message List 5 8 10 Selecting Interest Areas To select an interest area place the mouse cursor over the interest area and click the left mouse button The interest area is highlighted after selection To select more than one EyeLink Data Viewer 2002 2010 SR Research Ltd 44 interest area hold the CTRL key down and select the target area until all desired interest areas are selected If all interest areas in the trial are to be selected simply click the Select All Visible Item button l on the toolbar or click the right mouse button and sel
17. fixations are connected by an arrow pointing towards the more recent fixation Joint Concurrent Selected Fixations For the selected fixations connects temporally contiguous fixations Sample Trace Granularity If the sample visibility is toggled on shows every nth sample by default n 5 Sample Tick Period Draws a circular tick for every nth sample by default n 20 Widely spread ticks indicate high saccade velocity Sample Tick Width Diameter in pixels of the sample ticks Minimum IA Size Minimum width of an interest area Display IA If selected shows percentage of trial dwell time spent on the selected interest area EyeLink Data Viewer 2002 2010 SR Research Ltd 137 Use SQRT of Fixation Duration for Circle Size Uses the square root of fixation duration to calculate the width of the fixation circle 1f checked Fixation Circle Scalar Maximum Fixation Circle Width and Minimum Fixation Circle Width If the above Use SQRT of Fixation Duration for Circle Size option is not used use Fixation Circle Scalar to define a scalar for fixation circle width calculation The maximum and minimum circle widths are set with the Maximum Fixation Circle Width Minimum Fixation Circle Width elements Background Color Background color for the spatial overlay view used only if the trial bitmap is not loaded Maximum Graphics Commands to Process Sets the maximum number of graphics commands to process in each tria
18. lt rt_end_msg gt Note Condition labels and their values are not required for the trial specific message command and optional for the pre trial message command if not specified the RT definition is applied to all conditions Example MSG 329381 V RI MESSAGE SYNCTIME END RT 7 4 5 Reaction Time Definition Set Identifier FILE Description EyeLink Data Viewer 2002 2010 SR Research Ltd 120 When a large number of RT definitions have to be specified it is easier to first record all RT definitions in a file and later on the viewer can read the RT definition file with the V_RT FILE command In a reaction time definition file each line represents one RT definition which is written in the same format as the pre trial message command for each respective type of RT end event except that in this case V_RT token is not necessary Pre Trial Message Command Format V_RT FILE lt relative path gt Example MSG 329381 V_RT FILE rt default rts 7 5 Changes in the Sample Experiments The preceding sections list the special messages and commands that can be sent to the EDF file to enable the EyeLink Data Viewer to extract information in a more efficient way The current section provides an overview of the changes made in the sample experiment templates Please refer to the Programming EyeLink Experiments in Windows Version 2 0 manual for the description of individual templates 7 5 1 Simple Template Two EyeLink Data Vi
19. pointing towards the endpoint and as a colored solid line in the temporal graph view The following table EyeLink Data Viewer 2002 2010 SR Research Ltd 31 lists the properties of a saccade event Those fields that are editable in the viewer are marked with an asterisk Field Label ye Start Time End Time Duration Start X Start Y End X End Y Amplitude Peak Velocity The average and peak values of gaze velocity in visual Average Velocity degrees per second RT End Event Whether the current saccade 1s the reaction time end event see section 6 3 1 for reaction time definition Hidden Whether the current saccade is hidden from viewing and output analysis Manually Adjusted Whether the saccade has been adjusted manually Color To achieve better visibility the color of the currently selected saccade can be changed by clicking on the color toolbox 5 3 1 Merging Saccades Sometimes a large saccade 1s followed by a small corrective saccade or vice versa Thus two or more temporally contiguous saccades could be merged This can be done by selecting the saccades and clicking the Merge Selected Items button L5 on the toolbar or clicking the right mouse button and selecting merge Once the saccades are merged information on the ordinal sequence for the current and subsequent saccades is updated and the fixation between the two merged saccades is deleted Note Only two or more temporally contiguous sacc
20. simply select one variable and use the or button to move it to the desired position Repeat this step until all variables are in the right position e Data Viewer supports exporting and importing of variable selection across viewing sessions For example the user may go through each of the output reports to configure the selection of variables in an intended order Export the variable selection into a property file by clicking on the Export Variable Selection button E For all future viewing sessions the variable selection in the reports can be automated by importing the previously saved property file by clicking on the Import Variable Selection button H 3 Once all the desired variables have been entered into the output list press NEXT button 4 In the Save dialog box browse to the directory in which you want to save the output report The default output directory can be configured through General Preferences EyeLink Data Viewer 2002 2010 SR Research Ltd 71 5 In the File name text box enter the name for the document and choose the appropriate file extension Note if the output report file extension set to All Files and the file name does not contain an extension the file name is appended with a txt by default 6 Press the Save button 6 6 2 Variables in the Fixation Report Currently the fixation report includes the following variables RECORDING_SESSION LABEL Label of the data file CURRENT _ FIX
21. 8 1 Saving properties as defaults 0o oeenessessssooeerssssssssceresssssssseereresssssseeeress 125 EyeLink Data Viewer 2002 2010 SR Research Ltd vii 1 Introduction The EyeLink Data Viewer is a tool that allows the display filtering and report output of EyeLink I and EyeLink IIT EDF data files Data Viewer includes the following areas of functionality 1 1 Data Visualization The EyeLink Data Viewer supports three trial based viewing modes the Spatial Overlay View the Temporal Graph View and the Animation View In the first two viewing modes the user can specify which event types to display including fixations saccades blinks messages and buttons Sample traces can also be displayed The animation viewing mode plays back the gaze data of a selected trial The Spatial Overlay View allows a trial to be viewed superimposed on the background image that the participant was looking at while the data was being recorded This view is ideal for relatively static trial presentations like reading or visual search paradigms Fixations can be displayed as either circles or as a scan path Saccades can be displayed as lines with an arrow specifying the saccade direction Blinks can be displayed as a line joining the last valid sample position prior to the blink and the first valid sample following the blink Message and button events can be displayed as a small rectangle where the position of the event is determined by the position
22. Install the Data Viewer software Double click on the EyeLinkDV1 exe installer keeping the default settings on InstallShield Wizard screens except for the following two e On the Setup Type dialog box select Custom e On the Select Feature screen make sure that both HASP4 and HASPHL driver options are selected Install network HASP key driver You may install the driver by clicking Start gt All Programs gt SR Research gt HASP HL Driver from your computer desktop or double clicking on HaspUserSetup exe in C Program Files SR Research Common folder Install network HASP License Manager You may install the tool by clicking Start gt All Programs gt SR Research gt Networked HASP License Manager from your computer desktop or double clicking on Imsetup exe in C Program Files SR Research Common folder Failing to install this will report a NO HASP Key Found error in the SR License Manager dialog box e When installing the license manager set the Installation Type to Service nhsrvice exe e On the HASP License Manager dialog box check either Yes or No to continue If this is the server computer you may install optional Aladin Monitor software by clicking Start gt All Programs gt SR Research gt Aladdin Monitor from your computer desktop or double clicking on Aksmon32 exe in C Program Files SR Research Common folder Test license status e Please make sure that the server and cli
23. acceleration sample traces can be selected for viewing from buttons within the Trial Viewer Window View Trial Spatially with Image Overlay Select the spatial overlay mode View Trial Play Back Animation Select the playback animation mode Ci Zoom In Graph View Zoom in to view details of a selected portion of data X Sample Trace Toggle X trace visibilit Changes from the previous versions to show the eye or target traces in this version the user needs to select the type of data position velocity or acceleration and data source x y pupil of left eye and or right eye x y of targetl and or target2 to be shown To show the position velocity and acceleration traces of target s in this view messages on the current position of the target s must be recorded in the EDF file These messages should contain a target position keyword V TARGET_POS by default and can be configured in the target position string of Data Loading preference settings followed by parameters of the individual targets The scale in which the vertical data is displayed can be changed by clicking the right mouse button when the mouse cursor is placed on the Y axis and choose one of the following options ascending large values on the Y axis appear on the top of the screen descending large values on the Y axis appear at the bottom of the screen or split O appear in the middle of the screen positive values on the top and negative values at the b
24. acceleration traces of the eye Animation samples The pupil sample traces of both eyes are also displayed The default settings can be changed by clicking the corresponding cell and choosing a color from the palette or entering the value in RGB or HSB scales Trew Right Eye x Sample Trace Color MY Sample Trace Color A Velocity Trace Color v velocty Trace Color x Acceleration Trac A y Acceleration Trac Pupil Sample Trace Target 1 Target 2 Key Token word to indicate the target ID This field is set to blank by default so that various token words can be used If two targets are involved and 1f the order of the two targets is important set this field to the token string used in the EDF file x Sample Trace Color Y Sample Trace Color A Velocity Trace Color Vv Velocity Trace Color i Accelleration Trac Y Acceleration Trac X Position Trace Color Y Position Trace Color X Velocity Trace Color Y Velocity Trace Color X Acceleration Trace Color Y Acceleration Trace Color and Pupil Sample Trace Color Set the colors to be used to show the horizontal and vertical position velocity and acceleration traces of the targets The default settings can be changed by clicking the corresponding cell and choosing a color from the palette or entering the value in RGB or HSB scales x Position Trace Color i Y Position Trace Color i velocity Trace Color g
25. analyses trial fixation saccade interest and recording sequence outputs only those events and data within the selected interest period custom defined interest period or the default Full Trial Period or Reaction Time Period are exported 6 5 Trial Report Trial report summarizes the performance of individual trials Before trying to obtain a trial report make sure that you have completed the reaction time definition and initialized the reaction time events 6 5 1 Obtaining a Trial Report To obtain a trial report 1 From the application menus choose Analysis gt Report gt Trial Report a EyeLink Data iewer File Edit Analysis Window Help Reports Recording Event Sequence Data Fixation Report Ctrl F Trial Variable Manager Trial variable value Editor Saccade Report BA n a eee aa a O Interest Grea Report Trial Report CErl T Reaction Time Manager Initialize Reaction Time Events Sample Report Message Report O E Trial 2 Figure 6 15 Creating a Trial Report EyeLink Data Viewer 2002 2010 SR Research Ltd 63 2 In the following output report dialog select the variables in the list of available output variables left panel and press gt gt to enter the variables into the list of selected output variables 2 Trial Output Report x vailable variables Selected Variables RAVERAGE FIXATION DURATION RECORDING S
26. as an interest area template or to be imported into another trial EyeLink Data Viewer 2002 2010 SR Research Ltd 41 1 Click the Save the Interest Area Set to Disk i button on the spatial overlay window toolbar 2 In the Save dialog box browse to the directory in which you want to save the interest area 3 In the File name text box type in the name for the file 4 Press Save button 5 8 4 Importing Interest Area File for a specific trial For each individual trial interest area can be imported 4 Click the Import Interest Area File button 4 on the spatial overlay window toolbar 5 In the Load dialog box browse to the location of the interest area file that you want to import and select it 6 Click Load Note This operation will delete any existing interest areas in the trial 5 8 5 Emptying Interest Area Set for a trial To empty the current interest area set for a trial 1 Click the trial whose interest areas are to be emptied in the tree view 2 In the property panel of the trial find the entry Interest Area Set and choose the value of Empty Interest Area 5 8 6 Loading Interest Area Template If the same interest areas are used for several trials instead of repeating the procedure of creating interest areas for each individual trial an interest area template can be loaded to supply the segmentation information for those trials To load an interest area template or multiple interest area set file
27. coordinate of the upper left corner of the interest area Area of the interest area in pixels Color To achieve better visibility the color of the currently selected area interest can be changed by clicking on the color toolbox Time EDF file Time when the interest area was created with the V IAREA command during recording If the interest area was created during the viewing session manually or from interest area template file the time value will be 1 and this attribute will not be visible from the property table The interest area time was useful only when interest periods are created and used 1 e to filter interest areas based on the current selected interest period Number Fixations Total number of fixations within the interest area Fixation Percentage of total fixations in a trial falling within the current interest area Dwell Time Total time in milliseconds spent on the current interest area Dwell Time Percentage of trial dwell time spent on the current interest area Sequence Run Count Number of times the interest area was entered and left 1 e run Note The coordinate information Left Top Right and Bottom is available for the rectangular and elliptic interest areas only ID T Type of interest area rectangular elliptic or freehand op 5 8 1 Manually Creating Interest Areas The visibility of interest areas can be toggled on off by clicking the Toggle Interest Area Visibility button
28. current interest area interest area The X position of the last fixation event that was within the current interest area The Y position of the last fixation event that was within the current interest area ME current interest area TA LAST SACCADE START_T Start time of the saccade that last landed within the current interest area IME IA_LEFT Left side pixel position of non freehand IA IA_LEGAL A trial is considered legal 1 e IA_LEGAL 1 only if the first fixation in interest area N was preceded by a fixation in interest area N 1 This variable is relevant for experiments that run in a contingent display paradigm as it ensures that readers could see the target area before actually lending in it IA _MAX FIX PUPIL SIZE Maximum pupil size among all fixations in the interest area Note this measure does not represent the maximum pupil size within a fixation IA_MIN_FIX_PUPIL_SIZE Minimum pupil size among all fixations in the interest area Note this measure does not represent the minimum pupil size within a fixation IA_POINTS List of x y points for freehand Interest Areas IA_REGRESSION_IN Whether the current interest area received at least one regression from later interest areas e g later EyeLink Data Viewer 2002 2010 SR Research Ltd 84 parts of the sentence 1 if interest area was entered from a higher I A_ID from the right in English O 1f not Number of times interest area was ente
29. duration is shorter or equal to the duration threshold If not the current fixation will not be cleaned otherwise Data Viewer further checks the duration and distance of the fixation immediately before and after the current fixation The fixation will be merged to the neighboring fixation 1f its duration is longer than the threshold value and its distance along the x axis in degrees from the current fixation is shorter or equal to the distance threshold If both the previous and next EyeLink Data Viewer 2002 2010 SR Research Ltd 30 fixations meet the above criterion the current fixation will be merged to the longer one of the two 11 STAGE 2 This stage is similar to STAGE 1 except for a different fixation duration and a distance value For this stage to be effective a shorter duration and a longer distance threshold should be used compared to Stage 1 111 STAGE 3 Data Viewer goes over the entire data and checks for interest areas which include at least three fixations smaller than the threshold duration and no fixations larger than the threshold duration In such cases the shorter fixations are merged into the larger ones Iv STAGE 4 Data Viewer goes over the entire data and deletes every fixation which is shorter than Minimum duration or larger than the maximum duration threshold v If Delete Fixations Outside Interest Area box is checked this will remove those fixations falling out side of any interest area Important If no i
30. image in the following order 1 In the default image directory specified in the general preference settings 2 Inthe directory the EyeLink data file is loaded from 3 In the directory the viewer application is running from Format IV IMGLOAD FILL lt relative_image_path gt Example MSG 3388468 V IMGLOAD FILL Sac_blur jpg 7 3 3 2 Image Loading Top Left Identifier TOP LEFT Description This message specifies an image to be used as a segment of the spatial overlay view of a trial within the viewer The image size is not changed unless width and height parameters are also specified and will be positioned by using the x and y positions specified as the top left corner of the image The image should be represented as a relative path The viewer will look for the image in the following order 1 In the default image directory specified in the general preference settings 2 In the directory the EyeLink data file is loaded from 3 In the directory the viewer application is running from Format V IMGLOAD TOP_LEFT lt relative_image_path gt lt x_position gt lt y_position gt width height Note width and height are optional parameters Example MSG 2740540 V IMGLOAD TOP_LEFT fixations gif 200 200 7 3 3 3 Image Loading Centered EyeLink Data Viewer 2002 2010 SR Research Ltd 109 Identifier CENTER Description This message specifies an image to be used as a segment of the spatial overlay view of a trial with
31. indexes are updated accordingly 4 1 1 4 Interest Area Templates An interest area template is a AS file that contains a set of interest areas If the same interest areas are used for several trials instead of repeating the procedure of creating interest areas for each individual trial an interest area template can be loaded to supply segmentation information for those trials efficiently The property panel lists the following summary statistics for an interest area template Those fields that are editable in the viewer are marked with an asterisk EyeLink Data Viewer 2002 2010 SR Research Ltd 14 Label of the custom interest area set IA Count Total number of interest areas defined in the trial IsCustom Whether the current set of interest areas 1s user defined true or an interest area template false Image Name Mapping If the Auto Select IAS for Trial property in the Output Analysis preference settings is true the value in this field will be used to associate the IAS to trials automatically see section 5 8 8 Automatic Trial Image Interest Area Set Association for details 4 1 1 5 Custom Interest Area Set Empty Interest Area Set For each trial the tree view also shows whether or not a custom interest area set has been defined for the trial If there is no interest area set the node LJ will be Empty Interest Area Set The property panel lists the same elements as the interest area templates except that
32. is also supported if the EDF file is created from an SR Research Experiment Builder recording The video clip must be encoded in XVID format and a computer with P4 CPU is required for playback in Data Viewer The current frame number is displayed at a position relative to the top left corner of the video If you want to hide this frame number indicator somehow please go to Preference Settings gt Animation and uncheck the Display Frame Number option Please be advised that this feature is presently not available on Mac OSX EyeLink Data Viewer 2002 2010 SR Research Ltd 22 If you want to save the video clip with the overlaid eye position please try to make sure the display solution on your computer desktop right click on the desktop to start the Display Properties matches or is close to that of the EDF file recording resoltion the Display Width and Display Height in the recording session node for best video saving quality In the video saving dailog box set the size to this recording resolution The default NONE compression will save a large output file You may try some codec that does the compression e g the CINEPAK CODEC which does a good compression albeit slow Please also keep the default Trial View Window size as any change in the aspect ratio of this window may introduce distortion to the saved overlay video When the video saving is in progress please do not disrupt it e g by resizing or moving the Data Vie
33. mouse button and click on the delete menu item If trials contained within a grouping node are deleted from the data viewer session they will be permanently removed from the tree view the EDF file has to be reloaded before information on that file can be accessed again 4 1 1 3 Trial Summary By clicking on the trial node R of the tree view information on participants performance in individual trials can be retrieved Once a trial is selected for analysis the middle panel of the Data Tab lists all of the visible events and messages in the trial and the bottom panel provides a general summary of performance in that trial The following table lists the trial level analysis variables Those fields that are editable in the viewer are marked with an asterisk Start Time Timestamp when the trial recording started in milliseconds since EyeLink tracker was activated End Time Timestamp when the trial recording ended in milliseconds since EyeLink tracker was activated Reaction Time Configurable response time determined by the Reaction Time Definition associated with the trial Use the value of Duration if RT is undefined RT Event Index Index of event that triggered the end of the reaction time 1 when NO_MATCH The index is relative to a specific event type for example an index of 5 for a Saccadic RT means the 5 saccade in the trial RT Event Type The way in which the trial reaction time is ended possible values are TIMEOUT
34. of trials and configurable interest area information see section 6 1 3 on how to perform trial grouping By default trials in a viewing session are grouped by the EyeLink data files loaded The following table lists the group properties 1f trials are grouped by data file Those fields that are editable in the viewer are marked with an asterisk Eyes Which eye produced the recording the value could be Left Right or Binocular Mode Pupil only mode or pupil with corneal reflection Pupil Data Type Whether the pupil size is set by area or diameter Gaze Data type Raw raw pupil center position or pupil minus corneal 1f running in pupil CR mode as measured by the image processing system Gaze actual gaze position on the display screen fully compensated for head position or HREF the tangent of the rotation angle of the eye relative to the head Display Width Screen resolution width and height in pixels of the recording Display Height displays By default this sets the trial view window resolution to the value specified by display Coordinates messages If you want to change the screen resolution make sure that you first close the Trial View Window first change the Display Width and Display Height values and then open another trial view window EyeLink Data Viewer 2002 2010 SR Research Ltd 12 4 1 1 2 1 Deleting a group of trials To remove a group of trials from the analysis select the grouping node click the right
35. out the meaning of a tool on the standard toolbar simply place the mouse over the tool 3 2 Saving a Viewing Session From the menus choose File Save Tip The viewing session can also be saved by clicking the Save Viewing Session tool on the standard toolbar or press Ctrl S When a new viewing session is saved Data Viewer will create a session name evs file as well as a session res folder both of them are required for a proper re opening of the viewing session later on 3 3 Opening an Existing Viewing Session To open an existing viewing session 1 From the menus choose File Open 2 In the Open dialog box browse to the location of the file and select it EyeLink Data Viewer 2002 2010 SR Research Ltd 7 3 Click Open Tip A saved viewing session can also be opened by clicking the Open Existing Viewer Session tool on the standard toolbar or press Ctrl O The viewing session can also be opened by double clicking on the session name evs file Please make sure that the session res folder is available otherwise the viewing session cannot be properly opened 3 4 Saving an Existing Viewing Session to a Different File To save a viewing session to a file 1 From the menus choose File Save AS 2 In the Save As dialog box browse to the directory in which you want to save the document 3 In the File name text box type in the name for the document 4 Click Save Tip The viewing session can also be
36. report will only do summary statistics variables marked with in the above table for those events falling within that period 6 5 4 Configuring the Trial Report The Data Viewer also allows the user to configure the trial report similarly the fixation report saccade report and the interest area report The user can exclude some trials by entering a string in the Exclude Trial String edit box This string should be one message or part of a message within the scope of the trial recording see section 7 1 on defining the start and end of a trial that uniquely defines that subset of trials to be excluded In addition to enable correct loading of string text variables in some statistics software the Viewer also has an option of adding a pair of quotation marks for such variables 6 6 Fixation Report EyeLink Data Viewer 2002 2010 SR Research Ltd 69 Fixation report creates a columnar output of fixation events Each row of the report represents a fixation event Depending on the variables selected for output each row can contain information on the previous fixation and or saccade as well as the next fixation and or saccade 6 6 1 Obtaining a Fixation Report To obtain a fixation report 1 From the application menu choose Analysis gt Report gt Fixation Report a EyeLink Data iewer File Edit Analysis Window Help A Reports Recording Event Sequence Data Trial Variable Manager
37. tents 44 2S0 Selocune Interest Are ISo eeusins taht auras eS abes ingore teharee 44 5 8 11 Moving an Interest Ara isc ccicvorienctssvensdetstaaeavaiccdsesniatedesscensstetdadeaueindidaey 45 5 8 12 Resizing Rectangular and Elliptic Interest Areas cc ceeeeeceeeeeeeeeeees 45 5 8 13 Resizing Freehand Interest Areas siisii eden tiican doves 46 Sol Deleting Merest Areas ycniusncuniet Aisa a Deadetes ach atuas 46 28 15 Splht ne Mnterest Areas rruna a E 46 ISA Merome Mecs t Aras azr a tian eitesateia ene 46 60 Daa Analys Ai CN seca R E 47 6 1 Maia oni Trial V ar alles eeen a E N 47 O A Trial Varnable Manager borce ann tut whdwera tem ey 48 6E Trab Variable Vite Editor enron e O 48 OLS Pials Grou pie e E eh eens 49 62 Fixation Mapesa g a a a a eias 50 6 3 Managing Reaction Time Definitions eeeessseeeeessssssssoeerrsssssssseerrssssssseeeeees 55 0L Reacnon Vane Mana ebere EE sc deluatecomen sii aaaca dente 56 6 3 2 Viewing Reaction Time Information cccccccccssssseeseceeeeeeeeeeeeseeceeseeeeaas 59 Sc ARM 115 XS ew 0 0 pre ea etm rt ea En oe en nee 60 OAI Creatine Interes Periods sik scopvaies es slsaeysaied E 60 O42 Usm Eers PCHOC ssrviir5 ensinensacesddateniendacth a A a 63 6 5 TAER DO oria a a eats eee 63 63L Obtamine 4 Trial RepOU areiersocpni ana a E a N 63 6 5 2 Variables in the Trial Report sseeeeenssessssoeerssssssssscerrssssssssceressssssseceressssss 65 625 5 Usmo Tria
38. the desired position Repeat this step until all variables are in the right position e Data Viewer supports exporting and importing of variable selection across viewing sessions For example the user may go through each of the output reports to configure the selection of variables in an intended order Export the variable selection into a property file by clicking on the Export Variable Selection button E For all future viewing sessions the variable selection in the reports can be automated by importing the previously saved property file by clicking on the Import Variable Selection button B 3 Once all the desired variables have been entered into the output list press NEXT button 4 In the Save dialog box browse to the directory in which you want to save the output report The default output directory can be configured through General Preferences 5 In the File name text box enter the name for the document and choose the appropriate file extension Note if the output report file extension set to All Files and the file name does not contain an extension the file name is appended with a txt by default 6 Press the Save button Data Viewer also allows the user to configure the message output report The user can exclude some trials by entering a string in the Exclude Trial String edit box This string should be one message or part of a message within the scope of the trial recording that uniquely defines that subset o
39. the elements of the EyeLink Data Viewer can be configured by the user from the Preference tab of the Inspector Window These include everything from the default colors used to the elements of how an EDF file is loaded All the changes can be saved allowing the changed preference settings to be loaded in subsequent viewing sessions Any preferences setting can be edited by clicking on the value cell and changing the value For string and number values be sure to press Enter after making the change to register your input with the application To make the changed preference settings persist over future sessions the user can click the right mouse buttons and clicking on Save Properties as Defaults Data Viewer also supports exporting and importing of preference settings across viewing sessions Export the preference seta into a property file can be done by clicking on the Export properties button To use the saved preference settings for a given session click on the Import Properties button i Data Loadin are Hie dae 2 Restore Factory Defaults H Output Analysis B ea Data Filters H Data views erme Include Hidde Figure 8 1 Saving properties as defaults EyeLink Data Viewer 2002 2010 SR Research Ltd 125 8 1 General Preferences The general preference setting covers the following elements res Inspector Use Right Eye if Binocular For a binocular Tt Data mi Preferences Preferences
40. the right eye is in a saccade RIGHT_PUPIL_SIZE Right eye pupil size of the current sample eye along the x axis Velocity value in degree second of the right eye along the y axis If the EyeLink button box is pressed this records the ID of the EyeLink button number sample the target along the x axis the target along the y axis along the x axis along the y axis TARGET_VISIBLE Whether the target is visible during the current sample To support the retrieval of target position from a sample report the target position data must be written according to some format see section Protocol for EyeLink Data to Viewer Integration gt Target Position Commands TARGET_X TARGET_Y Target gaze position on y axis TIMESTAMP The time stamp of the sample in milliseconds since EyeLink tracker was activated EyeLink Data Viewer 2002 2010 SR Research Ltd 95 The start time in milliseconds since EyeLink tracker was activated of the trial VIDEO FRAME INDEX Index of the video frame that was visible at the sample time Note that all VIDEO_ variables are applicable to SceneLink recordings or some Experiment Builder recordings only For SceneLink recordings please check out the Data Loading Preference Settings VIDEO NAME Name of the video frame that was visible at the sample time Note t All AVERAGE_ measures will have a missing value if both eye samples are not available if pupils are missing
41. time definition is found in a trial the TRIAL START TIME will be set as the start as the reaction time definition otherwise this will be set as the start of trial recording see section 6 5 3 on discussion of three time periods used in Data Viewer 6 11 Recording Event Sequence Data Recording Event Sequence Data is a trimmed version of the EyeLink ASC file For each trial it outputs the selected events only and excludes the hidden events 6 11 1 Obtaining a Recording Event Sequence Data To obtain a recording event sequence data report 1 From the menus choose Analysis gt Report gt Recording Event Sequence Data 2 In the Export dialog box browse to the directory in which you want to save the data 3 In the File name text box type in the name for the data 4 Press Export button 6 11 2 Formats of the Recording Event Sequence Data The following output is a trimmed version of a sample recording event sequence report MSG 5520005 DISPLAY COORDS 0 0 1023 767 MSG 5520005 FRAMERATE 85 05 Hz MSG 5520009 TRIAL VAR LABELS PAGE MSG 5684435 TRIALID PAGE1 START 5686598 BUTTON 5686573 5 true MSG 5686595 DRIFTCORRECT R RIGHT at 320 40 OFFSET 0 09 deg 4 1 1 4 pix MSG 5686597 RECCFG P 500 2 1 MSG 5686597 GAZE COORDS 0 00 0 00 1023 00 767 00 EFIX R 5686602 5686852 252 514 2 388 949 0 50 95 45 0 false 72 dogs BUTTON 5686716 5 false MSG 5686723 DISPLAY ON EyeLink Data Viewer 2002 2010 SR Research Ltd 10
42. to mark the start and end of a trial or important events such as display changes Message events can be toggled on off by clicking the Toggle Message Event Visibility button E in the application desktop toolbar A message is represented as a colored triangle in the temporal graph view and a colored square in the spatial overlay view centering on the current gaze position Each field of the message event property is listed in the following table Those fields that are editable in the viewer are marked with an asterisk EyeLink Data Viewer 2002 2010 SR Research Ltd 33 Label of the message Time Trial time when the message was presented Note that if the message is presented before the trial starts a negative time value will be displayed Command If the message 1s a command message this lists the actual command used The commands include simple drawing built in audio messages interest area commands etc Message text X Concurrent gaze coordinates when the message is recorded 100 if no gaze information was available for the time of the message event see reaction time definitions Whether the current message is hidden from viewing Color To achieve better visibility the color of the currently selected message can be changed by clicking on the color toolbox ro Eyetink Data viewer oxi File Edit Analysis Window Help Demee bene Moom eee mcm JEE Toggle Message Event visibility _ oI x Data w P
43. viewing sessions the variable selection in the reports can be automated by importing the previously saved property file by clicking on the Import Variable Selection button Hy 3 Once all the desired variables have been entered into the output list press NEXT button 4 In the Save dialog box browse to the directory in which you want to save the output report The default output directory can be configured through General Preferences 5 In the File name text box enter the name for the document and choose the appropriate file extension Note if the output report file extension set to All Files and the file name does not contain an extension the file name is appended with a txt by default 6 Press the Save button Data Viewer allows the user to configure the interest area report The user can exclude some trials by entering a string in the Exclude Trial String edit box This string should be one message or part of a message within the scope of the trial recording that uniquely defines that subset of trials to be excluded In addition to enable correct loading of string text variables in some statistics software the Viewer also has an option of adding a pair of quotation marks for such variables 6 8 2 Variables in the Interest Area Report Currently the interest area report provides information for the following variables Field RECORDING SESSION LABEL Label of the data file DATA_FILE File name of the recordin
44. with messages or other important events such as button presses If different images were shown within different interest period the user should also make sure that messages used to load images text or draw simple graphics be recorded with the scope of the intended interest period 6 4 1 Creating Interest Periods To create an interest period 1 Click the Interest Period List combo box at the far right hand of the application menu bar and select the Edit EyeLink Data Viewer 2002 2010 SR Research Ltd 60 2 Similar to the reaction time manager dialog the user can create a new interest button on the left edit an existing interest period period by clicking the New t by clicking on the Edit is button and remove an interest period by clicking on the Delete button Data Viewer also supports exporting and importing of interest periods across viewing sessions For example the user may create intended interest periods for one session Export the interest periods 11 into a property file by clicking on the Export the Interest Period button D For all future viewing sessions creation of the interest periods can be automated by importing the previously saved property file by clicking on the Import the interest period button 5 Click on the new L button In the Interest Period Editor dialog General Tab see Figure 6 13 enter a label for the current interest period in the label edit box and select th
45. within which the fixations appear will also be moved along EyeLink Data Viewer 2002 2010 SR Research Ltd 29 5 2 3 3 Cleaning Fixations For some studies researcher may want to clean up fixations based on certain rules Data Viewer provides two options for fixation cleaning 1 Fixation Filter preferences The user can filter out small fixations with Merge Nearby Fixations Fixation Merging Amplitude Threshold and Fixation Duration Threshold settings from the Data Filter preference If the Merge Nearby Fixations option is checked a fixation with a duration shorter than the value set in the Fixation Duration Threshold will be merged with a neighboring fixation if the latter is within the distance set by the Fixation Merging Amplitude Threshold 2 Four stage Fixation Cleaning Important This option was not intended for all users For some reading studies the users may want to apply a more refined fixation cleaning algorithm This can be done by select the intended Trial node or Recording session node click on the right mouse button and select the Clean option Clean Data x Stage 1 Stage 2 Stage 3 Duration Threshold a0 fao h 40 Distance Threshold E 1 25 Stage 4 Durations himii E Miiniriurri Maximum 200 Delete Fixations Outside Interest Areas Start Figure 5 4 Options for Fixation Cleaning 1 STAGE 1 For each interest area Data Viewer checks for each fixation whether its time
46. 1 MSG 5686726 SYNCTIME 3 ESACC 5686854 5686900 48 514 1 385 7 342 1 i 50 55 44 EFIX 5686902 5686980 80 340 2 80 6 47 0 5 the ESACC 5686982 5687012 32 339 6 84 4 192 6 50 25 43 EFIX 5687014 5687176 164 195 0 44 4 46 0 Loe not ESACC 5687178 5687192 16 189 7 41 5 155 1 50 35 43 ESACC 5687366 5687384 20 157 9 47 8 232 8 50 3 43 EFIX 5687386 5687588 204 233 9 54 8 45 0 3s not ESACC 5718822 5718836 16 621 3 723 4 677 1 52 35 46 7 EFIX 5718838 5718968 132 684 3 710 4 46 0 142 sides R R R R R EFIX R 5687194 5687364 172 153 8 45 2 44 0 2 did R R R R R ESACC 5718970 5719032 64 685 0 706 9 347 0 51 3 45 05 EFIX R 5719034 5719336 304 356 5 131 343 0 16 not BUTTON 5719243 5 true MSG 5719244 ENDBUTTON 5 END 5719345 MSG 5719360 TRIAL OK In this output file the display coordinates and frame rate were reported first followed by information from individual trials This includes the selected fixations saccades blinks messages and button events and excludes any hidden events For a Data Viewing session that loads in several recording sessions only the first recording session will be exported in the recording event sequence output file 6 11 2 1 Fixation Events Fixation events are recorded in the format of e EFIX lt eye gt lt stime gt lt etime gt lt dur gt lt axp gt lt ayp gt lt aps gt lt xr gt lt yr gt lt ma gt lt 1a gt This reports the eye used in the recording the t
47. 1 Cannot be less than 1 EyeLink Data Viewer 2002 2010 SR Research Ltd 132 8 4 Data Filter Preferences The data filter preference settings consist of the following elements ey Merge Nearby Fixations If checked merge the neighboring brief fixations A fixation to be merged must have a duration of less General than that specified by Fixation Duration e Pater oagng Threshold and be within 1 of the target E weer ae fixation These default thresholds are set in Jala Firers the Amplitude Threshold and Fixation Duration Threshold fields bi HH Data View s Fed Value e Fixation Merging Amplitude Threshold Sets ie alue the amplitude threshold for fixation hl Mearby Fixati erge Nearby Fixati _ merging The default value is 1 0 Fixation Merging A Fixation Duration Th Fixation Duration Threshold Sets the maces Baad pe fixation duration threshold for fixation merging A fixation will be merged if Merge Nearby Fixations is on and its duration is less than the specified duration threshold Display Blink Sacca Hide F Fixations Beya a Show Interest Area Show Interest Area i Saccade Amplitude Threshold Sets the a minimum size of a saccade to be displayed in the viewing session All saccades will be displayed with an amplitude threshold E set to 0 0 Hide Eye Events Gr Hide spanned Even Tritn pann
48. 28 8 3 Output Analysis The output analysis preference settings consist of the following elements a Inspector Memory Usage ct oe Data ul Preferences Preferences ia General am Data Loading Wutput Analysis oo Data Filters HE Data views Use Nearest Interes m Auto Select Interest Type 1 Duration Sigma fin degrees Low Activity Cut Fixed Minimum value Clip Map Below Fixe Fixed Maximum Value tl Title Center Positi Title Center Y Positi Enable Heat Map Mo EyeLink Data Viewer Output Reports Use UTF8 Encoding By default unchecked the saved output file will be a plain text file in ANSI encoding If checked the saved tab delimited text file will be in UTF 8 encoding and the XLS file will be in Unicode Text to better support non ASCII characters in the output reports Variable Delimiter t for Tab Specifies the delimiter string for separating columns in the output file Missing Value Replaces variables with missing value with a string specified here Decimal Places Specifies the number of digits to appear after the decimal point Include Hidden Events in Relative Variables Allows the inclusion of hidden events in the relative event variables 1 e those variables beginning with PREVIOUS_FIX_ NEXT_FIX_ PREVIOUS_SAC _ or NEXT_SAC _ Treat Hidden Events as Missing Values If hidden events in the relative variable
49. All fixation events in a selected trial are listed sequentially in the middle panel of the inspector window Properties of a selected fixation are shown in the bottom panel of the inspector window Each field of the fixation event property is described in the following table Those fields that are editable in the viewer are marked with an asterisk Label of the fixation The eye to which the current fixation event is associated Start Time Trial time when the fixation starts Please note that if an interest period filter 1s applied the duration start time and end time of the fixations that overlap with the start or end of the interest period will be adjusted accordingly EyeLink Data Viewer 2002 2010 SR Research Ltd 26 Trial time when the fixation ends Duration in milliseconds of the fixation Avg X Position Average camera X Y of pupil center Avg Y Position the current fixation and the previous next fixation fixation and the previous next fixation Direction Direction LEFT RIGHT UP or DOWN relative to the current fixation in which the previous next fixation 1s located RT End Event Whether the current fixation is the reaction time end event see section 6 3 1 for reaction time definition Whether the current fixation is hidden from viewing and output analysis To achieve better visibility the color of the currently selected fixation can be changed by clicking on the color to
50. BUTTON FIXATION SACCADE MESSAGE or NO_MATCH RT Definition Label Label of the reaction time definition see section 6 3 1 66 99 Managing Reaction Time Definitions 1f undefined CUSTOM if the RT definition is a custom one see Section EyeLink Data Viewer 2002 2010 SR Research Ltd 13 LD 7 4 Reaction Time Definitions Average Fixation Average duration in milliseconds of all fixations in the trial duration Average Saccadic Average size in degrees of visual angle of the saccades in Amplitude the trial Report Hidden Whether or not to hide the trial from output reports Interest Area Set Setting of the interest areas Custom Interest Area Set or Empty Interest Area Set If interest areas have been defined they can be removed by selecting Empty Interest Area Set X Resolution Angular resolution at current gaze position in screen pixels Y Resolution per visual degree 4 1 1 3 1 Hiding a Trial To hide a trial from the output reports 1 Click the trial to hide in the top panel of the data tab 2 In the bottom panel of the data tab which contains properties for the trial find the entry Report Hidden and change the current setting 4 1 1 3 2 Deleting a Trial To delete a trial from the Data Viewer simply place the mouse over that trial node click the right mouse button and select Delete The trial is permanently removed from the data viewing session and all other trial
51. E and RT_EVENT_START_TIME are the start and end time of the RT event fixation saccade button or message Reaction time REACTION_TIME is calculated as the difference between RT START _ TIME and RT_EVENT_START_TIME Please note that the RT EVENT_END_TIME and RT_EVENT_START_TIME will be the same when a button or message is used as the RT end event but will be different when a fixation or saccade is defined as the end event If the user does not create a reaction time definition or no valid reaction time definition 1s found for one trial REACTION TIME RT EVENT END_TIME and RT_ EVENT START_TIME and other variables related to reaction time definition will have missing values whereas RT_START_TIME will be the same as the trial recording start time START_TIME The interest period variables will have different values depending on the settings used in the interest period filter see Figure 6 16 If the interest period filter is set to Full Trial Period the start P_ START TIME end IP_END_TIME and duration IP_DURATION of the interest period will be same as those for the recording period e START_TIME END_TIME and DURATION If the interest period filter is set to Reaction Time Period the start end and duration of the interest period will be same as those for the reaction time period If the user has created her his own interest period see section 6 4 1 and that interest period is used to filter events the output
52. EDF files 6 9 2 Obtaining a Sample Output Report To obtain an output report for samples 1 From the application menus choose Analysis gt Report gt Sample Report a EyeLink Data iewer File Edit Analysis Window Help Reports Recording Event Sequence Data Trial Variable Manager Fixation Report Ctrl F aE Trial variable Yalue Editor Saccade Report Reaction Time Manager Interest Area Report Trial Report CErl T Initialize Reaction Time Events Sample Report Message Report 2 E El Trial 2 Figure 6 26 Creating a Sample Report EyeLink Data Viewer 2002 2010 SR Research Ltd 91 2 In the following output report dialog Select the variables in the list of available output variables left panel and press gt gt to enter the variables into the list of selected output variables a Sample Output Report 5 x Selected variables RECORDING SESSION LABEL Ressesele Variables _AVERAGE_ACCELLERATION_ Y AVERAGE ACCELLERATION Y FAVERAGE GAZE AVERAGE _GAZE_ AVERAGE_INTEREST_AREA_ID AVERAGE_INTEREST_AREA LABEL AVERAGE PUPIL_SIZE AVERAGE VELOCITY X AVERAGE VELOCITY Y DATA _FILE HTARGET_DISTANCE Variable Definiton Gaze coordinate along the x axis across two eyes Exclude Trial String Include Hidden Events in Relative Previous Next Variables Treat Hidden Events as Missing Values in Relative Previou
53. ENT_MSG_INTEREST_ARE Interest areas in which the current eye position AS falls when the message is recorded CURRENT MSG_INTEREST_ARE The index of the interest area in which the A_INDEX current eye position falls when the message is recorded CURRENT MSG _INTEREST_ARE Label for the interest area in which the current a reaction time definition a reaction time definition CURRENT MSG LABEL Label of the current message event CURRENT_MSG_SAC_AMPLITU Amplitude in degrees of visual angle of the saccade to which the message is associated OCITY saccade to which the message is associated N associated CURRENT _ MSG SAC _END_TIME End time relative to the start of the interest period of the saccade to which the message is associated CURRENT MSG SAC END X X coordinate of the end point for the saccade to EyeLink Data Viewer 2002 2010 SR Research Ltd 99 pt which the message is associated which the message is associated associated LOCITY to which the message is associated CURRENT _ MSG SAC START TI Start time relative to the start of the interest ME period of the saccade to which the message is associated which the message is associated which the message is associated Trial time relative to the start of the interest period of the message CURRENT_MSG_X_POSITION X position of the current message text It may be a missing value if samples are not loaded in the viewing sessi
54. ESSION LABEL AVERAGE SACCADE AMPLITUDE AVERAGE_ RESOLUTION AVERAGE _ RESOLUTION BLINK_COUNT gt gt ths BUTTON_PRESS_COUNT DATA _FILE lt lt bd DURATION END_TIME EYE USED FIXATION COUNT peerage duration in milliseconds of all selected fixations in the ewan Definiton trial Exclude Trial String Place Quotes i 3 Around String Text variables Reset Cancel Next Figure 6 16 Variables used in the Trial Report e To remove one variable from the output list simply select that variable and press lt lt e To change the order in which the variables are listed simply select one variable and use the a or button to move it to the desired position Repeat this step until all variables are in the right position e Data Viewer supports exporting and importing of variable selection across viewing sessions For example the user may go through each of the output reports to configure the selection of variables in an intended order Export the variable selection into a property file by clicking on the Export Variable Selection button E For all future viewing sessions the variable selection in the reports can be automated by importing the previously saved property file by clicking on the Import Variable Selection button i EyeLink Data Viewer 2002 2010 SR Research Ltd 64 3 Once all the desired variables have been entered into the output
55. EyeLink Data Viewer User s Manual Document Version 1 10 123 Please report all functionality comments and bugs to support sr research com Copyright 2002 2010 SR Research Ltd EyeLink is a registered trademark of SR Research Ltd Mississauga Canada Table of Contents L GRO UC CO haat sateen eee l 1 1 Pata Visualization E A Tae esc da taiyece onan tbe meeee aoa l R EV e E O a AE 2 1 3 lateres Area Definition esse E E E 2 ke Eyen PEAN e a A 2 1 5 Interest Periods and Reaction Time Definition ensessseeenssssssseeeeressssssseeeeees 3 1 6 Data Output and Amal ysis anscia a a 3 1 7 Experiment PINS OT ALON ssi E N teh 4 Ze a Oaa A R 5 2al SYNER CTENI oere E A E E 5 22 SCUD ea tae renee anual ca ah O 5 2 2 1 For Standard Installation applicable to most users sseseeenssesssseeesssssseee 5 2 2 2 For Installation using Network Licensing sseoeeenesesssseeerrsssssssseerrssssssese 6 es WY Oi IA Vy EN Te Caceres E ace Neate ae a T A 7 3 1 Creating a Data Viewing Session DVS ccccccssssssecccecceeeaeeesececeeeesaeeesseeeeeees 7 3 2 SAVING a VICWING Sessionen nie e na ET 7 3 3 Opening an Existing Viewing SeSSlOMN sev vices nipein oki deer vie aces eteeeled 7 3 4 Saving an Existing Viewing Session to a Different File cc eeeeeeeeeeeees 8 39 Importing an By elink Data Terere a TA A 8 a Data Viewer Window Sxcsacaicesstessacseete Sansui ies onaaseadetaanncn ace es emacs 10 4 1 Mi
56. Fixation Report Trial variable value Editor Saccade Report BeactionTime Manager Interest Grea Report Initialize Reaction Time Events Trial Report Ctrl T Sample Report T Data 9 Untitl A text a E Ed Trial 2 Message Report Figure 6 19 Creating a Fixation Report 2 In the following output report dialog Select the variables in the list of available output variables left panel and press gt gt to enter the variables into the list of selected output variables EyeLink Data Viewer 2002 2010 SR Research Ltd 70 2 ination Output Report O vailable variables CURRENT FIX BUTTON 4 PRESS al CURRENT FIX BUTTON 5 PRESS EF CURRENT FIX BUTTON 6 PRESS CURRENT FIX BUTTON 7 PRESS CURRENT_FIX_BLUITTON_8_PRESS Selected Variables RECORDING SESSION LABEL are ETN a CURRENT FIX END OTHER CURRENT FIX INDEX CURRENT FIs INTEREST ARES of 4 d Variable Definition CURRENT_FIS_DURATIOM Duration of the current fixation Exclude Trial String Include Hidden Events in Relative Previous Next Variables P Treat Hidden Events as Missing values in Relative Previous Next Variables Place Quotes 3 Around String Text variables Reset Cancel Next Figure 6 20 Variables in a Fixation Report e To remove variables from the output list simply select the variables and press lt lt e To change the order in which the variables are listed
57. GS Flags used to indicate the head target tracking status if target tracking is ok otherwise error code for an EyeLink Remote recording Returns a missing value if the data was recorded with non Remote eye tracker End time in milliseconds since EyeLink tracker was activated of the interest period the viewing session Start time in milliseconds since EyeLink tracker was activated of the interest period TRIAL_LABEL Label of the trial the left eye along the x axis Acceleration value in degree second second of the left eye along the y axis LEFT_GAZE_X Left eye gaze coordinate along the x axis LEFT_GAZE_Y Left eye gaze coordinate along the y axis sample falls sample falls LEFT_IN_ BLINK Whether the left eye is in a blink LEFT_IN SACCADE Whether the left eye is in a saccade LEFT_PUPIL_SIZE Left eye pupil size of the current sample LEFT_VELOCITY_X Velocity value in degree second of the left eye along the x axis LEFT_VELOCITY_Y Velocity value in degree second of the left eye along the y axis RESOLUTION_X Horizontal angular resolution in screen pixels per degree for the sample RESOLUTION_Y Vertical angular resolution in screen pixels per EyeLink Data Viewer 2002 2010 SR Research Ltd 94 po degree forthe sample the right eye along the x axis the right eye along the y axis sample falls sample falls RIGHT_IN_BLINK Whether the right eye is in a blink RIGHT_IN_ SACCADE Whether
58. If a USB Dongle is not detected by the program the application will run in a DEMO mode supporting limited data loading 2 2 1 For Standard Installation applicable to most users The following installation instruction is applicable to users who use a standalone USB dongle that supports a single PC license 1 Install the EyeLink Data Viewer software Double click on the EyeLinkDV1 exe installer keeping the default settings 2 Install standalone HASP key driver if this is the first time that the USB dongle have been used on the display PC You may install the driver by clicking Start gt All Programs gt SR Research gt Install HASP Driver from your computer EyeLink Data Viewer 2002 2010 SR Research Ltd 5 desktop or double clicking on hdd32 exe in C Program Files SR Research Common folder Plug the dongle to the display computer Click on the License Manager utility Start gt All Programs gt SR Research gt License Manager to check for the licensing status for the Data Viewer software From the computer desktop click Start gt All Programs gt SR Research gt EyeLink gt Data Viewer gt DataViewer to run the application 2 2 2 For Installation using Network Licensing The following is applicable to the users who have purchased a network license 1 e a shared license for several computers on a network that running EyeLink Data Viewer at the same time for the Data Viewer software l
59. Interest Area Set if no interest areas are defined The middle panel of the inspector window lists all available interest areas in that trial The following table lists the properties of an interest area Those fields that are editable in the viewer are marked with an asterisk e EyeLink Data Viewer E lajx File Edit Analysis Window Help olelsjels xlolalolaisie Molol sls lalslele 5 Trial Period Inspector Trial View text Trial 1 Data a Preferences acl SEA alal 9 Untitled grs ot Buck aid nc readlthe newapapers orhelwouldlhavelknowelthat gi trouble was orewing Jnotfaione rornimseir outforlevery ide water i Trial 4 Interest Area Ternplates dog renales pozani longa rom Pusw Soundho afeoetsJand becaueelteemshiplandjranaportaten zompentes booming the find thousands of men were rushing into the Nentland These enfwarted doge andlhe sogs hey veniedlwore pro t them from the frost Buck vedlaalbig housenfnelsun Kssed Santa Claral Valley JudgelMirsplace ns caloa Wtooacktom heond ha LAm rpeesonulalbaiphat thelvielool erencalrrnlerunalefouiies Figure 5 10 Sample Text Display Overlaid with Interest Areas Buck l RECTANGLE an 51 0 23 0 146 0 B2 0 6036 0 EyeLink Data Viewer 2002 2010 SR Research Ltd 38 Text of the interest area ID Ordinal ID of the interest area Label of the group to which the current interest area belongs Top Y
60. K lt eye gt lt stime gt lt etime gt lt dur gt This reports the eye used in the recording the time of the first and last sample in the blink and computes the duration of the blink in milliseconds 6 11 2 4 Message Events Messages are recorded in the format of e MSG lt time gt lt message gt A message line contains the text of a time stamped message The lt message gt text fills the entire line after the timestamp lt time gt and any blank space following it 6 11 2 5 Button Events Button events are recorded in the format of e BUTTON lt time gt lt button gt lt button_pressed gt Button lines report a change in state of tracker buttons The lt button gt reports which button has changed state The lt button_pressed gt value will be true if the button has been pressed false if it has been released EyeLink Data Viewer 2002 2010 SR Research Ltd 103 7 Protocol for EyeLink Data to Viewer Integration The EyeLink Data Viewer can interpret a set of message commands from an EyeLink data file that allow the viewer to automate some of the viewer configuration for a given data file or trial Examples of these commands include defining the image to overlay and specifying trial variables These messages can be written by the display experiment to the EDF file using the API function that allows the writing of a custom message to the EDF file Messages that make up the EyeLink data file protocol for the viewer are n
61. S or he Would have knowa that z Trial 184 244 248 148 200 z i trouble wae brewing ndbalone for hims l but for very tide lt water naris rea I empla ates 312 228 iii dog Strong Gf muscle and with warm l6ng hair fr m Puget Sound to 228 176 220 184 188 272 312 4 m SaM Diege Because men groping irtthe Arctie darkhess had_found 40 208 224 260 ee 220 a yellow metal atid becausesteamship_and transportatioh companies 188 284 werebooming the find thousands of nen were rushihg into the 264 196 168 Northlahas These men wanted dogs and the dogs they Wanted Gere 208 248 heavy dogs withStrong muscles by which to toll and furry coats to protect th em fromthe frost 104 280 2 232 Bu k lived at a big ouse in the sun kiss d Santa Clara Valley Judge Mitler s placedit was c lled It Stood back from the road Half 304 204 hidden aiitong thedrees throtigh which glimpses coule caught of 308 236 the Wide Gool veranda that ran around its four sides Figure 5 1 Sample Spatial Overlay View of Fixation Events The trial view window Figure 5 1 right panel shows either a spatial overlay view or a temporal graph view of the fixation events In the former view fixations are represented as a hollow circle in the corresponding x y coordinates on the trial bitmap with fixation duration displayed near the top left corner of the circle In the temporal graph view fixations are represented as a filled block
62. T which are calculated relative to TRIAL START _ TIME will be different depending on whether a valid reaction time definition is found for the trial Note Messages written in the EDF file will be associated with an event closest in time So for a fixation report the message could appear during a preceding saccade EyeLink Data Viewer 2002 2010 SR Research Ltd 77 PREVIOUS_SAC_ MSG_ or a following saccade NEXT_SAC_MSG_ In very rare cases the message can be written to both saccade and fixation events if the message was written out after the last sample of a fixation or saccade but before the first sample of the following saccade or fixation Note A run of fixations refers to a group of consecutive fixations that are directed towards the same interest area Thus for example the interest areas of 10 fixations are A A B A A A C A E D Therun count will be 7 The following table summarizes the values for some relevant variables Variables CLA A B Ja ja A C a JE D_ Run not listed in the variable list 1 f1 2 3 3 3 4 5 f6 7 CURRENT_FIX_INDEX 1 2 3 4 fs 6 7 8 9 10 REA_INDEX ae e eA REA_FIX_COUNT REA_RUN_ID EE EST_AREA E INTEREST _ AREA CURRENT_FIX_RUNINDEX 1 2 1 ji 2 3 1 i i CURRENT_FIX RUN SIZE 2 2 1 3 3 3 i 1 6 6 3 Configuring the Fixation Report In addition to excluding some trials by entering a string in the Exclude Trial String edit box the fixation repor
63. Tria 2 Output Analysis Grouping OD Trial 3 oe Data Filters text Trial LA Set Treeview l Hol Custom Interest Area Set beeg Image Segmentation H E Trial 2 s Time Plot 4 0 Trial 3 oj Animation Eoo TA Template FEI Trial 4 F H E Interest Area Templates w Ha Empty Interest Area Set Field TE Fixation Sample Trace Color Event List KE Fixation A 40 Fixation 630ms Display Fixation Index 0 ED Fixation 882ms Display Fixation Dur T Fixation 1086ms e ee ee Displey Foationsas bon Concurrent see Start Time goms ET Pam Trace Grane B oo ooo o Properties Sample Tick Period 200 Sampe Tek Wich Avg amp Position 115 4 a 0 3 rimam TA Siz Avg Y Position EyeLink Data Viewer 2002 2010 SR Research Ltd 11 Figure 4 2 Components of the Inspector Window Left Data Tab Right Preference Tab 4 1 1 1 Data Tree Hierarchy When a data file is loaded the tree view panel lists the possible analysis levels in a hierarchical order The user can obtain information on the trial groups and individual trials Within each trial statistics on all events fixations saccades blinks button presses and messages and interest areas can also be retrieved 4 1 1 2 Trial Grouping By clicking on a trial grouping node information on this trial group can be obtained in the bottom panel of the data inspector Typically this includes the label of group values of the grouping variables total number
64. Y COORDS or GAZE COORDS Description This message specifies the display coordinates to be used within the viewer This message MUST be present for the viewer to function correctly Format DISPLAY COORDS lt Lett gt lt top gt right lt boltvon gt Left top right and bottom refer to the x y coordinates of the top left and bottom right corners of display Example MSG 3324002 DISPLAY COORDS 0 0 1279 025 7 2 3 Trial Grouping Identifier V TRIAL GROUPING Description Trial grouping message is used to group those trials in the same experimental condition together so that they can be manipulated e g selecting hiding deleting applying interest area templates collectively This message must be sent after TRIAL_VAR_LABELS message but before first trial start message in EDF file Format V TRIAL GROUPING trial warieble List The trial grouping variable s must be a member of the variables listed in the TRIAL_VAR_LABELS otherwise this variable is simply ignored Example MSG 3363553 V_TRIAL_GROUPING TYPE DIRECTION EyeLink Data Viewer 2002 2010 SR Research Ltd 106 Note Trial variables are space delimited Trial variables that do not exist in variable list for trial are ignored 7 3 Trial Message Commands The following message commands MUST be specified within the scope of a trial or the message commands will not be interpreted by the viewer IMPORTANT All message commands within the trial scope mu
65. _ ADJUSTED Whether the current fixation has been adjusted manuall CURRENT_FIX_BLINK Whether there is a blink preceding or following the _ AROUND current fixation Possible values are AFTER a blink follows the current fixation BEFORE a blink precedes the current fixation BOTH the current fixation is flanked by a preceding and a following blink or NONE no blink appears around the current fixation CURRENT_FIX_BUTTON_O_PR_ Time from trial start if a specific button 0 8 has ESS been pressed during or after fixation If no button cs press is made from the start of the current fixation CURRENT_FIX_BUTTON_8_PR_ to the start of next fixation missing value is ESS assigned Trial time when the current fixation ends on the other eye in a binocular recording CURRENT_FIX_INTEREST Interest area in which the current fixation falls _AREAS CURRENT_FIX_INTEREST_ARE Total amount of fixation dwell time in msec on A_DWELL_TIME the interest area to which the current fixation belongs A_FIX_ COUNT which the current fixation belongs A_GROUP current fixation is assigned CURRENT _FIX_INTEREST The index of the interest area in which the current EyeLink Data Viewer 2002 2010 SR Research Ltd 72 AREA INDEX fixation falls CURRENT _FIX_INTEREST_ ARE Label for the interest area to which the current A_LABEL fixation is assigned CURRENT_FIX_INTEREST_ARE The ordinal sequence of the current run
66. a tedd gs and the dogs they Wanted Were Delete Delete h avy dogs with Strong muscles oy which to toll and furry couts to Split gt ace ae protect th em fromthe frost gt gt Feat 25 2578ms Drift Ci rect Ctrl D Butk lived ata bigh ouse in the sun kissed Santa ClaraValley Judge Miller s place it was called It Stood back from thetoad Half hidden aitiong thettrees throghwhich glimpses ou caught of 308 236 the Wide Gool veranda that ran around its four sides Select All Ctrl A Fix Select Hidden Trial Grouping tr Avg x Position Avg Y Position 7 0 Figure 5 3 Drift Correcting Fixations on One Line of Text 5 2 3 2 Precise Drift Correction of a Single Fixation To carry out more precise drift correction of one fixation 1 Select the fixation to be drift corrected 2 In the property panel of the Inspector window select the entry for Avg X Position and type in the desired X position 3 Select the entry for Avg Y Position and enter the desired Y position Note Drift correcting one fixation or a group of fixations changes the properties of some relevant events such as the start end point of a preceding or following saccade and its amplitude Tip Before moving the fixations it is desirable to turn off the interest area set by pressing Toggle Interest Area Visibility button in the application desktop toolbar Otherwise the interest area s
67. abel hew FT 01 Type saccade Event Trial Condition Qualifiers Selected Value Trial Conditions Figure 6 9 Reaction Time Definition Editor General Tab Select the Reaction Time tab see Figure 6 10 a Reaction Time Definition Editor x General Reaction Time Start Time Message Text SYN TIME End Time Minumum Saccadic Amplitude s o Saccade End Point Center Jann Y 384 Region Diameter 50 0 Figure 6 10 Reaction Time Definition Editor Reaction Time Tab The layout of the Reaction Time tab depends on the type of end event you selected in the General tab One common feature though is the configuration of EyeLink Data Viewer 2002 2010 SR Research Ltd 57 the start time message In the Start Time Message Text edit box type in the intended message string the default is SYNCTIME Button Event This will treat a particular button press release as the reaction time end event Select the intended button ID from the Button Number combo box and choose the button state button press or release Message Event This will treat the first occurrence of a matching message as the end event for reaction time calculation In the Message Text edit box type in the message string DO NOT include quotes for text strings Fixation Event This will end the trial by the appearance of a specific fixation In the edit boxes fill in the minimum fixation duration in millisecond required as wel
68. ade Report Currently the saccade report includes the following saccade related information index start time end time start xy coordinates end xy coordinates duration amplitude angle direction average velocity peak velocity interest areas of the current previous and next saccades and whether these saccades have been selected for analysis It also contains the following information on the previous fixation and the next fixation angle blink around direction distance duration start time end time pupil size trial span the interest area in which the fixation is located the nearest interest area and whether the fixation has been selected for analysis In addition the report contains labels of the data file data file and individual trials as well as other user defined variables see section 6 6 2 Variables in the Fixation Report for the complete list of variables and their meanings EyeLink Data Viewer 2002 2010 SR Research Ltd 79 2 accade Output Report x Selected Variables RECORDING SESSION LABEL Available Variables CURRENT_S4C_ADIUSTED a FCURRENT SAC AMPLITUDE CURRENT_SAC_ANGLE CURRENT_SAC_AVG_VELOCITY CURRENT_5AC_CONTAINS_BLINK CURRENT_SAC_DIRECTION CURRENT_SAC_DURATION CURRENT_SAC_ENC_INTEREST_AREAS CURRENT_SAC_END_INTEREST_AREA_INDI E cll 4 a i Amplitude of the current saccade in degrees of visual angle DeFinibon Exclude Trial String
69. ades can be merged If saccades are selected that are not temporally contiguous only the neighboring saccades will be merged 5 4 Blink Events Blink events can be toggled on off by clicking the Toggle Blink Event Visibility button P Blink is represented as a colored solid line in both the spatial overlay view and the temporal graph view Each field of the blink event properties is listed in the following table Those fields that are editable in the viewer are marked with an asterisk EyeLink Data Viewer 2002 2010 SR Research Ltd 32 Label of the blink The eye to which the current blink event is associated Start Time Trial time when the blink starts Trial time when the blink ends Duration of the blink Whether the current blink is hidden from viewing Color To achieve better visibility the color of the currently selected blink can be changed by clicking on the color toolbox iol xi Dielja alaa Moom eese Frama Trial iew TEST Trial 1 Toggle Blink Event Visibility o x Data if Preferences 9 Untitled evs 0 ms 463 927 1391 1855 2318 2782 3246 3710 4174 4637 5101 551 l l l l l l l l l Trial 7 lt p Blink 490ms ave Blink 1018ms lt p Blink 3182ms Figure 5 6 Sample Temporal Graph View of Blink Events 5 5 Messages Messages including message for built in EyeLink commands can be placed in the EDF file
70. age Text Start Time Offset Button Murer any C Released End Time Offset b Pressed End Time Figure 6 14 Interest Period Editor Details Tab Similar to the reaction time definition the layout of the Details tab depends on the type of the end event the user selected in the General Tab Button Event This will treat a particular button press release as the interest period end event In the Start Time Message Text edit box enter the message string case sensitive DO NOT include quotes for text strings if an empty string is used this will be the start of the trial recording Select the intended button ID from the Button Number combo box and choose the desired button state button pressed or released The user can also specify a time offset 0 or a positive number in milliseconds for the start time and end time so that the interest period does not start or end right on the time of message and or button event Message Event This will treat the first occurrence of a matching message as the end event for the interest period Enter the desire message strings for both the Start Time and End Time Message Text edit boxes case sensitive with no quotes for text strings a valid message must be supplied for both start and end time message text fields The user can also set a time offset O or a positive number in milliseconds for the start time and end time Please note that when using this option the intere
71. aiabeieuss 61 Figure 6 14 Interest Period Editor Details Tab 0 0 cseeeseeecceeeeeeeeeseeeeeeseeeaaas 62 Pieure 6 15 Creating a Trak REDOT esinen pa a ea 63 Figure 6 16 Variables used in the Trial Report 2 0 0 0 ceccccccccccceeeeeeeeseeeeeeeeeeeeeeeeeeees 64 Figure 6 17 Saving the Output Report uiccritsoiacncinetintawicetiginaladiaatiiiemiewiatinns 65 Figure 6 18 Using Interest Period for Event Filtering cc ecessseseeeeseeeeeeeeeeeeeees 68 Pioure 0 19 Creating a Fixat or Report casaast covets a eens aia 70 Figure 6 20 Variables in a Fixation Report ccccccsseeecccceeecceceeeeaeeaeaeseeseeeeeeeeeeeeeees 71 EyeLink Data Viewer 2002 2010 SR Research Ltd vi Figure 6 2 12 Creatins a saccade Repol siceta iwi os neta a E 79 Figure 0 22 Vanables ina Saccade KEPOLEN NENE 80 Figure 6 23 Creatine an Interest Area Rep rtasrsinsss a a A 81 Figure 6 24 Variables in an Interest Area Report ccccccccccceeeeeeeeeseeeeseeeeeeeeeeeeeees 81 Figure 6 25 Progress Dialog Box Displayed when Creating the Interest Area Report 88 Figure 6 26 Creating a Sample REPOT seccdesvecctivceicecdinauswasesssvededuveentiabsteeedeuhatasselestadeanees 91 Figure 6 27 Variables in a Sample Report neseesssseeeensssssssseerrsssssssseerresssssssseerressss 92 Froure 0 25 Creatine a Messa Repor oinar E E E 97 Figure 6 29 Variales in a Message Reportt ssssssssseeeeeerereesssssssssssssssseeeerreeeeeesssssss 97 Figure
72. al into a movie file ror Trial View text Trial 1 ol x T speen fioo 2 1 1 B 00000000 ms Buck did not read the newspapers or he would have known that trouble was brewing not alone for himself but for every tide water dog strong of muscle and with warm long hair from Puget Sound to san Diego Because men groping in the Arctic darkness had found a yellow metal and because steamship and transportation companies were booming the find thousands of m n were rushing into the Northland These men wanted dogs and the dogs they wanted were heavy dogs with strong muscles by which to toil and furry coats to protect them from the frost Buck lived at a big house in the sun kissed Santa Clara Valley Judge Miller s place it was called It stood back from the road halt hidden among the trees through which glimpses could be caught of the wide cool veranda that ran around its four sides Figure 4 6 Sample Playback Animation View To save the playback of trial data into a movie file click on the save To Movie button 5 on the trial view window toolbar In the following Movie Save Options dialog box enter the movie file name file type AVI or MOV frame rate and compression method Click Start to begin moving saving Depending on the size of recording file this may take a long time to finish At any point user can press ESC key to stop the Saving process Playing back video clips in the animation view
73. ameter of the fixation region Pre Trial Message Command Format V_RT SACCADE lt rt_start_msg gt lt saccadic_amplitude gt lt x gt lt y gt lt diameter gt CONDITION LABEL 1 condition value 1 GONDITION LABEL 2 condition value 2 Trial specific Message Command Format YV V CRT SACCADE lt rt_start_msg gt lt saccadic_amplitude gt lt x gt lt y gt lt diameter gt Note If the location information of the saccade is not important set the values of x y and diameter as 1 Condition labels and their values are not required for the trial specific message command and optional for the pre trial message command if not specified the RT definition is applied to all conditions EyeLink Data Viewer 2002 2010 SR Research Ltd 119 Example MSG 329381 V_RT SACCADE SYNCTIME 5 0 300 400 100 TYPE Normal In this example the RT end event is the occurrence of the first saccade with a minimum amplitude of 5 0 degrees of visual angle The saccade must fall within 50 pixels from the region center 300 400 7 4 4 Message Events Identifier MESSAGE Description This will treat the first occurrence of a matching message as the end event for reaction time calculation Pre Trial Message Command Format V_RT MESSAGE lt rt_start_msg gt lt rt_end_msg gt CONDITION LABEL 1 condition value 1 CONDITION LABEL 2 condition value 2 Trial specific Message Command Format V V_CRT MESSAGE lt rt_start_msg gt
74. an integer between 0 and 255 Format V FILLBOX lt red gt lt blue gt lt green gt lt top gt lt left gt lt right gt lt bottom gt Note Left top right and bottom refer to the x y coordinates of the top left and bottom right corners of rectangle Example MSG 9441901 V FILLBOX 0 0 255 400 500 500 600 This draws a rectangle with the top left corner at 400 500 and the bottom right corner at 500 600 The rectangle is filled with the blue color 7 3 4 5 Drawing a Fixation Point Identifier FLXPOINT Description This command draws a fixation point at a specified position Format EyeLink Data Viewer 2002 2010 SR Research Ltd 112 V FIXPOINT lt target_red gt lt target_blue gt lt target_green gt lt erase_ red gt lt erase_green gt lt erase_blue gt lt x gt lt y gt lt outer_diameter gt lt inner diameter gt Note The RGB values for the fixation point drawing color is specified by the lt target_red gt lt target_blue gt lt target_green gt whereas the color of the fixation center 1s specified by lt erase_red gt lt erase_green gt lt erase_blue gt The lt outer_diameter gt and lt inner_diameter gt specified the diameters of the drawing circles Example MSG 9441901 V FIXPOINT 0 0 0 255 255 255 511 383 18 4 This draws a fixation point at 511 383 with a diameter of 18 pixels for the outer ring and 4 pixels for the inner ring The fixation point is drawn in black and its cen
75. and Trial Load End Message Define the start and end messages of data loading For each trial all events samples before the start message or after the end message will not be loaded By default the Viewer treats the TRIALID as the start message for data loading and TRIAL_RESULT as the end message Note the Trial Load Start Message must be one message before START recording otherwise the Viewer will internally re set the loading position at the start of trial recording to keep trial data integrity All Trial Variable Labels Message and All Trial Variable Values Message The former allows the definition of labels to be used for trial variables within the viewer and the latter specifies the list of trial variable values for the trial By default the trial variable labels message is set as TRIAL_VAR_LABELS and the trial variable values message is set as TRIAL_VAR_DATA Single Trial Variable Message This command lets the user specify a trial variable and value for the given trial Send one message for each pair of trial condition variable EyeLink Data Viewer 2002 2010 SR Research Ltd 127 and its corresponding value This means that there is really no need to use TRIAL_VAR_LABELS command when using TRIAL_VAR command Default command token is TRIAL VAR Target Position String String used to specify the position of the targets at the specific message time Exclude Message String Any messages within t
76. and visibility of the targets at the specific message time The command identifier can be changed in the data loading preference settings Format V TARGET_POS lt Targetl Key gt lt targetl x targetl y gt lt target 1 visibility gt lt target 1 step gt lt Target2 Key gt lt target2 x target2 y gt lt target 2 visibility gt lt target 2 step gt Where lt Targetl Key gt and lt Target2 Key gt the tokens to extract the position s of target s lt targetl x targetl y gt and lt target2 x target2 y gt the position s of the targets The coordinates must be enclosed in a pair of brackets lt target I visibility gt and lt target 2 visibility gt if 1 the targets are visible if 0 the targets are hidden lt target 1 step gt and lt target 2 step gt if 1 the position of the target will be in steps if 0 the position of the target is interpolated across samples Example EyeLink Data Viewer 2002 2010 SR Research Ltd 116 MSG SOT LOOO I TV TARGET POS TARGI S51 270 Jd O7 TARGZ 39907 134 1 0 Note The user can use any token word to indicate the target ID The key property of the temporal graph preference settings is set to blank by default so that various token words can be used If two targets are involved and if the order of the two targets is important set that field to the token strings used in the target position command string 7 4 Reaction Time Definitions To obtain an accurate rea
77. at the matching is case sensitive although the Image Name mapping text does not need to be the full image path in the trial If no matching Image Name Mapping text was found for the trial in any IAS template then the default empty interest area set template will be used for the trial To illustrate the use of automatic trial 1mage interest area set association create a Data Viewer session and load in the sample picture EDF file File Import Data gt EyeLink File s and segment files test1 1as test2 1as test3 1as and test4 ias File gt Import Data Interest Area Template The second trial of the EDF contains the following image loading command message MSG 62817663 V IMGLOAD FILL images Sac_blur jpg If the user wants to associate the test2 1as to Trial 2 first make sure that the Auto Select IAS for Trial property in the Output Analysis preference settings is checked Click on the test2 1as in the treeview and enter Sac_blur jpg case sensitive without quotes in the Image Name Mapping field Now the interest areas contained in test2 1as will be drawn on the Trial View Window for Trial 2 EyeLink Data Viewer 2002 2010 SR Research Ltd 43 o x a Inspector E_j EP Data gf Preferences Untitled evs Ha picture F CI Trial 1 CI Triat 2 CI Trial 3 Interest Area Templates Yp Ej i house testi jas test jas
78. ate more interest areas of the same type Press the Selection mode icon R from the Application Desktop toolbar to end creating interest areas Note Please avoid creating self intersecting freehand interest areas as this will cause problems for the proper calculation of the pixel area within the region EyeLink Data Viewer 2002 2010 SR Research Ltd 40 gr Trial Yiew picture Trial 1 4rea of Interest Mame FreeHand carcel Figure 5 11 Creating a Freehand Interest Area Several Interest Areas of the same type can be created in a sequence by following the above steps 5 8 2 Creating Interest Area Image Segmentation If a trial bitmap has already been loaded the Data Viewer can create interest areas for the trial by auto segmentation This is done by clicking the Auto Segment Image to Interest Area button A in the toolbar of the spatial overlay view window Note Using the auto segmentation feature will remove all of the pre existing interest areas for the trial Auto segmentation is more feasible for those displays in which the individual items can be easily isolated such as in reading and visual search studies where a background of a single color is present but not good for some visual scenes in which the boundaries between individual elements are not clearly defined see Section 8 7 on preference settings for image segmentation 5 8 3 Saving Interest Areas To save interest areas of a trial to be used
79. ation end event the minimum fixation duration in milliseconds required the xy coordinates for the region center as well as the diameter of the fixation region Pre Trial Message Command Format VORI FIXATION lt ricstartmsq gt lt Lixabionduration gt x gt lt y gt lt diameter gt CONDITION LABEL T condition value 1 CONDITION LABEL 2 condition value 2 Trial specific Message Command Format EyeLink Data Viewer 2002 2010 SR Research Ltd 118 iy WICRT FIXATION lt re Startmsg gt lt fixation durabion gt lt K gt y gt lt diameter gt Note If the location information of the target fixation is not important set the values of x y and diameter as 1 Condition labels and their values are not required for the trial specific message command and optional for the pre trial message command if not specified the RT definition is applied to all conditions Example MSG 329381 V_RT FIXATION SYNCTIME 500 1 1 1 In this example the RT end event is the occurrence of the first fixation with a minimum duration of 500 milliseconds whereas the location information of the fixation 1s not important 7 4 3 Saccade Events Identifier SACCADE Description This will end the trial by the appearance of a specific saccade The user can specify the parameters of the saccade end event the minimum saccadic amplitude in degrees of visual angle required the xy coordinates for the region center as well as the di
80. aximum value will be painted with the high activity color Draw Title If checked a title is displayed on the fixation map Title Center X Position 0 100 The X position for the center of the title in percent of the display width Title Center Y Position 0 100 The Y position for the center of the title in percent of the display height Text Color Sets the color for the text of the heat map title and legend Enable Heat Map Mode If checked the fixation map will be drawn in a colored heat map if unchecked a grayscale version will be created Transparency 0 0 100 0 Sets the transparency level of the heat map If 100 the heat map will be solid Low Activity Color Sets the color used to draw low activity area Medium Activity Color Sets the color used to draw medium activity area High Activity Color Sets the color used to draw high activity area EyeLink Data Viewer 2002 2010 SR Research Ltd 131 Draw Legend If checked a color scale is displayed on the fixation map Legend Center X Position 0 100 The X position for the center of the legend in percent of the display width Legend Center Y Position 0 100 The Y position for the center of the legend in percent of the display height Fixation Stream Analysis Fixation Skip Count Defines the number of fixations to skip when looking for the next interest area to use in the fixation sequence analysis variables of the Interest Area report Default is
81. cade 2112ms lt gt Fixation 2148ms gt Saccade 2656ms f Start fea EyeLink Data Viewer 3 20 PM Figure 4 3 Tiling Trial View Windows 4 3 Spatial Overlay Trial View The Spatial Overlay view see Figure 4 4 is selected by pressing the button in the Trial View window This view lets you look at events and samples by placing them where they were detected in space If the image that was presented during the trial is available it can be placed in the overlay view EyeLink Data Viewer 2002 2010 SR Research Ltd 17 a Trial iew picture Trial 1 Figure 4 4 Sample Spatial Overlay Trial View The following buttons are available from the spatial overlay mode Import Area of Interest File Loads an interest area set file and sets the interest areas for this trial Any existing interest areas are deleted from the trial After loading the Interest Area Set for the trial is set to Custom Auto Segment Image to Interest Areas Creates interest areas automatically for the trial bitmap Save the Interest Area Set File Saves the trials interest area set to a file Display Image in Full If enabled overlay is not scaled to size of Trial Viewer Window and is instead set to actual size One pixel of overlay corresponds to one pixel of trial display Change the Overlay Image Select the image to use as the background of the overlay Any existing background graphics are deleted Save Trial View a
82. coordinates of each point are separated by a comma Example MSG 2740540 V IAREA FREEHAND 3 512 284 612 384 512 484 412 384 diamond 7 3 5 4 Interest Area Set Identifier Default FILE Description When a large number of interest areas have to be specified such as in reading research it is easier to first write all the interest area information in a text file and later on the Viewer can locate and import the interest area file The v IAREA FILE Serves this purpose In an interest area file each line represents one interest area recorded in the format of RECTANGLE id left top right bottom label fora rectangular interest area ELLIPSE id left top might bottom label for an elliptic interest area and FREEHAND id x y x y x y label fora freehand interest area EyeLink Data Viewer 2002 2010 SR Research Ltd 115 Format IV IAREA FILE lt relative_file_path gt Example MSG 2740540 IV IAREA FILE segments example ias 7 3 6 Target Position Commands For experiments in which a moving resource is used the user may need to keep track of the position of the resource The Data Viewer allows the user to calculate the position velocity and acceleration data for each individual samples in the sample output report With such messages position velocity and acceleration traces can be displayed in the time plot view Identifier Default TARGET_Pos Description This message specifies the position
83. ction time RT measure the EyeLink Data Viewer relies on a set of reaction time definitions to parse the start and end events for RT calculation The reaction time definition command messages inform the Viewer of the RT start message the type of RT end events fixation saccade message or button the parameters of the end event as well as the conditions to which the RT definition is applied Reaction time definition commands can be provided in two ways The user can employ a pre trial condition based command messages to specify a RT definition for each of the experimental condition All pre trial reaction time commands start with the V_RT token and are followed by a one word subcommand indicating the type of RT end event BUTTON MESSAGE FIXATION or SACCADE Alternatively the user can supply a custom reaction time definition specifically for each trial All custom trial specific reaction time commands start with the V V_CRT token and are followed by a one word subcommand Important When an EyeLink Data File is loaded into the Viewer any existing Reaction Time Definitions for the Data Viewing Session are removed and reloaded from the data file being imported Therefore it is important that each data file contain all the pre trial condition based command messages required for the full analysis not just for the given data file Any previously set custom trial specific reaction time definitions are not affected when a new data file is
84. ctthiem from the frost cor 1 Bucktived at a big house in the sun kissad Santa Clara Walley rei a Judge Millor s piacerit was eallod It stood backsfrom the road half hiddentaimong the trees throught whieh glimpses could be caught of the wide aol veranda that rar drouha its four sides ad EyeLink Data Viewer 2002 2010 SR Research Ltd 37 Figure 5 9 Sample Spatial Overlay View left and Temporal Graph View right of Raw Sample Data Note By default samples are not loaded into the viewer when a data file is imported To enable loading samples into the data viewer change the Load Samples property in the Data Loading preference settings If you want this change to be persistent over future viewing sessions you may consider saving this as default setting This can be done by selecting the topmost preference tree node clicking the right mouse buttons and selecting Save Properties as Defaults see Preference Settings Tip In the Spatial Overlay trial view if samples are visible at the same time as events when an event is selected all samples used to generate that event are also selected 5 8 Interest Areas To access information on interest areas in a trial first click on the interest area button Bl of that trial in the tree view panel of the inspector window see Figure 5 10 The node will read as Custom Interest Area Set if custom interest areas are loaded or created but as Empty
85. current fixation If so the CURRENT_FIX_INDEX value of the very first fixation in that interest area 1s given CURRENT_FIX_REFIX_PREV_I Whether this trial has a previous fixation in an IA NTEREST_AREA with higher IA ID than current fix IA ID see run EyeLink Data Viewer 2002 2010 SR Research Ltd 73 definition S CURRENT_FIX_RUN_DWELL_T Total amount of dwell time in msec in the current IME run of fixations CURRENT FIX RUN INDEX Ordinal sequence of the current fixation in the current run of fixations The first fixation in this run has a RUN_INDEX of 1 and the second one has RUN_INDEX value of 2 and so on CURRENT FIX RUN_ SIZE Number of fixations within the current run d CURRENT FIX_ START Trial time when the current fixation starts Trial time when the current fixation starts on the CURRENT_FIX_START_OTHER other eye in a binocular recording CURRENT _FIX_TRIAL SPAN Whether the fixation starts before the trial starts and ends after the trial starts or starts before the trial ends and ends after the trial ends eye in a binocular recording N degree for the current fixation eye in a binocular recording N degree for the current fixation Note Similar analyses are done for the previous fixation variables beginning with PREVIOUS_FIX and for the next fixation variables beginning with NEXT_FIX DATA_FILE File name of the recording create this report End time in milli
86. d will output a missing value if samples are not loaded into a viewing session see Data Loading Preferences or the eye is in a blink PUPIL_SIZE_MIN_Y Y position at PUPIL_SIZE_MIN_TIME Note that this field will output a missing value if samples are not loaded into a viewing session see Data Loading Preferences or the eye is in a blink q REACTION_TIME Configurable response time determined by the Reaction Time Definition associated with the trial This variable returns a if the trial does not have an RT end event I RT_ DEFINITION LABEL Label of the RT definition 1f undefined CUSTOM_RT if the RT definition is a custom one q RT EVENT BUTTON_ID If the RT end event is the press release of a button records the button ID otherwise records q RT_EVENT_END_TIME End time in milliseconds since EyeLink tracker was activated of the end event If end event is not an eye event fixation or saccade event this variable is equal to RT_EVENT_START_TIME q RT_EVENT_INDEX Sequential order of the end event 1 when NO_MATCH Index is relative to a given event type q RT_EVENT_MESSAGE_TEXT Records the message text of the end event If the end event is not a message event records q RT_EVENT_POSITION_X Y Records the X Y coordinates of the fixation or saccade end event and sets for a button or message end event tracker was activated of the end event I RT_EVENT_TYPE The way in which the trial is ended
87. d with Interest Areas cc eeseeeeeeeeeeeeee 38 Figure 5 11 Creating a Freehand Interest Area cecccccccccccceceeeeeeetseseseeeeeeeeeeeeeees 4 Figure G15 Trial Variable Manat rescerooiaaisn en vals twndtiecstvaasindabd peqistewvateiondieasteues 48 Figure 6 2 Trial Variable Value Editor Dialog eccccccccccccceeeeeeetseseseeseeeeeeeeeeees 49 Figure 6 3 Applying Trial Grouping by a Trial Condition Variable and Setting Interest Area Template for a Group of Trials ssessseoeeesssssssssseensssssssseeresssssssseeerrsssssssees 50 Fioure 6 4 Example kaon MaD a enaewtaeteend eee eae 5I Pisure 6 5 Creating a FION Map a E T 52 Pisure 6 0 Types OF Eiaon Map enencen e a a uate T 54 Figure 6 7 Adjusting the Scale of the Fixation Map eesssssssssssssssssserereresssssssssssssseeeee 55 Figure 6 8 Reaction Time Definition Manager cccccccccccccceceeeeeetseeeeeeeeeeeeeeeeeees 56 Figure 6 9 Reaction Time Definition Editor General Tab ee cceseeeeeeeeeeeeeeees 57 Figure 6 10 Reaction Time Definition Editor Reaction Time Tab eee 57 Figure 6 11 Deleting Reaction Time Definitions 2 0 0 0 ccccccccceeeeeeeeeeeessseeeeeeeeeeeees 59 Figure 6 12 Reaction Time Graphics in Both the Spatial Overlay View and the Temporal Graph View of the Trial View Window cccccscccccceceeeseeeeeeeeeeeaeeeeeees 60 Figure 6 13 Interest Period Editor General Tab sineccams cecesnircctonseieatventenceene
88. ds NEXT_SAC_END_X X coordinates of the end point for the next saccade NEXT_SAC_END_X_RESOLUTI Horizontal angular resolution in screen pixels per ON degree at the end of the saccade If samples are loaded into the viewing session this takes the horizontal resolution of the last sample in the saccade otherwise the horizontal resolution of the next fixation is used NEXT_SAC_END_Y_RESOLUTI Vertical angular resolution in screen pixels per ON degree at the end of the saccade If samples are loaded into the viewing session this takes the vertical resolution of the last sample in the saccade otherwise the vertical resolution of the EyeLink Data Viewer 2002 2010 SR Research Ltd 75 pf next fixationisused OOOO O NEXT SAC INDEX Ordinal index of the next saccade NEXT SAC IS RT END Whether the next saccade is the end event of the RT definition NEXT SAC LABEL Label of the next saccade NEXT_SAC_MSG_COUNT Number of visible messages associated with the next saccade event This number will not exceed the Maximum Message Variables for Eye Event set in the Output Analysis Preference Settings NEXT SAC MSG_TEXT Text string of the messages associated with the next saccade _INTEREST AREA next saccade is assigned _INTEREST AREA LABEL point of the next saccade is assigned _INTEREST AREA next saccade is assigned _INTEREST AREA LABEL point of the next saccade is assigned NEXT_SAC_PEAK_ VELOCITY Peak values of gaze
89. e Reaction Time Events Unititl Sample Report text Wessage Report GamE trial 1 pee soe BERS H Cd Trial 2 yas liiki Figure 6 28 Creating a Message Report 2 In the following output report dialog Select the variables in the list of available output variables left panel and press gt gt to enter the variables into the list of selected output variables a Message Output Report x Available variables Selected Variables CURRENT_MS5G_5AC_END_Y al RECORDING SESSION LABEL CURRENT MSG 54 END CURRENT MSG S54 INDEX CURRENT MSG S amp C PEAK VELOCITY CURRENT MSG SAC START TIME gt CURRENT MSG 54 START Y CURRENT MSG S amp C START CURRENT MSG TEXT CURRENT _MS6_TIME CURRENT MSc 4 POSITION CURRENT _MSt_ _POSITION Variable Definition CURRENT M5 TEXT Text string of the current message Exclude Trial String Include Hidden Events in Relative Previous Next variables Treat Hidden Events as Missing Values in Relative Previous Hext Variables Place Quotes 3 Around String Text Variables Reset Cancel Meck Figure 6 29 Variales in a Message Report e To remove variables from the output list simply select the variables and press lt lt EyeLink Data Viewer 2002 2010 SR Research Ltd 97 e To change the order in which the variables are listed simply select one variable and use the or W button to move it to
90. e data loading preference settings Please note that the eye tracker can handle about 20 messages every 10 milliseconds So be careful not to send messages too quickly when you have many trial condition messages to send Add one millisecond delay between message lines if this is the case Format IV TRIAL VAR lt trial_var_label gt lt trial_var_value gt lt trial_var_label gt is the label for the variable being set If the current Data Viewer session does not have this variable yet it is created lt trial_var_value gt defines the value to set for the variable for the given trial Example MSG 9350338 V TRIAL VAR trial 1 MSG 9350359 IV TRIAL VAR Condition Gap MSG 9350340 V TRIAL VAR direction Left MSG 9350341 V TRIAL VAR gap_duration 200 MSG 9350342 IV TRIAL VAR t_x 212 MSG 9350343 V TRIAL VAR t_y 384 7 3 3 Image Commands The viewer supports a set of commands that display a default image on the overlay mode of the trial viewer screen All image commands use the IMGLOAD token followed by a sub command 7 3 3 1 Image Loading Fill Full Screen Identifier FILL Description EyeLink Data Viewer 2002 2010 SR Research Ltd 108 This message specifies the image to be used as the background for the spatial overlay view of a trial within the viewer The image is sized to fit the dimensions specified in the DISPLAY_COORDS command message The image should be represented as a relative path The viewer will look for the
91. e desired locations Tip In case several fixations on one single line such as in reading research are to be drift corrected another method is to select all of the desired fixations and press CTRL D to align them to the same Y position see Figure 5 3 This operation will fail if one or more fixations deviate more than 30 pixels in the Y dimension from the mean of the group of fixations to be drift corrected in a batch for example when fixations from different lines are selected The tolerable deviation threshold and the X Y dimension of EyeLink Data Viewer 2002 2010 SR Research Ltd 28 alignment is set to 30 as a default and can be modified in the general trial view preference settings e EyeLink Data iewer l B O x Diejejeia xeles M cio Bal ieiolels lemme O x Trial view text Triat 1 Data Preferences AE 9 Untitled evs text 224 184 124220 5 ie par didhot ad thehewspapers or he Kuld hav knovh that eh Trial a r T troub wae brewing a n AR foinse but for ya PA tide amp yater Interest Area Templates dog oa muscle ane Witwarm jong hair from Puget Sound to 184 SamDiege Because men Groping Ihe Arctic datkhess Fac ound a yeliowymetal a and becaus steamship and transportation companies Cut Copy 188 284 Paste w re Booming the find thousands of m n were rushing into the ee m No orthlana These men w
92. e start end of reaction time calculation and the event selection square These settings can be changed by clicking the corresponding cell and choosing a color from the palette dialog or entering the value in RGB or HSB scales Unselected Stroke Width and Selected Stroke Width Pixel width for the selected and unselected events Adjust Saccades with Fixations Whether or not to adjust saccade parameters when the fixations are shifted or merged Batch Drift Correction Error Threshold The maximum tolerable deviation in the Y dimension or the X dimension if the next field is unchecked for a fixation from the mean of the group of fixations to be drift corrected in a batch If any fixations within the group exceeds this threshold batch drift correction cannot be performed Batch Drift Correction Y X false If checked chooses the Y dimension for batch drift correction If unchecked X dimension is checked Include Fixation in Single IA In case of overlapping interest areas whether or not to limit the assignment of a fixation to one interest area the interest area with a smaller EyeLink Data Viewer 2002 2010 SR Research Ltd 135 ID only Auto Select Fixation in Selected IA When an interest area is selected whether or not to select fixations inside the IA as well Initial Data View 1 TP 2 OL 3 AV Selects the mode 1 temporal graph mode 2 spatial overlay mode 3 animation playback mode of the tr
93. e type of interest period end event Button Message or Duration based from the Type combo box o EyeLink Data Viewer File Edit Analysis Window Help IRICEN The house was approached by gravelled driveways which v wound Of m Ti 3 Trial 4 vision Area Templates about throug 1 wide spreading lawns and paaerrherpgiaciDg Eec poplars PL rear things were on even a r nore ro Interest Period Manager x re great stables _where a d Sew Interest Period 01 l g Interest Period Editor F a gt Fixation 1962ms LP Fixation 2142ms gt Fixation 2338ms gt Fixation 2542ms TP Fixation 2842ms gt Fixation 3130ms gt Fixation 3486ms lt gt Fixation 3690ms gt Fixation 3930ms LP Fixation 4270ms gt Fixation 4546rms lt gt Fixation 4834ms gt Fixation 5178ms gt Fixation 5346ms gt Fixation 5622ms 40 Fixation 5942rns O u e Label ixation 5942ms a Start Time 5942 ms p End Time 6326 ms uration 431 8 217 0 Figure 6 13 Interest Period Editor General Tab vine clad at ll General Details tt ti Label New Interest Period 01 Type Button Evert w gt 3 Select the Details Tab see Figure 6 14 EyeLink Data Viewer 2002 2010 SR Research Ltd 61 4a Interest Period Editor General Details Start Time Mess
94. eLink tracker was activated of the trial In addition other user defined trial variable labels will also be listed Note since version 1 3 of Data Viewer all eye event start and end times in the interest area report are made relative to trial start instead The absolute time of eye events can be obtained by adding TRIAL_START_TIME 6 8 3 Using Interest Area Report The data output in the interest area report depends on the setting of the interest period filter see section 6 4 2 or Figure 6 18 only those fixation and saccade events falling within the active interest period will be reported If a valid reaction time definition is found in a trial the TRIAL_ START TIME will be set as the start as the reaction time definition otherwise this will be set as the start of trial recording see section 6 5 3 on discussion of three time periods used in Data Viewer As a result the values of all of variables marked with a symbol which are calculated relative to TRIAL_START_TIME will be different depending on whether a valid reaction time is found in the trial If the Trimmed Spanned Fixation Duration setting of the Data Filter preference is enabled the duration start time and end time of the fixations that overlap with the start or end of the interest period will be adjusted accordingly Some variables in the interest area report may be influenced by the outlier fixations that do not belong to any interest area For e
95. earch Ltd 24 The EyeLink Data Viewer allows the user to carry out various manipulations over the events such as selecting a portion of data for further scrutiny excluding or deleting a subset of events from analysis performing drift correction on fixations merging neighboring fixations and saccades etc Selecting hiding and deleting operations are common to all event types fixations saccades buttons blink events and messages whereas merging and drift correction is available to fixation and saccade events only The common operations are discussed in this section whereas the unique operations pertaining to certain types of events are documented in the relevant event section 5 1 1 Selecting Events To select an event fixation saccade blink button or message place the mouse cursor over the event either in the spatial overlay temporal graph view or in the event list of the inspector window and click the left mouse button To select more than one event hold the CTRL key down and select the target event until all desired events are selected If all events in a trial are to be selected simply click the Select All Visible Item button Rl on the toolbar or click the right mouse button and select Select AI To select a group of events within a square region place the mouse cursor at the top left corner of the region Click and hold down the left mouse button drag the mouse cursor to the bottom right corner of the square regi
96. eas will be filled by expanding the size of each Interest Area Background Threshold 0 765 Combined RGB R G B to be used as the threshold limit for A a Background Threshold Less Than If checked pixels with a RGB value less than the threshold color are considered background pixels This setting is good for displays with a lighter background If this field is unchecked pixels with an RGB value greater than the threshold are considered background pixels good for displays with a darker background Note Auto segmentation may not work for a display with vertical stripes along its border s that have the foreground color If such stripes are not part of the original image try to reload the background image or to change the background color for the spatial overlay view to match with the background color of the original image EyeLink Data Viewer 2002 2010 SR Research Ltd 139 8 8 Temporal Graph Preferences The parameters related to the temporal graph view preference settings are covered below Left Eye Right Eye X Sample Trace Color Y Sample Trace Color X Velocity Trace Color Y Velocity Trace Color X Acceleration Trace Color Y Acceleration Trace Color and Pupil Sample Trace Color Preferences General Le Data Loading e Output Analysis she Set the colors to be used to show the EH Data Views _ Overlay horizontal and vertical position velocity Pe Time Plat and
97. ect Select AI Note If there are eye movement events within the interest area to be selected clicking on the interest area will likely select the eye movement events instead To make a more precise IA selection click on the Custom Interest Area Set node of the trial in the tree view and select the interest areas from the list panel Alternatively you can toggle off the eye movement events first make the interest area selection and then toggle the eye movement events back on 5 8 11 Moving an Interest Area An interest area can be moved by following these steps 1 Put the mouse cursor over the Interest Area 2 Hold the ALT key down 3 Press the left mouse button 4 Drag the IA to the desired location 5 Release the mouse button 5 8 12 Resizing Rectangular and Elliptic Interest Areas A rectangular or elliptic interest area can be resized by following these steps 1 Hold the ALT key down 2 Place the mouse over the border to be dragged the arrow cursor changes into a sizing cursor 3 Press the left mouse button and drag the border to the desired location 4 Release the mouse button To carry out a more precise adjustment for a rectangular or elliptic interest area 1 Select the interest area to move or adjust 2 In the property panel of the interest area select the entry for Left and type in the desired x coordinate of upper left corner 3 Select the entry for Top and type in the desired y coordina
98. ed Fixati lInclude Display Com Include Avictio orn Display Blink Saccades Shows flanking saccades of a blink Hide Fixations Beyond Display Bounds Whether or not to hide the fixations falling beyond the display boundaries Show Interest Areas Pre Interest Period If interest periods are defined whether or not to display interest area timed before the start of a selected interest period If no interest periods are defined the interest areas are displayed anyway Show Interest Areas Post Interest Period If interest periods are defined whether or EyeLink Data Viewer 2002 2010 SR Research Ltd 133 not to display interest area timed after the end of a selected interest period If no interest periods are defined the interest areas are displayed anyway Hide Eye Events Only If checked filters out eye events fixations saccades and blinks falling outside of the RT definition If unchecked filter out all events including buttons events and messages Hide Spanned Events For the RT filter whether or not to hide an event e g fixation or saccade that overlaps with the start event or end event of the RT definition Trimmed Spanned Fixation Duration If an interest period reaction time filter is applied the duration of the fixation that overlaps the start or end of the interest period will be trimmed so that only the portion of fixation within the interest period will be reported Include Display Command M
99. eeeeeaaas 107 do Amage Command S easa E 108 1 3 3 1 Image Loading Fill Full Screen ou eeccecccceceeeeeeeeeeeeeeeeeaes 108 Tomo linaeewoddimne Top LEen ete era es 109 Toso Tm geLoadins Centered saiieraacieietndiastaneiucatine a a a 109 Lad SUMP DAW INS mesara E E a 110 kodal Cleat Overlay Vie Wesson na eiahaiain edentereed nein ence 110 bok EIEE eaa One emer Once etm neta Preemie mens Drees ner aan rece nee 111 Todo Diavins a Rectan IC isc aatens tussle sitthcate aa aa n euitane deta 111 T344 Drawings a Filled Rectangle mersniernseea a 112 EyeLink Data Viewer 2002 2010 SR Research Ltd iv Toa Drwm ad Pixanon Oil esea a n 112 TaSeO Drow Tes CTV IG cers estates AA are eect a eet 113 Tio iberest Area Conima d S tet h cur eietes Resin A a 114 Poo Rectangular Interest Aree wciscad eine cc E 114 ToS Elhpue nteress Ame ait tactics st taatiennretich tastier eceiishebatienecesseeerechat 114 Ved 3 Preehand Interest Area ensinei e aces 115 Pee Mers NTC AS CU ieee os cee catia tested A 115 7200 Taret Position Command Scarsi E E E 116 74 Reaction Time DeninitiOns szissiw acccicerissinaleccinataaieclisdivaleendaianei wana 117 FA Mm 1 ELGG Bl l c 1 cs ete tee eer eee tn nee ream Rn ee EA 117 TAD Fixin EV GINS aeir ateenuabieaadiainaotuninals 118 TD BVACCAGE EVON ipu EN 119 Tad Mossas Eyen eaa a toate tO Aetna tea ea 120 74 Reaction me Denmtion Set icccseuctne se bet E 120 7 5 Changes in the Sample Experiments
100. ended order Export the variable selection into a property file by clicking on the Export Variable Selection button For all future viewing sessions the variable selection in the reports can be automated by importing the previously saved property file by clicking on the Import Variable Selection button The export import feature is similarly available to the interest period definitions and properties of the viewing session 6 1 Managing Trial Variables EyeLink Data Viewer 2002 2010 SR Research Ltd 47 The Trial Variable Manager Figure 6 1 and the Trial Variable Value Editor Figure 6 2 allow the user to review the currently available variables to assign a default value for the variables to create or remove variables and to change the variable values on a trial by trial basis 6 1 1 Trial Variable Manager xi Analysis Variables Selected Variable Label CONDITION Default Value Close Figure 6 1 Trial Variable Manager The Trial Variable Manager Dialog activated by pressing Analysis Trial Variable Manager from the menus lists the filename DATA_FILE and other variables imported from the EDF file if the TRIAL_ VAR LABELS command is used PAGE in this case To assign a default value to one variable click on the variable and type in the default value in the Default Value edit box Be sure to press Enter to register the change you made To create a new variable click the H button on the left A ne
101. ent computers are running and visible to each other in the same network group check this out from My Network Places gt View Network computers Contact your system administrator if the computers cannot see each other in the same network group e Please make sure that the network license dongle is plugged to server computer remove all other HASP dongles and drivers are already installed e Now click Start gt All Programs gt SR Research gt License Manager to check for the licensing status for each of the client computers in the network EyeLink Data Viewer 2002 2010 SR Research Ltd 6 3 Working with Files The EyeLink Data Viewer can import EyeLink EDF files The viewer loads each data file into a Data Viewing Session DVS A DVS can consist of many EyeLink data files Only one DVS can be open within the Data Viewer at a time Once a DVS has been created and EyeLink data files have been imported into it the DVS file can be saved and then reloaded at a later date for future analysis It 1s much quicker to load a DVS than to load the original EDF files of which the DVS consists All changes made during an viewing session only affect the DVS data the original EDF files are never altered 3 1 Creating a Data Viewing Session DVS From the menu choose File New Tip A new viewing session can also be created by clicking the Create New Viewing Session tool L on the standard toolbar or press Ctrl N Tip To find
102. ent gaze coordinates when the button is pressed released 100 if no gaze information was available for the time of the button event event see reaction time definitions output report To achieve better visibility the color of the currently selected button event can be changed by clicking on the color toolbox 5 7 Samples Samples can be toggled on off by clicking the Toggle Eye Sample Visibility button in the desktop toolbar In the spatial overlay view Figure 5 9 left panel the samples are overlaid on the trial bitmap forming the sample path of the viewing process In the temporal graph view Figure 5 9 right panel the xy coordinates of the samples as well as the concurrent pupil size are plotted as a function of trial time eh Trial Views bent i Triak 1 B eh Trial Views best i Triak i Bl Ha m eleja T Bu kd id rot re s the mevrs papers or he would have krrown that aie a trouble was brewing not alone for himself but for dvery tids water ea a all dog strong bf Tauscle and with warming hairfromrPugetSound to ft sph FI SarrBieg6 Becatiso monxgropingin td Arctle darkness hadfound y foes a yellow metal and because stcamshiptand trensportatidrrcompanies m J were beorhing the fine thous sdrids of man were rushing intothe ol Norland THEEe merwantedtoge and the dogs y wanted were heavy dogs with strong tuseles by whietrto toil anc furry coats to Li prote
103. er allows the user to create interest periods based on messages and button events The created interest periods are added to the interest period list The user can navigate between different interest periods by selecting the desired interest period from the list For each interest period only those events falling within that period are shown in the spatial overlay temporal graph views and in the event list of the inspector window In addition only those events and data within the selected interest period custom defined interest period or the default Full Trial Period are exported to the output file One important variant of the interest period is the reaction time period Reaction Time Definitions RTD can be created and applied to all trials loaded into an EyeLink Data Viewer session Each RTD can have a set of trial condition variables that must be matched for the RTD to be applied to a given trial The message event to use as the start time for the reaction time can be defined Each RTD can have a fixation saccade button or message event as the ending event for the reaction time calculation Depending on the event type selected for the reaction time end event a set of event properties can be specified to determine which event should be used within each trial A number of RTDs can be created for a given Data Viewer session allowing multiple reaction time conditions to be specified Each trial will only be matched to at most one RTD
104. ess Please note that the user should also check the setting for Fixation Skip Count in the Output Analysis preference settings The fixation skip count defines the number should be an integer no less than 1 of fixations to skip when looking for the next interest area to use in the fixation sequence analysis variables of the Interest Area report The default setting is 1 and uses the next available fixation for the sequence analysis from the current interest area to all interest area A value of 2 uses the fixation following the next one for the analysis and so on 6 8 3 2 Regression Analysis A lot of the variables in the interest area report are intended for the regression analysis especially in the reading research The following example illustrates the use the interest area report in the regression analysis Ss ee ee ee ee HA LABEL He sid Truth is a pathless_ Land _ IA DWELL_ TIME Fl P2 F5 ae IA_ FIXATION _COUNT EN a e a IA FIRST _ FIXATION _INDEX A_FIRST_FIXATION _RUN_INDEX i A 2 3 6 IA_FIRST_FIXATION _VISITED_IA_COUNT EyeLink Data Viewer 2002 2010 SR Research Ltd 89 ree FP Pr _PROGRESSIVE ie a a a a a a _ DURATION eee ee e e _DWELL_TIME a ial aL _RUN i a a a a _DWELL_TIME IAREGRESSIONIN 0 fo p JOT o emo A a a _ COUNT i aL _OUT ee PP R _OUT_COUNT 1 IA_ REGRESSION Fl F2 F3 F7 F4 F5 F9 _PATH DURATION F6 F7 F8 F1 F2 F3 F7 F4 F5
105. essages Whether display command messages 1 e command message starts with V listed in sections 7 3 2 image loading and 7 3 3 simple graphics should be visible Include Audio Command Messages Whether audio command messages should be visible The following built in audio messages are supported V ARECSTART IV ARECSTOP V VOICEKEY V APLAYSTART and V APLAYSTOP EyeLink Data Viewer 2002 2010 SR Research Ltd 134 8 5 General Trial View Preferences The parameters related to the general trial view preference settings are covered below A Fixation Color Saccade Color Blink E gt Data wh Preferences Preferences ij General i Data Loading soo Output Analysis con Data Filters Ey Data Views i Overlay soo Time Plot So Animation Field ization Color accade Color ink Color 4 Color utton Color essage Color eaction Time Stark C eaction Time End Color Selection Square Color Unselected Stroke Wi ee Selected Stroke Width Adjust Saccades with Batch Drift Correction BO Batch Drift Correct Y f Include Fixation in Sin TF OY Auto Select Fixation in Initial Data View 1 T Bs Display RT Graphic Include Graphics Com Color IA color Button Color Message Color Reaction Time Start Color Reaction Time End Color and Selection Square Color Set the colors to be used to show fixations saccades blinks interest areas button events messages th
106. ewer commands have been introduced in the Simple template TRIAL VAR LABELS for the definition of the labels to be used for trial condition variables within the viewer and TRIAL_VAR_DATA for the assignment of condition values for each trial All these changes listed in the following table were made in the w32_simple_trials c file of the template Data Viewer Functionality Message Commands Trial Variable Labels eyemsg_printf TRIAL_VAR_LABELS TRIAL_WORD Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA Ys trial_word num 1 7 5 2 Text Template Along with the TRIAL_VAR_LABELS and TRIAL_VAR_DATA commands the Text template also uses IMGLOAD FILL to load a single image and IAREA FILE to import a file containing interest areas for the trial All of these changes listed in the following table were made in the w32_text_trials c file of the template Data Viewer Functionality Message Commands EyeLink Data Viewer 2002 2010 SR Research Ltd 121 Trial Variable Labels eyemsg_printf TRIAL_VAR_ LABELS PAGE Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA d num Images eyemsg_printf V IMGLOAD FILL Images s image_fn eyemsg_printf V IAREA FILE Segments s seg_fn 7 5 3 Picture Template One new feature of the Picture template is the demonstration of another approach to load images and to specify interest areas for the trial The
107. f the frequency of saccades directed from the current interest area to all interest areas If there are N interest areas in a trial this will generate N columns in the output report with column labels being IA_FSA_COUNT_1 to IA_FSA_COUNT_N for counts and IA FSA DURATION_1 to IA_FSA_DURATION_N for duration outputs Each column in the output file reports number of fixations coming to one particular interest area from each of all possible interest areas Each row reports number of fixations starting from the current interest area and ending at each of the interest areas when Fixation Skip Count in the Output Analysis preference settings is set to 1 Interest Area 1 2 3 4 5 6 T Text He said Truth is a pathless land Fixation Sequence 1 2 3 gt 4 5 EyeLink Data Viewer 2002 2010 SR Research Ltd 88 IALABEL He said Truth_ is a __ pathless Land 1 He jo i jo Jo o o 7 2 said Jo qo H jo oO The above example illustrates the use of fixation sequence analysis Take interest area 6 pathless for example It received four fixations in total These fixations came from interest area 3 Fixation 4 6 Fixation 5 4 Fixation 8 and 7 Fixation 10 This is reported in the column IA_FSA_COUNT_6 There are three fixations starting from interest area 6 Fixation 5 to IA 6 Fixation 6 to IA 3 and Fixation 9 to IA 7 This is reported in the row with IA_ID being 6 pathl
108. f trials to be excluded In addition to enable correct loading of string text variables in some statistics software the Viewer also has an option of adding a pair of quotation marks for such variables 6 10 2 Variables in the Message Output Report Currently the following variables are included in the message output report RECORDING_SESSION LABEL Label of the data file CURRENT_MSG_BLINK_DURATI Duration of the blink to which the message is associated CURRENT MSG _ BLINK END End time relative to the start of the interest period of the blink to which the message is associated EyeLink Data Viewer 2002 2010 SR Research Ltd 98 CURRENT MSG _BLINK_ INDEX Index of the blink to which the message is associated CURRENT MSG_BLINK_ START Start time relative to the start of the interest period of the blink during which the message was written CURRENT_MSG_FIX_DURATION Duration of the fixation to which the message is associated CURRENT MSG_FIX_END End time relative to the start of the interest period of the fixation to which the message is associated CURRENT MSG_FIX_INDEX Index of the fixation to which the message is associated CURRENT MSG_FIX_START Start time relative to the start of the interest period of the fixation to which the message is associated is associated oe oaaae S associated CURRENT CURRENT_MSG_INDEX INDEX Index of the current message 2 of the current message CURR
109. g EYE USED Which eye s data LEFT or RIGHT is used to create this report IA_AREA Pixel area for the current interest area IA_AVERAGE_FIX_PUPIL_SIZE Average pupil size across all fixations in the interest area EyeLink Data Viewer 2002 2010 SR Research Ltd 82 A_BOTTOM Bottom side pixel position of non freehand IA Dwell time 1 e summation of the duration across IA_DWELL_TIME all fixations on the current interest area IA_DWELL_TIME_ Percentage of trial time spent on the current interest area A_FIRST_FIXATION_DURATIO N A_FIRST_FIXATION_INDEX A_FIRST_FIXATION_RUN_IND EX IA_FIRST_FIXATION_X A_FIRST_FIXATION_Y A_FIRST_FIX_PROGRESSIVE A_FIRST_RUN_DWELL_TIME Duration of the first fixation event that was within the current interest area Ordinal sequence of the first fixation that was within the current interest area This counts how many runs of fixations have occured when a first fixation is made to an interest area The current run is also included in the tally TA FIRST FIXATION TIME Start time of the first fixation to enter the current interest area The X position of the first fixation event that was within the current interest area The Y position of the first fixation event that was within the current interest area Checks whether later interest areas have been visited before the first fixation enters the current interest area 1 if NO higher IA ID in ear
110. gs they wanted were Button 166ms heavy dogs with strong muscles by which to toil and furry coats to Button 260ms Protect them from the frost a Button 23584ms Buck lived ata big house in the Sun kissed Santa Clara Valley Judge Miller s place it was called It stood Rack from the road halt hidden amang the trees through which glimpsecs could be caught of the wide cool veranda that ran aroung its four sides 3 a Trial iew text Trial 1 S f x ajal E 0 ms 1971 3942 5913 7384 9855 11826 13798 15769 17740 19711 21682 2 l l l l l l l l l 0 px rw 101 202 303 404 505 606 707 RT End Event 808 Hidden g09 Figure 6 12 Reaction Time Graphics in Both the Spatial Overlay View and the Temporal Graph View of the Trial View Window 6 4 Interest Periods Besides the above mentioned reaction time definitions the user may also selectively view and perform analysis on data within a specific period of time within a trial Interest Period For example the user may want to examine the eye data between two important markup messages for a trial with multi page manipulation analysis may be performed separately for the period of each page presentation The EyeLink Data viewer allows the user to create interest periods based on messages button events or duration To do that when programming an experiment the user should mark up possible interest periods
111. he changes made to the w32_gcwindow_trials c file of the GCWindow template Data Viewer Functionality Message Commands Trial Variable Labels eyemsg_printf TRIAL_VAR_LABELS TYPE CENTRAL PERIPHERAL Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA TEXT TEXT MASK TEXT eyemsg_printf V TRIAL_VAR_DATA IMAGE IMAGE MASK eyemsg_printf V TRIAL_VAR_DATA IMAGE MASK IMAGE eyemsg_printf V TRIAL_VAR_DATA IMAGE IMAGE BLURRED Images Trials 1 amp 2 Trials 3 4 amp 5 eyemsg_printf V IMGLOAD FILL images sacrmeto jpg Trials 1 amp 2 eyemsg_printf V AREA FILE segments text ias 7 5 6 Control Template The following messages and commands have been added to the w32_control_trials c file of the Control template Data Viewer Functionality Message Commands Trial Variable Labels eyemsg_printf TRIAL_VAR_ LABELS CONDITION The following messages and commands have been added to the w32_control_trial c file of the Control template Data Viewer Functionality Message Commands Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA GAZECTRL eyemsg_printf V IMGLOAD FILL images grid png eyemsg_printf V IAREA FILE segments grid 1as EyeLink Data Viewer 2002 2010 SR Research Ltd 123 7 5 7 Dynamic Template One important feature introduced in the Dynamic template is the addition of custom reaction time definition V V_CRT for t
112. he saccade trials Reaction time is defined as the interval between the onset of the target SS YNCTIME message and the occurrence of the first saccade with a minimum amplitude of 2 0 that falls within 50 pixels from the saccade target goal_x goal_y The following table lists all of the messages and commands that have been added in the w32_data_trials c file of the Dynamic template Data Viewer Functionality Message Commands Trial Variable Labels eyemsg_printf TRIAL_VAR_LABELS TRIAL TYPE DIRECTION Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA d Ps Ps num trial_labels O num 1 trial_labels 1 num 1 Reaction Time Definitions Trials 3 8 eyemsg_printf V V_CRT SACCADE SYNCTIME 2 0 od d 50 goal_x goal_y 7 5 8 Comm_simple Template Similar to the Simple template TRIAL_VAR_LABELS and TRIAL_VAR_DATA commands were added to the w32_simple_trials c file of the template see the Table Data Viewer Functionality Message Commands Trial Variable Labels eyemsg_printf TRIAL_VAR_LABELS TRIAL_WORD Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA s trial_word num 1 7 5 9 Other Templates Since the Broadcast and CComm_listener templates do not produce EyeLink data recording no change has been made in those templates to support Data Viewer analysis EyeLink Data Viewer 2002 2010 SR Research Ltd 124 8 Preference Settings All
113. he scope of a trial as defined by the Trial Load Start Message and Trial Load End Message containing the string will be 66 99 ignored by the Viewer Add a to separate multiple message strings Collapse Identical Interest Areas with Different Time Stamps If checked the default setting all interest areas with identical coordinates and label will be merged together and thus treated as one single interest area If unchecked interest areas are organized based on the time stamps and therefore interest areas with identical coordinates and label but different time stamps are treated as separate items In general the former approach 1s typically used if the data analysis is done on the whole trial recording whereas the latter setting 1s used if the data analysis are done based on individual interest periods Enable SceneLink Gaze Mapping If checked allows the user to load EDF file with mapped gaze data to scene video coordinates Generate SceneLink Frame Message If checked allows the user to generate frame number messages when loading file The frame number message will only be written if a lookup table has been created for synchronized playback of eye movement data over the scene video see section 5 1 of the EyeLink II Scene Camera User Manual Note The user has to save the preferences and reload the data file before the changes in the above preference settings take effect EyeLink Data Viewer 2002 2010 SR Research Ltd 1
114. ial view window when the data is first loaded Display RT Graphics If reaction time definitions are initialized whether or not to show the RT symbol in the spatial overlay view and to draw the Reaction Time Start End lines in the temporal graph view of the trial data Include Graphics Commands Sent Prior to IP If no graphics commands are found within the current interest period uses those sent prior to the current interest period EyeLink Data Viewer 2002 2010 SR Research Ltd 136 8 6 Spatial Overlay View Preferences The spatial overlay view preference settings cover the following parameters T Data wh Preferences Preferences General Data Loading Output Analysis Data Filters Data Views ye Time Plot Animation Field Sample Trace Color oo Sample Trace Granularity z Sample Tick Period B0 Sample Tick With W ooo rimum 1 Size o inlay 1A se SQRT of Fix Dur f ication Circle Scalar axitnurn Fixation Circle inuman Fixation Circle 2 ackground Color aximum Graphics Corm 1 A t Overlay Image Chan M l Sample Trace Color Sets the color to be used to show the sample trace Display Fixation Index Display Fixation Duration and Display Saccade Index Whether or not to show the fixation index fixation duration saccade index in the spatial overlay view Display Fixations as Scan Path If checked two temporally contiguous
115. ieteeaseidasagesdlasias Uietannecdarecudauaviantedamends 17 Figure 4 4 Sample Spatial Overlay Trial View cccccccecccccececceeeeeeeaeaeeeeeeeeeeeeeeeeees 18 Figure 4 5 Sample Temporal Graph Trial View ccccccccccccceceeeeeeesseseeeeeeeeeeeeeeeees 19 Figure 4 6 Sample Playback Animation View ssssssssseeeeeeeceecceceeeeeneaaeeeeeeeeeeeeees 22 Figure 5 1 Sample Spatial Overlay View of Fixation Evemts c ccssssseeessseeeeeeeeeeeeees 26 Fioure5 2 Diasram tor Angle Calculations A A 27 Figure 5 3 Drift Correcting Fixations on One Line of Text sssssssseeeereerrreesessssssssss 29 Pieire a4 Opus fOr Fix atime Ceai 0S o a T 30 Figure 5 5 Sample Spatial Overlay View of Saccade Events sssseseeseeeeeeeeeeeees 31 Figure 5 6 Sample Temporal Graph View of Blink Events cc ccsssesseeseeeeeeeeeeeeeeees 33 Figure 5 7 Sample Temporal Graph View of Message Events Note that the default size of the message symbol in the temporal graph preference settings has been changed E AE E ET EAA E S AA TATE E E E AN E AE E E 34 Figure 5 8 Sample Temporal Graph View Showing the Button Events Note that the default size of the button symbol in the temporal graph preference settings has been Ea E CU EE A E E A E A EA A A E E E E E 37 Figure 5 9 Sample Spatial Overlay View left and Temporal Graph View right of Rav Sampie Dalda a EEEO 38 Figure 5 10 Sample Text Display Overlai
116. imation playback preference settings are covered below g Inspector Memory Usai SJ Enable Cyclopean Cursor For a binocular T Data of Preferences recording enabling this option will display a FERET ENGES cyclopean gaze cursor instead of two separate General gaze cursors in the animation view Data Loading Output Analysis Right Gaze Cursor Color Left Gaze Cursor Color Data Filt m ii pii Cyclopean Gaze Cursor Set the colors to be Overlay used to show the right left and cyclopean gaze Time Flot cursor The default settings can be changed by 8 Sie clicking the corresponding cell and choosing a color from the palette or entering the value in RGB Field Value or HSB scales Enable Cyclopean Right Gaze Cursor Gaze Cursor Diameter Sets the diameter of the gaze Lett Gaze Cursor C cursor in pixels Cyclopean Gaze Cu Gaze Cursor Diamet 2 a Trial Time Color Trial Time Color Sets the color of the trial time code Trial Time X Position 5 000000 e E Trial Time X Position Trial Time Y Position EEEO Sets the x percent of screen width and y percent of screen height coordinates of the trial time code Trial Time Font Size Sets the font size of the trial time code Display Frame Number If checked displays the frame number of the video being played EyeLink Data Viewer 2002 2010 SR Research Ltd 142
117. ime of the first and last sample in the fixation and computes the duration of the fixation in milliseconds The average X and Y eye position the type of position data is determined when the event was generated and the average pupil size area or diameter are reported The horizontal and vertical eye position angular resolutions in pixels per visual degree are reported next In addition the output contains information on whether the fixation has been manually adjusted lt ma gt and the ID and name of the interest area in which the current fixation falls lt ia gt 6 11 2 2 Saccade Events Saccade events are recorded in the format of EyeLink Data Viewer 2002 2010 SR Research Ltd 102 e ESACC lt eye gt lt stime gt lt etime gt lt dur gt lt sxp gt lt syp gt lt exp gt lt eyp gt lt ampl gt lt pv gt lt xr gt lt yr gt This reports the time of the first and last sample in the saccade and computes its duration in milliseconds The X and Y eye position at the start and end of the saccade lt sxp gt lt syp gt lt exp gt lt eyp gt are listed The total visual angle covered in the saccade is reported by lt ampl gt which can be divided by lt dur gt 1000 to obtain the average velocity Peak velocity is given by lt pv gt The horizontal and vertical eye position angular resolutions in pixels per visual degree are given as well 6 11 2 3 Blink Events Blink events are recorded in the format of e EBLIN
118. in the viewer The image size is not changed unless width and height parameters are specified and will be positioned centering on the x y coordinate specified The image should be represented as a relative path The viewer will look for the image in the following order 1 In the default image directory specified in the general preference settings 2 Inthe directory the EyeLink data file is loaded from 3 In the directory the viewer application is running from Format V IMGLOAD CENTER lt relative_image_path gt lt x_position gt lt y_position gt width height Example MSG 2740540 V IMGLOAD CENTER fixations gif 200 200 7 3 4 Simple Drawing Besides the image loading the viewer also supports a set of commands that draws simple graphics such as lines framed box filled box as well as display clearing 7 3 4 1 Clear Overlay View Identifier CLEAR Description This command clears the overlay view to the color specified by the red blue green integer values specified in the command Each RGB value should be an integer between 0 and 255 Format IV CLEAR lt red gt lt blue gt lt green gt EyeLink Data Viewer 2002 2010 SR Research Ltd 110 Example MSG 2 740540 IV CL BAR 293 2939 299 This clears the display to white color 7 3 4 2 Line drawing Identifier DRAWLINE Description This command draws a line with the color specified by the red blue green integer values specified in the command
119. ipant or multiple participants with the same background image To create a fixation map or heat map a 2D Gaussian is applied to each of the fixation the Gaussian center is the fixation location the width of the Gaussian is influenced by an adjustable sigma value in degrees of visual angle the larger the sigma value the larger the area that will be influenced by the fixation and the height of the Gaussian can be weighted either equally for all fixations or by the duration of individual fixations This 2D Gaussian is added to an internal map by adding weight to that area of the map After the above process is applied for all fixations the internal map is normalized so it can be applied to the color or brightness scale used to create an aggregate view see Figure 6 4 EyeLink Data Viewer 2002 2010 SR Research Ltd 50 Figure 6 4 Example fixation map To create a fixation map for a single trial select the trial node A in the top panel of the inspector window click the right mouse button and select Create Fixation Map option see Figure 6 5 To create a fixation map for a group of trials select the group node FF Click the right mouse button and select Create Fixation Map option if no common image has been applied to the trials yet select Select Trial Background Image option before creating a fixation map In the following Save Fixation Map dialog box enter the intended file name with a proper file extension
120. k EyeLink Data Viewer 2002 2010 SR Research Ltd 9 4 Data Viewer Windows The EyeLink Data Viewer uses a desktop framework that contains all windows of the Viewer application Once a Data Viewing Session DVS is opened and EyeLink data is loaded two windows will appear the Inspector Window on the left and the Trial View Window on the right The Inspector Window enables the user to choose data to be viewed to review statistical summaries and to configure default application settings The Trial View window allows a graphic examination of the data of the selected trial Both windows can be minimized and maximized within the Application desktop The figure below shows the viewer desktop after loading the sample picture edf file 18 x e EyeLink Data iewer File Edit Analysis Window Help S Moom Beee mmm gia fs a picture G Trial 1 ED Trial 2 cam Trial 3 Interest Area Templates lt gt Fixation 8ms TP Saccade 472ms LP Fixation 528ms T Saccade 664ms TP Fixation 684ms TP Saccade 1128ms lt gt Fixation 1160ms gt Saccade 1404ms lt gt Fixation 1416ms gt Saccade 1668ms lt gt Fixation 1692ms T Saccade 1880ms TP Fixation 1900ms gt Saccade 2112ms lt gt Fixation 2148ms T Saccade 2656ms rial 1 1 nicture edfF 62797388 ms 62817622 ms 20234 ms f 3 Start EyeLink Data viewer 3 14 PM Figure 4 1 Viewer Display after L
121. kground Image Import Message List After the message list file is imported into the session a dialog box will be presented to show the number of valid messages imported 5 6 Button Events Button events can be toggled on off by clicking the Toggle Button Event Visibility button A button event is represented as a colored triangle in the temporal graph view and a colored square in the spatial overlay view centering on the current gaze position The following table lists the properties of a button event Those fields that are editable in the viewer are marked with an asterisk e EyeLink Data iewer Oj x plelsiela x ele a Moo eisi 2 o 1G hmv Toggle Button Event visibility Ol x Data i Preferences C Untitled ews text SD Trial 2 E Trial 3 E Trial 4 Interest Area Templates 18670 19104 19538 19973 20407 20841 21275 21709 22144 22578 23012 23446 al l l l l l l l l EyeLink Data Viewer 2002 2010 SR Research Ltd 36 Figure 5 8 Sample Temporal Graph View Showing the Button Events Note that the default size of the button symbol in the temporal graph preference settings has been changed Label of the button event Time Trial time when the button was pressed released Note that if the button event occurs before the trial starts a negative time value will be displayed Button ID Button pressed or released X Concurr
122. l This command is useful for those trials in which there are many viewer graphics commands while the user may just need to see a few of them If itis set to 1 the viewer will process all graphics commands For all other entries of integer numbers the viewer will process the number of graphics commands specified when creating background image for overlay view Fit Overlay Image Change to Display If True when the background image for a trial is manually changed the image is scaled to fit the display dimensions for the trial If false the image size is not altered and the image is centered on the trial overlay view EyeLink Data Viewer 2002 2010 SR Research Ltd 138 8 7 Image Segmentation Preferences The parameters related to the auto image segmentation preference settings are covered below Segmentation Spacing Threshold Number of Data f Preferences consecutive pixels below threshold before EErEE segment end is identified ees General s Data Loading Left IA Buffer Size Right IA Buffer Size Top IA e Output Analysis Buffer Size Bottom IA Buffer Size Number as sh dae of pixels added to the left top right and H E Overlay bottom of the interest area Note that the Top meage Segmentation sete Time Plot Animation IA Buffer Size Bottom IA Buffer Size fields will not have an effect if Fill Gaps Between IA is checked Fill Gaps Between IA If checked gaps between consecutive Interest Ar
123. l Output Report generates one row of data for each trial within the Data Viewer Variables include the count of each event type visible within the trial the average fixation duration and saccadic amplitude as well as the reaction time calculated for the trial based on the reaction time definitions created for the Data Viewer session The Sample Output Report provides a columnar output of eye movement data for each eye sample in a trial Variables include the index of the sample in a trial time of the sample position x y velocity acceleration and pupil data of the current sample If appropriate target position messages are read from the EDF file the position velocity and acceleration data of the targets up to two targets can also be provided The user can also save the spatial overlay and temporal graph views into image files save the playback of the trial into a movie file or create a landscape view 1 e fixation map for a trial or for a group of trials with the same background image 1 7 Experiment Integration The EyeLink Data Viewer allows commands to be inserted directly into the EyeLink EDF file when an experiment is running This allows the experiment to be significantly integrated into the Data Viewer These commands are interpreted by the Data Viewer when the data file is loaded and automates several areas of the viewer functionality By using a set of predefined viewer commands the programmer of an experiment can info
124. l Repo aa incase cn cde laced eee ee 68 63A Conticnriietne Trial REDO cara erie idea reennbeadt aetna 69 OG Paton REDO inae eect ares eels tas atone nes he testes 69 6 6 1 Obtaimine a Fixation Reports scos nie Geto cstaicee wane iii Seem 70 EyeLink Data Viewer 2002 2010 SR Research Ltd 1 00 2 Variables 1n the Fixation Repot esccain a a 12 6 6 3 Coniicirine the Fixation Repoti arescit T 78 6 7 Saccade Repor esser pansstae ante anid wee ea ante eee nee 78 O27 Obtained Saccade KC VOM erore en clawed EE ERAAN 79 62 Variables the SaCcade REPON iorsin a Aaeieaelen 79 6 8 Interest Afea REPO ernsnrianennei erann a dala venctiaxachs 80 6 8 1 Obtaining an Interest Area Report sssssssoeensssssssseeerrsssssssscrerssssssssceresssss 80 6 8 2 Variables in the Interest Area Repott aiinsir cidra iniia 82 6 38 33 Using Interest Area Report eiiie incepi e 87 6 8 31 Fixation Sequence ANALY GIS Miacacticasctiusdisieninn scene E dices 88 O 9 3 2 JREGTESSIOM ATIALY SIS euccusinnicdiclrecesairtiad A A 89 6 9 Sample COTOUE REPO E saria a a E 91 6 9 1 Loading Samples into a Viewing Session sessssseeessssssssseerressssssseeeresssss 91 6 9 2 Obtaining a Sample Output Reportt ssessseoeeesessssssseeressssssssserrssssssseeresssss 91 6 9 3 Variables in the Sample Output Report ennesesssseooeessssssssseerrssssssssceressssss 93 OIO Messac e OUDUC REDO aa a sede eared ned nnden 96 6 10 1 Obtaining a Message Out
125. l To create an interest area 1 Select the Interest Area shape that you want to create from the Application Desktop toolbar O Rectangular Interest Area Shape is active oOo Ellipse Interest Area Shape is active DE FreeHand Interest Area Shape is active EyeLink Data Viewer 2002 2010 SR Research Ltd 39 For rectangle and elliptic interest area shapes 2 Hold down the left mouse button in the top left corner of where you want the interest area to be created 3 Drag the mouse down to the right until the selection region covers the area that you want to select 4 Release the mouse button 5 Enter the name of the Interest Area and press Enter 6 Repeat steps 2 6 to create more interest areas of the same type Press the Selection mode icon R from the Application Desktop toolbar to end creating interest areas For FreeHand interest area shapes 2 Double click the left mouse button on the first point of the shape to create 3 Move the mouse to the second point and double click the mouse again A line joining the points should be displayed 4 Repeat step 3 for each point of the freehand shape 5 Press the ENTER key when you have specified all points you wish to create The first and last points of the interest area will be joined by the program Note that you can cancel the creation of a freehand interest area by pressing the ESC key 6 Enter the name of the Interest Area and press Enter 7 Repeat steps 2 6 to cre
126. l as the xy coordinates of the center of the fixation region and the diameter of the region Saccade Event This will end the trial by the occurrence of a specific saccade Fill in the minimum saccadic amplitude in degrees of visual angle required as well as the xy coordinates of the region center and the diameter of the saccade region 4 Once all the desired RT definitions have been set arrange the order of the definitions by using the and buttons in the Reaction Time Definition Manager dialog This operation is important only when more than one RT definition can be met for a single trial Always put specific definitions before general ones 5 Close the Reaction Time Manager dialog This will apply the reaction definitions to all trials If there are lots of trials in a viewing session this may take some time to finish 6 If the user thinks that the current RT definitions are not appropriate she he can remove them by clicking on the Delete button on the Reaction Time Definition Manager dialog box EyeLink Data Viewer 2002 2010 SR Research Ltd 58 a Reaction Time Definition Manager Figure 6 11 Deleting Reaction Time Definitions 6 3 2 Viewing Reaction Time Information If the reaction time events are initialized such information 1s available for viewing in trial view window see Figure 6 12 In the spatial overlay view a red RT symbol is displayed near the end event In the temporal graph view a green
127. le name does not contain an extension the file name is appended with a txt by default 6 Press the Save button Note Depending on the size of the EDF file s generating this report may take a long time 6 9 3 Variables in the Sample Output Report Currently the sample output report provides output for the following variables RECORDING_SESSION LABEL Label of the data file along the x axis across two eyes along the y axis across two eyes eyes Gaze coordinate along the y axis across two eyes Index of the interest area in which the current sample average across two eyes t falls BEL sample average across two eyes t falls axis across two eyes axis across two eyes DATA_FILE File name of the recording HTARGET_DISTANCE Distance between the head target and eye camera in millimeters for an EyeLink Remote recording Returns a missing value if the head target was missing or if the data was recorded with a non Remote eye tracker HTARGET_X X position of the head target in camera EyeLink Data Viewer 2002 2010 SR Research Ltd 93 coordinate for an EyeLink Remote recording Returns a missing value if the head target was missing or if the data was recorded with non Remote eye tracker HTARGET_Y Y position of the head target in camera coordinate for an EyeLink Remote recording Returns a missing value if the head target was missing or if the data was recorded with non Remote eye tracker HTARGET_FLA
128. lier fixations before the first fixation in the current interest area O otherwise This measure is useful in reading to check whether the first run of fixations in this interest area is in fact first pass fixations Dwell time 1 e summation of the duration across all fixations of the first run within the current interest area interest area first run of the current interest area Number of all fixations in a trial falling in the first run of the current interest area interest area current interest area A_FIRST_RUN_FIXATION_CO UNT ME TA_FIRST_SACCADE_ START TIME Start tume of the saccade that first landed within the current interest area IA_FIXATION_ Percentage of all fixations in a trial falling in the EyeLink Data Viewer 2002 2010 SR Research Ltd 83 ps fcurrentinterestarea O O O O O OSOS O IA_FIXATION_COUNT Total fixations falling in the interest area IA_FSA_COUNT The number of fixations fixation N which started in the current row of interest area with fixation N fixation_skip_count ending in the current column of interest area IA_FSA_DURATION The summed duration for all fixations fixation N which started in the current row of interest area with fixation N fixation_skip_count ending in the current column of interest area IA_GROUP Group label for the current interest area IA_ID Ordinal ID of the current interest area IA_ LABEL Label for the current interest area N the
129. line is drawn at the time when the start time message is presented and a red line is drawn at the time when the end event occurs to see these graphics make sure that the Display RT Graphics field in the General Trial View Preferences is checked see section 8 5 In the event list of the Inspector window select the end event that meets the reaction time definition for the selected trial The RT End Event field of that event is automatically checked This field will be unchecked and reaction time calculation will be updated if the user decides to choose another event as the RT end event by checking the same field of the newly selected event EyeLink Data Viewer 2002 2010 SR Research Ltd 59 e EyeLink Data Yiewer 7 E 15 x bolejsjeje xla a a a s K P Trial View text Trial 1 E Oj xi lt gt Data T aa Preferences AE fa alal fe 9 Untitled evs Se text Buck did not read the newspapers or he would have Known that a trouble wast brewing not alone for himself but for every tide water i a Hy dog strong of muscle and with warm long hair from Pugst Sound to rial Oo Trial 4 San Dicgoso Because Men groping in the Arctic darkness had found 7 fin Interest Area Templates a yellow metal and because steamship and transportation companies were booming the find thousands of men were rushing inte the Northland These men wanted do and the do
130. list press the Next button 4 In the Export dialog box browse to the directory in which you want to save the output report Save ini B My Documents ce My Recent Documents S My Documents Sr My Computer aa LVE File name Save My Network Places Files of type Microsoft Excel File xls Cancel Figure 6 17 Saving the Output Report 5 In the File name text box type in the name for the document and choose the appropriate file extension Note if the output report file extension set to All Files and the file name does not contain an extension the file name is appended with a txt by default 6 Press the Save button 6 5 2 Variables in the Trial Report The following variables are listed in the trial report Contents RECORDING_SESSION_LABEL Label of the data file AVERAGE FIXATION Average duration in milliseconds of all DURATION selected fixations in the trial AVERAGE_SACCADE Average size in degrees of visual angle of all EyeLink Data Viewer 2002 2010 SR Research Ltd 65 in screen pixels per degree for the trial File name of the data Duration of the trial recording between the START message and the END message END_TIME Timestamp when the trial recording ends in milliseconds since EyeLink tracker was activated EYE USED Which eye s data LEFT or RIGHT is used to create this report FIXATION COUNT Total number of fixation
131. loaded 7 4 1 Button Events Identifier BUTTON Description This will treat a particular button press release as the reaction time end event Pre Trial Message Command Format EyeLink Data Viewer 2002 2010 SR Research Ltd 117 VRI BUTION srt start msg lt button id gt lt stdate gt CONDITION LABEL 1 condition value 1 CONDITION LABEL 2 condition value 2 Trial specific Message Command Format V V_CRT BUTTON lt rt_start_msg gt lt button_id gt lt state gt Note Button_id refers to the intended button ID from 1 to 8 use O for any button event Button state could be O button release or 1 button press Condition labels and their values are not required for the trial specific message command and optional for the pre trial message command if not specified the RT definition is applied to all conditions In case both a condition based pre trial message command and a custom trial specific message command are applicable for one trial the trial specific command will override the more general one Example MSG 329381 V_RT BUTTON SYNCTIME 5 1 TYPE normal In this example the end event for RT calculation is pressing button 5 serves This RT definition is applicable to the condition in which the value of the variable TYPE is normal 7 4 2 Fixation Events Identifier FIXATION Description This will end the trial by the appearance of a specific fixation The user can specify the parameters of the fix
132. me definition 1 From the menus choose Analysis gt Reaction Time Manager a Reaction Time Definition Manager Figure 6 8 Reaction Time Definition Manager In the reaction time manager dialog see Figure 6 8 the user can create a new reaction time RT definition by clicking the new button on the left edit an existing RT definition by clicking on the Gi button and remove an RT definition by clicking on the ti button Users who have already had custom reaction time messages defined in the EDF file need to decide whether the customer RT messages or the RT definitions EyeLink Data Viewer 2002 2010 SR Research Ltd 56 2 3 created here should take precedence when both of them are applicable for a particular trial If Override Custom Reaction time definitions box is checked the new RT definitions created through the Reaction Time Manager will take precedence otherwise the custom RT messages written in the EDF file will be used Click on the 4 button In the Reaction Time Definition Editor dialog General Tab see Figure 6 9 a Enter a label for the current RT definition in the Label edit box b Select the type of RT end event from the Type combo box c Inthe Trial Condition Qualifiers group box select the trial condition variables and enter the intended values for the current RT definition DO NOT include quotes for text strings a Reaction Time Definition Editor x General Reaction Time L
133. no grouping variable is chosen grouping will be performed based on the data file each trial belongs to Once grouping is performed the trials will be listed by the conditions of the grouping variables selected see the right panel of Figure 6 3 The property panel of each group lists the label values of the grouping variables total number of trials and configurable interest area EyeLink Data Viewer 2002 2010 SR Research Ltd 49 information for the group Thus the user can potentially apply an interest area template to all trials in the group see section 5 8 7 Using Interest Area Templates 7 EP Data il Preferences HEHEHEHEH EHEH E ov Mm OF Be to Mi e value Name Ponens an 16 2008 Last Modified an 17 2003 Number Trial Groups Number Trials z EP Data vil Preferences Bh evs H Single Feature Absent i Single Feature Present g Two_feature Absent l A Two_Feature Present ED Trial 115 EI Trial 118 EI Trial 121 ngm J Trial 122 value wo Feature Present Number Trials Default Interest Grea test jas zl Empty Interest Area 4 test jas Figure 6 3 Applying Trial Grouping by a Trial Condition Variable and Setting Interest Area Template for a Group of Trials 6 2 Fixation Map EyeLink Data Viewer allows users to create a landscape view to identify informative parts of a display based on recording trials from a single partic
134. nterest area is defined all fixations will be removed 5 3 Saccades e EyeLink Data Yiewer x Diejaals s e ola sis Molly e 20 e s parar P o Trial View text Trial 1 Toggle Saccade Event Visbity 01 x Data i Preferences faa 9 Untitled evs a text et a5 ie Buck did r oi he would _have krotn that EI Trial 2 Trial ie ell trouble was brewing notalone for ut for every tidewater gt 1B pon Interest Area Templates dog rs A Pusela i vi f6nghair tere nest Ss oie to SatrBiego _Becatise mergroping in the Arctic darkness had found i a anisportation companies i i 4D gt Saccade 20494ms gt Saccade 20718ms P Saccade 21010ms Ste eg gt Saccade 21242ms m TP Saccade 21446ms P Saccade 21678ms gt Saccade 21886ms gt Saccade 22230ms TP Saccade 22514ms a lt a D ri i a t 4 amp T i i D i i 4 q 5 G iA D gshihe intet e i a 1 a i i WY Y ey a Q Saccade 22770ms RT End Event Hidden elo Adjusted Figure 5 5 Sample Spatial Overlay View of Saccade Events Saccade events see Figure 5 4 can be toggled on off in both the spatial overlay and temporal graph views by clicking the Toggle Saccade Event Visibility button A saccade is represented as an arrow in the spatial overlay view
135. ntil the eyes enter an interest area with a higher IA_ID IA RUN COUNT Number of times the Interest Area was entered and left runs IA_SECOND_FIXATION_DURA Duration of the second fixation in IA regardless of TION run IA_SECOND_FIXATION_RUN Index of run that the second fixation 1s in TA SECOND_FIXATION_TIME Time of the second fixation in JA regardless of run IA_SECOND_FIXATION_X The X position of the second fixation event that EyeLink Data Viewer 2002 2010 SR Research Ltd 85 P Was within the current interest area IA_SECOND_FIXATION_Y The Y position of the second fixation event that was within the current interest area IA_SECOND_RUN_DWELL_TIM Dwell time i e summation of the duration across all fixations of the second run of fixations within the current interest area TA SECOND RUN_END_TIME End time of the second run of fixations in the current interest area I A_SECOND_RUN_FIXATION Percentage of all fixations in a trial falling in the o second run of the current interest area COUNT second run in the current interest area ME current interest area IA_SELECTIVE REGRESSION __ Duration of fixations and refixations of the current interest area before the eyes enter an interest area with a higher ID IA_SKIP An interest area is considered skipped 1 e IA_SKIP 1 if no fixation occurred in first pass IA_SPILLOVER The duration of the first fixation made on interest area N 1 afte
136. o maps are very different To make such a comparison the user may set an intended peak activity value in the Fixed Maximum Value field of the preference settings By default with a value of 1 in the Fixed Maximum Value field the peak value displayed in the legend will be the actual maximum per trial average value for the map If a user defined peak value is set the drawing of fixation map will be adjusted according to this new scale A black line is drawn on the heatmap scale to indicate the actual maximum activation of the heatmap if that value is less than the fixed maximum A white line is drawn on the heatmap scale to indicate the Low Activity Cut off when the setting is greater than O and the Fixed Minimum Value set in the preference This low activity cutoff feature ignores areas on the map with an activation value lower than 10 default of the peak value If the low activity cutoff value is set to 0 the whole display is painted Panel A of the following figure shows the original fixations in a trial Panel B shows the fixation count based map using the default Fixed Maximum Value 1 and Low Activity Cut off 10 or 0 2 fixation the white line position Panel C shows the same trial but with a different Fixed Maximum Value 4 the actual peak value in the map is indicated by a black line Panel D illustrates the output using a Fixed Maximum Value of 2 0 which is the same as the actual peak value and a Fix Minim
137. oading the Sample Picture edf File 4 1 Inspector Window The Inspector Window consists of 2 tabs the Data Tab and the Preferences Tab see Figure 4 2 4 1 1 Data Tab EyeLink Data Viewer 2002 2010 SR Research Ltd 10 The Data Tab consists of 3 panels Figure 4 2 left Panel The top panel provides a tree view of the viewing session The first level of the tree view contains trial grouping nodes S EyeLink Data Viewer lists trials within a viewing session by either data file or by experimental conditions Each trial grouping node has a set of tree leaves representing the trials that are contained within that node The middle panel represents a list of components that are within the selected node of the analyses session tree If a trial is selected in the viewing session tree a list of visible events is displayed If an Interest Area Set is selected a list of interest areas that make up the set are selected The bottom panel is a table representing the properties of the selected tree node or selected list component For example if a fixation is selected all properties of the fixation are listed in the properties table Some properties like color are editable by pressing on the property value with the mouse Data Tab Preference Tab e inspector a Inspector E gt Data il Preferences _ Preferences picture l srini General ET Trial 1 _ _ Trial Hode i a Data Loading Trial B A
138. of the nearest sample recorded at the message or button time The Temporal Graph View provides a two dimensional plot of trial data The X axis represents time while the Y axis represents the location of the samples or events being plotted This view is suitable for a wide range of experimental paradigms including those using dynamic trial displays The scale of the graph can be changed via zoom in and zoom out operations This view supports binocular display of sample position and pupil size traces The color of individual events as well as the global color of a given event type or sample trace can be changed as desired There is a vast number of preferences that can be configured by the user saved and then applied to future loaded data The Animation View plays back the subject s gaze data in a trial with a concurrent time code displaying the time from the start of trial recording If the image that was shown during the trial recording is available it can be loaded as the background for the playback view A trackbar control displays the progress of the playback and lets the user select a specific position to start playback The speed of playback can also be adjusted Multiple viewing windows can be opened at one time displaying data from different trials or displaying data of one single trial in the Spatial Overlay View Temporal Graph View and Animation View concurrently EyeLink Data Viewer 2002 2010 SR Research Ltd l 1 2 E
139. olbox Note System time refers to the timestamp in milliseconds since the EyeLink tracker was activated whereas the trial time refers to the time since the trial started The default trial start time is the start of the trial recording 1 e START message If reaction time definitions are applied the trial start time is reset at the start event of the RT definition e g SYNCTIME message A negative trial time means that the event or message occurred before the trial start time Note The calculation of the angle between the previous next fixation and the current fixation is directional with the arrow pointing towards the previous next fixation see Figure 5 2 for an illustration of angle calculation Previous text Fixation ae 1809 qe Current Fixation 90 F Figure 5 2 Diagram for Angle Calculation Note The direction of the previous next fixation relative to the current fixation 1s determined as LEFT if the angle is greater than 135 or less than 135 UP if EyeLink Data Viewer 2002 2010 SR Research Ltd 27 the angle is between 45 and 135 RIGHT if the angle is between 45 and 45 and DOWN if the angle is between 135 and 45 5 2 1 Selecting Fixations In addition to the common method of event selection by mouse fixations may also be selected by using the cursor keys up down left and right cursor keys To select a group of temporally contiguous fixa
140. on CURRENT_MSG_Y_POSITION Y position of the current message text It may be a missing value if samples are not loaded in the viewing session DATA_FILE File name of the recording EYE USED Which eye s data LEFT or RIGHT is used to create this report IP_DURATION Duration of the interest period in milliseconds IP_END_TIME End time in milliseconds since EyeLink tracker was activated of the interest period the viewing session Start time in milliseconds since EyeLink tracker was activated of the interest period TRIAL_LABEL Label of the trial TRIAL_INDEX Sequential order of the trial in the recording TRIAL_LABEL Label of the trial TRIAL START TIME The start time in milliseconds since EyeLink tracker was activated of the trial Note Messages written in the EDF file will be associated with an event closest in time In very rare cases the message can be written to both saccade and fixation events if the EyeLink Data Viewer 2002 2010 SR Research Ltd 100 message was written out after the last sample of a fixation or saccade but before the first sample of the following saccade or fixation In addition other user defined trial variable labels will also be listed Please note that the data output in the message report depends on the setting of the interest period filter see section 6 4 2 or Figure 6 18 only those events falling within the active interest period will be reported If a valid reaction
141. on and then release the left mouse button Tip Holding the CTRL key while selecting an event leaves previously selected events selected If the CTRL key is not pressed previously selected events are unselected 5 1 2 Deleting Events Select the events and click the Delete Selected Items button M on the toolbar or click the right mouse button and select delete If an event is deleted it will be permanently removed from the temporal graph view spatial overlay view as well as the output reports and cannot be undeleted In addition deleting a fixation or saccade event will have an impact on other temporally contiguous events For example deleting a fixation will merge the saccades on either side of the fixation into one saccade Similarly deleting one saccade will merge the fixations on either side of the saccade into one big fixation 5 2 Fixations EyeLink Data Viewer 2002 2010 SR Research Ltd 25 To examine the fixation information in the data file first make sure that the fixation events are visible This is done by ensuring that the Toggle Fixation Event Visibility button in the application desktop toolbar is selected e EyeLink Data Yiewer a O x biejsjele 1 Molo Mal iap 0S parame i beee eas Trial View text Trial 1 Toggle Fixation Event Visibility x Data references ma m EE kja alem as E 3 A text 224 a il 284 276 i Buck dic Rot read thehewspaper
142. on will change to time period to be magnified only the spatial range displayed is not altered To zoom out the graph press the button The temporal graph will be zoomed out by a factor of 2 4 5 Animation View The Animation View see Figure 4 6 1s selected by pressing the button in the Trial View window This view plays back the gaze position superimposed on the background image that the participant was looking at while the data was being recorded with a concurrent time code displaying the time from the start of trial recording Several controls are available for the animation view The user can start stop or pause the playback by clicking the appropriate button The speed of playback can also be adjusted the user modifies the speed value and then press the Enter key to register the change A trackbar control displays the progress of the playback and lets the user select a position to start playback View Trial Spatially with Image Overlay Select the spatial overlay mode View Trial Data in 2D Temporal Graph Mode Select the temporal graph mode Playback Trial Starts playing back the trial data Stop Trial Playback Stops the playback and resets the time code and gaze Cursors Pause Trial Playback Pauses the playback EyeLink Data Viewer 2002 2010 SR Research Ltd 21 Forward Step Each click on this button advances the playback by one video frame Save Trial to Movie File Save the playback of the tri
143. or EDF_time field will place the message in a trial which started after 62798072 and ended before 62798072 If EDF_time is negative the EDF_time trial index of the message in the EDF file A value of 1 would mean the first trial in the file and 4 would mean the 4th trial in the file In this case the message EDF time is set to the start of the trial time in this case e Offset is optional and must be an integer if specified Offset is subtracted from EDF_time to generate the real message time For example a message line of MSG 2435806 14 V APLAYSTART 0 1 waves 1 wav suggests that the event the message was referring to APLAYSTART actual happened at time 2435820 e Message_text can be any string up to 100 characters in size that starts with a non numeric character e Lines that do not follow these rules are ignored e g MSG 2435806 14 V APLAYSTART 0 1 waves 1 wav MSG 2436376 14 V APLAYSTOP 12578 1 waves 1 wav MSG 62798072 0 POSN 174 384 MSG 62798072 0 POSN 185 384 To load the message list file 1 Select the EDF file label in the treeview panel of the Inspector Window 2 Click on the right mouse button and select Import Message List 3 In the following Open dialog box go to the directory where the message list file is stored and choose the file EyeLink Data Viewer 2002 2010 SR Research Ltd 35 A Data i Preferences 4 Urtitled evs Delete Create Fixation Map Select Trial Bac
144. or recording is done with left eye or right eye only In addition other user defined trial variable labels will also be listed Please note that the data output in the sample report depends on the setting of the interest period filter see section 6 4 2 or Figure 6 18 only those fixation and saccade events falling within the active interest period will be reported If a valid reaction time definition is found in a trial the TRIAL START TIME will be set as the start as the reaction time definition otherwise this will be set as the start of trial recording see section 6 5 3 on discussion of three time periods used in Data Viewer 6 10 Message Output Report Message output report provides a columnar output of messages written in each trial as well as the eye movement events to which the message is associated As with the other reports message report only outputs messages that fall within the active interest period for the trial 6 10 1 Obtaining a Message Output Report To obtain an output report for messages 1 From the application menus choose Analysis gt Report gt Message Report EyeLink Data Viewer 2002 2010 SR Research Ltd 96 a EyeLink Data iewer File Edit Analysis Window Help Reports Recording Event Sequence Data ic Trial Variable Manager Fixation Report Ctrl F Trial Variable Value Editor SS oere Ss z amp P Data Reaction Time Manager ee Area Report Trial Report CErl T Initializ
145. ot added to the Message list that 1s created for viewing within the viewer tool Message commands are therefore invisible to the viewing windows and are only interpreted by the Viewer during application loading Important Do not use space characters in any component of a viewer message command the space character is used to tokenize and interpret all viewer messages Instead of using a space character within a message token use the _ character 7 1 Defining the Start and End of a Trial The viewer uses two special message commands to define what should be considered the start and end of a trial for the purpose of parsing the EyeLink data files 7 1 1 Trial Start Message Identifier Default TRIALID Description This message defines the start of a trial for the viewer This is different than the start of recording message START that is logged when the trial recording begins The viewer will not parse any messages events or samples that exist in the data file prior to this message The command identifier can be changed in the data loading preference settings Format TRIALID lt TrRial ID wale lists Example MSG 3362269 TRIALID PIX1 images sacrmeto jpg EyeLink Data Viewer 2002 2010 SR Research Ltd 104 Note Ifthe trial start message is not found or if no trial start message is defined for the viewing session the START message is used to indicate the start of a trial for the Viewer 7 1 2 Trial End Message Identifier
146. ottom The X Y and pupil traces can be highlighted Press the x key to highlight the X trace press the y key to highlight the Y trace and press the p key to highlight the Pupil trace If pressing one of these keys does not highlight the intended sample traces please make sure that the trial view window is currently in focus double clicking anywhere the sample traces are plotted to set the keyboard focus to the trial view window Various aspects of the time plot view can be configured in the preference settings Preferences gt Data Views gt Time Plot For example the user may change the colors of the sample traces the scaling factor for plotting the acceleration velocity and pupil size data total number of initially visible samples in the temporal graph view window etc EyeLink Data Viewer 2002 2010 SR Research Ltd 20 4 4 2 Zooming Operations The temporal graph can be zoomed in and out To zoom into an area of the temporal graph 1 Hold the Shift key down or press the H button 2 Position the mouse on the temporal graph at the location of the upper left hand corner of the area you wish to zoom into 3 Press the mouse button and drag the mouse to the lower right hand corner of the area you wish to zoom into 4 Release the mouse button 5 Release the Shift key The graph will be magnified so that the area you selected fills the Trial View Window Tip Holding the CTRL key while defining the zoom in regi
147. peak velocity for saccades is also recorded in the events Other events record subject responses such as button presses and synchronization and data messages from applications These can be used to record the time of a change in the display or an experimental condition Events are generated by the EyeLink eye tracker EyeLink I EyeLink II and EyeLink CL in real time based on an internal heuristic saccade detector using a velocity and acceleration based saccade detection method A blink is defined as a period of saccade detector activity with the pupil data missing for three or more samples in a sequence A fixation event is defined as any period that is not a blink or saccade To detect a saccade for each data sample the parser computes instantaneous velocity and acceleration and compares these to the velocity and acceleration thresholds If either 1s above threshold a saccade signal is generated The parser will check that the saccade signal is on or off for a critical time before deciding that a saccade has begun or ended A detailed discussion on event parsing can be found in section 4 Data Files of the EyeLink IT or EyeLink 1000 User Manual In addition to providing a file based and a trial based summary of performance the EyeLink Data Viewer allows a detailed examination of event data such as fixations saccades blinks buttons messages as well as raw sample data 5 1 Common Operations EyeLink Data Viewer 2002 2010 SR Res
148. put Report esessssssseoeesssssssseeerrssssssssceressssss 96 6 10 2 Variables in the Message Output Report 2 0 0 ccccccccccceeesseeeeeeeeeeeeeaes 98 OLI Recording Event Sequence Data nici seessessuesaum inna e nna a 101 6 11 1 Obtaining a Recording Event Sequence Data cc ceeeeseeeeeeeeeeeees 101 6 11 2 Formats of the Recording Event Sequence Data cc ceeeeeeeeeeeeeeeees 101 6 11 2 1 Fixation BY CUS iera canvas E E 102 6 11 2 2 ACCA EY CIS cba cecestetaarsp assets ads sessins E eatin Pee eaealies 102 6 11 2 3 e H 001 ol kfc 0 Leanne errs wee reine A ree tery fern erreneen ner re 103 Ov A Meats EV Ct oie dire sate tattered a Mawes ettedeene niet 103 6 11 2 5 BOO nE yen earna OR Pre en oN 103 7 Protocol for EyeLink Data to Viewer Integration nseessseeensssssssseeerrsssssseseeeees 104 7 1 Defining the Start and End of a Trial eecsssecccececeeeeeeseseeeeeeeeseaeeeeees 104 lel AEilal OtAtt WICSS AGS 5 ce Stradi she taet hance atte TA 104 Pde Tiat End MESSI 8 Cs acssiautetidusacgeaiie S tite Ravin atu teins 105 T2 _ Pre Trial Messace Gmina ses2 dna acces tees dertisandeichuen Gea T EA DERE 105 Gedo Faai Variable Wael S cc ttamcetetoaa A E 105 1 2 2 Display Coordinates cenenson aunan a a 106 Taa Tal Cyt OUI NE se r A 106 7 3 Prtal Wiessage Commands a EE AE mensduias 107 Foke AMAA WACO lee VAC Se E 107 7 3 2 Single Trial Variable Message Toke0 ccccccssesssssececceceeeeeseeeee
149. r Interest Area Identifier Default RECTANGLE Description This message specifies the attributes of a rectangular interest area for the trial Each trial can have a set of such rectangular interest areas Format W TAREA RECTANGLE lt id gt lt left gt lt top gt lt right gt lt bottom gt label string Note The label string parameter is optional Example MSG 2740540 V IAREA RECTANGLE 1 547 410 585 449 square 7 3 5 2 Elliptic Interest Area Identifier Default ELLIPSE Description This message specifies the attributes of an elliptic interest area for the trial Each trial can have a set of such elliptic interest areas Format IV TAREA ELLIPSE lt id gt lt left gt lt top gt lt right gt lt bottom gt label SCring EyeLink Data Viewer 2002 2010 SR Research Ltd 114 Note The label string parameter is optional Left top right and bottom refer to the x y coordinates of the top left and bottom right corners of the bounding rectangle Example MSG 2740540 V IAREA ELLIPSE 2 647 310 685 349 circle 7 3 5 3 Freehand Interest Area Identifier Default FREEHAND Description This message specifies the attributes of a freehand interest area for the trial Each trial can have a set of such freehand interest areas Format ly TAREA FREEHAND lt 20 gt Xj Vi gt S255 was SX yy babel string Note The label string parameter is optional x y refers to the x y coordinates of a point The x y
150. r in the sense that it reports the duration and end event data in the Trial Report in addition to the data filtering capability Next you will need to deterimine which report is appropriate for your analysis EyeLink Data Viewer organizes the output reports based on different analysis emphasis If you care about the summary statistics for a recording trial e g how long 1s the trial recording how many fixations were made in each of the trials the Trial Report is ideal for it The Fixation Report Saccade Report and Sample Report provide detailed eye movement measures for each of the fixation saccade events or the individual eye samples The Interest Area Report provides a columnar output for the eye movement data related to each of the interest areas The message report provides an output for each of the message events recorded in the data file with the corresponding fixation saccade event While most of the research questions can be answered by extracting and analyzing the data from one or several of those reports it is possible that in some cases you will need to write some extra analysis code to further process the report outputs When performing analysis you may organize each of the viewing sessions by loading one or multiple EDF files The settings from one viewing session a template can be exported to different viewing sessions Thus the user may go through each of the output reports to configure the selection of variables in an int
151. r leaving interest area N in first A_THIRD_FIXATION_DURATI Duration of the third fixation in JA regardless of ON run IA_THIRD FIXATION RUN Index of run that the third fixation is in TA_ THIRD_FIXATION_TIME Time of the third fixation in IA regardless of run IA_THIRD_ FIXATION_X The X position of the third fixation event that was within the current interest area IA_THIRD_ FIXATION_Y The Y position of the third fixation event that was within the current interest area IA_THIRD RUN DWELL_ TIME Dwell time 1 e summation of the duration across all fixations of the third run of fixations within the PATH_DURATION current interest area interest area third run of the current interest area current interest area freehand EyeLink Data Viewer 2002 2010 SR Research Ltd 86 A_TOP Top side pixel position of non freehand IA IP_END_TIME End time in milliseconds since EyeLink tracker was activated of the interest period IP_LABEL Label of the current interest period selected in the viewing session IP_START_TIME Start time in milliseconds since EyeLink tracker was activated of the interest period TRIAL DWELL_TIME Dwell time 1 e summation of all fixation durations for the whole trial TRIAL FIXATION COUNT Total number of fixations in the trial TRIAL_INDEX Sequential order of the trial in the recording TRIAL_LABEL Label of the trial TRIAL START TIME The start time in milliseconds since Ey
152. reas Neighboring rectangular interest areas can also be merged To do that 1 Click Toggle Fixation Event Visibility button on the trial view window toolbar so that the fixation events will not be merged 2 Press CTRL key to select the intended interest areas 3 Click right mouse button to bring up a popup menu select Merge from the list EyeLink Data Viewer 2002 2010 SR Research Ltd 46 6 Data Analysis and Output One of the ultimate goals of the EyeLink Data Viewer is to let you extract useful eye movement information and export data to a tab delimited text file that can be processed by most statistical packages Before performing any data analysis the first question you may ask yourself is what part of the recording data you need to look at Do you need to analyze the eye movement data for the entire recording trial or just a small portion of it For example you conducted a reading experiment in which each trial displays a sentence followed by a comprehension question for the sentence just read Do you need to look at the portion of eye movement data when the subject was answering the comprehension question If not you may create an interest period for the reading part 1 e from the onset of the reading screen to the onset of the comprehension questions and then select the intended interest period In some experimemts you may create a reaction time period The reaction time definition is a special variant of interest period filte
153. red from a higher A_ID from the right in English IA_ REGRESSION OUT Whether regression s was made from the current interest area to earlier interest areas e g previous parts of the sentence prior to leaving that interest area in a forward direction 1 if a saccade exits the current interest area to a lower IA_ID to the left in English before a later interest area was fixated 0 if not IA_REGRESSION_OUT_FULL Whether regression s was made from the current interest area to earlier interest areas e g previous parts of the sentence 1 if a saccade exits the current interest area to a lower IA_ID to the left in English 0 if not Note that IA_REGRESSION_OUT only considers first pass regressions whereas IA_REGRESSION_ OUT_FULL considers all regressions regardless whether later interest areas have been visited or not IA_REGRESSION_OUT_FULL_C Number of times interest area was exited to a OUNT lower IA_ID to the left in English IA REGRESSION OUT COUNT Number of times interest area was exited to a lower IA_ID to the left in English before a higher IA_ID was fixated in the trial IA_REGRESSION_ PATH DURA The summed fixation duration from when the TION current interest area is first fixated until the eyes enter an interest area with a higher IA_ID IA_RIGHT Right side pixel position of non freehand IA IA_REGRESSION_ PATH DURA The summed fixation duration from when the current interest area is first fixated u
154. references 1s 26 53 80 107 133 160 187 214 240 267 294 321 l l l l l l l l a 5 9 Untitled evs A text S EI Trial 2 CI Trial 3 CI Trial 4 Interest Area Templates 41255ms Sms Sms 2ms 2ms Message 23719ms E Message 23836ms Figure 5 7 Sample Temporal Graph View of Message Events Note that the default size of the message symbol in the temporal graph preference settings has been changed EyeLink Data Viewer 2002 2010 SR Research Ltd 34 5 5 1 Import Message List Experiments should place certain messages into the EDF file to enable Data Viewer to process the files more efficiently Examples of these commands include defining the image to overlay specifying trial variables defining a start time of RT definition etc These messages will be timestamped with an accuracy of 1 millisecond from the time sent and can be used to mark important events such as display changes If the user forgot to write these messages when the experiment was created these messages can still be imported from a text file The loaded message list file must be an ASCII file and each line must be a valid EyeLink MSG line in the format of MSG EDF _time Offset Message_text where e EDF time must be an integer If this field is positive it is assumed to be the absolute EDF timestamp to be used for the message e g a value of 62798072 f
155. rent values and choosing a default directory from a Set window Note changes to these preference settings only take effect on files loaded after the change Default Display Width and Default Display Height Set display width and height to enable the Data Viewer to run properly if DISPLAY_COORDS GAZE_COORDS message is not found in the EDF file otherwise these preferences are ignored EyeLink Data Viewer 2002 2010 SR Research Ltd 126 8 2 Data Loading Preferences Data loading preference settings consist of the following parameters __ General lg Data Loading La Output Analysis Be Data Fitters a Data Views Field Value Load Samples im lLoad Fixations Fj Load Saccades La Load Blinks m Load Messages Fj 4 Load Buttons a Trial Load Start Messa TRISLID Trial Load End Message TRIAL RESULT All Trial variable Label TRIAL 4R_ LABELS All Trial variable Value TRIAL VaR DATA Single Trial Variable M TRIAL MAR Target Position String TARGET FOS Exclude Message Stri Enable SceneLink Gaz E Generate SceneLink F 7 Load Samples Load Fixations Load Saccades Load Blinks Load Messages Load Buttons Allow the loading of samples fixations saccades blinks messages and buttons from the EDF files By default all of the events are loaded whereas samples are not Note Versions before 1 7 1 loads samples as well by default Trial Load Start Message
156. rm the Data Viewer regarding a The image s to load for each trial s Spatial Overlay View b The Interest Areas to load for each trial c The Reaction Time Definitions to apply to the Data Viewing session d The trial condition variables and values to use for each trial e The position of the target in a dynamic display EyeLink Data Viewer 2002 2010 SR Research Ltd 4 2 Installation 2 1 System Requirements Operating System Windows 2000 XP Vista or Windows 7 Mac OSX Processor PIII 800 MHz or better processor RAM minimum 256 MB RAM 512 MB or higher recommended Disk Space 50 MB free disk space for application plus space required for EyeLink data files and saved viewing sessions Monitor Resolution 1024x768 or better resolution 1600 x 1200 recommended Other Free USB port required 2 2 Setup The latest version of EyeLink Data Viewer installer can be downloaded from https www sr support com forums showthread php t 10 If you have a previous version of EyeLink Data Viewer installed on the computer please uninstall it with the DV installer or with Windows Control Panel tool Add or Remove Programs before installing the new version By default the EyeLink Data Viewer software will be installed at Windows Drive Program Files SR Research DataViewer Important A USB Dongle provided by SR Research is required to run this application and must remain connected to the PC while the application is running
157. s 1 From the menus choose File Import Data Interest Area Template 2 In the Load dialog box browse to the location of the interest area file 1as that you want to import and select it 3 Click Load and the tree view panel will be updated 5 8 7 Using Interest Area Templates If several trials use the same set of interest areas an interest area template if already loaded can be used see section 6 1 3 on applying an interest area template to a group of trials To apply an interest area template EyeLink Data Viewer 2002 2010 SR Research Ltd 42 1 Click on the viewing session icon and perform trial grouping if necessary 2 In the tree view panel of the data tab select the trial group onto which the interest area template is loaded 3 In the property panel of a selected trial or trial group find the entry Interest Area Set and select the target interest area template 5 8 8 Automatic Trial Image Interest Area Set Association If Auto Select IAS for Trial property in the Output Analysis preference settings 1s true any value in the Image Name Mapping field of the interest area set will be used to automatically associate the interest area set to trials If the last Data Viewer image load command entered in a trial contains an image name that contains the Image Name mapping text of the interest area template then the interest area set 1s associated with the trial Please note th
158. s Hext Variables Place Quotes 9 Around String Text variables Reset Cancel Next Figure 6 27 Variables in a Sample Report e To remove variables from the output list simply select the variables and press lt lt e To change the order in which the variables are listed simply select one variable and use the or button to move it to the desired position Repeat this step until all variables are in the right position e Data Viewer supports exporting and importing of variable selection across viewing sessions For example the user may go through each of the output reports to configure the selection of variables in an intended order Export the variable selection into a property file by clicking on the Export Variable Selection button E For all future viewing sessions the variable selection in the reports can be automated by importing the previously saved property file by clicking on the Import Variable Selection button B 3 Once all the desired variables have been entered into the output list press NEXT button EyeLink Data Viewer 2002 2010 SR Research Ltd 92 4 In the Save dialog box browse to the directory in which you want to save the output report The default output directory can be configured through General Preferences 5 In the File name text box enter the name for the document and choose the appropriate file extension Note if the output report file extension set to All Files and the fi
159. s Image Creates an image of the spatial overlay view EyeLink Data Viewer 2002 2010 SR Research Ltd 18 Changes from the previous versions Note that when the background image for a trial is manually changed with the Change the Overlay Image button please also check for the Fit Overlay Image Change to Display setting in the Data Views gt Overlay preference If that setting is true the image is scaled to fit the display dimensions for the trial If false the image size is not altered and the image is centered on the trial overlay view 4 4 Temporal Graph Trial View The Temporal Graph View see Figure 4 5 allows the user to view trial data as a trace plot where the X axis represents time and the Y axis represents the X Y gaze location pupil size dived by a factor of 10 acceleration and velocity data To view trial data in this mode select the button in the top left corner of the Trial View Window ae Trial iew BINDOZTARG Trial 1 S039 S360 10692 11504 12525 13147 139569 14791 15617 Descending Ascending 748 Figure 4 5 Sample Temporal Graph Trial View 4 4 1 Viewing Sample and Target Data Time plot view will show trace plots only 1f the EDF file contains samples and 1f sample are activated for viewing 1 e the Toggle Eye Sample Visibility button 3 on the Data EyeLink Data Viewer 2002 2010 SR Research Ltd 19 Viewer tool bar is selected The position velocity and
160. s are included in the analysis the user can further decide whether or not to treat these events as missing data Bracket Strings with Quotes Adds a pair of quotation marks for string variables Exclude Trials with Message String Excludes trials containing the specified 2002 2010 SR Research Ltd 129 message string This string should be one message or part of a message within the scope of a trial that uniquely defines that subset of trials to be excluded Auto Select IAS for Trial If true trial interest area set association is done automatically by using Image Name mapping attribute of interest area set templates in the Data Viewer session see section 5 8 8 Automatic Trial Image Interest Area Set Association for details The default is false Use Nearest Interest Area for Outlier Fixations If the current fixation is not in any defined interest areas assigns the nearest interest area as the current interest area Fixation Saccade Report Maximum Message Variables for Eye Event Maximum number of messages associated with a given fixation or saccade that will be shown in the output report Eye Event Msg Variable String Match Token If left blank all messages associated with an eye event will be reported otherwise only those messages containing the token will be reported Fixation Map Type 1 Duration 2 Count 3 Count Density 4 Duration Density The fixation map 1s created based on the duration of fi
161. s in the trial INDEX Sequential order of the trial in the recording INTEREST AREA SET Setting of the interest area Custom Interest Area Set if interest areas are loaded created and Empty Interest Area Set if not IP END TIME End time in milliseconds since EyeLink tracker was activated of the interest period Start time in milliseconds since EyeLink tracker was activated of the interest period PUPIL_SIZE_ MAX Largest pupil size in arbitrary units Typical pupil area is 800 to 2000 units while pupil diameter is in the range of 1800 3000 units in the trial recording Note that PUPIL_SIZE_MAX PUPIL_SIZE_MEAN and PUPIL_SIZE_MIN fields will output a missing value if samples are not loaded into a viewing session see Data Loading Preferences PUPIL SIZE MAX TIME EDF Time of the sample with maximum pupil size Note that this field will output a missing value if samples are not loaded into a viewing session see Data Loading Preferences PUPIL_SIZE_ MAX _X X position at PUPIL_SIZE_MAX_TIME PUPIL_SIZE_MAX_Y Y position at PUPIL_SIZE_MAX_TIME PUPIL_SIZE_ MEAN Average pupil size in arbitrary units in the recording trial PUPIL SIZE MIN Smallest pupil size in arbitrary units in the EyeLink Data Viewer 2002 2010 SR Research Ltd 66 recording trial PUPIL_SIZE_MIN_TIME EDF Time of the sample with minimum pupil SIZe PUPIL_SIZE_MIN_X X position at PUPIL_SIZE_MIN_TIME Note that this fiel
162. saved by clicking the Save Viewing Session As tool la on the standard toolbar 3 5 Importing an EyeLink Data File EyeLink EDF files can be imported into an already opened Viewing session or if no Viewing session is open a new one will be created for you when the data files are imported To import an EDF file 1 From the menus choose File Import Data gt EyeLink File s 2 In the Load dialog box browse to the location of the EDF file that you want to import and select it 3 Click Load Tip EyeLink data can also be imported by clicking the Import EyeLink Data File button on the standard toolbar or press Ctrl l Note The time it takes to load the data files will depend on their size and heavily on whether or not you are loading samples from the data file A 60 minute binocular 500Hz recording will take 3 4 minutes to initially parse the data file if loading all events and samples Once you have saved the viewing session reloading the session takes a fraction of the time because the data is in a format optimized for the Data Viewer EyeLink Data Viewer 2002 2010 SR Research Ltd 8 Note To load data files using the SceneLink gaze mapping please make sure to enable the Enable SceneLink Gaze Mapping and Generate SceneLink Frame Messages in the Data Loading preferences settings before you import the data files Make sure that you have already created the lookup tables for the trials in SceneLin
163. seconds since EyeLink tracker was activated of the interest period viewing session IP_START_TIME Start time in milliseconds since EyeLink tracker was activated of the interest period LAST BUTTON PRESSED ID of the pressed button when the last button is pressed Trial time relative to TRIAL_START_TIME EyeLink Data Viewer 2002 2010 SR Research Ltd 74 when the last button is released LAST BUTTON_TIME Trial time relative to TRIAL_START_TIME when the last button is pressed or released NEXT_FIX_ANGLE Angle between the horizontal plane and the line PREVIOUS_FIX_ANGLE connecting the current fixation and the previous next fixation see 5 2 NEXT_FIX_DIRECTION Direction Left Right Top Bottom relative to PREVIOUS_FIX_ DIRECTION the current fixation in which the next previous fixation is located NEXT_FIX_DISTANCE Distance in degrees of visual angle between the PREVIOUS_FIX_DISTANCE current fixation and the next previous fixation in visual degrees visual angle direction of the next saccade see 5 2 NEXT SAC DIRECTION Direction Left Right Top Bottom relative to the current fixation in which the next saccade is NEXT SAC DURATION Duration of the next saccade 1n milliseconds _AREAS saccade falls REA_INDEX saccade 1s assigned Label for the interest area to which the end REA LABEL position of the next saccade is assigned NEXT_SAC_END_TIME Trial time when the next saccade en
164. so 6 4 2 In those trials with no reaction time defined missing values will be recorded for those variables marked with a f sign Please also note that event counts only factor in visible events If an event is hidden and not visible it will not contribute to event counts If hidden events are visible then they will apply to event counts e EyeLink Data iewer x File Edit Analysis Window Help J Moloi Belelelaolo A Reaction Time Period p DEER x a a a ajs s het inspe i Trial View text Trial 4 i x Data lt Preferences AE fa Alal Interest Period Settings 9 Untitled evs A text ae HE Trial 2 O Trial 3 EHA Trial 4 Eogain ae trouble was brewing not alone for himsel but for every tidewater Figure 6 18 Using Interest Period for Event Filtering Three time periods have been used in a trial output report 1 recording period 2 reaction time period and 3 interest period The recording period START_TIME EyeLink Data Viewer 2002 2010 SR Research Ltd 68 END_TIME and DURATION of a trial starts from the START message in the EDF file and ends on the END message This is fixed for a recording trial regardless how the user set the interest period filters If a valid reaction time definition is found for one trial the RT_ START _ TIME is the time of the RT start message e g time of SYNCTIME message RT_EVENT_END_TIM
165. spe ctor W INOW osese tre esaeiues deceit trader E 10 ANN SD ata TAD a sgssratsnes nce A I 10 AN Veh Data Tree Eierare ny vcs cie cose vcstttxntheetebadaccdaniie cote E T 12 Bb MMe TU TRAST OMIM ssena Gu sies sca cee euler a a 12 Alo Gi Colle Oa a a a E T O A 13 Ath Toterest Area Templates aarin E E EE 14 4 1 1 5 Custom Interest Area Set Empty Interest Area Set ees 15 Bed WRCTCRENCES Tabazr a a nein vtec da leeds 15 a2 tal VA wW N dO W eaaa E E toss 15 Ad Selec ne Data Elements to DISplayecnerennesneie e a 15 Bee Conme ay Ta V AGW ireen ea a wie eeranusieetd 16 AD Tilins Cascagine Windows exsevietraccctedeesavsaniatsneevereaatatedadesaeaameeeties 16 4 3 Spatial Overlay Trial VaiC Wenca AA gaits 17 AA Temporal Graph Trial View secs s ssivccnerctesicuassietaateteaiciniiavedeneteaiseotisietbadeteei ciliate 19 4 4 1 Viewing Sample and Target Data ccsceeseccceccceeaeeeeeeeeeeeeeeeaaeeeeees 19 Acc oomine Opera s cargisccnctsesteasrtat ecient elseentyien sia aaa ee vocontauencaad oe touies 21 4 5 AAO N 9 lt n Arcane pee mere nie amine ot ner en pe artis Di oer geen or SURE Rae pe tts bree aan eet 21 5 Working with Events Samples and Interest Areas cceecseeccceeceeseeeeeeeeeeees 24 5 1 COMMON Opera oN S si ec scntic ces tei wictennoo sain csawenianoe E tains 24 Dds CVE CUMS EVENT aieea ea i 29 ILZ WDCC ine EV S a cena aN erie nets 29 I FAOS oea E AE 25 32A Selec ns PIX AOS sree n e E E 28 I2 ICES PIKIS ee A T 28 92o
166. st period end message must be different from the start message otherwise the user should use a duration based interest period instead see below Duration Based The interest period can also be based on a duration following the detection of the start message e g 10 seconds following the SYNCTIME message The user needs to specify a message string case sensitive DO NOT include quotes for text strings in the Start Time Message Text edit box if an empty string is used this will be the start of the trial recording The user can also specify an optional offset time value so that EyeLink Data Viewer 2002 2010 SR Research Ltd 62 the interest period does not start right on the message time In the Duration edit box enter the desired duration a positive number in milliseconds of the interest period 4 Close the Interest Period Editor dialog This will initialize the interest period for all trials 6 4 2 Using Interest Period The newly created interest periods are added to the interest period list along with the default interest periods Full Trial Period and Reaction Time Period The user can navigate between different interest periods by selecting the desired interest period from the list For each interest period only those events falling within that period are shown in the spatial overlay temporal graph views and in the event list of the inspector window In addition for all of the following output
167. st start with a V directive or the command will not be interpreted and will instead appear as a regular message in the visible message list of the viewer Tip In almost all instances each of the following commands will be repeated for every trial of an EyeLink data file 7 3 1 Trial Variable Values Identifier Default TRIAL _ VAR DATA Description This message specifies the list of trial variable values for the trial The list of trial variable values must be in the same order as was specified in the TRIAL_VAR_LABELS command for the viewer to properly match the variable label with the variable value The command identifier can be changed in the data loading preference settings Note If this command is the same as the Trial Start Command TRIALID the values will still be extracted from the Trial Start Line however a V is not needed in the message Format IV TRIAL VAR DATA lt trial_variable_list gt Example MSG 3363553 V TRIAL_VAR_DATA valuel value2 value3 7 3 2 Single Trial Variable Message Token EyeLink Data Viewer 2002 2010 SR Research Ltd 107 Identifier Default TRIAL VAR Description This command lets the user specify a trial variable and value for the given trial Send one message for each pair of trial condition variable and its corresponding value This means that there is really no need to use TRIAL_VAR_LABELS command when using this command The default command identifier can be changed in th
168. t similarly the saccade report and the interest area report also allows the inclusion of hidden events in the relative event variables PREVIOUS_ and NEXT_ This can be done by clicking the Include Hidden Events in Relative Variables check box If the hidden events are included in the analysis the user can further decide whether or not to treat these events as missing data 6 7 Saccade Report Saccade report creates a columnar output of saccade events in the data file Each row of the report represents a saccade event Depending on the variables selected for output each row can contain information on the previous fixation and or saccade as well as the next fixation and or saccade EyeLink Data Viewer 2002 2010 SR Research Ltd 78 6 7 1 Obtaining a Saccade Report To obtain a saccade report adopt the same procedure as in obtaining the trial report except from the menus choose Analysis gt Report gt Saccade Report a EyeLink Data iewer File Edit Analysis Window Help Reports Recording Event Sequence Data Fixation Report Ctrl F Trial Variable Manager Trial Variable Value Editor Saccade Report Reaction Time Manager Interest Area Report Initialize Reaction Time Events Trial Report Cbrl T Sample Report k i Message Report l 200 L ao Ssererarerrecread the newspi E EI Trial 2 hb NE eB vedo Figure 6 21 Creating a Saccade Report 6 7 2 Variables in the Sacc
169. te of upper left corner 4 Select the entry for Right and type in the desired x coordinate of bottom right corner 5 Select the entry for Bottom and type in the desired y coordinate of bottom right corner EyeLink Data Viewer 2002 2010 SR Research Ltd 45 5 8 13 Resizing Freehand Interest Areas A freehand interest area can be resized by following these steps 1 Select the interest area 2 Hold the ALT key down 3 Place the mouse over the vertex to be dragged the arrow cursor changes into a hand cursor 4 Press the left mouse button and drag the vertex to the desired location 5 Release the mouse button 5 8 14 Deleting Interest Areas To delete interest areas 1 To delete interest areas without removing any events falling within first toggle off all event visibility 2 Select the interest areas 3 Press the right mouse button 4 Select the Delete option from the popup menu 5 Confirm that the IAs should be deleted Tip Interest areas can also be deleted by clicking the Delete Selected Items button m or the Cut Selected Item button on the desktop toolbar 5 8 15 Splitting Interest Areas Rectangular and elliptic interest areas can be split either horizontally or vertically You can split many interest areas at one time by selecting multiple IAs To split all selected IAs 1 Select the IA s to split 2 Press the right mouse button 3 Select Split from the popup menu 5 8 16 Merging Interest A
170. ter is erased with white 7 3 4 6 Draw List File Identifier DRAW _ LIST Description When a large number of simple drawings have to be made it is easier to first record all of the simple drawings in a draw list file During the viewing session the viewer reads in the drawing commands from the pre recorded file and re creates the display drawing In a draw list file dlf each line represents one simple drawing or an image loading command written in the same format as mentioned above except that V directive is not necessary Format V DRAW_LIST lt relative path gt Example Example MSG 262495 V DRAW_LIST BER s1106 dl1f The content of the file being CLEAR 255 255 255 IMGLOAD TOP_LEFT BER color bmp 772 644 33 33 IMGLOAD TOP_LEFT BER shape bmp 772 314 33 33 IMGLOAD TOP_LEFT BER orient bmp 222 424 33 33 IMGLOAD TOP_LEFT BER color bmp 552 94 33 33 This first clears the display and then loads four small bitmap images EyeLink Data Viewer 2002 2010 SR Research Ltd 113 7 3 5 Interest Area Commands The viewer supports a set of interest area commands that inform the viewer what interest areas to create by default for a given trial Trials that have interest area commands specified in the data file have a custom interest area set created when the data is loaded containing the specified interest areas All interest area commands start with the AREA token and are followed by a one word sub command 7 3 5 1 Rectangula
171. the IsCustom field is true for the custom interest area set 4 1 2 Preferences Tab The preferences tab Figure 4 2 right panel provides access to all the elements of the data viewer that can be configured by the user These include everything from the default colors used for displaying events to the elements of an EDF file to load These elements are broken down into the following five categories General Preferences Data Loading Preferences Output Analysis Preferences Data Filters Preferences General Trial View Preferences Spatial Overlay View Settings Temporal Graph View Settings and Animation Playback Settings 4 2 Trial View Window The Trial View window displays the data of a selected trial in a Spatial Overlay Mode a Temporal Graph Mode or an Animation Playback Mode Selecting a trial in the Data Inspector tree view shows the trial s data in a Trial View Window The user can have several Trial View Windows open at one time by right clicking on a trial in the Inspector window and selecting New Window in the popup menu 4 2 1 Selecting Data Elements to Display At anytime event visibility can be toggled on off within the Trial View Window For example the button in the Application Desktop toggles the visibility of Fixation Events EyeLink Data Viewer 2002 2010 SR Research Ltd 15 Toggle Fixation Event Visibility Toggle Saccade Event Visibility Toggle Blink Event Visibility Toggle Message Event Visibility
172. the trial VIDEO FRAME INDEX START Index of the video frame that was visible at the start of the eye event Note that all VIDEO_ variables are applicable to SceneLink recordings or some Experiment Builder recordings only For SceneLink recordings please check out the Data Loading Preference Settings of the eye event start of the eye event end of the eye event In addition to these default variables other user defined variables are also listed if they have been defined in the EDF file see section 7 2 1 on creating trial variable labels or created during the viewing session see section 6 1 1 on trial variable manager Please note that the data output in the fixation report depends on the setting of interest period filter see section 6 4 2 or Figure 6 18 only those fixation and saccade events falling within the active interest period will be reported If the Trimmed Spanned Fixation Duration setting of the Data Filter preference is enabled the duration start time and end time of the fixations that overlap with the start or end of the interest period will be adjusted accordingly If a valid reaction time definition is found in a trial the TRIAL START _ TIME will be set as the start as the reaction time definition otherwise this will be set as the start of trial recording see section 6 5 3 on discussion of three time periods used in Data Viewer As a result the values of CURRENT_FIX_END and CURRENT _FIX_STAR
173. the type of fixation map created the total number of trials and fixations contributing to the output and the maximum per trial average value for the type of map chosen The legend of the map indicates how long or how often subjects have looked across the map By default the frequently fixated areas are painted in red whereas the less fixated areas are painted in green The drawing colors and the transparency of the drawing can be configured through the preferences A gray scale version is also available if the Enable Heat Map Mode option is unchecked The following is a sample output of the four different fixation maps for the same data trial A original fixations in the spatial overlay view B the duration based fixation map C the density distribution of the fixation durations 1 e proportion of trial dwell time on each area of the display D the count based fixation map and E the density distribution of the fixation counts 1 e how frequently each area of display area has been visited EyeLink Data Viewer 2002 2010 SR Research Ltd 52 EyeLink Data Viewer 2002 2010 SR Research Ltd 53 Figure 6 6 Types of Fixation Map A single fixation map is useful for the purpose of identifying informative parts of a display the legend displays colors that correspond to the peak and lowest activation values However fixation activities across two different fixation maps cannot be directly compared if the scales of the tw
174. third trial of the template loads individual images IMGLOAD TOP_LEFT to create a composite image in the Viewer and reads individual rectangular interest areas directly IAREA RECTANGLE All these changes listed in the following table were made in the w32_picture_trials c file of the template Data Viewer Functionality Message Commands Trial Variable Labels eyemsg_printf TRIAL_VAR_LABELS TYPE Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA s imgname num 1 Images o images sacrmeto jpg eyemsg_printf V IMGLOAD FILL images sac_blur jpg Composite image eyemsg_printf V IMGLOAD TOP_LEFT s d d d d small_images 1 points i x points i y SCRWIDTH 2 SCRHEIGHT 2 Composite image eyemsg_printf V AREA RECTANGLE d d d d d Ps 1 1 points 1 x points i y points i x SCRWIDTH 2 points i y SCRHEIGHT 2 small_images 1 7 5 4 EyeData Template The following table lists all of the changes made to the w32_data_trials c file of the EyeData template Data Viewer Functionality Message Commands Trial Variable Labels eyemsg_printf TRIAL_VAR_ LABELS CONDITION Trial Variable Values eyemsg_printf V TRIAL_VAR_DATA Playback eyemsg_printf V IMGLOAD FILL images grid png EyeLink Data Viewer 2002 2010 SR Research Ltd 122 eyemsg_printf V IAREA FILE segments grid 1as 7 5 5 GCWindow Template The following table lists all of t
175. through the definition of some spatial or temporal filtering preferences Hiding events allows the user to focus on a subset of a trial s data Hidden events can be made visible again at a later date if required Events can also be deleted from within the Data Viewer This is useful for example if the researcher inspects a specific fixation or saccade event and determines that the event detection performed by the EyeLink on line parser did not satisfy their needs If a fixation or saccade event is deleted the surrounding saccade or fixation events are automatically merged to keep the event structure consistent The position of a fixation event can also be adjusted if required This is only suggested if it is obvious to the user that improper system setup or calibration has resulted in a trial s fixation data containing significant drift that can be easily corrected manually Any event that is adjusted in this fashion is flagged so that it 1s clear what events have been manually altered Optionally if the position of a fixation is adjusted the adjoining EyeLink Data Viewer 2002 2010 SR Research Ltd 2 saccade end point and start point are also adjusted so that the saccade positions are kept consistent with fixation positions 1 5 Interest Periods and Reaction Time Definition For each trial the user may selectively view and perform analysis on data within a specific period of time within a trial Interest Period The EyeLink Data View
176. tions select the first fixation by mouse and press the up cursor key to select the next fixation until all target fixations are selected Use the down cursor key to unselect the recently selected fixations The left or right cursor key can be used to choose a group of fixations earlier or later in the temporal sequence 5 2 2 Merging Fixations In some cases two or more temporally contiguous fixations can be merged and represented as a larger fixation To merge fixations select the fixations and click the Merge Selected Items button 45 on the toolbar or click the right mouse button and select merge Note Only two or more temporally contiguous fixations can be merged If fixations are selected that are not temporally contiguous only the neighboring fixations will be merged 5 2 3 Drift Correcting Fixations Sometimes a drift in the gaze position may occur due to poor system setup headband slippage or excessive head body movement Normally the eye tracker operator would notice this problem and perform a recalibration or drift correction If however the issue was not addressed during recording it may be possible to manually adjust the fixation events so that some degree of data analysis can still be performed 5 2 3 1 Drift correcting a Group of Selected Fixations To perform drift correction 1 Select the fixations to be drift corrected 2 Hold the ALT key down 3 Move the selected fixations with the cursor keys to th
177. um Value of 0 5 which is higher than the default 10 cutoff value 1 e 0 2 fixation with areas below the fixed minimum value clipped EyeLink Data Viewer 2002 2010 SR Research Ltd 54 Figure 6 7 Adjusting the Scale of the Fixation Map 6 3 Managing Reaction Time Definitions EyeLink Data Viewer 2002 2010 SR Research Ltd 55 Another important application of the trial condition variables is for managing reaction time definitions for all the trials in the same experimental condition A typical trial recording could be ended in several ways such as a button response a saccade event a fixation event or a special message To obtain an accurate reaction time RT measure the EyeLink Data Viewer relies on a set of reaction time definitions to parse the start and end events for RT calculation The reaction time manager allows the user to configure the way in which the trial starts and ends for each condition of the experimental design Once a set of RT definitions has been created and initialized the RT start and end event information is available in both the trial view window and the inspector window 6 3 1 Reaction Time Manager The Reaction Time Manager is used to create edit or delete reaction time definitions for different experimental conditions The user can set parameters of a trial end event and specify condition values that must be matched for the RT definition to be applied to a given trial To configure reaction ti
178. velocity in visual degrees per second of the next saccade _AREAS saccade falls Interest area to which the start point of the next AREA _ INDEX saccade is assigned Label for the interest area to which the start AREA LABEL ned NEXT SAC START TIME Trial time when the next saccade ends NEXT SAC START X X coordinates of the start point for the next saccade NEXT_SAC_START_X_RESOLU Horizontal angular resolution in screen pixels per degree at the start of the saccade If samples are loaded into the viewing session this takes the horizontal resolution of the first sample in the saccade otherwise the horizontal resolution of the current fixation 1s used NEXT SAC START Y Y coordinates of the start point for the next saccade NEXT_SAC_START_Y_RESOLU Vertical angular resolution in screen pixels per degree at the start of the saccade If samples are loaded into the viewing session this takes the EyeLink Data Viewer 2002 2010 SR Research Ltd 76 vertical resolution of the first sample in the saccade otherwise the vertical resolution of the current fixation is used Note Similar analyses are done for the previous saccade variables beginning with PREVIOUS_SAC TRIAL FIXATION TOTAL Total number of fixations in a trial TRIAL_INDEX Sequential order of the trial in the recording TRIAL_LABEL Label of the trial TRIAL START TIME The start time in milliseconds since EyeLink tracker was activated of
179. vent Selection EyeLink events can be selected for either of the data views temporal graph view or spatial overlay view Detailed properties of the selected event can be examined within a Inspector Window that also provides a list view of all visible events in the selected trial Properties of a selected event that are editable by the user like the events color can be modified directly within the inspector window 1 3 Interest Area Definition The Spatial Overlay View allows creation of any number of interest areas for the trial Rectangular elliptic and freehand interest area shapes can be created The position and shape of the Interest Area can be modified after Interest Area creation Users can view fixation based statistics for a selected interest area including the fixation count and total dwell time for the interest area as well as the proportion of fixations and dwell time relative to the trial totals Interest area templates can be created which can then be applied to multiple trials speeding the process of defining interest areas for multiple trials 1 4 Event Filtering The EyeLink Data Viewer supports data filtering including deleting merging and drift correcting event types Not all filtering functions are available to all event types The original EyeLink EDF file is never modified by the Data Viewer so the originally recorded data is always available Any event can be hidden within the Data Viewer either manually or
180. w value DO NOT include quotes for text strings and press Enter to register the change Note presumably the user would load EDF files of the same experiment with the same condition labels into one viewing session Loading EDF files containing different condition labels from each other may result in some unexpected findings 6 1 3 Trial Grouping Trial condition variables are important for identifying one specific trial or grouping trials tested under the same experimental condition Thus instead of going through each of the individual trials a trial grouping mechanism can be applied to manipulate those trials collectively For example practice trials can be removed from the viewing session in a batch interest area templates can be applied to those trials using the same search display and potentially a landscape view can be created for the same display image with data collected from several subjects to identify the informative parts of the display By default the Data Viewer group all of the trial by data file To regroup trials within a viewing session select the viewing session icon click the right mouse button and choose the Trial Grouping option In the following Edit Trial Grouping dialog choose the variable with which the grouping should be performed and press the Regroup button see the left panel of Figure 6 3 Multiple grouping variables can be selected or de selected by using the control key if
181. w variable label with a default value default value will appear Select the variable and change its label and default value in the two edit boxes DO NOT include quotes for text strings To remove one variable select it in the list and click the delete button 1 Sometimes the order in which the variables are listed is important This is especially true when you want to match the variables created with the Trial Variable Manager and the values read from the command messages in EDF file e g TRIAL_VAR_DATA TRIALID see the preference settings on data loading To do that simply select the variable and use the or W button to move it to the desired position 6 1 2 Trial Variable Value Editor EyeLink Data Viewer 2002 2010 SR Research Ltd 48 The variables and their values can be viewed and edited in the Trial Variable Value Editor dialog box fh Trial ariable alue Editor PAGE CONDITION tex t i 1 undfined a Be Retaul va e E T a a 2 Figure 6 2 Trial Variable Value Editor Dialog To activate the dialog box from the menus choose Analysis Trial Variable Value Editor The top row of the dialog box lists the filename variables imported from the EDF file as well as variables created by the Trial Variable Manager The following rows list the corresponding values for the variables in each individual trial To change the value for a particular cell double click on the current value type in the ne
182. wer window or have it occluded as whatever is visible on the display frame will be saved in the capture as well EyeLink Data Viewer 2002 2010 SR Research Ltd 23 5 Working with Events Samples and Interest Areas The EyeLink Data File EDF file contains two streams of data eye position samples up to 2000 per second produced from the EyeLink tracker depending on the system model and events eye movement events such as saccades and fixations subject responses and synchronizing events from the experimental application Both streams are time synchronized for easy analysis The file is organized into trials of data one for each of the start and stop of tracker recording Each trial may have samples events or both Samples are time stamped in milliseconds and contain monocular or binocular eye position data for now Data Viewer only report the eye position in screen coordinate GAZE while other data formats PUPIL or HREF are ignored Pupil sizes as area or diameter are also recordable Samples may also contain eye movement resolution used to compute true velocity or saccadic amplitudes Eye movement events record eye position changes identified by the EyeLink tracker s on line parser such as fixations blinks and saccades Both the onset and end of these events are marked allowing samples to be assigned to eye movement periods without complex algorithms Important data for analysis such as average position for fixations and
183. xample the presence of an outlier fixation may break the run of fixations on a particular interest area and therefore shortens the measure of IA_FIRST_ RUN DWELL_TIME and increases the IA RUN COUNT value Therefore users should ensure that all fixations are assigned to a particular interest area before creating an interest area report if run related measures are important Users can either manually move the position of those outlier fixations or more conveniently enable EyeLink Data Viewer 2002 2010 SR Research Ltd 87 the Use Nearest Interest Area for Outlier Fixations option of the Output Analysis preference settings Interest area report was designed to support analysis of data from different research paradigms and therefore the user only needs to use a small portion of variables in one output If you have lots of interest areas in a trial including IA_FSA_COUNT and IA_FSA_DURATION in the output report may take a very long time for the Viewer to generate the report A progress dialog see Figure 6 25 will be displayed while creating the report The user may abort the process by pressing the Cancel button e Progress x ra Creating Report i Session 0 Trial 1 14 20 TTT Cancel Figure 6 25 Progress Dialog Box Displayed when Creating the Interest Area Report 6 8 3 1 Fixation Sequence Analysis Variables A_FSA_COUNT and IJA_FSA_DURATION are used primarily for fixation sequence analysis 1 e examination o
184. xations 1 count of the fixation 2 probability of fixation across the display 3 or proportion of trial dwell time 4 Sigma in degrees Sets the standard deviation of the Gaussian distribution for each fixation point when creating a fixation map EyeLink Data Viewer 2002 2010 SR Research Ltd 130 Low Activity Cut off 0 0 100 0 Sets the minimum amount of activation required to have an area painted with an activation color this is a certain percent of the actual maximum per trial average value for the map to keep the contour of the fixation map in case the actual maximum per trial average value is different from the Fixed Maximum Value If set to 0 the whole map is painted with most of the areas in low activity color Fixed Minimum Value By default the scale of the legend starts from 0 A non zero value set here will be used as the minimum value of the scale Any areas with an activation value below this fixed minimum value but above the Low Activity Cut off 0 0 100 0 threshold will be painted with the low activity color Clip Map below Fixed Minimum If this enabled this will not draw an areas with an activation value below the Fixed Minimum Value set above Fixed Maximum Value If set to the default value of 1 the maximum value in the legend is based on the actual heat map maximum value Any value gt 0 will be used as the maximum legend scale Any areas with an activation value above this fixed m

EyeLink Data Viewer User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents