viewpoint eyetracker - ucla brain 1.12 citing viewpoint 6 1.12.1 citing viewpoint in methods section

Download ViewPoint EyeTracker - UCLA Brain 1.12 Citing Viewpoint 6 1.12.1 Citing Viewpoint in Methods Section

Post on 19-May-2020

0 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

  • ViewPoint EyeTracker ®

    UserGuide

    ®

    Arrington Research

    Karl Frederick Arrington, Ph.D.

  • Arrington Research

    March 2, 2016 15:31:00

    2016 © Arrington Research, Inc. All rights reserved.

    Contact Information Arrington Research, Inc.

    27237 N 71st Place, Scottsdale, AZ 85266

    United States of America

    Phone +1-480-985-5810 www.ArringtonResearch.com ViewPoint-EyeTracker@ArringtonResearch.com

    ViewPoint EyeTracker ® is a Registered Trademark of Arrington Research, Inc. ViewPoint ~ Voltage ™ is a Trademark of Arrington Research, Inc. RemoteLink™ is a Trademark of Arrington Research, Inc. ViewPoint Client ™ is a Trademark of Arrington Research, Inc. 3D ViewPoint ™ and 3DVP™ are Trademarks of Arrington Research, Inc. 3D WorkSpace ™ and 3DWS™ are Trademarks of Arrington Research, Inc. Experiment Engine ™ is a Trademark of Arrington Research, Inc.

    ViewPoint version: 2.9.5.111 C:\ARI\ARI Graphic Arts\ARI Documentation\VP Manual\ViewPoint-UserGuide-099.docx

    http://www.arringtonresearch.com/ mailto:EyeTracker@ArringtonResearch.com

  • Arrington Research

    CHAPTER 1. INTRODUCTION 1

    1.1 Congratulations 1 1.2 Contact Us 1

    Custom Software & Hardware Development 1 1.2.1 User Feedback & Support 1 1.2.2

    1.3 License Information and Conditions of Use 1 1.4 Styles 2 1.5 High-Risk Activities Warning 3 1.6 Computer System Requirements 3 1.7 How to Use this UserGuide 3 1.8 Hardware Installation 4 1.9 Documentation Folder 4 1.11 Info Window 5 1.12 Citing Viewpoint 6

    Citing Viewpoint in Methods Section 6 1.12.1 Citing Viewpoint in References Section 6 1.12.2

    CHAPTER 2. OVERVIEW OF VIEWPOINT 7

    2.1 Complete Environment 7 2.2 Interfaces 7

    Graphical User Interface (GUI) 7 2.2.1 Command Line Interface (CLI) 7 2.2.2 Using CLI Commands 8 2.2.3

    2.2.3.1 Settings Files 8 2.2.3.2 Interactive CLI Window 8 2.2.3.3 FKey and TTL 8 2.2.3.4 SDK/API 8 Software Developer’s Kit (SDK) 8 2.2.4 Ethernet & ViewPointClient TM 8 2.2.5

    2.2.5.1 ViewPointClientTM for PC 8 2.2.5.2 ViewPointClientTM for Mac 9

    2.3 Interfaces to Third Party Products 9 Integrity Suite TM 9 2.3.1 Other Third Party Interfaces 9 2.3.2

    2.4 Use the SDK to write your own Layered Applications. 10 SDK Communication 10 2.4.1 Example Layered Interface Applications 10 2.4.2

    2.5 Pilot Data 10

    CHAPTER 3. DIFFERENT CALIBRATION METHODS 11

  • Arrington Research

    CHAPTER 4. SOFTWARE INSTALLATION 12

    4.1 ViewPointLicense (.VPL) File 12 4.2 Program Layout 12

    User Windows 13 4.2.1 Menu Navigation 15 4.2.2

    4.3 Criteria 16

    CHAPTER 5. QUICK START SECTION 17

    5.1 Eye Camera & LED Illuminator Positioning 17 Camera Positioning 17 5.1.1 EyeFrame Camera Positioning 18 5.1.2 Remote System Camera Positioning 18 5.1.3

    5.2 Pan/Zoom/AutoCenter 18 Panning 18 5.2.1 Zooming 19 5.2.2 AutoCenter 19 5.2.3

    5.3 Locating the Pupil – All Systems 20 Corrective Lenses (Eye Glasses) 20 5.3.1

    5.4 Thresholding – All Systems 21 5.5 Calibration 21

    Calibration (Head Fixed and HMD Systems) 21 5.5.1 5.5.1.1 HMD Partial Binocular Overlap 22 Calibration (SceneCamera) 22 5.5.2

    5.6 Stimuli 24 Choosing the Type of Stimulus 24 5.6.1 ViewPoint Stimulus Window 24 5.6.2 Interactive Computer Display 24 5.6.3 SceneCamera Systems 24 5.6.4 Show SceneVideo in Stimulus window 25 5.6.5

    5.7 Data Collection – All Systems 25 5.8 Recording Scene and Screen Movies 27

    Recorded Movie Format 27 5.8.1 Display of Overlay Graphics in Recorded Movie 28 5.8.2 Compression 28 5.8.3

    5.9 DataAnalysis program 28 5.10 Analysis Options 28

    Head Fixed and HMD Systems 28 5.10.1 Playing Scene and Screen Movies 29 5.10.2

    5.11 Frequently Used Settings 29 5.12 Preferred Window Layout 29 5.13 Accelerator Keys & FKeys 29 5.14 Printing 29

  • Arrington Research

    CHAPTER 6. LOCATING THE PUPIL AND GLINT (ALL SYSTEMS) 30

    6.1 EyeCamera Window 31 6.2 Feature Method 31

    Single DataPoint 31 6.2.1 Multiple DataPoint 31 6.2.2

    6.2.2.1 Advantages 32 6.2.2.2 Disadvantages 32 Slip Compensation 32 6.2.3

    6.3 Simulation of Gaze 32 Manual Simulation 32 6.3.1 Pattern Simulation 33 6.3.2

    6.4 Thresholding 33 6.5 Setting the Scan Density 33 6.6 Manual Thresholding of the Dark Pupil 34 6.7 Step-by-step guide for Glint-Pupil Vector method 35 6.8 Noise 36 6.9 Automatic Slip Compensation 36 6.10 Feature Criteria 37

    Pupil Aspect Criterion 37 6.10.1 Width Criteria 37 6.10.2

    6.11 Alternative Segmentation Methods 37 Ellipse 37 6.11.1 Centroid 38 6.11.2 Oval Fit 38 6.11.3 PupilScanArea Shape Options 38 6.11.4 Glint Segmentation Methods 38 6.11.5

    CHAPTER 7. BINOCULAR OPTION 39

    7.1 To switch Operating in Binocular Mode 39 7.2 CLI Prefix – EyeTarget Specifier 39 7.3 Setup 40 7.4 Storing Data 40 7.5 Real-Time Display of Binocular Data 40

    CHAPTER 8. CALIBRATION 41

    8.1 Calibration Carryover 41 8.2 Choosing the Number of Calibration Points 41 8.3 Automatic Calibration (Head Fixed) 41 8.4 Assessing Calibration Success 42 8.5 CalibrationImage 43

  • Arrington Research

    8.6 Binocular Calibration 44 8.7 Omitting Individual Calibration Points 44

    Automatic Omitting 44 8.7.1 Manual Omitting 45 8.7.2

    8.8 Re-presenting Individual Calibration DataPoints 45 8.9 Slip Correction 45 8.10 Gaze Nudge 45 8.11 Dominant Eye 46 8.12 Advanced Calibration Controls 46

    Calibration Stimulus & Background Color 47 8.12.1 Timing & Warning 47 8.12.2 Presentation Order 47 8.12.3 Stimulus-Point Locations 48 8.12.4

    8.12.4.1 Custom Calibration Point Positions 49 8.12.4.2 Partial Binocular Overlap 49

    Flipping the Initial Calibration 49 8.12.5 Adjusting the Calibration Area 50 8.12.6 Snap and Increment Calibration Modes 50 8.12.7 Manual Calibration 50 8.12.8 Calibration Points in a Settings file 51 8.12.9

    CHAPTER 9. CORRECTIONS BASED ON MEASUREMENTS 52

    9.1 Obtaining POG in Degrees: 2D Geometry 52 Stimulus Window or InterActive Display -- HeadFixed (non-HMD) 53 9.1.1 HeadMounted SceneCamera 53 9.1.2 HeadMounted Display 54 9.1.3 Notes on Measurement Lines 55 9.1.4 Geometry Grid 55 9.1.5

    9.2 Parallax Correction for Binocular SceneCamera systems 56 Manual Parallax Adjustment 57 9.2.1 Parallax Correction from Data 57 9.2.2

    9.3 Pupil Diameter 58 Raw Pupil Size 58 9.3.1 Calculated Pupil Diameter 59 9.3.2

    9.4 Inter-Pupillary Distance (IPD) 60 9.5 Pupil Aspect 60

    CHAPTER 10. CURSOR CONTROL - EYEMOUSE 61

    CHAPTER 11. OCULAR TORSION 62

    11.1 Introduction to Torsion 62

  • Arrington Research

    11.2 Procedure for Measuring Torsion 64 11.3 Torsion Demonstration Test 65 11.4 Cyclovergence 65 11.5 Overriding the Default Torsion Parameters 65 11.6 Torsion Data 66

    CHAPTER 12. STIMULUS PRESENTATION ( HEAD FIXED ) 67

    12.1 General 67 12.2 PictureList 68 12.3 Using the Stimulus Window (Head Fixed Option) 69 12.4 Stereo Display 69 12.5 Using the GazeSpace Window 70 12.6 Regions of Interest (ROI) 71 12.7 ROI use Corrected Data 72 12.8 Associating an Image with Specific ROI 73 12.9 ROI Transition Statistics or Linkages 73 12.10 Controlling Stimulus Presentation 75

    CHAPTER 13. DATA COLLECTION 76

    13.1 Sampling Rate 76 13.2 Saving Data to File 76

    Unprocessed & Corrected Data 76 13.2.1 13.3 Data File Format 77

    File Header Information 77 13.3.1 File Records 77 13.3.2 Synchronous vs. Asynchronous Data Inserts 78 13.3.3 Data Record Tags. 79 13.3.4 User Defined Data 79 13.3.5

    13.4 PupilWidth and PupilHeight calculations 83 13.5 Direction-of-Gaze Coordinates 83 13.6 Raw Data 83 13.7 Timing Measurement 83 13.8 Display Screen Geometry 84 13.9 Events Data 84 13.10 Regions of Interest (ROI) 85 13.11 Quality Marker Codes 85

    CHAPTER 14. DATA DISPLAY & ANALYSIS 86

    14.1 Real-Time 86 PenPlots 86 14.1.1

  • Arrington Research

    Data Smoothing 87 14.1.2 14.2 Fixation, Saccade, Drift and Blinks 88

    Fixations 88 14.2.1 Criteria Levels 89 14.2.1 Saccade Velocity Criterion 89 14.2.2 Drift Criterion 90 14.2.3 Fixation Time Criterion 90 14.2.1 Blinks 90 14.2.2 Events Markers 90 14.2.3 Events Window 90 14.2.4 SDK 91 14.2.5

    14.3 Post-Hoc 91 14.4 Summary Data 91

    CHAPTER 15. STATE ENGINE 92

    15.1 State Engine Commands 92 State Initialization 92 15.1.1 State Setup 92 15.1.2 State Commands 92 15.1.3 State Transition Commands 92 15.1.4 State Space Debug 93 15.1.5

    15.2 Picture Lists 93 15.3 Counters 93 15.4 Miscellaneous 94

    CHAPTER 16. USING SETTINGS FILES 97

    16.1 CLI String Parsing 97 16.2 Saving and Loading Settings Files 97

    Startup Folder 98 16.2.1 FinishUp Folder 98 16.2.2 Settings/LastRun.txt 98 16.2.3

    16.3 Settings File Examples 98 16.4 CLI commands 99 16.5 Associating CLI s with FKeys 99 16.6 Command Line Interface Window 99 16.7 Settings File Lists (Deprecated) 99

    CHAPTER 17. ETHERNET COMMUNICATION BETWEEN COMPUTERS 101

    17.1 Ethernet Software Connections 102 Changing the ViewPoint IP Address 102 17.1.1

  • Arrington Research

    Changing the Port Number 102 17.1.1 Running the ViewPoint Server 103 17.1.2 Ping Clients 103 17.1.3 Loopback 10