SR Research Experiment Builder User Manual
Total Page:16
File Type:pdf, Size:1020Kb
SR Research Experiment Builder User Manual Version 2.1.140 Please report all functionality comments and bugs to: [email protected] An HTML version of this document, which contains extra sections on example projects and frequently asked questions, can be accessed by pressing F1 or clicking “Help → Content” from the Experiment Builder application, or can be downloaded from https://www.sr-support.com/forums/showthread.php?t=99. Copyright ©2004-2017 SR Research Ltd. EyeLink is a registered trademark of SR Research Ltd., Mississauga, Canada Table of Contents 1 Introduction ................................................................................................................... 1 1.1 Features .................................................................................................................. 1 1.2 How to Use This Manual ....................................................................................... 2 1.3 Citing Experiment Builder ..................................................................................... 3 2 Experiment Builder Experiment Life Cycle ................................................................. 4 2.1 Experiment Design ................................................................................................. 4 2.2 Building and Test-running Experiment ................................................................. 5 2.3 Experiment Deployment ........................................................................................ 5 2.4 Participant Data Set Randomization ...................................................................... 6 2.5 Data Collection ...................................................................................................... 6 2.6 Data Analysis ......................................................................................................... 6 3 Installation ..................................................................................................................... 8 3.1 Windows PC System Requirements ...................................................................... 8 3.1.1 Computer Configuration ................................................................................. 8 3.1.2 Maximizing the Real-time Performance of the Display PC ........................... 9 3.1.3 Host Computer and Display Computer Software Requirements .................. 11 3.2 Software Installation and Licensing on Windows ............................................... 11 3.2.1 For Standard Installation (Applicable to Most Users) .................................. 12 3.2.2 For Installation Using Network Licensing .................................................... 12 3.3 Software Installation and Licensing on Mac OS X ............................................. 14 3.3.1 Experiment Builder Installation .................................................................... 14 3.3.2 Other Software Installation ........................................................................... 15 3.3.3 HASP Driver Installation and Licensing ...................................................... 16 4 Working with Files ..................................................................................................... 18 4.1 Creating a New Project ........................................................................................ 18 4.2 Saving a Project ................................................................................................... 20 4.3 Saving an Existing Project to a Different Directory ............................................ 21 4.4 Opening an Existing Project ................................................................................ 21 4.5 Reopening a Recent Experiment Project ............................................................. 23 4.6 Lock/Unlock a Project ......................................................................................... 24 4.7 Packaging an Experiment .................................................................................... 24 4.8 Unpacking an Experiment .................................................................................... 25 4.9 Building an Experiment ....................................................................................... 25 4.10 Cleaning an Experiment ..................................................................................... 26 4.11 Test-running an Experiment from EB Application ............................................ 26 4.12 Deploying an Experiment .................................................................................. 26 4.13 Running an Experiment for Data Collection ..................................................... 27 4.14 Converting Projects Between Windows and Mac OS X ................................... 29 5 Experiment Builder Graphical User Interface ............................................................ 30 5.1 Project Explorer Window .................................................................................... 30 5.2 Graph Editor Window .......................................................................................... 34 5.3 Application Menu Bar and Toolbar ..................................................................... 35 5.3.1 File Menu and Tool Buttons ......................................................................... 35 5.3.2 Edit Menu and Tool Buttons ......................................................................... 36 5.3.3 View Menu .................................................................................................... 37 SR Research Experiment Builder User Manual ©2004-2017 SR Research Ltd. i 5.3.4 Experiment Menu and Tool Buttons ............................................................. 37 5.3.5 Help Menu .................................................................................................... 37 6 Designing an Experiment in Experiment Builder ....................................................... 39 6.1 Hierarchical Organization of Experiments .......................................................... 39 6.2 Experiment Graph: Flow Diagram ....................................................................... 40 6.2.1 Adding Components to an Experiment ......................................................... 41 6.2.2 Linking Experiment Components ................................................................. 42 6.2.3 Linking Rules ................................................................................................ 42 6.3 Actions ................................................................................................................. 43 6.4 Triggers ................................................................................................................ 44 6.5 Other Node Types ................................................................................................ 45 6.6 Sequence .............................................................................................................. 45 6.7 References and Equations .................................................................................... 46 7 Experiment Graph and Components ........................................................................... 49 7.1 Graph Editing Operations .................................................................................... 49 7.2 Node Connection ................................................................................................. 50 7.2.1 Connection: Create, Cancel, and Delete ....................................................... 50 7.2.2 Connection Order .......................................................................................... 50 7.2.3 Node Exporting and Importing ..................................................................... 51 7.2.3.1 Exporting ................................................................................................ 51 7.2.3.2 Importing ................................................................................................ 52 7.3 Layout of Nodes in Work Space .......................................................................... 53 7.4 Editing Properties of a Node ................................................................................ 54 7.5 Experiment Node ................................................................................................. 55 7.6 Sequence .............................................................................................................. 57 7.6.1 Typical Use of Sequences in an Experiment ................................................ 60 7.6.2 EyeLink Recording Status Message ............................................................. 63 7.7 Start Node ............................................................................................................ 64 7.8 Actions ................................................................................................................. 64 7.8.1 Display Screen .............................................................................................. 65 7.8.1.1 Reading Display Time ........................................................................... 68 7.8.1.2 Using Display Screen Actions ............................................................... 69 7.8.2 Performing Drift Correction ......................................................................... 70 7.8.3 Performing Camera Setup and Calibration ................................................... 75