Return to the Inhibition of Return (IOR) page
___________________________________________________________________________________________________________________	

								INHIBITION OF RETURN (IOR)
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 04-29-2013
last updated:  03-09-2020 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 03-09-2020 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

Inhibition of Return (IOR) is considered an important part of visual search behavior by biasing attention
towards unexplored locations. This script implements a visual cued target detection paradigm to study IOR.
The implemented procedure is based on:
 
Abroms, B.D. & Fillmore, M.T. (2004). Alcohol-Induced Impairment of Inhibitory Mechanisms Involved in
Visual Search. Experimental and Clinical Psychopharmacology, 12, 243–250.

Millisecond Software thanks Dr.Fillmore for his generous support in developing this script!

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are asked to press a key when they see a white star (target) in a box either to the left or
the right of a center box. Before the target is presented, either the left or the right box is briefly
"lit" (=cue) to shift attention towards cued location and is then followed by a briefly "lit" center square 
to shift attention back to the center location.

After a certain timeframe (min. 300ms) btw. cue and target, participants tend to be SLOWER to attend to the 
cued location (aka detect the star) => Inhibition of Return											  

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 30 minutes to complete

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________	
The default data stored in the data files are:

(1) Raw data file: 'inhibitionofreturn_raw*.iqdat' (a separate file for each participant)

build:							The specific Inquisit version used (the 'build') that was run
computer.platform:				the platform the script was run on (win/mac/ios/android)
date, time, 					date and time script was run 
subject, group, 				with the current subject/groupnumber
script.sessionid:				with the current session id

blockcode, blocknum:			the name and number of the current block (built-in Inquisit variable)
trialcode, trialnum: 			the name and number of the currently recorded trial (built-in Inquisit variable)
									Note: trialnum is a built-in Inquisit variable; it counts all trials run; 
									even those that do not store data to the data file such as feedback trials
																			
values.condition:				different, same, catch
values.currentsoa:				the SOA of the current trial

parameters.targetduration:max duration of target trials (max time that star is presented, default: 1000ms)

response:						the participant's response (scancode of response button)
									57 = spacebar press
									0 = no response
										
correct:						the correctness of the response (1 = correct; 0 = incorrect)

latency: 						the response latency (in ms)
									same/different: measured from onset of target
									catch: measured from onset of imaginary target (default) OR from onset of cue
									(which one depends on chosen setting of parameters.measureCatchResponsesFromCueOnset)


(2) Summary data file: 'inhibitionofreturnn_summary*.iqdat' (a separate file for each participant)

computer.platform:				the platform the script was run on (win/mac/ios/android)
script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				assigned subject id number
script.groupid:					assigned group id number
script.sessionid:				assigned session id number
script.elapsedtime:				time it took to run script (in ms); measured from onset to offset of script
script.completed:				0 = script was not completed (prematurely aborted); 
								1 = script was completed (all conditions run)

expressions.propErrors_Same:		Proportion Erros for Same test trials
expressions.propErrors_Different:	Proportion Erros for Different test trials
expressions.propErrors_Catch:		Proportion Errors for Catch trials (when participant responded but should not have)

expressions.meanrt_same:		the mean latency (in ms) of correctly responding in Same test trials
expressions.meanrt_diff:		the mean latency (in ms) of correctly responding in Different test trials

expressions.meanrt_catch:		the mean latency (in ms) of correctly responding in Catch test trials
									catch latencies: measured from onset of 'imaginary' target (default) OR from onset of cue
									(which one depends on chosen setting of parameters.measureCatchResponsesFromCueOnset)
										
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
a) Design:  	2 cue-target associations (target in same box as cue, target in opposite box as cue) x 
				5 SOAs (stimulus onset asynchronies; time between onset of cue and onset of target)

b) Experimental Block: 
- presents 200 trials each for same/different condition (=> 40 per SOA)
- presents 100 catch trials (no target presentations, the target trials ends after 1000ms)
- after 250 trials a rest trial is presented for 60s (default); 10s before rest trial is over
a beep alerts participants that rest is coming to an end.

c) Practice Block:
- runs 30 trials

d) Trial Sequence:
cue-presentation trials:
-> present fixation cross for 500ms (0-500ms)
-> then present the slightly gray boxes for 500ms (500-1000ms)
-> then "light" up the left (or right) box for 20ms (1000-1020ms)  <= SOA starts at 1000ms
-> present the original slightly gray boxes for 10ms before (1020-1030ms)
-> lightening the centersquare for 20ms (1030-1050) 
-> present the original slightly gray boxes for values.soa_remaining (=SOA-50ms)

target-presentation trials:
-> present the target for max 1000ms
trial either ends automatically after the responsetimeout of 1000ms or if participant responds; whichever comes first

Notes: 
*catch trials: latencies can either be measured from onset of cues OR from onset of the 'imaginary' target
(similarly to the target trials, done by Abroms & Fillmore, 2004); see parameters.measureCatchResponsesFromCueOnset

__________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
PHYSICAL STIMULI DIMENSIONS
Abroms & Fillmore (2004) report specific cm dimensions of their stimuli. By default, this script codes
the dimensions of the stimuli in % of the screen height.
Go to EDITABLE CODE -> Editable Values and change parameters.runAbsoluteSizing to change to mm measurements

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions are not originals. Customize under EDITABLE CODE -> Editable Instructions

___________________________________________________________________________________________________________________	
EDITABLE CODE 
___________________________________________________________________________________________________________________	
check below for (relatively) easily editable parameters, stimuli, instructions etc. 
Keep in mind that you can use this script as a template and therefore always "mess" with the entire code 
to further customize your experiment.

The parameters you can change are:

Stimuli Dimensions/Placements
/runAbsoluteSizing:							true (1): absolute measurements (in mm) are used for the squares, 
													the star and the distances between squares
											false (0): canvas percentage measurements are used for the squares, 
													the star and the distances between squares (default)
												
/squareheight_perc:							canvas percentage size for the square (default: 20%)
/squareheight_in_mm:						absolute size in mm of the square (default: 40mm, see Abroms & Fillmore, 2004)

/starheight_perc:							canvas percentage size for the star (default: 10%)
/starheight_in_mm:							absolute size in mm of the star (default: 20mm, see Abroms & Fillmore, 2004)

/distance_perc:								canvas percentage size for the distance btw. peripheral square and center (default: 25%)
/distance_in_mm:							absolute size in mm for the distance btw. peripheral square and center (default: 70mm, see Abroms & Fillmore, 2004)

/fontheight:								the height of the fontheight in %screenheight (default: 10%)

/responsekey:								the response key (default: " " => spacebar)

/targetduration:							max duration of target trials (max time that star is presented, default: 1000ms)
/ITI:										intertrialinterval (default: 500ms)
/restduration:								the duration of a rest trial that is presented after 250 trials (default: 60000ms)

/measureCatchResponsesFromCueOnset:	1 (true): catch anticipatory responses are measured from cue onset (different from Abroms & Fillmore, 2004)
												0 (false): catch anticipatory responses are measured as in Abroms & Fillmore, 2004 (default)