Return to the Arrow Flanker Task page
						
										ARROW FLANKER TEST - keyboard input
SCRIPT INFO

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

Script Copyright © 08-13-2018 Millisecond Software


BACKGROUND INFO

											*Purpose*
This script implements an short arrow version of the Flanker Test based on 
the NIH toolbox Arrow Flanker Test used for adults 18+

http://www.healthmeasures.net/explore-measurement-systems/nih-toolbox/intro-to-nih-toolbox/cognition

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


											  *Task*
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). 


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

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

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
/practice:						0 = test block; 1 = practice block
/countPracticeBlocks:			counts the number of practice runs
blockcode, blocknum:			the name and number of the current block
trialcode, trialnum: 			the name and number of the currently recorded trial
									(Note: not all trials that are run might record data) 

/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)
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: 'shortarrowflankertest_kb_summary*.iqdat' (a separate file for each participant)

script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				subject id number
script.groupid:					group id number
script.elapsedtime:				time it took to run script (in ms)
computer.platform:				the platform the script was run on
/completed:						0 = script was not completed; 1 = script was completed (all conditions 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
/propcorrect_incongruent:		proportion correct for all incongruent trials
/meanrt_congruent: 				mean latency (ms) of correct responses to congruent targets
/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 4 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 10 congruent (5 left, 5 right) and 10 incongruent trials (5 left, 5 right)
(number of trials can be edited under section Editable Parameters)

Trial Sequence:
-> presents fixation star for parameters.fixationDuration (default: 1000ms)
-> presents 'middle' text reminder (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 are similar to the NIH toolbox Arrow Flanker Test.
Instruction text 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 star at the beginning of each trial (default: 1000ms)
/reminderDuration:						the duration (in ms) of the 'middle' reminder (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
/errorFeedbackDuration:					the duration (in ms) of error feedback during practice (default: 5000ms)
/correctFeedbackDuration:				the duration (in ms) of correct feedback during practice (default: 2000ms)
/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: 4)
											Note: needs to be divisible by 4
/maxPracticeRuns:						the maximum number of practice runs  (default: 3)
/numberTestTrials:						the number of test trials run (default: 20)
											Note: needs to be divisible by 4
																						
											
/ leftResponsekey:						scancode of the left response button (default: 16)
											-> Tools -> Keyboard Scancodes
/ leftResponsekey_label:				the label attached to the left response button (here: "Q")
/ rightResponsekey:						scancode of the right response button (default: 25)
/ rightResponsekey_label:				the label attached to the right response button (here: "P")	
										
Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Privacy Statement | Security Statement | GDPR