User Manual: Inquisit Arrow Flanker Task based on Ridderinkhof et al (1997) (touchscreen)


___________________________________________________________________________________________________________________	

										ARROW FLANKER TEST - touchscreen input
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 03-28-2018
last updated:  02-22-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-22-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements an short arrow version of the Flanker Test,
an inhibition test to assess the ability to suppress inappropriate dominant responses
evoked by task irrelevant information.

References:

Ridderinkhof, K.R.; van der Molen, M.W.; & Band, G.P.H (1997). Sources of Interference from Irrelevant Information:
A Developmental Study. JOURNAL OF EXPERIMENTAL CHILD PSYCHOLOGY 65, 315–341.
(Note: Ridderinkhof et al. used a more extensive design of the arrow flanker test; the Inquisit
script only manipulates the direction of the center arrow) 

Note: The Inquisit arrowflankertest_touchscreen.iqx is designed to use on touchscreen devices but instructions
will adapt if no touchscreen is detected (in those cases the mouse is used instead)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants see 5 arrows in the middle of the screen inside a box. They have to decide whether the central arrow 
points right or left. The surrounding arrows (=flankers) either point in the same direction (congruent trials)
or in the opposite direction (incongruent trials). 

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

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

(1) Raw data file: 'arrowflankertest_touchscreen_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
session:								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. Thus, trialnum 
										may not reflect the number of main trials run per block. 

practice:								0 = test block; 1 = practice block										
blockcount:								counts the test blocks run										
countPracticeBlocks:					counts the number of practice runs									
trialcount:								counts all trials per block

congruence:								determines the state of the flankers 
										1 = congruent (target and flanker point in the same direction), 
										2 = incongruent (target points in opposite direction)
									
selecttarget:							itemnumber of the current target (center) stimulus
										1 = target points to right; 
										2 = target points to left
										
selectflanker:							itemnumber of the current flanker stimuli
response:								the participant's response (leftresponsebutton, rightresponsebutton)
correct:								the correctness of the response (0 = error or no response; 1 = correct)
latency: 								the response latency (in ms); measured from onset of target to response (or trial timeout)
rt_homebase:							the time (in ms) it took to press the homebase button; measured from onset of orange homebase

list.ACC_practice.mean:					the current proportion correct at this point in practice

practicePass:							1 = participant passed practice; 
										0 = participant did not pass practice									
									

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

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

blockcount:							number of test blocks run
countPracticeBlocks:				counts the number of practice runs		
list.ACC_practice.mean:				the proportion correct at the end of the last practice run

practicePass:						1 = participant passed practice; 
									0 = participant did not pass practice

propcorrect:						overall proportion correct (test trials only)				
meanrt:								overall mean latency (in ms) of correct responses (test trials only)

propcorrect_congruent:				proportion correct for all congruent trials
meanrt_congruent: 					mean latency (ms) of correct responses to congruent targets

propcorrect_incongruent:			proportion correct for all incongruent trials
meanrt_incongruent: 				mean latency (ms) of correct responses to incongruent targets

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
2 flanker congruence (congruent vs. incongruent), tested within

1-3 Practice Blocks: each block runs 8 trials with errorfeedback (number of trials can be edited under section Editable Parameters)
- participants have to get 75% correct to move on to the test block (proportion correct editable under section Editable Parameters)
- script is aborted after 3 unsuccessful practice runs (maximum number of practice runs editable under section Editable Parameters)

1 Test Block: runs 12 congruent (6 left, 6 right) and 12 incongruent trials (6 left, 6 right) (24 trials total)
(number of trials can be edited under section Editable Parameters)

Trial Sequence:
homeBase (waits for finger to press homeBase)
-> presents fixation star for parameters.fixationDuration (default: 1000ms)
-> presents the target and flanker and waits for response (default: response Timeout = 1750ms) 
Note: the selected response button is highlighted for 100ms

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
stimuli: 5 arrows pointing right or left (flanker, flanker, target, flanker, flanker)
Arrows can be edited under section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions provided by Millisecond Softare. They can be edited under section 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:

/fixationDuration:						the duration (in ms) of the fixation cross at the beginning of each trial (default: 1000ms)
/homeBaseReminder:						the delay (in ms) of the home base reminder if finger is not returned to home base (default: 2000ms)
/responseTimeout:						the response Timeout (ms); measured from onset of arrows (default: 1750ms)
											Note: to allow for infinite response time, remove /response = timeout(parameters.responseTimeout)
											from all relevant trials


/minPracticeACC:						the minimum proportion correct during a practice run that moves participant to the test (default: 0.75)
/numberPracticeTrials:					the number of practice trials per practice run (default: 8)
											Note: needs to be divisible by 4
/maxPracticeRuns:						the maximum number of practice runs  (default: 3)
/numberTestTrials:						the number of test trials run (default: 24)
											Note: needs to be divisible by 4