Home

SR Research Experiment Builder User Manual

1. nnsessseoeeenssesssseeeeses 183 7 10 12 2 How to align the recordings in the audio file and eye tracker event time 184 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 11 8 9 Pel Other Banding C Ompone is s erene a aa n 186 Fel EN a D E E ac toe ae 186 B2 RESU FE ee a eran merece tren pram inn errerrr ne 189 PEES AAC MAMAN CO eds EE tessa neuen ne ouiua O 191 GAIA Musto Class MaN e nes ess ricetecrsceh taatiadacetiehtesndeieieehats 194 Screen BWC eenen eres goed a tebe suaad eaes goed iasalaacenen otelasanat ates 196 8 1 RESOUN CS scree sctitu tera acannon reuse ct yet rasan wa teense yt escalate ones 197 odb Imaret IRCSOULCS sects tract EE ET 197 Selb Image Displaying Modes ssceicarasaisietesacdainianteleeaenieateunatisieelisks 200 8 1 1 2 Gaze Contingent Window Manipulations essessssoeenesssssssseersssss 201 ek Video RESO OC rr tered unedemdairaistatheies 202 Sl2vb Readino Frame TIMO icion a E aa 207 SA2 Video Frame TMINE ersten a ea herrea tks 207 8 1 2 3 Video Frame Rate and Display Retrace Rate ee cccceeeeeeeees 208 8 124 Dropping Frames seseris eacssenchsttesdesadenalane EE ER 209 SLS TEAC CACM sise a a easaeda erste 209 OZ Va OC OEO a E 210 8 1 2 7 Playing Video Clips with Audio seeneesesssseoennssssssssseerssssssssseerrssssss 211 Sled Texte RESOUTCE ouaaa a aie a See ae eee ant 211 Sek INonsA SCH Chara ters ossia E E E E 213 8 1 3 2 Anti aliasing and Transpa
2. 45 135 90 E 135 180 Region Location regionLocation Point Pixel coordinate of the top left corner of the Top Left boundary region in x y tuple The default value is 0 00 0 00 Note that the x y coordinate of the region location can be further referred as regionLocation x and regionLocation y respectively Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Region Width regionWidth Integer Width 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Height 0 by default of the boundary region in screen pixels Note that this property is only SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 176 available when the Region Type property is set to either RECTANGLE or ELLIPSE Interest Area The display screen on which target interest area Screen regions are located Note that this property is only available when the Region Type property is set to INTEREST AREA Interest Area Target interest areas used to define the Regions triggering region Note that this property is only available when the Region Type property is set to INTEREST AREA Within et oe If checked the trigger fired when the samples are in the target repioi Tracking Eye heel oe Sars Decides which eye s data is use
3. Clipping Area is clippingAreaAtG Boolea Whether the clipping region should be Gaze Contingent azeContingent n contingent on the mouse or gaze position The default setting is False t Play Count playCount Integer Total number of times the video clip will be played when the display screen is shown If 0 the clip will be played continuously looping Frame List frameList List XVID video clips The intended frames of the video clip to be played If set to 1 1 e from the first frame 1 to the last frame 1 the whole clip will be played Since XVID does not support frame seeking the first value must be 1 whereas the end frame can be configured VFW video clips Specifies the frame list frame number and or ranges of frames that should be played for the video Ranges of SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 205 Changes from version 1 1 The End Frame property have been removed and replaced with the Frame List property The name of the video resource file Note that Source File sourceFileName String Name f the video resource must be first loaded into the frames and frame indexes can be in any order For example 1 50 52 100 99 50 50 50 would start to play frames 1 50 skip frame 51 play frames 52 100 then play frames 99 50 e backwards then hold frame 50 for 2 more frames Note that the performance of presenting non sequential frames or pres
4. a GET_RESPONSE xev Figure 7 44 Collecting keyboard response data To evaluate the accuracy of the key press you will need to know what s the expected key press for the trial This can be encoded in the datasource with a string column Use a CONDITIONAL trigger to check whether the pressed key matches the expected key and then use an UPDATE_ATTRIBUTE action at each branch of the trigger to update the accuracy variable accordingly please check out the HTML version of this document for the complete example project SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 141 DISPLAY TARGET Properties _ _ Hx Label HELE RESPONSE __ KEYBOARD k Jode Path RIAL RECORDING CHECK RESPONSE i Message i i Time ast Checked Time CET_LRESPONSE onfidence Interval i K Y a t 7 F attribute Dparent parent TRIAL DataSource expected keyta Comparator UALS CHECK RESPONSE Ae a a zs Nalue TKEY PRESSED valued i T Py T To And Or Select SET CORRECT 2 4 SET_INCORRECT Attribute 2 X Y Comparator 2 i Walue 2 Figure 7 45 Checking keyboard response accuracy If you are evaluating the keypress on some non ASCII characters e g press on the spacebar you may use the returned key code for the trigger against a numeric value of key e g 32 for the spacebar key In the Attribute field of the conditional trigger use a reference to
5. ess Edit Attribute TEXT_RESOURCE gt text Attribute SSS SSS M parent parent parent TRIAL DataSource wordi Mode Selection Node Attributes Attribute Attributes EH Project trial His Simple JF START a BLOCK GE start b Select Word attribute EL_CAMERA_SETUP bel TRIAL BE enti YE START T PREPARE_SEQUENCE DRIFT_CORRECT io RECORDING a Click TRIAL gt Datasource nocle c Click Ok button to finish H Devices oO Cancel Figure 14 14 Referring Text to Be Shown to Data Source 5 Check the Use Runtime Word Segment box This will create interest area automatically for the text used 6 Select the newly added text resource click on both Horizontal Center Alignment and Vertical Center Alignment E buttons to place the text in the center of the screen 7 Select the text resource on the work area click the right mouse button and select the Lock Selection option so that the resource will not be moved accidentally SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 292 14 1 11 Writing Trial ID to EDF file A TRIALID message should be written to the EDF file so that the actual experiment condition under which the trial was conducted can be identified during analysis see Figure 14 15 SA Research fmpertirectd Balter v LALF RE Simple nll Fie Edi view Exper
6. images graph ebd Preferences properties e graph ebd This file contains the experiment graph Double clicking on this file will open the experiment session e Preferences properties This file contains the preference settings for the current experiment session e datasets This is the directory where the data source file is located e library This is the folder where the image audio interest area set and video files are contained e runtime This folder contains all of the runtime image and Data Viewer integration files amage drawing list and interest area set files SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 19 e myfiles This directory and all files and subdirectories within it will not be deleted or cleaned by the build process and therefore can be used as a place to store your own files randomized data sets test EDF files etc Files in this directory will be included in the packed project and copied to the deployed folder Please avoid using non ASCII characters in the project name or directory path as this may cause runtime problems Note If you are running Experiment Builder from a non Administrative account of Windows XP or 2000 you should create the new projects to the user account directory 1 e the project location should be Windows Drive Documents and Settings User Account My Documents In Windows Vista a new project should be created at a directory with u
7. 17 1 38 Record Sound Control See section 7 9 16 Record Sound Control 17 1 39 Terminate Experiment See section 7 9 17 Terminating an Experiment SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 345 17 1 40 Recycle Data Line See section 7 9 18 Recycle Data Line 17 1 41 Execute See section 7 9 19 Execute Action 17 1 42 Null Action See section 7 9 20 Null action 17 1 43 ResponsePixx LED Control See section 7 9 21 ResponsePixx LED Control 17 1 44 Accumulator See section 7 11 3 Accumulator 17 1 45 Result File See section 7 11 2 Result File 17 2Screen 17 2 1 Screen est Preferences D X Elf Preferences Property E Experiment ocation Type opLeft Position BD Devices i nterest4rea Color H Nodes Antialias Drawing E Do e 2 p mr Resources BY IMAGE_RESOURCE EN VIDEO RESOURCE TEXT_RESOURCE Fa MULTILINE_TEXT_RESOURCE N LINE_RESOURCE C RECTANGLE _RESOURCE C ELLIPSE RESOURCE He TRIANGLE RESOURCE D7 FREEFORM_RESOURCE H E Movement Patterns 2 HES Built In Interest 4rea Preference bs Build Deploy Ee GUI of GRAPH_LAYOLIT co CUSTOMCLASS EDITOR Restore Factory Default Save Properties as Default Import From File Save Into File SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 346 Location Type For all resources on the screen builder whether the def
8. Column WORD haximur Run Length 2 Splitting Column OK Cancel Reset Figure 15 8 Datasource Randomization 9 Uncheck the Prompt for Dataset File box so that you will not be asked to select datasource file at the beginning of the experiment 10 Click on the Split by value field Enter a value 9 This makes sure that only 9 trials are run in each block 11 Double click on the TRIAL sequence node in the structure list Click on Start node under it to continue SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 305 i A Research Paperia Baher v LALA RE Streep jajaj A E E E E aaaf EF kes aml e Enter values press Enter key to register the values 11 Click here to start 7 0 ST T man RESIL TS FILE 5 z 11 Click here to continue ato i ee ce eT eer a 2 Set the label as TRIAL 5 Click here to add rows si 4 SAT meea to add colunins 7 a aa splitby to 9 Row ionos Rarccnzatin 4 Click here to start F Enable Run Time Rarekrsizalion 8 Click here for m v y aaa adomization configuration s Freeze 0 Disniay Lint Fir i f Promet tor Daet Fie I T Check this box to perform runtime randomization lt j Uncheck this box Figure 15 9 Creating Data Set 15 7Editing Trial Sequence Setting Initial Values and Preparing Sequence Each trial should begin with a prepare sequence action followed by the actual trial r
9. FAQ The automatic TRIALID creator doesn t work Has the Message field of the triggers and actions been filled Messages will be sent to EDF file to mark important events For example you may write a SYNCTIME message for the DISPLAY_SCREEN action that shows the target screen Has Prebuild to Image button of the screen resources been enabled This ensures image files will be created in the runtime images directory for Data Viewer overlay FAQ How to show the images in Data Viewer FAQ No image is overlaid under the fixations in Data Viewer Has the target screen been transferred to the Host PC as feedback graphics FAQ How can we see the text on the Host PC FAQ Warning 2015 No display screen is selected for PrepareSequence TRIAL gt PREPARE_ SEQUENCE FAQ Tracker screen flashes many times very quickly prior to each trial on the Host PC Has a Recording Status Message been written to the tracker screen to report progress of experiment testing Has a PREPARE_ SEQUENCE action been added before a trial recording SEQUENCE Is this action called before the trial run time for EVERY iteration of the trial recording SEQUENCE Have you prepared interest areas for each of the trials SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 321 FAQ How can I create individual interest areas for every single image in the EB 10 Has an optimal screen refresh rate been used Has a proper v
10. Project Location field please make sure that the intended directory already exists SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 297 4 Make sure that EyeLink Experiment box is unchecked for a non EyeLink experiment 15 2 Configuring Experiment Preference Settings After a new experiment session is created the user needs to check whether the default display and screen peste settings are fine for the experiment to be created A Ig a a 4H f Pretersices l Esonerinent l Click Edit gt r E Preferences i maet T Nen Reins Wideo Frame Cache Sire amp Line Video Dasning Thr Meve 3 Enable Antialias drawing 2 Edit Transparency color 4 Select the experiment node Stroop and enable Save Messages property Figure 15 2 Editing Project Preferences 1 Select Edit gt Preferences from the application menu bar or press shortcut key F4 on Windows On Mac OS X click ExperimentBuilder gt Preferences from the application menu bar or press Command 2 Click on Preferences gt Experiment gt Devices gt Display to check display settings Make sure that the settings Width Height Bits per Pixel and Refresh Rate used in the current example are supported by your video card and monitor To make the text presentation look better the user may enable the anti aliasing function see Anti aliasing and Transparency Set the trans
11. Start Point and End Point attributes and enter the desired positions in tuples 1 e two float numbers separated by a comma The appearance color and width of the line resource can also be modified Field Attribute Type Content Reference Position is Gaze positionAtGaz Contingent T eContingent o A R Position 1s Mouse Contingent T _positionAtMou seContingent Host Outline Color hostOutlineCol or Screen Location Type re a Pattern Prebuild to prebuildToIma Boolean Image t ge SR Research Experiment Builder User Manual Label of the resource LINE_RESOURCE by default The type of screen resource LineResource the current item belongs to Whether the resource should be visible The default setting is True Whether the position of the resource is contingent on the gaze position The default setting 1s False This setting can only be modified when the display screen is contained in a recording sequence Whether the position of the resource is contingent on the mouse position The default setting is False Adjustment of the resource position relative to the position of the current gaze or mouse position The default value is 0 00 0 00 for a perfect alignment of the resource position with the current gaze or mouse position The color of the box drawn on the host screen to show the position and dimension of the current resource This property is available only if the
12. You should respond by pressing b for the blue color If you have finished readimg this instruction press any key to continue Figure 15 7 Create Instruction Screen 15 6 Editing Trial Sequence Data Source Next we will work on the sequence which will contain all of the necessary triggers and actions in each trial We will also need to create a data source to be used for setting parameters in individual trials see Figure 15 8 1 Click on the last SEQUENCE node on the structure list to start 2 In the property table click on the value field of LABEL Set it to TRIAL 3 Click on the Data Source property to bring up Data Source Editor 4 Click on the Add Column button In the following dialog box type COLOR without quotation marks in the Column Name editor box In the Column Type dropdown list select Color and click OK button to finish Click on the Add SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 303 Column button again Create three more new columns Set the Column Names as WORD EXPECTED and COMPATIBLE and set the Column Types as String Important Your experiment may not run if inappropriate column types are used for the datasource 5 Click on the Add Row button Enter 18 in the Number of Rows edit box to generate 18 rows of empty cells 6 Click on the empty cells of the table just generated Add the values to the table as foll
13. aeFomatathoad i sal Fo marmi narm2 F 1oOn 1 1 11 maram i Toa 100 en maram A i CW FO nara Figure 12 5 Custom Class Code Editor Custom Class Editor Toolbar Operation Shortcut Shortcut Function Windows Mac OS SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 275 es Eo Save Code CTRLS S 38S Save the custom class code the custom class code custom class editor hae custom class editor and place it into the clipboard coy RS ee ee clipboard Paste CTRL V tp V Inserts the previously copied item from the clipboard to the current position aston AID MI isha code m l inoanaie code dl Comment Creates comment This will add a Semm comment symbol in front of the current line of code om in the custom class code SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 276 13 Creating Experiments Overview The easiest way to start developing EyeLink experiments is to study the supplied templates included with the Experiment Builder software installed at C Users User Name Documents ExperimentBuilder Examples for Windows Vista or Windows 7 C Documents and Settings User Name My Documents ExperimentBuilder Examples directory for Windows 2000 or XP with user read write permission or Documents ExperimentBuilder Examples on Mac OS X Each of these experiment templates illustrates a typical experimental paradigm The follo
14. o The bidirectional mode must be turned off so that you can do the normal data sending through the data register and data receving through the status register You can disable the birectional mode by toggling off the pin 5 of the control register This can be done by sending a value of 0 to the control register with a SET_TTL action o You are reading the input from the status register the base port address 1 7 10 9 Fixation Trigger The fixation trigger fires when a fixation occurs at a specific region of the display for a certain amount of time Depending on the settings in the event type property this trigger can fire when the fixation starts STARTFIXATION or ends ENDFIXATION or after a pre specified amount of time into a fixation UPDATEFIXATION This trigger 1s only available in an EyeLink experiment Please note that when reading real time data through the link the start of the fixation event data will be delayed by about 35 milliseconds from the corresponding sample This is caused by the velocity detector and event validation processing in the EyeLink tracker The timestamps you got from the event data however reflect the true sample time for the start or end of the event SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 162 Reference ao E Label label String Label of the fixation trigger The default value Type So Co The type of Experiment Builder objects Fixation the current no
15. y Previews Type ot file WAYE PEM SIGM gt Size 9 630 bytes Duration 00 00 00 Channels 1 trong Audio Sample Rate 22 KHz Experiment EyeLink DY variables Figure 7 19 Adding Sound Clips to the Library When running the experiment project on Windows the user can play the sound clips with DirectX driver or with ASIO audio driver chosen from the Devices gt Audio settings see Figure 7 18 The ASIO driver supports predictable and low latency audio playback and recording and therefore is ideal for experiments that require high audio playing precision e g audio visual synchronization or with audio stimulus onset asynchrony manipulation If the user chooses to use the ASIO driver please make sure that a Creative Audigy sound card that supports the ASIO 2 0 specification is installed on the development computer and the deployment computer as well if it is used In the device setting for ASIO driver Figure 7 18 Panel A ASIO Audio driver indicates the name of the ASIO driver Output Interval returns the interval in milliseconds between SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 91 ASIO buffer swaps which determines how often new sounds can be output Minimum Output Latency indicates the minimum output latency of the ASIO driver delay from buffer switch to first sample output When running the experiment project on Mac OS X the audio driver is set to
16. 2004 2011 SR Research Ltd 260 11 EyeLink Data Viewer Integration It s always a good idea to think about data analysis while the experiment is still being designed The designer may take advantage of the messaging functionality of the tracker and Experiment Builder e g using the send message or log experiment action or using the Message property of the triggers and actions to write out messages for critical events in a display for reaction time calculation to send a Trial ID message and so on For some experiments the designer may also try to create interest areas Spending a couple of minutes on these small details may save hours in data analysis later It s always a good idea to test at least one participant after creating the experiment and collect the recording data to examine timing accuracy and to check whether any critical information is missing Record 1 TCP IP Link Open Stop Record ing Drift Corr Duration sec 6 Tracking Binocular 508 Hz Pupil Data to File SIMPLE EDF Samples and Events USING TRACKING USING Link Sanples and Events MOUSE OFF MOUSE SIMULATING HEAD SIMULATING Title Trial 1712 One DISABLEDS FP 66 Figure 11 1 Sending the Recording Status Message to the Tracker In a similar vein the user may also try to send a message to the tracker screen see Figure 11 1 This can be used to show the progress of the experiment so that the experimenter can arrange a break
17. 2004 2011 SR Research Ltd 6 3 Installation Version 1 10 of Experiment Builder runs on both Windows 32 bit and 64 bit of Windows 2000 XP Vista and Windows 7 and Mac OS X Intel CPU OS v10 6 or later The current section covers system requirements for computers used to create and run experiments with Experiment Builder as well as installation and licensing issues 3 1 Windows PC System Requirements The computer recommendations for SR Research Experiment Builder are in a large part dependant on the experimental paradigm being run For example an experiment that simply displays a single screen of text and waits for a manual response can run on a computer with much lower specifications than an experiment where video presentation 1s occurring during the trial It is always suggested to get the best computer you can for running your experiments even if you do not immediately plan on using all the features of the computer however due to monetary considerations this 1s not always possible The following computer specifications are guidelines only SR Research can be contacted for input on what computer specifications would best match your actual experiment designs IMPORTANT Regardless of the computer used and the experimental design it is always critical to spend time evaluating the timing of the experiment designed to ensure that it is operating as expected 3 1 1 Computer Configuration The minimum configuration should be fine for use
18. 9 2 Editing Data Source To create a new data source or to add new columns to an existing data source click on the Add Column button at the bottom of the project window This brings up a dialog asking for the column label see Figure 9 2 cor Add New Column x Column Mare rial Column Type Murnber f Append column at the end Of inzert column to the lett of insert column to the right OR Cancel Figure 9 2 Change the Type of Variables In this dialog fill in the Column Name field The column name must be a string starting with a letter between a and z or A and Z and consisting of alphanumerical characters A Z a z 0 9 or _ any space entered is converted to an underscore The new datasource column name shouldn t duplicate the name of any existing datasource columns variable labels or any of these reserved words EYELINK DISPLAY AUDIO TTL and CEDRUS In the dropdown list of Column Type choose the appropriate data type to be used Select the location where the column should be created at the end of the data source editor to the left of the currently selected column or to the right of the currently selected column and then click OK to finish This will create a new column heading with specified data type listed underneath Following this click on the Add Row button to
19. Camera Rotation High Speed Camera Pan Tilt Adjustment Left Illuminator Position Right Illuminator Position SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 327 Mount Usage mountUsage This option is only available when the Camera Mount is set to Desktop or Arm If Desktop Mount is used possible options are Monocular Stabilized Head Binoc Monoc Stabilized Head or Monocular Remote If Arm Mount is used the user can choose Monocular Stabilized Head or Monocular Remote option Dummy Mode dummyMode If checked the experiment can be run without attempting to connect to the EyeLink tracker This can be used to simulate EyeLink link connection for early development work or when the EyeLink tracker is not available Data Processing Link Filter Level linkFilterLevel Each increase in filter level reduces noise by a factor of 2 to 3 but introduces a sample delay to the link sample feed This setting is only available for EyeLink II and EyeLink 1000 eye trackers File Filter Level fileFilterLevel Selects the file sample filter for data in the EDF file Each increase in filter level reduces noise by a factor of 2 to 3 Note By changing the file sample filter from high to another value this will affect EyeLink Data Viewer and other analysis tool calculations SR Research Ltd recommends leaving this value set to High This setting is only available
20. Confidence confidenceInterv Float Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the trigger could actually occur between the last checked time and the actual firing time Region Type regionType String The type of triggering Region used RECTANGLE 0 ELLIPSE 1 or INTEREST AREA 2 Note that the INTEREST AREA option is only available when interest areas are defined in one of the display screens in the same recording sequence Region regionDirection Listof A range of eye angles from a multiple selection Direction String list 0 45 45 90 90 135 135 180 180 135 135 90 90 45 45 0 used to restrict the direction in which the invisible boundary trigger fires For each angle range the first value is inclusive and the second value is not inclusive 90 45 i 135 90 Ca Region Location Pixel coordinate of the top left corner of the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 117 Top Left boundary region in x y tuple The default value is 0 00 0 00 Note that the x y coordinate of the region location can be further referred as regionLocation x and regionLocation y respectively Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Region Width regionWidth Integer
21. Dewices Labe PAOD ACCUMULATOR label SEND _EL_MSG yeLink Message Co ee S a A A ction Time SSCYSCSSCSC S S Prstan OOOO O ve Link Message saccade data str Accumulator Recording ACCUMULATOR Add Value WSA CADE triggeredDat A B Figure 7 75 Adding Data to and Retrieving Data from the Accumulator This will record a message similar to MSG 3153136 saccade data 8 max 60 0 min 48 0 mean 55 0 in the EDF file 7 11 4 Custom Class Instance The custom class instance creates a new instance of a class The user can select a class defined in the Experiment Builder library to which the current instance should belong from the dropdown list associated with the custom class property Once such a link is established double clicking on the custom class instance in the experiment graph will automatically start a custom class editor for viewing and editing the source code of the custom class Field Attribute Type Content Reference label String Label of the custom class instance By default the label is CUSTOM_1000ASS_INSTANCE Type The type of Experiment Builder objects CustomClassInstance the current node belongs to Node Path absPath The absolute path of the node in the experiment graph Custom Class NR Select a class SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 194 defined in the Experiment Builder library to which the current instance belong
22. Displays the Structure panel Properties Displays the Attributes and Note section of the Properties Panel i Displays the To Connections and From Connections section of the Connections Panel hinineans In Displays the Navigation Nodes in the Graph Editor Window 5 3 4 Experiment Menu and Tool Buttons Commands used to compile and run the experiment clean up the experiment project and to create a deployment version of the experiment are located here see Chapter 4 for details Operation Shortcut Shortcut Function Windows Mac OS X F7 Ctrl Shift C Used to clean up the experiment project ln Build Ctrl Shift B Used to compile the experiment P Test F11 Ctrl Shift R Used to test run the experiment from the Run Experiment Builder application Deploy F12 Ctrl Shift D Used to generate deploy code for running experiment without replying on the Experiment Builder software 5 3 5 Help Menu This menu contains commands that display licensing and product release information see Chapter 3 for details Windows Mac OS X aa Contents Experiment Builder application a S O F information Picts Byenen paer nese Purchase Experiment Builder SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 34 6 Designing an Experiment in Experiment Builder This chapter introduces the general concepts of experiment design in the Experiment Builder hierarchical
23. EL_CAMERA_ SETUP R Type N The type of Experiment Builder objects C EyeLinkCameraSetup the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of aa the Experiment node checked when camera setup action is done Time time Float Display computer time in milliseconds from o the start of the experiment when the camera setup action is done Start Time startTime Float Display computer time in milliseconds from S the start of the experiment when camera setup action started Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action 1s performed meaning that any events already in the queues will be evaluated by Triggers following the action Calibration Type calibrationType String This sets the calibration type One of these q calibration type can be selected from the dropdown list H3 horizontal 3 point calibration HV3 3 point calibration poor linearization HV5 5 point calibrat
24. Once you have found out the parallel port address open the Experiment Builder project go to the TTL Device setting enter the hex value for the TTL port reported by the device manager e g 0x378 for 0378 you see in the device manager The other support device is the USB 1208HS box This can be used on both Windows and Mac OS X A driver installation is required on Windows First connect the box to the Windows PC When asked Can Windows connect to Windows Update to search for software choose No not this time When asked what do you want the Wizard to do choose Install from a list or specific location Advanced On the Please choose your search and installation options screen select the Search for the best driver in these locations check the Include this location in the search option only and browse to C Program Files SR Research 3rdparty usb1208hs or C Program Files x86 SR Research 3rdparty usb1208hs folder Reference IE ee o The type of Experiment Builder objects TTL the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the TTL trigger fires Time time Float Display computer time in milliseconds from the start of the experiment when the trigger fires Note To check the time when the triggering TTL pul
25. Part 1 si ccss esti ccnceieseieclteticaisleaetateecdeneites 310 15 6 1 Creatine the Pix ation S Cree nes ivressasccxacet cessed aa eE n E Eai 312 15 8 2 Creatine the Stroop Display Screenesinicsesesiaisdeticiudeseidaaeathinducereuiaiedebiccen 313 153 9 Editing Trial Event S quence Part 2 cists ssscsiccccedricwasdadasned cteiaetetvaiaadiedaidwnsaces 314 15 10 Outputting Data to the Result File 0 eccccccccceeesseeeeeeeeeeeeeaeeenees 319 15 11 RUMI S The EX Der MC NG acacia a E iidaed dane celal edhe tae 320 16 Experiment Builder Project Check List version 1 10 1 eeeeeeeeeeeeeeeees 321 17 PREC TCM Ce SC MIN OS acs accesses E eaea ae eacaoue cateaehenebeonee 325 A TE RPC THS INE fs ya ceeecnt tscod ete 329 ael Eve Bip lt O se E tr tint r T teern 327 MeeVee DRO a Nelo etc eee en Mie alte eigen elo tec et eo 333 UES AUO reer rear meee mer mir ry cre mrtram nar ren meric one cemnternrer am irene Netenree 335 CA C e A E E neat 336 EES KOy DO Ani tax5 kobprecaiani zh eatnpetesariahahencsena ati hada nnenc aria aeacaeiee ah ieeeane 336 VELO IWUOUS 6 Sasa rect ta eaeonesaeeneoceste be deca awa taxeteaedlabatatezencedsde aunt taunted lahateatezancedeest 338 E7 EyeLmk Button Box De Vice sess otass a deans 340 MY se WAR ANIC WRG a E E thease E E tee hee 340 LS USB OSHS DO eona a nen TE nme nr ea 342 r a O A E E EE E A E E santos A E E E E E 344 EGIL Invisible Boundary esnea dion ttewiaimaidaahmies 344 EI Conditiona sii E 344 TEk E
26. RESULT_FILE node to the graph 6 Click at any blank area in the work window Click the right mouse button and select Arrange Layout in the popup menu This will re arrange the nodes in a hierarchical fashion 7 Click on the SEQUENCE node in the structure list 15 4 Editing Block Sequence Next we will need to edit the properties of the Block Sequence This involves changing the Label of the sequence to make it more meaningful and changing the iteration count to the actual number of blocks to be tested see Figure 15 4 Please note here we do not edit the Split by field Fia Edt View Experiment Help IDBe eBSe S2SKRART EB CTAUS enor Alex laaa BBE AX Experiment START RESULTS_FILE 3 Double click on the Sequence to continue 1 Edit the label as BLOCK Press the Enter key Feal The eration Coun z 2 Set Iteration count to 2 a EEE rie Disper Uhi Fo fe ee y e m e Figure 15 4 Editing Block Sequence 1 Click on the value field of the Label property of the Sequence created Write BLOCK in the text editor and press the ENTER key to finish SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 300 2 Click on the Iteration Count value field and enter 2 as the total number of sequence loops 3 In the experiment Work Space double click on the Sequence object to continue In each
27. Record Status Message property 3 In the attribute editor enter an equation as Trial str QTRIAL DataSource Trial 712 str TRIAL DataSource Word 4 Click on the OK button to finish MESA Reseeenh Caperio Bialhter v LALI RE Simple O calf Fis Edt View Experiment Help DEAS Sxk RGQQT EW AUS eR gt 42i e gt QQQAHBAB XJ Expenmert BLOCH DEPLAY SCREEN TRIAL TRIAL DataSource RECORON peaLav sereen lle ra amt l O barr o grog m Irisi e ee TRIAL Deis Souece bis A E eee TRIAL DesteSource word 4 Create recording status message ria meai D EH Sipa l p I START 2 Click right end L 3 inek ______of this value field stam aaan Court i i Eepe aG sray SOEN stn t fy REV BOsRD ele Sarte Tokena DIR E PREPARE SEQUENCE EJ ORIFT_CORRECT p 1 Select this node E 5 CAMERA SETUP a TRIAL e ip START 1 PREPARE SBa Hilpert correct l l H RECORDING 5 Click here to finish CDren Beannan Cameanents Devore Sree W BLOCK gt _ Figure 14 16 Creating Trial Recording Status Message Derav SCREEN 3 Go to Datasource _ bimet Area j Movement _Patterna A TEXT RESOURCE te ate EL_BUTTON HO SPAY PLAK 14 2 Building the Experiment Now your first experiment is created If you haven t saved your experiment project yet cl
28. SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 222 by default This setting can only be modified when the display screen is contained in a recording sequence _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent n contingent on the mouse position This is False Contingent T by default Offset offset Point Adjustment of the resource position relative to the position of the current gaze or mouse position The default offset is 0 00 0 00 Host Outline Color The color of the box drawn on the host screen to Color f hostOutlineColor show the position and dimension of the current resource This property is available only if the Use for Host Display option of the containing display screen action is enabled Screen Location NR Whether the location specified below refers to Type the top left corner or center of the resource This setting can be changed at Screen Preferences Position 1s Location location Point The coordinate of the top left corner or center of the resource Width Width of the resource in pixels Height Height of the resource in pixels Movement NR Movement pattern sinusoidal or custom of the Pattern resource Prebuild to _prebuildToImage Boolea Whether the resource should be built into an Image n image when the experiment is built instead of having it created during the actual execution of the trial This field is
29. SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 317 a Click on the UPDATE ATTRIBUTE action and rename it as INCORRECT_RESPONSE Set the Attribute field to parent parent RESPONSE value and Value Field to Incorrect b Click on the PLAY SOUND action and rename it as INCORRECT_SOUND Select Inorrect wav from the dropdown list of the Sound File property 8 Add a timer and rename its label as TIMER SOUND Set the timer duration as 500 msec so that the feedback sound can be played complete before the trial ends 9 From the Action tab of the component toolbox add an ADD_TO_RESULTS_FILE action Set the Result File to RESULT_FILE iL enacts 1 X P RESPONSE Xe CORRECT_RESPONSE Xe INCORRECT_RESPONSE DISPLAY_ON_TIME KEY_RESPONSE_TIME xeY UPDATE_ATTRIBUTE CORRECT_SOUND TIMER _SOUND INCORRECT_SOUND KEYBOARD Experiment Components Dewices ee Property Oe Value AddToResutsFile F o m KTRIAL TRISL EWE tart Time Clear Input Queues aen FSET RESULTS_FILE Figure 15 22 Send Results to a Result File Make the following connections to the experiment graph a from the DISPLAY_BLANK to UPDATE_ATTRIBUTE action b from the UPDATE_ATTRIBUTE to the CONDITIONAL trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 318 c from the left branch of the CONDITI
30. Save Messages attribute of the Experiment node checked when the trigger fires Time time Float Time when the trigger fires Note To check the time when the input voice level exceeds the threshold you should use triggeredData time 1 e the time sub attribute of the triggeredData attribute instead Last Check lastCheckTime Experiment Builder checks for the status of the Time trigger about every 1 msec This property can be used to retrieve the Display computer time in milliseconds from the start of the experiment when the trigger was checked for the last time Confidence confidenceInterv Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 182 NO no event clearing Event removes the current triggering event from the voicekey event queue LIST all voicekey events from event queue will be removed Threshold threshold Float Value from 0 0 to 1 0 to set voicekey trigger Clear Input clearInputQueue Boolea ASIO Voicekey trigger maintains an event Queue n queue so that multiple voicekey events can be accessed over time The current option checks whether the voicekey event s cached in event queue should be cleared when the trigger fires
31. Use for Host Display option of the containing display screen action is enabled Whether the location specified below refers to the top left corner or center of the resource This setting can be changed at Screen Preferences The coordinate of the top left corner or center of the resource Intended width in pixels of the resource Intended height in pixels of the resource Movement pattern sinusoidal or custom of the resource Whether the resource should be built into an image when the experiment is built instead of having it created during runtime This field is always true when the screen is contained in a 2004 2011 SR Research Ltd 218 Use Software useSoftwareSu Boolean If false unchecked memory on the video card Surface T is used to hold the resource blitting from the video card memory to the display surface is fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface Color color Color Color in which the line is drawn The default color is medium gray 128 128 128 Stroke Width strokeWidth Specifies the width 1 pixel by default of the pen Start Point startPoint x y coordinate of the starting point of the line End Point x y coordinate of the ending point of the line 8 1 6 Rectangle Resource Rectangle resource creates a filled or framed rectangle on the screen Click on the Draw recording s
32. the current node belongs to experiment graph Message message Message to be sent to EDF file in an EyeLink P experiment or messages txt in a non EyeLink SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 59 experiment with Save Messages attribute of the Experiment node checked when display screen action is processed Time time Float Display computer time in milliseconds from the start of the experiment for the start of the retrace that the screen was actually drawn redrawn Important This is the field you should use to check for the time when the display is actually shown Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the display_screen action is entered so that the screen can be prepared and shown Note the display screen is not shown yet by this time Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action 1s performed meaning that any events already in the queues will be evaluated by Triggers following the action Actual time in msec used to prepar
33. Control Control n accepting calibration validation and drift correction target are usually done through key presses on the display or Host PC keyboard However keyboard may not be easily accessible in some experiments Enabling this option allows to use an external control device to assist the pupi CR thresholding and calibration process External externalControl String This specifies a file used to define button Control Device DeviceConfig functions to accept the drift correction Config target If this field is left blank the default configuration is used This property is only available if the Enable External Control option is checked External externalControl String The type of external device that is used to Control Device Device accept drift correction target This can be CEDRUS Lumina fMRI Response Pad or RB Series response pad from Cedrus KEYBOARD computer keyboard or keypad or CUSTOM a user control device interfaced through a callback function defined in the custom class code This property is only available if the Enable External Control option is checked Button State For an experiment project with custom class Callback enabled a method defined in the custom Function class can be run to check the button status SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 73 of an external control device and thus to control the camera image thresholding and cali
34. DV Variables property of the experiment node When the user clicks on the experiment node an EyeLink Trial ID dialog box will be shown see Figure 11 2 The Available Variables panel on the left lists all possible column labels in the data source and all newly created variables The user can use the Add button b and Remove button 4 to select variables to be written to the trial ID message The Move Up and Move Down buttons can be used to configure the order of the variables to be output If the Selected Variables panel is not empty a V TRIAL_VAR message will be written to EDF data file for each of the condition variables and its corresponding value for each trial f Select ariables for Output Available variables Selected variables Display z hove up Ado p q Remove ws Move gown OR Cancel Figure 11 2 Editing Trial ID Message 11 2Recording Status During recording a text message can be displayed at the bottom of the tracker screen so that the experimenter is informed of the progress of the experiment To send such a SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 262 message click on the recording sequence Make sure that the Record property of the sequence is checked Click on the right end of the val
35. Feb e SK BEBBORETEER CTAB Jabea Q2RaAHE EAE AX bpecmert uoc nera serem Teac maL aSorce RECORDIO maai TRIAL Det ODIs OO ley TETI g3 i TRAL iF crant T PREPARE SBOUPNCE DF T_coRRECT START p EPLAY SCREEN Aep 7 Click this button 3 to make e e pe the property panel floating _DISPLAY_SCREEN 3 Add a Display screen action T 1 Edit label S i i THER ww ELBUTTON i i rai w ri kt fim 4 Add a timer trigger ee 5 Add an EyeLink button tigger record UW ay fec cording Pause Time Bo Evel nh Record Salua gt 2 Enable both settings EF frai Resni D ail l DISPLAY ALANI bs Beni Time F T 6 Add a display screen for end of trial display clearing heratior Couri 1 tpi bry i penas pras ure Comms O Rowe Fi iaga Combes Unh Fa F Figure 14 11 Editing Recording Sequence 1 Select the newly added Sequence node Rename the label as RECORDING 2 Make sure that the Record and Is Real time checkboxes are checked Double click on the RECORDING node in the structure list until seeing a START node under it As we double click on the START node the content of the work area window is also updated 3 Click on the Action Tab of the component toolbox select the display screen action hold down the left mouse button and drag the action into th
36. Figure 12 3 Assigning Attribute Values through Custom Class Instance The user can call a class method through the Execute action or the Callback property of a Sequence Values can be passed from the Experiment Builder GUI to the custom class through the argument list of a class method see the figure below eof Edit Attribute EXECUTE gt executeMethod Attribute a a peoe Click here to start a a Se Execute Method CUSTOM_CLASS_INSTANCEm a parama a a Result Data Type CUSTOM CLASS INSTANCE myMethodda cNlode Attributes 1r Attribute Thy Method 3 Select a class Method 4 Pass parameters to the method Figure 12 4 Data Exchange through Execute Action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 274 In addition a value can be returned from the custom class to the Experiment GUI through the return value of a class method Please note that the return type of a method 1s string by default unless a doc string is used to specify the data type of the return value 12 6 Using Custom Class Editor To edit the content of a custom class users may use the simple text editor in the custom class tab of the library manager Alternatively users can edit the custom class code directly by double clicking on a custom class instance and opening a custom class editor tab The custom class editor provides much more functionality than the simple te
37. Lock the resource Text g FLA nf SORE L E iaire mi White i KEY BOMRD a EL_BUTTON G THER poai 19 719 8 _canena_setue i jia TRUA if start PREPARE _SEOUENCE 4 ORFT_CORRECT lt gt RECORDING hiore ebuid To image f r jee Soia Surface 2 Set text font 3 Set font size Horgontal Ahgnment t ay EL Burton eat parent pmet pre DEALAY PLANK 4 Set text reference BS Check this box i ine Purine Vi Sagen a FF Figure 14 13 Adding Text to Display Screen 1 Click on the Insert Text Resource button 4 on the Screen Builder tool bar and click at any position in the work area SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 291 2 Double click on the current value of Font Name New Times Roman This will bring up a dropdown list Set the new font name as Arial 3 Double click on the current value of Font Size 20 Enter the desired text size 40 in the text editor 4 Double click on the far right end of the value field of the Text property This will bring up an attribute editor dialog see Figure 14 14 a Click on DataSource node under TRIAL sequence on the node selection list b Double click on the word node in the node attributes window This will update the contents of Attribute editor dialog as parent parent parent TRIAL_DataSource Word c Click on the OK button to finish
38. Manager from the application menu bar tabulates the source parent of source property and value for each reference The value of the reference can be modified with the help of attribute editor The Reference Manager can be used to search for replace any reference entries that contain one particular string To search for a string enter the text e g case sensitive in the Text to Find edit box and press the ENTER key Items that meet the search criterion will be displayed in the list The user can adjust the search scope by selecting the appropriate sequences from the dropdown list To replace a string enter the text to be replaced in the Text to Find edit box and the text to replace in the Replace With edit box Place the text insertion caret the blinking vertical bar in the Replace With edit box and press ENTER key to perform replacement Press Undo Replacement button 2 to revert to the old references SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 259 ee 3 SR Research Experiment Builder 1 3 0 42 RC Simple D Undo pn Gop ya Faste j Faste Multiple TRIAL RECORDING EveLink Record Status M amp Trial str TRIAL_D _ DISPLAY SCREEN TEXT RESOURCE Tet parent parent parent T Saccade Sensitivity NORMAL a Fetes O pye Tracking San 000 Di imil ive RFEA ye Event Data ZE a Figure 10 3 Using the Reference Manager SR Research Experiment Builder User Manual
39. No parallel port card detected by the tracker error message will be displayed Model model Different models 5 button handheld 4 button dual handheld and 5 button desktop can be set if a ResponsePixx Button Box is used 17 1 8 Parallel Port SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 340 8 Preferences a x E pf Preference e SSS r Experiment Number Of Parallel Ports 1 Ee Devices Eis Esnean Teao TERE Parallel Port One Label PARALLELPORT_1 i a anej Parallel Port One Base Address bem OoOO a AUDIO A a E Ea AEE a oe Parallel Port One Base Input Queu 50 KEYBOARD Parallel Port One Status Input Que J50 H CEDRUS Parallel Port One Control Input Qu Do Bs BUTTONBOX US68 1208HS H J Nodes Screen H Build Deploy GUI h GRAPH LAYOUT i CUSTOMCLASS EDITOR Save Properties as Default Number of Parallel Ports numberOfParallelPorts This sets how many distinct parallel ports used in the experiment Parallel Port One Label Parallel Port Two Label portOneLabel portTwoLabel This supplies a lanel for the first second parallel port device used in the experiment Parellel Port One Base Address Parellel Port Two Base Address portOnebaseAddress portTwobaseAddress The address of data port or data register for outputting data on the first second parallel port s data lines LPT1 is n
40. OS X Similar to the ASIO driver it schedules audio events ahead of time to achieve a precise playing time All audio clips scheduled with a TIMER trigger with a duration longer than the minimum Scheduling Latency which is about 40 ms or played through Synchronize Audio option of a DISPLAY_SCREEN action will be played at the intended scheduled time FH Y Devices FH Y Devices EYELINK EYELINK DISPLAY DISPLAY AUDIO AUDIO TTL TTL CEDRUS CEDRUS Experiment Components Dewices Experiment Components Qeyices Sudio Driver ASIC sudio Driver Directs z Output Interval ASIO Audio Driver vlinimur Output Laten A B Figure 7 20 Choose Audio driver The following table lists the properties of a PLAY_SOUND action Field Attribute Type Content Pee e a Label label String Label of the PLAY_SOUND Action The default S The type of Experiment Builder objects PlaySound the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the PLAY SOUND action is executed Display computer time in milliseconds from the start of the experiment when the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 92 po PLAY_SOUND action is done Start Time StartTime Float Display comp
41. Sinji i a 1 x BeBBe PKB SRT HD AZBaOCeBli m reAl nr BAB EE PELE i stare yH JOSLA SEN H E FiF EF Zh ee a ee a m a a e A i Fog Te i a enstion Coed ia q Date Sora 0 Domni i Rice Gl L reaps Diapiey UMI Fb E Proma itr paisg Fie 3 f Mbac angie BLOCK Check to enable run time randomizer nhs Figure 9 9 Using Internal Randomization 9 6 1 1 Randomization Seed If set to Current Time the current Display computer time in milliseconds from the start of the experiment is used as the randomization seed If set to Session Label the string you input in the Session Name dialog box when running the experiment is used as the randomization seed Any two runs of randomization with the same seed will generate identical randomization outputs Seed value Current Tite Session Label SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 250 9 6 1 2 Blocking The randomizer supports blocking by up to two variables You may leave Block Level 1 and Block Level 2 fields empty if a blocking manipulation is not required in your experiment design If blocking is used all trials with the same value of the blocking variable will appear in a group The order of the blocking groups 1 e different values of the blocking variable to appear in the randomization output can be controlled with one of the two following metho
42. although the latest version 4 56 is recommended https www sr support com forums showthread php t 179 e If EyeLink Data Viewer is used for data analysis you should get the most recent version version 1 10 or higher of the software https www sr support com forums showthread php t 10 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 15 3 3 2 HASP Driver Installation and Licensing The user can run the Experiment Builder application in a demo mode immediately for 30 days from the first installation of the software on the computer All of the functionality of the licensed copy of Experiment Builder is available in the demo mode except that Experiments created with a demo version of the software will not re open using a fully licensed version of the software An UNLICENSED DEMO VERSION text will be drawn on every display screen in an experiment that is created with the demo version of the software To run Experiment Builder in a fully licensed mode the user needs to purchase a license code for the software and have a USB dongle connected to the computer on which the Experiment Builder software is installed The physical USB dongle is the same one we use to license the EyeLink Data Viewer If this is the first time that the USB dongle have been used on your Mac OS X you will need to install the driver for the HASP key The driver installer can be found in the Hasp folder after unpacking the ExperimentBuilder
43. and playStartTime attributes when returns a value greater than 0 Gets the maximum number of samples the audio Samples es buffer allocated can hold Retrieves the actual sample count stored in buffer data nant Rate ee ROE Retrieves the sample rate in samples per second of the buffer All of the audio buffers have a sample rate of either 48 000 or 24 000 samples per second chosen to be compatible with most ASIO drivers When a WAV file is loaded that has a different sample rate it is converted to one of these sample rates using sophisticated digital signal processing algorithms which do not degrade sound quality Current oe i Gets the current play position time in oe oe Toe from the start of the clip playing Current Sample Gets the current sample being played When you run a project using the ASIO driver on Windows a Creative ASIO Control Panel dialog box will show up This latency sets the minimum output latency of the ASIO driver delay from buffer switch to first sample output and the interval in milliseconds between ASIO buffer swaps 1 e how often new sounds can be output For better ASIO playing recording performance set the ASIO buffer latency to 10 ms the default 1s 50 ms SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 94 Creative ASIO Control Pan ser ASIO Buffer Latency 10 z mz Cancel CESA Figure 7 21 Setting ASIO Buffer Latenc
44. attach an audio clip to that PLAY_SOUND action for sake of synchronization If you want the audio clip to be presented at the same time as the onset of the display you may set the Offset value to 0 If a positive offset value is used the audio is played later whereas a negative offset value means the audio clip plays earlier This option is only available if you use the ASIO driver You may check out one example in the CHM version of this document section Installation gt System Requirements gt ASIO Sound Card Installation gt Related gt Using ASIO Driver The following figure illustrates the use of the PLAY_SOUND action to provide feedback to participant s performance if the participant presses the correct button one sound is played if the participant presses the wrong button another sound is played For each PLAY_SOUND action the user needs to specify the desired sound clip to be played from the sound library SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 96 Playsourned Mi START h SEQUENCE ae BUTTON_CORRECT ay BUTTON INCORRECT J SOUND INCORRECT TIMER Properties Property abel yp essage irre art Time lear Input Gueues udio Device ound File Ole Playing SR Research Experiment Builder User Manual Structure Playsound ise START ie SEQUENCE aa BUTTON _CORRECT aa BUTTON_INCORRECT J SOUND_CORRECT Experi men
45. eight ovement Pattern ont Color ont Size OA nderline Do tis Tet fre SP Use Runtime Word Segmen Tors A value XT RESOURCE Property m abel isible ost Outline Color ocation eight ovement Pattern one m Position i Gare conting Position is Mouse Contin Screen Location Type Prebuild To Image ont Color fort Size AO aparent parent parent TRIAL Use Ri parent parent parent TRIGL DataSource Word B Figure 6 5 Using a Reference to Update Text to Be Displayed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 44 7 Experiment Graph and Components The Component toolbox in the Graph Editor Window contains the basic building blocks for creating experiments To create an experiment the user needs to add necessary components into different sequences of the experiment and make connections between those components Following this the properties of the individual components should be reviewed and modified as necessary The current chapter reviews the usage and properties of the individual components in the toolbox 7 1 Graph Editing Operations The Experiment Builder is an interactive tool allowing the user to create a new experiment graph from scratch and to modify an existing graph With the graph editor window the user is able to add remove new experiment Builder component nodes to add remove the connection between nodes to modify the attr
46. error dialog box will be displayed if wrong type of data is entered in the attribute editor 2 One attribute cannot refer to itself In the above example Y g cannot have reference to Y g A Recursive Invalid reference error message will be reported during build time 3 Type conversion is only partially supported Integer can be assigned to a number floats or non floats and vise versa However assigning numbers directly to a string 1s not supported and vice versa 10 4 Entering in Equations Equations are a combination of values and or references Equations can be used to calculate data at runtime based on static or dynamic values or both All equations start with a sign followed by references and or values that are concatenated with operators While all of these operators support numerical operations the only operator that supports string concatenation is the sign Functions like str int and float can be used to do data type conversion Note Actually any valid Python equation is a valid equation in the Experiment Builder For details on Python the run time programming environment used by the Experiment Builder visit http www python org Although equations will be evaluated during build time to check for obvious problems the user should always check for the completeness and validity of the equations herself himself In particular the user should make sure that the type o
47. hello and then clear it Please note that the conditional triggers can connect to a maximum of two actions or triggers forming two branches To make the conditional trigger valid the user should attach triggers or actions to at least one of branches If the firing of the conditional trigger exits the current sequence the user may attach some other node e g a NULL_ACTION node blank display screen action or a timer trigger etc following this trigger As an exception to the general linking rules 8 Section 6 2 3 Linking Rules the user is allowed to connect from a conditional trigger to an action and a trigger at the same time It is possible to use multiple chained conditional triggers to do a series of evaluations The following picture illustrates giving out a different instruction at the beginning of each block in a multi block experiment Properties xi Property vawe f abel CHECK SECOND BLOCK Conditional Properties x Property abel HECK FIRST BLOCK CHECK_FIRST_BLOCI vpe Conditional Jade Path ELOCK CHECK_FIRST i essage Mode Path BLOCK HECK SECON essage ime st Checked Time X i ast Checked Time ast Checked Time Confidence Interval i onfidence Interval attribute if parent iteration ompar ator QUALS alue f And Or Select Sttribute 2 omparatoar 2 alue 2 Figure 7 34 Displaying different instruction screens at the beginning of each block Important I
48. i i UX E gf Preferences Property Experiment Tracker Address 100 1 1 1 a 2 BO Devices Tracker version velink II E DISPLAY soit AUDIO 5 OLEE Link Filter Level ORMAL es fy KEYBOARD ile Filter Level IGH 5 T TTL ye Event Data AZE 2H CEDRUS E accade Sensitivity NORMAL ae BUTTONBOX i HES Nodes ye Tracking Mode UPIL ONLY BI Screen ve Tracking High Speed I i me Build Deploy yes To Track BOTH cr GUI punt size REA zi Restore Factory Default Save Properties as Default Import From File Save Into File Tracker Address trackerAddress The IP address of the Host PC This must be the same as the host_address setting in the eyenet ini file on the Host PC typically under c eyelink2 exe directory for an EyeLink II tracker c EyeLink exe directory for an EyeLink I tracker and c elcl exe directory for an EyeLink 1000 eye tracker Tracker Version trackerVersion The version of EyeLink eye tracker EyeLink I EyeLink II or EyeLink 1000 previously EyeLink CL Camera Mount mount The mount type Tower Desktop or Arm of the EyeLink 1000 eyetracker Desktop Version desktopVersion The version of EyeLink 1000 desktop mount Illuminator on Left vs Illuminator on Right This option is only available if the Camera Mount type is set to Desktop This option requires version 4 20 or later of EyeLink 1000 host software running IR illuminator Camera Angle Adjustment 7 Binocular
49. 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 4 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 5 Test license status e Please make sure that the server and client 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 Note If you are using Experiment Builder for developing EyeLink experiments test running experiments must be done using a secondary network card unless the EyeLink Host PC also stays on the same network as the other computers 3 2 3 HA
50. installer program Double click on Sentinel_HASP_RTE_Installer dmg file and then run the Install HASP SRM Runtime Environment application with default settings If the driver installation is successful and the USB dongle is attached to the Display computer the dongle will glow If your license key is not licensed for the Experiment Builder software you will need to contact sales sr research com to purchase a license for the software If your license key is already licensed for the Windows version of the software you may update the license for the Mac version remotely by following the steps below please contact support sr research com if you have trouble in updating the key e Make sure you have internet connection on your Mac e Start the LicenseManager application which is located at Applications ExperimentBuilder e From the File menu at the top left corner of the desktop click Update License In the following dialog box fill up the form make sure all fields are filled and click OK If the license update is successful it will display Success ExperimentBuilder Mac text at the bottom of the dialog box Click Cancel to quit the application SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 16 Get ExperimentBuilder License Mac OS X First Name Last Name Institute Department Email Phone Figure 3 5 Updating Experiment Builder License on Mac OS X SR Research Experiment Bui
51. it might help if you can follow the Chapter 14 Creating EyeLink Experiments The First Example to re create the SIMPLE example by yourself and get a sense of the life cycle of experiment generation and data collection with Experiment Builder software This section can be used as a Getting Started guide You should also read the following sections of the document very carefully as they discuss the basic concepts of Experiment Builder software Chapter 2 Experiment Builder Life Cycle Chapter 6 Designing an Experiment in Experiment Builder Chapter 9 Data Source and Chapter 10 References Following this you can then take a look at other examples we provided see the html version of this document for detailed explanations on the examples and start reading other sections Chapter 16 Experiment Builder Project Checklist may be used to make sure that common problems can be avoided when creating your experiments Please use the following to cite the Experiment Builder software in your manuscript SR Research Experiment Builder 1 10 165 Computer software 2011 Mississauga Ontario Canada SR Research Ltd SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 3 2 Experiment Builder Experiment Life Cycle To create an experiment with the Experiment Builder the user needs to go through the following steps Experiment Design Building and Test running Experiment Deploying Experiment Participant Data Set
52. the Experiment node checked when the RESET_NODE action is done Time time Float Display computer time in milliseconds from the start of the experiment when this action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Reset Node 4 NR fs The node whose data will be reset 7 9 13 Playing Sound SR Research Experiment Builder Oh loading of WAV audio files and playing the 4 clips with the PLAY_SOUND action h Before using the PLAY_SOUND action make sure that target sound files are loaded into the experiment library manager This can be done by clicking Edit Library Manager from the application menu bar see Figure 7 17 A dialog box will show up to let the user load in image sound resources or interest area set files Select the Sound tab and click Add button to load in the target soun
53. 23 Using Play Sound Control Action 7 9 15 Record Sound For experiments where verbal responses are required the SR Research Experiment Builder supports both recording of audio to a WAV file and an integrated voicekey trigger The recommended experimental procedure would be to record a WAV file for each trial using some numbering system and to use the voicekey to detect the response Recorded data is always written to an audio buffer first and can later be copied to a WAV file It is possible to record many short recording segments to one large file relying on the messages placed in the EDF file to determine the start and end of each recording However this may require a lot of memory and take longer to save the file The Record_sound action Aa supports recording of audio to a WAV file using the ASIO driver on a PC and therefore this action is only supported when an ASIO SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 100 compatible sound card is installed on the display computer and the Audio Device is set to ASIO or running the experiment on Mac OS X A message placed in the EDF file will mark the exact time and position in the WAV file of the first recorded sample for analysis The resulting wav files are saved in results session name directory The following table lists the properties of aRECORD_SOUND action Field Attribute Type Content Reference Label of the Record Sound action The default
54. 2Creating a New Custom Class To create a new custom class click Edit gt Library Manager Select the Custom Class tab and click on the New button In the following File Name dialog box enter the intended custom class file name You may also create a new custom class by loading a python file py This can be done by clicking the Add button ess Library Manager 2 l x mage Sound lnterest4rea Set Video Custom Class Movernert Pattern Creating a new custom class ____ ew Save Code Delete Renae class CustomClassTemplate sreb EBOHJect Bee Anit deeb sreb EBObJect init self self propertyl l property of Integer type This is also a read wr self property2 1 2 read only point property Note the setter missini self propertys 1 2 3 read only color property Mote the setter missing self property4 1 0 read and write property of double type alsa win Sselt propertys sreh EBPoint l00 200 read Write point property Note the writeableness self propertyo sreb EBColor 200 100 100 read write color property Nol except the writeableness self property 1 abc self propertyo read write eblist property self property hello read write string property self myInternalattribute My Internal Attribute string property howe Property propertyl i Figure 12 1 Creating a New Custom Class SR Research Experiment Builder User Manual 2004 2011 SR Research Lt
55. 4 From the menu the users can also zoom in or out the current graph or to make the current graph fit the screen The following table lists of the options available from the popup menu QO Zoom Make a selection of components in one region and use this operation to zoom in the selected items for details Zoom in towards the center of the work space so that details of a selected portion of area can be viewed Zoom out the graph so that more items can be displayed in work Space Rearrange the size of the graph so that the whole graph fits the size of the Work Space Layout Click to bring up a configuration dialog box so that the layout of Option components in a graph can be configured Arrange Rearrange the layout of components in the graph in a hierarchical Layout manner Note To perform the operations listed in the table the user should first click on a blank area in the work space click the right mouse button to bring up the menu and then make a selection of the operation to be performed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 50 Ghee Cut Us Co py fey Faste fy Paste Multipl Ue Paste Multiple Bee eye fi Gelete G soom selected ce zoom In m oom ue hf Fit Content Layout Options Arrange Layout i Export Mode ES Import Mode Figure 7 6 Choosing Layout of Components in Work Space 7 5 Editing Properties of a Node After a component is added into the workspac
56. 4 Data Exchange through Execute Action cccccccsssseseeeceeeceeeeeeeseeeeeees 274 Pisure 1 225 5C us tomy lass C Ode Edo eera a a N Mesttosmaenckes 219 Figure 14 1 Creating a New Experiment Builder Session cccceeeeeeeeeeeeeeeees 278 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd xX Figure 14 2 Figure 14 3 Figure 14 4 Figure 14 5 Figure 14 6 Figure 14 7 Figure 14 8 Figure 14 9 Figure 14 10 Figure 14 11 Figure 14 12 Figure 14 13 Figure 14 14 Figure 14 15 Figure 14 16 Figure 14 17 Figure 14 18 Figure 15 1 Figure 15 2 Figure 15 3 Figure 15 4 Figure 15 5 Figure 15 6 Figure 15 7 Figure 15 8 Figure 15 9 Figure 15 10 Figure 15 11 Figure 15 12 Figure 15 13 Figure 15 14 Figure 15 15 Figure 15 16 Figure 15 17 Figure 15 18 Figure 15 19 Figure 15 20 Figure 15 21 Figure 15 22 Figure 15 23 Figure 17 1 SR Research Conisurins Preference Sein SS isen E iieree 280 Setting the Tracker Version for the Experiment cccccccessseeeseeeeeees 281 Creating Experiment Block Sequence ccccccssseeseeeeeceeeeeeeeeeeeeeeeeeaas 282 GCS Block Seguente rrean a daututinaniadeaennaaee 283 Adding Instruction to Block Sequence nnsssseooeeesssssssseeersssssssseeerrssss 284 Adding Multiline Text Resource onto a Display Screen c 0008 285 Create INST lO SChECN ie n E E r 286 Creatie Dalt SU ina E E EN 287 Edit
57. 4 E DIsPLay AUDIO B MOUSE B MOUSE 4 fi KEYBOARD faq KEYBOARD Ty TTL Ty TTL CEDRUS CEDRUS F e90 BUTTONBOX sna DI ITTAROAY Nodes EHE9 Action E DISPLAY_SCREEN C DRIFT_CORRECT EL_CAMERA_SETUP ADD_TO_LOG Ei SEND_EL_MSG A EL_COMMAND 4udio Driver Output Interval 4510 Audio Driver Minimum Output Latency i 4DD_ ACCUMULATOR oicekey Queue Size 0 2 i voicekey Event Count Restore Factory Default Save Properties as Default Import From File Save Into File oiceKey Threshold 5 fd b Navigator change Figure 17 1 Accessing the Experiment Builder Preference Settings 17 1 Experiment This section lists preference settings that are related to the Experiment Builder devices and nodes actions triggers etc SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 325 eo Preferences Fl ef Preferences zue PHS Devices HEP EVELINK E DISPLAY B AE A KEYBOARD Tr TTL I CEDRUS e e BUTTONBOX EHB Nodes H Screen 2 sis Build Deploy a GUI Restore Factory Default Save Properties as Default Import From File Save Into File EyeLink Experiment If checked the experiment projects can be run together with an EyeLink tracker All eye movement related triggers saccade fixation velocity and boundary triggers and actions sending EyeL
58. Boolea n SR Research Experiment Builder User Manual Screen Builder toolbar is on several vertical lines will be drawn to divide the screen into the specified number 3 by default of columns If checked this will force a full redraw of the whole screen at every retrace The possible values are true and false default value Time in milliseconds required to prepare for the display screen This is typically set to the value of Default Estimated Prepare Time The preparation time is influenced by screen resolution computer video hardware and whether the screen resources have been preloaded or not Default time in milliseconds set for display screen preparation Typically this is set to 1 5 times of a display refresh cycle Note that the Estimated Prepare time is useful only when a timer trigger is used before a display screen This allows the timer to pre release for the preparation of the following display screen action If true default the display screen will be updated automatically without re entering the display screen action again This applies to anything that modifies the currently visible screen e g 1f there are mouse or gaze contingent resources on the screen resources have movement patterns or resources visibility position is modified by update_Attribute action or custom code etc If false the screen is only ever updated when the display Screen action is re entered so no auto updating of
59. Builder has no intrinsic data type As a result the user can flexibly change the type of the variable by setting an initial value to the Value field the default data type for a new variable is String For example see Figure 7 42 if the user enters 0 in the Value field the Type is automatically reset to Integer If 0 0 is entered instead the Type is set to Double When referring the variable to an attribute of a node in the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 188 graph the user should make sure that the type of the variable matches the data type of the intended attribute YariableTypes YariableTypes VariableTypes YE START LF start 3iF START 1 VARIABLE STRING YVARISBLE_ STRING 1 YARISBLE STRING 1 VARIABLE INTEGER q VARIABLE INTEGER VY ARISBLE_ INTEGER VARIABLE_POINT VARIABLE POINT MY ARIABLE_FLOAT Experiment Components Devices Properties _ H x Experiment Components Devices Properties A x Properties Al X Property Property Value Label ARIABLE STRING abel ARIABLE INTEGER YHE variable Ype variable Experiment Components Dewices abel Ype arable Mode Path VARIABLE FLOAT lata Type Jouble Mode Path ARIABLE STRING Jode Path ARLABLE_ INTEGER Data Type string lata Type Integer Male 1 0 A B Figure 7 70 Dynamic Data Type Casting In addition the user should set
60. Color to the COLOR column of the Data Source Double click on the far right end of the value field of the Font Color property This will bring up an attribute editor dialog see Figure 15 18 a Click on DataSource node under TRIAL sequence on the node selection list b Double click on the COLOR node in the node attributes window This will update the contents of Attribute editor dialog as parent parent parent TRIAL_DataSource COLOR c Click on the OK button to finish SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 313 cor Edit Attribute TEXT RESOURCE gt fontColor Attribute parent parent parent TRIAL DataSource COLORE Mode selection O i Node Attributes r Attribute Attributes er Project COLOR H Stroop WORD iF START EXPECTED Ps BLOCK COMPATIBLE F START A DISPLAY SCREEN E TIMER fi KEYBOARD Hah TRIAL l E ataSource fF START TRIAL_INDEX 1 KEYPRESS 1 RESPONSE J RT Xx LIPDATE_ATTRIBUTE T PREPARE_SEQUENCE bas TRIAL_EVENT LE RESULTS_FILE Devices Figure 15 18 Referring Text to Be Shown to Data Source 3 Set the appearance of the Text by choosing the desired font name font style and font size 4 Similar to Step 2 set the reference of the Text to the WORD column of the Data Source 5 Select the newly added text resource click on both Horizontal Center Alignment and Vertical
61. DataSet Files dat Lancel Places Open as read only A Figure 9 7 Append or Overwrite Confirmation SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 248 It s possible to prepare your own version of the datasource file When preparing such files please make sure make all of the variable labels appearing on the first row of the file in lower case regardless of the case used in the datasource editor add a before the label of a string column e g word a sign shouldn t be used for the labels of all other data types use a tab to separate between neighboring fields wrap the position and color values within string values with a pair of and list values with make sure all of the values in each column of the data file appear in the original column of the datasource editor 9 5 Datasource Splitby A data source may contain several hundred of trials However under some circumstances the user may want to run a small portion of the trials For example the user may want to run the first ten trials of a data source containing two hundred trials for debugging purpose In this case the user may modify the Split by property of the sequence node to which the data source is attached This specifies the actual number of iterations to be executed within each block This feature can be used to design data source for experiments in which unequal number of trials are tested at dif
62. E PA E Fie Edi Wew Experimert Help DEBRSA G SKE BRETEE VTAHBise araeali x BaAQHEAA degree Beets fe 4 4 fw START ER E Et PATE ATTRSUTE 2 Adda fixation screen 3 Add a timer k EO a u _ DESPLAT SCREEN 4 Add a target display screen i Edit label i T HET RORAD inPut l THRE OUT z T Add a timer trigger for Maximum response duration 5 Add a keyboard trigger i i i i After Lav bua fi E 8 Add a display screen paenan for end of trial clearing Epi by i pats Source Cours D Pows O _svoop mon p ma pb TRIAL EVENT Frese Disniey Uni Fir fF Figure 15 14 Editing Recording Sequence SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 310 1 Select the newly added Sequence node Rename the label as TRIAL EVENT Make sure that the Is Real Time box is not checked as this will make the keyboard dysfunctional 2 Click on the Action Tab of the component toolbox select the display screen action hold down the left mouse button and drag the action into the work area Select the action and rename it as FIXATION SCREEN We will add a fixation cross in this screen see Section 15 8 1 3 Click on the Triggers Tab of toolbox select the TIMER node hold down the left mouse button and drag the trigger into the work space Click on the Timer object Enter 1000 in t
63. Experiment gt Test Run This will create a Results directory containing data collected from the test run session Note that test run is not intended for real data collection and should be only used when you are testing your experiment Tip Running an experiment can also be performed by clicking on the Test Run button on the application tool bar or pressing the shortcut key F11 on Windows or Ctrl Shift R on Mac OS X Note If the experiment is tested under dummy mode a warning dialog box You are running in dummy mode Some eye tracking functionality will not be available will be SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 24 displayed at the beginning of the experiment and a warning dialog No EDF file is created for dummy mode session will be displayed at the end 4 11 Deploying an Experiment To deploy a built experiment so that it can be run on a different computer without relying on the Experiment Builder application choose from the application menu bar Experiment Deploy Upon receipt of the deployment command Experiment Builder asks for a directory to deploy If the user selects a directory a subdirectory with the name of the experiment session is created within it This experiment subdirectory contains all of the required files generated The user can cancel the deploy process by pressing the Cancel button Please note that non ASCII characters are not allowed in a deployme
64. Experiment Trial Recording DISPLAY _SCREEN alalN ololalY oloy leal alela e alal rz os Edit Attribute TEXT_RESOURCE gt text Attribute parent parent parent Trial_DataSource Text Attribute Editor Reference Selection Demoline START EL_CAMERA_SETUP D f Trial START DRIFT_CORRECT a Recording JF start FHA DISPLAY _SCREEN Interest_Areas Movement_Patterns Node Selection EHT Demoline START EL_CAMERA_SETUP Trial Node Attributes Attribute Attributes O Gees START A Tegel es DRIFT_CORRECT 2 EL_BUTTON Recording amp TIMER START Experiment Components Preferences ia DISPLAY _SCRE Interest_Are Property Value Moverment_f PO ofl Al MOLUSE OPTI jaf TEXT_RESC ocation 26 00 232 00 VMidth EL_BUTTON l a _ TIMER eight b ovement Pattern rebuild To Image 5 ont Color E Click Here ok cancer ont Name imes New Roman ont Style ormal ont Size 20 wall nderline L on aa TEXT all Demoline gt gt Trial Figure 10 1 Using Attribute References 10 2 Entering in Values If you want to enter in static values in the attribute editor just type the value Do not supply any prefix to the value Any preceding or trailing white spaces are removed The f
65. Experiment Builder User Manual 2004 2011 SR Research Ltd 347 17 2 12 Grid Segmentation co Preferences wf Preferences Eb Experiment E 0 Devices o H Nodes H Screen 5 Resources HS Movement Patterns EME Built In Interest Grea Preference GRID SEGMENT ii Ap ALITO_SEGMENT A WORD SEGMENT Build Deploy e GUI H GRAPH_LAYOUT e CUSTOMCLASS EDITOR Restore Factory Default Save Properties as Default Import From File Save Into File Grid segmentation will divide the whole screen into evenly spaced Rows x Columns interest areas Rows Number of rows used to create grid segment Columns Number of columns used to create grid segment 17 2 13 Auto Segmentation oof Preferences Elf Preferences Experiment Ee in Devices HE Nodes j Screen A 5 k Bottom eSources C Built In Interest Area Preference r sw Type Rectangle tS FR GRID_SEGMENT aE OTO SEGMENT Ae WORD SEGMENT in Build Deploy GUI L GRAPH_LAYOLIT io CUSTOMCLASS EDITOR Restore Factory Default Save Properties as Default Import From File Save Into File Auto segmentation will create a rectangular or elliptic interest area to contain each of the individual resources created on the display screen SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 348 Left Margin Right Margin Top Margin and Bottom Margin Number of p
66. For some properties e g Label of an action the value can be modified by double clicking on the value field entering the desired value and then pressing the ENTER key to register the change SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 51 e Ifa button box appears at the right side of the attribute cell after selecting the field see Figure 7 5 the property field may be edited with Attribute Reference Editor see Chapter 10 in addition to the above mentioned editing operations Properties xi Type Timer ode Path BLOCK TIMER ae ees Editable with Attribute Time Reference Editor last Checked Time Confidence Interval Figure 7 7 Property Field Editable with Attribute Reference Editor In the following sections of this chapter a set of symbols are used to indicate the properties of each attribute of an experiment component Attribute is read only and is not directly modifiable Attribute can not reference another attribute Reference Editor is not available NR The attribute can not be referred to by other component attributes Attribute value can be selected from a dropdown list Attribute is a Boolean value True if the box is checked false if unchecked The value of all other attributes can be modified either by entering value directly in the edit field or by attribute reference in an attribute editor dialog box and can be accessed by
67. Insert Text Resource button 4 on the Screen Builder toolbar and click at the desired position in the workspace where the text resource will be placed To edit the text double click on the resource A text editing caret will appear and the user can type in text from there Text editing can also be done from the value field of the Text property in the property panel Users can either enter the text in the text editor or click the button on the right end of the value field to bring up an attribute editor dialog box Various aspects of text appearance can be modified including color font name style and size Field Attribute Type Content Reference Label label String Label of the resource TEXT_RESOURCE by default Type NR Thetype of screen resource TextResource SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 211 pL the current item belongs to n default n Position is Gaze positionAtGazeC Boolea Whether the position of the resource is Contingent T ontingent n contingent on the gaze position False by default This setting can only be modified when the display screen is contained in a recording sequence Position is _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent n contingent on the mouse position False by Contingent T default Offset offset Point Adjustment of the resource position relative to the position of the
68. Left and Toggling Grid Visibility A special type of alignment styles is called Snap to Grid and is only available to resources see Figure 8 19 When creating the screen grids can be visible for alignment reference To enable grid visibility click on Toggle Grid Visibility button see Figure 8 18 This will create a set of grids partitioning the whole workspace into small areas the actual number of grids to be created is specified by the Grid Columns and Grid Rows attributes in the Display Screen preference settings Select the resource to be aligned and then click on the right mouse button Choose Snap to Grid in the popup menu This will align the top left corner of the resource with the top left edge of the grid if the location type is set as TopLeft Position or align the center of the resource to the center of the grid if the location type is set as Center Position see the preference settings for Screen ae Cut Experiment SEQUENCE DISPLAY SCREEN a alal oloa aolo m Paste fee ti Delete Th Snap To Grid A Lock selection Unlock selection Grouping Order Vertical Alignment Horizontal Alignment al Create Interest 4rea Set Save Screen As Image Figure 8 19 Snap to Grid Please note that position alignments should be re applied if the properties of the resource have been changed For example in a top left screen coordinate system changing the font siz
69. Manual 2004 2011 SR Research Ltd 167 N E Property poe Label IKATION Property abel FECTANGLE_RES Type Fixation Type lectangleResource Jode Path LOCK TRIAL RECORDING FIXATION isible W essage Ts TION Screen Index ime Position is Gaze Contingent 7 EBFointi DISPLAY SCREEN RECTANGLE RESOURCE location x Last Checked Ti DISPLAY_ SCREEN RECTANGLE_RESOURCE width 2 E M DISPLAY_SCREEN RECTANGLE RESOURCE location yi DISPLAY SCREEN RECTANGLE RESOURCE heighta 2 Position is Mouse Conting _ offset D 0 lear Input Quee nu Region Type RECTANGLE Region Location Top Left EBPoint DISPLAY_SCREEN RECTANGLE RESOURCE Region width DISPLAY SCREEN RECTANGLE RESOURCE width Acreen Location Type Center zegion Height DISPLAY SCREEN RECTANGLE RESOURCE height cation 0 100 hwvithin lw i 200 Tracking Eye ITHER i ast Outline Color hite Minimum Curation Boo ovement Pattern Event Type PDATEFIXATION Prebuild To Image se Software Surface Triggered Data I Figure 7 60 Using fixation trigger with top left and center location types 7 10 9 3 How to show the triggering region on the host PC Sometimes it is useful to draw feedback graphics on the Host PC so that the experimenter can monitor whether the subject s eye position is within the triggering region or the programmer can debug the experimemnt code by running the eye tracker in the mouse simu
70. Message g reezeDisplayUrtilFirstDisplayScreen RECORDING Record v Recording Pause Time 20 yeLink Record Status Me Trial str Figure 11 3 Creating Recording Status Message 11 3lmage and Interest Areas If the Send EyeLink DV Messages checkbox of a DISPLAY_SCREEN action 1s checked a V DRAW_LIST message will be recorded in the EDF file specifying the images and simple drawings to be used as the background for the spatial overlay view of the trial within a viewing session MSG 12808461 9 V DRAW_LIST runtime dataviewer graphics 1116546752 vcl Important Please make sure that the Prebuild to Image box of each screen resource 1s checked This will build the screen resource into an image and save it in an image file in the runtime images directory when the experiment is built This ensures a better runtime performance as well having images available for Data Viewer analysis SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 263 Important Please note that your data analysis does not have to be limited on the original PC where the data collection was done You may copy the whole Experiment Name folder to your data analysis computer To make the data transfer easier given so many files involved you may first zip up the Experiment Name folder keeping the directory structure and then unzip the file on your data analysis
71. N TA 92 Figure 7 21 Setting ASIO Buffer Latency iepene E A ERR 95 Pigure 7 22 U sine Playn ound ACION een A a labe cote 98 Figure 7 23 Using Play Sound Control ACtion sssseeeseeeeeesssssssssssssssseeeerrrrreeesssssssss 100 Figure 7 24 Using Record Sound ACtiOn esesssesssssssssseeeerrereressssssssssssseeeeereereeeessssssss 103 Figure 7 25 Using Terminate_Experiment Action sssseesssssssssssssseeterereresesssssssssssesees 106 Figure 7 20 Using Recycle Dataline AcCtonsesnisrinese i r 108 Pisure 7 27 Usms a NULL AC TION NOG oersstiecseiai nien a 111 Figure 7 28 Using a ResponsePixx LED Control ACON sesssssssessssssssssseererrrsesessssssss 113 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd viii Figure 7 29 Figure 7 30 Figure 7 31 Figure 7 32 Figure 7 33 Figure 7 34 Figure 7 35 Figure 7 36 Figure 7 37 Figure 7 38 Figure 7 39 Figure 7 40 Figure 7 41 Figure 7 42 Figure 7 43 Figure 7 44 Figure 7 45 Figure 7 46 Figure 7 47 Figure 7 48 Figure 7 49 Figure 7 50 Figure 7 51 Figure 7 52 Figure 7 53 Figure 7 54 Figure 7 55 Figure 7 56 Figure 7 57 Figure 7 58 Figure 7 59 Figure 7 60 Figure 7 61 Figure 7 62 Figure 7 63 Figure 7 64 Figure 7 65 Figure 7 66 Figure 7 67 Figure 7 68 Figure 7 69 Figure 7 70 Figure 7 71 Figure 7 72 Figure 7 73 Figure 7 74 Triggers Implemented in Experiment Builder cc eeeeeeeeeeeeeeeeees 11
72. SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 123 Reference Label of the conditional trigger The default value is CONDITIONAL Type The type of Experiment Builder objects Conditional the current node belongs to Node Path absPath String The absolute path of the node in the experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the conditional trigger fires Time time Float Display computer time in milliseconds from the start of the experiment when the trigger fires Last Check lastCheckTime This property can be used to retrieve the Time Display computer time in milliseconds from the start of the experiment when the trigger was checked for the last time Confidence cena Time difference between the trigger time and Interval last check time of the trigger This indicates a window of uncertainty Attribute attribute The attr bute whose value needs to be evaluated Attribute 2 attribute2 Comparator J comparitor Dropdown list used to select possible Comparator 2 comparitor2 comparison between the variable and value q Possible values EQUALS default value GREATER THAN LESS THAN OR EQUALS CONTAINS NOT EQUALS LESS THAN or GREATER THAN OR EQUAL Value val
73. Save AS 2 In the Save As dialog box click on the button to the right of Project Location to browse to the directory where the session should be saved 3 Enter the new session name in the Project Name edit box 4 Click OK button Tip The session can also be saved by clicking the Save As button lo on the application tool bar 4 4 Opening a Session To open an existing experiment session from the Experiment Builder application 1 From the application menu bar choose File Open 2 In the Open dialog box browse to the directory of experiment and select the graph ebd file see Figure 4 4 My Recent D Desktop biy Documents er My Computer biy Metwork File nare graph ebd Open Files of type lEyeLink Experiment Builder files Cancel Figure 4 4 Open an Experiment Builder Session 3 Click on the Open button SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 21 Note If an experiment is already open in the current session the Open operation will first bring up a Save Confirmation dialog box so that the user can either save the current session YES abandon the current session NO or stay in the current session CANCEL see Figure 4 5 a Save Confirmation x 2 Do you want to sawe changes to D ExperimentBuilderitest ab Figure 4 5 Save Confirmation When Opening a New Session Tip A s
74. Screen In the following Multiline Text Resource Editor 1 Click the Margins button box to set the text margins Enter 100 in all fields Click the OK button on the dialog box 2 Enter the instruction text SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 302 3 Press CTRL A on Windows Command A on Mac OS X to select all text entered 4 Make sure that the text is still selected Click the buttons on the toolbar to set the desired text appearance font name font size font style alignment style line spacing and text color 5 Select the target word Green and set its color to blue and text size to 50 6 Click on the Close button J at the top right corner of the dialog to finish Please note that instead of using multi line text resource the user can also create the instruction screen by using an image resource see Section 8 1 1 Hilt ane Dest Beso Udit 4 Set the appearance of the text 1 Click on the margins button to edit text margins Top Mergen noo Botiom Mergn 100 In the following displays you will see a single word show 2 a a E ig Fo min I ra Len Margi hiis Please make a speeded response to the COLOR of the woi patwa fan if the word 1s in red color b if it is in blue color and g color For example if you see x cea 2 Enter instruction text 3 Press CTRL A to select all text Green Select the word and adjust its appearance
75. TTL FE CEDRUS TT OnBOX E E Nodes re Screen 2 a Build Deploy Eb Gul a Restore Factory Default Save Properties as Default Import From File Save Into File Type type This identifies the type of button box plugged to the host computer This can be the Microsoft SideWinder Plug and Play gamepad plugged to a USB port SR Research Gamepad plugged to a parallel port and ResponsePixx Button Box plugged to a parallel port Button presses on the response box will be processed by the EyeLink button trigger Debounce Time debounceTime Sets the button debounce time in milliseconds Typically button responds immediately to first change any change following this is ignored for the amount of time set in the debounce time Parallel Port parallelPort The parallel port to which the gamepad 1s plugged if the SR Research Gamepad or ResponsePixx Button Box is chosen This can be the parallel port on the motherboard or the PCI express adapter card LF811 installed on the host computer The Card option is only supported with version 4 50 or later of the EyeLink 1000 host software or 2 30 or later of the EyeLink II host software A Parallel port expansion cars not supported in this version of host software error will be reported if an earlier version of software is running on the host computer If this property is set to Card while the physical card LF811 is not installed on the host computer a
76. The user may first add a Variable object to the graph see Figure 7 40 and set its initial value to 0 see Panel A of Figure 7 41 Following this an update attribute action can be added in the loop to increase the value of the variable by 1 for each loop set the Attribute property of the action as VARIABLE value and set its value field as VARIABLE value 1 see Panel B of Figure 7 41 Finally a conditional trigger should be added so that the loop can be ended after 5 repetitions see Panel C of Figure 7 41 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 186 VARIABLE i CONDITIONAL a L x DISPLAY _END Figure 7 68 Using a Variable SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 187 Using ariable F START Jif START VARIABLE i VARIABLE _ DISPLAY_A TIMER_ 2 z E TIMER_A x UPDATE_ATTRIBUTE X Y UPDATE_ATTRIBUTE DISPLAY _B POATE ATTRIBUTE POATE ATTRIBUTE est Attribute alue List for UPRATE_ATTRIBUTE Attribute ay ARABLE valued E ARABLE valued 1 Please Set Attribute Please Set Value A B C Figure 7 69 Property Settings for Variables Variable can be conveniently used as temporary data storage For example to output some trigger data to a result file or to record it to a Trial ID message the user may first create a variable and refer it to the target triggered data Please note that a variable in Experiment
77. Using EyeLink button trigger without ending a trial 7 10 4 3 Knowing the ID of a specific button on the EyeLink button box The supported EyeLink button box should be used on the host computer It can be the one attached to a USB port Microsoft SiderWinder Plug and Play Gamepad or the one attached to the parallel port on the motherboard or to the designated PCI express parallel port adapter card on the host computer SR Research Gamepad or ResponsePixx button box The use of the parallel port based button box on the designated PCI express adapter card LF811 requires running version 2 30 or later of EyeLink IJ host software or 4 50 or later of the EyeLink 1000 host software You will also need to go to EyeLink Button Box Device to specify the particular button box used for your study so that Experiment Builder can automatically configure the button mappings for you e Microsoft SideWinder Plug and Play gamepad Y gt 1 X gt 2 B gt 3 A gt 4 Big D pad on the left gt 5 left back trigger gt 6 right back trigger gt 7 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 131 e SR Research Gamepad blue gt 1 green gt 2 yellow gt 3 red gt 4 big purple gt 5 The other two side trigger buttons are non functional e ResponsePixx Button Box 5 button handheld and 5 button desktop models Yellow gt 1 red 2 blue gt 3 green gt 4 white gt 5 7 10 5 Cedrus Button T
78. Width 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Region Height regionHeight Integer Height 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Interest Area NR The display screen on which target interest area Screen regions are located Note that this property is only available when the Region Type property is set to INTEREST AREA Interest Area NR Target interest areas used to define the Regions triggering region Note that this property is only available when the Region Type property is set to INTEREST AREA Within T within Boolea If set to True default the trigger should fire n when samples are within the boundary region otherwise the trigger fires when samples are outside of the prespecified region Tracking Eye trackingEye Integer Decides which eye s data is used for online parsing The default value is EITHER 2 It can also be LEFT 0 or RIGHT 1 minimumDuratio Integer Duration in milliseconds in or out of the region before the trigger fires If the default value 0 is used the trigger fires immediately after detecting a sample inside or outside of the boundary Minimum Duration n Changes from version 1 4 202 The Sample Count prope
79. Y 305 13778 291 16 TRIAL 2 MOUSE X 512 Y 289 13795 179 16 TRIAL 2 MOUSE X 512 Y 284 The actual mouse resource position shown on screen will be the difference between the first two columns 1 e 13661 141 for 13645 141 16 One drawback with the above approach is that the messages are only sent out when the mouse position changes and thus the screen updates based on the resource position change If you need to get a SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 157 continuous output you ll need to fill in the positions yourself for the period of time when the mouse is not moving If you are recording the mouse position in an EDF file an V TARGET _POS TARGI message can be used so that the target position traces can be obtained in the sample report and displayed in the temporal graph view the positions of the mouse are interpolated across samples You may check the HTML version of this document for an example project ar EyeLink Data iewer Ioj x File Edit Analysis Window Help a Inspector Men i E gt Data at Preferences B33 1666 2499 S335 HEG 4999 5833 BEGG 7499 233a 94166 l l l l l 205 407 508 610 7412 81 Anz 6 CI 2 fe ED Trial 3 H Interest Area Templat Field Walle TE ndex 2 R Recording B2688 ms Recording 102773 ms Recording 10085 ms 7 iew
80. afterimages Use Animation useAnimationT Boolea If checked an video clip can be used as the Target arget drift correction target The user should B n preload the intended video clip into the library manager Note that this option 1s presently not available on Mac OS X Animation animationTarge String The name of the video clip used as the drift Target J t correction target Note that this option is presently not available on Mac OS X Animation animationPlay Integer Total number of times the video clip will be Play Count Count played before the drift correction is done Note that this option is presently not available on Mac OS X Use Custom useCustomTarg Boolea If checked drift correction will use the Target et n custom target supplied a small image file with the feature interesting part appearing in the center of the image Custom Target customTarget String The name of the image file that 1s used for drawing the drift correction target The image files should be preloaded into the library manager Note that this property is only available if Use Custom Target is checked Target Outer Diameter of the outer disk in pixels Size SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 65 Target Inner Diameter of the inner disk in pixels Size If checked drift correction will use the custom useCustomBack Boolea ground n Use Custom Backgrou
81. aie QQQBae START 2 Select Action Tab g HA Connect from Start to Sequence RESULTS_FILE amp 5 Click on the Other tab of the z rar 3 Add Sequence to work Hii stant mm T Double click on E RESULTS FILE Sequence to continue component toolbox to add a Result File node 1 Click here to start 6 Click on the nght mouse button at a blank area and select Arrange Layout Resi Time ir Aeration Coun 4 Bet by i Conta Source Coms Di Rowa G T tmi heii Unii Fit E Wena u I i s al Soop import Mod I Figure 15 3 Creating Experiment Block Sequence 1 Click on the Experiment Tab in the Project Explorer Window to start 2 Click on the Action Tab of component toolbox 3 Select the Sequence node hold down the left mouse button and drag it into the work area SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 299 4 Place the mouse cursor on top of the START node hold down the left mouse button while moving the mouse cursor on top of the SEQUENCE node This makes the connection from the START node to SEQUENCE node Note don t make a single or double click on the START node as this will select the node instead If you have done so place the mouse cursor on a blank area in the work space and make a single click there Redo the current step again 5 Click on the Other Tab of the component toolbox and add a
82. aliasing Drawing box is checked see Figure 8 8 Ee Preferences Property H Experiment ocation Type Devices Interest4rea Color Z Nodes artialiasDrawing 8 Sey Resources Movement Patterns __ Built In Interest Area Preference BuilldDeploy GU Restore Factory Detautt Save Properties as Detautt Figure 8 8 Antialiasing Drawing Preference Setting In addition anti aliasing works well in a uniform background The user should set the Transparency color of the Experiment close to but not identical to the background color in the display For example see Figure 8 9 to show black 0 0 0 text over white 255 255 255 background the user may set the transparency color to something close to white for example 251 250 251 Important Never set the transparency color the same as the display background color this will cause the display drawn improperly SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 214 ooo a Preferences 2 Choose Color Ff Preferences Property ares eas Ey H amp E Experiment cth m4 9 Devices eight 68 EX EYELINK Coo Elisa Bits Per Pixel 32 m F Refresh Rate S0 e jiii i igrao a ties 251 a E T S O Tr TTL ransparency Color aceoms o Gem presser sg 3603 __ Nodes in msec To Next Fetra 2 0 oS 170 Zoo H Screen Resources Blue E E a 251 T Movemen
83. allows the user to share data between several experiment creation sessions with newly added importing exporting features You may select the nodes to be shared export it to a file In the target experiment builder session you can then import the graph at the intended location This topic explains in detail how to share data between Experiment Builder sessions by exporting and importing 7 3 1 Exporting 1 Select the node sequence to be exported Please make sure that only one node or sequence is selected 2 Click the right mouse button to bring up a popup menu see Figure 7 2 Select Export Node If the Export Node option is grayed out please make sure that you SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 47 have one and only one node sequence selected START oe Cut FES Copy ta Paste t Paste Multiple Delete A Zoom Selected RH foun Ln Q zoom tue FB Ft Content Layout B Export Node A import Node Figure 7 2 Exporting Node 3 In the following Export dialog box go to the directory where the node should be exported set the intended export file name and then click on the OK button e If the node to be exported contains references to other nodes data source that are not part of the selection a Reference Maintenance dialog see the figure below will be displayed to enumerate all of the stripped references You may click on the Save button to save the informat
84. amount of memory in a video card available for graphics operation e g stores images as before they are sent to the display monitor Retrace Interval retraceInterval The duration of one refresh cycle of the monitor calculated as 1000 refresh rate SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 334 17 1 3 Audio Ek i x Er wa Preferences 5 Experiment loudio Driver 3 a rO Devices oicekey Queue Size ABE EYELINK br B DISPLAY f KEYBOARD 4 CEDRUS 2 ae BLITTONBOX E Nodes a Screen Build Deploy ET Restore Factory Default Save Properties as Default a Import From File Save Into File Audio Driver driver The driver used to play audio clips On Windows 2000 XP Vista and Windows 7 two audio drivers are available DirectX or ASIO supported only on 32 bit Windows If using the ASIO the user must have ASIO driver and an ASIO compatible sound card installed On Mac OS X this is always set to OS X Properties applicable to ASIO Driver e Output Interval outputInterval The interval in milliseconds between ASIO buffer swaps which determines how often new sounds can be output e ASIO Audio driver driverName The name of the ASIO driver e Minimum Output Latency minimumOutputLatency The minimum output latency of the ASIO driver delay from buffer switch to first sample output e Voicekey Queue size voicekeyQueueSi
85. and debugging experiment code To collect experiment data the user should use the deployed version of the experiment see next section as it does not have to rely on the Experiment Builder application and can be run on a different computer 14 3 Deploying the Experiment After the experiment is built the user must deploy the experiment to a new directory see Section 4 11 This will generate a set of files so that the experiment can be run on a different computer without replying on the Experiment Builder application If a data source is used this will create a datasets subdirectory with a copy of data set file in it The user may create several copies of data set files with the randomizer application see Section 9 5 2 14 4Running the Experiment To run the experiment open the directory where the experiment is deployed to and click on simple exe If the EyeLink host application is already running on the Host PC and the Ethernet connection and settings between the host and display computer are ok the experiment should now start This will first popup a dialog box asking for the data source file Go to the datasets directory and select the target data source file Following this enter the desired EDF file name must be in DOS 8 3 format and click on the OK button to continue Following the initial welcome message the participant will be shown the camera setup and calibration screen and the recording can be s
86. are documented in the COMMANDS INI file under C AEYELINK2 EXE or C ELCL EXE directory of the host partition See the change template for an example 7 10 11 Sample Velocity Trigger The sample velocity trigger available only in an EyeLink experiment implements a fast saccade or fixation detection algorithm by checking the velocity and acceleration information on a sample by sample basis The Sample velocity trigger fires when both the sample velocity and acceleration values exceed their respective criteria This trigger will fire much quicker than the Saccade trigger so the Sample Velocity Trigger should be used for saccade contingent paradigms Occasionally there will be misses and false alarms in saccade detection compared to the slower saccade trigger The sample velocity trigger is location based and fires only when the eyes are within or outside of a specified region To make the trigger fire regardless of current eye position the user can keep the default location settings but uncheck the within check box Alternatively the user may set the triggering region as the whole display area As all other eye based trigger types a sample velocity trigger must be used in a recording sequence Reference Label of the sample velocity trigger The default label is SAMPLE_VELOCITY The type of Experiment Builder objects SampleVelocity the current node belongs to experiment graph Message to be sent to E
87. area of the workspace in the intended sequence level please make sure that no node sequence is selected 2 Click the right mouse button to bring up a popup menu see Figure 7 3 Select Import Node If the Import Node option is grayed out please make sure that you do not have any node currently selected 3 In the following Open dialog box go to the directory where the exported node file is contained select the ebo file and then click Open START 2 VARIABLE a ub apy 4 A Paste si tig Paste Multiple Delete a Zoom selected Fe E oom In 4 zoom ue Ea Fit Content Layout oy Export Mode DISPLAY SCREEN TIMER b Import Mode SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 49 Figure 7 5 Importing Node 7 4 Layout of Nodes in Work Space The Work Space in the Graph Editor Window functions like a flow diagram editor in which components are dragged onto and connected If a large number of items are added the work space may get cluttered The graphic interface of Experiment Builder allows for automatic node arrangement zoom in or zoom out operations to create high quality drawings of a graph so that it can be understood easily To rearrange the layout of items in a hierarchical manner place the mouse cursor to a blank area in the Work Space click the right mouse button to bring up a popup menu and choose Layout and then click OK see Figure 7
88. be possible for some data files I Enable Trial Randomization Run Length Control Column Maximum Fun Length 2 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 251 9 6 1 4 Randomize on Roll Over If checked a different randomization sequence will be created for the datasource when it is re used 9 6 1 5 Splitting Column Sometimes the user may want to have randomization done over a subset of the trials in the original data file This can be achieved by using a splitting variable with one output for each level of the grouping variable Splitting Column 9 6 1 6 Running Experiment with Internal Randomizer After the experiment is fully tested you can now create a deployed version of the experiment Experiment gt Deploy Click on the experiment name exe in the deployed directory to run your experiment If you use the randomized versions of the same data source file across subjects you may uncheck the Prompt for Dataset file box of the sequence to which the data source is attached before deploying so that you do not have to choose the data source file at the beginning of the experiment In addition 1f you have specified a variable for splitting the data source a dialog box will be displayed at the beginning of the experiment prompting to choose the level of the splitting variable Select Condition Value To Available Values for Column SET a Tho Ed cance _ At the end of
89. be set to O for a vertical sine movement and Amplitude Y should be O for a horizontal movement X and Y amplitudes must be the same for a circular movement otherwise this will result into an elliptic movement The start point of the movement is specified by the Start Phase X and Start Phase Y The following table lists the most important landmark positions in a sinusoidal movement pormo ear ving Pomoje Sy Pao fo fee Novag ews e son Som For a horizontal movement Start Phase Y should be set to 0 A Start Phase X of 0 creates a movement which starts at the center of the movement and moves right a Start Phase X of 90 creates a movement which starts at the right end of the movement and moves left a Start Phase X of 180 creates a movement which starts at the center of the movement and moves left and a Start Phase X of 270 creates a movement which starts at the left end of the movement and moves right SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 227 For a vertical movement Start Phase X should be set to 0 A Start Phase Y of 0 creates a movement which starts at the center of the movement and moves down a Start Phase Y of 90 creates a movement which starts at the lower end of the movement and moves up a Start Phase Y of 180 creates a movement which starts at the center of the movement and moves up and a Start Phase Y of 270 creates a movement which starts at the upper end of the m
90. block we will first give an instruction and then run nine trials see Figure 15 5 1 Click on the Action Tab of the component toolbox select the Display screen action hold down the left mouse button and drag the action into the work area 2 Click on the Trigger Tab of the component toolbox select the Timer trigger hold down the left mouse button and drag the action into the work area 3 Click on the Timer trigger and set the duration to 120000 msec 4 Add a Keyboard trigger to the work space 5 Click on the Action Tab of toolbox and add a Sequence node to the work space This will be our trial sequence 6 Place the mouse cursor on top of the START node Hold down the left mouse button while moving the mouse on top of the DISPLAY_SCREEN node This makes the connection from the start node to the DISPLAY SCREEN node 7 Similarly connect from DISPLAY_SCREEN to KEYBOARD and TIMER triggers Note that a number is added to these connections indicating the evaluation order among the two trigger types 8 Make a connection from the two triggers to the SEQUENCE node a S Pepearch Expeniment Bader y A020 A romp n o nlf Fis Edt View Expersnert Help DERS S DPxeRARR BE CTAB edoRral QhRaBas lB gt iol alalels SPP LAr _SCREEM 1 Click on the action tab to add a display screen action 2 Click on the Trigger tab of fo the
91. blue bars but the hardware video refresh rate is 85 hz one refresh every 11 765 ms green bars then the two different update intervals are not multiples of each other Assuming a video start time of 0 the second frame would have a desired display time of 33 33 ms but the nearest retrace to the desired time is at time 35 29 msec retrace rate 3 which would be the actual time that the frame is displayed Refresh 85 hz M UTP RCECUENN Video 30 fps E E E Refresh 60 hz This implies that the best case is one in which the vertical refresh rate is an integer multiple of the frame rate For practical purposes that would mean a refresh rate of either SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 208 60 hz see the red bars 90hz 120 hz or 150 hz for a video clip playing at 30 frames per second Moreover it implies that refresh rates intermediate between integer multiples of the frame rate 75hz for example will cause increased variability in the offset between actual and desired video frame display times In reality the retrace rate of a 60 hz or 120 hz monitor may be slightly off for example it could be 60 01 hz This means that even when you use a retrace rate that 1s a multiple of the frame rate some small drift between actual and desired frame display times can occur during the course of the video presentation This is handled by the video display engine by displaying a video frame for a duration le
92. button and 4 the properties of the button trigger can be set as those in the following figure SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 128 x ButtonTest Jif START 1 PREPARE_SEQUENCE Fh RECORDING START A DISPLAY _INITIAL AEL BUTTON 6 TIMER DISPLAY _BLANK Experiment Components Devices Properties A x Property Value Label L BUTTON TIMER ype Eeto i rode Path FECORDING EL BUTTON essage EL_BUTTONM irre beet Checked Tine i DISPLAY BLANK Contidengce Interval lear Input Queue riggered Data Press Everts m Release Events Figure 7 35 Using EyeLink button trigger The following discusses some of the common applications of the EyeLink button trigger 7 10 4 1 Calculating response time of a button press EyeLink button responses can be retrieved by using the UPDATE_ATTRIBUTE action Typically you may use a couple of variables to record the button pressed the time RT of the button press and the accuracy of the button press Specifically the button press should be retrieved as EL_BUTTON triggeredData button the time of button press should be retrieved as EL_BUTTON triggeredData time see the following figure With that you can calculate the response time BUTTON_PRESS_TIME value DISPLAY_ON_TIME value In case the trial can end without having the subject to press a button an UPDATE_ATTRIBU
93. component toolbox to add l m Todo a Timer trigger i as 4 Add a Keyboard trigger 5 Add a sequence 3 Select the Timer trigger and set the duration to 120000 ms Figure 15 5 Adding Instruction to Block Sequence SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 301 9 Click at any blank area in the work window Click the right mouse button and select Arrange Layout in the popup menu This will re arrange the nodes in an orderly fashion 10 Double click on the DISPLAY_SCREEN object in the work space not from the structure list until the Screen Builder interface is displayed in the Graph Editor Window see Figure 15 6 15 5 Creating Instruction Screen The user may want to provide instruction to the participants at the beginning of the experiment 1 Click on the multiline text resource 4 button on the screen builder toolbar to select the type of resource to be added 2 Click anywhere on the screen i BeBBe PKEBBRTE VAH Sieger eli QaRaREE cor XU eenerimert BLOCK DESPLAY_SOREEN AaVPARNOOCAY AvY BEE BEE BARRE EB Trent Mufti Line Tert Resource 1 Click on the Multiline text resource icon 2 Click anywhere in the work space to continue 1 i fi 1 i Ces inpul Guai i j i i F j J Pag ad Coder puio Genma Syre 7 i oi a igra Rpa mi Figure 15 6 Adding Multiline Text Resource onto a Display
94. computer If the user adds a blank screen at the end of the trial to clear display screen please make sure that the Send EyeLink DV Messages checkbox of that action 1s unchecked For some experiments the user should also create interest areas so that future analyses can be done with ease If a display screen contains interest areas an interest area message will be written to the EDF data file to inform the viewer to re create those interest areas during analysis MSG 63036 13 V IAREA FILE runtime dataviewer test aoi ias_1021582019659 ias SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 264 12 Custom Class In addition to programming through the Graphical User Interface Experiment Builder also allows the users to do custom scripting using the Python programming language The current section explains how to create a new custom class how to define class attributes and methods how to instantiate a custom class object and how to use the custom class object in the Experiment Builder GUI 12 1 Enabling Custom Class Option To create a custom class in an Experiment Builder project please first check the project preference settings Click Edit gt Preferences select Experiment Preferences and check the Enable Custom Class box This will activate several node types for use in the experiment project Custom Class Instance Execute Action and Custom Class Tab of the Library Manager see below 12
95. computer if the driver for a PS 2 keyboard mouse is updated SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 144 Hardware Installation q The software you are installing for this hardware IN SREE Keyboard Filter has not passed Windows Logo testing to verify its compatibility With Windows esP Lell me why this testing is important Continuing your installation of this software may impair or destabilize the correct operation of your system either immediately or in the future Microsoft strongly recommends that you stop this installation now and contact the hardware vendor for software that has passed Windows Logo testing Continue Anyway STOP Installation Figure 7 48 Click Continue Anyway on logo testing warning 3 Open the experiment project click Edit gt Preference gt Experiment to open the Experiment preference settings and tick the Enable Multiple Input option 4 If multiple keyboards are used go to the Keyboard Device preferences set the intended number of keyboards for the experiment project and assign a distinct label for the keyboards if you need to If multiple mice are used go to the Mouse Device preferences set the intended number of mice for the experiment project and assign a distinct label for the mice if you need to 5 Now for all of the keyboard triggers the possible keyboards to be used are listed in the Use Keyboard property of the trigger 6 When
96. correct action camera setup action or any trigger If a prepare sequence action is used it should be placed before the drift correction action In typical experiments the user may have Allow Setup field checked so that when the ESC key is pressed the camera setup screen is displayed so that the experimenter can adjust the camera settings and redo a calibration and validation The Draw Drift Correction Target box should be checked if the built in or custom drift correction target should be displayed when entering the drift correction mode In some e g pursuit or saccade experiments the user may want to have the drift correction target to be the same as the pursuit target or other display items If this is the case the user may uncheck this box and insert a display screen action to pre draw the drift correction target Please take a look at the PURSUIT experiment for an example Alternatively the user may have both Draw Drift Correction Target and Use Custom Target fields checked and supply an image for the custom target property The following figure illustrates the use of drift correction action in a typical trial SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 67 Co i START Drift correct fF START W PREPARE_SEQUENCE DRIFT_CORRECT ha RECORDING Experiment Components eeey OO ve Label ORIFT_CORRECT Ype DriftCorrection Message irre art Tirne Clear Input Queue
97. create the trial randomization files manually by using programs like Microsoft Excel to create the data source and save it in a tab delimited file Please make sure that each and every possible trial instance in the randomization file should be seen in the default data source used when building the experiment Failing to do so may cause the experiment to crash during run time Once the randomization is done click on the experiment name exe to run your experiment When you are asked to load a data source file choose one of the randomized copies from the datasets directory In your experiment project please make sure that you have checked the Prompt for Dataset file box of the sequence to which the data source is attached SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 253 H Simple iF START EL_BUTTON EA TIMER EL_CAMERA_SETUP ae Split by 2 Freeze Display Until Fir z T 5 rompt for Dataset He M o O OOS O Ba a EEE Make sure that this box i is decai when using external randomization Figure 9 10 Using External Randomization SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 254 10 References The Experiment Builder uses references to link or bind an attribute of one experiment component to be equal to the value of another component attribute References are a critical part of the Experiment Builder providing muc
98. current gaze or mouse position 0 00 0 00 by default Host Outline hostOutlineColo Color The color of the box drawn on the host screen to show the position and dimension of the current resource This property is available only if the Color Use for Host Display option of the containing display screen action is enabled Screen Location NR Whether the location specified below refers to Type the top left corner or center of the resource This setting can be changed at Screen Preferences Location location Point The coordinate of the top left corner or center of the resource Width width Intended width of the resource in pixels Height Intended height of the resource in pixels Movement NR Movement pattern sinusoidal or custom of the Pattern f resource Prebuild to prebuildToImage Boolea Whether the resource should be built into an Image T n image when the experiment is built instead of having it created during the actual execution of the trial This field 1s always true when the screen is contained in a recording sequence IMPORTANT If this attribute is False the run time drawing may not look exactly as it does in the screen editor Use Software useSoftwareSurf Boolea If false unchecked memory on the video card Surface T n is used to hold the resource blitting from the video card memory to the display surface is fast If true checked the system memory is used to h
99. default START node to one or several triggers or actions and then to other triggers or actions and so on This requires the designer to connect two experiment components with arrowed line to establish a directional or dependency relationship between a Source component and a Target component DISPLAY _SCREENM Source TIMER Target Figure 6 3 Connecting between Source and Target Components To make a connection from a Source component to a Target component place the mouse cursor on the Source component hold down the left mouse button without releasing the button as this constitutes a mouse click and will select the item instead move the cursor to the Target component and then release the left mouse button To cancel a connecting operation in progress press the ESC key To remove a connection between two experiment components click on the connecting line until it is highlighted in yellow and then press the Delete key on a Windows keyboard Command and Delete together on Mac OS X or select the fi button on the application tool bar 6 2 3 Linking Rules The connection between a Source and Target component is governed by a set of rules 1 A node cannot be connected to itself 2 You cannot connect two components in the same direction twice 3 The START node cannot be a Target 1 e it cannot receive a connection from other components The Source START node can target to an action trigger or sequence SR R
100. display change can be implemented Please note that how quickly the trigger will fire is influenced by the tracker heuristic filter setting and the velocity acceleration model used for calculation applicable to EyeLink 1000 only To detect a saccade instantaneous velocity and acceleration values are calculated for each sample and compared to the threshold values For cognitive experiments the velocity threshold is typically set to 30 degrees sec and the acceleration threshold is set to 8000 degrees sec to detect saccades of 0 5 degrees of visual angle or greater For psychophysical studies the threshold values are much lower to make the parser more sensitive ast Checked Time konfidence Interval egion Direction 0 45 45 90 90 135 135 180 Region Type RECTANGLE Region Location Top Lett 212 334 Eapro too Region Height nog e NeostyTeshod ooo Peacen oooO Figure 7 63 Using sample velocity trigger The following discusses some of the common applications of the sample velocity trigger 7 10 11 1 Top left vs center triggering location type Please note that the location type of all trigger types invisible boundary triggers mouse trigger fixation trigger saccade trigger and sample velocity trigger is top left based SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 179 whereas the screen resources can be either top left based or center based the screen resource interest area loca
101. does not have to add a PLAY_SOUND action immediately before or after the DISPLAY_SCREEN action Audio played with ASIO driver will have messages logged in the EDF EyeLink experiment or message file non EyeLink experiment with Save Messages option enabled in the project node The start time of audio playing is logged as V APLAYSTART message and the end time is marked by V APLAYSTOP message Both messages have a negative time offset typically preceding this message e Playing Starts MSG lt EDF time gt lt offset gt lt V APLAYSTART gt lt start frame gt lt clip id gt lt audio file gt e Playing Ends MSG lt EDF time gt lt offset gt lt V APLAYSTOP gt lt stop frame gt lt clip id gt lt audio file gt In the following example the FIXATION_SCREEN is displayed at time 10400921 10400919 2 and the PLAY_BEEP sound is emitted at time 10401021 10401007 14 So the delay between FIXATION_SCREEN and PLAY_BEEP is 100 ms MSG 10400919 2 FIXATION_SCREEN MSG 10401000 2 V DRAW_LIST runtime dataviewer test graphics VC_1l vcl MSG 10401007 14 V APLAYSTART 0 1 library audio innertrialbeep wav MSG 10401021 PLAY BEEP MSG 10401903 14 V APLAYSTOP 19755 1 library audio innertrialbeep wav If you need to synchronize the playing of the sound to the presentation of a screen you may use the DISPLAY_SCREEN to show the visual stimuli and then enable the Synchronize Audio check box This will allow you to
102. e f g h 1 J K l m n 0 p q r S t u V w X y z Delete NumPad 0 NumPad 1 NumPad 2 NumPad 3 NumPad 4 NumPad 5 NumPad 6 NumPad 7 NumPad 8 NumPad 9 NumPad Period NumPad Divide NumPad Multiply NumPad Minux NumPad Plus NumPad Enter NumPad Equals Up Down Right Left Insert Home End Pageup Pagedown F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 Numlock Capslock Scrollock Rshift Lshift Retrl Letrl Ralt Lalt Rmeta Lmeta Lsuper Rsuper Mode Compose Help Print Sysreq Break Menu Power Euro Undo When a keyboard trigger fires the user can further access the triggered data The sub attributes of the TriggeredData for a keyboard trigger are listed in the following table Keyboard keyboard String Keyboard on which the triggering key is pressed If Enable Multiple Input option is enabled this returns Tracker PC KEYBOARD_1 KEYBOARD_2 otherwise this returns Display PC or Tracker PC Key key String The key pressed that fired the trigger Key Code The numeric code for the key pressed Unicode Key R Integer Returns the Unicode key for the key s pressed A MISSING_DATA will be returned if the system cannot translate the key sequence to a character a Integer A bit field enumeration for one or multiple modifier keys Shift CTRL and ALT pressed Is aro Pressed lll Boolea Whether one of the SHIFT keys is pressed n Is CTRL Pressed isCtrlPressed B
103. experiment An Action tells the computer to do something like displaying a screen or playing an audio clip whereas a Trigger represents some precondition that must be met for the experiment to continue past that point Experiment components are connected to each other using arrowed lines that represent sequence and dependency relationships 1 e X must be done before Y can be done The connection of experiment components forms the flow of the experiment The following figure illustrates a very simple experiment sequence with gaze contingent manipulation SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 36 INVISIBLE _ BOUNDARY Figure 6 2 Sample Experiment Sequence In this example the experiment sequence starts with a DISPLAY_FIRST_SCREEN action which draws graphics to the computer display Now the sequence constantly monitors two Triggers until one of the Triggers is satisfied an INVISIBLE_BOUNDARY trigger and a TIME_OUT The INVISIBLE_BOUNDARY is triggered if the participant s gaze falls within a pre specified region of the screen whereas the TIME OUT is triggered if a specified amount of time e g 30000 milliseconds has passed since DISPLAY_FIRST_SCREEN was drawn If TIME_OUT is triggered the sequence ends since the TIME_OUT Trigger does not connect to any subsequent experiment components However if INVISIBLE_BOUNDARY is triggered DISPLAY_SECOND_SCREEN action is performed and draws new graphics to t
104. experiment directory will be overridden by Experiment Builder eos EyeLink Message l x i Please Note Do not manually add or remove Files in the experiment directory The Experiment Builder application will overwrite such changes 14 1 2 Configuring Experiment Preference Settings After a new experiment session is created the user needs to check whether the default display and screen preference settings are fine for the experiment to be created i SE Research aperiri Bidhher v LALA RE Simple Fis Edt Vew Experiment Hap raneperancy Coin n many To Mrt Petree Aden Fame Cache Sie i i Evelink DV Variables ioe Widen Decoding Thread j Tame u D ry 7 Bil pimen Ares Pelerence a Bes j m e c SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 279 Figure 14 2 Configuring Preference Settings 1 Select Edit Preferences from the application menu bar or press shortcut key F on Windows On Mac OS X click ExperimentBuilder gt Preferences from the application menu bar or press Command 2 Click on Preferences Experiment gt Devices gt Display to check display settings Make sure that the settings Width Height Bits per Pixel and Refresh Rate used in the current example are supported by your video card and monitor 3 Click on Preferences gt Screen to check Screen Builder settings Set the Location Type as Center Position 4 To
105. for EyeLink II and EyeLink 1000 eye trackers Heuristic Filter heuristicFilter Used to set level of filtering on the link and analog output and on file data This setting is only available for EyeLink I tracker Eye Event Data eyeEventData Sets how velocity information for saccade detection 1s to be computed This setting is almost always left to GAZE Saccade Sensitivity saccadeSensitivity Defines the sensitivity of the EyeLink II or EyeLink 1000 parser for saccade event generation Normal is intended for cognitive tasks like reading while High is intended for psychophysical tasks where small saccades must be detected Eye Tracking Eye tracking Mode eyeTrackingMode Select the tracking mode for recording EyeLink II runs either under a pupil CR corneal reflection mode or a pupil only mode EyeLink I only runs under a pupil only mode Eye tracking High Speed eyeTrackingHighSpeed Sets sampling rate in combination with the Eye tracking mode setting for EyeLink II trackers If set to true it will be 500 Hz in a pupil only recording and 250 Hz in a pupil CR mode This setting is only available for EyeLink H tracker SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 328 Pupil Detection pupilDetection Algorithm used to detect the pupil center position centroid algorithm vs ellipse fitting algorithm This option is only applicable to EyeLink 1000 trackers Eye tracking Sampling Rate ey
106. from the background color FAQ Images shown in Display Screen are surrounded by white dots Text Resource Anti aliasing and Transparency 14 Are you running the deployed version of the experiment FAQ Results file had disappeared when we cleaned the experiment project FAQ File disappears from the folder where it was stored when we got ready to run it 15 Do you randomize the datasource file for each subject Typically the datasource is attached to a TRIAL sequence not to a recording sequence FAQ How to modify the data source file to create different trial ordering FAQ What do I do with the randomized data source files Data Source Common Experiment Designs and Datasource Manipulations 16 Have you taken measures to maximize real time performance of the Display PC when running the experiment SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 322 17 Are you viewing your EDF files at the original file locations e Results Session Name directories If you need to analyze data on a different computer you may copy the entire Experiment Name folder to your data analysis computer To make the data transfer easier given so many files involved you may first zip up the Experiment Name folder keeping the directory structure and then unzip the file on your analysis computer FAQ No image is overlaid under the fixations in Data Viewer If this is a non EyeLink
107. if you keep sending the same TTL signal value This is rare but it does occur You might want to ensure the parallel port of your display computer is not in a bi directional mode in this mode the data register is used to read incoming signals and thus you are not able to send a signal from this register To turn off the bidirectional mode which 1s typically controlled through pin 5 of the control register you may add a SET_TTL action at the beginning of the experiment Set the Register to CONTROL Mode to Word and Data value to OxO 7 9 7 Adding to Experiment Log For the ease of experiment debugging messages can be written to a log file so that errors in the experiment programming can be detected early The ADD_TO_LOG action B allows the user to send one log message per call Reference Label Label of the ADD TO LOG action The default value is ADD _ TO LOG Type NR The type of Experiment Builder objects AddToExperimentLog the current node SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 81 a a ee a experiment graph Time time Float Display computer time in milliseconds from the start of the experiment when the action is processed Start Time StartTime Float Display computer time in milliseconds from nn ian the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues f S
108. in the middle of the experiment for example This message may also contain trial condition information so that the experimenter knows immediately which condition is being tested and therefore may be able to evaluate the performance of the participant For some experiments especially those involving a location trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 261 invisible boundary fixation saccade or fast velocity it might be helpful to draw some simple graphics on the tracker screen for feedback information with EL_ COMMAND action In a saccade experiment for example the user may draw a box on the tracker screen to show the target location EyeLink recording data EDF files can be conveniently analyzed with the Data Viewer application A set of messages can be written to the data file so that the Viewer can automate configurations for individual trials Examples of such messages include defining images and simple drawings to be used as background for overlay display specifying trial variables creating interest areas trial grouping and so on 11 1 TRIALID Message For the convenience of data analysis a trial ID message should be written to each trial so that the actual experiment condition under which the trial was conducted can be easily identified Although the user may send such a message via the SEND_MESSAGE action sending trial ID messages can be automated if the user utilizes the EyeLink
109. jiejteleleMe e Giren aaee which glimpses could be caught of the wide cool _ af Figure 8 10 Multiline Text Editor After a multi line resource is added to the screen double clicking at any empty place where there is no other resource on the work space will bring up the multi line resource editor The user can type in text in the editor or paste text from text files using shortcut keys CTRL V on Windows or Command V on Mac OS X Buttons on the toolbar of the text editor allow the user to modify the appearance of text entered This includes text font font size text style bold underline italic color line space alignment style margin of the text Note that the user may first set the right text appearance especially the font before entering text If the text has already been entered the user may select all by pressing shortcut keys CTRL A on Windows or Command 4 A on Mac OS X or part of the text entered before using the toolbar to change text appearance To change the font size of the selected text please make sure that you have pressed the ENTER key to register the change Please note that texts of the same font size will look smaller by a factor of about 1 33 on Mac OS X than on Windows due to different default DPI values used across the two operating systems The following table lists the properties of a multiline text resource Field Attribute Type Content Reference Label label String Label of the r
110. level with 1 0 being the maximum audio level The threshold should be set high enough to reject noise and prevent false triggering but low enough to trigger quickly on speech A threshold of 0 05 to 0 10 is typical Below belowThreshold Boolea Whether the voice key should trigger is the Threshold audio level is below the specified threshold level Triggered Data triggeredData If the voice key trigger fires the triggered data can be further accessed see the following table When the voicekey trigger fires the triggered data can be further accessed The sub attributes of the TriggeredData field are listed in the following table Time time Integer Display computer time in milliseconds from the start of the experiment when the voicekey trigger fires EDF Time EDFTime EDF time when the voicekey trigger fires Level level Float Returns the voicekey audio level in the Same units as the voicekey threshold when the voicekey trigger fires with 0 0 being silence and 1 0 being the maximum audio level The following discusses some of the common applications of the voice key trigger You may check out the HTML version of this document for the complete example project 7 10 12 1 How to calculate the voice key RT online Voicekey responses can be calculated online by using the UPDATE_ATTRIBUTE action You ll typically need to use a couple of variables to store the time of the voicekey trigger and time of the disp
111. list is SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 231 From File omFile n specified in a text file If enabled a text file must be added into the Movement Pattern tab of the library manager and selected either from dropdown list or from the attribute editor If this box is unchecked the user must added a list of resource positions to the movement pattern see the following table File Name fileName String Name of a text file that is used to specify the custom movement pattern Each of the individual resource position in the custom movement pattern has the following properties Field Attribute Type Content PN emee O FN Label of the resource position in the custom movement pattern The default label is Resource_Position The type of Experiment Builder object ResourcePosition the current item belongs to Screen Location Whether the locations specified refer to the Type top left corner or center of the resource This setting can be changed at Screen Preferences time Integer Time since the start of the sequence when the resource reaches the destination position of movement finishes of movement finishes reached to the specified position 8 3 Interest Areas Interest areas can be drawn on the Screen Builder workspace and recorded in EDF file for the ease of analysis with EyeLink Data Viewer The interest areas created in the Screen Builder will not be
112. n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Log File logMessage String Message to be written to the log file Message Log File NR String File to which the log message is written The default file name is Logfile If this field is left empty the message will be printed to command line or the output tab of Experiment Builder if test running the project In the following example Figure 7 14 the user adds a sample velocity trigger in the experiment and wants to check out whether the values of trigger e g left eye gaze position eye velocity and acceleration and trigger time are right when it fires The user may add an ADD_TO_LOG action following the sample_velocity trigger and set the Log File Message field of the action as SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 82 START Exptlog D START io RECORDING DISPLAY SCREEN DISPLAY _SCREEN ay EL_BUTTON SAMPLE_VELOCITY A DD To LOG SAMPLE VELOCITY Experiment Components Dewices Property Value abel 00 To LOG ADD_T
113. or Command and C keys on Mac OS X or select Copy from the popup menu to put a copy of a selection to the clipboard e Pasting a selection Press CTRL and V keys together or Command and V keys together on Mac OS X or click the right mouse button to bring up a popup menu and select Paste to insert the previously copied cut items from the clipboard to the current position SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 45 e Pasting a selection Multiple times Press CTRL and M or Command and M keys together on Mac OS X or select Paste Multiple from the popup menu This will bring up a dialog to let you specify the number of copies of the previously copied item from the clipboard to the current position e Undoing Pressing CTRL and Z or Command and Z on Mac OS X undoes the last action performed 7 2 Node Connection The flow of an experiment sequence moves from the default START node to one or several triggers or actions and then to other triggers or actions and so on This requires the designer to connect two experiment components with arrowed line to establish a directional or dependency relationship between a Source component and a Target component 7 2 1 Connection Create Cancel and Delete To make a connection from a Source component to a Target component place the mouse cursor on the Source component hold down the left mouse button without releasing the button as this constitute
114. pixels per visual degree along the x or y axis Gaze position of the triggering sample along the x axis for the left eye right eye and the average between the two Gaze position of the triggering sample along the y axis for the left eye right eye and the average between the two Left eye right eye or average pupil size in arbitrary units area or diameter Left eye right eye or average velocity in degrees second Left eye right eye or average acceleration in degrees second The angle of the eye movements when the trigger fires Distance between the target and camera 10 times the measurement in millimeters This option is for EyeLink Remote eye tracker only Returns MISSING_DATA 32768 if target is missing or if running a non Remote eye tracker X Y position of the target in camera coordinate This option is for EyeLink Remote eye tracker only Returns MISSING_DATA 32768 if target is missing or if running a non Remote eye tracker Flags used to indicate target tracking status 0 if target tracking is ok otherwise error code This option is for EyeLink Remote eye tracker only Returns MISSING_DATA 32768 if running a non Remote eye tracker 1 Returns MISSING_DATA 32768 for the untracked eye SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 178 The sample velocity trigger can be used when a saccade needs to be detected as quickly as possible so that a
115. recording is still ongoing e currentEyeTrackerTime value lt the Current Time field of the EyeLink device e currentDisplayPCTime value lt the Current Time field of the Display Device e dAudioRecordingStartlime value lt the Record Start Time attribute of the Record Sound action DISPLAY BLANK eof Attribute Yalue List for UPDATE_TIMES X Attribute a DcurrentE ye Tracker Time valued imparent parent parent EYELINE current Timem McurrentDisplayPCTime valued lpparent parent parent DISPLAY currentTine me TIMER_extra_recording 4udioRecordingStartTime value mMRECORD SOUND recordStart Timed Ddisplay onset Time valued fODTSPLAY IMAGE timed Please Set Attribute lease Set Value RECORD _ SOUND STOP Figure 7 66 Aligning audio recording times Please remember to send these new variables to the Trial condition variable list the EyeLink DV Variable list of the topmost experiment node Once you have collected the data open the EDF file Please note that all of the eye movement measures are reported relative to the start of the trial if no interest period is defined or a non RT period is defined or to the start of the reaction time period if an RT definition is applied The O point for the eye recording in a trial will be TRIAL_START_TIME So the EDF file eye tracker time for the start of a fixation will be CURRENT_FIX_START TRIAL_START_TIME The onset the audio recor
116. setting of the text or multi line text resource If the above word based interest areas are not satisfactory or you plan to use an image resources to show the text you may instead assign a text file to the Interest Area Set Name field of the DISPLAY SCREEN action that contains the screen resource Leave the rest interest area related work to EyeLink Data Viewer SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 323 FAQ How can I create individual interest areas for every single image in the EB If this is an experiment with eye based triggers 1 Have you checked out the location type used in the screen editor Please note that screen resources can be either top left based or center based whereas the location type of all trigger types e g invisible boundary trigger mouse trigger fixation trigger saccade trigger and sample velocity trigger is top left based 2 If you are running a saccade experiment which saccade trigger type saccade trigger vs sample velocity trigger should be used 3 If you are using an invisible boundary trigger or sample velocity trigger is heuristic filter set to a desired setting If this is an experiment involving audio playback or recording 1 Do you plan to use ASIO or DirectX driver FAQ Example for synchronized audio video presentation 2 If you are using ASIO driver have you followed the instructions for Experiment Builder ASIO Installation FAQ Empty
117. should be saved Enter the name for the session in the Project Name edit box Click on the button on the right end of the Project Location to browse to the directory where the experiment files should be saved if you are manually entering the Project Location field please make sure that the intended directory already exists In both cases please make sure you have the writing permission at the selected directory If your intended project is an EyeLink experiment make sure to check the EyeLink Experiment box and choose the appropriate tracker version from the dropdown list SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 18 Note The experiment session name must start with a letter between a and z or A and Z and may contain letters digits and the underscore character If there is any space in the filename this will be replaced by an underscore An Invalid Value or invalid label format error dialog box will be displayed if the format of session label is invalid eos Mew Project x Project Marne Test Project Location E EB Projects aes J EyeLink Experiment OR Cancel Figure 4 2 Dialog for Creating a New Project After the experiment is generated the following files and folders are created Experiment datasets library audio ustom Lass images interestAreaSet video myfiles runtime dataviewer
118. the participants In addition we may need to draw simple graphics onto the host screen so that the participants gaze accuracy during recording can be evaluated SF Besteri Gaperticent Badiber y LALA RE Simpe SSS olf x Fis Edt View Experiment Help oeaee oi De Oe Blt a Ere Shr al v QGgagaa F F eia xp m I vINCTIME 2 Enter SYNCTIME j pence i in the message field i BLOCK F i ia stam Seo input Queues F Select the Display screen p DePLAY _ScREEN a g gD KEY BOARD iy EL BUTTON i lt i THER Bocigr und Coia 3 Pi py CAMERA SETUP Per F TER fF ELBUTTON ad ts a o Generate Syrc h E i gt 3 E PREPARE SEQUENCE ner L ae k r C orFT_coRnRecT an z k J f RECORDING alr 3 res f GF START is ec i f DISPLAY _BLANI pager fled Cay S Maea sores z B TRPA Estimated Prepare Time Greeti el al ormie i gy EL BUTTON TT iadi H say Blank a Lipoiste Screen Send EyeLrw Dv Mess FF 3 These two fields should be checked For Hon Display Ef teegaa Sel Nene z i ar Espar mare Camparents Devore single bo are gt gt _ mm ma recon Figure 14 12 Modifying the Properties of DISPLAY_SCREEN Action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 290 1 Click on the DISPLAY_SCREEN node In the property window of the action double click on the value field of Message property Type in SYNCTIME and then press ENTER key
119. the Display Screen action nor will be displayed in the Screen Builder editor 8 4 Resource Operations The current section lists miscellaneous operations for adjusting the appearance of display screen and the layout of resource components 8 4 1 Resource Editing Similar to triggers and actions the following operations can be applied to screen resources interest areas and movement patterns cut F5 copy paste 8 and delete m using either application menubar toolbar or popup menu 8 4 2 Resource Alignments The position of resources and interest areas can be adjusted with alignment buttons on the Screen Builder toolbar see Figure 8 18 The user needs to select the target resource or interest area and then click on one of the alignment tool buttons Horizontal alignment buttons determine the relative position of a resource or interest area on the horizontal dimension left aligned right aligned or centered For example if a resource is left aligned the x coordinate of the left edge will be set as 0 The vertical alignment buttons can be used to adjust the resource or interest area position relative to the top and bottom margins top aligned bottom aligned or centered The resource and interest area SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 237 alignment can also be done from the popup menu invoked by a click on the right mouse button S S 8 ah lel Figure 8 18 Resource Alignment
120. the experiment an actually executed version of the data source will be saved in the results directory 9 6 2 External Randomization For experiments created with Experiment Builder you may rely on the Experiment Builder GUI to Build and Test Run the experiment to make sure everything is fine Don t use Experiment gt Test Run to collect experiment data Once you are happy with the experiment you can now Deploy the experiment to a new directory by clicking Experiment gt Deploy This will create a new experiment name exe file in the intended deploy directory There you will also find a datasets directory Do randomization on the data source file and put the randomized copies in that directory SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 252 Important Please note that when a project is rebuilt by clicking Experiment gt Build or Experiment gt Test Run all of the files in the datasets directory will be deleted So please make sure that you have backed up those files in a different folder for example in myfiles directory before rebuilding the project On Windows the external randomizer RandomizerW exe is located at Windows Drive Program Files SR Research Experiment Builder Randomizer There is also an accompanying document Randomizer chm on how to perform randomization On Mac OS X the randomizer app is located at Applications ExperimentBuilder folder The user may also
121. the initial value of a variable to a plausible value to avoid build time error For example e Ifthe user wants to use a variable to store the temporary value of the image file name the initial value of the variable should be set to the name of one image resource in the image library instead to an arbitrary string like abc e Default value needs to be a valid value for equation use For example if a variable is used as the divisor in a division operation make sure that the initial value of the divisor is non zero To clear a non string value eg 3 set in the value attribute of a variable the user may first set the value to some string e g hello and then clear it 7 11 2 Result File In addition to the EyeLink EDF file the user can also create her his own output file This is especially the case for non EyeLink experiments Result file HEL working together with the ADD_RESULT action is used to record experiment data It provides a columnar output of selected variables Each row of the file represents a call of the ADD_RESULT action Similar to the above mentioned Variable object a Result File object should be used without connecting to any other item in a graph Field Attribute Type Content Reference Label of the RESULT FILE object The default SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 189 po value is RESULTS_PILE S S Type The type of Experiment Builda objects gt o R
122. the subject s eye position is within the triggering region or the programmer can debug the experimemnt code by running the eye tracker in the mouse simulation mode This can be done by using an EyeLink_Command action before the recording sequence immediately after the PREPARE _ SEQUENCE or as the first node in the recording sequence so that the drawing is overlaid on top of the existing host graphics The drawing command can be either a draw_box or draw_filled_box The Text of the command should inform the tracker of the top left right and bottom pixel position of the triggering region as well as the drawing color This can be done either with string concatenation or string formatting The topleft corner of the triggering region is SAMPLE_VELOCITY regionLocation x SAMPLE_VELOCITY regionLocation y and the bottom right corner of the triggering region is SAMPLE_VELOCITY regionLocation x SAMPLE_VELOCITY regionWidth SAMPLE_VELOCITY regionLocation y SAMPLE_VELOCITY regionHeight String Concatenation str SAMPLE_VELOCITY regionLocation x str SAMPLE_VELOCITY regionLocation y str SAMPLE_VELOCITY regionLocation x SAMPLE_VELOCITY regionWidth str SAMPLE_VELOCITY regionLocation y SAMPLE_VELOCITY regionHeight 3 String Formatting d d d d 3 SAMPLE_VELOCITY regionLocation x SAMPLE_VELOCITY regionLocation y SR Research Experiment Builder User
123. to a eel SCREEN 2 Select Trigger tab and add a display screen action gh KEYBOARD add a keyboard trigger hy BL BUTTON i DISPLayY_SCREEN amp KEYBOARD ar yia z5 EgBuTTON DUO TIMER 3 Add a EyeLink a3 an button tigger a 1O i i st j p s P i 4 Adda Timer Trigger Y EL CAMERA SETUP 5 Set the Timer SO 6 Add an EL_Camera_Setup Action BEQUENCE T Add a sequence Figure 14 6 Adding Instruction to Block Sequence 11 Click at any blank area in the work window Click the right mouse button and select Arrange Layout in the popup menu This will re arrange the nodes in an orderly fashion 12 Double click on the DISPLAY_SCREEN object in the work space not from the structure list until the Screen Builder interfaceis displayed in the Graph Editor Window 14 1 5 Creating Instruction Screen The user may want to provide instruction to the participants at the beginning of the experiment This can be done by creating an image file containing the experiment instructions and then using DISPLAY_SCREEN action to show the image The SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 284 instruction text can also be created with the multiline text resource In the current example we illustrate the use of multiline text resource SE he thEspeniment Buker y Lasso A Smale fe che ae Eeeet l oengeoj xasennaano on rer 9 amp QBEE 5 Bxpenmert BLOCH DSP
124. to a resource the position of the resource cannot be gaze or mouse contingent at the same time e Interest Area For static resources creating interest areas may make data analysis in the future easier Interest areas can be generated either manually or with the auto segmentation feature of the Screen Builder e Last but not least two location types can be used in the Screen Builder top left or center In the top left location type the Location attribute of the resource refers to the top left corner of the resource whereas in the center location type the Location attribute of the resource refers to the center of the resource The screen location type can be set from Preferences Screen gt Location Type The following sections describe the usage and properties of each resource type in detail 8 1 1 Image Resource In order to add an image resource onto a display screen the user should first make sure that images are loaded into the Experiment Builder library To add images into the image library click on Edit gt Library Manager from the application menu bar This will bring up a Library Manager dialog box Select the Image tab and click on the Add button to load in the desired images Note that multiple images can be selected from the dialog box and imported together on Windows On Mac OS X only a single image file SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 197 can be add
125. used RECTANGLE 0 ELLIPSE 1 or INTEREST AREA 2 Note that the INTEREST AREA option is only available when interest areas are defined in one of the display screens in the same recording sequence Region Location regionLocation Point Pixel coordinate of the top left corner of the Top Left trigger region in x y tuple The default value is 0 00 0 00 Note that the x y coordinate of the region location can be further referred as regionLocation x and regionLocation y respectively Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Region Width regionWidth Integer Width 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Region Height regionHeight Integer Height 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Interest Area NR The display screen on which target interest area Screen regions are located Note that this property is only available when the Region Type property is set to INTEREST AREA Interest Area NR Regions triggering region Note that this property is only available when the Region Type property is set to INTEREST AREA Within within Boolea If set to True default the trigger should fire
126. users for attribute references 7 6 Experiment Node Clicking on the topmost node of the structure list in the Project Explorer Window displays the properties of the experiment in the property panel Field Attribute T Dn Content Reference haihin of the Experiment EyeLink DV Clicking on the value field of this property will Variables bring up a dialog box so that the user can select variables and data source columns to be recorded in each trial as trial ID This attribute is only available in an EyeLink experiment SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 52 a ee ae i e the EyeLink Experiment setting of the Experiment Preference is enabled Time Out timeout Integer The maximum time in milliseconds the paren pie mee experiment should run If 0 the experiment will not time out created Last Modified lastModifiedD String Time and Date when the experiment was last Date ate modified Session Name sessionName String Name of the experiment session This is the string you input in the Session Name dialogbox when running the experiment License ID NR License ID of the dongle key Demo if the Experiment Builder software is unlicensed Save Messages T saveMessages Boolea Whether the messages associated with any n triggers or action should be logged This attribute is available in Non EyeLink Experiments only If enabled a message property will be avai
127. visible to the participants during recording To show interest areas on the workspace the Toggle Interest Area Visibility button should be clicked on the Screen Builder toolbar see Figure 8 15 In the Structure panel interest areas are listed under the Interest_Areas folder SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 232 Figure 8 15 Toggling Interest Area Visibility 8 3 1 Manually Creating an Interest Area SR Research Experiment Builder supports three types of interest areas rectangular elliptic or freeform The following sections illustrate the use of each type of interest areas o o Figure 8 16 Creating an Interest Area To create a rectangular interest area click on the Insert Rectangle Interest Area Region button L Place the mouse cursor in the workspace at the location intended for the top left corner of the interest area press the left mouse button drag the mouse cursor to the desired location intended for the bottom right corner of the interest area and then release the mouse button The precise location of the rectangular interest area can be edited in the property panel An elliptic interest area C can be created in a similar fashion A freeform interest area W can be created in the same way as a freeform resource 1s created see Section 8 1 9 8 3 1 1 Rectangular Elliptic Interest Area The following table lists the properties of a rectangula
128. you run your experiment with multiple keyboards you will now be asked to press the ENTER key on the intended keyboards in sequence so that Experiment Builder can can map the keyboards labelled in the Keyboard Device to the physical keyboard devices The experiment shall start after the keyboards and mice are identified 7 10 6 4 Disabling Re enabling the Windows Logo Keys It has been reported in the past that the Experiment Builder failed to lock the drawing surface because the participants accidentally pressed the Windows logo key when using the keyboard trigger To prevent this from happening users may disable the Windows logo keys http support microsoft com kb 181348 Download the windowskey zip file and unzip the files from the HTML version of this document e To disable the Windows logo keys select the disable_both_windows_keys reg file click on the right mouse button and select the Merge option Reboot the computer SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 145 e To re enable the Windows logo keys select the enable_back_windows_key reg file click on the right mouse button and select the Merge option Reboot the computer 7 10 7 Mouse Trigger A mouse trigger fires by pressing or releasing a pre specified mouse button As in the invisible boundary trigger the user may specify a particular region for mouse trigger to fire The mouse trigger can also be used to detect the location of
129. 0 384 and the third point has a time of 6000 and an end position of 800 384 This translates into two segments of movement The first segment moves from 512 384 to 100 384 when the sequence Starts the movement ends in 1000 milliseconds The second movement starts from time 1000 since the sequence starts and ends on time 6000 moving smoothly from position 100 384 to 800 384 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 229 H ResourcePoint F START DRIFT_CORRECT Fh SEQUENCE F START DISPLAY SCREEN Interest _Areas 3 Movement_Patterns EHA CUSTOM_PATTERN Resource Position resource Position 1 Resource Postion 2 ELLIPSE RESOURCE TIMER ype ResourcePostion essage Seond Position H ResourcePairt if START DRIFT_CORRECT Fb SEQUENCE 4 START DISPLAY _SCREEM Interest _Areas 4 Movement_Patterns EKA CUSTOM_PATTERN Resource Position a Resource Postion LC Resource Postion 2 ELLIPSE RESOURCE amp TIMER SSS Experiment Components Dewices pe ResourcePostion k Figure 8 13 Creating a Custom Movement Pattern e Alternatively the user can create a movement pattern file a tab delimited text file see the following example to specift the landmark points in a movement this is particularly useful when a large number of movement points have to be specified The movement pattern file should contain time integ
130. 011 SR Research Ltd 200 and height Please note that the clipping location is always top left based and the location is relative to the top left corner of the image 3 Ifimages are stretched to different dimensions the user should add two columns in the experiment data source to specify the desired image width and height After the sample image is added to the display the user should refer the width height clip width and clip height of the image to the two columns created in the data source See the PICTURE template for an example The user can also flexibly specify the alignment style of images The read only Screen Location Type attribute of the image resource indicates the current location coordinate type 1 The easiest way of displaying an image in the center of the screen is to first set the Location Type of Screen preferences to Center Position After the image is added to the display the user can then click on horizontal center alignment and vertical center alignment 2 buttons on the Screen Editor toolbar If the image is center aligned to a different position enter the desired coordinate value in the Location field of the image 2 If the top left corner of all images is aligned to a specific location x y the user should first set the screen location type preference to TopLeft Position After the image is added to the screen the user can then set the desired value in the Location field of the i
131. 16 8 8046624 this flip event also updates frame count and index number and associated frame time After that flip Experiment Builder processes frame number 32 and next frame to be flipped is frame 32 with the last flipped frame now set to 31 8 1 2 2 Video Frame Timing Experiment Builder decodes each frame of the video and attempts to present the frame at a desired time The desired display time for a frame is calculated as desired frame time video_start_time frameNumber 1000 0 frameRate where video_ start_time is the millisecond time that the first frame of the video was presented frameNumber is the number of the frame to be presented and frameRate is the number of frames to display per second For example assume the first frame of a video was presented at time T and the frame rate of the video is 30 frames per second The desired display time for frame 100 would therefore be T 3333 33 msec However the video frame will likely not be able to be presented at the exact time that is desired and will instead have an actual display time that is slightly different than the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 207 desired frame time Two main factors can influence the offset between the desired and actual display time for a video frame Interaction between the display s retrace rate and the video s frame rate Video frames can only be presented at intervals that are a multiple of the mo
132. 3 Click here to start 7 Rem THe datasource editoi 7 Set ais value aiam a e eny I 4 hersten Coun 4 2 Gell by taj Daia Source Daum 2 Ape 12 j Fiere Diona Lid fi fe Figure 14 9 Creating Data Set 1 Click on the last SEQUENCE node on the structure list to start 2 In the property table click on the value field of LABEL Set it to TRIAL 3 Click on the Data Source property to bring up Data Source Editor 4 Click on the Add Column button In the following dialog box type Trial without quotation marks in the Column Name editor box and set Column type as Number Click OK button to finish Click on the Add Column button again Set the Column Name as Word and Column type as String Click OK button to finish 5 Click on the Add Row button Enter 12 in the Number of Rows edit box to generate 12 rows of empty cells 6 Click on the empty cells of the table just generated Set the values of the Trial column as 1 2 3 4 5 6 7 8 9 10 11 and 12 For the word column enter the following strings One Two Three Four and Twelve 7 Click on the Split by value field Enter a value 4 This makes sure that only 4 trials are run in each block 8 Double click on the TRIAL sequence node in the structure list Click on Start node under it to continue 14 1 7 Editing Trial Sequence Preparing
133. 3 Usno Amer ig 2c 2s ca pemereneenceeemeen rion ero renee aye enews eye rene ee ee 116 Using an Invisible_boundary trigger eecccesccecceceeeeeseeeeeeeeeeeeeeeeees 121 Using invisible_boundary trigger with top left and center location types 123 Usine C OnditiOnal TASo E aseo 125 Displaying different instruction screens at the beginning of each block 126 Usines EyeLink Dutton ALS SOP ccia a a raai 129 Collecting EyeLink button response data sosssoooneeeessssssseeeersssssseseeeees 130 Checking EyeLink button response accuracy ccccecceeceesseeeeeeeeeeeeeeaes 130 Using EyeLink button trigger without ending a trial ce eeeeeeeeeeeees 131 Usine Cedrus Button tree sasien no wa ralutaahteiadien eis 135 Collecting Cedrus button response data nesesssooeeesssssssseeressssssseeeerees 136 Checking Cedrus button response accuracy ssseeeesssssssseeeeresssssseeeeees 136 Using Cedrus button trigger without ending a trial eeeeeeeeeeeeeeees 137 Using Key OO ard Tre Ser ercana E 140 Collecting keyboard response Gata viisccteterecijieiaiecsierisinaiaeientareedeisenntens 141 Checking keyboard response accuracy eeessssssseeeressssssseseeresssssseeeees 142 Using keyboard without ending a trial oo eecccccccccceceeeeeeeeeeeeeeeeeeeeeees 143 Installing SREB keyboard driver ssas c cicevesiaeiein let onaninl a 144 Click Continue Anyway on logo testing warning cecccesseeeeeeeeeeeeeeees 14
134. 4 4 10 Test running an Experiment from EB Applicaton seessssseeeeeeeereessssssssss 24 Att Deploy ime vdm Experiment oee a A R 29 4 12 Running an Experiment for Data Collection sseeesssssssoeessssssssseeresssssssseeeees 29 4 13 Conver ting Projects between Windows and Mac OS X ceccccccccccesseeeeeeeeees 21 5 Experiment Builder Graphical User Interface 0 0 0 ceccccccecceceeeeeeeeeeeeeeeeaaeeeeees 28 5 1 Project Explorer WINGO W 253 cusictasatsosncdbataregi nasa Gent E 28 5 2 Graph Editor WMdOW easan a a hes 31 5 3 Application Menu Bar and Too bar cc ceeccceeccccccccceeeeseeceeseeesaaeesseeeeeees 32 5 3 1 File Menu and Tool Buttons diccssssnssecsssdeeseenadsndspennsnadarsaasecusncverecencsecspendenadanys 32 322 Edt Venu and ool Butlons orses e EE 33 IDS VEW M Diore aaa E sel etn aoe acannon 34 5 3 4 Experiment Menu and Tool Buttons scmeccesiorwn recite haste tenets 34 Io FEP MICU saaa eee Sawin waa ert ae eS oes cae 34 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd i 6 Designing an Experiment in Experiment Builder cccccccccccccceccceeeeeeeeeeeeeeees 35 6 1 Hierarchical Organization of Experiments cccccccccsssseeseeeeeeeeeeaeeesseeeeeees 35 602 Expenme nt Graph Flow Diasram jecseicecctssasicstctetidiorede a 36 6 2 1 Adding Components to an Experiment sesessssoeeeesssssssseeerrsssssssseeressss 37 6 2 2 inking Expemment Component ecce
135. 4 2011 SR Research Ltd 161 Figure 7 58 Using TTL trigger 7 10 8 2 TTL trigger and the type of cable used The complication for receiving a TTL signal here is that you will need to determine the type of cable you are using e If you are using a straight through data cable pin 1 to pin 1 etc you need to read the data from the data register of the parallel port and enable the bidirectional mode for the port o Reboot the computer to go into the BIOS settings Select the settings for Parallel Port Mode and set the mode to either PS 2 EPP or Bidirectional Mode if it is not currently set so o Next you will need to enable the bidirectional mode for the parallel port If you use Experiment Builder this can be done by use a SET_TTL action at the very beginning of the experiment set the Register to CONTROL and set the value to 0x20 basically this toggles on pin 5 the bidirectional pin on the control register o Now you are using the bidirecitonal mode so the incoming TTL signal shall be checked with the data register Set the Register of the TTL trigger to DATA If you want to detect the arrival of signal you may simple choose the Pin mode and set all of the pin values to EITHER Remember to fill out the Message property of TTL trigger to mark the event time e If you are using a crossed parallel cable that reads the data through the status register of the parallel port o The parallel port can be set to any modes
136. 49 Line 050 Line 051 Line 052 Line 053 Line 054 Line O55 Line 056 Line 057 Line 058 Line 059 Line 060 Line 061 Line 062 Line 063 Line 064 Line 065 Line 066 Line 067 Line 068 Line 069 Line 070 SR Research Experiment Builder User Manual A read and write integer type property def setProperty 1 self c self property l c def getProperty 1 self return self property 1 Property property2 A read only property The type will be treated as a point EBPoint def getProperty2 self return self property2 def getProperty3 self return self property3 Callable method using Execute action Note the default arguments and the doc string to let eb know what is the expected return type def myMethod self parm1 parm2 100 1 1 1 param3 100 100 50 param4 50 75 param5 hi RETURN 1000 2000 3000 The first line of the doc of method is used to get the return type of the method return 1000 2000 3000 internal method def _myInternalMethod self pass Property property4 A read and write float type property def setProperty4 self c 5 7 self property4 c def getProperty4 self return self property4 Property property5 A read and write EBPoint type property def setProperty5 self c self property5 c def getProperty5 self return self property5 Property property6 A read and write EBColor type property def setProperty6 self c self p
137. 5 Using THEMOUSE TIO CCL esiseina reser aah ated nesiace saaadblnsaaseraah beh loners 150 Setting the MOUSE triggering region ceeeeeecccceccceesesesseeceeceeeeseeeseeeeeees 151 Using mouse trigger with top left and center location types 006 152 Collecting mouse Pes pOnSe dataserie e E E 153 Checking MOUSE response accuracy ssssseeeessssssseserrrsssssssserrrsssssseeeeeres 154 Using mouse trigger without ending a trial ccccccseseeeeeeeeeeeeeeeeeeeees 155 Installing SREB Mouse diVer menea EA s 156 Click Continue Anyway on logo testing warning esssssssoeereessssseeeeeees 157 Viewing mouse traces in the Data Viewer temporal graph view 158 Usne TILTI Em g a a metuceu sided 162 O TIX Oa CCF A E A E E A A 166 Using fixation trigger with top left and center location types 168 Using the Saccade th S98 6F cies sssaseaertecainuedaxedenstzastudetavaaerslasiieudaethenttzansutedss 172 Using saccade trigger with top left and center location types 0 174 sine Samiple velocity MISIE erin a sel sncacadustivoniasmexeunans 179 Using sample velocity trigger with top left and center location types 181 Collecting voicekey response data iccgatietecemiseartaiwiesinsioved seen acabinei tonne tsanas 184 Aligning audio recording times ssesssseoeeeessssseceressssssseccreesssssssecreessssss 185 Other Components Implemented in Experiment Buildet 00 1
138. 86 Si a Nc DIC e E eds 187 Properly Sctunes for Variables ekeen ipia a 188 Dynamic Data Type Casting iccssssvesciandimesunsustedaicndeneduestedsiandinaseesasadsiendennes 189 Usne Result Ee osere a elractarntaseo oma a ace iaedoeiseetanaceneietes 190 Setting Properties of the Result File Node noosssenennssssssssseeressssssseeeeees 191 USE CC UIA ALON er Son staaaen etnias ie ce aunts 192 Setting the Properties of Accumulator cc cecccccccccccessseseeecceeeeeeseeeneeeeees 193 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 1x Figure 7 75 Adding Data to and Retrieving Data from the Accumulator 194 Figure 8 1 Sample View of the Screen Builder Interface ceeeeeeeeeeeeeeeeees 196 Figure 8 2 Resources Implemented in Screen Builder cee ecccceenneeeeeeeeeeeeeeees 197 Figure 8 3 Loading Images into Image Library cece ccccccnsseeeeeeceeeeeeeaeaeeneeeeeees 198 Figure 8 4 Setting Different Location Types for Images Used in a Gaze Contingent Window A ppl Calis otiacc5 ccsidavarencareseiuedusnnos canes sau ianwhencasharutisdadeaet a aaa 202 Figure 8 5 Loading Video Clips into Video Library ccceececcccecceceeeeeeeeeeeeeeeeeeeees 204 Provure6 6 Setting U TE 6 Encoding coen E 213 Figure 8 7 Aliased and Antti aliased Texts cccccccccsssssscccecccceeeeeesseeeeceesesaaeeeneseeeess 214 Figure 8 8 Antialiasing Drawing Preference Setting ssesee
139. 8HS configuration dialog box see the figure below The arrows indicate the directions of the data flow that each pin is configured for if the arrow points towards the box that pin is used to receive signals if the arrow points away from the box that pin is used to send signals The following figure configures pins O to 7 for sending signals and pins 8 to 15 for receiving signals Digital Input Queue Size digitalInputQueueSize Sets the maximum number of TTL input events from the USB 1208 HS box that can be cached in the event queue Digital Event Count digitalEventCount Total number of TTL input events from the USB 1208 HS box that are cached in the event queue Current Value currentValue The current TTL value across all 16 pins PBOQOPGOPOOOOPOS f CDOOOCOGCCCCCCOOO LITET SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 343 17 1 10 Timer See section 7 10 1 Timer Trigger 17 1 11 Invisible Boundary See section 7 10 2 Invisible Boundary Trigger 17 1 12 Conditional See section 7 10 3 Conditional Trigger 17 1 13 EyeLink Button See section 7 10 4 EyeLink Button Trigger 17 1 14 Cedrus Input See section 7 10 5 Cedrus Button Trigger 17 1 15 Keyboard See section 7 10 6 Keyboard Trigger 17 1 16 Mouse See section 7 10 7 Mouse Trigger 17 1 17 TTL Trigger See section 7 10 8 TTL Trigger 17 1 18 Fixation See sectio
140. A msee Bomoa i Misible Hereen Index EBPointht DISPLay SCREEN RECTANGLE RESOURCE location xi M DISPL4Y SCREEN RECTANGLE RESOURCE width 2 Ecreen Location Type enter Location 14 132 oe i E SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 122 Figure 7 32 Using invisible_boundary trigger with top left and center location types 7 10 2 2 How to show the triggering region on the host PC Sometimes it is useful to draw feedback graphics on the Host PC so that the experimenter can monitor whether the subject s eye position is within the triggering region or the programmer can debug the experimemnt code by running the eye tracker in the mouse simulation mode This can be done by using an EyeLink_Command action before the recording sequence immediately after the PREPARE SEQUENCE or as the first node in the recording sequence so that the drawing is overlaid on top of the existing host graphics The drawing command can be either a draw_box or draw_filled_box The Text of the command should inform the tracker of the top left right and bottom pixel position of the triggering region as well as the drawing color This can be done either with string concatenation or string formatting The topleft corner of the triggering region is INVISIBLE_BOUNDARY regionLocation x INVISIBLE_BOUNDARY regionLocation y and the bottom right corner of the triggering region is INVISIBLE_BOUNDARY regionL
141. AUDIO_ON and REMOTE_WARNING_AUDIO_OFF are recorded to the EDF file to mark the time of the onset and offset of the audio Minimum Target Missing Duration targetMissingThreshold Minimum amount of time in milliseconds the target is missing before a warning beep will be given Target Missing Beep targetMissingBeep The audio clip to be played when the target is missing A different audio clip may be used if that clip has already been loaded into the library manager Edit gt Library Manager select the Sound tab Event Queue Size Experiment Builder maintains separate event queues for the eye based triggers The following sets the size of the event queue and reports the current event count in each queue Fixation Queue Size fixationQueueSize Sets the maximum number of fixation events FIXUPDATE STARTFIX or ENDFIX that can be cached in the fixation event queue Saccade Queue Size saccadeQueueSize Sets the maximum number of saccade events that can be cached in the saccade event queue Button Queue Size buttonQueueSiz Sets the maximum number of button events that can be cached in the button event queue Sample Queue Size sampleQueueSize Sets the maximum number of samples that can be cached in the link sample queue Fixation Event Count fixationEventCount The number of fixation events FIXUPDATE STARTFIX or ENDFIX cached in the fixation event queue Saccade Event Count saccadeEventCount Th
142. BOUNDARY Ey EL_BUTTON E TIMER H DISPLAY _SECOND 2 DISPLAY BLANK L_ amp TIMER_SECOND DISPLAY INITIAL INVISIBLE_BOUNDAR Experiment Components Devices Properties INVISIBLE BOUNDARY 5 ype Boundary DISPLAY SECOND Jade Path RECORDING INVISIBLE_B essage NV ISIBLE_BOUNDARY ime ast Checked Time TIMER_SECOND EL_BUTTON Contidence Interval Pas Region Direction 7 45 45 90 90 1355 a i Region Type ECTANGLE Region Location Top lett A00 364 Region Width i 50 bee Height Faq racking Eye inirrilrri Duration riggered Data Figure 7 31 Using an Invisible_boundary trigger Since the invisible boundary trigger keeps monitoring the online recording data this trigger type must be placed within a recording sequence 1 e the Record property of the sequence is checked If you see a This node type cannot be added to this sequence build time warning message please check whether the sequence to which the trigger belongs is a recording sequence The following discusses some of the common applications of the invisible boundary trigger 7 10 2 1 The location type of the invisble boundary trigger Please note that the location type of all trigger types invisible boundary trigger mouse trigger fixation trigger saccade trigger and sample velocity trigger is top left based whereas the screen resources can be either top left based or center based th
143. CEDRUS_INPUT is used in realtime Sequence RECORDING gt CEDRUS_INPUT message may be seen if the Cedrus input trigger is used in a Sequence with the Is Real Time option checked This warning means that the Cedrus trigger may not work when your sequence is running under the realtime mode this is especially the case if you are using an old display computer For most recent computers the Cedrus input along with mouse and keyboard will still run in the realtime mode so this message can be ignored Check the BIOS setting of your Display PC and make sure that the multi core or hyper threading setting is enabled for the proper functioning of the keyboard mouse or Cedrus triggers in a real time sequence Note Make sure you use the PREPARE SEQUENCE action before each iteration of the sequence in which the Cedrus input trigger is used the PREPARE SEQUENCE action is used to re establish the clock synchronization between the display computer and the built in timer on the Cedrus response box Failing to do so might result in a significant drift in the trigger time returned by the Cedrus box Field Attribute Type Content Reference Label of the Cedrus button trigger The default SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 132 value is CEDRUS INPUT rs Type NR The type of Experiment Builder objects ULL CedrusInput the current node belongs to The absolute path of the node in the experiment graph
144. Center Alignment E buttons to place the text in the center of the screen 6 Select the text resource on the work area click the right mouse button and select the Lock Selection option so that the resource will not be moved accidentally 15 9 Editing Trial Event Sequence Part 2 Following the presentation of the Stroop word participant s response should be checked and reaction time for he trial be calculated The following nodes see Figure 15 19 are added for checking for response and giving feedback on participant s performance SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 314 68 Beseanch Giperimen fudijer y 4 22080 Strip x mlj i Fie Edt hew Expert Help DeB g SXRART EA VTAHSB se aerai x QAe Baa Esperimenti BLOCK DEPLay_ SCREEN TRIAL TRUM DataSource TRIAL EVENT mocaTion_ocrmen paeLav sereen Paral a gt TRIAL EVENT G start 1 Click here to start l i p m ee Ae 2 Add two new variables p yaranar as BEEN X 3 Add Update Attribute action THE_OUT i gp SEY BOSRD INPUT i r CONDTORAL r SALA BLARE piit 4 alas ie an p 4 Adda conditional trigger to check response ARA ae Incorrect il Correct response iT NOORRE LT RESPONSE i A 1 r gt response ifcepect pesons a CORMECT RESPonse 5 Load audio clips ET CORRECT _FESPUNDE a Ng x xeY ete Propertie Ax CORREC
145. Creating a New Experiment Session Click on the Experiment Builder to start a new session When the application starts z a i a sa ee ya F5 TLO jsi iSA T Fe ika ehi Biak MERE Fis nm A X e TE Fia Edt ew Experiment Help af j 2 i 3 3 Open bled 3 Remmen 1 Click File gt New to start al Ura Fa Exit 2 Enter the session name Enget hame Er Pre F cai Proget Locair Ee _Proeecis gt Eyelid Experiment Evei 1 DH Cancel 3 Click here to save the project to the intended directory 4 Make sure that the EyeLink Experiment box is checked Figure 14 1 Creating a New Experiment Builder Session SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 278 1 Click on File New on the application menu bar 2 In the following New Project dialog box enter Simple in the Project Name edit box 3 Click on the button on the right end of the Project Location to browse to the directory where the experiment project should be saved If you are manually entering the Project Location field please make sure that the intended directory already exists 4 Make sure that EyeLink Experiment box is checked for an EyeLink experiment Please note that the user shouldn t manually add or remove files in the experiment directory To maintain file integrity for the experiment projects created any changes made to the
146. Current Frame currentFrameNu Integer The currently processed frame number This Number mber may not be the currently visible frame on the Current Frame Index looping mode this reports the relative frame position in a clip 1 e a number between and last frame of the video clip Next Frame nextFrameNumb Integer The index number of next frame to be flipped Number er shown SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 206 Number er shown on the screen Time actually shown Predicted time when the next frame is shown on Desired Time dTime the screen Reports the number of frames displayed non Count Count dropped frames Count ount Frames per second calculated as displayed frames duration played in msec 1000 FPS Float Duration into clip playing When the play ends the duration may report as displayedFRameCount 1 self frameRate ial 8 1 2 1 Reading Frame Time Experiment Builder can record the time of each frame in the EDF file For example if the user adds the following message to the message field of the display screen Display lt str selr VIDEO_RESOURCE lastkrameNnumber CRE str self VIDEO RESOURCE currentFrameNumber The EDF will contain output like MSG 8046616 8 Display 30 CRT 31 This shows that at the message time 8046616 the visible frame should be 30 last frame number Frame 31 appears at 80466
147. DF file in an EyeLink experiment when the sample velocity trigger fires Time time Float Display computer time in milliseconds from the start of the experiment when the trigger fires Note To check the time when the triggering sample occurs you should use triggeredData time instead This property can be used to retrieve the Time Display computer time in milliseconds from SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 175 pT orcas checked for the last time Confidence confidenceInterv Float Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time Region Type regionType String The type of triggering Region used RECTANGLE 0 ELLIPSE 1 or INTEREST AREA 2 Note that the INTEREST AREA option is only available when interest areas are defined in one of the display screens in the same recording sequence Region regionDirection List of A range of eye angles from a multiple selection Direction String list 0 45 45 90 90 135 135 180 180 135 135 90 90 45 45 0 used to restrict the direction in which the sample velocity trigger fires For each angle range the first value is inclusive and the second value is not inclusive ks 7 90
148. ECC aera neta rea E T i tunabetss 245 9 3 Importing Existing Files as Data Source i eececcccccccceeeseeseeeeceeeeeaeeeeeeeeeees 247 94 Usm Data Source File wet arcuae th scestu www eet Oaeiande at tdaern eae 248 9 5 PAS OIC Si o PUDY eii tages Sober inewor E EERE 249 06 DataSource RandommZau On ch io5inieceterisictseicheiecetindcas OA 249 9 61 Totemal RanGOmiZationvssstess ctssesieatveveieeediesanencexas TO 250 YO Randomization Sodeke sebeaeeenaelvateaea tees 250 POT BOC UNG irs cs tapeanaticac tea tan E E 251 9 6 1 3 Trial randomization and run length control cc cccecceecceesssseeeeeeeeees 231 DOA Randomizeon ROOVER E 232 9 6 5 lt Splttiie OM sii idareicncs iid ancien ahlstedsccarvalodanedetuateitaaenee 252 9 6 1 6 Running Experiment with Internal Randomizer cc ceeeeeeeeees 252 96 2 Erena RandomizI O eiaa het 232 1O BRETONO ooa T A ATE E T 255 101 Usma TREICLCN CCS onran EEE 255 10 gt terion Valie sarem a a eed 256 105 Entin RE eN ESen smagieeieemh cb ureuinia ph een ra euamebecthe 251 lOt Te Vn Eguin sia dat se races tan a N ale tics itauslea tetas 257 TO Retence Mando Cionn a Re oe a 259 11 EyeLmkO Data Viewer Inte erat On sninn RE as 261 ILL TRAED Ma eur ede wchiesh ied iaeneriesadeinaee teresa eet inanneresyels 262 11 2 lt IRECOPGING STATUS sassi E E E 262 WS MASS and neres VACA aee E e dadoudumcteadeedaies 263 E Bs TONE Fe hss a A E E E 265 123I Enabling Custom Class Option ieu
149. ECK_RESFONSE e Attribute parent parent TRIGL DataSource expected button aas Wale DBUTTON PRESSED valued SET_INCORRECT And Or Select SET_CORRECT pbu xev camper Value 2 Figure 7 37 Checking EyeLink button response accuracy 7 10 4 2 Collecting inputs from the EyeLink button box without ending the trial Sometimes the subject s button response should be recorded without ending the trial e g pressing a button whenever the subject detects a specific event in the video clip This can SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 130 be done by adding a NULL_ACTION node after the DISPLAY_SCREEN and having the EyeLink Button trigger branch looping back to the NULL_ACTION use an UPDATE_ATTRIBUTE action following the button trigger to collect response data All other triggers initially attached to the DISPLAY_SCREEN action should be connected from the NULL_ACTION as well If a TIMER trigger is used to end the trial the start time should be reset to the time of the DISPLAY SCREEN so that the start time of the TIMER trigger is not reset whenever a button is pressed DISPLAY _TASRGET ee lt Property a NULL_ACTION Rode Path BLOCK TRIAL RECORDING TIMER ooo essage timeout ime ast Checked Time Fontidence Interval Duration Type msecs Start Time DISPLAY TARGET time o DISPLAY BLANK p Duration O00 Mo A Elapsed Time Figure 7 38
150. ESOURCE height j z Regon Location Top Leh EEBPor EDISPLAY SCREEN RECTANGIE RESOURCE Recon With DISPLAY SCREEN RECTANGLE RESOURCE WANE Regon teitt DISPLAY SCREEN RECTANGLE RESOURCE Pete e Properties H e CRECTANGLE ES I Position is Gaze Contingent offset o Booo o rs rs ee jecaton BO mn o ew w a Property Value Ype RecktangleResaurce e Position is Gaze Contingent Position is Mouse Conting ost Outline Color a ovement Pattern Figure 7 51 Using mouse trigger with top left and center location types SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 152 7 10 7 3 Calculating response time of a mouse click Responses on the mouse device can be retrieved by using the UPDATE_ATTRIBUTE action Typically you may use a couple of variables to record which mouse button is pressed the time RT of the button press and the accuracy of the button press Specifically the button press should be retrieved as MOUSE triggeredData button the time of button press should be retrieved as MOUSE triggeredData time see the figure below With that you can calculate the response time BUTTON_PRESS_TIME value DISPLAY_ON_TIME value In case the trial can end without having the subject to press a button you may use the UPDATE_ATTRIBUTE at the beginning of the trial to reset the default values for the variables so that the response data from the previous trial will not be carri
151. Edit gt Preferences menu select Preferences gt Screen gt Built in Interest Area Preference gt GRID_SEGMENT The Auto Segment option will create a rectangular or elliptic interest area to contain each of the individual resources created on the screen The margins and shape of the interest areas can be set in the AUTO_SEGMENT preference settings An interest area created by Auto Segment option will be associated with the resource and its location width and height cannot be modified but referable These properties will be changed when resource s properties are changed For text resources you may apply Word Segment option from the popup menu This will create segments for individual words However the interest areas created will be Static in the sense that the same segments will be carried over to following trials even if the text materials have changed To create dynamic interest areas for text and multi line text resources you should check Use Runtime Word Segment Interest Area option from the resource property table see the figure below Note Interest areas created in this method will not be listed under the Interest_Areas folder of the Display Screen action nor will be displayed in the Screen Editor By default the automatic word segmentation is based on the space between words The users may choose other delimiter options For example to see whether the subject detects semantic anomaly in the sentence The autho
152. Experiment 1 2 3 Please consider the above issues 2 5 8 10 11 12 13 14 15 16 and the following two extra issues Are you using a result file If so have variables and datasource columns been added to the Columns field of the result file node Have you used an ADD_TO_RESULT_FILE action to record data to the result file Are you planning to write out debugging messages for the experiment If so check the Save Messages attribute of the Experiment node and fill the Message field of the triggers and actions If this is a reading experiment 1 2 3 4 5 6 If using a text or image resource has the Prebuild to Image box of the resource been enabled FAQ How to show the images in Data Viewer If using a text or multi line text resource have you enabled anti aliasing drawing Is the drift correction target displayed at the intended location FAQ How can I draw my own fixation cross and keep it stable at one point during drift correction and stimulus presentation Are you using non ASCII characters FAQ Warning 2001 You are using characters that ascii encoding cannot handle FAQ How can I import data file containing Umlauten characters Have you chosen the appropriate font style and size for the text or multi line text resource You may need to use special fonts to display non ASCII characters Have you enabled the Use Runtime Word Segment Interest Area
153. HS box on Mac OS X So the TTL device of a project created on the Windows version using the parallel port will be reset to USB 1208 HS Some of the fonts may be missing when converting from the other operating system Single line texts or multi line texts of the same font size will look smaller by a factor of about 1 33 on Mac OS X than on Windows due to different default DPI values used across the two operating systems Calibration control through external device is not supported SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 27 5 Experiment Builder Graphical User Interface The SR Research Experiment Builder uses a desktop framework that contains all windows of the application The following figure shows a typical graphical user interface GUI the experiment designer will see in an experiment generation session Besides the standard windows application menu bars and tool bars the experiment builder desktop can be divided into two major parts the Project Explorer Window on the left and the Graph Editor Window on the right The Project Explorer Window lists all of the experiment components in a hierarchical fashion and allows the designer to select components for review or modification The Graph Editor Window allows the designer to create the experiment graph by dragging individual building blocks and making connections between components to form experiment flow G EyeLink Experiment Builder 1 1 0 100 Beta Simpl
154. ING_DATA 32768 if target is missing or if running a non Remote eye tracker Target Flags targetFlags Integer Flags used to indicate target tracking status O if target tracking is ok otherwise error code This option is for EyeLink Remote eye tracker only Returns MISSING DATA 32768 if running a non Remote eye tracker Note Returns MISSING_DATA 32768 for the untracked eye 17 1 2 Display oo Preferences i af Preferences Experiment 2 Spm Devices eqD EVELINK ae c AUDIC me Refresh Rate MOUSE iq KEYBOARD aa Tr TTL Transparency Color SH CEDRUS Startup Background Color ae BUTTONBOX AC Nodes Min msec To Next Retrace E H Screen ideo Frame Cache Size 5 i Build Deploy Use video Decoding Thread ever Eh GUI Restore Factory Default Save Properties as Default Import From File Save Into File Width width The width of the display screen in pixels Height height The height of the display screen in pixels Bits Per Pixel bitsPerPixel The number of bits used to represent the luminance and chroma information contained in each pixel Refresh Rate refreshRate Sets the refresh rate Hz of the monitor Transparency Color transparencyColor The setting of transparency color for the display When you move or copy a Selection from an item any pixels in the selection that match the current background color are by default transpare
155. Install from a list or specific location Advanced On the Please choose your search and installation options screen select the Search for the best driver in these locations check the Include this location in the search option only and browse to C Program Files SR Research 3rdparty usb1208hs or C Program Files x86 SR Research 3rdparty usb1208hs folder Reference Type le The type of Experiment Builder objects SetT TL the current node belongs to experiment graph Message to be written to EDF file when sending the TTL signal This attribute is only available in an EyeLink experiment Time time Float Display computer time in milliseconds from the start of the experiment when TTL signal is sent Display computer time in milliseconds from the start of the experiment when sending TTL signal begins Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Device device String Which device parallel port or USB 1208 HS is used to s
156. L action requires proper identification of the base address of the parallel port This can be done through the Device Manager in Windows on Windows XP click Start gt Control Panel gt System In the System Properties dialog select the Hardware tab and click Device Manager button In the Device Manager list find the entry for the parallel port device under Ports COM amp LPT if you use PCI PCI SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 79 Express or PCMCIA version of the parallel port adapter card you ll need to install a driver for the port before it 1s correctly recognized by Windows Click on the port and select the Resources in the properties table This should list the I O address of the card For the built in LPT1 of desktop and laptop computers this is typically 0378 037F hex value Once you have found out the parallel port address open the Experiment Builder project go to the TTL Device setting enter the hex value for the TTL port reported by the device manager e g 0x378 for 0378 you see in the device manager The other support device is the USB 1208HS box from measurement computing This can be used on both Windows and Mac OS X A driver installation is required on Windows First connect the box to the Windows PC When asked Can Windows connect to Windows Update to search for software choose No not this time When asked what do you want the Wizard to do choose
157. LAY_SCREEN ae Lmz DoAVooY 7 BB 8 8 8 amp eb 1 Click on the Multiline text resource 2 Click anywhere in the work space to start the multiline text resource editor Figure 14 7 Adding Multiline Text Resource onto a Display Screen 1 Click on the multiline text resource A button on the screen builder toolbar to select the type of resource to be added 2 Click anywhere on the screen SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 285 E Milt ine Test Resource Lis eal 4 Select the Desired Text Appearance 5 Click Here to Finish Ve are going to perform camera setup and calibration When vou see the following blank screen 1 Enter the Instruction Text ee 4 3 Click Margins 2 Select Text by Pressing CTRL A Margins Button to Set Text Top Margin a0 Margin Press ENTER ke ans camqne en fioo Lert Margir hao Press C Key to perform calibration r lf you have finished reading the above instruction press an yboard or any button on the EyeLink button box to continue Figure 14 8 Create Instruction Screen In the following Multiline Text Resource Editor 1 2 3 4 5 Enter the instruction text Press CTRL A on Windows Command A on Mac OS X to select all text entered Click the Margins button box to set the text margins Enter 100 in all fields Click the OK button on the dialog box Make sure that th
158. LAY_SOUND action for details Note that this field is only available when the ASIO driver is used to play sound clips see Audio Driver setting in the Audio Devices of the structure Panel The following figure illustrates a simple experiment trial by displaying a screen and then waiting for a button response from the participant or the sequence ends after a pre specified amount of time set in the TIMER trigger For the ease of data analysis reaction time calculation for example the user should record an EyeLink message to the EDF file when the display is presented This can be done by entering a text message on the Message field or by having Auto Generate Sync Message box checked In a trial with multiple display screens each of the display screen action should send a unique Data Viewer integration message In a recording sequence the user may enable the Use for Host Display button if this is the primary display of the trial for gaze accuracy monitoring and add a PREPARE SEQUENCE action before the recording sequence with its Draw to EyeLink Host field enabled SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 62 START Movement_Patterns TEXT RESOURCE al DISPLAY BLANK DISPLAY SCREEN Experiment Components Dewices abel DISPLAY SCREEN Hode Fath BLOCK TRIAL RECORDING DISP sw eee o e Brora e i e e SO wacom SO p ra Ooo JE bin mh m al Mee T Leh i
159. Link experiment or if the sequence is already contained within a recording sequence If the Record button field allows the user to send a text message to be displayed at the bottom of the tracker screen so that the experimenter can be informed of the progress of experiment testing Recording Pause Time controls the delay in the execution of sequence following the choose the intended dataset file If unchecked it Callback NR of time to finish will result in a build time error error 2028 No Recording sequence found To is checked the user will see additional properties EyeLink Record Status Message start of the tracker recording SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 56 Some nodes can only be used in a recording sequence For example all eye based triggers such as invisible boundary trigger fixation trigger saccade trigger and sample velocity trigger should be only used in a recording sequence However some other node types such as drift correction and camera setup actions cannot be used in a recording sequence To maximize real time performance in data collection the user should have the Is Real Time box checked and include a prepare sequence action before executing the sequence The following figure illustrates the use of sequences in one experiment In this example a RECORDING sequence that performs the actual eye tracker recording is nested within a TRIAL sequence which is contain
160. Manual 2004 2011 SR Research Ltd 181 SAMPLE_VELOCITY regionLocation x SAMPLE_VELOCITY regionWidth SAMPLE_VELOCITY regionLocation y SAMPLE_VELOCITY regionHeight All of the drawing commands are documented in the COMMANDS INI file under C AEYELINK2 EXE or C ELCL EXE directory of the host partition See the change template for an example 7 10 12 ASIO Voicekey Trigger Note this section is only applicable to the Windows version with a recommended ASIO sound card Voicekey trigger is not supported on Mac OS X Voicekey trigger A fires when the ASIO input exceeds a pre specified threshold Note that this trigger type only works in experiments with ASIO compatible sound card and the Audio devices set to the ASIO driver It must be realized that a voice key will typically respond to the voiced parts of vowels and some consonants and therefore will not accurately measure the onset time of words For this purpose the user may use some other audio editing tools to analyze the recorded audio The voice key is most useful in detecting that a subject has made a response for the purpose of ending trials Reference Label label Label of the voice key trigger The default value Sally haul Ge The type of Experiment Builder objects VoiceKey the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with
161. Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the cedrus input trigger fires Time time Float Display computer time in milliseconds from the start of the experiment when the trigger fires Note To check the time when the Cedrus input was received you should use triggeredData time instead Last Check lastCheckTime Float This property can be used to retrieve the Time Display computer time in milliseconds from Node Path the start of the experiment when the trigger was checked for the last time Confidence confidenceInterv Float Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time Clear Input clearInputQueu Boolea Cedrus Input trigger maintains an event Queue e n queue so that mutliple Cedrus input events can be accessed over time The current option checks whether the Cedrus event s cached in the event queue should be cleared when the trigger fires NO no event clearing Event removes the current triggering event from the Cedrus event queue LIST all Cedrus events from event queue will be removed Triggered Data triggeredData Data of the trigg
162. NOOAY OO MN ala aalma mb Buck did not read the newspapers or he would have known that trouble was brewing not alone for himself but for every tide water Structure f dog strong of muscle and with warm long hair from Puget Sound to iF START aieas San Diego Because men groping in the Arctic darkness had found Haa RECORDING F start a yellow metal and because steamship and transportation companies EHE DISPLAY _SCREEN l i pee were booming the find thousands of men were rushing into the Movement_Patterns Northland These men wanted dogs and the dogs they wanted were ELLIPSE_RESOURCE Be Pee heavy dogs with strong muscles by which to toil and furry coats to EHE DISPLAY_BLANK 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 half hidden among the trees through which glimpses could be caught of the wide cool veranda that ran around its four sides Position is Gaze Cort Position is Mouse Co M Track BLOCK TRIAL RECORDING Figure 8 1 Sample View of the Screen Builder Interface SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 196 8 1 Resources Resources are the individual graphic drawings e g image text line etc to be displayed on the screen Currently the following lis
163. O Recycle Daa Cine arron r ia bakes tnasinens teats 346 VV EXC CUUG nonea E een sadinetnenctees 346 Fera NUP INCU the eeiiuesgtrraseas cshiotarausioleGagdn aah oes cg gine edo wee ees 346 17a JResponsePixx LED CONTO erea E 346 AT A a O a A Omen 346 KeA S Reut EIC care a a a 346 2 Smt gt E ea eh Ree era A E E 346 Pa ESS Acs E Meet ene tery Nee nt amr E A E tn er mmr E Neat tre E RA 346 Wee NASCAR CS OU C Cena ct salar ci a eck talee Ge orate ewe eeiahet 347 1723 NIJO RESOURCE esate ania ete cin ance eee eagles 347 Dec TCR OU O e E aa viabuneee 347 A29 Muline Text RESOU crane E 347 120 Line RESOU O asiinucaoniieird nii E 347 Dist Recnnele Resour O srsina A 347 17S EMPe RESOU Cins R E E tener 347 29 ane e RE OU E aesa T 347 172109 Freeform Reso Gnana enue a a E N 347 LL Sme Pale menh E on ttewialvanadaahmies 347 17212 AdS emen AON a A a 348 AD AOS omenan an A R 348 I 24 Word Sesmentation esii enaena a a 349 73 Buld DeplO Visserie e 350 UE CUa aaa eves eee eee 351 ZA aE Ea O ea wera em pare er rr rem were wer sr tent moran rane ay Tt errr nt 352 FA Custom LASS Edo ennaa eee ie bed a nos eet 353 13 Revision Histo se itot vor sortie soe hous laa wae aor Tieton wane ea nae 354 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd vii List of Figures MOUS Are Be IV CANN tra tee cee en Seca a cece oat aati oat ocalt nese eae eames 18 Figure 4 2 Dialog for Creating a New Project cccceccccccccecccceeee
164. ONAL trigger to INCORRECT_RESPONSE d from INCORRECT RESPONSE to INCORRECT SOUND e from INCORRECT_SOUND to TIMER _SOUND f from the right branch of the CONDITIONAL trigger to CORRECT_RESPONSE g from CORRECT_RESPONSE to CORRECT_SOUND h from CORRECT SOUND to TIMER SOUND 1 from TIMER _SOUND to ADD_TO_RESULTS_FILE 10 Click at any blank area in the work space then click the right mouse button Select Arrange Layout in the popup menu to re arrange the nodes in an orderly fashion 15 10 Outputting Data to the Result File Finally variables should be added to the result file see Figure 15 23 i Research ieperinient Melder v Laden reap alfj x ASeBBe SKXRGBART BEB VAN Bitar el r QDeabsa a ervi 61 Experiment Lock oisPLav aomen miar Tiai Datatource tran event FoceTiON screen naeta sereen OANA RESULTS_FILE a tite EE Soop A START E BLOCK UF Start H belay SCREEN a e Gy KEV BCMAD atts TRL i start j E TRAL NOEK i KEWPRESS J Select Variabbes for Chutqut A x RESPONSE i m ie UPDATE ATTRIBUTE 2 PREPARE SEQUENCE iia TRIAL_EVENT 1 Click here to start 2 Select the result file 4 Select variables ae and click Add _ Mb button q fener T PECTED Cup A ELA r eT TIAL _ADEH EVORESS Sene RESPONSE E RESPOMEE TME Laba RESULTS FLE fi Prsa se Moc
165. OUSE_2 used for response This option will only be available if Enable Multiple Input option is enabled Press Events t _pressEvents Boolea Whether the trigger should fire when a button n press event occurs This is set to True box checked by default n Release Events T releaseEvents Whether the trigger should fire when a button release event occurs This is set to True by default Position positionTriggere Boolea This provides the specific region in which the Triggered T d n mouse must be in before a press or release event is registered as a response If this field is not checked then the mouse trigger will fire with a click event on any part of the screen If this field is checked while neither the Press Events nor Release Events field is checked the mouse trigger will fire when the mouse is placed over the specified region without a press or release event 1 e a mouseover event Region regionDirection Listof A range of eye angles from a multiple selection Direction String list 0 45 45 90 90 135 135 180 180 135 135 90 90 45 45 0 used to restrict the direction in which the mouse trigger fires For each angle range the first value is inclusive and the second value is not inclusive SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 147 ER pan Region Type regionType String The type of triggering Region
166. O_LOG Tine BtertTme og File Message Trigger strs AM A B Figure 7 16 Using Add to Experiment Log Action Trigger str SAMPLE VELOCITY triggeredData EDFTime LOC str SAMPLE VELOCITY triggeredData leftGazex str SAMPLE_ VELOCITY triggeredData leftGazeY VEL str SAMPLE_ VELOCITY triggeredData leftVelocity VY ACLOOQ 4 str SAMPLE_VELOCITY triggeredData leftAcceleration G z The following is one sample output from the LogFile txt file when the sample velocity trigger fires Trigger 9o2017 LOC 9004499967793 403399993890 VEL 190 4L027908 ACLIOO0 938370 5273 123 7 9 8 Updating Attribute The UPDATE_ATTRIBUTE action Or modifies the value of a variable or an attribute of an experiment component For example in a change detection experiment See section 7 11 1 Variable the user may want to display two slightly different images for a certain number of cycles and then stop the presentation after that To do that the user may create a new variable to keep track of the current iteration status behaving as a counter and use the UPDATE_ATTRIBUTE action to update the counters value on each cycle of the graph Field Attribute Type Content Reference Label label String Label of the UPDATE_ATTRIBUTE action The default value is UPDATE_ATTRIBUTE SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 83 The type of Experiment Builder object
167. OutlineColor show the position and dimension of the current screen is contained in a recording sequence IMPORTANT If this attribute is False the run time drawing may not look exactly as it does in the screen editor Use Software useSoftwareSurf Boolea If false unchecked memory on the video card ace n is used to hold the resource blitting from the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 221 Surface T video card memory to the display surface is fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface hens Color Color in which the outline 1s drawn The default color is medium gray 128 128 128 Filled hl Boolea Whether the interior of the resource should be n filled If not this just draws a framed ellipse This is True by default Fill Color fillColor Color Color in which the interior of the ellipse is mom fee filled The default color is medium gray 128 128 128 Specifies the width 1 by default of the pen in pixels 8 1 8 Triangle Resource The triangle resource can be used to create an isosceles triangle to create other types of triangle use the freeform resource instead To create a triangle resource on the screen click on the Draw Triangle Resource button A on the toolbar Place the mouse cursor in the screen builder workspace click down the left mouse butt
168. PCMCIA sound card discontinued by manufacturer omleaddvconimedtynantictay nf PP sound card discontinued by manufacturer Creative Labs Sound Blaster Audigy 2 ZS Supported No PEE sound card discontinued by manufacturer Creative Labs Sound Blaster Audigy 2 Platinum Supported SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 8 Ex P T Creative Labs Sound Blaster X Fi XtremeGamer Supported Supported Yes Yes PCI a sound card discontinued by manufacturer Creative Labs Sound Blaster X Fi XtremeGamer Supported Supported Yes Yes PCI ada sound card discontinued by manufacturer Creative Labs Sound Blaster X Fi XtremeMusic Supported Supported Yes Yes PCI a a sound card discontinued by manufacturer Express Model SBO880 Express Fatality Pro PCI Express Model SB0886 PO M Audio Fast Track Pro 4 x 4 Mobile USB Supported supported USB Audio Interface It s our understanding that performance of a USB based sound card can be influenced by the presence of other USB and wireless devices etc in addition to the buffer latency settings on the card So if your display E can use PCI or PCI Express sound cards aan use nn sound _ a of the ee one The following cards are NOT supported 32 bit 64 bit Play Record aE aN foe eae o Ceased NNT F ML APPO L CA a a supported supported supported PCI Express supported supported Express For details on A
169. PD Y StartPPD Y or fixation update event starts in screen pixels per visual degree PPD End PPD X End endPPDX Float Angular x y resolution when triggering fixation PPD Y endPPDY W or fixation update event ends in screen pixels per visual degree PPD Note 32768 if the eye event is set to STARTFIXATION The fixation trigger can be used to monitor the subject s fixation behavior online For example the user wants to end a display after the participant looks at the target region for a couple hundred of milliseconds the Event Type may be configured as UPDATEFIXATION SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 165 fo RECORDING iF START DISPLAY _SCREEN Interest_Areas Movement_Patterns C RECTANGLE RESOURCE BLANK_SCREEN Experi ment Components Dewices e Property Value Type imation Mode Path ECORDING FIXATION Bssage MATION Tire Last Checked Time Confidence Interval a lear Input Queue Region Location Top Lett DISFLAY_ SCREEN RECTANGLE_RESOU ike anni AA E raat Region Height DISPLAY_SCREEN RECTANGLE RESO hin mi racking Eye DISPLAY_SCREEN RECTANGLE_RESOURCE height anos Event Type PDATEFIMATION riqgered Data Figure 7 59 Using fixation trigger If the fixation trigger should fire regardless where the participant is fixating at the user may set the trigger region as the whole sc
170. Randomization Data Collection Data Analysis 2 1 Experiment Design While the Experiment Builder simplifies many of the tasks required for creating an experiment a good understanding of experiment design e g blocking counterbalancing factorial design etc and experience with the EyeLink system makes initial use of Experiment Builder easier In the stage of experiment design the user needs to do the following 1 2 Conceptualizing the Experiment The user should have a clear concept of the experiment before creating it State clearly what variables should be manipulated in the experiment Within each trial how is the display presented a static display or a dynamic display Can the same display presentation routine be used across all conditions or a different routine should be created for each of the experiment condition This allows the user to contemplate all of the possible trial types in the experiment design conditional branching if necessary and create a data source for filling trial parameters Once this is done study one or more sample experiments we supplied before creating your own project Creating a New Experiment Session Start the Experiment Builder application and create a new experiment session Please read Chapter 4 Working with Files for details on experiment creation and file folder management 3 Adding Experiment Building Blocks to the Graph To schedule an array of events in an experiment the us
171. Reference Label of the SEND_COMMAND action The default value is EL_COMMAND Type NR The type of Experiment Builder objects EyeLinkCommand the current node belongs to experiment graph Time time Float Display computer time in milliseconds from the start of the experiment when the SEND COMMAND action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Command command String The command used to configure or control the EyeLink tracker For a complete list of commands and current tracker configuration examine the INI files in the EyeLink directory of the eye tracker computer Text text String The parameters to be passed along with the command priority Boolea If enabled causes the command to be executed n with the highest priority This priority is even higher than the output of an
172. Resource button OY on the toolbar and place the mouse cursor at the intended position for the first vertex in the Screen Builder workspace and click the left mouse button Next click on the position for the second vertex and do the same for the rest To end drawing simply press the Enter key so that the last vertex can be connected back to the first one To create a curved polygon the user can simply drag the mouse cursor along the intended shape until the shape is closed To move a freeform resource on the screen as described in the previous sections the user should simply select the resource and drag it to a desired location To adjust the position of individual vertices select the resource and place the mouse cursor on top of the intended vertex until the shape of the mouse cursor changes to one of the resizing cursors e g i Then hold down the left mouse button and drag the vertex until it is placed at the desired location The appearance frame color interior color of the freeform resource can also be adjusted If the Filled attribute is set to true the interior of the freeform resource will be filled with the filling color otherwise only the frames of the resource will be drawn while the filling color will be ignored Reference FREEFORM RESOURCE Type The type of screen resource FreehandResource the current item belongs to _ ai Whether the resource should be visible It is True by def
173. SIO sound card selection and installation please see section Installation gt System Requirements gt ASIO Card Installation in the html version of this document This can be accessed by pressing F1 or clicking Help gt Content when running Experiment Builder software or downloaded from https www sr support com forums showthread php t 99 Version 1 6 1 has updated the ASIO Sound Card Installation section of the user manual Existing users of the following sound cards should re check the installation steps to select the Audio Creation Mode and enable Bit Matched Playback option even if you have already had the sound card working with the software e Creative Labs Soundblaster X Fi XtremeGamer e Creative Labs Soundblaster X Fi XtremeMusic e Creative Labs Soundblaster X Fi Titanium PCI Express e Creative Labs Sound Blaster X Fi Titanium Fatallty Pro PCI Express SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 9 E Audio Control Panel Seles 8 Audio Control Panel ioj x Select Device Select Device as 5B X Fi BCEO a SB Fi BCEO SPDIF I Bit Matched Headphone Detection Restore Defaults Device Information Mode Speakers E Effects Device Information Mode Speakers EA Effects Fi Crystalizer SPDIF Ifo Bit Matched Headphone Detection Restore Defaults Entertainment Mode MW Enable Bit Matched Recording Select this mode for the highest quality music and m
174. SP Driver Installation and Licensing The user can run the Experiment Builder application in a demo mode immediately All of the functionality of the licensed copy of Experiment Builder is available in the demo mode except that Experiments created with a demo version of the software will not re open using a fully licensed version of the software An UNLICENSED DEMO VERSION text will be drawn on every display screen in an experiment that is created with the demo version of the software To run Experiment Builder in a fully licensed mode the user needs to purchase a license code for the software and have a USB dongle connected to the Development PC on which the Experiment Builder software is installed The physical USB dongle is the same one we use to license the EyeLink Data Viewer After purchasing the software license the user will then need to contact us support sr research com with the ID of the USB Dongle SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 13 If this is the first time that the USB dongle have been used on the Display PC you will need to install HASP key driver Click Start from the desktop go to Programs gt SR Research gt Install HASP driver to install the driver Follow the default settings If the driver installation is successful and the USB dongle is attached to the Display PC the dongle will glow Now you can check the dongle licensing status Please contact us if the license key i
175. SR Research Experiment Builder User Manual Version 1 10 165B Please report all functionality comments and bugs to support sr research com 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 gt 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 jee 8 0618 2 0 E reer ena eerie acter Rene ee Or ee oe E te ner E re a l 1 1 Feature aeoea a E E E A ET l I2 MLO TO Se This Minidress 2 2 sExpernment Builder Ex pernment LIE Cyce eena 4 Zad Experiment Desio esrisniieuiei i a a a a a 4 2 2 Building and Test running Experiment sseessseoeeessssssseseerrssssssseerrrsssssssseeeees 5 2 Experiment Deployment scco saci viauase ds E E E 5 2 44 Participant Data Set Randomization sseoeeeesssssseeesssssssseerrssssssseeeeressssssseeeees 6 25 DUECO C O ce enter ern mee E 6 20 Da ANa S1S ss cairaiad on rarsushtataniaa vin tuastaladanndntualialanuny iu tatsaloduntttanitaladanr saan 6 Se MING CAR AL OI E E eect E E A iow daahioneoeaeedceiadasasentaneaions 7 3 1 Windows PO System Regtire ment Saaros eed nasra elke ieee 7 Solel Computer Conturi osaset E oan a 7 3 1 2 Maximizing the Real time Performance of the D
176. SR Research Ltd 281 a SA Research Expenment Buder y A020 AC Sample 7 z alj Fie Edt View Expersnert Help DEBS S SKE GRTRA CTAB dahaa jaaa Man Epeineri EE Dele R _ 6 Click on the Sequence to continue 1 Click here to start ee 5 Click on the right mouse button on a blank area and select Arrange Layout Figure 14 4 Creating Experiment Block Sequence 1 Click on the Experiment Tab in the Project Explorer Window to start 2 Click on the Action Tab of component toolbox 3 Select the Sequence node hold down the left mouse button and drag it into the work area 4 Place the mouse cursor on top of the START node hold down the left mouse button while moving the mouse cursor on top of the SEQUENCE node This makes the connection from the START node to SEQUENCE node Note don t make a single or double click on the START node as this will select the node instead If you have done so place the mouse cursor on a blank area in the work space and make a single click there Redo the current step again 5 Click on any blank area in the work window Click the right mouse button and select Arrange Layout in the popup menu This will re arrange the nodes in a hierarchical fashion 6 Click on the SEQUENCE node in the structure list to continue 14 1 4 Editing Block Sequence Next we will need to edit the properties of the Block Seq
177. Sequence and Drift Correction Each recording trial should begin with a prepare sequence action followed by a drift correction action and then by the actual trial recording see Figure 14 10 The prepare SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 287 sequence action allows the user to preload the image files or audio clips for real time image drawing or sound playing to draw feedback graphics on the Host PC to evaluate participants performance and to reinitialize trigger settings The user should typically call this action before performing a drift correction DEBS G PxkRARBPBRA WT AOS scRr Azle aaa BBE xf Experiment BLOCK CPLay_ sone TRIAL Tend DataSource fy KEYBOARD ga EL BUTION iS Ten eb _caverna_setur jae TRA 4 Add Sequence 6 Click at blank area to change layout Eia uy 7 Double click on the Kiser input Guus sequence to continue 2 Set Draw to EyeLink ost to IMAGE fe Load SoeenAesorces fe f Load Audio brew To ByeLins Host a Triggers Fania Anon Feitiaize Video Reso Pamane SEQUEHCE Fish Loos Figure 14 10 Editing Trial Sequence 1 Click on the Action Tab of the component toolbox select the Prepare Sequence action hold down the left mouse button and drag the action into the work space 2 Click on the added PREPARE SEQUENCE action and review the settings in the property table Ma
178. T SOLUND T CORRECT SOUND __Praperty qs 4 Play feedback sound Labe ThA gt ll k i J al ai ai a TIVER_SOUND i EA Set timer duration for audio playing S da patiibnte Hipa on pared KEV PRESS valued ADD TO _FESATS_FLE i ire j j ponn 9 Add an Add to result file action J hohe parent parent TRAL DataSource EXPECTED j i T i Figure 15 19 Editing Recording Sequence 1 Click on the TRIAL_EVENT sequence 2 Add two new variables and rename them as DISPLAY_ON_TIME and KEY_RESPONSE_TIME in the work space Set the initial values of both variables to 0 0 3 Add an Update Attribute action to get the time for target display onset and time and response key from the keyboard Click on the action and modify the following attributes see Figure 15 20 KEY RESPONSE _TIME value Please note that the actual time when the Stroop display is presented is the DISPLAY SCREEN time but not DISPLAY SCREEN startTime The former is the time when the display is actually shown whereas the latter is time SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 315 when the DISPLAY_SCREEN action starts 1 e screen is prepared before it can be flipped The time when the keyboard response is made should be the KEYBOARD_INPUT triggeredData time instead of KEYBOARD_INPUT time Again the former is the time when the response key is pressed whereas the l
179. TE action shall be used to reset the default values for the variables at the beginning of the trial so that the response data from the previous trial will not be carried over to the current trial Don t forget to add the variables to the EyeLink DV Variable list or to the RESULT_FILE SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 129 RESET_OATA K Y DISPLAY_TAR GET oon Attribute Yalue List for GET RESPONSE Attribute ee ee EL BUTTON TBUTTON PRESSED valued MEL BUTTON triggeredData button TBUTTON PRESS TIME value EL BUTTON triggeredData time TOISPLAY ON TIME valued MOTSPLAY TARGET time TRESPONSE TIME valued Sinti BUTTON PRESS TIME value DISPLAY_ON_TIM GET_RESPONSE Please Set Attribute Please Set Value O 4 X k Figure 7 36 Collecting EyeLink button response data To evaluate the accuracy of the button press you will need to know what s the expected button press for the trial This can be encoded in the datasource with a number column Use a CONDITIONAL trigger to check whether the pressed button matches the expected button and then use an UPDATE_ATTRIBUTE action at each branch of the trigger to update the accuracy variable accordingly check out the HTML version of this document for the complete example project EL_BUTTON HELE RESPONSE Type Conditional NodePath BLOCK TRIAL RECORDING CHECK_RESPONSE pesse GET_RESFONMSE C ie ooo ast Checked Te CH
180. Text H Devices k how Tooltip Me HHG Nodes ae Screen H Resources H E Movement Patterns gen Built In Interest Area Preference Build Deploy GRAPH_LAYOUT i CUSTOMCLASS EDITOR Restore Factory Default Save Properties as Default Import From File Save Into File SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 351 Property is Code Text Sets the format of labels in the property table If disabled the label of the properties will be formatted and or translated for internationalization so that it is understood easily If enabled an internal label will be displayed for ease of references and no internationalization or formatting will be done Show Tooltip f enabled a description text will appear beside the item on which the mouse cursor is placed 17 4 1 Graph_Layout oot Preferences Sf Preferences 3 H E Devices Enap To Grid H Nodes rid Type ross Er JAPEN rid Resolution 100 AES Resources i ES Movement Patterns t ae Built In Interest Area Preference lumbering Edges z 2 by Build Deploy Remember Zoom Level E GRAPH LAYOUT i CUSTOMCLASS_EDITOR Restore Factory Default Save Properties as Default Import From File Save Into File Grid Visible Whether the grids should be visible in the workspace in the non screen builder graphs Snap to Grid If checked this will align the items of the graph to the closest in
181. Time time Float Display computer time in milliseconds from the start of the experiment when the drift correction action is done Start Time StartTime Float Display computer time in milliseconds from ws the start of the experiment when the drift correction state was entered Clear Input clearInputQueue a If true all events from input queues are flushed Queues S when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action X Location xLocation Integer X coordinate of the drift correction target in screen pixels Typically this is center of the screen Y Location Y coordinate of the drift correction rn in screen rn Allow Setup T Ll If this is checked the EyeLink II Camera Setup screen the Setup menu in EyeLink I can be called up to allow calibration problems to be corrected by pressing the Esc key during drift correction The default setting is true draw the target herself himself for example if the drift correction is part of the initial fixation in a saccadic task and the user wants the target to stay on the screen afte
182. Time in milliseconds to wait to execute the Time ime sequence after the recording starts typically set as 20 This attribute is only available in an EyeLink experiment with the Record attribute of the current sequence enabled Trial Result trialResult Integer A value used to encode the result of current recording trial e g MSG 1067284 TRIAL_RESULT 12 in the EDF file It is O by default but can be referred to some responses made in the trial This attribute is only available in an EyeLink experiment with the Record setting of the current sequence enabled Is Real Time T to stabilize Also note that on some operating systems real time mode locks keyboard and mouse inputs from occurring isRealTime Boolea When set to True sets the application priority to n real time mode Real time mode is only maintained for the duration of the sequence It may take up to 100 milliseconds depending on the operation system for the real time mode SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 55 Iteration The current iteration of the sequence execution Iteration Count teractionCount Integer Total number of times 1 by default the sequence should be executed Split by List of Specifies the number of iterations to be integer executed each time the sequence is encountered If the list is not empty each number in the list should be no less than 1 but also not more than the iterat
183. Top to Bottom Left to Right Bottom to Top Right to Left Top to Bottom and Right to Left Bottom to Top in which the text is segmented Interest areas are numbered consecutively based on the order they are created 17 3 Build Deploy This section lists preference settings that are related to the building and deploying processes oo Preferences Property Value O ncode Files as UTFS Disable Disable Warnings For Default Value Disable Equatic Equation Check External Libraries Ic Mest Run Command Line Arguments l nclude Packed Project In Deploy sn Nerbose f El if Preferences Be Experiment i 4 9 Devices Nodes Screen 2 H E Resources es 4 9 Movement Patterns 2 EA O ite In Interest 4rea Preference GRAPH_LAYOLIT m CUSTOMCLASS EDITOR Restore Factory Default Save Properties as Default Import From File Save Into File Encode Files as UTF 8 If enabled the generated experiment code and dataset files are written using UTF 8 encoded http en wikipedia org wiki UTF 8 files This is a must if the user is using a character that does not fit in the ASCII encoding range 1 127 In simple terms this should be enabled if anyone is using characters that are non English SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 350 e g a Or even special curved quotes and obviously any non European language character
184. Trial Data in 2D Temporal Graph Mode F905 00 1004 00 Figure 7 57 Viewing mouse traces in the Data Viewer temporal graph view 7 10 8 TTL Trigger The TTL trigger ED is used to check for TTL input to the parallel port or other data port of the display computer It fires when a pre specified TTL data is received Version 1 6 121 or later of this software automatically installs the I O port driver for both 32 bit and 64 bit versions of Windows except for Windows 2000 For the latter operating system you will need to run the PORTYSNT exe installer in the SR Research 3rdParty folder Using the TTL trigger requires properly identifying the base address of the parallel port This can be done through the Device Manager in Windows on Windows XP click Start gt Control Panel gt System In the System Properties dialog select the Hardware SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 158 tab and click Device Manager button In the Device Manager list find the entry for the parallel port device under Ports COM amp LPT if you use PCI PCI Express or PCMCIA version of the parallel port adapter card you ll need to install a driver for the port before it is correctly recognized by Windows Click on the port and select the Resources in the properties table This should list the I O address of the card For the built in LPT1 of desktop and laptop computers this is typically 0378 037F hex value
185. WAV files created with the RECORD_AUDIO action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 324 17 Preference Settings Many aspects of the SR Research Experiment Builder can be configured in the application preference settings which can be accessed by clicking on Edit gt Preferences from the application menu bar see Figure 17 1 These include the EyeLink tracker settings display setup screen coordinate type default values for the experiment components triggers actions and screen resources graph layout etc All of the changes can be saved by pressing the Save Properties as Default button allowing them to be used in the future experiment sessions If the changes are valid only for the current experiment creation session simply press the close J button on the dialog box lt change Read Only SR Research Experiment Builder 1 6 112 q la xi File Edit view Experiment Help Unde Ctrl Z a i cee S982 G PAalshOo eoa gt A l gt QQQHAE fut Ctrl x EA Hm cony celc PALXI Experiment Paste Cery O m amp Paste Multiple Ctrl M i 8 Eza poy gt l X Y 1D d Ww Delete Delete E Refresh Custom Glass CtrHH Waa 4 Preferences w Preferences ih Library Manager Ctrl L EEE references ij Reference Manager Ctrl R Eh Experiment Devices Node Groups Ctrl G cim EES EYELINK Select All Ctrl
186. a Static image file name Use Software useSoftwareSurf Boolea If false unchecked memory on the video card Surface T ace n is used to hold the resource blitting from the video card memory to the display surface is Prebuild to _prebuildToImage Boolea Whether the resource should be built into an Image T n image when the experiment is built instead of having it created during runtime Uncheck this option only if you will need to come up with the fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface Clipping clippingLocation Point The coordinate of the top left corner of the Location clipping region of the resource Only part of the image within clipping region will be shown Clipping Height clippingHeight Float Intended height in pixels of the clipping region of the resource Clipping Area is clippingAreaAtG Whether the clipping region should be n Clipping Width clippingWidth Intended width in pixels of the clipping region Position azeContingent contingent on the mouse or gaze position The Contingent T default setting is False Source File sourceFileName String The name of the image file Make sure that the Name 4 file name does not contain space or non ASCII characters Note that the images must be first loaded into the resource library Use Original useOriginalSize Boolea If set to true this
187. a center based resource or a top left based screen resource Imagine that a mouse trigger should fire when the cursor is within a rectangle resource RECTANGLE_RESOURCE The top panel of the figure below illustrates creating the Region Location reference when the RECTANGLE_RESOURCE is top left based DISPLAY_SCREEN RECTANGLE_RESOURCE location The bottom panel of the figure illustrates creating a location equation when the location type is center based SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 151 EBPoint DISPLAY_SCREEN RECTANGLE_RESOURCE location x DISPLAY_SCREEN RECTANGLE_RESOURCE width 2 DISPLAY_SCREEN RECTANGLE_RESOURCE location y DISPLAY_SCREEN RECTANGLE_RESOURCE height 2 Properties Hx Property i Message OUSE ast Checked Time Buttons Press Events Release Events Position Triggered onfidence Interval lear Inpuk Queue Region Direction O 45 45 90 90 135 135 180 180 135 135 Region Type RECTANGLE Region Location Top Left I DDISFPLAY SCREEN RECTANGLE RESOURCE location Region Width DISPLAY SCREEN RECTANGLE RESOURCE WANE e PSS Properties 4al x Property e horan LOCK TRIALRECORONG MOUSE a pame f SSCS FBPointi DISPLAY SCREEN RECTANGLE RESOURCE location xi DISPLAY _SCREEN RECTANGLE_RESOLIRCE width 2 lear Input z DISPLAY_SCREEN RECTANGLE_RESOUIRCCE location y Region Direction DISPLAY SCREEN RECTANGLE R
188. adasera eee 63 7 9 3 Performing Camera Setup and Calibration 00 00 cccccccccceccceeeseeseeeeeeeeeeaaes 68 LIA Sende Eyelink Messase six secncoseciewidnnanteie ean eee iene neewe 75 oD Sending EyeLinkO Command resarcirse te ibslwisducateieets 76 LOG Sdn TTE S nahea EN 79 Pod Adde TOE Xperment Otene aa 81 FAS Updating Atrib t cironi secede ves E A 83 TOD Addn 10 Accumulator austerity a a nes 85 PONG Addme TOR GS ONT FNC steric tcrecics ceed A E 86 TALL seme PARLIN Se GUC NCC eeaeee 87 LIA RESC NOO eeano a a E Teen en en 90 LLI Playin Sound areenassa are iendalnaladelvends 90 TOA Play Sg nd C onio leesni aclosacieaaioss nateadingocd yeisicainiaatiysaceewents 98 TAAS Recon SoU ee tcrseneeeeehntendeaeel ceases 100 TATO Record sound Contokezirusiensare re a E 103 7 9 17 Terminating an Experiment eeeeessseoeeeessssssoeersssssssseererssssssseeeressssss 104 FIIS Recycle Data L Mecenes a 106 FI Ee We A Oaa ost tetera Rasa ager enchant att aniiae I oaeaneanenoecbensahestan 108 a 6 MS S20 0 pe etree ree ne a ee 109 Loo JInesponsePxx LED Conttolvesscnscianwunnsientaieriwaaianeni en ean 111 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 1i ee nat Ls boa a a Doerner rn meter Deceit nmr nate A 113 POL Amer To oe ae een A ae aE 113 T102 Invisible Boundary W116 Ger arisen a 116 7 10 2 1 The location type of the invisble boundary trigger eeeeee 121 7 10 2 2 How to sho
189. addition running SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 5 the deployed version of an experiment generally has a better timing performance than running it directly from the Experiment Builder application because the computer is not running the Experiment Builder interface at the same time as the experiment To run an experiment in a different computer the user should copy the entire directory of the deployed version of the experiment to the new experiment computer The experiment should be run at least once and results validated on the new computer before starting full data collection from multiple participants 2 4 Participant Data Set Randomization As mentioned earlier the experiment designer can use Experiment Builder to create prototypical trials for the experiment and to supply the actual parameters of individual trials from a data source In most experiments the user will need to randomize trial order so that the experiment materials are not presented in the same sequence across participants Randomization of data source can be done with either an internal randomizer or an external randomizer These two randomization methods are almost identical and therefore the user may use the internal randomizer to perform randomization unless counterbalancing or Latin square designs are needed Please note that configuration of the internal randomization settings should be done before deploying the experiment project
190. al randomization with data sources attached to multiple sequences Bug fix for ResponsePixx LED Control action Bug fix for TTL_INPUT trigger not firing properly Bug fix for improper reporting of composite resources in Data Viewer Bug fix for file transfer issues aborted file transfers corrupted EDF files or false alarms Version 1 10 1 This is a full release of Experiment Builder that runs on 32 bit and 64 bit Windows 2000 XP Vista and 7 This is also a beta release of Experiment Builder that also supports running on Mac OS X Intel CPU OS v10 6 or later Experiment projects saved on the Windows operating systems can be opened with the same version or a newer version of the software on Mac OS X and vice versa with some exceptions on the transferability Known limitations when designing running the experiment on Mac OS X with this release o Voicekey is not supported o Only Xvid video clips are supported through the video resources animation video clips are not supported in Camera Setup and Drift Correction actions o Sending or receiving TTL signals is only supported through USB 1208HS box o Calibration control through external device is not supported Adds support for ASIO driver for sound playing sound recording and voice key on 64 bit Windows 7 Adds support for USB 1208HS box through SET_TTL action and TTL_INPUT trigger Adds Ignore if Missing option to the EyeLink Button Box device so that the project can st
191. alog or link sample data so please use it carefully The use of this prefix should be limited to the write_ioport Priority T command Typical command execution is 1 20 ms after the action is pressed With prefix this is reduced to less than 1 ms 99 of the time In the worst case it may still about 10 ms but rarely higher than 2 ms The default setting is False This setting has no effect on EyeLink I Log Time T If enabled logs the command and its delay in SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 77 execution to the EDF file and link if message events are enabled The default setting is False The message time is when the command completed execution The message syntax 1s ICMD lt execution delay gt lt text of command gt This setting has no effect on EyeLink I aa Whether the program should wait a a response a the tracker 7 Time Out resultTimeOut E Sets the maximum amount of time to wait for a response from the tracker If no result is returned then the error code NO_REPLY is returned Exit On Fail T exitOnFail m Whether the experiment should be terminated if there is an error in the command Important please leave this field unchecked unless it is absolutely necessary that you should terminate the experiment if the EyeLink send command action fails Result result Integer Result code for the command 0 Command successfully sent 1 Unknown c
192. always true when the screen 1s contained in a recording sequence IMPORTANT If this attribute is False the run time drawing may not look exactly as it does in the screen editor Use Software useSoftwareSurf Boolea If false unchecked memory on the video card Surface T n is used to hold the resource blitting from the video card memory to the display surface is fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface color is medium gray 128 128 128 Filled t filled Whether the interior of the resource should be n filled This is True by default Color in which the interior of the resource is filled The default color is medium gray 128 128 128 Specifies the width 1 by default of the pen in pixels x y coordinate of the first point of the triangle Point Two _pointT wo Point x y coordinate of the second point of the triangle SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 223 Point Three _pointThree Point x y coordinate of the third point of the triangle 8 1 9 Freeform Resource The freeform resource can be used to draw a polygon consisting of two or more vertices connected by straight lines To create a freeform resource on the screen first write down on a piece of paper the list of x y coordinates for all of the intended vertices in order Click on the Draw Freeform
193. any type is done Note If a static display is used 1 e none of the above mentioned manipulations is applicable turning off this option might be advantageous and will improve timing performance e g trigger firing as the program does not have to constantly checking whether the display should be updated If checked writes a message V DRAW LIST to the data File for the ease of analysis with EyeLink Data Viewer This message will draw images and simple graphics in Data Viewer as the background for gaze data This field is only available when the action is contained in a recording sequence If checked the current screen will be transferred to the Host PC as a bitmap or primitive drawings for online gaze feedback This field 2004 2011 SR Research Ltd 61 needs to work together with the Draw to EyeLink Host field of the PREPARE SEQUENCE action This attribute is only available in an EyeLink experiment Interest Area Set If the user has already had interest area files for Name the current display she he can first add the interest area files into the library manager and set this field to a desired interest area set file Returns MISSING_DATA if no value is set in this field This attribute is only available in an EyeLink experiment Synchronize syncAudio Boolea If checked this will bring up a list of additional Audio T n variables so that the parameters of sound playing can be specified see P
194. arts with O when the EyeLink host program was started Sample Rate sampleRate Returns the actual sampling rate running in the experiment This may differ from the value set at the Eye tracking Sampling Rate property CR Mode CRMode Returns the actual mode PUPIL_CR or PUPIL_ONLY string running on the Host PC This may differ from the value set at the above Eye tracking Mode property File Filter fileFilter Returns the actual file filter level OFF NORMAL or HIGH used in the experiment This may differ from the value set at the above File Filter Level property SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 329 Link Filter linkFilter Returns the actual link filter level OFF NORMAL or HIGH used in the experiment This may differ from the value set at the above Link Filter Level property Eye Used eyeUsed Returns the actual eye s used LEFT RIGHT or BOTH in the experiment This may differ from the value set at the above Eyes To Track property Pupil Detection Model pupilDetectionModel Returns the actual algorithm used to detect the pupil center position centroid algorithm vs ellipse fitting algorithm This option is only applicable to EyeLink 1000 trackers Last Sample Possible data that can be retrieved from the last eye sample see the table below for details Data File Contents Important SR Research Ltd does not reco
195. ary region in x y tuple The default value is 0 00 0 00 Note that the x y coordinate of the region location can be further referred as regionLocation x and regionLocation y respectively Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Region Width regionWidth Integer Width 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Region Height regionHeight Integer Height 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Interest Area Target interest areas used to define the triggering region Note that this property is only available when the Region Type property is set to INTEREST AREA n lands within the target region Tracking Eye trackingEye String Decides which eye s data is used for online Teet eee parsing The default value is EITHER It can also be LEFT or RIGHT Integer Minimum amplitude 0 by default of the Amplitude ude triggering saccade ee following table SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 170 Regions Interest Area NR The display screen on which target interest area Screen regions are located Note that this property is only available when the R
196. ase events cached in the release event queue for the keyboard device or the first keyboard device if multiple inputs are supported Enable Key Repeat NR If this is enabled supports repeated key inputs when you hold down a key This option is only available if Enable Multiple Input option is NOT enabled Repeat Delay repeatDelay Adjust the amount of time that elapses before characters repeat when you hold down a key Repeat Interval repeatInterval Adjust how quickly characters repeat when you hold down a key Keyboard Two Label Keyboard Three Label keyboardTwoLabel keyboardThreeLabel This supplies a label for the second third keyboard device detected by the experiment This option is only available if Enable Multiple Input option is enabled Keyboard Two Key Down Input Queue Size Keyboard Three Key Down Input Queue Size keyboardTwoKeyDownInputQueueSize keyboardThreeKeyDownInputQueueSize Sets the maximum number of press events that can be cached in the press event queue for the second third keyboard device SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 337 Keyboard Two Key Up Input Queue Size Keyboard Three Key Up Input Queue Size keyboardTwoKeyUpInputQueueSize keyboardThreeKey UpInputQueueSize Sets the maximum number of release events that can be cached in the release event queue for the second third keyboard device Keyboard T
197. ased or center based the screen resource interest area location type can be set by the Screen Preferences This means that references should be created differently depending on whether the region location of a trigger refers to a center based resource or a top left based screen resource Imagine that a fixation trigger should fire when the eye is within a rectangle resource RECTANGLE_RESOURCE The top panel of the figure below illustrates creating the Region Location reference when the RECTANGLE_RESOURCE is top left based DISPLAY_SCREEN RECTANGLE_RESOURCE location The bottom panel of the figure illustrates creating a location equation when the location type is center based EBPoint DISPLAY_SCREEN RECTANGLE_RESOURCE location x DISPLAY_SCREEN RECTANGLE_RESOURCE width 2 DISPLAY_SCREEN RECTANGLE_RESOURCE location y DISPLAY_SCREEN RECTANGLE_RESOURCE height 2 Properties Property Ts TION RECTANGLE RES Ype ixation me oe Pode Path BLOCK TRIAL RECORDING FIsATIOM essage FIXATION ast Checked Time eae foonfidence Interval lic Clear Input Queue NO aana Region Type RECTANGLE Host Outline Color Redon Locator Tope BOLRAY_SCREENRECTNGE RESOURCE rG POISPLAY SCREEN RECTANGLE RESOURCE width Screen Location Type Region Height DDISPLAY_SCREEN RECTANGLE_RESOURCE height iin a Sieben a gi ovement Pattern Event Type PDATEFIXATION proba Talmage roren pee fe SR Research Experiment Builder User
198. atter 1s the time when the KEYBOARD_INPUT trigger fires Please note that an sign is added before DISPLAY_ON_TIME value KEY_RESPONSE_TIME value so that an equation can be created in the cell ecb Edit Attribute UPDATE_ATTRIBUTE gt Attribute KEVBOARD_INPUT triggeredData time Mode Selection Ebi TRIAL_EWENT Label Keyboard F START Node Path Key FICATION _SCREEM Time Key Code a TIMER Last Checked Time Unicode Key DISPLAY _SCREEN Confidence Interval Modifier F TIMEOUT E Input Gueue ls Shift Pressed KEYBOARD INPUT Keys ls CTRL Pressed E DISPLAY BLANK Es Apriona E ALT Pressed M UPDATE_ATTRIBLUTE CONDITIONAL YY INCORRECT_RESPONSE X Y CORRECT_RESPONSE F INCORRECT _SOUND lt b CORRECT_SOUND E TIMER_SOUND E ADD_TO_RESULTS_FILE KEY_RESPONSE_TIME DISPLAY _ON_TIME RESULTS_FILE Devices ae OK Cancel Figure 15 20 Accessing the Subattribute of the TriggeredData Attrbiute 4 Add a conditional trigger to determine whether a correct response has been made by checking whether the key pressed is the desired keyboard response Select the conditional trigger set a attribute to parent parent KEYPRESS value b comparator to EQUALS c value to parent parent TRIAL_DataSource EXPECTED The conditional trigger yields true result when the key pressed is the same as the expected key response set in the Data sourc
199. ault Index of the resource in screen resource list O n Position is Gaze positionAtGazeC Boolea Whether the position of the resource is Contingent T ontingent contingent on the gaze position The default setting is False This setting can only be modified when the display screen is contained in a recording sequence Position is _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent contingent on the mouse position The default Contingent T setting is False Offset Adjustment of the resource position relative to SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 224 the position of the current gaze or mouse position The default offset 1s 0 00 0 00 Host Outline Color The color of the box drawn on the host screen to Color hostOutlineColor show the position and dimension of the current resource This property is available only if the Use for Host Display option of the containing display screen action is enabled Location location Point The coordinate of the top left corner or center of the resource Width z width i Width of the resource in pixels height Height of the resource in pixels os T pattern sinusoidal or custom of the Pattern f resource Prebuild to aa a Whether the resource should be saved in an Image T image file when the experiment is built instead of having it created during run time This field is always true when the scr
200. ault location in the settings refers to the top left corner or center of a resource Interest Area Color Color used to draw the border of interest areas Anti aliasing Drawing Anti aliasing is the process of blurring sharp edges in text or line drawings to get rid of the jagged edges on lines If this preference is set to true anti aliasing is applied to resources to make screen drawings appear smoother To achieve best anti aliasing result make sure that the transparency color Preferences gt Experiment gt Devices gt Display gt Transparency Color is set to close but not identical to the background color of the display Preferences gt Experiment gt Nodes gt Action gt Display Screen gt Background Color 17 2 2 Image Resource See section 8 1 1 Image Resource 17 2 3 Video Resource See section 8 1 2 Video Resource 17 2 4 Text Resource See section 8 1 3 Text Resource 17 2 5 Multiline Text Resource See section 8 1 4 Multiline Text Resource 17 2 6 Line Resource See section 8 1 5 Line Resource 17 2 7 Rectangle Resource See section 8 1 6 Rectangle Resource 17 2 8 Ellipse Resource See section 8 1 7 Ellipse Resource 17 2 9 Triangle Resource See section 8 1 8 Triangle Resource 17 2 10 Freeform Resource See section 8 1 9 Freeform Resource 17 2 11 Sine Pattern See section 8 2 1 Sinusoidal Movement Pattern SR Research
201. aved experiment session can also be opened by clicking on the Open button Fi on the application toolbar or pressing the shortcut keys Ctrl O on Windows or Command d O on Mac OS X Note The user can also open an existing experiment project with Window Explorer by going to the directory where the experiment project is contained and double clicking on the graph ebd file 4 5 Reopening a Recent Experiment Session Experiment Builder keeps a history of five recently opened experiment projects If the user needs to reopen a recent experiment project try 1 from the application menu bar choose File Reopen 2 from the list of recent experiment projects choose the project to open see Figure 4 6 eos EyeLink Experiment Builder File Edit wiew Experiment Help New Ctrl M Open Ctrl 0 fe Reopen D Program Files 5R ResearchiExperiment Builder Examples 5accade ae e C Program Files SR ResearchiExperiment Builder ExamplesiSimple D Program Files5R ResearchiExperiment Builder Examples change Save Os cial Package F5 Ea Unpack F3 Exit C Program Files SR ResearchiExperiment Builder ExamplesiTextLine Clear History Figure 4 6 Reopening Recent Experiment Sessions SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 22 A File Not Found error will be displayed if the intended experiment project has been moved renamed or deleted To clear the list of recent projects clic
202. background in Data Viewer Experiment Builder also allows the users to specify condition variables for a trial and to add interest areas for a display screen Finally the users can send custom messages to the EDF file so that time critical or important events can be marked in the data file for the ease of future analyses The Experiment Builder also contains a built in Screen Builder utility that makes the creation of 2D visual displays easier The Screen Builder is a what you see is what you get WYSIWYG tool allowing experiment designers to create and view 2D visual stimuli right within the Experiment Builder application The Screen Builder allows various types of graphic resources images text or simple line drawings to be added to a Display Screen action The exact properties of the resources can be further modified from a property panel In addition the Screen Builder supports creation of both static and dynamic displays In a dynamic display the user can have some resources on the screen move along a pre specified movement pattern The SR Research Experiment Builder is highly configurable Nearly all of the properties of experiment components can be modified This can be done either by directly entering the parameter values or more flexibly by attribute reference and equations 1 e setting the value of one variable to the value of another variable With this dynamic reference capability a typical experiment requires the users to crea
203. be downloaded from https www sr support com forums showthread php t 9 If you have a previous version SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 14 of Experiment Builder installed on the computer please uninstall it first by removing the Applications ExperimentBuilder folder to Trash Now click on the ExperimentBuilder dmg installer Select the ExperimentBuilder folder in the package drag and drop it into the Applications folder The software is now installed at Applications ExperimentBuilder Click on ExperimentBuilder app to run the software The examples can be found in the Documents ExperimentBuilder Examples folder AALO ExperimentBuilder x 4 items 172 7 MB available EB ReadMe txt ExperimentBuilder Hasp IXI To install this software drag the Expenment Builder icon to your applications folder M Applications ExpernmentBuilder 1 10 0 192 _ ExperimentBuilder if Figure 3 4 Installing Experiment Builder on Mac OS X SR Research Experiment Builder works with EyeLink I EyeLink H and EyeLink 1000 eye trackers e EyeLink I users should make sure that version 2 11 of eyelink exe file https www sr support com forums showthread php t 45 runs on the Host PC e EyeLink II users should use a recent version 2 0 or later of eyelink2 exe https www sr support com forums showthread php t 11 e Any version of EyeLink 1000 host software will be fine
204. bel axitnutn Size lermnent wy ua z om Ltr imirriLirr Mean Median Btandard Deviation Btandard Error A EN veLink Message ction Time Attribute Y ACCUMULATOR Y ADD_ACCUMULATOR SEND_EL_MSG xev Mae ATTRIBUTE Tak nom o Bly ii A t m O Cc Experiment Components Devices Value PDOATE_ATTRIBUTE lear_data Property aA CCUMULA TOR maxit B Figure 7 74 Setting the Properties of Accumulator An Add to Accumulator action is added to the sequence to store saccade duration data The user needs to specify the accumulator in which the data is stored and the data to be stored see Panel A of Figure 7 47 Finally at the end of the trial or experiment the data can be retrieved For example if the user wants to know the number of saccades in the sequence and some basic statistics of saccade duration a SEND_EL_MSG action can be used saccade data str ACCUMULATOR size max str ACCUMULATOR maximum min str ACCUMULATOR minimum mean str ACCUMULATOR mean SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 193 uP Recording 4 P Recording JCO ACCUMULATOR S ADD ACCUMULATOR E SEND EL MSG X Y UPDATE_ATTRIBLITE TIMER TIMER ay EL_BUTTON ay EL_BUTTON E SACCADE EP SACCADE gt ACCUMULATOR gt ACCUMULATOR r X Y UPDATE_ATTRIBUTE Experiment Components Dewices Experiment Components
205. box those involving online eye data invisible boundary fixation saccade and sample velocity and conditional evaluations The following sections list the use of each trigger type Triggers can be selected from the trigger tab of the component toolbox Figure 7 29 A MOeODNBDOO E O Action Figure 7 29 Triggers Implemented in Experiment Builder 7 10 1 Timer Trigger Timer Trigger fires when a pre specified amount of time has elapsed since the trigger started It can be used to introduce a delay between actions and or triggers and to control the maximum amount of time a sequence can last The following table lists the properties of a timer trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 113 Reference String Label of the Timer trigger The default value is TIMER The type of Experiment Builder objects Timer the current node belongs to String The absolute path of the node in the i experiment graph k Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the timer trigger fires Display computer time in milliseconds from the start of the experiment when the trigger fires Last Check lastCheckedTim Float Experiment Builder checks for the status of the timer trigger about every 1 msec This property can be used to retrieve the D
206. bration drift correction through the External Control Device Config setting This property is only available if the External Control Device option is set to CUSTOM Result Always returns None Please note that the Camera setup action is only available in EyeLink experiments and must be placed outside of a recording sequence As a linking rule the camera setup action cannot be connected to another drift correct action camera setup action or any trigger Figure 7 11 illustrates the use of camera setup in an experiment START Sequence est Bi START Na BLOCK JF START EE GAMERA aE HE EL_CAMERA_SETUP zi TRIAL JF START Experi ment Components Properties EL CAMERA SETUP EyelinkCameraSetup BStaqe tart Time Clear Inout Queues fe Calibration Type vg Foreground Color Background Color i P Use Custom Target Target Outer size ae a a COR JCPHFH Target Inner Size Target Beep DEFAULT Error Beep DEFAULT Good Beep DEFAULT fae Figure 7 13 Using Camera Setup Action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 74 7 9 4 Sending EyeLink Message rest The SEND_EL_MESSAGE action writes a text message to the EyeLink eye tracker which timestamps it and writes to the EDF data file Messages are useful for recording trial conditions responses from the participant or marking time critical events for debugging and analysis The EDF message te
207. cked Time Confidence Interval Duration Duration Type msecs ptart Time DISPLAY TARGET time Elapsed Time DISPLAY BLANK Figure 7 42 Using Cedrus button trigger without ending a trial 7 10 6 Keyboard Trigger The Keyboard trigger responds to an input from the keyboard device attached to the display computer collecting keyboard response to the host PC keyboard may also be possible The user needs to specify a list of possible key presses on the keyboard so that the trigger will fire To set the key s used for response click on the value field of the Keys property and select the desired keys Multiple keys can be selected or unselected by holding down the CTRL key on Windows or the Command key on Mac OS X Important Please note users should not use the keyboard trigger to collect timing critical responses as the delays introduced by Windows are highly variable A warning 2003 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 137 The IO node KEYBOARD is used in realtime Sequence RECORDING gt KEYBOARD message may be seen if the keyboard trigger is used in a sequence with the Is Real Time option checked This warning means that the keyboard may not work when your sequence is running under the realtime mode this is especially the case if you are using an old Display PC For most recent computers the keyboard trigger along with mouse and Cedrus Input triggers will still run in the realtime mo
208. comprehensive graphical experiment creation environment for Psychologists The features in the Experiment Builder have been designed to address many of the research needs SR Research has encountered when working with EyeLink users on their applications This ranges from simple experiments in which each trial shows a static screen of text or picture and then waits for a response from the participant to more sophisticated experiments in which complex event sequence can be scheduled with good timing precision Experiments are created in the Experiment Builder by dragging and dropping experiment components into a workspace and configuring the properties of the added components There are two main classes of experiment components in the Experiment Builder Actions and Triggers Actions tell the computer to do something like displaying a set of graphics on the screen or playing a sound Triggers define the conditions that must be met before an action can be performed Examples of Triggers are keyboard events and eye Fixation Saccade and Invisible Boundary events The flow of the experiment is achieved by connecting sequentially related components in the workspace in a flow diagram like fashion For example a Display Screen Action may be connected to a button press Trigger which is in turn connected to another Display Screen Action This simple Action gt Trigger gt Action sequence would result in a given set of graphics being displayed until the
209. create lines of empty cells for data input By default the empty data source lines will be created at the end of the table The user can also choose to insert the new row s above or below the currently selected data source row s To modify the value for a particular cell double click on the cell type in the new value DO NOT include quotes for text strings and press the ENTER key to register the change SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 245 Experiment SEQUENCE TRIAL RECORDING TRIAL DataSource E a 54 255 0 sep freee a0 100 0 0 285 Salt Fou a 0 0 0 Figure 9 3 Data Types Used in Experiment Builder Currently the Experiment Builder supports six data types number string point color list and Boolean For the number data type the user can enter one integer 1 2 3 or float number 0 1 2 0 3 14159 in each cell The user can enter any text in a cell of string type If the text contains or is flanked by a pair of quotes the quotes are shown as well For the point type the user needs to enter two numbers separated by a comma a pair of brackets will be added automatically For the color type the user needs to enter three integer numbers between 0 and 255 separated by a comma For the list type the user needs to enter a list of numbers string colors points or lists each separated by a comma A pair of square brackets will be added automatically To crea
210. d The Devices Tab right panel allows the designer to configure default settings for the EyeLink tracker experiment display and other devices see preference settings Structure Simple m START ia BLOCK Property abel DISPLAY SCREEN Object Type velink Message Background Color lll GidRows bo oOo Grid cums BS Structure ADD_ACCUMULATOR PLAY _ SOUND PREPARE _ SEQUENCE ADD_TO_RESULTS_FILE DRIFT CORRECT SET_TTL RESET_MODE DISPLAY _SCREEM BA IGISPLAyY_SCREEN Experiment Components Properties H a Se 24 waht 7 Background Color NN ts Per Pixel BO GidRows bo oOo Grid Cums OB orce Full Redraw ze For Host Display D T 2 Auto Generate Sync M 7 7 Structure EH 9 Devices EVELINK DISPLAY AUDIO TTL CEDRUS Experi ment Components Dewjices Properties H x Property Resolution nike Heit BR Bits Per Pixel Refresh Rate oT ranzparency Color lip Remain Threshold Roo Figure 5 4 Different Tabs of the Structure Panel The Properties panel at the bottom displays attributes associated with the selected item in the Structure panel The designer can review the current settings for the attributes and make modifications if necessary Please note that if a property field is grayed out the value of the property cannot be directly modified but may be referred e g Time of the DISPLAY_SCREEN action whereas all of the other properties may be modified directly SR Res
211. d 265 There are some restrictions in the file naming 1 The file name cannot use any of the following reserved words name of a package that already exists in the python library path ctypes numarray py2exe pyasio pygame pylink pypsy pythonwin serial sreb win32 and wxPython 2 The file name cannot have spaces or non ANSI characters 3 The file name cannot contain other than for the use of extension py 12 3 Syntax of Custom Class Custom Classes are written using the Python programming language As such an understanding of the Python programming language is necessary before creating a Custom Class in Experiment Builder Please refer to the Python documentation if you are not familiar with Python While a custom class is written in Python a set of rules is used by the Experiment Builder GUI to parse the custom class and display the properties of the class in the Experiment Builder GUI It is critical that these rules described later in this section are understood as you define your custom class so that access to class attributes and methods is possible from within the rest of the experiment The following explains the basics of creating a custom class in Experiment Builder with an example 12 3 1 Line 001 Line 002 Line 003 Line 004 Line 005 Line 006 Line 007 Line 008 Line 009 Line 010 Line O11 Line 012 Line 013 Line 014 Line O15 Line 016 Line 017 SR Research Experiment B
212. d that you record a sound file for the entire trial It is advisable to add a short TIMER trigger towards the end of the trial so that the entire vocal response can be captured In an experiment in which both eye movements and speech voice key are recorded simultaneously it is important that the user is able to examine the temporal relationship between the two domains ideally compare the two streams of data in the same time scale In Experiment Builder Data Viewer the time stamps for the eye movment data and messages 1 e EDF file time are based on a different clock than the time fields for the actions and triggers 1 e EB run time The EDF file time runs on the host PC clock with the 0 ms being the time when the EyeLink host program started The EB run time is based on the display computer clock with O ms being the time when the experiment SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 184 project starts To align up the eye movement data and the recorded speech data you will need to add extra variables to the xperiment project e currentEyeTrackerTime used to retrieve the current time on the eye tracker clock e currentDisplayPCTime used to retrieve the current time on the display computer clock when the currentEyeTrackerTime value is updated e AudioRecordingStartTime used to retrieve the time when the audio recording Starts Use an UPDATE_ATTRIBUTE action to update these three variables while the audio
213. d error value for all added values The accumulator can be used as a handy tool for presenting a summary of participant s performance RT calculation at the end of the experiment Suppose that we have a saccade trigger Whenever the saccade trigger is fired the triggered data is collected and the duration of each saccade can be added to the accumulator At the end of the trial or at the end of the experiment we can easily calculate the max min mean etc of the duration of all saccades The following figure illustrates the experiment START ACCUMULATOR UIPDATE_ATTRIBUTE DISPLAY _SCREENM TIMER ADD_ACCUMULATOR e ese an i eee Figure 7 73 Using Accumulator The user needs first to add one accumulator object into a graph and set the maximum data size for the accumulator see Panel A of Figure 7 46 At the beginning of the sequence execution the user may need to clear the data in the accumulator if it has been used previously This is done by adding an UPDATE_ATTRIBUTE action and resetting the maximum data size for the accumulator see Panel B of Figure 7 46 Note that the user can also reset the data points in an accumulator with the RESET NODE action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 192 uP Recording uP Recording Y ACCUMULATOR Y gt ADD_ACCUMULATOR SEND_EL _MSG X Y UPDATE ATTRIBUTE Experiment Components Dewices Value ACCUMULATOR Property a
214. d files Note that multiple audio clips can be selected from the dialog box and imported together SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 90 on Windows On Mac OS X only a single file can be added from each click of the add button To import multiple audio clips you may first use Finder to select all of the audio clips to be imported and then drop them into the Sound tab of the library manager Please make sure the audio file name does not contain space or non ASCII characters Please note that the playing of an audio clip is asynchronous 1 e the action returns before the sound finishes playing As a result if a sound clip is played at the end of a sequence e g used as a feedback to the participant the user needs to attach a timer following the play sound action to ensure that the whole sound clip will be played eon SR Research Experiment Builder 1 2 1 RC Playsound File Edit view Experiment Help F Unda Ctr Me 6S O RAl sH M ea gt 2 oe aut CEES Over ie Sony Ctrl C Experiment Faste Ctrl O 7 j Paste Multiple EFM i pelete Delete mi Preferences F4 6 Library Manager x Ai Library Manager Ctrl L gusta tass c orrect way EHE EE Reference Manager Ctrl F A Node Groups Ctrl G pee agian Select All Ctrl 4 Renane Add Delete Experiment Components Devices Properties H x gt Properties
215. d for online parsing The default value is EITHER It can also be LEFT or RIGHT Trigger Above triggerAboveThr Integer Decide whether the trigger should fire if the Threshold t eshold current velocity and acceleration values exceed the threshold values Velocity velocityThreshol Integer Sets velocity threshold of saccade detector Threshold d usually 30 sec for cognitive research 22 sec for pursuit and neurological work The default is 30 degrees This will override the saccade sensitivity settings in Preferences gt Experiment gt Devices gt EyeLink Use useAcceleration Boolea Whether the acceleration value should be Acceleration n considered Given the dynamics of acceleration deceleration during a saccade this field may be checked whether determining a saccade with no region location constrain e g when the location is set to full screen If the trigger should fire when entering or leaving a particular region the user may leave this box unchecked 1 e ignore the acceleration data Acceleration accelerationThre Integer Sets acceleration threshold of saccade detector Threshold shold usually 8000 sec sec for cognitive research 3800 sec sec for pursuit and neurological work The default value is 8000 This will override the saccade sensitivity settings in Preferences Experiment Devices gt EyeLink Triggered Data triggeredData Data about the saccade
216. data Save audio output stream Play Input Fie Stop Play Gutput Fle Start Compression To play video clips in Experiment Builder the user should first convert the original avi files into XVID or VFW files with the Split Avi application which is presently only available on Windows that comes with the Experiment Builder software Following this the converted X VID or VFW files can be added into the library manager and the target clips can be added into a display screen Please do not attempt to load the original unconverted avi files into the video library as this may not work To add video clips into the resource library click on Edit gt Library Manager from the application menu bar This will bring up a Library Manager dialog box Select the Video tab and click on the Add button to load in the desired video clips Note that multiple video clips can be selected from the dialog box and imported together on Windows On Mac OS X only a single video file can be added from each click of the add button To import multiple video clips you may first use Finder to select all of the video clips to be imported and then drop them into the video tab of the library manager Please make sure the video file name does not contain space or non ASCII characters SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 203 eo Library Manager x Add Delete Rename Je Fropetieis a aa Brevi
217. de so this message can be ignored Check the BIOS setting of your Display PC and make sure that the multi core or hyper threading setting is enabled for the proper functioning of the keyboard mouse or Cedrus triggers in a real time sequence Reference String Label of the keyboard trigger The default label is KEYBOARD The type of Experiment Builder objects Keyboard the current node belongs to Strin The absolute path of the node in the experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the keyboard trigger fires Time time Float Display computer time in milliseconds from the start of the experiment when the trigger fires Note To check the time when the key was pressed you should use triggeredData time instead Last Check lastCheckTime This property can be used to retrieve the Time Display computer time in milliseconds from the start of the experiment when the trigger was checked for the last time Time difference between the trigger time and last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time Clear Input clearInputQueue Boolea Keyboard trigger maintains an event queue so Queue that multiple key
218. de belongs to experiment graph Message Message String Message to be sent to EDF file in an EyeLink meee Bes Sten when henson wig fe Time time Float Display computer time in milliseconds from the start of the experiment when the trigger fires Note To check the start and end time of the triggering fixation you should use triggeredData startTime and triggeredData endTime e the startTime and endTime sub attributes of the triggeredData attribute Last Check lastCheckTime Float This property can be used to retrieve the Time Display computer time in milliseconds from the start of the experiment when the trigger was checked for the last time Confidence confidenceInterv Float Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time Clear Input clearInputQueue Boolea Fixation trigger maintains an event queue so Queue n that multiple fixation events start of a fixation fixation updates and end of a fixation can be accessed over time The current option checks whether the fixation event s cached in the event queue should be cleared when the trigger fires NO no event clearing Event removes the current triggering event from the fixation event queue LIST all fixation events from event queue wil
219. ding SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 185 i e O point in the EDF file eye tracker time frame will be currentEyeTrackerTime AudioRecordingStartTime currentDisplayPCTime 7 11 Other Building Components This section lists other components for experiment building variable result file and accumulator see Figure 7 39 Action Other Figure 7 67 Other Components Implemented in Experiment Builder 7 11 1 Variable The user can create a variable Li during run time to keep track of some important information e g the iteration status in a loop To create a new variable simply drag it from the component toolbox to the Work Space Note that the variable object should be used without connecting to other items in a graph The user can update the value of the variable by assigning a value directly referring to the attribute of another item or by equation Reference VARIABLE Type The type of Experiment Builder objects Variable the current node belongs to experiment graph Data Type The data type of the variable could be String ae Integer Float Point Color and List __ The value of the variable Image one experiment in which the display screen alternates between displays A and B and the trial ends after a certain number of alternations The user may want to create a counter to keep track of the number of loops
220. ds no randomization complete randomization Blocking Level 1 Tolun var_abca Randomization Type None Blocking Level 2 Column Randomization Type Hone e None If the randomization type of the blocking variable is set to None the order of the blocking groups will be the same as in the original data file For example the four levels of the var_abcd variable appear in the order of ABCD in the original file The var_abcd variable in the randomization output also appear in the order of ABCD e Random If this is the case levels of the blocking variable will appear in a random order For example blocking by variable var_abcd with randomization type set to Random will create one of the 24 possible orders ABCD ABDC ACBD ACDB ADCB ADBC BACD BADC BCAD BCDA BDAC BDCA CABD CADB CBAD CBDA CDAB CDBA DABC DACB DBAC DBCA DCAB or DCBA 9 6 1 3 Trial randomization and run length control If Enable Trial Randomization box is checked the trial order will be randomized In addition the run length of trials belonging to the same condition within the data file or within a block of trials if blocking is involved can also be controlled To do that choose the Run Length Control variable in the dropdown list currently only one control variable is supported Enter the maximum run length in the edit box and press enter to register the change Note that controlling run length may not
221. dth of the resource screen width Height Height of the resource screen height Prebuild to _prebuildToImage Boolea Always True Image T n Use Software useSoftwareSurf Boolea If false unchecked memory on the video card Surface T n is used to hold the resource blitting from the video card memory to the display surface is fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface Use Runtime useRuntimeIAS Boolea If enabled an Interest Area set file will be Word Segment n created during runtime to contain segment InterestArea information for individual words 1n the text If the user intends to use a character that does not fit in the ASCII encoding range 1 127 please make sure that the Encode Files as UTF8 box of the General Preference settings is checked SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 217 8 1 5 Line Resource Line resource creates a line drawing on the screen Click on the Draw Line Resource button on the toolbar to select the line resource type Place the mouse cursor at the desired line start location in the work space click down the left mouse button keep dragging the mouse cursor until it reaches the desired end location and then release the mouse button The precise location of the line resource can be edited in the property panel Select the
222. e g a x File Edit view Experiment Help l DABBBel SxRaoatl lveroegl x QQQBB Experiment BLOCK i Structure DISPLAY _SCREEN TIMER 4 2a EL_BUTTON KEYBOARD EL_CAMERA_SETUP Connections r Connected From EL_CAMERA _SETUP Simple bP BLOCK Figure 5 1 Sample Experiment Builder Interface r Connects To 5 1 Project Explorer Window The Project Explorer Window allows the designer to select experiment components to be viewed to modify the current property values and to configure default devices eye tracker display audio driver parallel port and Cedrus input settings This window has four individual panels Overview Structure Property and Connections panels Each of the individual section can either be a docked panel of the project Explorer window or a free floating 1 window In addition each of the panels can be hidden or made visible from the View menu SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 28 eof EyeLink Experiment Builder File Edit view Experiment Help pen Overview Properties Fy w Show Properties Panel Connections w Attributes ae Figure 5 2 The View Menu w Overview w Structure w Mote The Overview panel on the top shows the graph layout of all components in the current level of experiment and highlight
223. e 2 1 3 H3 512 384 61 384 962 384 Point order for HV3 calibration type 1 3 2 HV3 512 65 962 702 61 702 If checked user defined validation positions can be used instead of the default positions A list of X Y pairs to specify the validation target positions in the intended display screen resolution These points MUST be ordered on screen and match the calibration type selected This option is only available if the Enable Customized Validation Positions setting is enabled Color used to draw calibration targets and for the text on the camera image display It should be chosen to supply adequate contrast to the background color The color to which the entire display is cleared before calibration This is also the background for the camera images The background color should match the average brightness of your experimental display as closely as possible as this will prevent rapid changes in the subject s pupil size at the start of the trial This will provide the best eye tracking accuracy as well Using white or gray backgrounds rather than black helps reduce pupil size and increase eye tracking range and may reduce retinal afterimages SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 71 streams The user should preload the intended video clip into the library manager Note that this option is presently not available on Mac OS X Animation animationTarge T
224. e The user needs to set value for the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 316 RESPONSE variable and provide audio feedback for each branch of the conditional trigger separately 5 Before working on each branch of the conditional trigger the user should load feedback audio clips into the resource library Click Edit gt Library Manager from the Experiment Builder menu bar In the library manager dialog box see Figure 15 21 e lt Library Manager i x incorrect war a Click on the Sound tab Delete i b Click Add to load in audio files ee ko FPreview Type of file WAYE PCM SIGNED SIZE 9 930 bytes Duration 00 00 00 Channels 1 mong Audio Sample Rate 22 kHz Figure 15 21 Loading Feedback Audio Clips a Select the Sound Tab b Click on the Add button and load in the desired audio clips correct wav and incorrect wav c Click on the close button at the top right corner of the dialog box 6 Add an UPDATE_ATTRIBUTE action and a PLAY _SOUND action a Click on the UPDATE ATTRIBUTE action and rename it as CORRECT RESPONSE Set the Attribute field to parent parent RESPONSE value and Value Field to Correct b Click on the PLAY SOUND action and rename it as CORRECT_SOUND Select Correct wav from the dropdown list of the Sound File property 7 Add another pair of UPDATE_ATTRIBUTE and PLAY_SOUND actions
225. e interest area files into the library manager Select the display screen to which the interest areas are associated and set Interest Area File Name field to a desired interest area set file Please make sure the name of the interest area file does not contain space or non ASCII characters In an interest area file each line represents one interest area The interest areas shall be coded in the following formats Rectangular Interest Area RECTANGLE id left top might bottom label The id left top right and bottom fields must be an integer number For example RECTANGLE 1 118 63 332 208 RECTANGLE_INTERESTAREA Elliptic Interest Area SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 236 ELLIPSE id left top right bottom label The id left top right and bottom fields must be an integer number For example ELLIPSE 2 191 168 438 350 ELLIPSE INTERESTAREA Freehand Interest Area FREEHAND id xl yl XE xn yn label The id field and each item in the pairs of x1 y1 must be an integer number The x and y coordinates in each pair are delimited by a comma For example FREEHAND 3 481 54 484 57 678 190 602 358 483 330 483 327 493 187 468 127 FREEFORM_INTERESTAREA For all three types of interest areas please make sure the individual fields are tab delimited Note Interest areas contained in an interest area file will not be listed under the Interest_Areas folder of
226. e l Connec inm Order esinen craw aeute ancient a E ieee 47 Pioure 7 2 Ee xportine NOG spei aa a EN TEAS CEA 48 Pisure 7 3 Relerence Maimane nte sscan E 48 Figure 7 4 Export Library Piles orabisa ae E 49 Heie 3 Timiportann Nodes a a eee naseeseee 50 Figure 7 6 Choosing Layout of Components in Work Space cccsssssesseeeeeeeeeeeeeeeeees 5I Figure 7 7 Property Field Editable with Attribute Reference Editor cc00e 32 Figure 7 8 Properties of the Experiment NOdCicneccci ican mitten iaiventatieneainbater 54 Figure 7 9 Using Sequence in an Experiment pooten n 58 Figure 7 10 Action Tab of the Component Toolbox ssesseeeesesesessssssssssserresssssssssssssseeeees 59 Figure ide Usine Display S Cre eie aan Denies ceu sate a GaN esa aataas acids 63 Figure 7 12 Using Drit Correction ACuon ssai Santen sivas leiiesaniee Reds ghanisia SS 68 Firre Usine Camera Seip ACH Okei e a T ADEN 74 Figure 7 14 Usine Sending Message AcCHhonicinnosii eena a a 76 Figure 7 15 Using Sending EyeLink Command ACtiOn eeessssessssssssssseererreeesssssssssss 79 Figure 7 16 Using Add to Experiment Log Action ssessssssssssssssssseeeeerrrressssssssssssseeeees 83 Proure 7 17 Usine Update Atri DUte A CHOON corre a E E A 85 Figure 7 18 Usine Prepare Sequence Acton aeaaee ea a EEA EE 90 Figure 7 19 Adding Sound Clips to the Library sseoeennsssssssoeenrsssssssscerrsssssssseeeresssss 91 Figure 7 20 Choose Audio drivef eraci a
227. e some of its default property values can be modified according to the requirements of the experiment For example the maximum duration set in a TIMER trigger is set to 4000 milliseconds by default This may not be the desired value in an actual experiment and therefore the experiment designer needs to set a different value for it To edit the properties of an item click on the item until it 1s highlighted 1 e a gray border encircles it Double clicking on a sequence or a display screen action will also unfold the content of the sequence or display screen and make the current selection take up the whole work space for editing When one experiment component is selected its properties and corresponding values are displayed in the property panel for review and modification Depending on the nature of the property field different operations are required to change the value e Ifa properties field e g Time and Start Time of various actions is grayed out then the value of the property is read only and can only be referred by other components and cannot be directly modified e If the value field of a property contains a check box e g Record property of a sequence that property can be either enabled or disabled by clicking on the check box e Ifa dropdown list appears after doubling clicking on the property value field e g Duration Type property of the Timer trigger make the selection from the list e
228. e 5 26 Save SCreem as IMa enu tank ateawanttatmeeaalwenctuannanua tes 243 Figure 9 1 Using Data Source in Experiment Builder cccceecsssececeeeceeeseeeseeeeees 244 Figure 9 2 Change the Type of Variables wsnnactiucnetiQasisin n n S 245 Figure 9 3 Data Types Used in Experiment Builder cc ccccccceeeeeeeeeteeeeeeeeeees 246 Figure 9 4 Editing Operations for Data Source Columns and RoWG 0 0000008 246 Fig te 9 5 Editing Datasource Cells is issicctiasssacesidiwcsurarsyeuiedavinetenreiaaudieoaceentiastetrtaiandiexs 247 Figure 9 6 Append or Overwrite Confirmation eeseessseeeeeeeeececceeeeeeeeeeeeeeeeeeees 248 Proure 10 1 Usine Air bute RETereme 6S eroe a a sad ateavedinn E 256 Figure 10 2 Creating Equations in Attribute Editor 20 0 0 ccccceccccccececceeeeeeeeeeeeeeeeeeeees 258 Figure 10 5 Using the Reference Manat er errori enera E N neces 260 Figure 11 1 Sending the Recording Status Message to the Tracket 0008 261 Fure t2 editing Tural UD Messa Ecen sxuasgasminatedeskinieaeseausioiases 262 Figure 11 3 Creating Recording Status Message ccccccseeececcceeeeeeeeeeeeeeeeeeeeeeeeeees 263 Figure 12 1 Creatine a New Custom ClasSicincr ideii e e 265 Figure 12 2 Attributes and Properties of a Custom Class Instance eeeeeeeeeeees 273 Figure 12 3 Assigning Attribute Values through Custom Class Instance 274 Figure 12
229. e String Either Word mode the decimal or hexadecimal value of the TTL input value or Pin mode status of each individual pins Data data Integer The byte value of the current input TTL signal This could be a decimal or hexadecimal number This field is only available if the Mode property is set to Word The desired status for the corresponding pins The pin value can be either ON high OFF low or EITHER the status of that pin is ignored This field is only available if the Mode property is set to Pin If using a USB 1208HS box the available output pins can be configued through the device preferences Triggered Data triggeredData If the TTL trigger fires the triggered data can be further accessed see the following table When the TTL trigger fires the triggered data can be further accessed The sub attributes of the TriggeredData field are listed in the following table Time time Float Display computer time in milliseconds from the start of the experiment when the voicekey trigger fires EDF Time EDFTime EDF time when the voicekey trigger fires Pin Data _pinData integer The byte value a decimal number of the current input TTL signal The following discusses some of the common applications of the TTL trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 160 7 10 8 1 Setting the pin values The TTL trigger fires when a pre specified TTL data 1s rece
230. e common applications of the keyboard trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 140 7 10 6 1 Calculating response time from an keyboard input Keyboard responses can be retrieved by using the UPDATE_ATTRIBUTE action Typically you may use a couple of variables to store the key pressed the time RT of the key press and the accuracy of the key press Specifically the key pressed should be retrieved as KEYBOARD triggeredData key the time of key press should be retrieved as KEYBOARD triggeredData time see the following figure With that you can calculate the response time KEY_PRESS_TIME value DISPLAY_ON_TIME value In case the trial can end without having the subject to press a key you may use the UPDATE_ATTRIBUTE to reset the default values for the variables at the beginning of the trial so that the response data from the previous trial will not be carried over to the current trial Don t forget to add the variables to the EyeLink DV Variable list or to the RESULT_FILE RESET DATA oof Attribute Yalue List for GET_RESPONSE oo le KEY PRESSED value KEYBOARD triggeredData key a KEY PRESS TIME valued E KEYBOARD triggeredData timem DISPLAY _ON_TIME value DISPLAY_TARGET time DRESPONSE_TIME value Fint KEY_PRESS_TIME value DISPLAY_ON_TIME value Please Set Attribute Please Set Value x a hl KEYBOARD P Eg M
231. e emitted from the sound card within 3 milliseconds plus or minus of the scheduled time e If the sound is commanded to happen as quickly as possible e g for example in response to a subject response external signal or eye movement event or if the sound play command was not given far enough in advance e g the PLAY _SOUND action is preceded by a TIMER with a duration shorter than 20 ms Experiment Builder is unable to compensate for system delays and the audio will begin after a short delay However the exact moment that the sound will play is predictable and can be reported precisely for analysis later This applies to experiments in which the PLAY_SOUND action is preceded by an action or by a node other than TIMER e Experiment Builder allows to synchronize the playing of the audio clip and displaying of visual stimuli when the display screen and play sound actions are intervened with a SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 95 TIMER trigger only Experiment Builder also allows the users to set the audio clip information from the DISPLAY_SCREEN action directly by enabling Audio Synchronization check box The user needs to specify the clip to be played and the time offset relative to the display onset a negative offset value means that the audio clip is played before visual onset whereas a positive offset means that the visual information is presented earlier Please note that in this case the user
232. e for the display screen action The width of the display screen in pixels 1024 by default Height The height of the display screen in pixels 768 by default The background color of the screen The Color r default color is white 0 0 0 Bits Per Pixel bitsPerPixel The number of bits 32 by default used to represent the luminance and chroma information contained in each pixel Auto Generate autoGenerateSyn Boolea Whether or not to a send a default message Sync Messages T cMessages n SYNCTIME when the display changes This message will not be generated if the EyeLink Message field is filled The default setting is false box unchecked screen action not including screen background Grid Rows NR Integer If the toggle grid visibility button in the Screen Builder toolbar is on several horizontal lines will be drawn to divide the screen into the specified number 2 by default of rows Grid Columns If the toggle grid visibility button in the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 60 Force Full Redraw t Estimated Prepare Time Default Estimated Prepare Time Auto Update Screen Send EyeLink DV MessagesTt Use for Host Display T forceFullRedraw estimatedPrepare Time defaultEstimated PrepareTime autoUpdateScree n sendEyeLinkDV Messages useForHostDispl ay Boolea n Boolea Boolea n n
233. e number of saccade events cached in the saccade event queue Button Event Count buttonEventCount The number of button press released events cached in the button event queue Use Keyboard useKeyboard In a project with multiple input support this specifies the display keyboard s that can be used to control the camera setup calibration and drift correction process SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 331 Use Mouse useMouse In a project with multiple input support this specifies the display mouse mice that can be used in the camera setup process The following table lists possible data that can be retrieved from the last eye sample Display computer time in milliseconds from the start of the experiment when the triggering sample occurs EDF Time EDF Time EDF time of the triggering sample Eyes Available eyesAvailable Triggered Eye triggeredEye PPD X PPD Y PPDX PPDY Left Gaze X leftGazeX right Float Right Gaze X GazeX average Average Gaze X GazexX Float averagePupilSize Size l Left Velocity leftVelocity Float rightVelocity average Velocity 1 Right Velocity leftAcceleration Left Gaze Y Right Gaze Y Average Gaze Y Left Pupil Size Right Pupil Size Average Pupil leftGazeY right GazeY average GazeyY leftPupilSize ri ghtPupilSize Left Acceleration Right Acceleration Average Acceleration Angle Average Velocit
234. e of the text resource after applying the center alignment will not display the text in the center of the screen 8 4 3 Resource Locking SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 238 When building the screen the user may want to lock a resource just in case it is moved or resized by accident To do that place the mouse cursor over the resource click the right mouse button and select Lock Selection To unlock the resource select the Unlock Selection x x ELLIPSE RESOURCE cannot be moved or resized because it is locked Figure 8 20 Error When Trying to Modified a Locked Resource When a resource is locked any attempts to change the resource from the workspace will prompt an error see Figure 8 20 If the resource appearance should be adjusted the user can make the modification from the property panel of the resource Alternatively the user can first unlock the resource do the adjustments and then re lock the resource 8 4 4 Resource Grouping Resource grouping offers a handy tool so that the same operations can be applied to individual component resources together For example after a schematic face is created on the screen with several components resources the user may want to adjust the position of the whole drawing It will be much easier if all of the components resources are grouped and moved together than the individual resource components are moved one by one To group s
235. e screen resource interest area location type can be set by the Screen Preferences This means that SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 121 references should be created differently depending on whether the region location of a trigger refers to a center based resource or a top left based screen resource Imagine that an invisible boundary trigger should fire when the eye is within a rectangle resource RECTANGLE_RESOURCE The top panel of the figure below illustrates creating the Region Location reference when the RECTANGLE_RESOURCE is top left based DISPLAY_SCREEN RECTANGLE RESOURCE location The bottom panel of the figure illustrates creating a location equation when the location type is center based EBPoint DISPLAY _SCREEN RECTANGLE RESOURCE location x DISPLAY_SCREEN RECTANGLE_RESOURCE width 2 a a p m Wi K Properties H x Property Value abel NVISIBLE_ BOUNDARY Type Node Path Boundary BLOCK TRIAL RECORDING INVISIBLE BOUNDARY BSSage ime ast Checked Time Konfidence Interval Region Direction RECTANGLE OISPLAY_SOREEN RECTANGLE_RESOURCE width ren Location Type Region Type Region Location Top Lett Region Width fi wy a Ca J E wy C 0 m m 0 m J va E m 0 m wy D me 0 C ou Fey Region Height MeDISPLAY SCREEN RECTANGLE RESOURCE height ocation ininum Duration e
236. e standard calibration and drift correction Size target is a filled circle for peripheral delectability with a central hole target for accurate fixation The disk is drawn in the calibration foreground color and the hole is drawn in the calibration background color The Target Outer Size property specifies the diameter of the outer disk of the default calibration target in pixels Note that this property is only available if Use Custom Target is not checked Target Inner nnerSize Integer Diameter of the inner disk of the default Size calibration target in pixels If holesize is 0 no SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 72 central feature will be drawn Note that this property is only available if Use Custom Target is not checked Target Beep J targetBeep String Experiment Builder plays alerting sounds during calibration These sounds have been found to improve the speed and stability of calibrations by cueing the subject and make the experimenter s task easier The Target Beep property specifies the sound to play when target moves If set to DEFAULT the default sounds are played if set to OFF no sound will be played for that event otherwise a sound file from the audio library can be played on failure or interruption play on successful operation Enable Toggling through different camera views External enableExternal Boolea adjusting pupil and CR thresholds and
237. e text is still selected Now click the buttons on the toolbar to set the desired text appearance font name font size font style alignment style line spacing and text color Click on the Close button at the top right corner of the dialog to finish Please note that instead of using multi line text resource the user can also create the instruction screen by using an image resource See Section 8 1 1 14 1 6 Editing Trial Sequence Data Source Next we will work on the sequence which will contain all necessary triggers and actions in each trial We will also need to create a data source to be used for setting parameters in individual trials see Figure 14 9 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 286 DEBS S FxX BART A TANS cher a li n Qaa BEE L2H experiment BLOCK oeePLay scree TRIAL TRIAL DataSource wn Sting Cee j Teo j p Three Ee Simple l Four if START lai Add Mew tolunin Pca NRT e rin gt BLOK z al start Tp Seven 5 oseLay SCREEN a E Eigh fa KE BOMAL a k bire pose of Do cameacene 1 Fleet 6 Enter value press Jul s 12 m mere Enter key to register z i qp Click here to start change experiment Campanerte Davvicns 15 Click Start to Pro iperties ET continue Property vate Lape RAL a Edit label 4 Click here to add columns f 5 Click here to add rows LE
238. e work area 4 Click on the Triggers Tab of toolbox select the TIMER node hold down the left mouse button and drag the trigger into the work space Double click on the Timer object Enter Time out without quote in the Message value field and 10000 in the duration field SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 289 5 Add an EyeLink Button trigger 6 Add another display screen action Double click on the action and modify its label as DISPLAY_BLANK Also uncheck the Send EyeLink DV Message box 7 Make a connection from the START node to DISPLAY_SCREEN from DISPLAY_SCREEN to TIMER from DISPLAY_SCREEN to EL BUTTON from TIMER to DISPLAY BLANK and from EL_BUTTON to DISPLAY_BLANK 8 Click at any blank area in the work space then click the right mouse button and select Layout in the popup menu Click ok in the following dialog box This will re arrange the nodes in an orderly fashion 9 Click on H button in the properties window to make it a free floating window 14 1 9 Modifying Properties of Display Screen We will first need to check the property settings of the display screen actions see Figure 14 12 For better Data Viewer integration and for reaction time calculation a message should be written to the EDF file to indicate the time when the stimulus was visible to
239. eTrackingSamplingRate Sets sampling rate for EyeLink 1000 The avaible options are 1000 default 500 and 250 Eyes To Track eyesToTrack Select the eye s to track during recording For a binocular eye tracker EyeLink I and II the default is BINOCULAR For monocular EyeLink 1000 tracker the default is EITHER Pupil Size pupilSize Record the participants eye area or diameter in arbitrary unit Fixation Update Interval fixationUpdateInterval During fixation send updates every m msec integrated over n msec max m min 4 msec These can be used for gaze controlled software or for pursuit tracking Intervals of 50 or 100 msec are suggested Interval of O disables Fixation Update Accumulate fixationUpdateAccumulate During fixation send updates every m msec integrated over n msec max m min 4 msec Normally set to 0 to disable fixation update events Set to 50 or 100 msec to produce updates for gaze controlled interface applications Set to 4 to collect single sample rather than average position Auto Calibration Message autoCalibrationMessage Should the calibration messages be printed in the EDF file Velocity Acceleration Model velocityAccelerationModel EyeLink 1000 only This allows to choose the model 5 sample 9 sample and 17 sample used to calculate velocity and acceleration data Current Time currentTime Returns the current tracker time in milliseconds The tracker clock st
240. earch Experiment Builder User Manual 2004 2011 SR Research Ltd 30 see section 7 5 Editing Properties of a Node The Note section of a properties panel allows the user to add comments to the node The Connections panel lists all of the nodes that are connected to the current node The Connected From section lists all of the nodes that target the current node and the Connects To section lists all of the nodes that receive a connection from the current node 5 2 Graph Editor Window The Graph Editor Window provides the interface where the experiment can be created graphically This window can be divided into four sections the Component Toolbox Work Space Editor Selection Tabs and Navigation Nodes The Component Toolbox contains the basic building blocks of the experiment graph and allows the designer to select a desired component to be added into the experiment The experiment components are grouped under three categories trigger including timer invisible boundary conditional EyeLink button Cedrus Input TTL keyboard mouse voice key fixation saccade and sample velocity trigger action displaying screen performing camera setup performing drift correction sending EyeLink message logging experiment sending EyeLink command updating variable attribute preparing sequence adding to result file adding to accumulator sending TTL signal playing recording sound controlling sound playing recording terminating e
241. eared when the action 1s performed meaning that any events already in the queues will be evaluated by Triggers following the action In the following example Figure 7 23 an ERROR_COUNT variable is used to store the number of errors made in the experiment When a target button is pressed the ERROR_COUNT is updated If the error count exceeds a pre set number the experiment can be terminated earlier by the TERMINATE_EXPERIMENT action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 105 ERROR _COUNT START DISPLAY_SCREEN A DISPLAY _SCREEN EA TIMER at EL_BUTTON DISPLAY _BLANK ERROR_COUNT TIMER X Y UPDATE_ERROR_COUNT P CONDITIONAL SEND_EL_MSG TERMINATE EXPERIMENT fis CONDITIONAL POMEL ERMINATE_EXPERIM Object Type erminateExperiment yelink Message ime Slat Tme A B Figure 7 25 Using Terminate_Experiment Action 7 9 18 Recycle Data Line Recycle Data Line action 2 instructs the experiment sequencer to perform the current data source line at a later time Note If Recycle_DataLine action is used such that neither the containing sequence nor the parent s of the sequence has data source a build time error will be raised Reference Label of the Recycle DataLine action The default value is RECY1000E_DATALINE Type NR The type of Experiment Builder objects C RecycleDataLine the current node belongs to experiment graph Message message String Message to be s
242. ecording see Figure 15 10 The prepare sequence action allows the user to preload the image files or audio clips for real time image drawing or sound playing to draw feedback graphics on the Host PC to evaluate participants performance and to reinitialize trigger settings In addition we will add a couple of variables to store data such as RT key press trial response accuracy for each trial SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 306 SE he nh Esperiment faery LADS RC Sire al x Fils View Experiment Help Feage E M a TAOS sheer E O28 4B Be ws BLOCH nem ay cope TRAL TRIAL DataSource l foo mia a 4 4101s 0 9 19f Other int ETART TRA INEZ EE TRPRESS FESFONEE RT Moo Y uPpaTe_aTreiwte 1 2 3 4 Click on the Other tab of the Strmbure eS TRAL z am repr hs mE 3 5 i J HAR stam 5 Set initial values xv component toolbox to add variables edit their eee of the variables for labels and set initial values j i HevPRESs each trial RESPONSE y _ PREPARE_SEQUENCE i FT j j i OT UPDATE ATTRIBUTE e mit 6 Add a prepare sequence action T Add a sequence i iem inpud Gumus losd Screen Resm tes Load Junio antisite Trager Pemndisice Actors Freenfiaicze w Riep FRAD lauaga haat Figure 15 10 Editing Trial Sequence 1 Click on t
243. ect the Keyboard trigger hold down the left mouse button and drag the action into the work area 3 Add an EyeLink Button trigger to the work space 4 Add a Timer trigger to the work space 5 Click on the Timer trigger and set the duration to 20000 msec 6 Click on the Action Tab of the component toolbox and add a Camera Setup action to the work space Click on the action and set the Background Color to white 255 255 255 7 Click on the Action Tab of toolbox and add a Sequence node to the work space This will be our trial sequence SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 283 8 Place the mouse cursor on top of the START node Hold down the left mouse button while moving the mouse on top of the DISPLAY_SCREEN node This makes the connection from the start node to the DISPLAY SCREEN node 9 Similarly connect from DISPLAY_SCREEN to KEYBOARD EL_BUTTON TIMER triggers Note that a number is added to these connections indicating the evaluation order among the three trigger types 10 Make the connection from the latter three triggers to the EL_CAMERA_SETUP node and from EL_CAMERA_SETUP to the SEQUENCE node DEBS S PRR AGRHA TAOS aerAl QO OARB aE EE experiment GLO K k i zO S lola 20e b i E E Ji stant dp BLOCK i i 1 Click on the Action tab
244. ecution several times if required In a typical experiment the user needs to add a couple of nested sequences so that blocking trial recording hierarchy can be implemented SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 54 efficiently In an EyeLink experiment the Record attribute of one of the sequences must be checked so that eye tracking data can be collected Reference Label of the Sequence node The default label is SEQUENCE The type of Experiment Builder objects Sequence the current node belongs to The absolute path of the node in the experiment graph Time time Float Display computer time in milliseconds from i the start of the experiment in milliseconds pee fie when the sequence is executed Record T record Boolea Whether EyeLink recording should be done n within the sequence Recording starts at the beginning of each iteration of the sequence and ends at the end of each iteration of the sequence The default setting is False box unchecked This attribute is only available in an EyeLink experiment EyeLink eyeLinkRecordS String This supplies the title at the bottom of the eye Record Status tatusMessage tracker display This property is only available Message for a recording sequence This attribute is only available in an EyeLink experiment with the Record setting of the current sequence enabled Recording Pause recordingPauseT Integer
245. ed Windows Logo testing to verify its compatibuility with Windows XP A green check mark will be drawn if the driver is successfully installed You may be prompted to reboot the computer if the driver for a PS 2 keyboard mouse is updated Hardware Installation A The software you are installing for this hardware SREB Mouse Filter has not passed Windows Logo testing to verify its compatibility With Windows F Lell me why this testing is important Continuing your installation of this software may impair or destabilize the correct operation of your system either immediately or in the future Microsoft strongly recommends that you stop this installation now and contact the hardware vendor for software that has passed Windows Logo testing Continue Anyway STOP Installation SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 156 Figure 7 56 Click Continue Anyway on logo testing warning 4 Open the experiment project click Edit gt Preference gt Experiment to open the Experiment preference settings and tick the Enable Multiple Input option 5 If multiple keyboards are used go to the Keyboard Device preferences set the intended number of keyboards for the experiment project and assign a distinct label for the keyboards if you need to If multiple mice are used go to the Mouse Device preferences set the intended number of mice for the experiment project and assign a distinct label for the
246. ed for the last time Confidence confidenceInterv Float Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time accessed over time The current option checks whether the saccade event s cached in the event queue should be cleared when the trigger fires Clear Input clearInputQueue _ EyeLink saccade trigger maintains an event Queue queue so that multiple saccade events can be SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 169 NO no event clearing Event removes the current triggering event from the saccade event queue LIST all saccade events from event queue will be removed Region Type regionType String The type of triggering Region used RECTANGLE 0 ELLIPSE 1 or INTEREST AREA 2 Note that the INTEREST AREA option is only available when interest areas are defined in one of the display screens in the same recording sequence Region regionDirection List A range of eye angles from a multiple selection Direction list 0 45 45 90 90 135 135 180 180 135 135 90 90 45 45 0 used to restrict the direction in which the saccade trigger fires Region Location regionLocation Point Pixel coordinate of the top left corner of the Top Left bound
247. ed from each click of the add button To import multiple images you may first use Finder to select all of the images to be imported and then drop them into the image tab of the library manager Please make sure the image file name does not contain space or non ASCII characters 5f Library Manager q x Add Delete ii Rename Properties Type of file Pts Size 63 849 bytes B a meso vvictth 1024 pixels vam Fes ce tpl Height TOG pixels ha tr a F Henr Rin EEEE Seek hT Hy be ed a a Fa Bit Depth 24 Figure 8 3 Loading Images into Image Library The following image file formats is supported by the current version of Experiment Builder PNG TIF GIF JPG BMP and PCX Please note that the current version of Experiment Builder doesn t support transparency manipulations through alpha channel So when you save some of the image formats e g png tif file format please make sure it doesn t contain the alpha channel bits For example when saving images in Adobe Photoshop make sure the Alpha channel option is unchecked Similarly BMP files with 32 bit depth will not be displayed properly To add an image resource onto a display screen click on the Insert Image Resource button tay on the Screen Builder toolbar and then click anywhere in the screen workspace When a Select Image dialog shows up choose the desired image file The image will now be displayed on the screen To adjust the po
248. ed over to the current trial Don t forget to add the variables to the EyeLink DV Variable list or to the RESULT_FILE RESET_DATA T Marans PMOUSE BUTTON PRESSED valem MOUSE triggeredData buttona I MOUSE_BUTTON_PRESS_TIME value DMOLISE triggeredData time DISPLAY_TARGET ia DISPLAY_ON TIME value DISPLAY TARGET time DRESPONSE TIME valuea Eint MOUSE_BUTTON_PRESS_TIME value DISPLAY_ ect Attribute Yalue List for GET_RESPONSE X a T F ease Set Atkribuke lease Set Value GET_RESPONSE xY Figure 7 52 Collecting mouse response data To evaluate the accuracy of the button press you will need to know what s the expected button press for the trial This can be encoded in the datasource with a number column Use a CONDITIONAL trigger to check whether the pressed button matches the expected button and then use an UPDATE_ATTRIBUTE action at each branch of the trigger to update the accuracy variable accordingly check HTML version of this document for the complete example project SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 153 DISPLAY_TARGET GET _RESPONSE ttribute Dparent parent TRIAL DataSource expected buttona CHECK_RESPONSE omparatar EOUALS alue TMOUSE BUTTON PRESSED valued ind Or Select Figure 7 53 Checking mouse response accuracy 7 10 7 4 Collecting inputs from the mouse without ending the trial Sometimes the subject s bu
249. ed within a BLOCK sequence The Record field is checked in the RECORDING sequence but not in the BLOCK or TRIAL sequences The RECORDING sequence also allows the user to send a message EyeLink Record Status Message to the tracker screen so that the experimenter can be informed of the progress of the experiment Sequence START T EL_CAMERA_ SETUP Experiment Components Devices Froperty Value abel BLOCK Time Le ls Real Time E eration ae ee Split by i ee alumns 0 Rows O A B SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 57 Sequence 5 START i BLOCK START T EL_CAMERA_SETUP Sequence 5 START i BLOCK START T EL_CAMERA_ SETUP RECORDING o Experi ment Components Dewices Experi ment Components Devices time fine SSCS Record E S sR MSS Recording Pause Tme feo C l EyeLink Record Status M E Tra sr TRIAL ean S OOOO teration Court po sy eaa E Data Source feraion SiS nn teration Count SOT oo o o cpitby SS olumns Os Rows 0 Q Pa g m pm T iT J Figure 7 9 Using Sequence in an Experiment The iteration count of a sequence specifies the maximum number of repetitions the sequence should be executed whereas the Split by field allows the user to flexibly configure the number of actual iterations to be executed By default the Split by field contains an empty list which means that all of the iterations should be execu
250. eeaeeeseeeseeeeeeeeeeeeeeees 19 Figure 4 3 Warning Messages after Experiment Creation eseseseessssssssssseerreresessessssssss 20 Figure 4 4 Open an Experiment Builder Session cccccsseeeecceecceeeeeeeeeaeeeeeeeeeeeeeees 21 Figure 4 5 Save Confirmation When Opening a New SeSSION cccccceeeesseeeeseeeeees 22 Figure 4 6 Reopening Recent Experiment Sessions sseeeeesssssssssssssssseeerrrreeesssssssssss 22 Froure 4 7 Experiment Moeaa E E 24 Figure 5 1 Sample Experiment Builder Interface snnnnneeeessssssssssssssssseeerrerersssssssssss 28 Feire o2 TMe View Moi ale ceaed aes aw rece cece aedl sien reece ene eonsaaiee 29 Figure 5 3 Components of the Project Explorer Window cccccccseseseeeeeeeeeeeeeeeeeeees 30 Figure 5 4 Different Tabs of the Structure Panel cccccesnnntseeseseeeeeeeeeeeeeeeeees 30 Figure 5 5 Components of the Graph Editor Window cccccccccccsntteeseesseeeeeeeeeeeeees 32 Figure 6 1 Hierarchical Organization of Events in an Experiment eeeeeeeee 36 Figure 6 2 Sample Experiment Sequence ccceesssssessssseeeeeeceeeeceeceeeeeeeaeeeeeeeeeeeeees 37 Figure 6 3 Connecting between Source and Target Components cccceeeeeeeeeees 38 Figure 6 4 Nested Sequences in an Experiment cccceccsseccceccceeeeeeseeecceeceeeaaeesseeeeeees 43 Figure 6 5 Using a Reference to Update Text to Be Displayed ce eeeeeeeeeees 44 Mour
251. een is contained in a recording sequence IMPORTANT If this attribute is False the run time drawing may not look exactly as it does in the screen editor In addition images will not be saved to support Data Viewer overlay Use Software useSoftwareSurf a If false unchecked memory on the video card Surface T is used to hold the resource blitting from the video card memory to the display surface is fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface _ ee in which the outline is drawn The default color is medium gray ee 128 128 Screen Location er Whether the location specified below refers to Type the top left corner or center of the resource This setting can be changed at Screen Preferences filled The default setting is True Color in which the interior of the freeform is filled The default color is medium gray 128 128 128 Specifies the width 1 by default of the pen in pixels points 8 2 Movement Patterns A screen resource does not need to be static when shown on the screen Instead it may move at a constant speed oscillate sinusoidally or jump discontinuously SR Research SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 225 Experiment Builder supports the generation of various resource movement patterns This will be convenient for creating experiments showing moving targe
252. eessssssssoerrsssssssseeersssss 214 Figure 8 9 Setting the Transparency Color for the Experiment cccceeeeeeeeeeeeeeees 215 Fiure S 10 Multiline Text EONO crcire a 216 Freure S Ni Creatine a Movement Pateri errn A 226 Figure 8 12 Adding Resource Positions to a Custom Movement Pattern 0 0 229 Figure 8 13 Creating a Custom Movement Pattern ccccccecccccceccecceeeeeeeeeeeeeeeeees 230 Figure 8 14 Creating a File based Custom Movement Pattern cc ceeeeseeeeeeeeeees 231 Figure 8 15 Toggling Interest Area Visibility cc eeeccscccccccceeeeseeeeeceeeeeeaaeeeneeeeeess 233 Figure S 10 Creatine am IM erest ATOT anen icterd evita tieveudueteauciesshesicie Mette wieieucees 233 Figure 8 17 Creating Interest Area with Grid Segmentation ccceeeeeeeeeeeeeeeeees 236 Figure 8 18 Resource Alignment Left and Toggling Grid Visibility eee 238 igure 6219 Snap 00 Gr der ee E O E Geonsaaseenstases 238 Figure 8 20 Error When Trying to Modified a Locked Resource cccsseeeeeeeeees 239 Fis re 9 2 l Resource Gro piN o ensen a E eochetus ews ediseas 239 Fisure 22 Creatine a Comp ste Resource siirde E E 240 Figure 8 23 Two Resources with Different Resource Order sssssesseeeeeereeressssssssss 240 Figure 8 24 Changing the Order of Resources ssseenssssssssseersssssssscerrssssssssceressssss 241 Fig re 25 Choosing Fit to screen OPUON srra ede 242 Figur
253. eference and the Execute Sequence and Update_Attribute actions With these options the user can set values for the class attributes and pass parameters to the class methods Conversely the user can also retrieve the current value of a class attribute and access the return value of a class method The bi directional direct exchange of data between the custom class attributes and experiment builder GUI is supported by the getX and setX methods For class attributes with a corresponding setX method without a default value as the function parameter the user can set a value an equation or a reference for the class attribute directly in the custom class instance Of course the user can also use an Update Attribute action to set a value reference for a class attribute Similarly if a class attribute has a corresponding getX method its current value can be retrieved and used directly much like any other EB components e g a variable SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 273 Properties all x Property abel USTOM CLASS INSTANCE Type CustomClassinstance BLOCK CUSTOM CLASS INSTANCE est CustomClass Template Assigning a value directly F ead only attribute TRIAL TRIAL DataSource width GTRISAL TRIAL DataSource height Enterms al equation Color value Refernng to other attribute property 1 abc EBColor 200 100 100 property s TRIAL TRIAL DataSource imaged Reterme to Datasource yhiethod
254. egion Type property is set to INTEREST AREA Pf The user can further get access to the triggered data if a saccade trigger fires The sub attributes of the TriggeredData field are listed in the following table Start Time StartTime Integer Display computer time in milliseconds from the start of the experiment when the triggering saccade starts End Time endTime Integer Display computer time in milliseconds from the start of the experiment when the triggering saccade ends EDF Start Time EDFStartTime Integer EDF time time since the EyeLink program started on the Host PC when the triggering saccade starts EDF End Time EDFEndTime EDF time when the triggering saccade ends Eyes Available eyesAvailable Integer This attribute is depreciated it will always return the same value as the Triggered Eye property To find out the eye s used in the recording please check the Eye Used property eyeUsed of the EyeLink Device Triggered Eye triggeredEye Integer Eye 0 for left eye 1 for right eye whose data makes the current saccade trigger fire Duration of the triggering saccade started started ended ended screen pixels per visual degree PPD screen pixels per visual degree PPD screen pixels per visual degree PPD screen pixels per visual degree PPD Average velocity in degrees second of the saccade Peak Velocity Float Peak value of gaze velocity in degrees sec
255. elative to the position of the current gaze or mouse position The default value is 0 00 0 00 for a perfect alignment of the resource position with the current gaze or mouse position The color of the box drawn on the host screen to show the position and dimension of the current resource This property is available only 1f the Use for Host Display option of the containing display screen action is enabled and Draw to Color Host Outline hostOutlineColo Color EyeLink Host of the prepare sequence action is set to PRIMITIVE Whether the location specified below refers to the top left corner or center of the resource This setting can be changed at Screen Preferences The coordinate of the top left corner or center of the resource If the Offset is non zero the actual screen position where the resource 1s displayed Screen Location NR Type will be the coordinate set in the location field Location location Point minus the offset adjustment Width Float Width of the video stream in pixels Height Height of the video stream in pixels Al ol A e Pattern 7 resource Surface ace n Location clipping region Clipping Width clippingWidth Float Intended width in pixels of the clipping region of the resource Only part of the video image within clipping region will be shown Clipping Height clippingHeight Float Intended height in pixels of the clipping region of the resource
256. end or receive TTL signals SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 80 Note that this is always set to USB 1208HS on Mac OS X Usually set as DATA register Note that this option is only available on Windows when the device is set to a parallel port Mode mode String Either Word mode the decimal or hexadecimal value of the TTL signal output or Pin mode status of each individual pins Data data Integer The byte value of the current TTL signal output It could be a decimal or hexadecimal value This field is only available if the Mode property is set to Word String The desired status for the corresponding pins The pin value can be either ON high or OFF low These fields are only available 1f the Mode property is set to Pin If using a USB 1208HS box the available output pins can be configued through the device preferences For most parallel ports you will need to use the DATA register in the Register property of the SET_TTL action to send out a signal TTL communication works by the detection of a change in the pin status in the receiving end So you will typically send a clearing signal e g 0x0 after sending your intended TTL signal You can send out the clearing signal a second SET_TTL action either at the end of the trial or some time gt 20 ms gap is recommended after the initial TTL signal You will not see any change in the receiving end
257. ent Builder User Manual 2004 2011 SR Research Ltd 119 target is missing or if running a non Remote eye tracker Target Flags targetFlags Integer Flags used to indicate target tracking status 0 if target tracking is ok otherwise error code This option is for EyeLink Remote eye tracker only Returns MISSING_DATA 32768 if running a non Remote eye tracker Note Returns MISSING_DATA 32768 for the untracked eye 2 For EyeLink I and II the velocity and acceleration of the 2nd sample before the triggering sample are reported For EyeLink 1000 the reported velocity and acceleration values belong to the nth sample n 2 4 or 8 respectively if a 5 9 or 17 sample velocity acceleration model is used before the trigging sample The Invisible Boundary Trigger can be used to check whether the participant s gaze position crosses a specified region and therefore is useful for experiments involving the boundary paradigm To make this trigger useful the user needs to specify a triggering location For example if the user wants to change a display immediately after the participant s left eye gaze position is in a rectangular region 100 384 250 818 the recording sequence can be programmed as the following SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 120 CHH InvisibleBoundary Test YF START V PREPARE_SEQUENCE START of a RECORDING START tH DISPLAY INITIAL KAIN ISIELE
258. ent to EDF file in an EyeLink nn en experiment or messages txt in a non EyeLink experiment with Save Messages attribute of SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 106 ee E E aaa is done Time time Float Display computer time in milliseconds from the start of the experiment when the action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when this action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues f S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Data Source NR The data source from which the current trial data line will be repeated Recycling Mode recyclingMode Method of data source line recycling If set to 4 IMMEDIATE 1 the same data source line will be repeated in the next trial if set to RANDOM 0 the data source line will be repeated at a random point later if set to END 2 the data source line will be repeated at the end of the experiment Rec
259. enting frames in reverse order will be strongly influenced by the video codec used and the specifications of the display computer Performance will generally be worse than when playing the video in the standard first to last frame order resource library Frame Rate frameRate Integer Intended number of frames default is 30 0 to be displayed each second typically set to 30 frames per second for NTSC or 25 frames per second for PAL formatted video The actual frame rate of the original video clip is displayed in the property fields of the video clip in the library manager see the figure above Please note that a frame rate higher than the screen refresh rate is not possible Apply applyTransparen Boolea If checked transparency manipulation will be Transparency cy n applied to the video resource similar to that is done on the image resources 1 e pixels with the same color value as the transparency color will not be displayed We recommend keeping the default setting unchecked Is Playing isPlaying Boolea Whether the video clip is playing Returns n True if the clip playing is still in progress or False if the playing has stopped or hasn t started yet screen This number increases by one for every frame presented currentFrameInd Integer The currently processed frame number This ex should be identical to Current Frame Number for a non looping video For video played in a
260. eployment PC 1 3 1 3 Host Computer and Display Computer Software Requirements 1 a2 Software Installation and Licensing On Windows ccccccessseeeeeeeeceeeeeeeeeeees 1 3 2 1 For Standard Installation applicable to most users ssseeeenesssssseeeesssss 12 3 2 2 For Installation using Network Licensing cc ceeceeeececeeeeeeeseeeeeeeeeeeeaaas 12 3 2 3 HASP Driver Installation and Licensing i eeeeeceececeeceeeseeeeeeeeeeeenaas 13 3 3 Software Installation and Licensing on Mac OS X aeeessssssssssssrrsssssssseeerrssss 14 SoA Sotware Instalatio mr irani E A EE 14 3 3 2 HASP Driver Installation and Licensing eseessseoeensssssssseeeresssssssseeressssss 16 A WO Oy Ts et S ict ecseceethonins etcita cn dation A eet neat ania 18 4 1 Cheam era NCW CS SION iia aeadieereh dt cau taeaniae ain Sade Sic saeh dm oae elec wen tae 18 4 2 ROE AYA 1 Sars E E E E EE AE E E E A A AE E E 20 4 3 Saving an Existing Session to a Different Directory sssseeessssssssecrresssssssee 21 4 4 SE BSCS S10 1M A E A E E EA E A E N E E E E 21 4 5 Reopening a Recent Experiment Session ssssssseessssssssseerrssssssssererssssssseeeeees 22 4O Packacino an EX periiient Ail cncnccsn sitter wianscw piicacsealca asian sve teidearnsbemiets 23 4 7 Unpackine an Exprimer e a tees saa boonaea nak 23 4 8 Buildinsan EXPerimMen tesien a E apices 24 4 9 Cleaning an EX periment ncs i a a a R i 2
261. equence IMPORTANT If this attribute is False the run time drawing may not look exactly as it does in the screen editor In addition images will not be saved to support Data Viewer overlay Rectangle Resource button L on the toolbar to select the resource type Place the mouse cursor on the location intended for the top left corner of the rectangle then click down the left mouse button and drag the mouse to the desired location for the bottom right corner of the rectangle resource and then release the mouse button The precise location of the resource can be edited in the property panel the Location Width and Height attributes The appearance frame color frame line width interior color of the rectangle resource can also be adjusted If Filled property is set to true the interior of the rectangle will be filled with the filling color otherwise only the frames of the rectangle will be drawn and the setting of filling color will be ignored Reference RECTANGLE RESOURCE Type NR The type of screen resource C RectangleResource the current item belongs to Visible T visible Boolea Whether the resource should be visible The n default setting is True Screen Index Index of the resource in screen resource list O n Position is Gaze positionAtGazeC Boolea Whether the position of the resource is Contingent T ontingent contingent on the gaze position The default setting is Fa
262. equence should end in 4000 milliseconds The user may design the graph as following START TIMER_B DISPLAY_A TIMEQUT TIMER_A SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 115 Timer Jif START h SEQUENCE START DISPLAY _A DISPLAY _B 5 TIMER_B TIMEOUT Timer Jif START Eie SEQUENCE rH DISPLAY B e TIMER_B Experiment Components Dewices Experi ment Components Devices es gt Label IMER_ 4 Label TIMEOUT Type Tirier ype Timet i o Z Z Timne Time ast Checked Time A ast Checked Time t onfidence Interval Duration 4000 onfigdence Interval Duration E uration Type Duration Type secs Start Time STARTtime lapsed Time Figure 7 30 Using Timer Trigger Note that the Start Time of TIMER _A and TIMER _B is set to 0 which means that the timers reset themselves when Display_A and Display_B actions are repeated The Timer TIMEOUT controls the maximum duration to stay within the sequence and therefore its start time shouldn t be reset when either of the two display screen actions is repeated The start time of this trigger is set to the start of the subgraph START time instead Fs art Time lapsed Tire 7 10 2 Invisible Boundary Trigger The EyeLink tracker provides two streams of eye position samples up to 2000 times per second for an EyeLink 1000 eye tracker and events eye movement events suc
263. er x integer and y integer fields followed by an optional message field string Neighboring fields should be separated by a tab 0 512 384 1000 100 384 6000 800 384 Left End Right End Start of Movement Add this file to the Movement Pattern tab of the library manager Select the desired custom pattern in the Structure panel and check the Use Points From File box Select the movement pattern file from dropdown list or specify the file with the attribute editor SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 230 Picture F START dja RECORDING H DISPLAY _SCREEM a Interest_Areas CJ Movement_Patterns _ CUSTOM_PATTERN 7 ELLIPSE_RESOURCE amp TIMER aa EL_BUTTON H DISPLAY _BLANK Experiment Components Property Figure 8 14 Creating a File based Custom Movement Pattern The following is a list of properties for a custom movement pattern Reference nee i Label of the custom movement pattern The default label is CUSTOM_PATTERN ne The type of Experiment Builder objects CustomPattern the current item belongs to Screen Location NR Whether the locations specified refer to the Type top left corner or center of the resource This setting can be changed at Screen so Time a ime a Start Time of the movement Typically set to 0 so that the movement pattern is aligned to the display screen action Whether the movement pattern point
264. er can further get access to the triggered data The sub attributes of the TriggeredData attribute are listed in the following table Content Content Start Time StartTime Integer Display computer time in milliseconds from the start of the experiment when the triggering fixation or fixation update event starts End Time endTime Integer Display computer time in milliseconds from the start of the experiment when the triggering fixation or fixation update event ends 32768 if eye event is set to STARTFIXATION EDF Star Time EDFStartTime Integer EDF time time since the EyeLink program started on the Host PC when the triggering fixation starts fixation update event ends Eyes Available eyesAvailable Integer This attribute is depreciated it will always return the same value as the Triggered Eye property To find out the eye s used in the recording check the Eye Used property eyeUsed of the EyeLink Device makes the current fixation trigger fire update event Average Gaze Y averageGazeY fixation or fixation update event Size fixation update event X Y gaze position when the triggering fixation Start Gaze Y StartGaze Y or fixation update event started Pupil size when the triggering fixation or fixation update event started Gaze Y endGazeyY or fixation update event ended fixation update event ended Start PPD X StartPPDX Float Angular x y resolution when triggering fixation Start P
265. er needs to add individual building blocks triggers actions sequences and other components to the workspace in the Graph Editor Window Connecting components by arrowed lines which represent sequence and dependency relationships forms the experiment flow Please read Chapter 6 on flow diagram and Chapter 7 on the components of the Experiment Builder 4 Modifying Properties of Experiment Components The user will need to change the default settings for the actions triggers and sequences so that the experiment can be run in the intended way For example if a timer trigger is used the user may change the maximum duration set in the trigger If an invisible boundary trigger is used the desired triggering location needs to be specified Similarly the user needs to supply data for all actions For example 1f a display screen action is used the user needs to add different resources into the screen builder and adjust the layout of the resource in the screen To change the default settings for triggers actions and subsequences and make the new values available for future uses the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 4 user may make the modification through the preference settings of the Experiment Builder application see Chapter 17 5 Creating a Data Source The Experiment Builder allows the user to create prototypical trials for the experiment and to supply actual parameters for individual trials fr
266. ered button event see the following table Press Events t _pressEvents Boolea Whether the trigger should fire when a button n press event occurs This is set to True box checked by default Release Events T default Buttons buttons List of List of buttons that may be pressed released to integer fire the trigger Default value is 1 2 3 4 5 6 S 7 8 Multiple button selection can be made by holding down the CTRL key on Windows or the command key 6 on Mac OS X Note To check which button is actually pressed or SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 133 releaseEvents Boolea Whether the trigger should fire when a button n release event occurs This is set to True by released use triggeredData button 1 e the button sub attribute of the triggeredData attribute instead To set the button s used for response click on the value field of the Buttons property and select the desired buttons Multiple buttons can be selected or unselected by holding down the CTRL key on Windows or the Command key 5 on Mac OS X The buttons can also be set via attribute reference by double clicking on the right end of the Buttons value field When the Cedrus input trigger fires the triggered data can be further accessed The attributes of the TriggeredData attribute are listed in the following table Time time Integer Display computer time in mil
267. esearch Experiment Builder User Manual 2004 2011 SR Research Ltd 38 4 A Source node cannot have more than one Target Action unless it is a Conditional Trigger in which case each conditional branch cannot Target more than one Action component 5 A Source component can target many Trigger nodes 6 A Source node cannot target a Trigger and an Action component at the same time 7 A Sequence action cannot target a Trigger node 8 A Target trigger node cannot receive connections from multiple source trigger nodes 9 A Source node cannot target multiple Sequence nodes That is the current version of Experiment Builder does not support parallel processing 10 A Drift Correct Action or Camera Setup Action cannot target any Trigger 11 Storage space elements Accumulator Variable and Result File cannot be Source or Target Nodes 1 e never directly connected to other components 12 Certain node types such as Fixation Saccade Invisible Boundary and Sample Velocity Triggers can only be added to a sequence that has the Record checkbox enabled 13 Drift Correct and Camera Setup Actions cannot be added to a sequence that has the Record checkbox enabled 14 A Trigger can not be the target of an action and a trigger at the same time 6 3 Actions Action components instruct the computer to do something like displaying a screen or playing a sound One or multiple actions can be added to a sequence depending on the complexity
268. esource MULTILINE_TEXT_ RESOURCE by SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 216 pO defatty MultiLineTextResource the current item belongs to n default n Position is Gaze positionAtGazeC Boolea Whether the position of the resource is Contingent T ontingent n contingent on the gaze position False by default This setting can only be modified when the display screen is contained in a recording sequence Position 1s _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent n contingent on the mouse position False by Contingent T default Offset offset Point Adjustment of the resource position relative to the position of the current gaze or mouse position 0 00 0 00 by default Host Outline Color The color of the box drawn on the host screen to hostOutlineColor show the position and dimension of the current resource This property is available only if the Color q Use for Host Display option of the containing display screen action is enabled Screen Location NR Whether the location specified below refers to Type me the top left corner or center of the resource This setting can be changed at Screen Preferences Location location Point The coordinate of the top left corner or center of the resource Always 0 0 for top left screen coordinate and center of screen in the center position coordinate type Width Wi
269. esource to the center of the display screen the location of the text resource can be referred as parent width 2 parent height 2 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 258 e Example 3 If to write the position of the text resource TEXT_RESOURCE in the data file using an SEND_EL MSG action which is in the same sequence as the display screen DISPLAY_SCREEN that contains the text resource the message property of the Send Message action can be referred as Text Location x str parent DISPLAY SCREEN TEXT_RESOURCE location x T y str parent DISPLAY_ SCREEN TEXT_RESOURCE location y This will record a message similar to MSG 11545029 Text Location x 512 y 384 in the EDF file e Example 4 This illustrates how to record in a data file the reaction time calculation for a button press EL_BUTTON following the onset of the display screen DISPLAY_SCREEN assuming that all actions and triggers are contained in the same sequence The user can enter the following equation in the attribute editor Button pressed time str EL_BUTTON triggeredData time DISPLAY_SCREEN time This will record a message as mse 12818953 Button pressed time 1228 0 in the EDF file 10 5 Reference Manager All of the references used in the experiment graph can be reviewed and modified in a reference manager The reference manager accessed by clicking Edit gt Reference
270. esultsFile the current node belongs to experiment graph ST S file 66 99 Use Period for usePeriodForMis If true a will be written out to the result file Missing Values singValues instead of ance values 1 e 32768 for t T numbers and MISSING_VALUEF for strings An integer specifying the minimum output field width This will be exceeded if necessary Specifies the number of digits to appear after the decimal point Result file is useful for recording data in non EyeLink experiments The following graph see Figure 7 43 illustrates part of a simple reaction time experiment START RESULTS FILE DISPLAY SCREEN VARIABLE_EKEY VARIABLE TIME KEYBOARD T ADD_TO_RESULTS_FILE Figure 7 71 Using Result File To record the keyboard response and response time to the result file the user needs to create two new variables VARIABLE_KEY referring to the keyboard response KEY BOARD triggeredData key and VARIABLE_TIME referring to the elapse time of the timer trigger TIMER elapsedTime The user also needs to add a RESULT_FILE object to the experiment and click on the Columns property to add both variables for output see Panel A of Figure 7 44 An ADD_RESULT action is added following the timer and keyboard triggers to record responses and reaction time for the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 190 sequence The Results File
271. eter To support attribute referencing of that property in Experiment Builder do not give a default value for the parameter For example def setEB Attrib self value That is the attribute EBAttrib should be able to be set to a reference If a default value is assigned to the setX method this would tell the Experiment Builder that the attribute nonEBAttrib should not be able to be set to a reference For example def setNonEB Attrib self value 0 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 271 A class attribute that has a corresponding getX method is a readable attribute A class attribute that has a corresponding setX method is a writeable attribute An attribute is a readable and writeable property if it has corresponding getX and setX methods 12 4Instantiating Custom Class Once a custom class is defined users can instantiate the class by creating a concrete instance of that class To do that click on the other tab of the component tool box and add a Custom Class Instance node to the experiment graph Select the newly added custom class instance node Click on the value field of the Custom Class property Select the custom class from a dropdown list Once the class is loaded attributes and methods are listed in alphabetical order in the property table The Attribute section lists all of the class attributes that has a corresponding getX method e Those attributes having a getX method only but wit
272. everal resources together select the resources and click the right mouse button In the popup menu select Grouping Group To ungroup resources select Grouping Ungroup Alternatively tool buttons on the Screen Builder toolbar see Figure 8 21 can be used a Figure 8 21 Resource Grouping Please note that after several resources are grouped together a COMPOSITE_RESOURCE object is created while the individual component resources are removed from the Structure panel see Figure 8 22 The content of the property panel is also updated to reflect this change SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 239 ia SEQUENCE F START DISPLAY _SCREEN Interest Areas Movement_Patterns RECTANGLE RESOURCE AY TEXT _RESOURCE G TIMER Experiment Components Devices a ee olor Filed i Color a Stroke Width Ce DRIFT_CORRECT im SEQUENCE F START DISPLAY _SCREEN Interest_Areas Movement_Patterns Betneciieinesel nes G TIMER Experiment Components Dewices OMPOSITE_RESOURCE lS Figure 8 22 Creating a Composite Resource 8 4 5 Resource Order If several resources are created close to each other spatially it is possible that some resources created earlier may be partially or entirely occluded by some resources created later see Figure 8 23 panel A Therefore the surface layout of individual resources may be rearran
273. experiment manipulations and time critical actions often the sequence that eye data is recorded in as well the experiment should be given the opportunity to prepare upcoming actions as much as possible The Prepare Sequence Action includes the following operations a Preloading the image or audio files to memory for real time image drawing or sound playing b Drawing feedback graphics on the Host PC so that the participants gaze accuracy can be monitored c Re initializing trigger and action settings d synchronizing the clocks between the display computer and Cedrus button box e Flush the log files In a typical experiment the user should call the prepare sequence action before entering the trial recording sequence preferably before performing a drift correction In most of the experiments the Reinitialize Triggers box should be checked so that the data for each trigger is reset for re firing IMPORTANT For proper timing it is critical that the Prepare Sequence Action be called before the trial run time for EVERY iteration of the trial run time sequence IMPORTANT The Prepare Sequence Action Loads the image and audio files based on the state of display screen and Play Sound actions at the time the Prepare Sequence is called This means that if an image name or audio file name is changed after the Prepare Sequence action 1s called the new image or audio resource will not be preloaded and timing may be affected If an image o
274. f a conditional trigger does not have a connection from its TRUE or FALSE port then the port that does not have a connection is NOT evaluated For example if a Conditional trigger has a connection from its TRUE port and no connection from its FALSE port then the trigger will only fire if the conditional evaluates to TRUE and nothing will be done if the conditional evaluates to FALSE So the user needs to use other types of trigger in parallel to the conditional trigger in the experiment graph if there is a chance that the conditional evaluation will not be true SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 126 7 10 4 EyeLink Button Trigger The EyeLink button trigger 2 button trigger available only in an EyeLink experiment fires when one of buttons on the pre specified EyeLink button box is pressed or released Note that the EyeLink button box should be attached to the host computer not to the display computer The button box will not work if you are running your project from the dummy mode Reference Label of the EyeLink button trigger The default value is EL_BUTTON _ SL The type of Experiment Builder objects EyeLinkButton the current node belongs to graph Message message String Message to be sent to EDF file in an EyeLink experiment when the EyeLink button trigger fires Time time Float Display computer time in milliseconds from the start of the experiment when t
275. f the equation SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 257 created matches the data type required in the attribute field In the following Example 1 see Figure 10 2 the EyeLink Record Status Message field of a recording sequence expects a string value Therefore the equation created in the Example 1 1s also a string type please note that the str function is used in the equation to do data type casting In Example 2 the equation created is Point data type which matches the data type expected by the Location attribute of a screen resource eof Edit Attribute RECORDING gt eyeLinkRecordStatusMessage Node Selection Simple m START fa BLOCK G TIMER at EL_BUTTON KEYBOARD Attribute Attributes T PREPARE_SEQUENCE Figure 10 2 Creating Equations in Attribute Editor e Example 1 During recording a text message can be displayed at the bottom of the tracker screen e g like Trial 1 12 One so that the experimenter knows the progress of experiment To do that the user should click on the Recording sequence node in the structure list to start Double click on the right end of the value field of the EyeLink Record Status Message property of the sequence to bring up the attribute editor Enter a reference equation as Trial str QTRIAL_ DataSource Trial 12 TRIAL DataSource Word e Example 2 To draw a text r
276. fault setting is True n Position is Gaze positionAtGazeC Boolea Whether the position of the resource is Contingent T ontingent n contingent on the gaze position The default setting 1s False This setting can only be modified when the display screen is contained in a recording sequence Position is _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent n contingent on the mouse position The default Contingent T setting is False Offset offset Point Adjustment of the resource position relative to the position of the current gaze or mouse position The default offset is 0 00 0 00 resource This property is available only if the Use for Host Display option of the containing display screen action is enabled Screen Location NR Whether the location specified below refers to Type the top left corner or center of the resource This setting can be changed at Screen Preferences the resource Width of the resource in screen pixels Height of the resource in screen pixels Movement NR Movement pattern sinusoidal or custom of the Pattern resource Prebuild to _prebuildToImage Boolea Whether the resource should be built into an Image T n image when the experiment is built instead of having it created during the actual execution of the trial This field is always true when the Host Outline Color The color of the box drawn on the host screen to Color host
277. ference settings see Chapter 17 Operation Shortcut Shortcut Function Windows Mac OS X CTRL Z Undoes the last action performed eX Cut CTRL X dX Removes a selection from the project and place it into the clipboard Copy CTRL C Puts a copy of a selection to the clipboard Paste CTRL V V Inserts the previously copied item from the clipboard to the current position Paste CTRL te M Inserts the previously copied item from the Multiple M clipboard to the current position location Preferences Experiment Builder Fi Refresh CTRL H Refreshes the Custom Class files 1 e reparses Custom the contents of the files This tool is useful to Class users who use an external editor to edit the content of custom classes Used to load in image audio resources or ae interest area set files te CTRL R GR Tabulate the source property and value of each Risers reference used in the experiment graph see Manager section 10 5 CTRL G G Allows the user to rearrange the layout of the components in the component toolbox and structure list Select A CTRL A GA Selects the entire contents of the active window SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 33 5 3 3 View Menu This menu contains commands that display or hide panels in the project explorer window Windows Mac OS X Overview pf If enabled a tick to the left displays the Overview panel it 4
278. ferences equations which are a combination of values and or references In most cases the data type of the referring attribute must match that of the referenced attribute As amore concrete example of using references imagine that the user needs to show a text on the screen In the property table of the text resource the user can enter the text to be displayed directly in the Text property field see left panel of the figure below This static approach will be problematic when the user needs to display different text across trials Another more flexible approach is to have the Text attribute of the text resource refer to a column e g Word of a data source that contains a different text value in each iteration of the sequence see the right panel Obviously using references is more advantageous when the user needs to set a value dynamically In addition references can also be used to access the value of attributes of an action or a trigger In the above example the width and height of the text shown on the screen will change dynamically across trials To know the exact text dimension 1n one trial the user can refer to the Width and Height property of the text resource SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 43 Value XT RESOURCE Property m abel sible ost Outline Color ocation dth Position is Gare Continge Position is Mouse Continge Screen Location Type Prebuild To Image
279. ferent blocks For example the user may plan to run 80 trials in total but want to run 32 trials in the first block and 48 trials in the second block The user may enter 32 48 in the Split by field of the sequence Property Value Label RIAL fime ooo Record jsRealTime Split by 32 48 DataSource Poumne TE Rows 80 freezeDisplayUntilFirstDispl m Figure 9 8 Using Split by Option to Customize the Number of Iterations to Run in a Sequence 9 6 Datasource Randomization In most experiments the user may need to randomize trial order so that the experiment materials are not presented in the same sequence across participants The user can perform data source randomization either internally during runtime of the experiment or externally before running the experiment These two randomization methods are almost SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 249 identical except that the external randomizer allows for further counterbalancing manipulations across subjects You may experiment both methods out to see which one fits your needs better 9 6 1 Internal Randomization To perform an internal randomization simply check Enable Run Time Randomization check box on in the data source editor see the Stroop example This will enable the Randomization Setting button By clicking that button will bring up a Randomization Setting dialog box 7 Rete mei fann ire Pahia wT LR Ailus
280. ful the user needs to either add one or more resource positions and define their x y coordinates and time values or to specify a movement pattern file Following this the user can select a screen resource on the same DISPLAY_SCREEN action and set its Movement Pattern property to the custom movement pattern defined For the first option the user can add one or more resource positions to the movement pattern To add a resource position select the desired custom pattern in the Structure panel and make sure that the Use Points From File box is unchecked Following this click the button Insert Resource Position in the selected Custom MovementPattern on the Screen Builder toolbar When a custom movement pattern is created with this option a default resource position is automatically generated This position cannot be deleted unless the custom movement pattern is removed The time field of this resource position object is set to 0 and is not editable so that this can be viewed as the start position of the movement pattern The x and y coordinates are initially set to the center of the screen When the movement pattern is assigned to a resource the x and y coordinates are then reset to the current position of the resource Consider the following custom movement pattern the first default resource position has a time field of O and a destination position of 512 384 the second point has a time of 1000 and a destination position of 10
281. ged Figure 8 23 Two Resources with Different Resource Order SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 240 ee Cut Copy Paste m Delete fie Snap To Grid amp Lock selection Unlock selection Grouping I Order d iP Bring bo Front Vertical Alignment Ta Send to Back Horizontal Ali t I orizontal Alignmen OA Create Interest Area Set d A Send Backward Save Screen As Image Figure 8 24 Changing the Order of Resources The order of resources can be changed by clicking the right mouse button and choose different options under the Order menu from the popup menu see Figure 8 24 Bring to Front makes the selected resource to appear on the topmost layer as if the resource was the last item added to the screen Send to Back moves the selected resource to the bottommost layer and therefore it is most likely to be blocked other resources Bring Forward moves the resource one layer closer to the surface and Send Back moves the resource one layer away from the surface Please note that changing the resource order on the workspace also modified the order of the resource listed in the structure panel 8 4 6 Composite Resource A COMPOSITE_RESOURCE object can be created by grouping several individual resources together The individual component resources are removed from the structure panel Reference COMPOSITE_RESOURCE by default Type The
282. ged to the computer If the experiment needs to be run on a different machine with similar or better computer specifications the user should first copy the entire directory of the deployed version of the experiment to that computer To make the experiment transfer easier given so many files involved you may first zip up the Experiment Name folder keeping the directory structure and then unzip the file on your target computer The user should also pay attention to the following details e For accurate display drawing the dots per inch DPI resolution of the deployment PC that is used to run the experiment must match that of the development PC which is used to create the experiments To check the DPI settings click the right mouse button at a blank space on the Display PC desktop to open a dialog box for display properties settings Click on the Advanced Button to get access to the DPI settings e If the deployed experiment shows video clips please make sure that codec used to test run the video experiment is also installed on the deployment computer as well otherwise the deployed experiment will not run Important Please check out section 3 1 2 regarding experiment runtime performance and steps that should be taken to maximize the real time performance of the deployment computer Finally when an experiment is in progress please avoid hitting the Windows logo key on the keyboard so that the experiment will not be aborted for faili
283. h It is important to note that the video quality and playback performance will vary depending on the codec used to compress the video files Our internal tests have shown that X VID video files perform much better than VFW avi files as the X VID loader runs faster than the VFW loaders To play XVID encoded files the user should convert the original video files with the accompanying Split AVI tool with the video compressor set to Xvid MPEG 4 codec see Video Experiments in the html version of this document Please note that the Xvid MPEG 4 codec is not installed by default To install the XVID codec run the Xvid Install exe driver contained in the Program Files SR Research 3rdparty folder on a 32 bit Windows or Program Files x86 SR Research 3rdparty folder on a 64 bit Windows For EB versions prior to 1 6 1 you may do the following to install the driver on a 32 bit version of Windows Go to the directory where the Experiment Builder software is installed e g C Program Files SR Research Experiment Builder select the xvid inf file in the VideoHandlers folder and click the right mouse button to bring up a popup menu Select Install option Click Yes button in the following Digital Signature Not Found dialog box to continue the installation This only needs to be done once on a given display computer To play VFW video clips choose other video codecs from the Split AVI compressor list it is a known issue that the n
284. h Pursuit Illustrates several kinds of sinusoidal movement in a pursuit task The discussion of the simple template must be read before working with any of other templates as it illustrates most of the shared operations for all experiments You may go over the Stroop example for creating non eye tracking experiments In general you should read through all of the templates before programming your own experiment When creating your experiment you may also refer to the check list in Chapter 16 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 277 14 Creating EyeLink Experiments The First Example To create an Experiment with SR Research Experiment Builder the user needs to take the following three steps e Create an Experiment e Build and test run the Experiment e Deploy the Experiment Following these a set of files are generated so that the experiment can be run for data collection without relying on the Experiment Builder application To illustrate the use of Experiment Builder we are going to create a very simple eye tracking experiment which runs three blocks of four trials In each trial a single word is displayed in the center of the screen see the SIMPLE template of the EyeLink C programming API 14 1 Creating the Experiment The current section provides a step by step tutorial to walk you through the basics of creating an experiment with SR Research Experiment Builder 14 1 1
285. h as saccades and fixations blinks The invisible boundary trigger fires when one or multiple eye samples stay inside or outside of a pre specified invisible boundary This trigger type can be used to implement all or part of display change based on the locus of gaze For example a line of text may be changed when the reader proceeds past a critical word in the sentence This trigger is only available in an EyeLink experiment Please note that the tracker heuristic filter setting influences how quickly the trigger will fire Field Attribute Type Content Reference Label label String Label of the Invisible boundary trigger The default value is INVISIBLE BOUNDARY SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 116 absPath The absolute path of the node in the experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment when the invisible boundary Time time Float Display computer time in milliseconds from the start of the experiment when the trigger fires Note To check the time when the triggering sample occurs you should use triggeredData time instead Last Check lastCheckTime Float This property can be used to retrieve the Time Display computer time in milliseconds from Type NR The type of Experiment Builder objects Boundary the current node belongs to the start of the experiment when the trigger was checked for the last time
286. h of the flexibility to the application As an example assume a sequence has two components X and Y and component X has attribute Ax and component Y has attribute Ay If attribute Ax was set to reference Ay then the value of Ax would always be equal to the value of Ay In this example it is said that Ax is the referencing attribute and Ay is the referenced attribute Even if Ay changes value during the experiment Ax will always reflect the current value of Ay 10 1 Using References References have this syntax object_name attribute_name That is a reference starts and ends with a sign A reference can be manually entered in the property value field or more preferably from an attribute editor To bring up the attribute value editor place the mouse cursor at the very far right end of the property value field that should be edited see Figure 10 1 If the field supports attribute referencing a button with three dots on it will be displayed on the right hand side of the attributes value cell Double clicking on that button will bring up an Edit Attribute dialog with editable area on the top and a node selection tree on the bottom left In the editable area the user may enter in a value a reference or an equation SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 255 e EyeLink Experiment Builder 0 01 Demoline X l 18 x Fie Edit Experiment Help ABBB siexRaw lara
287. he DISPLAY_SCREEN object in the work space not in the structure list until the screen builder interface is displayed in the Graph Editor Window 258 Peseearnih Expenment Bler y LADS S0 C0 Sron E Z alj Fis Edt View Experiment Help Denso 2xXRGART ER TAOS darhan G GQ ERE xj Expenmert ELock tisPLay screws TAL TAL DataSource TAL Event FIKATION ScReEn DISPLAY SOREEN PFA nnm rA T S Ww GENNER 1 Select the text resource and click any a where in the display screen 5 Align to the center of the screen i 4 Red Lape TERT RESOURCE D i D Copy Uia a SS joria i i Ea FA fees i oa peene serait 6 Select Resource E srap toc i click on the right mouse button to press Tarn lock the resource UPDATE oT TRUE Recent Pater hore 2 PREPARE EEOUENE Preteaild To image F E pr pag Lise Software Surtece START i i oe Font Soin iparert parert pact 4 7 Refer to datasource column COLOR i Fira Name Tere Flee Rag DISPLAY SCREEN premena E perna 3 Set text apperance i Fon rs 50 te out Liderine r 4 Refer to datasource column WORD fy KEYBOARD INPUT 4 ose ay BLARK E RESULTS FILE Figure 15 17 Adding Text to Display Screen 1 Click on the Insert Text Resource button A on the Screen Builder tool bar and click at any position in the work area 2 Set the reference of the Font
288. he Other Tab of the component toolbox select the Variable node hold down the left mouse button and drag the action into the work space Click on the VARIABLE node set its label as TRIAL INDEX and set the initial value as 0 This variable is used to keep track of the current trial index Please note that the data type is automatically changed to Integer 2 Add another variable in the graph Set its label as KEYPRESS and initial value as This variable is used to keep a record of key press for the trial 3 Add a third variable Set the label as RESPONSE and initial value as This variable is used to check whether the response recorded is correct or not 4 Add in a fourth variable Set its label as RT and its initial value as 0 0 This variable is used to store reaction time for the trial 5 Click on the Action Tab of the component toolbox select the UPDATE_ATTRIBUTE action hold down the left mouse button and drag the action into the work space Click on the action Step Al of the figure below and set the initial values of the following four variables TRIAL_INDEX RT RESPONSE and KEYPRESS a Click on the far right end of the value field of the Attribute Value List property Step A2 of the figure below This will bring up an Attribute Value List dialog box b Click on the right end of the first cell under the Attribute column Step A3 of the figure below This will b
289. he duration field 4 Add another display screen action This will be the screen showing the Stroop word see Section 15 8 2 5 Adda Keyboard Trigger Select the trigger and edit the label as KEYBOARD_INPUT Double click on the left part of the value field for the Keys attribute This will bring up a keyboard for choosing the possible response keys Press the CTRL key on Windows or Command key on Mac OS X while selecting multiple desired keys In this experiment choose the following keys b for blue color r for red color and g for green color Click on the Close button h at the top right corner of the dialog to finish Properties _ i x Property value 2 Hold down the CTRL key and select input keys Confidence Interval lear Input Queue l se Keyboard Triggered Data 1 Click here Figure 15 15 Setting Response Keys 6 Add another Timer trigger Rename it as TIME OUT and set the duration as 8000 msec 7 Add another DISPLAY SCREEN action Click on the action and modify its label as DISPLAY_BLANK This will be the blank screen to clear the Stroop word 8 Make a connection from the START node to FIXATION SCREEN from FIXATION_SCREEN to TIMER from TIMER to DISPLAY_SCREEN from DISPLAY_SCREEN to KEYBOARD_INPUT and TIME _OUT from the last two triggers to DISPLAY_BLANK 9 Click at any blan
290. he ExperimentBuilder Examples Version 1 5 1 e This release runs on 32 bit versions of Windows 2000 XP and Vista Known issues with Windows Vista o Touch screens are not supported o Driver for the Cedrus button box needs to be installed twice before the device is fully functional e Bug fix for the Prepare Next Display Screen Action of the Display Screen action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 356 Version 1 4 624 e Bug fix for automatic interest area creation for multiline text resources e Bug fix for resetting the position of mouse cursor Version 1 4 562 e Touch screens are now supported as a variant of the mouse trigger e More options Camera Mount Desktop Version and Mount Usage are added to the EyeLink Device Version 1 4 402 e EyeLink Remote EyeLink Device can now be set to use EyeLink Remote system e Invisible Boundary Trigger Updated Trigger now supports specification of a minimum duration that the eye needs to be in the boundary before the trigger will fire Also added EDF Start Time and Start Time to the TriggeredData e Animation Target Now supports calibration and drift correction with an animation target SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 357
291. he computer display Now the sequence monitors two new Triggers a TIME OUT _2 trigger and an EL_BUTTON trigger The EL_BUTTON trigger fires if the participant presses a button on the EyeLink button box TIME OUT _2 is triggered if a pre specified duration has elapsed since the second display was drawn The sequence ends when either of the triggers EL_BUTTON and TIME _OUT_2 becomes true Important Note that in the above example once the DISPLAY_SECOND_SCREEN Action has been performed the TIME_OUT and INVISIBLE_BOUNDARY Triggers are no longer monitored only the Triggers connected to the last processed Action are monitored 6 2 1 Adding Components to an Experiment In the Experiment Builder graphical user interface the user can add individual components to the workspace of the Graph Editor Window by dragging them from the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 37 component toolbox To do that first choose the right node group by clicking on the Trigger or Action or Other Tab of the Components Toolbox Place the mouse cursor on the icon of the desired component press the left mouse button hold it down as you move the mouse to drag the selected item to the desired location in the work space and then release the left mouse button To find out the meaning of a component simply place the mouse cursor over the icon 6 2 2 Linking Experiment Components The flow of an experiment sequence moves from the
292. he current mouse position see Panel B See FAQ Will mouse trigger fire when I use the Position Triggered Option and do not check the Press Release Event boxes in the HTML version of this document SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 150 MouseTest Movement _Patterns C ELLIPSE_RESOURCE Experiment Components Dewices Properties H x lime T astGhededTne Oooo e ae Reson Orecion 0 8 80001 keane RECTANGLE pesos kesoren pee Within I Stroke Width al x MouseTest fF START DISPLAY _SCREEM Movement_Patterns BELLIPSE_RESOURCE TIMER P MOUSE Experiment Components Devices Properties H x abel LLIPSE_RESOURCE Property Tyee FinseRe source a all Position is Mouse Contingent oie C 0 Prebuild To Image Use Sofware Surface Color filed ill Color Figure 7 50 Setting the mouse triggering region 7 10 7 2 Center location type vs top left location type Please note that the location type of all trigger types invisible boundary trigger mouse trigger fixation trigger saccade trigger and sample velocity trigger is top left based whereas the screen resources can be either top left based or center based the screen resource interest area location type can be set by the Screen Preferences This means that references should be created differently depending on whether the region location of a trigger refers to
293. he name of the video clip used as the Use Animation useAnimationT Boolea If checked an video clip can be used as the Target arget n calibration target this can be a small avi file that contains both video and audio Target t calibration target Note that this option is presently not available on Mac OS X Animation animationPlay Integer Total number of times the video clip will be Play Count Count played before the calibration target is accepted If 1 the clip will be played continuously looping Note that this option is presently not available on Mac OS X Use Custom useCustomTarg Boolea If checked calibration will use the custom Target et n target supplied a small image file with the feature interesting part appearing in the center of the image Custom Target customTarget String The name of the image file that is used for drawing the calibration target The image files should be preloaded into the library manager Note that this property is only available if Use Custom Target is checked Background kground n background image supplied Custom customBackgro String The name of the image file that is used for Background drawing the calibration background The image file should ideally be a full screen image and be preloaded into the library manager Note that this property is only available if Use Custom Background is checked Target Outer outerSize Integer Th
294. he trigger fires Note To check the time when the button was pressed released you should use triggeredData time instead Last Check lastCheckTime Float This property can be used to retrieve the Time Display computer time in milliseconds from the start of the experiment when the trigger was checked for the last time Confidence confidenceInterv Float Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time Clear Input clearInputQueue Boolea EyeLink button trigger maintains an event Queue n queueso that multiple button events can be accessed over time The current option checks whether the button event s cached in the event queue should be cleared when the trigger fires NO no event clearing Event removes the current triggering event from the button event queue LIST all button events from event queue will be removed Type type String This identifies the type of EyeLink button box plugged to the host computer specified through the EyeLink Button Box device List of List of buttons that may be pressed released to SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 127 integer fire the trigger Default value is 1 2 3 4 5 S 6 7 Multiple button selection can be made by holding do
295. hen the property is treated as internal For example self thislsAnExmaple and self example2 are valid custom class attributes whereas self 2Example and self badString are not valid The data type of the class attribute is determined by the initial value assigned to the attribute Known supported data types are int float str EBPoint EBColor tuple and list For example Line 006 self property1 attribute has an initial value of 1 As a result this class attribute is an integer The following table lists typical data types used in a custom class Attribute Value Data Type Usage Example Line 013 self myString This is another string 100 100 Point Example Line 007 If an attribute s default value is of tuple type and only has two items the property will be treated as an EBPoint The parameter of the setX method and the return type of the getX method is expected to be the same as the attribute type sreb EBPoint 100 200 Example Line 010 1 2 3 Color Example Line 008 If an attribute s default value is a tuple of 3 items the property will be treated SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 269 as an EBColor The parameter of the setX method and the output type of the getX method is expected to be the same as the type of the attribute sreb EBColor 200 100 100 Example Line 011 1 abc self property6 List sd Example Line 012 listQ List self myList listQ Thi
296. his option will only be available to an EyeLink experiment eS Label label String Label of the alas RESPONSEPIXX_LED_CONTROL action Type The type of Experiment Builder objects pee RESPONSEP1xxLEDControl the current node belongs to experiment graph Message Message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the RESPONSEPixx_LED_ Control action is done SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 111 Time time Float Display computer time in milliseconds from the start of the experiment when the RESPONSEPIXX_LED_CONTROL action is done Start Time startTime Float Display computer time in milliseconds from the start of the experiment when this action starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Boolea Whether the LED for button one should be n tur
297. houping Order b Vertical Alignment b Horizontal Alignment b b Create Interest Area Set EI he e es ae a E Save Screen 4s Image Figure 8 26 Save Screen as Image SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 243 9 Data Source An important issue for most experiments is to specify the actual parameters of the individual trials For example which experiment condition should each trial be in Which display should be presented To do that the user may hard code the content of each trial in the experiment Obviously this will be extremely time consuming and error prone if there are several hundreds of trials involved unfortunately this is the typical case for a perception or cognition experiment The Experiment Builder handles this issue by allowing the user to create prototypical trials for the experiment and to supply the actual parameters for individual trials from a data source see Figure 9 1 A data source can be created within the Experiment Builder or by loading a text file The column headings in that file could be variable names and each row contains values for the variables in each trial During the execution of a script file lines in the data source can be read supplying the actual parameters for each trial the linkage between the two is achieved by attribute reference which is discussed in next Chapter G EyeLink Experiment Builder 0 5 239 Beta Picture File Edit Exper
298. hout a corresponding setX method will be read only and is not directly modifiable see attributes property2 and property3 in 3 1 example e Those attributes that have both a getX method and a setX method without a default value for the parameter are both readable and writeable These attributes should be able to be set to a reference see attributes property1 propertyS property6 property7 and property8 in 12 3 1 example e Those attributes that have both a getX method and a setX method with a default value are readable and writeable However these attributes cannot be set to a reference see attributes property4 in 12 3 1 example Those attributes having a setX method but not a getX method will not be displayed in the attribute section The setX method will be displayed as a regular methods The Methods section lists all methods available for the class see myMethod of the 12 3 1 example except for the __init__ getX and setX methods mentioned above SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 272 Properties _ a al x abel CUSTOM_CLASS_INST Ype Customtlassinstante Pode Path CUSTOM CLASS INST ustom Class TestClass Custom Attributes 1 abo EBColor 200 1 a ello biyhiethod Figure 12 2 Attributes and Properties of a Custom Class Instance 12 5 Using Custom Class The interaction between the custom class and the Experiment Builder graph is done through attribute r
299. ht eye and an average Average Gaze X GazeX between the two Right Gaze Y GazeY average y axis for the left eye right eye and an average Average Gaze Y GazeY between the two Left Pupil Size leftPupilSize ri Float Left eye right eye or average pupil size in Right Pupil Size ghtPupilSize arbitrary units area or diameter as selected in Left Gaze Y leftGazeY right Gaze position of the triggering sample along the Average Pupil averagePupilSize the EyeLink device settings Size l Left Velocity leftVelocity Float Left eye right eye or average sample velocity Right Velocity rightVelocity in degrees second Average Velocity average Velocity 1 Left leftAcceleration Float Left eye right eye or average sample Acceleration rightAcceleratio acceleration in degrees second 2 Right n Acceleration averageAccelerat Average ion Acceleration Angle angle Float The angle of the eye movements when the trigger fires Target Distance targetDistance Integer Distance between the target and camera 10 times the measurement in millimeters This option is for EyeLink Remote eye tracker only Returns MISSING_DATA 32768 if target is missing or if running a non Remote eye tracker Target X Target targetX targetY X Y position of the target in camera coordinate Y This option is for EyeLink Remote eye tracker only Returns MISSING_DATA 32768 if SR Research Experim
300. i al an LLI ai 1 mh ali m ee ere EL_BUTTON S DISPLAY BLANK Figure 7 11 Using Display Screen 7 9 2 Performing Drift Correction At the start of each trial a fixation point should be displayed so that the participant s gaze is at a known position The EyeLink tracker is able to use this fixation point to correct for small drifts in the calculation of gaze position that can build up over time Even when using the EyeLink II tracker s corneal reflection mode a fixation target should be presented and a drift correction allows the experimenter the opportunity to recalibrate if needed Performing a drift correction is optional when running EyeLink 1000 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 63 The Drift Correction action Gh implements this operation The display coordinates where the target is to be displayed should be supplied Usually this is at the center of the display but could be anywhere that gaze should be located at the start of trial recording For example it could be located over or just before the first word in a line page of text Reference Label of the Drift correction action The default value is DRIFT _CORRECT Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the Drift correction action is done
301. ializing trigger settings to ensure real time performance and better recording feedback y Add to Adds a number to an Accumulator object Accumulator ip Add to Result File Used to output data to a tab delimited data to a Result File x y Update Attribute Updates the value of a Variable or an attribute of an experiment component Th can Send TTL Signal Sends a TTL Sead EL signal vie the paceilel peat ce oles ata ports via the ae port or other data pon D Rese fap DM piek a nod in Be apartmen amaresa data Ce eeeeiainsiaaeameaeal Experiment data source line again at a later time O Play Sound Plays a WAV audio file a WAV audio file I Pay Sound Control Stop pause or unpause a specified playsound aeon sound card Stop pause unpause or abort the current ASIO sound being Control recorded class E Coto Buonton ee Control Button box 6 4 Triggers A Trigger is some condition that must be met for the sequence to continue past that point Triggers are used by the Experiment Builder to control the transition from one Action to another or to end a sequence itself For example in a simple reaction time experiment following the onset of the stimulus display a speeded response from the keyboard or a button box can be used as a trigger to end the trial In a change detection experiment the time delay serves as a trigger to make the transition from one display screen to another and therefore controls the exposure du
302. ibutes of node and so on The following lists common operations used in editing a graph in Experiment Builder Most of the operations can be performed by keyboard shortcuts by using buttons on the application toolbar or by entries in the Edit menu e Inserting a new node Click on the Action Trigger Other Tab of component toolbox in the Graph Editor Window Place the mouse cursor on the icon of the desired component press the left mouse button hold it down as you move the mouse to drag the selected item to the desired location in the work space and then release the left mouse button e Cutting nodes Select the nodes to be cut and then press CTRL and X keys together on a Windows keyboard or Command amp and X keys together on a Mac OS X keyboard This can also be done by clicking the right mouse button to bring up a popup menu and selecting cut to remove a selection from the project and place it into the clipboard e Deleting nodes Select the nodes to be removed press Delete key or Command and Delete keys together on Mac OS X or select Delete from the popup menu to remove the selection from the current location Note Delete will not place the selection into the clipboard Therefore if you want to move one node from one sequence to another you may first cut the selected nodes and then paste the selection to the intended location e Copying a selection Select the nodes to be copied press CTRL and C keys together
303. ick on the save E button on the application tool bar Click on Experiment gt Build menu to build the experiment The Editor Selection Tab in the Graph Editor Window will be set to the Output tab and build information will be displayed Watch out for error displayed in red and warning in brown messages during building The following is a list of common errors during experiment building Image file not found No positions are added to the custom pattern Use of runtime value with prebuild to image option on No value is set at row for the column SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 294 The node could not be used in the sequence Reference to not found in the graph No link from node Infinite loop found Invalid Reference No recording sequence found in an EyeLink experiment The following is a list of common warnings during experiment building e The keyboard trigger and mouse trigger is used in a real time sequence If this is the case check whether these two triggers are indispensable for the experiment design If so uncheck the Is Real time box in the recording sequence e Default value use in attribute The user may also test the experiment by clicking on Experiment gt Run from the application menubar This will try to connect to the tracker PC and execute the experiment code Please note that this should only be used for the purpose of testing
304. ideo card monitor driver been installed FAQ The stimuli screen was really flickering during the experiment FAQ Could not initialize display 11 Is the trial recording sequence running under real time mode You should have the Is Real Time box of that sequence checked if it does not contain a keyboard mouse or Cedrus input trigger Discussion Forum Post Real time mode EL_ Button box FAQ Warning 2003 The IO node KEYBOARD is used in realtime Sequence 12 Does the background color property of the calibration and drift correction screens match that of the display screens used in the experiment Try matching the background color of the screen during calibration and validation to that of the test displays because changes in pupil size caused by large brightness differences can degrade the system accuracy 13 Is the transparency color of the display device correctly set The transparency color of the project should be set to close to but not identical to the background color of the display screen and click Experiment gt Clean before you re run your experiment For example if you use a white background color for your experiment try setting the transparency color to something like 254 254 254 Similarly if you use a black display background try setting the transparency color to something like 0 1 0 Some of the resource drawing especially text resources may look fuzzy if the transparency color is very different
305. ield is left blank the default configuration is used This property is only available if the Enable External Control option is checked The type of external device that is used to control the camera setup calibration and validation setup This can be CEDRUS Lumina fMRI Response Pad or RB Series response pad from Cedrus KEYBOARD computer keyboard or keypad or CUSTOM a user control device interfaced through a callback function defined in the custom class code This 2004 2011 SR Research Ltd 66 property is only available if the Enable External Control option is checked Key State For an experiment project with custom class Callback enabled a method defined in the custom Function class can be run to check the button status of an external control device the HTML version of this document provided an usage example and thus to control the camera image thresholding and calibration through the External Control Device Config setting This property is only available if the External Control Device option is set to CUSTOM Result result Integer 0 1f successful 27 if Esc key was pressed to enter Setup menu or abort None if this attribute is accessed before this action is done Please note that the Drift Correction action is only available in EyeLink experiments and must be placed outside of a recording sequence see linking rules In addition this action cannot be connected to another drift
306. ill be run if button box is missing from EyeLink II and 1000 Also fixes EyeLink I button box issue Adds a Lock Project Unlock Project icon to the application toolbar and file menu Adds support for using multiple parallel port devices and for reading the current data status control register values of the parallel port device fix for automatic interest area creation for the multi line text resource when delimiter characters are used Bug fix for Error 2031 Equation parse error when running projects with non ASCII characters in the multi line text resource SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 354 e Bug fix for collecting response from button 8 of Cedrus RB 830 and RB 834 response pads Version 1 6 121 e This release supports using multiple display keyboards and mice in the same experiment responses on the different input devices can be handled differently e Supports the keyboard trigger to detect a release event e Adds options for different types of EyeLink button boxes Microsoft SideWinder Plug amp Play Gamepad as well as button boxes plugged to the parallel port e Adds RESPONSEPixx_LED_ CONTROL action to allow set the LED lighting on a ResponsePixx button box e Allows to cancel the Clean Build Test and Deploy processes before they start e This release provides an I O port driver for both 32 bit and 64 bit Windows You will need to manually install the I O driver if yo
307. iment Help l BeBbal xbheatl gt roeee QRQAAHE Experiment BLOCK TRIAL_DataSource Trial Image Width Height x y Number String Number Number Number Number Th town jpg 1024 768 0 0 Picture tovvn_blur jpq 1024 768 0 0 town jpg 800 600 112 64 toven_blur jpg 600 600 112 64 town jpg 600 600 0 0 town blur jpg 800 600 0 0 YF START H BLOCK fi START EHE DISPLAY _SCREEN TIMER EL_BUTTON KEYBOARD EL_CAMERA_SETUP Bear fif START W PREPARE_SEQUENCE HEC DRIFT_CORRECT i Experiment Components Devices 1 Select Sequencer Property abel TRIAL Value Hime Record r Real Time r teration eration Count 6 Data Source Columns 6 Rows 6 reezeDisplayUntilFirstDispl Iv 2 Click Here 3 Create Column Headings Picture BLOCK Figure 9 1 Using Data Source in Experiment Builder 4 Create Data Line Add Colurnn Add Row Import Data SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 244 9 1 Creating Data Source A data source is attached to a sequence object given its repetitive nature To create a data source select the sequence object and click on the value field of the Data Source property by default it shows Columns 0 Rows 0 This will bring up the Data Source Editor
308. in and click the right mouse button Select Lock Resource in the following popup menu to prevent the image being accidentally moved in the Screen Editor 350 Research Experiment Budder y 140220 RC Siroqp alj zi Fis Edt Yiee Esperimei Help BP undo Add Criz e cut Ctlex Ly Copy Criec E a Rest aw vAHB saerali rv O46484 BBB Erparimert Lock tepLay commen ta TAL _Detatouce TRIAL EVENT wanan screen PIES eon Aca ETART p 1 Click Edit gt Library 4 Click here to finish Manager to start P cee 0 brary Manages OM ve 7 E F i i Ace oe i 2 Select the Image tab me bd B 3 Click Add to load in images Properties Previray Tipe of fie BWP Bre 513 pyte em input Gases F jg TS Hagh dt pixeis ra l J en Cee LES Fl main J Rawagalor i ackgrourd Color eae _ I re i Ais ill Siop Fe BOCK Fe TRIAL Pb TRIAL EWENT Figure 15 16 Loading Resources to Image Library SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 312 15 8 2 Creating the Stroop Display Screen Next we will create a screen containing the Stroop color word A text resource should be added to the display screen The properties of the text resource such as font name size text to be displayed and alignment style should be modified see Figure 15 17 To do this first double click on t
309. in between instead of using SEND_EL_MESSAGE action or ADD_TO_LOG action The null action can also be attached to the unused branch of conditional trigger so that the experiment flow can continue It can also be used between two successive triggers to make the reading of the experiment graph less ambiguous SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 109 b Clearing cached trigger data Reference Label of the NULL_ACTION action The default value is NULL_ACTION E CO The type of Experiment Builder objects NullAction the current node belongs to Node Path absPath String The absolute path of the node in the experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the action is executed Time time Float Display computer time in milliseconds from the start of the experiment when the action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the action Starts Clear Input ClearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action is started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events tha
310. in milliseconds since the recording starts Returns 0 before or after recording SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 101 Record Start recordStartlim Float Display computer time in milliseconds Time from the start of the experiment when the audio recording starts Returns 0 before or after recording When you run a project using the ASIO driver a Creative ASIO Control Panel dialog box will show up This latency sets the minimum output latency of the ASIO driver delay from buffer switch to first sample output and the interval in milliseconds between ASIO buffer swaps 1 e how often new sounds can be output For better ASIO playing recording performance set the ASIO buffer latency to 10 ms the default is 50 ms A possible trial recording sequence involving audio recording would be 1 Add a Record Sound action to open the recording file for the trial 2 Present visual events with DISPLAY_SCREEN action Add a Voice key trigger to the DISPLAY_SCREEN in addition to other trigger types 3 Wait until timeout or a voicekey trigger event 4 Blank the display immediately or after a very short delay to let the subject know their utterance has been detected 5 Add a timer trigger so that recording can be continued for a short period 1000 ms to ensure the entire word has been recorded If a long response is expected you may want to continue checking the voicekey and e
311. in simple reading and scene perception type experiments Pentium 4 1 4 GHz or higher 32 bit or 64 bit Windows 2000 XP Vista and Windows 7 DirectX 9 0 or later 256 Mb of memory Hard drive with enough free space to hold experiment and data collected 64 MB Video Card from NVidia or ATI Monitor Sound Card Keyboard and Mouse USB port for Experiment Builder key If using EyeLink Ethernet connection to the EyeLink tracker The recommended PC configuration should handle any experiment that can be created by the SR Research Experiment Builder including video presentation saccade contingent display changes accurately timed audio presentation audio recording and ASIO based voice key support e Pentium 4 2 4 GHz or higher with Hyperthreading enabled a duo core multiple core processor or multiple CPUs SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 7 e Windows XP 32 bit version Service pack 2 or Windows Vista 32 bit version DirectX 9 0 or later 1 GB of memory Primary 80 GB or larger 10 000 RPM hard drive Secondary 80 GB or larger 7 200 RPM hard drive 256 MB AGP 8x or PCI Express video card from NVidia or ATI High refresh rate CRT Monitor Creative SoundBlaster Audigy 2 ZS or other tested ASIO sound card Keyboard and Mouse Free USB ports for Experiment Builder key If using EyeLink Ethernet connection to the EyeLink tracker To check the version of DirectX installed in
312. ing Trial Seguente siosasaensoi a 288 Editine Rec rding SegUcN Esenes ieee arcesiets 289 Modifying the Properties of DISPLAY_SCREEN Action 290 Addins Text to Display Sorese anii 291 Referring Text to Be Shown to Data Source cccccccceeeeeeesseeeeeeeeees 292 Creatine Trial ID MESSE rinine Sooo tee aeeene ae bes sae 293 Creating Trial Recording Status Message ccesssssssecceeeceeeeseeeseeeeees 294 Error tiv muah ine Gea pics senas aea 296 Error i PAC Ket Verslo sere ssctinacecd ctentas a ieee aheedeneineeanemaeees 296 Creating a New Experiment Builder Session ccccccccceeeeeseeeeeeeeeeeeees 297 Editing Project Preference sv tisio iver ins Wercog cite we a 298 Creating Experiment Block Sequence ccccccesseeeeeececeeeeeeeseeeeeeeeenaas 299 Editing Block SEQUENCE ers nacceceriebutesnasinenr tebe 300 Adding Instruction to Block Sequence cc eeeeeeeeeeceeceeeaeeeeseeeeeeeeeaaas 301 Adding Multiline Text Resource onto a Display Screen c c0008 302 Create ANSITUC HOM SOTEER E E 303 DatasOurc e Randomization ence sade A cette eaeie wt ateadess 305 Creatin DL 2 Wo oo Rane ane a fee re Te 306 e AEN Pall Seguen eean baveus acttasacctecevnedsieadar caver aeeeaeasamentaea 307 Updating big Fol ie 6 op caer neuer tee eee nee a arnt ter yn tern 308 Update Taal Mer ann eree T A T a 309 Updating he Attribute of RD ryss a i odareagelics 309 Edite Recordin Segu NCE eeraa OE 310 SCUSE RESPO E KO
313. ing characters that are non English eg or even special curved quotes and obviously any non European language characters e g Chinese characters In addition please make sure that the right font for the text is chosen before entering any text eos Preferences Property Ete Preferences Experiment Encode Files as UTFS Devices Disable Warnings for D Nodes Encode Files as UTFS H Screen Resources Movement Patterns Buitt In Interest Area Preference Build Deploy Restore Factory Detautt Save Properties as Detautt Ul Figure 8 6 Setting UTF 8 Encoding 8 1 3 2 Anti aliasing and Transparency Anti aliasing is one of the most important techniques in making graphics and text easy to read and pleasing to the eye on screen Take the texts in Figure 8 7 for example Panel A shows an aliased letter in which all of the curves and line drawing appear coarse SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 213 whereas Panel C shows an anti aliased letter which looks smooth Anti aliasing is done by substituting shades of grey Panel D around the lines which would otherwise be broken across a pixel Panel B C D Figure 8 7 Aliased and Anti aliased Texts To apply anti aliasing the user should first check for the Experiment Builder preference settings Click Edit gt Preferences Click on Screen node and make sure that the Anti
314. ink message sending EyeLink command camera setup and drift correction actions will be available for experiment generation If this field is unchecked all of the abovementioned actions and triggers will be hidden Append Session Name If checked Experiment Builder will concatenate the current session name with the output files warning log messages txt etc in the results session name directory Enable Custom Class If this box is checked additional features Custom class instance Execute method Custom class library Callback attribute for Sequences etc will be available for programming an experiment using custom class Please note that custom class related features belong to adavanced Experiment Builder functionality that requires knowledge of the Python programming language If you wish to use this feature please contact SR Research eb sr research com for support Enable Multiple Inputs If checked multiple display keyboards and mice can be used in the same experiment responses on the different input devices can be handled differently The number of distinct keyboards and mice can be set in the keyboard and mouse device If unchecked responses from all of the keyboards and mice attached to the computer are treated the same as if the response is made to a single keyboard or mouse SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 326 17 1 1 EyeLink af Preferences
315. ion This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action acy A i The intended play sound action to be controlled Sound Action stop pause or play Operation operation String Action used to control the current audio recording STOP PAUSE or PLAY continue playing a paused audio Please note that PAUSE and PLAY controls are only valid with DirectX driver SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 98 The following graph illustrates playing a sound clip PLAY_SOUND_DIRECTX for 1 second TIMER_PLAYING pausing PAUSE_AUDIO for 1 second TIMER_PAUSING and then resume playing UNPAUSE AUDIO with Direct X driver ee O m Start Time Clear Input Queues F OO O O O Ol Sound File parent parent TRIAL am ooo SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 99 START DISPLAY SCREEH E a Type Flay sound Control Message PAUSE AUDI Time at PLAY_SOUND_DIRECTH fc art Time if ED i Clear Input Queues I arget Play Sound ActionPLAyY SOUND DIRECTs TIMER_PLAYING MPAUSE_ AUDIO Alay oundlontral MPAUSE_ AUDI Target Play Sound Actionf LAY SOUND DIRECTS Operation PLAY Figure 7
316. ion poor at corners HV9 9 point grid calibration HV13 13 point calibration EyeLink II version 2 0 or later The default calibration type is HV9 Horizontal This sets the Y position of the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 69 Target Y horizontalTarg Integer automatically generated targets for the H3 Position etLocation calibration type This option is only available when the calibration type is set to H3 Pacing _pacingInterval Integer Sets the time delay in milliseconds for Interval calibration and validation if calibration triggering is done automatically Randomize randomizeOrde Boolea If checked randomizes the presentation Order r n sequence of calibration and validation fixation dots Repeat First repeatFirstPoin Boolea If checked redisplays the first calibration or Point t n validation fixation dot Force Manual forceManualAc If checked the user has to manually accept n each calibration and validation fixation point Lock Eye After lockEyeAfterC If checked locks the recording eye on the n Accept cept Calibration alibration display computer keyboard if performing a monocular recording Select Eye selectEyeAfter Boolea Controls whether the best eye is After Validation n automatically selected as the default after Validation validation If unchecked binocular mode 1s kept by default Calibration alibrationPosi
317. ion Type property is set to INTEREST AREA Target interest areas used to define the triggering region Note that this property is only available when the Region Type property is set to INTEREST AREA If set to True the trigger should fire when the fixation are within the target region Decides which eye s data is used for online parsing The default value is EITHER It can also be LEFT or RIGHT Duration 0 by default of fixation in or out of the region before the trigger fires This property is available only if the Event Type is set as UPDATEFIXATION or ENDFIXATION Fixation Event used for parsing This trigger fires when the start of a fixation 1s detected when set to STARTFIXATION or the end of a fixation if set to If set to ENDFIXATION UPDATEFIXATION Experiment Builder checks for fixation update event 1 e summary data of the fixation sent from the tracker at a constant interval 50 ms or so It will fire after a pre specified amount of time into a fixation If the Minimum Duration of the UPDATEFIXATION is set to 0 or any value within one fixation update interval the trigger will fire after receiving one fixation update event Triggered Data triggeredData Data about the fixation trigger if fired see the following table SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 164 When a fixation trigger fires the us
318. ion and validation and then runs several trials Trial Sequence Every iteration of the Trial Sequence starts with pre recording preparations e g preloading image audio video resources clearing trigger data sending some simple drawing graphics to the tracker screen flushing log file and drift correction followed by the trial recording Recording Sequence and finally displaying feedback information if necessary The Recording Sequence is responsible for collecting the eye data and is where visual and auditory stimuli are presented Response collection from the participant is also performed in the Recording Sequence SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 35 Experiment Block Greetings Trial Calibration Or Break Trial Preparation or Instruction a Blocks if y Drift Recordin Trials pi 9 Good bye k l or Debriefing Correction Recording Display Stimuli Feedback Wait for Response Figure 6 1 Hierarchical Organization of Events in an Experiment 6 2 Experiment Graph Flow Diagram Experiment Builder uses an intuitive flow diagram interface for experiment generation the whole experiment generated can be called a graph Like a drawing board the user can drag and drop experiment components into the workspace of the graph editor window These experiment components are usually either triggers or actions that represent individual events and preconditions in the
319. ion count of the sequence a Double clicking on this field will bring up a data Source editor see Chapter 9 Data Source for details The Columns X Rows X reports the current size data source Freeze Display freezeDisplayUn Boolea If checked the display will not be updated until Until First tilFirstDisplayScr n the call of the first Display Screen action within Display Screen T een the sequence to avoid some undesired display change The field should be checked in most experiments Prompt for _promptForDatas Boolea If checked a dialog box will show up at the Dataset File T etFile beginning of the experiment allowing user to will load in the default dataset file For an experiment project with custom class enabled a method defined in the custom class can be run for every poll of the sequence Similar to the EXECUTE action a list of parameters will displayed if a method 1s selected from a custom class instance Please note that running this callback function may add an extra delay to sequence polling and there should be used with caution avoiding running any g callback function that takes a significant amount __ Result of the execution method Lo a a Type method A recording sequence should be included in an EyeLink experiment Failing to do this specify one sequence as a recording sequence check the Record checkbox Note that this checkbox will not be available if the current project is a non Eye
320. ion to a text file before pressing the OK button eo Reference Maintanence i xj The folowing list tems have been removed because they refer to experiment nodes outside the component being exported RECORDING EyeLink Record status Message Trial stro BlOCk TRIAL TRIAL DataSource triath V6 stri BLOCK TRIAL TRISL_DataSource type 4 str BLOCK TRIAL TRIAL_DataSource foreground BACKGROUND IMAGE gt Source File Name parent parent parent BLOCK TRISL TRIAL_DataSource background FOREGROUND IMAGE Source File Name parent parent parent BLOCK TRIAL TRIAL_DataSource foreground OK Save Figure 7 3 Reference Maintanence SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 48 e A dialog box will be displayed asking you whether you want to export all necessary library files Press Yes to export all necessary library files If No is pressed Experiment Builder will not export library files it 1s the user s responsibility to maintain the files herself himself If the Cancel button is pressed the node exporting operation will be cancelled eos Export Library Files a x op Would you like to export all necessary library resource Files E Mote Exporting a large number of or large sized library resources can be time consuming and result in a large exported ebo file Mo Cancel Figure 7 4 Export Library Files 7 3 2 Importing 1 Click anywhere in the blank
321. iring based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Text to be sent to the tracker The following figure illustrates the use of SEND_EL_ MESSAGE action In the EyeLink Message field the user can enter a string directly see panel A In case runtime data accessing is required the user may need to use references and equations and SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 75 create the message text in the attribute editor see Panel B see Chapter 10 References for details START DISPLAY_SCREEM EL_BUTTON Ha DRIFT_CORRECT fa RECORDING abel SG _TIMER endEyeLinkMessaqge lear Input Queues m A B Figure 7 14 Using Sending Message Action 7 9 5 Sending EyeLink Command The EyeLink tracker ial text commands sent through the link The SEND COMMAND action B is used for on line tracker configuration and control Please refer to the ini files in the EyeLink directory of the Host PC typically SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 76 c eyelink2 exe for EyeLink II and c EyeLink exe for EyeLink I system for a list of possible commands that can be sent with this action The send command action is not available in non EyeLink experiments
322. isplay computer time in milliseconds from the start of the experiment when the trigger was checked for the last time Time difference between the trigger time and last check time of the trigger This indicates a window of uncertainty a Duration duration Integer The maximum duration 4000 msec by default of delay set in the trigger Duration Type J durationType String Unit of timer duration either msecs or frames Start Time startTime Integer Display computer time in milliseconds from Time e Confidence confidencelInterv Float Interval l the start of the experiment when the trigger starts The default value is 0 the timer starts from the previous action or trigger to which the timer is linked and resets if that action or trigger re enters If a different start time should be used for the trigger the user should use the attribute reference functionality to set the start tme Elapsed Time elapsedTime Integer Amount of elapsed time in milliseconds since the timer starts By default the start time of the timer trigger is set to 0 which means that the timer starts from the end time of the previous action Therefore if the timer is attached to a display screen it doesn t start until the display screen s retrace starts Similarly if it is attached to a EyeLink Message action the timer will start only after the message is sent If the timer is connected from a trigger the s
323. itten to the data file so a discontinuity will be present in the message stream 8 1 2 5 Frame Caching To help ensure smooth video presentation Experiment Builder caches a certain number of video frames in memory By decoding n frames in advance the application does not have to wait for the decoding of the next frame before it can be displayed on screen By decoding frames ahead of time dropping frames becomes less likely The maximum number of frames that are cached for each video resource can be changed go the Display Device to set the desired value of the Video Frame Cache Size This should be a value between 5 and 60 Unless there is a specific reason to change the default frame cache size we suggest that you do not change the frame cache value SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 209 A large frame cache size results in a larger amount of system memory use This can cause a longer initial preparation time for the video resources increasing the PrepareSequence actions duration A larger frame cache size and increased system memory usage can also cause the overall system performance to degrade if there is not enough physical RAM to hold the frame caches 8 1 2 6 Video Codec Experiment Builder supports playing video files that are compatible with VFW video for windows and XVID encoded files In each experiment the user can load either VFM or XVID video files into the library manager but not bot
324. iu COLOR WORD EXPECTED COMP AT ELE TRIAL N Lise Paoi Fa Ma l P 3 Click on this cell 5 Click OK to finish j Precision a aj aj Figure 15 23 Adding Variables to Results File 1 From the Structure Window click on the first START node Just underneath the topmost Stroop node 2 In the work space select the RESULTS_FILE node 3 Click on the value field of the Columns property of the node SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 319 4 Select the desired variables click Add button to add the variables to the results file Click OK to finish 5 In the properties window of the Results node set Field Width to 8 and Precision to 2 If you want to record the missing values as in the result file make sure the Use Period for Missing Values box is checked 15 117Running the Experiment Click on Experiment Build menu to build the experiment The Editor Selection Tab in the Graph Editor Window will be set to the Output tab and build information will be displayed Watch out for error displayed in red and warning in brown messages during building If no errors are found in the Experiment graph click on Experiment gt Test Run to check out whether the experiment runs as designed Note that test run is not intended for real data collection and should be only used when you are testing your experiment To run the experiment fo
325. ive your function a doc string but you always should SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 270 e The doc string should start with a RETURN text case sensitive e Following the RETURN text provide a default value of the type or the repr__ value of the class e g str for string 12 3 6 setX and getX Methods Method name starting with set and get are assumed to operate on the class attributes and are handled differently from regular custom class methods def init__ self sreb EBObject __ init__ self self myProperty 1 Property myProperty A read and write integer type property def setMyProperty self c self MyProperty c def getMyProperty self return self myProperty To allow the getX and setX methods to operate directly on a class attribute x the following syntax rules must be followed e The class attribute identifier must be an alphanumeric string and start with a lowercase letter e g use self myProperty instead of self MyProperty e The getX and setX method name should be composed of set and get string and the attribute identifier with the first letter of the identifier capitalized e g getMyProperty instead of getmyProperty The getX and setX methods that do not follow this rule will be treated as regular class methods e The getX method shouldn t take extra parameter except for the mandatory parameter self e The setX method expects an extra param
326. ived If however you don t know the specific trigger values you may use the Pin Mode and set all of the pin values to EITHER to poll the incoming trigger events The trigger will fire as long as the incoming TTL signal changes the pins value of the parallel port device on the display computer If you know the specific pin the trigger expects set that pin value and leave all other pin values to EITHER If you know the exact trigger value then specify it either in the PIN or WORD mode For example if the user wants to end the trial when the parallel port received a specific input data 0x58 the properties of the TTL trigger can be set as the following e If the Mode set to PIN the user should make sure that pin 3 4 and 6 set to ON while the rest pins set to OFF see panel A e Ifthe Mode set to WORD the user should enter either 0x58 hexadecimal or 88 decimal in the Data field If a decimal number is entered this will be automatically converted to a hexadecimal number see panel B Status Input Register Base Address 1 Pin Pin6 PinS Pind Pin3 Pin2 Pint Ping Hes Status S o gt sen T Properties H X Properties l H x Property Property Value TL_INPLUT J abel TL_IMPUT EE ode Path RECORDING TTL_INPUT Message confidence Interval te PIN Fin 0 DIFF ir 2 OFF ON OFF Pin 4 Pin 6 e A E Register STATUS ode SR Research Experiment Builder User Manual 200
327. ixels added to the left top right and bottom of the interest area that bounds the resource Shape Type The type of interest area to be created either rectangular or elliptic type 17 2 14 Word Segmentation s Preferences x Property ooo oe O Egi Preferences Eb e Experiment eft Margin 30 ao Devices Right Margin Bo B Screen Bottom Margin bo HE Resources Emon iz EOT Fill Gaps Between HHG Movement Patterns GE 2 H Built In Interest Area Preference mA EH GRID_SEGMENT Enable Interest Area Delimiter M 2 Ba Ag AUTO SEGMENT Delimiter Character so Ay WORD SEGMENT nable Interest Area Delimiter Rep ri H BuildiDeploy D limiter Replacement Character GUI Segmentation Direction eft to Right Top to Bottom H GRAPH_LAYOUT He CUSTOMCLASS_FDITOR Restore Factory Default Save Properties as Default Import From File Save Into File Word segmentation will create a rectangular interest area to contain each of the word in a text or multiline text resource Segmentation Spacing Threshold Number of consecutive pixels below threshold before segment end is identified Left Margin Right Margin Top Margin and Bottom Margin Number of pixels added to the left top right and bottom of the interest area Note that the Top Margin and Bottom Margin fields will not have an effect if Fill Gaps Between is checked Left Margin Number of pixe
328. ize Order m T TTL Repeat First Point m CEDRUS Force Manual Accept Ta L Nodes Lock Eye After Calibration 7 Seren Select Eye After Yalidation 7 s k _ St tC aii Link Filter Level ORMAL File Fiter Level HIGH Eye Event Data GAZE k accade Sensitivity NORMAL Restore Factory Det Save Properties a Import From File Save Into File Figure 14 3 Setting the Tracker Version for the Experiment In addition the user needs to check whether the intended experiment contains any non ASCII characters If this is the case the Encode Files as UTF8 setting in Preferences Build Deploy should also be enabled Failing to do so will result in the following build run time warning WARNING warning 2001 You are using characters that ascii encoding cannot handle Please change your encoding Chinese Japanese and Korean Users Please make sure that the Encode Files as UTF8 setting in Preferences gt Build Deploy setting is always enabled otherwise you may see the following error ERROR error 2070 Internal Error Could not create script Please contact SR Research Sorry MemoryError This may have caused by an invalid encoding Try using UTF8 encoding 14 1 3 Creating Experiment Block Sequence In this example we are going to run three blocks of four trials The first step is to add a block sequence for repeating blocks see Figure 14 4 SR Research Experiment Builder User Manual 2004 2011
329. k area in the work space then click the right mouse button and select Arrange Layout in the popup menu to re arrange the nodes in an orderly fashion SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 311 15 8 1 Creating the Fixation Screen This section illustrates the creation of the fixation screen Images must be loaded into the image resource library before they can be used Follow the steps below to add images to the resource library see Figure 15 16 assuming that you have already created the image Fixation bmp 1 From the Experiment application menu bar select Edit Library Manager 2 In the following library manager dialog box select the Image Tab 3 Click on the Add button to load in images The properties and a preview of the image size type of the file and color bits information will be displayed in the bottom 4 Click the button to finish 5 Double click on the FIXATION_SCREEN action in the work space of the Graph Editor Window 6 Click on the image EB button on the screen builder tool to select the type of resource to be added and then click anywhere on the screen In the following Select Image Dialog select Fixation BMP and then click on the OK button 7 Select the image resource Click on both Horizontal Center Alignment and Vertical Center Alignment E buttons to place it in the center of the screen Select the resource aga
330. k on the Clear History menu 4 6 Packaging an Experiment The user can pack up the current experiment project by clicking File Package from the application File menu This will zip up the experiment directory and save the zip file at a location selected by the user The created zip file contains only the files necessary to rebuild and run the experiment graph ebd Preferences properties and library directory The packed project can be unpacked by Experiment Builder Tip The experiment can also be packaged up by clicking the Package button on the application tool bar or pressing F5 on Windows or Ctrl Shift P on Mac OS X Experiment packaging is very useful if you want to send another Experiment Builder user an experiment you have created so they can modify the experiment in the Experiment Builder 4 7 Unpacking an Experiment The packed experiment project can be unpacked by clicking File gt Unpack from the application File menu In the following dialog the user should select the packed project source and specify a directory to which the project should be unpacked Destination Unpack O M x Packed Project Source o Bimple ebz Directory Unpacked To Destination D Program Files SR ResearchiExperimer OK Cancel Tip A packed project can also be unpacked by pressing F3 on Windows or Ctrl Shift U on Mac OS X or click the icon on the application toolbar Note Version 1 3 1 or later a
331. ke sure to check Draw To EyeLink Host field is set to IMAGE or PRIMITIVE This will draw image or simple graphics on the host screen for the purpose of evaluating gaze accuracy 3 Adda Drift Correction action from the action tab of the component toolbox 4 Click on the Action Tab of toolbox select the Sequence node hold down the left mouse button and drag it into the work space 5 Make a connection from the START node to PREPARE SEQUENCE from PREPARE SEQUENCE to DRIFT_CORRECTION and from DRIFT_CORRECT to the SEQUENCE node 6 Click on any blank area in the Work Space Click the right mouse button and select Arrange Layout in the popup menu to re arrange the nodes in an orderly fashion SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 288 7 Double click on the newly created sequence to fill in the actual events in the recording 14 1 8 Editing Recording Sequence In the current step the properties of the trial recording sequence should be modified see Figure 14 11 The actual display presentation should also be worked out In this simple recording sequence we will display a screen and then wait for a button press response from the participant The trial times out automatically if no response is made within 10 seconds The display screen is then cleared SE Research Expenment Buler y Lanm AC Semple EE nlf Fis Edt View Experiment Help
332. ktop click Start gt All Programs gt Accessories gt Command Prompt Go to the deployed experiment directory by typing cd experiment path on the command prompt and type the experiment exe file name to start the experiment Running the experiment from the command line prompt also allows the user to pass additional parameters to the program Some of the useful command line options are SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 25 e session lt your edf or session name gt If the session option is used the software will not prompt for a session name via a dialog box at the beginning of the experiment The session name pass along the session option must be within eight characters consisting of letters or numbers e ui GUIICONSOLEINONE The ui option allows to disable the file transferring dialog box at the end of the session If ui GUI the graphical progress bar is popped up default if ui CONSOLE progress updates are printed to the console 1f ui NONE no progress messages are brought to the user For example for an experiment named simple_deployed you can pass the ui NONE to disable the files transfer progress bar simple_deployed session myTest ui NONE e The acutal paramters passed along the command line can be retrieved through the Command Line Arguments property of the Experiment node Running the deployed version of the experiment doesn t require a license key plug
333. l be removed Region Type regionType String The type of triggering Region used RECTANGLE 0 ELLIPSE 1 or INTEREST AREA 2 Note that the INTEREST AREA option is only available when interest areas are defined in one of the display screens in the same recording sequence Region Location regionLocation Point Pixel coordinate of the top left corner of the Top Left boundary region in x y tuple The default value is 0 00 0 00 Note that the x y coordinate of the region location can be further referred as regionLocation x and regionLocation y respectively Note that this property is only available when the Region SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 163 Type property is set to either RECTANGLE or ELLIPSE Region Width regionWidth Region Height regionHeight _ ae Tracking Eye mer oe Minimum minimumDuratio Integer Duration i Screen Interest Area Regions Within haa Width 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE Height 0 by default of the boundary region in screen pixels Note that this property is only available when the Region Type property is set to either RECTANGLE or ELLIPSE The display screen on which target interest area regions are located Note that this property is only available when the Reg
334. l4LS Edine ReCOrdin Sequences enean a a a 289 14 1 9 Modifying Properties of Display Screen eeeneesssseeeesssssssseerssssssssse 290 14 1 10 Creatine Display SEGi eea a wecenacies 291 IAE Waun Miran TD tO BDF Tile 5 cisco hse an cveisn ae 293 14 1 12 Showing Experiment Progress Message on Tracker Screen 293 142 Butldinge th Experiment s gcsiccersesedavinntivresscetdasiaataxentondsa vane eanieecdawelaaelaandadedes 294 t gt Deployme the Bx perme ntsc sein tetaiondimcsenictedadvasacsnntieetaitietid ese ete teeeaias 295 HA Rumin tie EX periment ssstsecnersci E EEE 295 14 4 1 Error in Initializing Graphics seesrsssvatcseaiaaiwanceiweuatinaleientaaiene 296 lA Bror racker Ver ilonsecrr nan a a A 296 15 Creating Non EyeLink Experiments Stroop Effect eeesesssseennssssssseerrrsssssseees 297 15 1 Creating a New Experiment SeSSI00N ccccccccssssessseeecececeeeeeseeeeeeeeeeaaeenees 297 15 2 Configuring Experiment Preference Settings ccccceseeeeeecceeeeeeeeeeneeeees 298 15 3 Creatine Experiment Block Sequence sscirsrarceaen e 299 1534 Edi ne Block S CQUCINC acices tune eceassanctnramsinessisandinadanedDeanvandsaracstseswinadsnaseseatietalies 300 135 Creatine INSUUCH OM SCLC CIs 0 sedaue en tentas a a a 302 19 6 Editing Trial Sequence Data SOUtCC csn aT 303 15 7 Editing Trial Sequence Setting Initial Values and Preparing Sequence 306 15 8 Editing Trial Event Sequence
335. label is RECORD_SOUND Type NR The type of Experiment Builder objects C RecordSound the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the action returns Time time Float Display computer time in milliseconds from the start of the experiment when the action is processed Start Time startTime Float Display computer time in milliseconds from the start of the experiment when record sound control action begins Clear Input clearInputQueue Boolea If true all events from input queues are Queues S n flushed when the action is started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Filename wav for the audio clip Maximum duration for the sound recording Status status Integer Current status of the playsound action 1 recording yet to be started 1 recording in progress 1000 recording finished Position position Integer Position into recording
336. lable in most of the triggers and actions Read Only f NR Boolea_ Check this box if you do not want to save any n changes made to the experiment project SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 53 JF START Na BLOCK G TIMER GP EL_CAMERA_SETUP Ave TRIAL F START PREPARE_SEQUENCE i erect oo Se Experiment Components Properties i pee Simple i I fon Feb 21 1452 ession Mame est Run Command Line Arq License ID FEB A SBA Figure 7 8 Properties of the Experiment Node The EyeLink DV Variables property is used to send trial condition messages to the EDF file so that the user knows exactly under which condition each trial recording is performed After clicking on the value field of the property a dialog box will be displayed to allow the user to choose variables to be recorded The list of possible variables includes columns in the experiment data source see Data Source as well as new variables created by the user see Variable If the user wants to have the experiment time out after certain duration enter the millisecond time out value in the Time Out field 7 7 Sequence Subgraph A sequence D is used to encapsulate different actions and triggers This allows the user to perform editing operations cut copy delete paste on all of the items contained within the sequence together It also allows the user to execute them in a loop and repeat the ex
337. lation mode This can be done by using an EyeLink_Command action before the recording sequence immediately after the PREPARE SEQUENCE or as the first node in the recording sequence so that the drawing is overlaid on top of the existing host graphics The drawing command can be either a draw_box or draw_filled_box The Text of the command should inform the tracker of the top left right and bottom pixel position of the triggering region as well as the drawing color This can be done either with string concatenation or string formatting The topleft corner of the triggering region is FIXATION regionLocation x FIXATION regionLocation y and the bottom right corner of the triggering region is FIXATION regionLocation x FIXATION regionWidth FIXATION regionLocation y FIXATION regionHeight String Concatenation str FIXATION regionLocation x str FIXATION regionLocation y str FIXATION regionLocation x FIXATION regionWidth str FIXATION regionLocation y FIXATION regionHeight 3 String Formatting d d d Yd 3 FIXATION regionLocation x FIXATION regionLocation y FIXATION regionLocation x FIXATION regionWidth FIXATION regionLocation y FIXATION regionHeight SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 168 All of the drawing commands are documented in the COMMANDS INI file under CA EYELINK2 EXE or C ELCL EXE directory
338. lay event Specifically the time of voicekey response should be retrieved as VOICE_KEY triggeredData time see the following figure With that you can calculate the response time voicekey_time value display_onset_time value In case the trial can end without having the subject to SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 183 make a response or the voice key fails to trigger you may use the UPDATE_ATTRIBUTE to reset the default values for the variables at the beginning of the trial so that the response data from the previous trial will not be carried over to the current trial Don t forget to add the variables to the EyeLink DV Variable list or to the RESULT_FILE aa RESET VARIABLES cument Eye Tracker Time l curent Display P C Time RECORD_SOUND EJ Fudio Recording Start Time DISPLAY IMAGE display _onset_Time re L Ea voicekey_time 4 j x T a woicekey RT EA VOICE KEY i display onset Time valem M DISPLAY_IMAGE time EVOICE_KEY triggeredData timem i woicekey RT valued Fint voicekey_time value display_onset_Time valued yoicekey tine valued ord RECORD_SOUND_STOP Ld Figure 7 65 Collecting voicekey response data 7 10 12 2 How to align the recordings in the audio file and eye tracker event time For post recording verification of the accuracy of the vocal responzse it is recommende
339. lder User Manual 2004 2011 SR Research Ltd 17 4 Working with Files The SR Research Experiment Builder is used to create build test run and deploy experiments on either Windows 2000 XP Vista and Windows 7 or Mac OS X Each experiment creation session generates a binary file graph ebd which contains the graphic layout of the experiment and a set of supporting files and directories for preference settings image loading etc With these files the experiment creation session can be reopened later for review or modification After the experiment is built the user can deploy the experiment to a new directory This will generate a set of files so that the experiment can be run on a different computer without relying on the Experiment Builder application 4 1 Creating a New Session To create a new experiment session from the application menu bar choose see Figure 4 1 File gt New Tip A new experiment session can also be created by clicking on the New Experiment button B on the application toolbar or by pressing shortcut keys Ctrl N on Windows or Command N on Mac OS X eof EyeLink Experiment E File Edit view Experirr Ctrl M Ctr a Open TE Reopen b eee See il Save As ia Package FS ca Unpack F3 Exit Figure 4 1 File Menu This will bring up a New Project dialog see Figure 4 2 prompting for the experiment project name and a directory under which the experiment project
340. licking on hdd32 exe in C Program Files SR Research Common folder see section 3 3 1 HASP Driver Installation 3 Check license status Click on the License Manager utility to check for the licensing status for the Experiment Builder software see section 3 3 2 Software Licensing 3 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 Experiment Builder at the same time for the Experiment Builder software 1 Install the Experiment Builder software Double click on the sreb_1 exe installer keeping the default settings on InstallShield Wizzard 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 2 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 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 12 or double clicking on HaspUserSetup exe in C Program Files SR Research Common folder 3 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
341. lies of file AD Size 0 1 ME Vvicth 20 pixels Height 450 pixels Bit Depth 24 Frame Rate 29 97063 fps Figure 8 5 Loading Video Clips into Video Library To add a video resource onto a display screen click on the Insert Video Resource button on the Screen Builder toolbar and then click anywhere in the screen workspace When a Select Video dialog shows up choose the desired video file The first frame of the video will now be displayed on the screen Please make sure that the video file name does not contain space or non ASCII characters Reference VIDEO_RESOURCBEP Type s The type of screen resource VideoResource the current item belongs to Visible t visible _ Whether the resource should be visible The default setting is True box checked Screen Index Index of the resource in screen resource list O n Position is Gaze positionAtGazeC Boolea Whether the position of the resource is Contingent T ontingent contingent on the gaze position The default setting is False This setting is only available when the display screen is contained in a recording sequence Position is _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent n contingent on the mouse position The default SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 204 Contingent setting is False Offset offset Point Adjustment of the resource position r
342. liseconds from the start of the experiment when the button is pressed EDF Time EDFTime EDF time when the button is pressed Button button The ID of the pressed button that fires the trigger Pressed _pressed Integer Whether the triggering button is pressed 1 or released 0 For example if the user wants to end the trial by pressing Cedrus button 1 and 4 the properties of the button trigger can be set as SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 134 ButtonTest START T PREPARE_SEQUENCE START Ka RECORDING DISPLAY INITIAL TIMER DISPLAY BLANK DISPLAY INITIAL Properties H X ERUS INPUT edryslnput ECORDING CEDRUS IMF CEDRUS_INPUT DISPLAY BLANK riggered Data Press Events Release Events Buttona Figure 7 39 Using Cedrus Button trigger The following discusses some of the common applications of the Cedrus Input trigger 7 10 5 1 Calculating response time of a button press Cedrus button responses can be retrieved by using the UPDATE_ATTRIBUTE action Typically you may use a couple of variables to record the button pressed the time RT of the button press and the accuracy of the button press Specifically the button press should be retrieved as CEDRUS_INPUT triggeredData button the time of button press should be retrieved as CEDRUS_INPUT triggeredData time see the following figure With that you can calculate the resp
343. ls added to the left of the interest area Right Margin Number of pixels added to the right of the interest area Top Margin Number of pixels added to the top of the interest area Note that this field will not have an effect if Fill Gaps Between is checked Bottom Margin Number of pixels added to the bottom of the interest area Note that this field will not have an effect if Fill Gaps Between is checked Fill Gaps Between If checked gaps between consecutive Interest Areas will be filled by expanding the size of each Interest Area SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 349 Enable Interest Area Delimiter Whether a special delimiter character instead of the commonly used space should be used to mark the boundary between segments Delimiter Character Specify the delimiter character one single character only used to Separate segments Enable Interest Area Delimiter Replacement Whether the delimiter character should be replaced by another character Please note that the delimiter characters are used to separate string tokens and will not be displayed in the text or multiline text resource Therefore if you use space as the delimiter character you will need to enable the delimiter replacement option and set space as the replacement character Delimiter Replacement Character One single character that is used to replace the delimiter character Segmentation Direction Direction Left to Right
344. lse This setting can only be modified when the display screen is contained in a recording sequence SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 219 Position is _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent n contingent on the mouse position The default Contingent T setting is False Offset offset Point Adjustment of the resource position relative to the position of the current gaze or mouse position The default offset is 0 00 0 00 Host Outline Color The color of the box drawn on the host screen to hostOutlineColor show the position and dimension of the current resource This property is available only if the Color Use for Host Display option of the containing display screen action is enabled Screen Location NR Whether the location specified below refers to Type the top left corner or center of the resource This setting can be changed at Screen Preferences Location location Point The coordinate of the top left corner or center of the resource Width of the resource in pixels Height of the resource in pixels Movement NR Movement pattern sinusoidal or custom of the Pattern resource Prebuild to _prebuildToImage Boolea Whether the resource should be built into an Image T n image when the experiment is built instead of having it created during run time This field is always true when the screen is contained in a rec
345. lso allows you to unpack a project by simply clicking on the ebz file SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 23 4 8 Building an Experiment After creating the experiment the user needs to compile the experiment to make sure that there is no error in the experiment graph To do that from the application menu bar choose see Figure 4 7 Experiment Build Tip Building an experiment can also be performed by clicking on the Build button Lz on the application tool bar or pressing F9 on Windows or Ctrl Shift B on Mac OS X eos EyeLink Experiment Builder 1 1 0 100 File Edit View Experiment Help Clean FY D Bas Bia Build Fo Test Run Fil ra Deploy Fiz Figure 4 7 Experiment Menu 4 9 Cleaning an Experiment Sometimes the user may want to clean up the experiment projects This is especially important when the user has changed the images or other screen resources used for the experiment To do that from the application menu bar choose Experiment gt Clean Tip Cleaning an experiment can also be performed by clicking on the Clean button s on the application tool bar or by pressing shortcut key F7 on Windows or Ctrl Shift C on Mac OS X 4 10 Test running an Experiment from EB Application To check whether the experiment works the user may test run the experiment from the Experiment Builder application To do that from the application menu bar choose
346. m 1 0 left channel only through 0 0 left and right channels have equal volume to 1 0 right channel only Balance works by attenuating one of the channels for example at a pan of 0 5 the right channel is at full volume while the left channel is at a volume of 0 5 Note that this option is not available on Mac OS X for clip playing for guaranteed performance will be ASIO minimum output latency 2 Play Start _playStartSample Integer The position within the buffer of the start of Sample play samples from start of file loaded into Estimated estimatedPrepare Float If the sound is scheduled enough in advance it Prepare time Time will play on time The estimate time to prepare buffer 0 start of buffer Note that this option is only available when the ASIO driver is used on Windows SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 93 Play End _playEndSample Integer The position within the buffer for the end of Sample play samples from start of file loaded into buffer 0 end of buffer Note that this option is only available when the ASIO driver is used on Windows Play Start Time playStartTime Reports the time at which the first sample of a clip was last played in Display computer time in milliseconds from the start of the experiment This is set to O when the clip playing 1s scheduled End of audio play can be determined by a combination of playing when returns False
347. mage Please note that the user should determine the screen type before working on any resources as changing the Location Type preference setting in the middle of the experiment generation may cause some undesired behaviors 8 1 1 2 Gaze Contingent Window Manipulations To create a screen with gaze contingent window manipulation the user needs to add two full screen images to the display screen one as the foreground the part of the image to be displayed in the window and the other one as background the part of the image to be displayed out side of the window For the foreground image the user should also make sure that the Position is Gaze Contingent and Clipping Area is Gaze Contingent boxes are checked Please note that these two attributes will only be valid when the display screen is contained in a recording sequence otherwise they will be grayed out The user should also set the Clipping Width and Clipping Height properties in pixels of the foreground image to specify the size of the central window See the GCWindow template for an example It is easier to create a gaze contingent display with Center Position screen location type After adding each image to the screen click the horizontal center alignment and vertical center alignment buttons to put the image in the center of the screen see left panel of Figure 8 4 However if the user wants to create such a display in a top left scree
348. make the text looks better the user may enable the anti aliasing function see Section 8 1 3 2 Anti aliasing and Transparency If this is the case please click on Preferences Screen to enable Antialising Drawing In addition click on Preferences Experiment gt Devices gt Display to set the transparency color value to something similar but not identical to the background used in the display screen In the current example the user may set the RGB value of the transparency color to 251 250 251 Anti aliasing may be enabled in experiments using Text or primitive drawings shown on a uniform background 5 If any of the above settings have been changed and if you want to keep the new settings as defaults for all of your future experiments click on the button save properties as default EyeLink I and 1000 users The default tracker version is set to EyeLink II EyeLink I and 1000 users should also make sure that the Tracker Version setting in the Preferences gt Experiment gt Devices gt EyeLink preferences is set to EyeLink I or EyeLink 1000 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 280 xi Property Value f Preferences mar Experiment racker Address 010 1 1 1 __ 4 Devices OEY ELINK Eyelink yelin Eyelink Il Z Es a iT a DISPLAY e AUDIO MOUSE Pacing Interval Eyelink 1000 g KEYBOARD Random
349. mert Help soe88e Sake ROGER CTAOS ie aer Ae2le rvr QQ GQHBE xj igiol neem ae mlO D e F START ish BLOCK Gf start p besa SCREEN 5 plage 3 Select the Baas variables to be s TIMER E pL camera SETUP added jas TERRAL T2 Click here to bring up EyeLink DV Variable dialogbox Figure 14 15 Creating Trial ID Message 1 Click on the Experiment the topmost node in the structure list to start 2 Inthe property table click on the value field of the EyeLink DV Variables property 3 In the following dialog box for each of the variables to be added to the trial ID message select the variable and click the ADD button The order of the selected variables can be modified with the Move up and Move down buttons 4 Click on OK to finish 14 1 12 Showing Experiment Progress Message on Tracker Screen During trial recording a text message can be displayed at the bottom of the tracker screen so that the experimenter can be informed of the experiment progress see Figure 14 16 For example in this experiment we wanted to show a text message like Trial 1 12 One on the tracker screen 1 Click on the Recording sequence node in the structure list to start SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 293 2 Inthe property panel click on the far right end of the value field of the EyeLink
350. mice if you need to 6 Now for all of the mouse triggers the possible mice to be used are listed in the Use Mouse property of the trigger 7 When you run your experiment with multiple mouse devices you will now be asked to click on the left button of the intended mice so that Experiment Builder can map the mice labelled in the Mouse Device to the physical mice The experiment shall start after the keyboards and mice are identified 7 10 7 7 Recording mouse traces in a data file To save the mouse coordinates into an EDF file or to a results file when doing non eyetracking experiments one quick solution would be filling out the message field of the DISPLAY_SCREEN and use this to output the coordinate of the mouse For non EyeLink experiment make sure the Save Messages option of the topmost experiment node is checked for message logging For example you will get outputs like the folllowing in the results session name folder with the following DISPLAY_SCREEN message TRIAL t str parent parent iteration IMOUSE tX t str CUSTOM_CLASS_INSTANCE mouseX tY t str CUSTOM_CLASS_INSTANCE mouseY 13645 141 16 TRIAL 2 MOUSE X 512 Y 378 13661 6088 16 TRIAL 2 MOUSE X 512 Y 370 13678 538 16 TRIAL 2 MOUSE X 512 Y 360 13695 127 16 TRIAL 2 MOUSE X 512 Y 348 13711 654 16 TRIAL 2 MOUSE X 512 Y 336 13728 289 16 TRIAL 2 MOUSE X 512 Y 327 13745 155 16 TRIAL 2 MOUSE X 32 X 315 13761 735 16 TRIAL 2 MOUSE X 512
351. middle Node Attributes panel double click on the Iteration node B3 This will update the contents of the top Attribute editor dialog as parent iteration Click on the OK button to finish B4 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 308 i SA Reston aperies Mahler e 1b RE Stree e ajgj xj DEBS Sl SKRART A TADS car Ael QQRBAR mbo START g Q ORAA TRAL NDEA HKETFRESS REEFUHSE Af pe S00 Arite PATE Ati eimi B3 Double click on the START H beray DOREEN D THER i HEV eOarD l e Dsus B2 Click on the TRIAL node Jil START j TRL INDEK d KEYPRESS RESPONSE f RI iT PRATE ATTRIBUTE PREPARE SEOUENCE in Pramet tor Destro Fie B1 Click here to start the attribute editor dialog box ici mera B4 Click here to finish Figure 15 12 Update Trial Iteration d Similarly set the second cell of the Attribute column to RT value Click the left end of the second cell under the Value column type 32768 and press Enter to register the change e Set the Attribute 3 to KEYPRESS value and value 3 to f Set the Attribute 4 to RESPONSE value and value 4 to wparent iteration 32766 Please Set Attribute Please Set Value Figure 15 13 Updating the Attribute of RT 6 Add a Prepare Sequence action into
352. mmend changing the following default settings as this may have negative impacts on the data file integrity and your data analysis Samples If checked samples will be recorded in the EDF file Fixations If checked fixations will be recorded in the EDF file Saccades If checked saccades will be recorded in the EDF file Blinks If checked blinks will be recorded in the EDF file Buttons If checked press or release of the EyeLink button box will be recorded in the EDF file Inputs If checked input data will be recorded in the EDF file Remote Warnings Note The following option is only available for EyeLink Remote eye tracker Giving out warning may not work on some computers running under the real time mode If possible please check the BIOS setting of the Display PC so that hyperthreading or multithreading is enabled Enable Remote Warning enableRemote Warning Whether a warning beep should be given when the eye or target is missing Minimum Eye Missing Duration eyeMissingThreshold Minimum amount of time in milliseconds the eye data is missing before a warning beep will be given SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 330 Eye Missing Beep eyeMissingBeep The audio clip to be played when the eye is missing A different audio clip may be used if that clip has already been loaded into the library manager Edit gt Library Manager select the Sound tab Messages C REMOTE_WARNING_
353. mponent can itself be considered a complex action To implement the hierarchical organization of events in an experiment the Experiment Builders allows one graph containing the triggers and actions to be nested under another graph to represent a sub sequence in the event chain In a typical experiment the user needs to add a couple of nested sequences so that the implementation of blocking trial and recording can be done efficiently see the following figure for an example Given the repetitive nature of the sequence component a data source can be attached to a sequence object to supply different parameters for each sequence iteration Like Microsoft Excel software each column of a data source contains a variable label and each row contains a value for the variables For a typical experiment created by Experiment Builder the user needs to create prototypical trials and to supply the actual parameters for individual trials from a data source attached to the trial sequence During experiment runtime individual lines can be read from the data source supplying the actual parameters for each trial the linkage between the two can be achieved by attribute referencing Sequence Sub A controller for experiment flow Used to chain together graph different Actions and Triggers and execute them in a loop or to simply modularize a set of experiment components EL CAMERA SETUP Block Trial Recording SR Research Experiment Builder User Ma
354. n coordinate she he should also set the Offset attribute of the foreground image to be half of the clipping area width and height see right panel of Figure 8 4 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 201 I lipping Area is Gaze Cor Source File Name Picture O08 jpg se Original Size Clipping Area is Gaze Con Source File Mame Use Original Size Property Label Visible Position is Gaze Contingent Position is Mouse Conting Position is Mouse Conting Tt Offset EXE Po screen Location Type Screen Location Type Location ooo ooo With 024 Height BR Cg me Movement Pattern rebuild To Image Prebuild To Image ee ee Clipping Location Bo Clipping Location oo Clipping With o0 Clipping th lt a Clipping Height Clipping Height lt n Mo B A Figure 8 4 Setting Different Location Types for Images Used in a Gaze Contingent Window Application Finally the order of the foreground and background images added to the display screen matters The user must ensure that the foreground image is listed after the background image in the structure list so that the foreground image 1s drawn in front of the background image see Section 8 4 5 on setting the order of resources 8 1 2 Video Resource The SR Research Experiment Builder supports video clip presentation by using video resources on a display screen The Experiment Builder uses a custom developed video display engine for video clip
355. n is done time Float Display computer time in milliseconds from the start of the experiment when the action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when record sound control action begins Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues f S n when the action is started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Operation operation String Action STOP PAUSE PLAY or ABORT used to control the current audio recording STOP Stops the current audio recording writes out the data stored in the record buffer to the wav file and frees the buffer ABORT Stops the current audio recording without saving the wav file PAUSE Pauses the current audio recording Recording may be continued by using the RECORD action RECORD Unpauses a paused recording The RECORD_SOUND_CONTROL action can only be applied after the RECORD_SOUND action For the usage of this action please take a look at the Record Sound example 7 9 17 Terminating an Expe
356. n 7 10 9 Fixation Trigger 17 1 19 Saccade See section 7 10 10 Saccade Trigger 17 1 20 Sample Velocity See section 7 10 11 Sample Velocity Trigger 17 1 21 Voice Key See section 7 10 12 ASIO Voicekey Trigger 17 1 22 Display Screen See section 7 9 1 Display Screen 17 1 23 Drift Correct See section 7 9 2 Performing Drift Correction 17 1 24 Camera Setup See section 7 9 3 Performing Camera Setup and Calibration SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 344 17 1 25 Send EyeLink Message See section 7 9 4 Sending EyeLink Message 17 1 26 Send Command See section 7 9 5 Sending EyeLink Command 17 1 27 Set TTL See section 7 9 6 Sending TTL Signal 17 1 28 Add to Experiment Log See section 7 9 7 Adding to Experiment Log 17 1 29 Update Attribute See section 7 9 8 Update Attribute 17 1 30 Add to Accumulator See section 7 9 9 Adding to Accumulator 17 1 31 Add to Result File See section 7 9 10 Add to Result File 17 1 32 Prepare Sequence See section 7 9 11 Preparing Sequence 17 1 33 Sequence See section 7 7 Sequence Subgraph 17 1 34 Reset Node See section 7 9 12 Reset Bode 17 1 35 Play Sound See section 7 9 13 Playing Sound 17 1 36 Play Sound Control See section 7 9 14 Play Sound Control 17 1 37 Record Sound See section 7 9 15 Record Sound
357. n when the mouse is within the above mentioned trigger region otherwise the trigger fires when the mouse is outside of the region Triggered Data triggeredData a Data of the triggered mouse button event see Target interest areas used to define the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 148 the following table for further attributes of the mouse triggered data When a mouse trigger fires the user may further access the triggered Data The sub attributes of the TriggeredData attribute are listed in the following table Time time Integer Display computer time in milliseconds from the start of the experiment when the mouse button pressed released Pressed _pressed Integer Whether the mouse button 1s pressed 1 or released 0 Specific button pressed released for trigger firing axis when the trigger fired axis when the trigger fired left corner of the triggering region trigger fires Mouse mouse String For a project with multiple input support this reports the mouse device from which the response is collected The following discusses some of the common applications of the Mouse trigger 7 10 7 1 Mouse press mouse release and mouse over The mouse trigger can be used to collect the participant s response to end a trial For example if the user wants to press any button to end the sequence the properties of the mouse trigger can be set as shown in the figure bel
358. nd F Custom customBackgrou String Background nd Target Beep targetBeep String target supplied The name of the image file that is used for drawing the drift correction background The image file should ideally be a full screen image and be preloaded into the library manager Note that this property is only available if Use Custom Background is checked Sets sound to play when target moves If set to DEFAULT the default sounds are played if set to OFF no sound will be played for that event otherwise a sound file from the audio library can be played play on successful operation on failure or interruption Enable enableExternal External Control Boolea Control n externalControl DeviceConfig External Control Device Config externalControl Device External Control Device SR Research Experiment Builder User Manual Toggling through different camera views adjusting pupil and CR thresholds and accepting calibration validation and drift correction target are usually done through key presses on the display or Host PC keyboard However keyboard may not be easily accessible in some experiments Enabling this option allows to use an external control device to assist the pupil CR thresholding and calibration process This specifies a file used to define button functions to control the pupil CR thresholding and to accept calibration validation and drift correction target If this f
359. nd only after 1000 ms or so of silence 6 Close the recording WAV file with the RECORD_SOUND_CONTROL action The following graph illustrates the above event sequence SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 102 Properties H x Property abel RECORD SOUND ype essage RECORD SOUND ime o parent TRIAL DataSource R ecard O Time _ RECORD SOUND CONTROL Record AudiaCoantral i Py eSsaqe RECORD SOUND CONTROL l T T RECORD SOUND CONTROL lear Input ueues Operation STOF Figure 7 24 Using Record Sound Action 7 9 16 Record Sound Control Record Sound control action LA stops pauses records or aborts the current sound being recorded This action is only supported if Mac OS X is used or if an ASIO compatible sound card is installed on the Windows computer and the Audio Device is set to ASIO Reference Label label hall Label of the Record Sound Control action The default label is RECORD_SOUND_CONTROL Type The type of Experiment Builder objects RecordAudioControl the current node belongs to Node Path The absolute path of the node in the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 103 po experiment graph Message Message Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the actio
360. ndows chat clients email programs etc prior to running an EyeLink experiment These applications are listed in the taskbar at the bottom of the screen Shut down any programs Norton Antivirus volume controller Windows Messenger Google Desktop etc running in the notification area of the taskbar where you usually see the current time displayed lower right corner of the screen Make sure no scheduled tasks e g data backup virus checking are active Remove unnecessary devices e g DV converter flash disk external hard drive connected through the USB or firewire ports Shut down screen saver management Click the right mouse button at a blank space on the Display PC desktop to open a dialog box for display properties settings On the Screen Saver tab set the screen saver to None Shut down power management Select the Screen Saver tab of the Display Properties dialog box and click on the Power button In the Power Options Properties dialog box turn off all features related to power management hibernation advanced power management support turning off monitors or hard drives Disable unnecessary services Themes in particular running at the background This can be done by clicking Start gt Control Panel gt Administrative Tools gt Services In the following services window select Themes Double click on item and select Stop from the dialog box Disabling Themes
361. ned on or not n turned on or not n turned on or not n turned on or not Boolea Whether the LED for button five should be n turned on or not The following figure illustrates the use of the ResponsePixx_LED_Control action All of the LEDs are turned off at the beginning of the trial The participant presses either button 2 or 4 Once the button is pressed the LED for that button is turned on The experiment project can be downloaded from the HTML version of this document SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 112 Property ESPONSEPiz LED onkral BLOCK TRIGL RECORDING TUR Stark Time lear Input Queues fw Button One C Button Two Button Three Button Four Button Five bee oao Message Time Etart Time lear Input Queues fw Bontoa MS Button Five TURM_OFF_LIGHTS DISPLAY_SCREEW 3 Properties O Property ri gt yee OR FSPONMSEPixxLEDContral ee Node Pat BLOCK TRIGL RECORDING TUR ime TIMER TURN _ON_2 lear Input Queues G puerto Button Three putnfor Figure 7 28 Using a ResponsePixx LED Control Action 7 10 Triggers Triggers are used to control the flow of actions within a sequence such as the transition from one action to the other or ending the sequence SR Research Experiment Builder supports several kinds of triggers including timer control those from a device input keyboard mouse TTL Cedrus voice key and EyeLink button
362. ner By clicking on Experiment gt Test Run the experiment will be executed from the Experiment Builder application For an EyeLink experiment a connection to the tracker PC will be made and the user may record some data using mouse simulation The EDF data file should be carefully examined to see whether all of the trial condition variables are properly recorded whether interest areas and images are shown correctly whether time critical and other important messages are recorded for analysis and so on For a non EyeLink experiment the user may rely on a log file or result file to debug the experiment Important Note Every time Experiment gt Test Run is performed the experiment is rebuilt and all of previous data files in the experiment directory are deleted Do not use Experiment gt Test Run for collecting real experiment data Experiment gt Test Run is intended for testing purposes only 2 3 Experiment Deployment After fixing errors in the experiment graph and checking validity of the experiment the user can then deploy the experiment to a new directory This will generate a set of files in the intended directory Please note that the Experiment gt Test Run step mentioned in the previous section must be used only for the purpose of testing and debugging the experiment graph To collect experiment data the user must use a deployed version of the experiment as it does not rely on the Experiment Builder application In
363. ng location type Please note that the location type of all trigger types invisible boundary trigger mouse trigger fixation trigger saccade trigger and sample velocity trigger is top left based whereas the screen resources can be either top left based or center based the screen resource interest area location type can be set by the Screen Preferences This means that references should be created differently depending on whether the region location of a trigger refers to a center based resource or a top left based screen resource Imagine that a saccade trigger should fire when the saccade ends within a rectangle resource RECTANGLE_RESOURCE The top panel of the figure below illustrates creating the Region Location reference when the RECTANGLE_RESOURCE is top left based DISPLAY_SCREEN RECTANGLE RESOURCE location The bottom panel of the figure illustrates creating a location equation when the location type is center based EBPoint DISPLA Y_SCREEN RECTANGLE_ RESOURCE location x DISPLAY_SCREEN RECTANGLE_RESOURCE width 2 DISPLAY_SCREEN RECTANGLE_RESOURCE location y DISPLAY_SCREEN RECTANGLE_RESOURCE height 2 Properties E l Propertics ig Value abel SACCADE RECTANGLE RES ode Path BLOCK TRIAL RECORDING SACCADE essaqge SA CADE Region Direction 0 45 45 90 90 135 135 180 180 135 135 9 Region Type RECTANGLE Region Location Top Left fe DISPLAY SCREEN RECTANGLE RESOURCE location li
364. ng to lock the experiment graphics window You may check out the discussion in Keyboard trigger to disable the Windows Logo Keys SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 26 4 13 Conver ting Projects between Windows and Mac OS X Experiment projects saved on the Windows operating systems can be opened with the Same version or a newer version of the software on Mac OS X and vice versa There are some exceptions on the transferability between the two families of operating systems Voicekey is not supported on Mac OS X When converting a Windows version of the EB project using the voicekey feature all of the voicekey nodes will be removed from the project and a warning message will be displayed Audio playback and recording is done through OS X driver on Mac OS X When converting a project created on Windows with audio playing either through DirectX or ASIO driver or recording through the ASIO driver the audio device will be reset to OS X On the other hand the audio device will be reset to ASIO driver when converting a Mac version of the experiment project with audio recording or playing Only Xvid video clips are supported through the video resources on Mac OS X driver experiment project will not run when other video codecs is used Animation video clips are not supported in Camera Setup and Drift Correction actions on Mac OS X Sending TTL signals or receiving TTL signals is only supported through USB 1208
365. nitors retrace rate If the display retrace rate and video frame rate are not evenly divisible then the desired and actual frame display times can be offset by up to one display retrace rate Duration of decoding and displaying the video frame If the computer hardware that you are running the video presentation on is not able to decode and display frames fast enough there may be delays in the frame presentation If the delay is greater than a frames duration for example 33 33 msec for a 30 fps video then a video frame can actually be dropped increasing the drop frame count for the video resource 8 1 2 3 Video Frame Rate and Display Retrace Rate It is important to know how the nominal frame rate of the video file interacts with the monitor video refresh rate to determine the actual time point at which a frame is displayed As described above a video frame s desired display time is equal to desired frame time video start_time frameNumber 1000 0 frameRate The video frame s actual display time assuming the display computer hardware is capable of presenting the video without dropping frames can be conceptualized as actual_frame_time nearestRetraceTo desired frame_time where nearestRetraceTo calculates the display retrace start time that is closest to the desired_frame_time provided to the function Take the following figure for an example If a video resource file has a nominal frame rate of 30 fps one frame every 33 33 ms
366. nput clearInputQueue Boolea If true all events from input queues are flushed Queues F S n when the action is started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Execute Method NR Method of a class to be executed Click on right end of the value field to start the attribute editor to locate a method in a custom class instance If a method in a custom code class is already linked to this field double clicking on the execute action should bring up the custom code text editor and set the current editing position to the start of the method that the execute action was using Parameter s a A list of parameters the execute method may take Result of the execution method Result Data NR Type of the data returned by the execute Type method 7 9 20 Null Action The Null action node D as suggested by its name does not perform any actual actions Itis primarily used for two reasons a Controlling experiment flow For example the current linking rules do not allow for a direct connection between a sequence and triggers A null action can be used as a dummy action
367. nt Startup Background Color startupBackgroundColor The background color used when experiment starts up SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 333 Minimum msec To Next Retrace flipRemainThreshold The minimum amount of time in milliseconds remaining in a retrace before the next flip can be scheduled In runtime if the remaining time in a retrace to perform a flip is less than the specified amount of time the flip will be scheduled to the retrace after to ensure that the flip is done properly Video Frame Cache Size cacheFrameThreshold Video frame buffer size Min should be 5 max should be 60 Use Video Decoding Thread useVideoDecodingThread Video decoding thread drives the video decoder Decoding thread continually fills this buffer while video playing thread consumes them Current Time currentTime Reads the millisecond clock running on the display computer the clock starts with O when the EyeLink library is initialized Software To Hardware Blit time softwareToHardwareBlitTime Time required to perform a software based copying of resource from system memory to the display surface Hardware To Hardware Blit time hardwareToHardwareBlitTime Time required to blit resource from the video card memory to the display surface Video Memory Size hardwareMemorySize The total amount of memory found in a video card Video Memory Available hardwareMemory Available The
368. nt path e g deploying a project to a folder that contains Chinese characters will fail Tip Deploying an experiment can also be performed by clicking on the Deploy button on the application tool bar or pressing shortcut key F12 on Windows or Ctrl Shift D on Mac OS X Tip For the ease of reconstructing the original experiment project a source folder will also be created in the deployed project Depending on the Build Deploy preference settings this folder contains either the packed experiment project or the graph ebd and Preferences properties files Note Users may deploy the experiment on one computer and then copy and execute the project on a different computer Please make sure the deploy computer and the test computer have the same operating system installed For example an experiment deployed on a Windows Vista computer will not run on a display computer with Windows XP or 2000 installed as the dependency files are very different between the Vista and XP 2000 operating systems Similarly experiment deployed on Mac OS X will not run on the Windows computers and vice versa Other runtime errors could be if the two computers have different settings in Cedrus driver I O driver video card driver audio device etc 4 12 Running an Experiment for Data Collection To run the experiment for data collection from the deployed folder simply double click on the executable file in the deployed directory or from your computer des
369. nual 2004 2011 SR Research Ltd 42 Figure 6 4 Nested Sequences in an Experiment 6 7 References and Equations The Experiment Builder uses references to link or bind an attribute of one experiment component to be equal to the value of another component attribute References see Chapter 10 are a critical part of the Experiment Builder providing much of the flexibility to the application As an example assume a sequence has two components X and Y and component X has attribute Ax and component Y has attribute Ay If attribute Ax was set to reference Ay then the value of Ax would always be equal to the value of Ay In this example it is said that Ax is the referencing attribute and Ay is the referenced attribute Even if Ay changes value during the experiment Ax will always reflect the current value of Ay A reference is represented by a string that starts and ends with a symbol in the attribute editor for an experiment component For example X Ax is a reference to the Ax attribute of component X Y Ay is a reference to the Ay attribute of component Y If the reference is to a component attribute that is not in the same sequence as the referencing component the reference will also contain the graph path to the referenced component The user can refer a variable or an attribute of a node to the attribute of another node trigger action or sequence a variable or data source The users can also use a more complex form of re
370. o ocation SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 180 Properties A x Property SAMPLE VELOCITY Samplevelocity LOCKE TRIAL RECORDING SS amp MPLE_ VELOCITY SAMPLE VELOCITY FBPointi DISPLAY SCREEN RECTANGLE RESOURCE location x OISPLAY SCREEN RECTANGLE RESOURCE widtha n 2 ast Checked SDISPLAY SCREEN RECTANGLE RESOURCE location y Confidence In DISPLAY_ eae nerd RECTANGLE RESOURCE IRCE height 2 a 45 45 90 90 1s e 180 180 135 Region Direction Region Type Region Location Top Left EEPOR DISPLAY_SCREEN RECTANGLE RESOURC Region Width MODTSPLAY SCREEN RECTANGLE RESOURCE width Region Height DISPLAY SCREEN RECTANGLE RESOURCE height ithin Iw racking Eye ITHER rigger Above Threshold m elocity Threshold 60 se Acceleration E riggered Data Properties H Property vae lectangleResource Screen Index Position is Gaze Contingent C Fosition is Mouse Position is Mouse Conting offset t mae Host Outline Calor Color creen Location Type a Height 200 Movement Pattern Prebuild To Image Use Software Surface Figure 7 64 Using sample velocity trigger with top left and center location types 7 10 11 2 Sometimes it is useful to draw feedback graphics on the Host PC so that the experimenter How to show the triggering region on the host PC can monitor whether
371. o differentiate the responses from different keyboards or mice This can be done by enabling the mulitple keyboard support 1 First plug in all of the intended keyboards and mice to the display computer and reboot the computer 2 Install the keyboard and mouse driver that supports multiple keyboard mouse inputs From your computer desktop click Start gt All Programs gt SR Research gt Experiment Builder gt Install Experiment Builder Drivers In the following Tnstall Uninstall Experiment Builder Driver dialog box a list of keyboards and mice detected will be listed Select the intended devices or click on the Select All boxes to install the driver It may takes some time for the drivers to be installed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 143 Si F InstallUninstall ExperimentBuilder Drivers _ x Keyboards I Select All wt ID keyboard Device HID Wid 1267Pid O103Rey O101MI 00 Mice Select All X HID compliant mouse HID Vid O45ePid OOF6Rey 0121 Rollback Drivers Instal Upgrade Driverts Close Figure 7 47 Installing SREB keyboard driver Click on Continue Anyway button if you see the warning dialog The software you are installing for this hardware SREB Keyboard Filter has not passed Windows Logo testing to verify its compatibuility with Windows XP A green check mark will be drawn if the driver is successfully installed You may be prompted to reboot the
372. o the display computer responses from all of the keyboards and mice are treated the same as if the response is made to a single keyboard or mouse In some applications the user may want to differentiate the responses from different keyboards or mice This can be done by enabling the mulitple keyboard support 1 First plug in all of the intended keyboards and mice to the display computer and reboot the computer 2 Install the keyboard and mouse driver that supports multiple keyboard mouse inputs From your computer desktop click Start gt All Programs gt SR Research gt Experiment Builder gt Install Experiment Builder Drivers In the following Tnstall Uninstall Experiment Builder Driver dialog box a list of keyboards and mice detected will be listed Select the intended devices or click on the Select All boxes and click on the Install Update Driver s button to install the driver It may takes some time for the drivers to be installed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 155 BW Install Uninstall ExperimentBuilder Drivers E E x Keyboards Select All HID keyboard Device HIDWid_1267Pid O103Rey O101MT On Mice M Select All Rollback Drivers Instal Upgrade Driver s Close Figure 7 55 Installing SREB mouse driver 3 Click on Continue Anyway button if you see the warning dialog The software you are installing for this hardware SREB Mouse Filter has not pass
373. ocation x INVISIBLE_BOUNDARY regionWidth INVISIBLE_BOUNDARY regionLocation y INVISIBLE_BOUNDARY regionHeight String Concatenation str INVISIBLE_BOUNDARY regionLocation x str INVISIBLE_BOUNDARY regionLocation y str INVISIBLE_BOUNDARY regionLocation x INVISIBLE_BOUNDARY regionWidth str INVISIBLE_BOUNDARY regionLocation y INVISIBLE_BOUNDARY regionHeight 3 String Formatting d d d d 3 INVISIBLE_BOUNDARY regionLocation x INVISIBLE_BOUNDARY regionLocation y INVISIBLE_BOUNDARY regionLocation x INVISIBLE_BOUNDARY regionWidth INVISIBLE_BOUNDARY regionLocation y INVISIBLE_BOUNDARY regionHeight All of the drawing commands are documented in the COMMANDS INI file under C EYELINK2 EXE or C ELCL EXE directory of the host partition See the change template for an example 7 10 3 Conditional Trigger Conditional trigger fires Ay when one or two condition evaluations are met This is useful to implement conditional branching in a sequence when several conditions are possible see the SACCADE example In each condition evaluation the user needs to specify attribute the variable to be evaluated comparator comparison operations such as equal less than greater than etc as well as the target value being compared to Two condition evaluations connected with an and or or logical operator can be made within the same trigger
374. odes Simple BLOCK TRIAL RECORDING Figure 5 5 Components of the Graph Editor Window 5 3 Application Menu Bar and Toolbar The Experiment Builder application menu bar and toolbar contain a list of common operations If you are a menu oriented person you may access all of the operations from the menu bar Most of the operations can also be performed by keyboard shortcuts or by using buttons on the application toolbar 5 3 1 File Menu and Tool Buttons Commands that affect creating opening saving packaging or closing the Experiment Builder sessions are located here see Chapter 4 for details Operation Shortcut Shortcut Function Windows a OS CTRL N Creates a new experiment project CTRL O Opens an existing experiment project Reopens a recent Experiment Builder project a CTRL S Saves the current experiment project Save Saves the experiment project to a different As directory Blok Click on the icon locks a currently unlocked SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 32 poe Proj ect E aa Package a zip file for file sharing etc Sa e ea P compressed zip file Exit Closes the Experiment Builder application a Experime ntBuilder menu 5 3 2 Edit Menu and Tool Buttons This menu contains commands such as copy paste cut delete and undo The menu also contains tools for resource library management node group organization and pre
375. of the experiment For example a recording sequence showing a static page of text may just require a single display screen action whereas an experiment studying change detection necessitates several display screen actions to present alternating screens at a fixed interval SR Research Experiment Builder supports the set of actions listed in the following table Display Screen Used to show a set of 2D graphics on the computer screen Please follow Chapter 8 Screen Builder to modify the content of the screen Camera Setup Displays the EyeLink camera setup screen for the experimenter to perform camera setup calibration and validation Drift Correction Performs an EyeLink drift correction by using a fixation point at a known position to correct for small drifts in the calculation of gaze position that can build up over time This is particularly useful when using the pupil only mode of EyeLink Command Ethernet link for on line tracker configuration and control EyeLink Writes a text message to the EyeLink eye tracker The text Message is msec time stamped and is inserted into the EyeLink EDF file B Add to Log File Allows the user to add text to a log file for experiment SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 39 Poof debugging S Prepare Sequence Performs preparatory works for a sequence e g preloading image or audio files drawing feedback graphics on the Host PC and re init
376. of the host partition See the change template for an example 7 10 10 Saccade Trigger The saccade trigger available only in an EyeLink experiment fires following the detection of a saccade into a pre specified region on the display This trigger waits for a ENDSACC online parser signal from the tracker If the timing of saccade detection is critical the user may use the sample velocity trigger instead Since the saccade trigger keeps monitoring the online eye data this trigger type must be placed within a recording sequence 1 e the Record property of the sequence is checked If you see a This node type cannot be added to this sequence warning message check whether the sequence to which the current trigger belongs is a recording sequence Reference Label label String Label of the saccade trigger The default value a The type of N Builder objects Saccade the current node belongs to experiment graph saccade trigger fires Display computer time in milliseconds from the start of the experiment when the trigger fires Note To check the start and end time of the triggering saccade you should use triggeredData startTime and triggeredData endTime _ e the startTime and endTime sub attributes of the triggeredData attribute Last Check lastCheckTime Float This property can be used to retrieve the Time Display computer time in milliseconds from the start of the experiment when the trigger was check
377. of the mouse device or the first mouse device if multiple inputs are supported SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 338 Mouse Down Input Queue size mouseDownInputQueueSize Sets the maximum number of press events that can be cached in the press event queue for the mouse device or the first mouse device if multiple inputs are supported Mouse Up Input Queue Size mouseUpInputQueueSize Sets the maximum number of release events that can be cached in the release event queue for the mouse device or the first mouse device if multiple inputs are supported Mouse Down Event Count mouseDownEventCount Total number of press events cached in the press event queue for the mouse device or the first mouse device if multiple inputs are supported Mouse Up Event Count mouseUpEventCount Total number of release events cached in the release event queue for the mouse device or the first mouse device if multiple inputs are supported Mouse Two Label Mouse Three Label mouseTwoLabel mouseThreeLabel This supplies a label for the second third mouse device detected by the experiment This option is only available if Enable Multiple Input option is enabled Mouse Two X Position Mouse Three X Position mouseTwoXPosition mouseThreeX Position Default X position of the second third mouse device Mouse Two Y Position Mouse Three Y Position mouseTwoY Posi
378. old the resource blitting is slow as it is done by copying from RAM to display surface color is Black 0 0 0 Font Name f fontName String String that specifies the typeface name of the font Font Name can be selected from a dropdown list The default font is Times New SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 212 Roman When transferring project from one computer to another please ensure the target computer has this font available Font Style fontStyle String Sets whether the text is to be rendered using a normal italic or bold face Font Size fontSize Integer Sets the desired font size 20 by default Please note that texts of the same font size will look smaller by a factor of about 1 33 on Mac OS X than on Windows due to different default DPI values used across the two operating systems Underline T Specifies an underlined font if set to True n Text to appear in screen Use Runtime useRuntimelIAS If enabled an Interest Area set file will be Word Segment created during runtime to contain segment Interest Area T information for individual words in the text 8 1 3 1 Non ASCII characters If the user intends to use a character that does not fit in the ASCII encoding range 1 127 please make sure that the Encode Files as UTF8 box of the Build Deploy Preference settings is checked see Figure 8 6 In another word that field should be enabled if the user is us
379. ollowing table lists some commonly used data types that can be entered in the attribute editor type properties preserved _Hello_ String Hello The under scores are representing white spaces which are trimmed True Boolean True Check Boxes Possible values are True or SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 256 alse False Boolean False Check Boxes Possible values are True or False 100 100 100 0 100 0 5 2 6 5 0 2 0 6 0 Buttons keys Split by List 15 223 58 15 223 58 Please note that all of the non string data entries are automatically translated into the appropriate data types unless the type of the field is already specified as a string 10 3 Entering in References The easiest way to enter in a reference is by traversing down the object tree and selecting the node and then double clicking on the target node attribute or sub attribute see Figure 10 1 However the user may always enter in the reference manually without using the object tree The path of the entered reference is always relative References have the following constraints 1 The referred value should match the assigning field s value type Suppose you have an object X with attribute p and object Y with attribute g If the type of attribute X p is number and if the value of Y q is string 5 X p cannot be directly referred to Y g or vice versa An Invalid Value
380. om a data source A data source can be created within the Experiment Builder or by loading a text file The use of data source makes the creation of experiment more efficient and less error prone It also makes the randomization of trial order across participants easier see Chapter 9 Data Source for details 6 Saving the Experiment Session After the experiment is generated don t forget to save the experiment session so that it can be re opened later on 2 2 Building and Test running Experiment After the experiment is created the next step is to see whether there is any error in the experiment graph for example failing to make a connection between items incomplete data source wrong data type used etc The user can compile the experiment by clicking on Experiment gt Build menu to build the experiment Build time errors in red or warnings in orange will be displayed in the Output tab of the Graph Editor Window In most of cases clicking on the error or warning message will select the experiment component at issue and thus enable the user to identify and fix up the problem quickly Please note that the above build process just checks whether there are obvious mistakes in the experiment graph but does not check for the content and validity of the experiment per se Therefore the user should test run the experiment on a couple of participants to see whether the experiment does exactly what was intended by the experiment desig
381. ommand 1 Unexpected end of line 2 Syntax error 1000 No reply from the tracker Message resultMessage String Returns text associated with last command response may have error message see above Figure 7 13 illustrates how to draw a white filled box on the top left quadrant of the tracker screen using the EyeLink Command action In the Command field type in draw_filled_box without quotes and in the Text field enter 0 0 512 384 15 without quotes Please refer to the 1ni files in the Host PC for the syntax of EyeLink commands SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 78 START Command START W PREPARE_SEQUENCE a RECORDING DISPLAY _SCREEN EL_COMMAND Properties gt x L_ COMMAND EL_BUTTON yveLinkCommand Time tart Time Clear Input Queues F ormmand drave filled box Text 10512 384 15 Priority Wait For Result I Stona T Fest Result Message A B Figure 7 15 Using Sending EyeLink Command Action 7 9 6 Sending TTL Signal This action E sends a TTL signal through the parallel port of a Windows display computer Version 1 6 121 or later of this software automatically installs the I O port driver for both 32 bit and 64 bit versions of Windows except for Windows 2000 For the latter operating system you will need to run the PORT9 S5NT exe installer in the SR Research 3rdParty folder Using the SET_TT
382. on and drag the mouse cursor to the desired location for the bottom right corner of the triangle resource and then release the mouse button To adjust the location of the triangle resource select the resource by clicking on it hold down the left mouse button and drag the resource until it is placed at the desired location The exact location of the resource can also be set from the value field of the Location property To adjust the height and width of the triangle select the resource and move the cursor to one of the three vertices until the shape of the mouse cursor changes to one of the resizing cursors e g i Hold down the left mouse button and drag the vertex until it is placed at the desired location The appearance frame color frame line width interior color of the triangle resource can also be adjusted If Filled property is set to true the interior of the triangle will be filled with the filling color otherwise only the frames of the triangle will be drawn while the filling color will be ignored Reference TRIANGLE_RESOURCE Type NR The type of screen resource C TriangleResource the current item belongs to Visible t visible Whether the resource should be visible This is True by default Screen Index of the resource in screen resource list O Position is Gaze positionAtGazeC ina a the position of the resource is Contingent T ontingent contingent on the gaze position This is False
383. ond of the current saccade of visual angle the trigger fires SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 171 For example if the user wants to end a sequence after the participant makes a saccade towards the target region 212 334 312 434 The user may use a saccade trigger set the Region Location as 212 334 Region Width as 100 and Region Height as 100 The user may further configure the minimum saccade amplitude and the triggering eye saccade Test START T PREPARE_SEQUENCE iva RECORDING DISPLAY_SCREEN Experi ment Components Devices ECORDING SACCADE pessage mw ooo em O o boraren oS lear Input Queue Region Direction i 45 45 90 90 135 135 180 Region Location Top Lett 212 334 Region Width Region Height TIMER Minimum Amplitude Triggered Data Figure 7 61 Using the saccade trigger If the saccade trigger should fire regardless where the saccade is directed to the user may set the triggering region as the whole screen 1 e Region Location as 0 0 the Region Width as 1024 and Region Height as 768 for a 1024 x 768 screen resolution Alternatively the user may keep the default region settings and uncheck the Within button The following discusses some of the common applications of the saccade trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 172 7 10 10 1 Top left vs center triggeri
384. onse time BUTTON_PRESS_TIME value DISPLAY_ON_TIME value In case the trial can end without having the subject to press a button you may use the UPDATE_ATTRIBUTE to reset the default values for the variables at the beginning of the trial so that the response data from the previous trial will not be carried over to the following trial Don t forget to add the variables to the EyeLink DV Variable list or to the RESULT_FILE SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 135 RESET OATA oot Attribute alue List for GET_RESPONSE DISPLAY TARGET Attribute TBUTTON PRESSED valued CEDRUS INPUT triggeredData button TBUTTON PRESS TIME valem CEDRUS INPUT triggeredData timed CEDRUS INPUT DDOISPLAY ON TIME value MDTSPLAY TARGET time Fa 7 H TRESPONSE TIME RESPONSE _TIME value RESPONSE _TIME value ink BUTTON_ PRESS TIME value DISPLAY_ON TIME value e Please Set Attribute Please Set value GET_RESPONSE gt Ibe Figure 7 40 Collecting Cedrus button response data To evaluate the accuracy of the button press you will need to know what s the expected button press for the trial This can be encoded in the datasource with a number column Use a CONDITIONAL trigger to check whether the pressed button matches the expected button and then use an UPDATE_ATTRIBUTE action at each branch of the trigger to update the accuracy variable accordingly cherck the HTML version of this documen
385. oolea Whether one of the CTRL keys is pressed n Is ALT Pressed isAltPressed Whether one of the ALT keys is pressed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 139 o ee es O EDF Time EDF Time EDF time of the triggering key press Time time Integer Display computer time in milliseconds from the start of the experiment when the triggering key is pressed It is pretty easy to use a keyboard trigger For example if the user wants to press the ENTER or SPACEBAR of the display computer to end a trial the properties of the keyboard trigger can be set as shown in the following figure Structure H x E H keyboardTest fif START 1 PREPARE_SEQUENCE Eeh SEQUENCE Hj L DISPLAY _END Experiment Components Dewices Properties H x Label EYBOARD TIMER ype Keyboard Mode Path SEQUENCE KEYBO essage KEYBOARD ae SPLA Y _END ast Checked Time Confidence Interval lear Input QUEUE NO eys Enter Space se Keyboard Display Pic ices Events m Release Events Lil Triggered Data Figure 7 43 Using Keyboard Trigger To set the key s used for response click on the value field of the Keys property and select the desired keys By holding down the CTRL key on Windows or the command key on Mac OS X the user can select or de select multiple target keys from the dropdown list The following discusses some of th
386. or mouse position For example if the location field is set to 512 384 and the offset is 100 100 The actual resource position will be 412 284 The color of the box drawn on the host screen to show the position and dimension of the current resource This property is available only if the Use for Host Display option of the containing display screen action is enabled and the Draw to EyeLink Host of the prepare sequence action is set to Primitive Whether the location specified below refers to the top left corner or center of the resource This setting can be changed at Screen Preferences Location location Point The coordinate of the top left corner or center of the resource If the Offset 1s non zero the actual screen position where the resource 1s displayed will be the coordinate set in the location field minus the offset adjustment Float Intended width of the resource in screen pixels Float Intended height of the resource in screen pixels Movement NR Movement pattern sinusoidal or custom of the Pattern resource SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 199 Position 1s Boolea Mouse Contingent T l l Host Outline hostOutlineColo Color Color _positionAtMouse Contingent Screen Location Type n image file name during runtime e g by using a variable or an equation instead of referring to a datasource column or using
387. ording sequence IMPORTANT If this attribute is False the run time drawing may not look exactly as it does in the screen editor Use Software useSoftwareSurf Boolea If false unchecked memory on the video card Surface T ace n is used to hold the resource blitting from the video card memory to the display surface is fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface Color color Color Color in which the outline of the resource is drawn The default color is medium gray 128 128 128 n filled The default setting is True Fill Color fillColor Color Color in which the interior of the resource is filled The default color is medium gray 128 128 128 Specifies the width 1 by default of the pen in pixels 8 1 7 Ellipse Resource Similar to the preceding rectangle resource clicking on the Draw Ellipse Resource tool button creates a filled or framed ellipse bound by a rectangle defined by the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 220 Location Width and Height properties of the resource Follow the same steps as in the previous section to create an ellipse resource and to modify its appearance Reference Label label Label of the resource The default value is Type NR The type of screen resource EllipseResource the current item belongs to n de
388. organization of events in an experiment flow diagram and attribute referencing It also provides an overview of Experiment Builder components triggers actions sequences and other nodes and linking rules for the experiment graph 6 1 Hierarchical Organization of Experiments One of the important concepts in SR Research Experiment Builder is hierarchical organization of events in an experiment A typical experiment can be dissected into several levels along a hierarchy of Experiment gt Blocks gt Trials gt Trial Runtime Recording All of the events within each level of this hierarchy can be conveniently wrapped in a loop called sequence or sub graph in Experiment Builder This allows the whole sequence to be connected to other objects as a unit and be repeated several times in a row The following figure illustrates a common high level EyeLink experiment architecture To create an experiment the designer needs to create several nested sequences add a list of actions and triggers to each sequence and make necessary connections between components to form experiment flow In this example the top most level of the experiment Experiment Sequence contains a greeting message or instruction screen followed by a sub sequence representing blocks of trials Block Sequence and then a goodbye or debriefing message at the end of the experiment Within each repetition of the Block Sequence the user first performs a camera adjustment calibrat
389. ormally assigned base address 0x378 while LPT2 is assigned 0x278 Note this field expects a hexadecimal number so the user should put in 0x378 instead of 378 Parellel Port One Base Input Queue Size Parellel Port Two Base Input Queue Size portOneBaseInputQueueSize portTwoBaseInputQueueSize Sets the maximum number of input events at the base register of the first second parallel port that can be cached in the event queue Parellel Port One Status Input Queue Size Parellel Port Two Status Input Queue Size portOneStatusInputQueueSize port woStatusInputQueueSize Sets the maximum number of input events at the status register of the first second parallel port that can be cached in the event queue Parellel Port One Control Input Queue Size Parellel Port Two Control Input Queue Size portOneControlInputQueueSize portlwoControlInputQueueSize Sets the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 341 maximum number of input events at the control register of the first second parallel port that can be cached in the event queue Parellel Port One Base Event Count Parellel Port Two Base Event Count portOneBaseEventCount port woBaseEventCount Total number of input events at the base register of the first second parallel port cached in the event queue Parellel Port One Status Event Count Parellel Port Two Status Event Count
390. ot all VFW files are recognized and loadable into the library In addition the performance of video files converted by different video codecs varies Users may try the Divx http www divx com divx play download or MCMP M peg codecs http www leadcodecs com Codecs LEAD MCMP MJPEG htm for VFW codecs with good performance If the user deploys the experiment project and runs it on a different deployment computer please make sure that codec used to test run the video experiment is also installed on the deployment computer as well otherwise the deployed experiment will not run Please also note that it is a known issue that the AVI converter may drop the last frame during conversion when using the XVID encoder Therefore the user may add one extra frame to each clip when authorizing video clips The user can then set the Frame List attribute of the video resource to the intended frame number regardless whether the last frame 1s dropped or not SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 210 Right now only the XVID codec is supported in the animation playback view of the EyeLink Data Viewer software Make sure the converted video clips have the xvd file extension 8 1 2 7 Playing Video Clips with Audio For those video clips with sound the Split Avi program splits the video stream from the audio stream in the original video file and saves each stream in a separate file Now the user has two files one for
391. output for some variables The user should first add a RESULT_FILE object see Section 7 11 2 Result File for example into the experiment graph and add columns of the data source file and or newly created variables to the result file Reference Label of the ADD_TO_RESULT_FILE action The default value is ADD TO RESULTS_FILEP Type The type of Experiment Builder objects AddToResultsFile the current node belongs to experiment graph Display computer time in milliseconds from the start of the experiment when the action is done Display computer time in milliseconds from the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Results File NR fs The Result file the current action is referring to SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 86 7 9 11 Preparing Sequence Before starting the portion of the experiment that contains the important
392. ovement and moves down The sinusoidal movement can be two dimensional if both Start Phase X and Start Phase Y are non zero To create a circular or elliptic movement pattern make sure that Start Phase X Start Phase Y 90 for a clockwise movement and Start Phase Y Start Phase X 90 for a counterclockwise movement The circular or elliptic movement will be reduced to a movement along an oblique axis if Start Phase Y Start Phase X All other phase value combinations will result into a complex Lissajou figure 8 2 2 Custom Movement Pattern The Experiment Builder also allows the user to create a linear movement at a constant velocity or a set of such linear smooth movements The underlying mechanism of the custom movement pattern is to process a list of resource positions which specify the destination movement position and the time in millisecond since the start of the current trial when the resource reaches the position A message can also be sent when the target position 1s reached ResourcePoirt F START DRIFT CORRECT me Recording START DISPLAY SCREEN Interest _ Areas Movement_Patterns ELA CUSTOM PATTERN ositian ELLIFSE RESOURCE TIMER Experiment Components Devices rr ime Ecreen Location Type Xoo R Mo SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 228 Figure 8 12 Adding Resource Positions to a Custom Movement Pattern To make the custom movement patterns really use
393. ovie playback exPerence SPOIF input signal monitoring Digital In Unknown or invalid signal Game Mode Select this mode for the most powerful game audio processing solution Audio Creation Mod udio Creation Mode I Enable Bit Matched Playback Select this mode if your primary activities will be recording mixing and Note This disables EQ Fi Crystalizer and SVM Playback volume composing Will increase bo maximum level It is recommended that you quit all audio applications and games before switching modes CREATIVE Help CREATIVE Hep Figure 3 1 ASIO Control Panel Settings When you test run a project using the ASIO driver a Creative ASIO Control Panel dialog box will show up This latency sets the minimum output latency of the ASIO driver delay from buffer switch to first sample output and the interval in milliseconds between ASIO buffer swaps 1 e how often new sounds can be output For better ASIO playing recording performance set the ASIO buffer latency to 10 ms the default is 50 ms Creative ASIO Control Panel ASIO Buffer Latency 10 z Cancel Figure 3 2 ASIO buffer latency settings SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 10 3 1 2 Maximizing the Real time Performance of the Deployment PC To maximize the real time performance of the Deployment PC the user should do the following Shut down all other applications browser wi
394. ow Please note that the Position Triggered check box should be unchecked so that clicking one of the mouse buttons anywhere on the screen fires the mouse trigger If the Position Triggered check box is enabled the user needs to set the width and height of the triggering region to the width and height of the display area respectively while keeping the default top left location of the trigger region to 0 0 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 149 MouseTest F START 1 PREPARE_SEQUENCE i RECORDING START DISPLAY BLANK Experiment Components Devices DISPLAY INITIAL Properties Property Label OUSE YHE AOWSe Nace Path ECORDING MOUSE Message OUSE Time ast Checked Time E uttans Press Events OCO 1 2 3 Release Everts Position Triggered C ontidence Interval Fe a 0 45 45 90 80 135 Region Type Region Location Top Lett ies e Figure 7 49 Using themouse trigger Some paradigms require the mouse trigger to fire at a specific region For example the user can click on a link in a webpage to move onto the next page If this is the case please make sure that the Position Triggered attribute is checked and that a target region is specified see Panel A of the following figure In addition the user may add a small image on the display screen and make its position mouse contingent behaving as if a mouse cursor so that the user knows t
395. owing Color WORD_ EXPECTED _ COMPATIBLE 1 0 255 Blue Bes 2 255 0 Red te NO 3 55 0 0 Red tt es i 4 0 255 Green Jb No S 55 0 0 Bue fr No e toso Blue p No 7 0 0 255 Red BN 8 255 0 Green fg Ves 9 55 0 0 Green fr No 11 0 255 Green Jb No 13 255 0 Green ges 15 0 255 Bue fb es 16 255 0 Red fgg No 17 255 0 Bue fg No 18 0 255 Red fb ND 7 Check the Enable Run time Randomization box so that internal randomization can be performed 8 Click the Randomization Setting button to configure randomization settings In the following dialog box set randomization seed value to Session Label so that the same trial sequence will be presented when the same recording session label is used Check the Enable Trial Randomization box set Run Length Control Column to WORD and Maximum Run Length to 2 please press ENTER key to register the value This ensures that the trial presentation order is completely randomized with a restriction that the same WORD value will not be shown on three trials in a row Press the OK button to finish SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 304 Randomization Setting E x Seed Valle Eeee gees Blocking Level 1 Column Randomization Type ione T Blocking Level 2 Colurrir r Randomization Type ione F M Enable Trial Randomization Run Length Control
396. p PIDTSPLAY SCREEN RECTANGLE RESOURCE width egion Height TOISPLAY SCREEN RECTANGLE RESOURCE height Mvidth 200 Movement Pattern on Prebuild To Image r Use Software Surface SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 173 Properties Al x Property fe E _ Property Label BACCADE Label RECTANGLE _RES vpe Eaccade Type PETEERE E Mode Path LOCK TRIAL RECORDING SACCADE isible a essage SACCADE Pcreen Index Position is Gaze Contingent C Position is Mouse Conting Offset O 0 lear Input Queue ny Region Direction 0 45 45 90 90 1387135 180 180 ast Outline Color hite a seal ba a eae Region Type Region Location Top Left Le ees Bcreen Location Type Region width TOTSPLAY SCREEN RECTSANGLE RESOURCE width i Region Height DISPLAY _ SCREEN RECTANGLE RESOURCE height Awithin E Tracking Eye EITHER Movement Pattern Minimum Amplitude 0 Prebuild To Image riggered Data Use Software Surface Figure 7 62 Using saccade trigger with top left and center location types 7 10 10 2 Online RT calculation See Frequently Asked Questions How can I calculate Saccade RT of the HTML version of this document 7 10 10 3 How to show the triggering region on the host PC Sometimes it is useful to draw feedback graphics on the Host PC so that the experimenter can monitor whether the subject s eye position is within the t
397. parency color value of the Display Device to something similar but not identical to the background used in the display screen In the current example the user may set the RGB value of the transparency color to 251 250 251 3 Click on Preferences gt Screen to enable the Antialising Drawing setting To complete preference settings press the close button on the dialog box SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 298 4 Select the topmost experiment node Stroop In the property table enable the Save Messages box so that a message can be written to the messages txt file at the results Session Name folder when an action is performed or a trigger fires Chinese Japanese and Korean Users Please make sure that the Encode Files as UTF8 setting in Preferences gt Build Deploy settingis always enabled otherwise you may see the following error ERROR error 2070 Internal Error Could not create script Please contact SR Research Sorry MemoryError This may have caused by an invalid encoding Try using UTF8 encoding 15 3 Creating Experiment Block Sequence In this example we are going to run two blocks of nine trials The first step is to add a block sequence for repeating blocks see Figure 15 3 In addition we add a result file to contain data outputs earth Experinvent Bidder L402 20 AC Streep Fis Edt View Experiment Help ies Sx 6 amp B eh Oe li h rb
398. pes supported in current implementation of conditional triggers are string integer double and Boolean When comparing strings please make sure that the strings are case sensitive without quotes see the Saccade template for the implementation of conditional evaluations with strings In case of evaluating a Boolean comparison for example checking whether the Force Full Redraw field of a DISPLAY SCREEN action is checked or not the user needs to set the Attribute field of the conditional trigger by referring to the target attribute e g DISPLAY_A forceFullRedraw choose either EQUALS or NOT EQUALS as the comparator and type in true or false lower case without quotes in the value field of the conditional trigger Sometimes the user may attempt to evaluate attributes against missing values For example the user may want to check whether a trigger has fired or whether a valid data has been retrieved from one attribute e g the start time of an action If the target attribute is a string type set the value field of the conditional trigger to MISSING _ DATA If the target attribute is an integer or a float data set the comparison value to 32768 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 125 e To clear a non string value eg 3 set in the value or value2 attributes of a conditional trigger you may first set the value to some string e g
399. playback The video display engine was specifically designed to allow access to the msec time that each frame of the video is displayed the start of the first retrace that contained the frame data on the display The video display engine also functions in Windows real time mode These features provide a timing advantage to researchers using video stimuli because the common timing pitfalls of display packages that use Windows DirectShow for video presentation have been bypassed For optimal video playing performance the recommended display computer configuration is a Pentium 4 processor with 2 0 Ghz or faster CPU 512 MB or more RAM 8x AGP or PCIx video card and Windows XP 32 bit version Service Pack 2 installed On Windows Experiment Builder supports video files that are compatible with the VFW video for windows specification or have been X VID encoded our internal tests have shown that X VID encoded files perform much better than VFW files Only the xvd video files are presently supported on Mac OS X SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 202 e AYI Splitter IN Ioj x File View Help F Refresh SS ti lt Xt Output Folder C Documents and Settings Precision T is Output Prop ideo Codec xvid MPEG 4 Codec a Video Filename Pie E Default Selection a M Save only raw data Audio Filename IY Save audio output stream Options F Save only raw
400. portOneStatusEventCount portTwoStatusEventCount Total number of input events at the status register of the first second parallel port cached in the event queue Parellel Port One Control Event Count Parellel Port Two Control Event Count portOneControlEventCount portTwoControlEventCount Total number of input events at the control register of the first second parallel port cached in the event queue Parellel Port One Current Value Parellel Port Two Current Value portOneCurrentValue portTwoCurrentValue Current value of the first second parallel port in the format of data register value status register value control register value 17 1 9 USB 1208HS Box cor Preferences El af Preferences Property oO Value EF Experiment 7 on Ae Devices EE aa EE EYELINK E DISPLAY AUDIO PB MOUSE iq KEYBOARD SE CEDRUS ee ece BLITTONBOX Ty PARALLEL PORT fi TREES Eee Nodes re Screen Build Deploy E e GUI i GRAPH_LAYOUT i CUSTOMCLASS EDITOR Digital Input Queue Size 50 r m L a ae Restore Factory Default Save Properties as Default Import From File SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 342 Pins pins This sets the digital pins used for sending or receiving signals through the USB 1208HS box Click on the Value field will bring up a USB 120
401. press events can be accessed over time The current option checks whether the keyboard event s cached in the event queue should be cleared when the trigger fires NO no event clearing Event removes the current triggering event from the keyboard event queue LIST all key press events from event queue will be removed Keys keys Listof Keys allowed for the trigger firing Use the drop Strings down list to select target keys In the attribute SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 138 Confidence confidencelInterv Interval al editor the user should specify a list of keycode the internal numeric identifier for a key on a keyboard Use Keyboard useKeyboard String Specifies the keyboard Display PC Tracker PC or Either used for response If Enable Multiple Input option is enabled the keyboard option would be Any Tracker PC KEYBOARD_1 KEYBOARD_ 2 Triggered Data triggeredData If the keyboard trigger fires the triggered data can be further accessed see the following table The supported named keys in attribute editor are Any Backspace Tab Clear Enter Pause Escape Space Exclaim Quotedbl Hash Dollar Ampersand Quote Leftparen Rightparen Asterisk Plus Comma Minus Period Slash 0 1 2 3 4 5 6 7 8 9 Colon Semicolon Less Equals Greater Question At Leftbracket Backslash Rightbracket Caret Underscore Backquote a b c d
402. property of the ADD_RESULT action is set to RESULT_FILE FesulFile ResultFile F START RESULTS FILE 1 VARIABLE_KEY DISPLAY _SCREEN E ADD_TO_RESULTS_FILE fy KEYBOARD 1 ARIABLE_TIME fy KEYBOARD 1 ARIABLE_TIME Experiment Components Dewices Experiment Components Dewices RESULTS FILE Labe ADD TO RESULTS FLE ARABLE KEY VARIAB fme rst Action Time OOS RESULTS FILE A B Figure 7 72 Setting Properties of the Result File Node When the experiment is executed a result file is generated in the experiment directory with one column for each of the output variables The result file is tab delimited and can be easily imported by most statistical software VARIABLE_TIME VARIABLE_BUTTON 686 0 booo 603 0 a 530 0 532 0 7 11 3 Accumulator The accumulator is used to keep numeric values and do statistical analysis on the accumulated data Field Attribute Content Reference tos of the accumulator Maximum Size Hanmi Integer Maximum number of data points can be added into the accumulator If the number added exceeds the limit the initial few data points will be overwritten Size size SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 191 Minimum value on all added values Mean value across all added values Median value across all added values Standard Stddev Number Standard Deviation for all added values Deviation Standard Error Standar
403. put Queue Size E Devices Key Up Input Queue Size aia I EVELINE E DISPLAY nable Key Repeat CEDRUS Lega BUTTONBOX HES Modes HH Screen be Build Deploy Ee GUI Restore Factory Default Save Properties as Default Import From File Save Into File SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 336 Number of Keyboard numberOfKeyboards This sets how many distinct keyboards used in the experiment This option is only available if Enable Multiple Input option is enabled Keyboard One Label keyboardOneLabel This supplies a label for the first keyboard device detected by the experiment This option is only available if Enable Multiple Input option is enabled Key Down Input Queue Size keyDownInputQueueSize Sets the maximum number of press events that can be cached in the press event queue for the keyboard device or the first keyboard device if multiple inputs are supported Key Up Input Queue Size keyUpInputQueueSize Sets the maximum number of release events that can be cached in the release event queue for the keyboard device or the first keyboard device if multiple inputs are supported Key Down Event Count keyDownEventCount Total number of press events cached in the press event queue for the keyboard device or the first keyboard device if multiple inputs are supported Key Up Event Count keyUpEventCount Total number of rele
404. r audio file has not been preloaded when it is used in the Display Screen or Play Sound action that references it a warning message will be written to the warnings log file for the experiment session Reference Label of the PREPARE_SEQUENCE action The default value is PREPARE SEQUENCE Type NR The type of Experiment Builder objects PrepareSequence the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of aaa the Experiment node checked when the PREPARE SEQUENCE action 1s done Display computer time in milliseconds from the start of the experiment when the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 87 ee ee eee PREPARE_SEQUENCE action is processed Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any even
405. r data collection the user should first deploy the experiment to a different directory and run the experiment without relying on the Experiment Builder GUI and for better timing performance Simply double click on the executable file Stroop exe in the deployed directory and then follow the instructions on the screen The experiment result file should be saved in the results session name subdirectory of the experiment directory SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 320 16 Experiment Builder Project Check List version 1 10 1 The following checklist was created to summarize some common problems in creating and running an Experiment Builder project See the html version of this document for a list of frequently asked questions If this is an EyeLink experiment 1 2 3 4 5 6 7 8 9 Is there a recording sequence in the project FAQ How to convert a non EyeLink experiment to an EyeLink experiment Does the project use the hierarchical organization concept of experiment design Is the data source attached to the trial sequence instead of the recording sequence If the datasource is attached the recording sequence you will not be able to do image drawing to the Host PC perform a pre recording drift correction as well as reset triggers actions and resources Have the experiment trial variables been added to the EyeLink DV Variables of the Experiment node
406. r drift correction To Draw Drift drawDefaultTarg By default the box is checked the drift Correction et correction procedure clears screen draws the Target T fixation target and clears screen when done However sometimes it is better for the user to SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 64 do this the user can pre draw the drift correction target using a DISPLAY_SCREEN action and check off this field Clear Target At clearTargetAtExi Boolea If checked the screen will be cleared to the Exit T t n background color after the drift correction finishes otherwise the drift correction target remains on the screen This option is valid only if the Draw Drift Correction Target option is enabled and has no effect if the drift correction drawing is supplied by the user foregroundColor Color in which the drift correction target drawn Color Background backgroundColo Color The color to which the entire display is Color r cleared before calibration This is also the background for the camera images The background color should match the average brightness of your experimental display as closely as possible as this will prevent rapid changes in the subject s pupil size at the start of the trial This will provide the best eye tracking accuracy as well Using white or gray backgrounds rather than black helps reduce pupil size and increase eye tracking range and may reduce retinal
407. r line spacing in multiline text resource e Bug fix for displaying non ASCII Chinese Hebrew Thai etc characters in English versions of Windows e Splitavi converter now supports multiple input files e Added Clear Target At Exit option for drift correction action e Touch screens are now supported as a variant of the mouse trigger in 32 bit Windows 2000 XP Vista and Windows 7 Version 1 5 201 e For MEG MRI applications adds supports for camera setup calibration validation drift correction through an external control device e g a Cedrus Lumina fMRI Response Pad These can be done through the Camera Setup action and Drift Correction action e Several improvements have been introduced to the calibration procedure thorough the Camera Setup action o For horizontal only H3 calibration type now the user can specify the intended vertical position using the Horizontal Target Y Position option o Now support using a customized calibration background image o Users can now specify customized calibration validation point list o Some calibration related EyeLink device settings are now moved to the Camera Setup screen o Bug fix for using non English keyboards while in the calibration mode e Bug fix for the duration calculation of the fixation trigger and saccade trigger e The packed project now includes files contained in the myfiles folder of the project Version 1 5 58 e Bug fix for the default directory of t
408. r or elliptic interest area Please note that the precise location of an interest area can be edited with the Location Width and Height attributes in property table Reference Type NR The type of Experiment Builder object RectangleInterestArea the current item belongs to Label label String Label of the Rectangle or Ellipse interest area The default label is REACTANGE_INTERESTAREA or Ordinal ID of the interest area Name Viewer screen editor Screen Location NR Whether the locations specified refer to the top Type left corner or center of the interest area This global setting can be changed Screen SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 233 po Preferences Screen Location NR Whether the locations specified refer to the top Type left corner or center of the interest area This global setting can be changed at Screen Preferences Location location Point The top left or center of the interest area depending on the preference setting of screen location type The width of the interest area in pixels The height of the interest area in pixels 8 3 1 2 Freeform Interest Area The shape of a freeform interest area can be adjusted by moving the vertices individually To adjust the position of a vertex select the interest area place the mouse cursor on top of the intended vertex until the shape of the cursor changes to one of the resizing cursor
409. r time in milliseconds from the start of the experiment when the mouse trigger returns Note To check the time when the mouse button is pressed released or the mouse position falls within the triggering region you should use triggeredData time 1 e the time sub attribute of the triggeredData attribute instead This property can be used to retrieve the Time Display computer time in milliseconds from SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 146 a ee ne checked for the last time Confidence confidenceInterv Float Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger time time Clear Input clearInputQueue Boolea Mouse trigger maintains event queues so that Queue n multiple mouse press release events can be accessed over time The current option checks whether the mouse event s cached in the event queue should be cleared when the trigger fires NO no event clearing Event removes the current triggering event from the mouse press release event queue LIST all mouse events from event queue will be removed List of Integers 1 2 3 by default indicating the buttons may be pressed for trigger firing List of Integer S Use Mouse useMouse String Specifies the Mouse Any MOUSE_1 M
410. r to overwrite the old data lines see Figure 9 6 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 247 Confirm whether append or overwrite x an The variables are the same as the existing one would yau like to append rows or overwrite Overwrite Cancel Figure 9 6 Append or Overwrite Confirmation By default all of the data columns are imported as string To change data type for a column click on that column heading and then click the right mouse button to bring up a popup menu Select Update Column menu option and choose the desired data type 9 4 Using Data Source File The Prompt for Dataset file box of the sequence to which the data source is attached 1s unchecked by default When running the experiment from either the testrun mode or the deployed version a file chooser dialog box will be displayed prompting for a datasource file for the session Click on the datasets folder and choose the default dat file prepared by the program If the Prompt for Dataset file option is unchecked the file chooser will not be displayed during experiment runtime and the default datasource file will be chosen Choose a Dataset file for TRIAL i 2 x Look in gt Simple a e 6 e e m Size 126 bytes Files TRIAL DataSource Simple _BLOCKTRIAL dat My Recent Documents Desktop My Documents a My Computer i File name veers Files of type Experiment Builder
411. ration of a display screen In a gaze control experiment a trigger for display change can be elicited when the eye is entering or leaving a pre specified invisible boundary SR Research Experiment Builder supports the following set of Triggers Fires when a pre specified amount of time elapses Timers can be used to add a delay between actions and or triggers and to control the maximum amount of time a sequence can last SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 40 or Keyboard Fires when a pre specified keyboard key is pressed _ when a specified mouse button is pressed or when the position falls within a specified region of the screen Checks TTL input to the input ports e g parallel port or USB 1208HS box of the display computer TTL Trigger fires when a pre specified TTL signal is received Boundary Fires when one or multiple samples stay inside or outside of a pre specified invisible boundary Boundary trigger s can be used to implement display changes based on the locus of gaze Fixation Fires when a fixation occurs at a specific region of the display for a certain amount of time Saccade Fires following the detection of a saccade to a specific region of the display Sample Velocity Implements a fast saccade detection algorithm by checking the velocity and acceleration information on a sample by sample basis Sample Velocity Trigger fires when the sample
412. re 14 18 Error in Tracker Version SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 296 15 Creating Non EyeLink Experiments Stroop Effect The current chapter illustrates the use of SR Research Experiment Builder in creating a non eye tracking experiment This sample experiment demonstrates the Stroop Effect with keyboard response the subject is asked to respond to the colors of the words as fast and as accurately as possible For example for the word BLUE the subject should respond as RED instead of BLUE 15 1 Creating a New Experiment Session Click on the Experiment Builder to start a new session When the application starts aay aperire Bradhh T TETY FA a E fes ii yazma m em ee th Fie Edt wew Experiment Help Open Cleo 3 Pannen gt Click File gt New to start Enter the session name Preci Looatian CEB Proeole P Palink Eoqerimeni i E l ance veil 3 Click hare to save the project to the intended location 4 Uncheck this box fora non EyeLink experiment Figure 15 1 Creating a New Experiment Builder Session 1 Click on File New on the application menu bar 2 In the following New Project dialog box enter Stroop in the Project Name edit box 3 Click on the button on the right end of the Project Location to browse to the directory where the experiment project should be saved If you are manually entering the
413. reen 1 e Region Location as 0 0 Region Width as 1024 and Region Height as 768 for a 1024 x 768 screen resolution Alternatively the user may keep the default region settings and uncheck the Within button Since the fixation trigger keeps monitoring the online eye data it must be placed within a recording sequence 1 e the Record property of the sequence is checked If you see a This node type cannot be added to this sequence error message please check whether the sequence to which the trigger belongs is a recording sequence The following discusses some of the common applications of the fixation trigger 7 10 9 1 Optimal triggering duration If the UPDATEFIXATION event is used the fixation trigger doesn t work well if the duration is set to 0 or a very short value as mis triggering can occur during the start and SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 166 end of a fixation A duration around 250 350 ms will generally work much better with non patient group If the required duration is longer than 1000 ms try using the INIVISIBLE_BOUDARY trigger instead with identical triggering region and duration settings 7 10 9 2 Top left vs center triggering location type Please note that the location type of all trigger types invisible boundary trigger mouse trigger fixation trigger saccade trigger and sample velocity trigger is top left based whereas the screen resources can be either top left b
414. reen is contained in a recording sequence Important If this attribute is False the run time drawing may not look exactly as it does in the screen editor In addition images will not be saved to support Data Viewer overlay Use Software useSoftwareSurf Boolea If false unchecked memory on the video card Surface ace n is used to hold the resource blitting from the video card memory to the display surface is fast If true checked the system memory is used to hold the resource blitting is slow as it is done by copying from RAM to display surface Contingent ontingent n contingent on the gaze position False by default This setting can only be modified when the display screen is contained in a recording sequence 8 4 7 Others The screen builder also allows the users to adjust the canvas size of the workspace If Fit to Screen option is enabled see Figure 8 25 the workspace area is scaled to size of the screen to be displayed otherwise the workspace area is set to actual size 1 e one pixel of workspace area corresponds to one pixel of computer desktop Fit to Screen Po Figure 8 25 Choosing Fit to Screen Option SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 242 Finally the user can save the graphics of the workspace with the Saving Screen as image option see Figure 8 26 ee Cut Copy Paste m Delete Hk Snap To Grid A Lock selection E Unlock selection S
415. rency cccccseeeeseccceccceeeseeeeeecceeeeeaaeeeeees 213 S4 M l line Text Resource asiana E 215 Bele EME RESOU aen R uaaetae 218 Sko Recimo e ROU Ooa A ES 219 Blk EIDER O e a a S 220 Sdo Trans le RESC een ea E 222 S9 Freel onmi ReSourCe n En E A eteeases 224 S2 Move mene Pale an a a teal 225 S221 Sinusoidal Movement Pattern scien soviesiaeadtetsaiidesaledoeins Case eianas lee ibasriteraies 226 2 2 Custom Movement Paterissa a A S 228 8 3 Mite St ATCAS ensen a a E E E 232 8 3 1 Manually Creating an Interest Area erona 233 8 3 1 1 Rectangular Elliptic Interest Area cc cccccccccenseeeeeeeceeeeeeeneeeeees 233 SLA Erecrorm Merest Ame ieai travis te wasindhdravacsiawlvetiewceisias 234 8 3 2 Automate SCS me matossa testes EE E 234 Saa Usma Merest Arer Fese E A AT 236 SA RESOU e OPE ONS aoee a T E a 237 SAT RESOURCE EN Teao a a eu camsalotaunsrtaaeel 231 SA2 Resource A OMIM S eie a aaa a eiaa 237 Sdo Resource LOCKING eres e E ee 238 S44 Resource Gro pine sec dcctaneeaianseneiadalesdidet a E 239 849 Resource CTC as stip an scoa dep sesindenandeetaenniedsian dena duvnesinauienstataveiiesgiandemalevanddies 240 6 40 Compose RESOU G nana iter nethaniave eae iedaeert een eae 241 i O ac eae etanercept emt Oe ere ater E O ere 242 1D EEL CIES 6 WI i ounce amare ace eae nn a A E oe Pe ee 244 9 1 Creatine Data SOUICE wccccietcut Sout ii Sau A 245 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 1v I eG ata SOU
416. rget will move in a full cycle from Xcenter Xamplitude Ycenter Yamplitude to Xcenter Xamplitude Ycenter Yamplitude and the movement will be centered at Xcenter Ycenter Reference _ i Label of the sinusoidal movement pattern SINE_PATTERN by default s e The type of Experiment Builder object SinePattern the current item belongs to Screen Whether the locations specified refer to the top _ Type ee left corner or center of the resource This setting can be changed at Screen Preferences Start Time startTime Float Start Time of the movement Typically set to 0 so that the movement pattern 1s aligned to the display screen action The amplitude of horizontal movement in pixels 341 0 by default SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 226 Amplitude Y amplitude_y Float The amplitude of vertical movement in pixels 256 0 by default Center X plot_x Float The horizontal center of the movement in pixels Typically this is the center of the screen The vertical center of the movement in pixels Frequency X frequency_x Float The speed of horizontal movement in number of cycles per second Hz Frequency Y frequency_y The speed of vertical movement Start Phase X start_phase_x The start phase position of horizontal movement This number should be between 0 and 360 Start Phase Y The start phase position of vertical movement Note Amplitude X should
417. rigger The Cedrus input trigger E fires when one of the pre specified buttons on a Cedrus RB Series response pad http www cedrus com responsepads rb_series htm or a Lumina MRI Response Pad http www cedrus com lumina is pressed or released To use the Cedrus RB Series response pad please follow the installation instruction provided by Cedrus http www cedrus com support rb_series to install the USB driver to the Display computer please note that for the 64 bit Windows 7 or Vista please use the driver from http www cedrus com support rb_series rbx30_win64_drivers_01282008 exe the 64 bit edition of Windows XP is not supported according to the manufacturer of the button box In addition the user should also check the setting of the DIP switches which are located on the back of the response pad to the left of where the USB cable plugs into the pad Experiment Builder requires all the switches be in the down On position The Lumina Response Pads for MRI doesn t require a driver installation The Cedrus input trigger can also be used to detect Cedrus SV 1 Voice Key responses The onset of a Voice Key trigger is represented as a button 1 down event the offset of the voice key event is represented as a button up event Please follow https www sr support com forums showthread php t 56 for setup and example Please note that only ONE Cedrus device can be connected to the experiment computer at a time A warning 2003 The IO node
418. riggering region or the programmer can debug the experimemnt code by running the eye tracker in the mouse simulation mode This can be done by using an EyeLink_Command action before the recording sequence immediately after the PREPARE SEQUENCE or as the first node in the recording sequence so that the drawing is overlaid on top of the existing host graphics The drawing command can be either a draw_box or draw_filled_box The Text of the command should inform the tracker of the top left right and bottom pixel position of the triggering region as well as the drawing color This can be done either with string concatenation or string formatting The topleft corner of the triggering region is SACCADE regionLocation x SACCADE regionLocation y and the bottom right corner of the triggering region is SACCADE regionLocation x SACCADE regionWidth SACCADE regionLocation y SACCADE regionHeight String Concatenation str SACCADE regionLocation x str SACCADE regionLocation y str SACCADE regionLocation x SACCADE regionWidth SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 174 str SACCADE regionLocation y SACCADE regionHeight 3 String Formatting d d d Pd 3 SACCADE regionLocation x SACCADE regionLocation y SACCADE regionLocation x SACCADE regionWidth SACCADE regionLocation y SACCADE regionHeight All of the drawing commands
419. riment The experiment ends when all iterations of sequences have been executed The user can choose to terminate an experiment earlier by using the TERMINATE_EXPERIMENT action Field Attribute T Content Reference Label label lal Label of the TERMINATE_EXPERIMENT action The default value is TERMINATE EXPERIMENT SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 104 Type NR The type of Experiment Builder objects TerminateExperiment the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the TERMINATE_EXPERIMENT action is done Time time Float Display computer time in milliseconds from the start of the experiment when the TERMINATE EXPERIMENT action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues F S n when the action is started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cl
420. ring up an attribute editor dialog In the left Node Selection treeview click on the TRIAL_ INDEX node SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 307 under the TRIAL sequence Step A4 In the middle Node Attributes panel double click on the Value node Step A5 This will update the contents of the top Attribute editor dialog as TRIAL_INDEX value Click on the OK button to finish Step A6 This will fill in the first cell of the attribute value list dialog i GR Research Experinenl fudkber v LILE AC Siren e n z ala x Fie Edt Mew Eperme Help Se866 iae a el a pad ial Q 8BB dneoloiolal 4elsIh AMAL INDEF KEY FREES RE BF OWE AT START ia i TRL _INDEN UPDATE ATT F k Al Select Update i nil attribute action X Y i RI PREPARE SEQUENCE FREFARE_SE AS Select the Value attribute Ad Select Trial Indes n variable from the treeview boeiaan ET PDA TE_ATTRIBUTE Hrva DO 1 PREPARE_SEQUENCE A3 Click here to bring manne up the attribute editor A2 Click here to create i an attribute value list enen AG Click here to finish Figure 15 11 Updating Trial Index c Now click on the right end of the first cell under the Value column See B1 of the figure below In the left Node Selection treeview of the following attribute editor dialog click on the TRIAL sequence see B2 In the
421. rities were trying to decide where to bury the survivors you may group bury the survivors into one interest area instead of creating three separate interest areas To do that you may set the original sentence as The authorities were trying to decide where to bury the survivors replace space with a In the Word Segmentation preference settings see the figure below check the Enable Interest Area Delimiter option Set the Delimiter Character as Check the Enable Interest Area Delimiter Replacement option and set the Delimiter Replacement Character as a single space SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 235 ya Cut Copy E Paste m Delete k Snap To Grid Lock selection Unlock selection Grouping Order Vertical Alignment Horizontal Alignment d d d d d HH Grid Segment Save Screen 45 Image ig Auto Segment A word Segment Figure 8 17 Creating Interest Area with Grid Segmentation 8 3 3 Using Interest Area File For some experiments it is difficult to define interest areas within Experiment Builder For example if the experiment presents different images across trials it is hard to manually create built in interest areas or to create runtime interest areas automatically If this is the case you may consider the interest area file option In this approach you will need to create one interest area file for each of the images to be displayed Add th
422. river can be found at C Program Files SR Research Eyelink bin directory of the display computer if Windows Display Software Package is installed All of the above mentioned software can be downloaded from the EyeLink Support Site at http www sr Support com 3 2 Software Installation and Licensing on Windows The latest version of Experiment Builder installer can be downloaded from https www sr support com forums showthread php t 9 If you have a previous version of Experiment Builder installed on the computer please uninstall it with the Experiment Builder installer or with Windows Control Panel tool Add or Remove Programs before installing the new version By default the Experiment Builder software will be installed at Windows Drive Program Files SR Research Experiment Builder Click on ExperimentBuilderW exe to run the software 3 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 Experiment Builder software Double click on the sreb_1 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 Plug the dongle to the Display PC You may install the driver by clicking Start gt All Programs gt SR Research gt Install HASP Driver from your computer desktop or double c
423. roperty6 c def getProperty6 self return self property6 2004 2011 SR Research Ltd 267 Line 071 Line 072 Line 073 Line 074 Line 075 Line 076 Line 077 Line 078 Line 079 Line 080 Line 081 Line 082 Line 083 Line 084 Line 085 Line 086 Line 087 Property property A read and write list type property def setProperty7 self c self property 7 c def getProperty7 self return self property7 Property property8 A read and write string type property def setProperty8 self c self property8 c def getProperty8 self Line 088 return self property8 Line 089 Line 090 12 3 2 Class Definition A Python class starts with the reserved word class followed by the class name Each word in a class name is usually capitalized but this is only a convention not a requirement Python functions have no explicit begin or end and no curly braces to mark where the function code starts and stops The only delimiter is a colon and the indentation of the code itself Everything in a class is indented class ClassName BaseClasses statement s The class name of the above example is CustomClassTemplate Line 003 In Python the ancestor of a class is simply listed in parentheses immediately after the class name All custom classes in Experiment Builder must inherit sreb EBObject class Line 003 and import sreb module Line 001 If a class starts with _ then it is considered internal and
424. rs a A a 265 122 Creatine a New Custom Class Senan a teats et Ga a 265 W223 syntax Or Cus Omi CASS e a a ena eeeanamtes 266 e I cio oe Ree mer E tT intr T cern 266 Lo Class Derm ttOMm see cdee caste aaa ceca E S 268 1239 Cass IMUNA o cin acai E ausanre nee 268 aA CS AIDU e cess ste eeic E T saad asand ieee eta eee ee 269 22 ClaSSuViCIhOGS srisncetetiet n r E 270 1233 6 setX and getX Methods rensar hanen a a 271 24 Jnstantiatins Custom Classes e a ai 212 VS U mecu tonm Oe Isis ener ene er nee E Roy reer ner a et EE 273 126 Usm C stom Class EOL zasune decease tune ete un sateen decoudere dase stisens 219 l3 Creatine Experiments Oy Cr ya W cecacicrice ecu ingen teedldsiuke ZY 14 Creating EyeLink Experiments The First Example ccccccccccccceeeeeeeeeeeeeees 278 IAI Creatine he Experiment aineen e a E Ea 278 14 1 1 Creating a New Experiment SessiOnsicwerneicctirass tintin 278 14 1 2 Configuring Experiment Preference Settings ccccceccccceceeeeeeneeeeees 219 14 1 3 Creating Experiment Block Sequence noensssesssseoeerssssssseeresssssseseerees 281 ioe Edi ne Block SCQUCII CS capi cte trad seca ed eteeed 282 ELS Creatine InstriChOn Scree aee ieee eee iets 284 14 1 6 Edie Tirial Sequence Data SOUC ccennresnenenren eaten 286 14 1 7 Editing Trial Sequence Preparing Sequence and Drift Correction 287 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd v
425. rty has been removed and replaced with the Minimum Duration property Triggered Data triggeredData If the boundary trigger fires the triggered data can be further accessed see the following table If the Invisible Boundary Trigger fires the user can further check the triggered data The sub attributes of the TriggeredData attribute are listed in the following table They can be used for attribute references Display computer time in milliseconds from SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 118 the start of the experiment when the triggering sample occurs EDFTime Integer EDF time of the triggering sample EDF Time Eyes Available Eyes available in recording 0 for left eye for right eye 2 for both eyes Start Time startTime Float Display computer time in milliseconds from the start of the experiment when the first sample appears in the region EDF Start Time EDFStartTime Integer EDF time time since the EyeLink program started on the Host PC when the first sample occurs in the region Triggered Eye Eye 0 for left eye for right eye whose data makes the current invisible boundary trigger fire PPD X PPD Y Angular resolution at the current gaze position in screen pixels per visual degree along the x or y axis Left Gaze X leftGazeX right Float Gaze position of the triggering sample along the Right Gaze X GazeX average x axis for the left eye rig
426. s Note The property table will also list all of the methods and attributes defined in the custom class in alphabetical order SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 195 8 Screen Builder The Screen Builder provides a convenient tool for creating visual displays After adding a Display Screen action in the workspace the user can start the Screen Builder by double clicking it Screen Builder is a what you see is what you get WYSIWYG type of application which allows the user to see how the display will actually look like during the runtime of the experiment It behaves like a drawing board onto which various types of the graphic resources images text or simple line drawings can be added see Figure 8 1 Once added the exact properties of the resources can be further edited from the property panel For example for text presentation the user can specify the position font name size or style color and alignment style of the text For a dynamic display with moving object on the screen the user can further specify the movement pattern of the graphic resources Finally auxiliary utilities e g interest area drawing grid are provided for the ease of editing and data analysis lt EyeLink Experiment Builder v 1 1 0 105 Beta Track a l x Fie Edit view Experiment Help l DABBBel gt axRawl varael QQAQBE Experiment BLOCK TRIAL RECORDING DISPLAY_SCREEN APIARA
427. s Disable warning to default If unchecked this will raise a warning whenever a default value is used and if particular property calls for warning If checked such warnings are not brought up For example in the Timer trigger the duration calls for a warning whenever a default value is used The raised warning can be disabled by having this box checked Disable Equation Check A warning message will be given if the value and attribute of an equation are of different data type Checking this option will hide the type mismatch warning External Libraries Put directory paths here if you will need to use other Python packages in custom code Test Run Command Line Arguments If the deployed experiment runs from the command prompt additional parameters can be passed to the program The parameter can be retrieved as cmdargs of the topmost experiment node Use this preference to set parameters for test run purpose Include Packed Project in Deploy Directory If checked a copy of the packed experiment project will be included in the source folder of the deployed directory otherwise only the graph ebd and preferences properties files will be included for reconstructing the original project if necessary Verbose If checked a detailed printout will be shown in the EB output tab when deploying a project 17 4 GUI eos Preferences E 3 x E af Preferences Property e O E Experiment Property Is Code
428. s UpdateAttribute the current node Type NR belongs to Node Path absPath String The absolute path of the node in the experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the action is executed Float Display computer time in milliseconds from the start of the experiment when the UPDATE_ATTRIBUTE action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the action started Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues F S when the action is started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action 1s performed meaning that any events already in the queues will be evaluated by Triggers following the action Used to set up an attribute value list the number of currently established attribute value pairs is displayed in the value field of the property To add more attribute value pairs click on the value field The Attribute column of the dialog box specifies the variable or attribute to which
429. s e g a Hold down the left mouse button and drag the mouse until it is placed at a desired location The properties of a freeform interest area are listed in the following table Reference Label of the Freeform interest area The default label is FREEFORM_INTERESTAREA Type NR The type of Experiment Builder object FreehandInterestArea the current item belongs to Ordinal ID of the interest area Data Viewer DV Name String Text associated with the interest area in Data Name Viewer screen editor Screen Location NR Whether the locations specified refer to the top Type left corner or center of the interest area This global setting can be changed at Screen Preferences Location location Point The top left or center of the interest area depending on the preference setting of screen location type List of points 2 tuple of x y coordinates for Points the vertices of the interest area 8 3 2 Automatic Segmentation Interest areas can be automatically created for some screen resources Click the right mouse button in the workspace to bring up a popup menu Select Create Interest Area Set gt Grid Segment This will create a set of rectangular interest areas partitioning the SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 234 whole workspace into grids The number of columns and rows created is set in Rows and Columns of the GRID_SEGMENT preference settings from
430. s a mouse click and will select the item instead move the cursor to the Target component and then release the left mouse button To cancel a connecting Operation in progress press the ESC key To remove a connection between two experiment components click on the connecting line until it is highlighted in yellow and then select the Delete button on the application toolbar or press the Delete key on a Windows keyboard or Command and Delete keys together if using a Mac OS X version of the software SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 46 7 2 2 Connection Order START DISPLAY _ SCREEN EL_BUTTON Figure 7 1 Connectin Order When several triggers are connected to a common node a small number is drawn by each edge in the graph This number represents the order that triggers will be evaluated from a source node that has multiple trigger targets In the above example Panel A the keyboard trigger will be evaluated first then followed by the EyeLink button trigger and then by the timer trigger To change the connection order the user can first delete the connection edges between the source and target nodes and then reconnect the nodes For example if the user deletes the connection between DISPLAY_SCREEN and KEYBOARD and then re connects between them the connection order of the triggers will be changed see Panel B 7 3 Experiment Node Exporting and Importing The Experiment Builder
431. s creates an empty list Unknown Type self unknowType None 12 3 5 Class Methods Methods in a class are defined by a def statement The def statement is a single clause statement with the following syntax def function name self parameter list statement s All of the code within the function is indented Unlike other python functions a method defined in a class body always has a mandatory first parameter self In addition to the first mandatory parameter self the user can pass a variable comma separated list of parameters to the functions Zero or more mandatory parameters may be followed zero or more optional parameters whereas each optional parameter has the following syntax identifier expression The code segment below illustrates a function named doMyCalculations which takes three parameters x y and items The last parameter items is optional as it has a default value def doMyCalculations self x y items 2 RETURN 1 ABIRE if items return x else return y By default the return type of a method is string unless a doc string with the following constraint is available e The doc string is a multi line string flanked by a triple quotes Everything between the start and end quotes is part of a single string which documents what the function does A doc string if it exists must be the first thing defined in a function that is the first thing after the colon You don t technically need to g
432. s m K Location 512 iy Location 384 Allow Setup m EL BUTTON l A Drave Drit Correction T BOO O G3 Foreground Color Background Color RECORDING se Custom Target arget Outer size arget Inner Size Use Custom Background arget Beep DEF AULT Error Beep DEF SULT ood Beep DEF AULT A B Figure 7 12 Using Drift Correction Action 7 9 3 Performing Camera Setup and Calibration The Camera Setup action Sh will bring up a camera setup screen for the experimenter to perform camera setup calibration and validation on EyeLink eye trackers Scheduling this at the start of each block gives the experimenter a chance to fix any setup problems Simply pressing the ESC key immediately can skip calibration This also allows the participant an opportunity for a break the entire setup can be repeated when the participant is reseated The user can set up the calibration type and other calibration configurations through this action SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 68 Typical operations for the camera setup and calibration can be performed by using the display computer keyboard Using the display computer monitor and peripherals Camera Setup and Calibration can also be performed through an external control device for environments in which the Host PC is located far away from the display e g MEG MRI environments Reference Label of the Camera setup action The default value is
433. s not recognized To activate the Experiment Builder license start License Manager program click Start from the desktop go to Programs gt SR Research gt License Manager The ID of that dongle attached to the Display PC will be displayed on the title of the dialog box If the Experiment Builder License status is No and you have purchased the software license please contact support sr research com with that dongle ID you will be given a license code for running Experiment Builder with that dongle Click on the license button on the License Manager to enter the license code see Figure 3 3 ID of the dongle key EE SRLicense REREN None License a x License Status Experiment Builder Data Viewer Please select a license file to program your key Program Key stmata License File Click here to enter the license code Figure 3 3 Getting the ID of USB Dongle Key and Entering Licensing Code 3 3 Software Installation and Licensing on Mac OS X SR Research Experiment Builder runs on most recent Intel based Macs software version Mac OS X 10 6 The computer recommendations are in a large part dependant on the experimental paradigm being run it is always suggested to get the best computer you can for running your experiments even if you do not immediately plan on using all the features of the computer 3 3 1 Software Installation The latest version of Experiment Builder installer can
434. s the currently selected components The part of the graph within a gray background is currently visible in the workspace of the Graph Editor Window The designer can choose to work on a different part of the graph by placing the mouse cursor on top of the gray area holding down the left mouse button and move the gray background to cover the intended region Project Explorer Window C i x Make the Panel Free Floating Overview Panel Make the Window Docked Structure Structure Panel EL_CAMERA_SETUP Eafe TRIAL lfi START T PREPARE_SEQUENCE O DRIFT_CORRECT Properties Panel Devices Tab Connected Frorn START Components Tab Connections Panel Connects To Experiment Tab TIMER EL_BUTTON KEYBOARD SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 29 Figure 5 3 Components of the Project Explorer Window The Structure panel in the middle lists the components used in the experiment This panel has three tabs Experiment Components and Devices The Experiment Tab left panel contains a hierarchical representation of the Experiment all component nodes are listed under the sequence in which they are contained The Components Tab middle panel lists the nodes by type triggers actions or other components Similar to the interface used by Windows Explorer if a certain type of components is used the folder containing those components can be opened or close
435. se was received you should use triggeredData time 1 e the time sub attribute of the triggeredData attribute instead Last Checked lastCheckedTim Float Display computer time in milliseconds from Time the start of the experiment of previous check on the trigger Confidence confidenceInterv Time difference between the trigger time and Interval al last check time of the trigger This indicates a window of uncertainty as the true trigger time could be between the last check time lastCheckTime and the reported the trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 159 pf time time Clear Input clearInputQueue Boolea TTL trigger maintains event queues so that Queue n multiple TTL events can be accessed over time The current option checks whether the TTL event s cached in the event queues should be cleared when the trigger fires NO no event clearing Event removes the current triggering event from the TTL event queue LIST all TTL events from event queue will be removed Device device Which device parallel port or USB 1208 HS is used to send or receive TTL signals Note that this is always set to USB 1208HS on Mac OS X Register register This is usually set to STATUS register but please see the following discussion TTL trigger and the type of cable used Note that this option is only available on Windows when the device is set to a parallel port Mode mod
436. ser read write permission e g at C Users User Name Similarly you should deploy your experiments to the user account directory Note The above files and folders are created and maintained by the Experiment Builder The user should not attempt to modify these files and folders or store important files in the experiment project folder except within myfiles directory The Experiment Builder will overwrite any manual changes made to the experiment project directory except myfiles eon EyeLink Message x i Please Note Do not manually add or remove Files in the experiment directory The Experiment Builder application will overwrite such changes Figure 4 3 Warning Messages after Experiment Creation 4 2 Saving a Session An experiment session can be saved by choosing from the application menu bar File Save Tip The experiment creation session can also be saved by clicking on the Save button on the application tool bar or by pressing the shortcut keys CTRL S on Windows or Command S on Mac OS X If there is any change to the experiment session the previous experiment graph is saved as graph ebd bak in the experiment directory SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 20 4 3 Saving an Existing Session to a Different Directory To save an experiment session with a different session name and or in a different directory 1 From the application menu bar choose File gt
437. service may make the appearance of the Windows less attractive but will greatly improve the performance of the computer For a computer with multiple Ethernet cards installed use the Windows Control Panel to temporarily disable all network connections except for the one dedicated for EyeLink connection The user should disable the firewall for the EyeLink Ethernet connection as well In Windows XP always run your experiments from an account with administrative privilege otherwise a real time priority application might be run in a high priority process instead In Windows Vista when running the application select the exe file from the deployed folder click on the right mouse button Select Run as Administrator Click Allow in the following User Account Control dialog box 3 1 3 Host Computer and Display Computer Software Requirements SR Research Experiment Builder works with EyeLink I EyeLink H and EyeLink 1000 eye trackers EyeLink I users should make sure that version 2 11 of eyelink exe file is installed on the Host PC whereas EyeLink II users should use a recent version 2 0 or later of eyelink2 exe If the EyeLink Data Viewer is used for data analysis the user should get the most recent version of the software The DriverLinx parallel port driver SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 11 Port95NT exe should also be installed if the user is using a TTL action or trigger This d
438. sition of the image resource select the image by clicking left mouse button and keep holding down the mouse button while dragging the resource to the desired location Release the mouse button when the image resource is at the desired location The resource position can also be set from the value field of the Location property in the property panel SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 198 Tip The x y coordinate of the current mouse cursor position will be displayed below the cursor if the mouse is left static for a couple of seconds in the Screen Builder workspace Reference String Label of the resource The default label is IMAGE RESOURCE i l NR The type of screen resource ImageResource the current item belongs to n default setting is True box checked i n Position is Gaze Contingent T _positionAtGazeC Boolea Whether the position of the resource is ontingent contingent on the gaze position The default setting 1s False This setting can only be modified when the display screen is contained in a recording sequence Whether the position of the resource 1s contingent on the mouse position The default setting is False Adjustment of the resource position relative to the intended resource location or the position of the current gaze or mouse movement pattern The default value is 0 00 0 00 for a perfect alignment of the resource position with the current gaze
439. sound and one for video To put the sound back into the video so that the video will have sound during the experiment the user needs to use a DISPLAY SCREEN action to show the video stream and a PLAY SOUND action to play back the audio stream To synchronize the playing of the video and audio streams we recommend the user to use the ASIO driver click the Devices Tab of the structure panel and select the Audio Device to play the audio file To use the ASIO driver please follow the instructions on installing and configuring the ASIO card and driver available Once the ASIO driver has been selected double click on the Display Screen action which is used to show the video and enable the Synchronize Audio Option This will let you select a wav file from the library manager to play with the video and set the Sound Offset to 0 for well synchronized audio and video playback If exact audio video synchronization is not critical to your experiment or you do not have an ASIO sound card on your display computer you can also always use a separate Play_Sound action right before the Display_Screen action that displays the video and have the PlaySound action play the associated wav file for the video clip This method will work with any audio card when the Audio device is in DirectX driver mode but will not give you exact synchronization between the audio and video 8 1 3 Text Resource To add a text resource onto a display screen click on the
440. ss than the full frame duration whenever this small drift between the actual and desired frame display times approaches one display retrace in duration correcting or resetting the drift 8 1 2 4 Dropping Frames The term dropping frames refers to the situation where a frame or a set of frames were not displayed on the screen There are several detailed possibilities as to why a frames may be dropped however they all converge on the higher level reason of the display computer hardware not being able to keep up with the requested frame rate for the video resource in question If a display computer is used that meets the specifications we suggest for video presentation dropped frames should not occur for normal video playback scenarios The Experiment Builder decides to drop a frame if the actual frame display time for that frame is estimated to be equal to or greater than the desired display time of the next upcoming frame If the video playback performance is very poor this may result in several frames being dropped in a row If a frame is dropped the Dropped Frame Count is increased in the video resource object Furthermore a warning message is printed to the console and to the warnings log file indicating a frame was dropped and what the index of that frame was You can also detect dropped frames by looking at the display screen messages that are saved as a video is being played If a frame is dropped no frame display message will be wr
441. ssi eia 38 02 TMK R l S isse a a e E aie 38 6 3 ACON S sieri stew vat oases ooo tee alterw cates va ae tiene 39 Ope O Ren ECT TE Ie PERE EE RTE ey een I EE ee ey eer eee 40 6 5 Other Node Ty pes sccualescig ona diemaiateyalceeiaatdaniw a 4 6 6 O15 6 Ul 8 CeCe A001 6 esa 0 kenen eee ar ee em tr ee een 42 6 7 Relerences and Equations neira E 43 Experiment Graph and Components ccccsssssssecccececeeeesseseecececseeeeseeeeeeeeeeaaeeesees 45 7 1 Graph Pditine OPaOS ei ete eee eee 45 T ANOGE C ONMECION issos a a eee ees ee een es 46 7 2 1 Connection Create Cancel and Delete 200 eee eecceccecceceeceeceeceecs 46 k22 ACOMME CIO Orderan onesie ieatedanein eee tenel areata adenosine horetese 47 ts Experiment Node Exporting and Importing ccccessseseeeeeeeeeeeeeeesseeeeeees 47 A ool Naam EDON cen ren er renee ene eee enna Tee errant enn nye enn ne en 47 Ter TMp a Gaus Rests eaoia teat eas eames eke 49 74 gt LCayoutof Nodes m Work SP aCe issvsseacecdeneseisovsanicdcnasctsnevsasasteded aara E a a vies 50 7 5 Editing Properties oia Noden A 51 AO Experiment Nodesscenmaciaae o E a 52 7 1 SSCS CS SM IAN e E E udaassee ie teeatie 54 7 8 to 21 ocala 10 cere mn eter E anne Rare Ree Ene Me rT nee are O 58 Mi UUM Stage eh saree AE EA A aoe ohana Genentech seated 59 er Display Cle e Meats ca eeheces saree aie eed ieee es tieuneeeteeearnenes 59 T92 Pernon DICE Ore Ct OU oon tsicsdanctate ss visited aerate tsonth eras eeee
442. t Co mponents Devices Properties x irre Start Time Clear Input Queues Sound File orrect wary 2004 2011 SR Research Ltd 97 A B Figure 7 22 Using Play Sound Action 7 9 14 Play Sound Control Play Sound Control action Sh stops pauses or plays a specified playsound action Please note that the pause and play continue playing of a paused audio actions are only applicable when DirectX driver is used Reference Label of the Play Sound Control action The default label is PLAY _SOUND_ CONTROL Type NR The type of Experiment Builder objects PlaySoundControl the current node belongs to Node Path absPath String The absolute path of the node in the experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the action is done Time time Float Display computer time in milliseconds from fe ee the start of the experiment when the action is done Start Time StartTime Float Display computer time in milliseconds from pe the start of the experiment when play sound control action begins Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues F S n when the action is started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixat
443. t Patterns 0 oo 170 255 Built In Interest Area BuildDeploy cUl C Sample Text Sample Text Bl Cancel Reset Restore Factory Default Save Properties as De Figure 8 9 Setting the Transparency Color for the Experiment Generally speaking anti aliasing should be applied when using text multi line text resources line ellipse and freeform screen resources The following sample experiments use the anti aliasing in the resource drawing Simple Stroop TextPage TextLine Saccade and Pursuit 8 1 4 Multiline Text Resource The above mentioned text resource allows the user to add one line of text on the screen To show a full page of text the user may use the multiline text resource by clicking on the Insert Multi Line Text Resource button 4 on the Screen Builder toolbar and clicking anywhere in the workspace Only one multiline text resource can be added to each display screen SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 215 eos MultiLine Text Resource Editor a Buck did not read the newspapers or he woul not alone for himself but for every tide water dog hair from Puget Sound to San Diego Because ir found a yellow metal and because steamship anc the find thousands of men were rushing into the the dogs they wanted were heavy dogs with stror coats to protect them from the frost Buck lived at a Dig house in the sun kissed lt place it was called
444. t are collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action The following illustrates one common use of the NULL_ACTION node Suppose that the subject s response should be recorded without ending the trial e g pressing a key or button whenever the subject detects a specific event in the video clip This can be done by adding a NULL_ACTION node after the DISPLAY_SCREEN and having the input trigger branch looping back to the NULL_ACTION use an UPDATE_ATTRIBUTE action following the input trigger to collect response data All other triggers initially attached to the DISPLAY SCREEN action should be connected from the NULL_ACTION as well Please note that if a TIMER trigger is used to end the trial the start time should be reset to the time of the DISPLAY SCREEN so that the start time of the TIMER trigger is not reset whenever a key is pressed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 110 DISPLAY _TARGET COC x Property TIMER NULL ACTION Ty Timer Duration Type Start Time DISPLAY TARGET time Flapsed Time ae DISPLAY BLANKE Figure 7 27 Using a NULL_ACTION node 7 9 21 ResponsePixx LED Control If a ResponsePixx button box is used as the EyeLink button box this action 8s allows to turn on off the LEDs on the button box T
445. t for the complete example project DISPLAY _TARGET Properties Property a HECK RESPONSE conditional Path BLOKE TRIAL RECORDING CHECK RESPONSE es54ge ime CEDRUS INPUT ast Checked Time onfidence Inte ttribuke Dparent parent TRIAL DataSource expected buttona GET_RESPONSE omparator UALS alue TBUTTON PRESSED value CHECK RESPONSE And Or Select omparator 2 alue 2 SET CORRECT Figure 7 41 Checking Cedrus button response accuracy SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 136 7 10 5 2 Collecting inputs from the Cedrus button box without ending the trial Sometimes the subject s button response should be recorded without ending the trial e g pressing a button whenever the subject detects a specific event in the video clip This can be done by adding a NULL_ACTION node after the DISPLAY_SCREEN and having the Cedrus Input trigger branch looping back to the NULL_ACTION use an UPDATE_ATTRIBUTE action following the button trigger to collect response data All other triggers initially attached to the DISPLAY_SCREEN action should be connected from the NULL_ACTION as well If a TIMER trigger is used to end the trial the start time should be reset to the time of the DISPLAY SCREEN so that the start time of the TIMER trigger is not reset whenever a button is pressed DISPLAY _TASRGET Properties H X MOLL_ACTION f ast Che
446. t of resources can be added to a display screen images texts single line or multiple lines and simple drawings like rectangles ellipses lines triangles and polygons see Figure 8 2 APARADO A WY Figure 8 2 Resources Implemented in Screen Builder As for triggers and actions discussed in the previous chapter the layout and properties of a selected resource can be easily modified by using the Property panel In addition to the physical appearance of the resource position size style etc the user needs to keep in mind the following issues when reviewing the properties of a graphic resource e Visibility After a resource is added to a screen it can be either visible or invisible when the display is shown This property is especially useful for those experiments in which similar displays are used except that one or several items are present or absent e Position is Gaze or Mouse Contingent This is useful for those experiments in which the resource position is changed according to the current gaze or mouse position see the GCWINDOW and TRACK examples during recording For an image resource the clipping area can also be made gaze contingent see the GCWINDOW example e Movement Pattern The Experiment Builder supports both static and dynamic resource presentations In the latter case users can specify a movement pattern sinusoidal or custom for a resource see the PURSUIT example Note if a movement pattern has been assigned
447. tart time of the timer trigger will be the end of the previous action as well not the time when the previous trigger fires SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 114 The user need to explicitly set the start time value of the TIMER trigger when the desired start time is the triggered time of the previous trigger or when the action from which the timer trigger is connected may be repeated see FAQ Using an EyeLink button trigger without ending the trial sequence in the html version of this document The TIMER trigger uses a pre release mechanism when it is connected to a DISPLAY SCREEN action or a PLAY SOUND action when set to ASIO driver to ensure that the upcoming audio visual event will be presented on the predicted time To make this preleasing mechanism work please do not insert any intervening trigger actions between the TIMER trigger and the intended DISPLAY SCREEN or PLAY SOUND action Therefore a sequence like DISPLAY A gt TIMER gt DISPLAY B gt UPDATE_ATTRIBUTE is recommended for accurate timing while DISPLAY A gt TIMER gt UPDATE_ATTRIBUTE gt DISPLAY B is not The following illustrates the use of TIMER triggers to control the duration of display presentation and how long a sequence should be run Imagine that the user wants to show display A for 500 milliseconds then show display B for 500 milliseconds and then display A for 500 milliseconds and so on while the whole s
448. tarted following calibration validation and drift correction After running three blocks of four trials blocks are separated by a camera setup procedure an EDF file will be transferred to the display computer It may take some time to complete the file transfer so please be patient The following sections list the common errors while running an experiment SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 295 14 4 1 Error in Initializing Graphics When you start the experiment and see an Error Initializing Graphics error please check whether the display settings screen resolution color bits and refresh rate specified for the experiment are supported by your video card see Figure 14 17 If not please change the Preferences Experiment Devices Display settings Error Initializing Graphics Figure 14 17 Error in Initializing Graphics 14 4 2 Error in Tracker Version SR Research Experiment Builder works well with both EyeLink and EyeLink II eye trackers The default tracker version is set to EyeLink II see Preferences Experiment Devices gt EyeLink Therefore EyeLink I users may see such an error message with the default tracker setting see Figure 14 18 If this is the case please set the tracker version in the device settings to EyeLink I see Figure 14 3 Error Tracker version is not 2 x X File Pn7676434222565155408_exp py line 47 in Figu
449. te a data column of Boolean the user needs to enter true or false in the data cell The above figure illustrates the use of these data types To delete one column of data line click on the column heading of the intended column click the right mouse button and select Cut or Delete from the popup menu To copy one column of data press Copy and then press Paste This will append the new column to the end of the data source Similar operation can be performed on the rows of data source by clicking on the row label of the target lines and choose the desired operations Experiment st SEQUENCE SEQUENCE DataSource Update Column Copy A Paste m Delete Figure 9 4 Editing Operations for Data Source Columns and Rows The user can copy paste or cut delete data cells in a similar fashion by selecting the target cells In addition the user can copy the current selection to external program such as Microsoft Excel If you have copied some data from external programs you may also paste the selection into the current data source editor Selections can also be copied and pasted between two ongoing Experiment Builder sessions A Data type mismatch error will be given if the data types of the source and target do not match e g copying a column of string data to a column of color type Please make sure that there are no SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 246 empty lines cells in the dataso
450. te a prototype of experiment conditions while leaving all parameter settings e g experiment trial condition labeling images to be used text to be shown positions of the resources to be handled by a data source This makes the randomization of trials across participants easier In addition attribute reference allows the user to access some run time data so that useful experiment manipulations such as conditional branching displaying feedbacks and creating new variables can be made 1 2 How to Use This Manual This manual is intended for users who are using version 1 10 or later of SR Research Experiment Builder software If you are still using an earlier version of the software please download the latest version from https www sr support com forums showthread php t 9 The latest version of this document can be obtained from https www sr support com forums showthread php t 99 Note you must be a registered user of https www sr support com to access these updates and the Experiment Builder usage discussion forum If you have feature requests or bug reports please send an e mail to support sr research com If you have questions on using the software please check out the Frequently Asked Questions section of the user manual html version the Experiment Builder usage discussion forum or send us an e mail SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 2 To use the Experiment Builder software effectively
451. ted in one set A non empty split by list specifies the actual number of iterations to be executed for each call of the sequence This feature can be conveniently used to design a data source for experiments in which uneven numbers of trials are tested in different blocks In the above example the iteration count of the BLOCK sequence is 3 and split by list 1s empty This means that the BLOCK sequence will be executed three times in total 1 e 3 blocks The total iteration count of the TRIAL sequence is 12 and the split by field contains a list of 2 5 5 This means that the TRIAL sequence will be executed two five and five times during the first second and last call of the BLOCK sequence The iteration count of the RECORDING sequence is and the split by list is empty This means that the recording sequence will be executed once for each call Therefore the above graph indicates that this experiment has three blocks which contains two five and five trials respectively Each trial will perform one eye tracker recording 7 8 Start Node For each sequence in an experiment graph the flow always begins with the default START node Each sequence requires at least one connection made from the START SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 58 node to one or several triggers or actions The START node cannot receive a connection from other nodes Reference ee Label of the Display Screen action The defa
452. tersection of grids Grid Type The grid can be formed by lines cross or points Grid Resolution This draws a grid every 100 pixels Numbering Edges If checked adds a number to each of the connection between a node and multiple triggers that connect from the node to indicate evaluation priority among the triggers Remember Zoom Level If checked the current zoom level will be saved and remembered when the project is re opened later SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 352 17 4 2 CustomClass Editor oof Preferences El af Preferences p Experiment o HA Devices 3 a Nodes Highlight Color Enable EF aeae Highlight Color HHA Resources BS Movement Patterns HHG Built In Interest Area Preference e Build Deploy ey GUI GRAPH_LAYOLIT Restore Factory Default Save Properties as Default Import From File Save Into File Font Name Name of the font the custom class editor used to show custom class code Font Size Size of the font the custom class editor used to show code Highlight Color Enable If enabled the current editing line will be highlighted Highlight Color Color used to highlight the current editing line SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 353 18 Revision History Version 1 10 165 Bug fix for automatic interest area creation for multiline text resources Bug fix for performing intern
453. the PC type dxdiag in the DOS command line prompt or search for the dxdiag exe file in the windows system32 directory and click on it This will bring up a DirectX Diagnostic Tool dialog box Ifa version older than DirectX 9 0 is installed on your computer an updated version of DirectX should be downloaded and installed from http www microsoft com windows directx For the most accurate display timing it is strongly suggested that a CRT monitor is used as LCD monitors can add extra delay in display updating The retrace rate capabilities of the monitor should also be considered We suggest that a video card and CRT monitor are used that can run at a minimum of 100 Hz ek Any Direct X compatible sound card can be used for hearing calibration and drift correction feedback tones and playing audio files where exact audio timing is not important to the experiment In cases where accurate audio timing is important or if the audio recording and or computer base voice key features of the Experiment Builder will be used then an ASIO compliant audio card must be available in the PC The following cards have been tested and the status of the ASIO driver tests are listed SR Research strongly suggests that a card from the table is used that supports the features required for your experiment cameron fist ef fo Windows Windows 7 voicekey E A sound card discontinued by manufacturer Creative Labs Sound Blaster Audigy 2 ZS Supported No
454. the current action is referring and the Value column specifies the new value assigned to the corresponding target attribute The new value assigned to the corresponding target attribute Atttribute Attribute 2 Attribute 3 Value value Value 2 value2 Value 3 value3 The user can update the value of an attribute by assigning a value directly e g setting the value of VARIABLE to 0 referring to another attribute e g retrieving the time when the EyeLink button box was pressed and assign this time to VARIABLE2 or using equation e g incrementing the value of VARIABLE3 by 1 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 84 Properties BR Property vae Assign a value directly EL_BUTTON triggeredData timeg Referring to another attribute VARIABLES value 1 Using Equation lear Sar QUEUES m lattribute value List 3 Number of established Click on the right end of the Attribute or Value attribute value pairs field to bring up attribute eclitor dialog box Figure 7 17 Using Update Attribute Action 7 9 9 Adding to Accumulator The ADD_ACCUMULATOR action 2 is used to add data to an accumulator object see Section 7 11 3 Accumulator for example so that statistical analysis can be done on the stored data Reference Label of the ADD_ ACCUMULATOR action The default value is ADD ACCUMULATOR Type NR The type of Experiment Builder objec
455. the triggeredData keyCode of the KEYBOARD trigger In the Value field enter the expected keycode for the character e g 32 for the spacebar 7 10 6 2 Collecting inputs from the keyboard without ending the trial Sometimes the subject s key response should be recorded without ending the trial e g pressing a key whenever the subject detects a specific event in the video clip This can be done by adding a NULL_ACTION node after the DISPLAY_SCREEN and having the keyboard trigger branch looping back to the NULL_ACTION use an UPDATE_ATTRIBUTE action following the keyboard trigger to collect response data All other triggers initially attached to the DISPLAY_SCREEN action should be connected from the NULL_ACTION as well If a TIMER trigger is used to end the trial the start time should be reset to the time of the DISPLAY SCREEN so that the start time of the TIMER trigger is not reset whenever a key is pressed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 142 DISPLAY TARGET ee X _ Property Label TIMER Ype imer MOLL_ACTION G ae Start Ti DDISPLAY _TARGET time Figure 7 46 Using keyboard without ending a trial 7 10 6 3 Enabling multiple keyboards If multiple keyboards or mice attached to the display computer responses from all of the keyboards and mice are treated the same as if the response is made to a single keyboard or mouse In some applications the user may want t
456. the work space Click on the added action and review the settings in the property table Make sure to check the Flush SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 309 Log box so that the data output for the previous trial is done before starting a new trial 7 Click on the Action Tab of toolbox select the Sequence node hold down the left mouse button and drag it into the work space 8 Make a connection from the START node to UPDATE_ATTRIBUTE from UPDATE_ATTRIBUTE to PREPARE SEQUENCE from PREPARE SEQUENCE to the SEQUENCE node Please note that the four variables RT KEYPRESS RESPONSE and TRIAL_INDEX should not be connected to other nodes 9 Click at any blank area in the Work Space Click the right mouse button and select Arrange Layout in the popup menu Click ok in the following dialog box to re arrange the nodes in an orderly fashion 10 Double click on the newly created sequence to fill in the actual events in the recording 15 8 Editing Trial Event Sequence Part 1 The next step is to work out the actual display presentation in a trial In this example we first show a fixation mark in the center of the screen for one second followed by the presentation of the Stroop word Wait for a keyboard response by the subject or the trial times out in eight seconds and the display is cleared SA Beseanth permen Maker y LAZARAT Strep S
457. ti positions Positions on Customized List A list of X Y pairs to specify the calibration Calibration calibrationPosit of target positions in the intended display screen Positions ions points resolution The number of points included in the list must match the calibration type This option is only available if the Enable Customized Calibration Positions setting is enabled The following lists example default calibration validation point lists under a 1024 768 recording resolution Please be aware that the points in the list MUST be ordered on screen Enable If checked user defined calibration Customized enableManualC Boolea positions can be used instead of the default n Point order for 5 9 or 13 point calibrations 6 2 7 10 1l 4 l 5 12 13 8 3 9 HVS 512 384 512 65 512 702 61 384 962 384 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 70 Customized Validation Positions Customized validation Positions Foreground Color Background Color enableManual ValidationPositi on validationPositi ons foregroundCol or backgroundCol or Boolea n List of points HV9 512 384 512 65 512 702 61 384 962 384 61 65 962 65 61 702 962 702 HV 13 512 384 512 65 512 702 61 384 962 384 61 65 962 65 61 702 962 702 286 224 737 224 286 543 737 543 Point order for H3 calibration typ
458. tion mouseThreeY Position Default Y position of the second third mouse device Mouse Two Button Down Input Queue size Mouse Three Button Down Input Queue size mouseTwoDownInputQueueSize mouseThreeDownInputQueueSize Sets the maximum number of press events that can be cached in the press event queue for the second third mouse device Mouse Two Button Up Input Queue Size Mouse Three Button Up Input Queue Size mouseTwoUpInputQueueSize mouseThreeUpInputQueueSize Sets the maximum number of release events that can be cached in the release event queue for the second third mouse device Mouse Two Button Down Event Count Mouse Three Button Down Event Count mouse WoDownEventCount mouseThreeDownEventCount Total number of press events cached in the press event queue for the second third mouse device Mouse Two Button Up Event Count Mouse Three Button Up Event Count 4 mouseTwoUpEventCount mouseThreeUpEventCount Total number of release events cached in the release event queue for the seond third mouse device SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 339 17 1 7 EyeLink Button Box Device eo Preferences S on Property Value ype USB Sidewinder Debounce Time 30 Fl af Preferences t Experiment 2 AS Devices BED EVELINK I DISPLAY AUDIO s B MOUSE E KEYBOARD oT
459. tion In this example Draw to EyeLink Host field of the PREPARE SEQUENCE action is checked The Use for Host Display field of the DISPLAY_SCREEN is also checked so that drawing on that screen will be shown on the Host PC simple rectangular boxes to mark the location of the resources SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 88 START PREPARE_SEGQUENCE DRIFT CORRECT DISPLAY SCREEN EL_BUTTON to TRIAL F START T PREPARE_SEGUENCE eee nee DRIFT_CORRECT Pr Ta RECORDING ri RECORDING Properties Property Value Label PREPARE_SEQUENCE Object Type PrepareSequence 7 Bivcce Reintiaize Triggers f gt lt gt L SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 89 Figure 7 18 Using Prepare Sequence Action 7 9 12 Reset Node Similar to the PREPARE SEQUENCE action RESET NODE action Dh can be used to re initialize trigger and action data The RESET_NODE can also be used to clear the data stored in an accumulator Field Attribute Type Content Reference Label of the RESET_NODE action Type NR The type of Experiment Builder objects ResetNode the current node belongs to Node Path absPath String The absolute path of the node in the experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of
460. tion type can be set by the Screen Preferences This means that references should be created differently depending on whether the region location of a trigger refers to a center based resource or a top left based screen resource Imagine that a fixation trigger should fire when the eye is within a rectangle resource RECTANGLE_RESOURCE The top panel of the figure below illustrates creating the Region Location reference when the RECTANGLE_RESOURCE is top left based DISPLAY_SCREEN RECTANGLE_RESOURCE location The bottom panel of the figure illustrates creating a location equation when the location type is center based EBPoint DISPLAY_SCREEN RECTANGLE_RESOURCE location x DISPLAY_SCREEN RECTANGLE_RESOURCE width 2 DISPLAY_SCREEN RECTANGLE_RESOURCE location y DISPLAY_SCREEN RECTANGLE_RESOURCE height 2 ce E Cees Elx Property Property RECTAMGLE_RES lechangleResource abel SAMPLE VELOCITY a amplevelocity dode Path BLOCK TRIAL RECORDING SAMPLE VELOCITY ime ast Checked Time Region Direction 0 45 45 90 90 135 135 180 180 135 13 Region Type RECTANGLE ost Outline Color Region Location Top Lert DISPLAY SCREEN RECTANGLE RESOURCE locationi Region Width DDISPLAY_ SCREEN RECTANGLE RESOURCE width Region Height TOISPLAY SCREEN RECTANGLE RESOURCE height ithin m rigger 4bove Threshold m Movement Pattern ba ai se Acceleration C se Software Surface O o
461. to register the change 2 Make sure that the Send EyeLink DV Messages and Use for Host Display properties are checked 3 Select the DISPLAY BLANK action Double click on the value field of Message property Type in blank_screen and then press ENTER key to register the change 4 Make sure that both Send EyeLink DV Messages and Use for Host Display checkboxes for the DISPLAY BLANK action is unchecked 14 1 10 Creating Display Screen We will add a text resource to the display screen and modify the properties of the text resource such as font name size text to be displayed and alignment style We will also create an interest area for the text see Figure 14 13 To do this first double click on the DISPLAY_SCREEN object in the work space not in the structure list until the screen builder interface is displayed in the Graph Editor Window 58 feseench biperimen fuer y 402080 Simple p nai alj xj Fia Edi Yew Expert Heb IA 2 BeBe sxRaeQepa wAHovauicgarali x 2 amp 4 BEE ALG eeperimert eLo ose_ay someon tar TmAL_DataSouce recono DISPLAY SCREEN BVPAANOOAQVYV OOF Avs DEE Fae aixi 1 Select the Text Resource and click in the work space 6 Choose alignment style ARERI RESOURCE Soon in Gare Contingent r taion i Mouse Oribi r Tipi E g 7 Select resource click on vs the right mouse button to 2
462. touches within the display area of a touchscreen Using mouse as a response device is not recommended for timing critical experiments because the temporal resolution of the mouse response is unknown the delays introduced by Windows are highly variable and the timing performance may vary across different types of mouse USB vs serial If the mouse trigger is used in a sequence with the Is Real Time option checked a WARNING 2003 The IO node MOUSE 1s used in realtime Sequence gt MOUSE message will be reported This warning message means that the mouse trigger may not work when your sequence is running under the realtime mode this is especially the case if you are using an old Display PC For most recent computers the mouse trigger along with keyboard and Cedrus Input triggers will still run in the realtime mode so this message can be ignored Check the BIOS setting of your Display PC and make sure that the multi core or hyper threading setting is enabled for the proper functioning of the keyboard mouse or Cedrus triggers in a real time sequence Reference MOUSE The type of Experiment Builder objects Mouse the current node belongs to experiment graph Message message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the mouse trigger fires Time time Float Display compute
463. trigger if fired see the following table If the Sample Velocity trigger fires the user can access to the triggered data The attributes of the TriggeredData field are listed in the following table Time time Integer Display computer time in milliseconds from the start of the experiment when the trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 177 es ee eyesAvailable triggered Eye PPDX PPDY leftGazeX right Float GazeX average GazeX leftGazeY right GazeY average GazeyY leftPupilSize ri ghtPupilSize averagePupilSize targetDistance Target Flags targetFlags 1 Note EDF Time Eyes Available Triggered Eye PPD X PPD Y Left Gaze X Right Gaze X Average Gaze X Left Gaze X Right Gaze X Average Gaze Y Left Pupil Size Right Pupil Size Average Pupil Size Left Velocity Right Velocity Average Velocity leftVelocity rightVelocity average Velocity 1 Left Acceleration Right Acceleration Average Acceleration Angle leftAcceleration rightAcceleratio n averageAccelerat ion Target Distance Target X Target Y targetX targetY EDF time of the triggering sample Eyes available in recording 0 for left eye 1 for right eye 2 for either eye Eye 0 for left eye for right eye whose data makes the current sample velocity trigger fire Angular resolution at current gaze position in screen
464. ts AddAccumulator the current node belongs to experiment graph Message Message String Message to be sent to EDF file in an EyeLink experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the action is executed Time time Float Display computer time in milliseconds from the start of the experiment when the action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 85 collected following the start of the Action If false the input queues are not cleared when the action is performed meaning that any events already in the queues will be evaluated by Triggers following the action Accumulator NR accumulator the current action is referring Add Value add Value P R specifies the value 0 0 by default to be added to the accumulator 7 9 10 Adding to Result File The ADD_RESULT action Bh is used to send data to a result file so that the user will get a columnar
465. ts already in the queues will be evaluated by Triggers following the action Load Screen loadImages Boolea If enabled default all of the possible images Resources T n used in the current sequence and sequences nested within it will be preloaded for real time performance Load Audio T loadAudio Boolea If enabled default all of the possible sound n clips used in the current sequence and sequences nested within it will be preloaded for real time performance Draw to drawToEyeLink Integer If NO 0 no feedback graphics is drawn on EyeLink Host Host the Host PC screen If IMAGE 1 transfers xq one of the display screens to the tracker PC as backdrop for gaze cursors If PRIMITIVE 2 draws primitive line drawings on the Host PC to indicate the location of resources used in a display screen This attribute is only available in an EyeLink experiment Reinitialize If checked performing this action will also clear Triggers T n trigger data for re initialization Reinitialize If checked performing this action will also clear Actions T n action data for re initialization Reinitialize reinitVideoReso oe If checked the video resource if used in the ed Resources urces previous trial will be rewound to the beginning lt a Log T flushLogs ie If checked this will write the messages to the log file and clear the buffer The following Figure 7 16 illustrates the use of PREPARE_SEQUENCE ac
466. ts on the screen e g pursuit Two types of movement patterns can be created sinusoidal or custom To create a movement pattern click on the Insert Sine MovementPattern button MWA or Insert Custom MovementPattern button ar on the Screen Builder toolbar see Figure 8 11 Following this the user can assign the created movement pattern to a resource by setting the Movement Pattern attribute of the resource m Figure 8 11 Creating a Movement Pattern To have Data Viewer automatically integrate the target position information users may write out a V TARGET_POS message to the DISPLAY_SCREEN action which is used to present the moving screen resource see EyeLink Data Viewer User Manual section Protocol for EyeLink Data to Viewer Integration gt Target Position Commands or the Pursuit example Target position can be derived from the TARGET_X and TARGET_Y variables of a Sample Report 8 2 1 Sinusoidal Movement Pattern Smooth sinusoidal movement pattern is a widely used diagnostic test due to its wide range of velocities and lack of abrupt changes in speed and direction To review its properties click on the movement pattern node in the structure panel of the project explorer window The defining parameters of a sinusoidal movement are the frequency cycles per second amplitude of the movement start phase and the center X and Y coordinates see the following table for details of each property The ta
467. tting the initial position of the mouse device cceeeeeeeeeees 155 HAOL JEmablne inuitiple Misan vata ee eteheads cere sieiaeiende 155 7 10 7 7 Recording mouse traces 1n a data file nnnosssesoeeeesssssseseeressss 157 OS TPE SG a a nee rae rate ne eee a Nn orca ee eee 158 7 10 8 1 Selina he Pil Valles stuccatueres Sewiauteuceteducda N 161 7 10 8 2 TTL trigger and the type of cable used cceseeeeseeeeeeeeeees 162 GMO TAO TACO ies acariasetet inca eteraahabia usecase ere neeearaatoenteeiet ieee 162 7 10 9 1 Optimal triggering duration 0 0 0 eeeeeeeecceecceeeeeeseeeeeeeeeeaaeeeeseeess 166 7 10 9 2 Top left vs center triggering location type cccccccessseeseeeeeeeees 167 7 10 9 3 How to show the triggering region on the host PC ceeee 168 TOAT SS ACCAGC UES CCT oi os oh eterna hi iune naan a TA 169 7 10 10 1 Top left vs center triggering location type cccccccesseeeseeeeeeeees 173 TAOTO2 Online RY Calculauo ticrets ss canscistasaaverananialvanes E 174 7 10 10 3 How to show the triggering region on the host PC 00 174 IOLL Sample Velocity Tite Get ee ialons ieee he heals 175 7 10 11 1 Top left vs center triggering location type ssssseeesessssssseeeeeees 179 7 10 11 2 How to show the triggering region on the host PC 00 181 TAOTI ASIO Voicekey Tiere arire ea a nieve uameataeieartseaaanets 182 7 10 12 1 How to calculate the voice key RT online
468. tton response should be recorded without ending the trial e g pressing a button whenever the subject detects a specific event in the video clip This can be done by adding a NULL_ACTION node after the DISPLAY_SCREEN and having the Cedrus Input trigger branch looping back to the NULL_ACTION use an UPDATE_ATTRIBUTE action following the button trigger to collect response data All other triggers initially attached to the DISPLAY_SCREEN action should be connected from the NULL_ACTION as well If a TIMER trigger is used to end the trial the start time should be reset to the time of the DISPLAY SCREEN so that the start time of the TIMER trigger is not reset whenever a button is pressed SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 154 DISPLAY _TASRGET Properties Hx MOLL_ACTION Last Checked Time Konfidence Interval Duration Duration Type Start Time DDISPLAY_ TARGET time Elapsed Time DISPLAY BLANK Figure 7 54 Using mouse trigger without ending a trial 7 10 7 5 Resetting the initial position of the mouse device The initial position of a mouse contingent resource can be reset by updating the X Position and Y Position of the mouse device to intended values See FAQ What should I do to reset the mouse position to a default position at the beginning of each trial in the HTML version of this document 7 10 7 6 Enabling multiple Mice If multiple keyboards or mice attached t
469. type of screen resource CompositeResource the current item belongs to experiment graph Visible visible Boolea Whether the resource should be visible The e ais po Screen Index screenIndex Integer Index of the resource in screen resource list 0 n positionAtGazeC Whether the position of the resource is SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 241 Position is _positionAtMouse Boolea Whether the position of the resource is Mouse Contingent n contingent on the mouse position The default Contingent setting is False Offset offset Point Adjustment of the resource position relative to the position of the current gaze or mouse position The default value is 0 00 0 00 for a perfect alignment of the resource position with the current gaze or mouse position Screen Location Whether the location specified below refers to Type the top left corner or center of the resource This setting can be changed at Screen Preferences Location location Point The coordinate of the top left corner or center of the resource width Width of the resource in pixels height Height of the resource in pixels Movement NR Movement pattern sinusoidal or custom of the Pattern resource Prebuild to _prebuildToImage Boolea Whether the resource should be built into an Image image when the experiment is built instead of having it created during runtime This field is always true when the sc
470. u are running Windows 2000 e Cedrus input trigger now works on 32 bit Windows XP Vista Windows 7 and 64 bit versions of Windows Vista and Windows 7 e SplitAvi and Xvid codec runs fine with both 32 bit and 64 bit versions of Windows e Bug fix for the custom movement pattern when the first resource point doesn t start from time 0 e Bug fix for the mouse movement range in screen resolutions higher than 1024 x 768 e Bug fix for uncleared EyeLink Button trigger used in the non recording sequence e Bug fix for gaze contingent moving window manipulations with a variable size across trials e Bug fix for size error when the location of a triangle resource 1s modified by a reference Version 1 6 1 e This release runs fully on 32 bit versions of Windows 2000 XP Vista and Windows 7 Known limitations on 64 bit of Windows 7 e Updated the ASIO Sound Card Installation section of this document Existing users of the following sound cards should re check the installation steps to select the Audio Creation Mode and enable Bit Matched Playback option even if you have already had the sound card working with the software o Creative Labs Soundblaster X Fi XtremeGamer o Creative Labs Soundblaster X Fi XtremeMusic SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 355 o Creative Labs Soundblaster X Fi Titanium PCI Express e Bug fix for resource drawing when the offset value is not 0 0 e Added more options fo
471. ue The value used to evaluate one attribute The Value 2 value2 data type of this field depends on the attribute used And Or Select andOrSelect String Connection between multiple conditional q evaluations Possible values are AND OR AND NOT or OR NOT In the previous example section 7 5 2 the user may want to further check whether the velocity and acceleration of the triggering sample in the invisible boundary trigger exceeds a set of target values The following figure illustrates the use of conditional trigger to check out these parsing criteria The Attribute field of the trigger is set as INVISIBLE_BOUNDARY triggeredData leftVelocity and the Attribute 2 field of the trigger is set as INVISIBLE_BOUNDARY triggeredData leftAcceleration SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 124 Conditional START a SEQUENCE Experiment Components Dewices A Property Value abel ONDMONMAL Message onditional Trigger DISPLAY_TRUE fie o o Attribute I INVISIBLE_BOUNDARY REATER_THAN Vue and Or Select attribute 2 aun YISIBLE BOUNDARY REATER_THAN Neue A B Figure 7 33 Using Conditional Trigger When performing a conditional evaluation the user must make sure that the data type of the value field must match that of the attribute field ditto for Value 2 and Attribute 2 The data ty
472. ue field of the EyeLink Record Status Message Property In the following attribute editor dialog enter the message string see Figure 11 3 Make sure that the message string is shorter than 40 characters for an EyeLink I eye tracker and 80 characters for an EyeLink II or 1000 eye tracker Since the EyeLink host software runs on a DOS operating system please make sure that non ASCII characters are not included in the message string as they will not be displayed properly For example if the user has a data source with the variable list being Trial Word and the first line being 1 One the record status message can be Trial str TRIAL SEQ DataSource Trial 4 TRIAL SEQ DataSource Word This will display a text like Trial 1 4 One on the tracker screen for the first trial lt a Edit Attribute equation EquationRECORDING gt eyeLinkRecordStatusMessage Attribute Simple f START Eats BLOCK i START gH DISPLAY _SCREEN TIMER EL_BUTTON KEYBOARD EL_CAMERA_SETUP Jr Attribute Attributes Ebel TRIAL fi START W PREPARE_SEQUENCE C DRIFT_CORRECT SOR IRECORDING YF START aH DISPLAY _SCREEN START HH DISPLA Y_SCREEN TIMER EL_BUTTON KEYBOARD EL_CAMERA_SETUP EHT TRIAL DataSource START PREPARE_SEQUENCE DRIFT_CORRECT 9 eee ecording Pause Time yeLink Record Status
473. uence This involves changing the Label of the sequence to make it more meaningful and changing the iteration count to the actual number of blocks to be tested see Figure 14 5 Please note here we do not edit the Split by field SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 282 SE Pepearch Expenment Bader Y L402 20 A Sample 5 al l si IS BbG8e PxXRGQGRERBA CAS gaRr elie QRARAE aff covet aoo Oa Bel 0 gt mo oi Bl a Se Single ii START k STARI M1 Edit label press Enter key to finish ecard B z 3 Double click on the BLOCK sequence to continue eration Cound H 2 Set the Iteration Count to 3 Figure 14 5 Editing Block Sequence 1 Click on the value field of the Label property of the Sequence created Write BLOCK in the text editor and press the ENTER key to finish 2 Click on the Iteration Count value field and enter 3 as the total number of sequence loops 3 In the experiment Work Space double click on the Sequence object to continue In each block we will first give an instruction perform a camera setup calibration and then run four trials see Figure 14 6 1 Click on the Action Tab of the component toolbox select the Display screen action hold down the left mouse button and drag the action into the work area 2 Click on the Trigger Tab of the component toolbox sel
474. uilder User Manual Example import sreb class CustomClassTemplate sreb EBObject def init__ self sreb EBObject __ init__ self self property1 1 property of Integer type This is also a read write property see the getter and setter self property2 1 2 read only point property Note the setter missing for this property self property3 1 2 3 read only color property Note the setter missing for this property self property4 1 0 read and write property of double type also will not accept references or equation self property5 sreb EB Point 100 200 read write point property Note this property is similar to proprty2 except the writeableness self property6 sreb EBColor 200 100 100 read write color property Note this property is similar to proprty3 except the writeableness self property7 1 abc self property6 read write eblist property self property8 hello read write string property self _myInternalAttribute My Internal Attribute string property however this is hidden from the interface Property property 2004 2011 SR Research Ltd 266 Line 018 Line 019 Line 020 Line 021 Line 022 Line 023 Line 024 Line 025 Line 026 Line 027 Line 028 Line 029 Line 030 Line 031 Line 032 Line 033 Line 034 Line 035 Line 036 Line 037 Line 038 Line 039 Line 040 Line 041 Line 042 Line 043 Line 044 Line 045 Line 046 Line 047 Line 048 Line 0
475. ult value is DISPLAY_SCREEN label Type NR a The type of Experiment Builder objects Start the current node belongs to experiment graph Time time Float Display computer time in milliseconds from o the start of the experiment when the experiment ue flow starts 7 9 Actions SR Research Experiment Builder supports a list of actions such as displaying a screen performing drift correction performing camera setup and calibration sending a message to an EDF file or to a log file preparing sequence sending a command sending a TTL signal updating variable value adding to result file adding data to an accumulator outputting data to a result file playing sound recording sound data source line recycling or terminating the experiment Actions can be accessed by clicking on the Action Tab of the Component Toolbox The following sections describe the usage and properties of each action type in detail BOS BREED gt ls 4 Alle lle 76 le Figure 7 10 Action Tab of the Component Toolbox 7 9 1 Display Screen The DISPLAY_SCREEN action 2 is used to show visual stimuli on the display monitor Double clicking on the newly created DISPLAY_SCREEN action will show a blank Screen Builder workspace for editing the screen Please follow Chapter 8 Screen Builder to modify the content of the screen Reference value is DISPLAY_SCREEN Type R The type of Experiment Builder objects DisplayScreen
476. urce editor when you start to test run or deploy your project COLOR WORD EXPECTED COMPATIB Color Stringy String Stringy HKO D 255 Bue k Yes 2 0 255 0 Red g No 3 255 0 0 Red r Nes 4 0 0255 Green p No 5 255 0 0 Blue t Mo 6 0 255 0 Blue eal eo Cut a cm Paste m Delete E External Copy EY External Paste s foan cae a es in ee oo hy 7 Figure 9 5 Editing Datasource Cells Changes from version 1 3 External Copy and External Paste options have been removed in version 1 4 These operations can now be done through Copy and Paste 9 3 Importing Existing Files as Data Source For greater flexibility the user can also generate data source with external text editor software like Wordpad Notepad etc and then load the plain text file into Experiment Builder In that file use the first row for column variable labels Use space or tab to separate neighboring columns Click on the Import Data Button on the data source editor screen In Open dialog choose the target file Please note that if your external data source file is encoded with ASCII format you may leave the Encoding field as default Ifthe target file was encoded with UTF 8 format choose the right encoding type before pressing the OK button If the user has already a data set created a dialog box will be displayed to allow the user to choose to append the new data after the existing data lines o
477. user pressed a button at which time a second set of graphics would be displayed Detailed discussion on the experiment component connection or linking process including a set of rules for linking experiment components together can be found in Section 6 2 Experiment Graph Flow Diagram As a convenient tool for creating eye tracking experiments the Experiment Builder is fully integrated with the EyeLink eye tracker Performing camera set up calibration validation and drift correction can be achieved by simply inserting the appropriate action in the experiment A single check box setting can be enabled to record eye movements for a period of time Online eye data can be used as triggers to drive display changes e g displays can be made contingent on fixation saccade or instantaneous sample data so that gaze contingent or gaze control applications can be developed In addition users can set eye tracker preferences and send commands and messages to the EyeLink tracker SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 1 With these capabilities the Experiment Builder allows the users to focus on stimulus presentation and data analysis Recording data collected from experiments created by Experiment Builder is fully integrated with EyeLink Data Viewer For example Experiment Builder automatically sends messages to the EDF file when a screen is displayed so that images and or simple drawings can be used as overlay
478. uter time in milliseconds from the start of the experiment when the action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only firing based on events that are collected following the start of the Action If false the input queues are not cleared when the action 1s performed meaning that any events already in the queues will be evaluated by Triggers following the action Audio Device Indicating the current audio driver setting either DirectX or ASIO on Windows or OS X on Mac OS X This field is neither editable nor referable Sound File firstSoundFile String The name of the sound file This is automatically set to one of sound files in the library None if no sound file is loaded in the library Volume firstvolume Float Adjusts the volume of audio playing Volume ranges from 0 0 muted to 1 0 full volume The default value is 1 0 Playing playing Boolea Whether the sound playing has begun and is in n progress The possible values are true and false If sound playing is done this returns False Note The following fields are specific to the ASIO driver only Balance firstPan Float Adjusts the balance of the sound buffer Balance ranges fro
479. velocity and acceleration values exceed their respective thresholds Conditional Fires when one or two conditional evaluations are met This is useful to implement conditional branching in a graph when several conditions are possible Voice Key Triggers when ASIO input exceeds a pre specified threshold Trigger This only works with an ASIO compatible sound card This trigger type is not supported on Mac OS X 6 5 Other Node Types SR Research Experiment Builder also supports other components Variable Result File and Accumulator These components mainly function as a temporary storage for experiment data Note that these objects are never connected to other components in an experiment in the graph editor Instead they are used within the experiment by attribute referencing See section 6 7 Accumulator Used to keep numeric values and do statistical analysis on the accumulated data The Accumulator is a circular list so the last n items added to the list are kept B Result File Provides a columnar output of selected variables Used to store data during run time Custom Class Used to create a new instance of a custom class Instance SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 41 6 6 Sequence Sub graph As the experiment looping controller a sequence 1 e sub graph is used to chain together different actions and triggers and execute them in a loop Therefore the Sequence experiment co
480. w the triggering region on the host PC 00 123 FAQS Conditional Trig Cer necon ase 123 1O44 Eyelink B tton Trio teisson a aa 127 7 10 4 1 Calculating response time of a button press ccccccceeeeeeeeeeeeees 129 7 10 4 2 Collecting inputs from the EyeLink button box without ending the trial 130 7 10 4 3 Knowing the ID of a specific button on the EyeLink button box 131 4105 Cedrus Button Tie GCP messia tania uineseanis 132 7 10 5 1 Calculating response time of a button press cccccceceeeeeeeeeeeees 135 7 10 5 2 Collecting inputs from the Cedrus button box without ending the trial 137 PAOLO Keyboard Tit OC ities tree teeas Sess nce vad A aoe nets 137 7 10 6 1 Calculating response time from an keyboard input 006 141 7 10 6 2 Collecting inputs from the keyboard without ending the trial 142 7 10 6 3 Enabling multiple keyboards 0 0 00 ccecccccccccccccesseeeeeeceeeeeeaaeeseeeeees 143 7 10 6 4 Disabling Re enabling the Windows Logo Keys cc00e 145 PANO Mouse Tigo e enina n tne idenceee tes naaens teak 146 7 10 7 1 Mouse press mouse release and MOUSE OVET cccccesseeeeeeeeeees 149 7 10 7 2 Center location type vs top left location type cccceeseeeeseeeees 151 7 10 7 3 Calculating response time of a mouse CLICK ccccccccesseeeeseeeeees 153 7 10 7 4 Collecting inputs from the mouse without ending the trial 154 7 10 7 5 Rese
481. whereas the external randomization can be done after deploying the experiment project see Chapter 9 Data source 2 5 Data Collection Data can now be collected from the deployed version of the experiment Double click on the executable file in the deployed experiment directory or type in the exe file name from the command line prompt If the experiment uses a data source a dialog will be displayed allowing the user to choose the appropriate data source file In an EyeLink Experiment the user will also be asked to enter the experiment session name At the End of experiment an EDF file will be generated for EyeLink recording session and saved in the experiment directory Optional result file s will be created if the user has specified them in EyeLink and non EyeLink experiments 2 6 Data Analysis EyeLink recording file can be conveniently analyzed with EyeLink Data Viewer as the experiments created with Experiment Builder are fully integrated with this analysis tool Experiment Builder sends messages to the data file so that images or simple drawing can be added as overlay background The user can also specify trial variables create interest areas and send messages for the ease of data analysis The result file s from a non EyeLink recording session contains columnar outputs for selected variables in the experiment This file can be easily loaded by common statistics packages SR Research Experiment Builder User Manual
482. will display the image in Size T n original size otherwise the image may be stretched to the dimension set by Width and Height fields 8 1 1 1 Image Displaying Modes The image resource 1s flexible enough to accommodate various modes of displaying e g original image size vs stretched top left aligned or centered The following discusses the option of displaying images in original size or stretching it to a specific dimension 1 To display the image in original size after the image is added to the display the user should have Use Original Size field of the image checked Please note that enabling that field will also make several attributes read only Width Height Clipping Location Clipping Width Clipping Height and Clipping Area is Gaze Contingent 2 To stretch all images to a fixed width and height 1024 x 768 for example after the image is added to the display the user should first make sure that the Use Original Size field is unchecked Check the values of Width and Height fields of sample image added and adjust them if necessary In addition the user may need to check the values of Clipping Location Clipping Width and Clipping Height attributes which are used to control the part of the image to be shown By default the clipping width and height are the same as the image width SR Research Experiment Builder User Manual 2004 2
483. will not be treated as a custom class 12 3 3 Class Initialization The body of the class is where you normally specify the attributes and methods of the class An Experiment Builder custom class always starts with a __ init__ self method Line 004 This method is used to initialize the CustomClassTemplate class The first argument of every class method including __init__ is always a reference to the current instance of the class By convention this argument is always named self The custom class __init__ method will only use the default constructor 1 e a constructor with only self parameter or any other parameter with default arguments If any default arguments passed in only the default arguments will be used SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 268 def init__ self sreb EBObject __ init__ self list of attributes self identifier value 12 3 4 Class Attributes Within the __init__ method the constructor must call sreb EBObject s constructor Line 005 Following this all of the possible attributes and methods used in the class should be listed Attributes of the class are specified by binding a value 1 for Line 006 to an identifier self property1 for Line 006 All of the attributes used in the class must start with self The attribute identifier must be an alphanumeric string and start with a lowercase letter if the property starts with an _ underscore or an upper case letter t
484. wing table provides a brief description of the experiments A detailed analysis of each template s operations 1s documented in the following sections More examples can be found in the Experiment Builder usage discussion forum https www sr support com forums forumdisplay php f 7 Experiment Simple The basic experiment template displaying a single word in the center of the screen in each trial This example is used to introduce how to create an experiment with SR Research Experiment Builder step by Step Stroop The basic template for creating non EyeLink experiments This template illustrates the use of result file RT calculation and audio feedback etc Picture Illustrates various parameter settings for showing an image on the screen in original size versus stretched centered versus not centered TextLine Experiment to show a single line of text illustrating the use of runtime interest area TextPage Experiment to show a full screen of text using a multi line text resource GCWindow Demonstrates how to use real time gaze position to display a gaze contingent window Track Displays the user s current gaze position during recording and illustrates how to set the resource position contingent on the current gaze position Change Displays several almost identical screens rapidly It also illustrates the use the of the fixation trigger Saccade Illustrates the creation of a simple experiment for saccade anti saccade researc
485. wn the CTRL key on Windows or the command key on Mac OS X Note To check which button is actually pressed or released use triggeredData button 1 e the button sub attribute of the triggeredData attribute instead Press Events F pressEvents Boolea Whether the trigger should fire when a button n press event occurs This is set to True box checked by default Release Events releaseEvents es Whether the trigger should fire when a button release event occurs This is set to False box unchecked by default Triggered Data triggeredData Data of the triggered button event see the following table To specify a list of button s used for response click on the value field of the Buttons property and select the desired buttons Multiple buttons can be selected or unselected by holding down the CTRL key on Windows or the Command key on Mac OS X The buttons can also be set via attribute reference by double clicking on the right end of the Buttons value field When the button trigger fires the triggered data can be further accessed The sub attributes of the Por field are listed in the following table Attribute Type Content Time time Integer Display computer time in milliseconds from the start of the experiment when the button is pressed n False when the trigger fires The ID of the pressed button that fires the trigger For example if the user wants to end the trial by pressing
486. wo Key Down Event Count Keyboard Three Key Down Event Count keyboardTwoKeyDownEventCount keyboardThreeKeyDownEventCount Total number of press events cached in the press event queue for the second third keyboard device Keyboard Two Key Up Event Count Keyboard Three Key Up Event Count keyboardTwoKeyUpEventCount keyboardThreeKeyUpEventCount Total number of release events cached in the release event queue for the second third keyboard device 17 1 6 Mouse oo Preferences El wh Preferences Eb Experiment f Fosition g O Devices bY Position E E i Mouse Down Input Queue Size A ARI ause Up Input Queue Size 50 oo GP AUDIO fi KEYBOARD si T TTL ee CEDRUS ie BUTTONBOX 2 H io g Screen Build Deploy S GUI hal Restore Factory Default Save Properties as Default Import From File Save Into File Number of Mice numberOfMouses This sets how many distinct mice used in the experiment This option is only available if Enable Multiple Input option is enabled Mouse One Label mouseOneLabel This supplies a label for the first mouse device detected by the experiment This option is only available if Enable Multiple Input option is enabled X Position xPosition Default X position of the mouse device or the first mouse device if multiple inputs are supported Y Position yPosition Default Y position
487. xperiment or recycling data line and other type variable result file and accumulator The Work Space provides a venue where the experiment is generated In an empty sequence the Work Space area contains a START node to which actions and triggers can be connected The designer needs to drag selected experiment elements from the Component Toolbox and drop them to the work space and make connections from to other components The designer can further select individual items for property editing The Editor Selection Tabs and Navigation Nodes provide convenient shortcuts for selecting a display screen or an experiment subgraph sequence to work on When an experiment involves several different layers of subgraphs for example blocks gt Trials gt Trial Recording the Navigation Nodes at the bottom of the graph editor window informs the designer of the layer that they are currently at The designer can switch to work on a different level by a simple click on the target sequence In addition all of the experiment sequences and display screens created in the experiment as well as the project output screen are listed as individual Editor Selection Tabs above the Component Toolbox for direct access SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 31 Editor Selection Tabs Graph Editor Window Experiment BLOCK TRIAL RECORDING Work Space 2 E TIMER w EL_BUTTON fo __Navigation N
488. xt can be created with the attribute editor by double clicking at the right end of the value field allowing for the use of numbers and strings in the message text This action is not available in non EyeLink experiments When using the SEND_EL_MESSAGE action the user should avoid end of line characters n in the message text and avoid making reference to strings with quotes Message text should be no more than 128 characters in length the tracker will truncate text messages longer than 128 characters Also be careful not to send messages too quickly the eye tracker can handle about 2 messages a millisecond Above this rate some messages may be lost and not written to the EDF file Reference Label of the SEND_EL_ MSG action The default value is SEND_EL_ MSG Type The type of Experiment Builder objects C SendEyeLinkMessage the current node belongs to experiment graph Time time Float Display computer time in milliseconds from e the start of the experiment when the message is sent Start Time StartTime Float Display computer time in milliseconds from i in the start of the experiment when this action Starts Clear Input clearInputQueue Boolea If true all events from input queues are flushed Queues S n when the action 1s started This includes all Experiment Builder triggers such as keyboard mouse TTL and EyeLink inputs button saccade fixation This results in upcoming Triggers only f
489. xt editor in the library manager The following table summarizes the tools available for code editing using the built in custom class editor Experiment TestClass py RECORDING BLOCK Ala exBa haa 0 h jimport sreb 2 class CustoullassTenplate areb EB0bject Gee init WserEk sreb EB bject init sel self propertyl 1 property of Integer type This 13 also a read wri aell property jl read only point property Note the setter missing self property3 l 2 3 read only color property Wore the setter missing aell propertyg4 1 0 read and write property of double type also will selft propertyS sreb EBPoint lO0 200 read write point property Note th self propertye6 sreb EBColor 200 100 100 read write color property Noti selt property 1 abc self property6 read write eblist property Self propertys hello read write string property self myInternalattribute My Internal Attribute string property howevi Property propertyl 4 read and write integer type property def sethropertyl fae Le c ys selft propertyl c def getFropertyliself return self propertyl Property property 4 read only property The type will be treated as a point EBPoint def getProperty4 self return self propertye deft getPropertys selfi return self propertys Callable method using Execute action Note the default arquments and the doc string to let eb Enow what is the expected Tes
490. y The synchronization of audio and visual presentations 1s critical in some experiments When the DirectX is used for playing an audio clip the play sound action is done as quickly as possible however no timing certainty should be expected when using this audio driver If your experiment requires accurate audio timing the ASIO driver should be used The ASIO driver creates two audio buffers for each input or output channel When producing sounds one buffer is being played by the audio card while the other buffer is being filled with sound data by the Experiment Builder When the ASIO driver finishes playing its buffer the application and driver buffers are switched This means that sounds are actually produced at a short but highly predictable delay after the data is stored in the buffer Since the Creative Labs sound cards we recommended have a typical latency setting of 10 milliseconds this would have a buffer switch interval of 10 milliseconds and an output delay of 10 milliseconds The time that the clip was actually played will be accurately reported in the EDF file When using an ASIO driver e If the start of a sound has been commanded far enough in advance of the time the sound is to be played e g the PLAY_SOUND action is preceded by a TIMER trigger with a duration of greater than 20 ms the Experiment Builder software will be able to write the sound data in advance to the ASIO buffer and therefore the first sample of the clip will b
491. y rightAcceleratio n averageAccelerat ion Target Distance targetDistance Integer Target X Target Y targetX targetY SR Research Experiment Builder User Manual Eyes available in recording 0 for left eye for right eye 2 for both eyes Eye 0 for left eye for right eye whose data makes the current invisible boundary trigger fire Angular resolution at the current gaze position in screen pixels per visual degree along the x or y axis Gaze position of the triggering sample along the x axis for the left eye right eye and an average between the two Gaze position of the triggering sample along the y axis for the left eye right eye and an average between the two Left eye right eye or average pupil size in arbitrary units area or diameter as selected in the EyeLink device settings Left eye right eye or average sample velocity in degrees second 2 Left eye right eye or average sample acceleration in degrees second angle Float The angle of the eye movements when the trigger fires Distance between the target and camera 10 times the measurement in millimeters This option is for EyeLink Remote eye tracker only Returns MISSING_DATA 32768 if target is missing or if running a non Remote eye tracker X Y position of the target in camera coordinate This option is for EyeLink Remote eye tracker only Returns 2004 2011 SR Research Ltd 332 MISS
492. yS sceussriniedencs nea ierinhanateseouaeviaiees 311 Loading Resources to Image Library ensssssssoeeessssssseeresssssssserresssss 312 Addins Text to Display Sofeeh escena a 313 Referring Text to Be Shown to Data SOuUrCe nessssssssseeessssssseseeeees 314 Editine Recordo SEQUENCE ies sagicscn aaea TER 315 Accessing the Subattribute of the TriggeredData Attrbiute 316 Loading Feedback Audio CLDpS ccccccccccccseeessssseeccccesseeessseeeeeceeenaas 317 send Results toa Result Pile sitsstauscasnnethceseennhacessauiadianegaseneeteiereeseheenaae 318 Addins Variables to Results Pile xiscsiascvesssansiotcetvcreanierateveinaheiney 319 Accessing the Experiment Builder Preference Settings 0008 325 Experiment Builder User Manual 2004 2011 SR Research Ltd xi 1 Introduction The SR Research Experiment Builder SREB is a visual experiment creation tool for use by Psychologists and Neuroscientists on Windows and Mac OS X The SREB is designed to be easy to use while maintaining a high degree of flexibility This unique design combination allows for a wide range of experimental paradigms to be created by someone with little or no programming or scripting expertise When used in combination with the SR Research EyeLink eye tracking system the SREB provides seamless integration into the EyeLink hardware and software platform 1 1 Features The SR Research Experiment Builder provides a
493. ycle Dataline action can be used to recycle a trial and rerun it at a later time The following graph illustrates the case of recycling the trial if the subject press button 5 Note A dummy action should be added to the false branch of the conditional trigger SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 107 ONDITTIONAL RECYCLE DISPLAY _SCREEW fi ONDITTIONAL RECYCLE ime r Loo i i o EL_BUTTON Attribute EL_BUTTON triggeredD value F And Or Select Attribute 2 Properties emme dS Pas Scuce RIAL DasSouce Figure 7 26 Using Recycle Dataline Action CONDITTIONAL_RECYCLE 7 9 19 Execute Action Execute action Zh is used to execute methods defined in custom class Reference EXECUTE Type NR The type of Experiment Builder objects Execute the current node belongs to Node Path Path of the node in the experiment graph Message to be sent to EDF file in an EyeLink SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 108 experiment or messages txt in a non EyeLink experiment with Save Messages attribute of the Experiment node checked when the action is done Time time Float Display computer time in milliseconds from the start of the experiment when the action is done Start Time StartTime Float Display computer time in milliseconds from the start of the experiment when record sound control action begins Clear I
494. ye LnKO BUO see ah ied acts alone ati ae 344 EL COGS pitasin N atin 344 TARIS Keyboard esirced sian dimasuy sured siendenedub sutadaiandtmecuy sidedaismdemedub adeddiandtnnsuesetediiendennatl 344 VAIO VIOUS etecias si cusna date aia eer areeaa sate ele cd nee aren eee 344 eae amma Wd UD Rael a ces degree meee bree ecemee ners otc tame mtr breuete nme mt yon cen mrt mer men Poet nm 344 jet UA Ero E lt 2 6 0 AE orange cere erm re E A A E cre re 344 Melek Sacide nera a a nana nea eaten cen meaarateeeene en eeeanere 344 SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd vi t20 sine VW ClOCM E batt ieansemette 344 Mails SN OUCS HNC a a a ered boats checerenti nics uate ren en scteaatensi ts 344 17 122 Display Scree i 23s cuss seated ecuecaiieates AN 344 S DAP E OTE Ee E E A E A 344 LELA Canine ta oe UD AE 344 17 125 Send EyeLinKkO MESSA Cuinne ena i 345 TAL Send Commandera A 345 ee SETE Eea E E E R 345 W728 Addto Experiment LO cenciosi 345 TEIZ UPC ADU a a E eatin alacant cinta 345 17 130 Addo Accumulo epea tate ben teteuialvandaahmies 345 ILo Addo Resul File a 345 TEL Propa SCQUCICe e a a ee ke eee 345 ILS SeU Eaa A Meee oa decena eee eae de 345 PMO Reset Node eracisnstnosun sires ssandencaun EE E E 345 PLoS Payo oe A 345 IAL lay sound Contolera e ata ee eames 345 CARS Record Soiden a a A ee te 345 17 138 Record Sound Co nfolas roeien a E E Seas 345 1AL9 Terminates x Perimemt ern E ORES 345 AA
495. ze Sets the maximum number of voicekey events that can be cached in the voicekey event queue e Voicekey Event Count voicekeyEventCount Returns total number of voicekey events cached in the event queue e Voicekey Threshold voicekeyThreshold Value from 0 0 to 1 0 to set voicekey trigger level with 1 0 being the maximum audio level The threshold should be set high enough to reject noise and prevent false triggering but low enough to trigger quickly on speech A threshold of 0 05 to 0 10 is typical SR Research Experiment Builder User Manual 2004 2011 SR Research Ltd 335 Properties applicable to ASIO Driver e Minimum Scheduling Latency minimumSchedulingLatency The minimum amount of delay in milliseconds is required for the audio to be played at the intended scheduled time 17 1 4 Cedrus oo Preferences S f Preferences O o o e O oO Devices ABE EVELINK E DIsPLay AUDIO bites B MGLSE oc KEYBOARD z ie TE exe BLITTONBOX AE Nodes a Screen e Build Deploy S GUI l Restore Factory Default Save Properties as Default Import From File Save Into File Debounce Time Sets the Cedrus button debounce time in milliseconds Button responds immediately to the first change Any change in button status following this is ignored for the amount of time set in this field 17 1 5 Keyboard oot Preferences i af Preferences El ai Experiment Key Down In

SR Research Experiment Builder User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents