Return to the page
___________________________________________________________________________________________________________________	

										ARROW FLANKER TEST - keyboard input
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 08-13-2018
last updated:  05-26-2020 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 05-26-2020 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) 

The Inquisit Short Arrow Flanker Test-keyboard uses the keyboard instead of touchscreen input

___________________________________________________________________________________________________________________
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_keyboard_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. 

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

values.congruence:						determines the state of the flankers 
										1 = congruent (target and flanker point in the same direction), 
										2 = incongruent (target points in opposite direction)
									
values.selecttarget:					itemnumber of the current target (center) stimulus
										1 = target points to right; 
										2 = target points to left
										
values.selectflanker:					itemnumber of the current flanker stimuli

response:								the participant's response (scancode of response button)
										16 = Q = left
										25 = P = right

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)
list.ACC_practice.mean:					the current proportion correct at this point in practice

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

(2) Summary data file: 'arrowflankertest_keyboard_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)

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

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

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

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

expressions.propcorrect_incongruent:	proportion correct for all incongruent trials
expressions.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:
-> 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)
/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
/correctFeedbackDuration:					the duration (in ms) of correct feedback during practice (default: 1000ms)
/getReadyDuration:							the duration (in ms) of the get-ready trial (default: 3000ms)


/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
																						
											
/ leftResponsekey:							the left response button (default: "Q")
/ rightResponsekey:							the right response button (default: "P")