SR Research Experiment Builder User Manual
Total Page:16
File Type:pdf, Size:1020Kb
SR Research Experiment Builder User Manual Version 1.10.165B 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 be downloaded from https://www.sr-support.com/forums/showthread.php?t=99. Copyright ©2004-2011 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 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................................................................................................................... 7 3.1 Windows PC System Requirements ................................................................... 7 3.1.1 Computer Configuration ................................................................................. 7 3.1.2 Maximizing the Real-time Performance of the Deployment PC .................. 11 3.1.3 Host Computer and Display Computer Software Requirements .................. 11 3.2 Software Installation and Licensing on Windows ............................................ 12 3.2.1 For Standard Installation (applicable to most users)..................................... 12 3.2.2 For Installation using Network Licensing ..................................................... 12 3.2.3 HASP Driver Installation and Licensing ...................................................... 13 3.3 Software Installation and Licensing on Mac OS X .......................................... 14 3.3.1 Software Installation ..................................................................................... 14 3.3.2 HASP Driver Installation and Licensing ...................................................... 16 4 Working with Files ................................................................................................... 18 4.1 Creating a New Session .................................................................................... 18 4.2 Saving a Session ............................................................................................... 20 4.3 Saving an Existing Session to a Different Directory ........................................ 21 4.4 Opening a Session ............................................................................................. 21 4.5 Reopening a Recent Experiment Session ......................................................... 22 4.6 Packaging an Experiment ................................................................................. 23 4.7 Unpacking an Experiment ................................................................................. 23 4.8 Building an Experiment .................................................................................... 24 4.9 Cleaning an Experiment .................................................................................... 24 4.10 Test-running an Experiment from EB Application ........................................... 24 4.11 Deploying an Experiment ................................................................................. 25 4.12 Running an Experiment for Data Collection .................................................... 25 4.13 Conver ting Projects between Windows and Mac OS X .................................. 27 5 Experiment Builder Graphical User Interface .......................................................... 28 5.1 Project Explorer Window ................................................................................. 28 5.2 Graph Editor Window ....................................................................................... 31 5.3 Application Menu Bar and Toolbar .................................................................. 32 5.3.1 File Menu and Tool Buttons ......................................................................... 32 5.3.2 Edit Menu and Tool Buttons ......................................................................... 33 5.3.3 View Menu.................................................................................................... 34 5.3.4 Experiment Menu and Tool Buttons ............................................................. 34 5.3.5 Help Menu .................................................................................................... 34 SR Research Experiment Builder User Manual ©2004-2011 SR Research Ltd. i 6 Designing an Experiment in Experiment Builder ..................................................... 35 6.1 Hierarchical Organization of Experiments ....................................................... 35 6.2 Experiment Graph: Flow Diagram.................................................................... 36 6.2.1 Adding Components to an Experiment ......................................................... 37 6.2.2 Linking Experiment Components ................................................................. 38 6.2.3 Linking Rules ................................................................................................ 38 6.3 Actions .............................................................................................................. 39 6.4 Triggers ............................................................................................................. 40 6.5 Other Node Types ............................................................................................. 41 6.6 Sequence/Sub-graph ......................................................................................... 42 6.7 References and Equations ................................................................................. 43 7 Experiment Graph and Components ......................................................................... 45 7.1 Graph Editing Operations ................................................................................. 45 7.2 Node Connection .............................................................................................. 46 7.2.1 Connection: Create, Cancel, and Delete ....................................................... 46 7.2.2 Connection Order .......................................................................................... 47 7.3 Experiment Node Exporting and Importing ..................................................... 47 7.3.1 Exporting....................................................................................................... 47 7.3.2 Importing....................................................................................................... 49 7.4 Layout of Nodes in Work Space ....................................................................... 50 7.5 Editing Properties of a Node ............................................................................. 51 7.6 Experiment Node .............................................................................................. 52 7.7 Sequence/Subgraph ........................................................................................... 54 7.8 Start Node ......................................................................................................... 58 7.9 Actions .............................................................................................................. 59 7.9.1 Display Screen .............................................................................................. 59 7.9.2 Performing Drift Correction ......................................................................... 63 7.9.3 Performing Camera Setup and Calibration ................................................... 68 7.9.4 Sending EyeLink© Message ......................................................................... 75 7.9.5 Sending EyeLink© Command ...................................................................... 76 7.9.6 Sending TTL Signal ...................................................................................... 79 7.9.7 Adding to Experiment Log ........................................................................... 81 7.9.8 Updating Attribute ........................................................................................ 83 7.9.9 Adding to Accumulator................................................................................. 85 7.9.10 Adding to Result File ................................................................................ 86 7.9.11 Preparing Sequence