User Manual: Inquisit Flanker Squared Task

>
___________________________________________________________________________________________________________________	

								      Flanker Squared
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 05-22-2024
last updated:  06-20-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 06-20-2024 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of the FlankerSquared task designed by Burgoyne et al (2023).
The flankerSquared task is part of a 'squared' test battery designed by Burgoyne et al (2023).
These tasks are designed to provide an additional level of conflict (thus, the 'squared' part of the name)
as well as a quick administration time compared to the more traditional designs of their respective tasks.

Reference:											
Burgoyne, A. P., Tsukahara, J. S., Mashburn, C. A., Pak, R., & Engle, R. W. (2023). 
Nature and Measurement of Attention Control. 
Journal of Experimental Psychology. General, 152(8), 2369–2402. 
https://doi.org/10.1037/xge0001408

Task made available at: https://osf.io/7q598/

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

Participants view a top stimulus (the 'target') which is a string of five arrow heads.
The outside arrows (the flankers) always point in the same direction but the middle
arrow can point in the opposite direction: →→→→→, ←←←←←, →→←→→, ←←→←←.

Below the target, participants get two response options:
a left response stimulus displaying a string of five arrows and a right response 
stimulus displaying a string of five arrows (left and right stimuli are orthogonal to
each other)

Participants are asked to match the direction of the outside arrows (the flankers)
of the target stim to the middle arrow of one of the response stims.

The setup of the targets/response options fall into four different congruence categories:
"FullyCongruent": middle and flanker arrows point in the same direction for the target and the response stims
"StimCongruent": middle and flanker arrows point in the same direction for the target but in opposite directions for the response stims
"StimIncongruent": middle and flanker arrows point in opposite direction for the target but in the same directions for the response stims
"FullyIncongruent": middle and flanker arrows point in the opposite direction for the target and the response stims

___________________________________________________________________________________________________________________	
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: 'flankerSquared_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:					with the current subject id
group: 						with the current group id
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. 
								
test:						0 = practice phase; 1 = test phase								
								
congruence:					"FullyCongruent": middle and flanker arrows point in the same direction for the target and the response stims
							"StimCongruent": middle and flanker arrows point in the same direction for the target but in opposite directions for the response stims
							"StimIncongruent": middle and flanker arrows point in opposite direction for the target but in the same directions for the response stims
							"FullyIncongruent": middle and flanker arrows point in the opposite direction for the target and the response stims

targetStim:					the top stimulus (consisting of five arrow heads)
targetFlankerArrow:			stores the flanker arrows of the target Stim	
			
leftStim:					the complete arrow string on the left response button
leftMiddleArrow:			the arrowhead of the middle arrow of the left stimulus
rightStim:					the complete arrow string on the right response button
rightMiddleArrow:			the arrowhead of the middle arrow of the right stimulus

corrResp:					the currently correct response button (left or right)
							correct => the response stimulus whose middle arrow matches the target flankers
							
responseTimeOut:			the current response timeout (in ms) of the trial

blockScore:					the total score obtained in the current block
stop:						0 = block continues; 1 = block stop criterium has been reached	

//built-in variables:					
response:					the response of participant (left or right; 0 = timed out response)
correct:					correctness of response (1 = correct, 0 = error)
latency:					response latency (in ms); measured from: stim onset


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

practiceFinalScore:			the number of points earned during practice 

/////////////////test trials only:
totalTrialCount: 			total number of test trials run (Excluded: last time that is timed-out)
finalScore:					the number of points earned during the test phase
meanCorrRT:					mean correct response time (in ms) overall


//by congruence:
fullyCongruentTrialCount: 	total number of 'fully congruent' test trials run (Excluded: last time that is timed-out) 	
fullyCongruentFinalScore:	the number of points earned for 'fully congruent' test trials
fullyCongruentMeanCorrRT:	mean correct response time (in ms) for 'fully congruent' test trials

stimCongruentTrialCount: 	total number of 'stim congruent' test trials run (Excluded: last time that is timed-out) 	
stimCongruentFinalScore:	the number of points earned for 'stim congruent' test trials
stimCongruentMeanCorrRT:	mean correct response time (in ms) for 'stim congruent' test trials

stimIncongruentTrialCount: 	total number of 'stim incongruent' test trials run (Excluded: last time that is timed-out) 	
stimIncongruentFinalScore:	the number of points earned for 'stim incongruent' test trials
stimIncongruentMeanCorrRT:	mean correct response time (in ms) for 'stim incongruent' test trials

fullyIncongruentTrialCount: total number of 'fully incongruent' test trials run (Excluded: last time that is timed-out) 	
fullyIncongruentFinalScore:	the number of points earned for 'fully incongruent' test trials
fullyINcongruentMeanCorrRT:	mean correct response time (in ms) for 'fully incongruent' test trials 
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

1. Instruction block with one 'fully incongruent' example (can be repeated as often as necessary)

2. Practice block: runs for 30 seconds (see editable parameters)
- randomly without replacement selects from 4 different congruence options:
fully congruent, stim congruent, stim incongruent, fully incongruent
(reset after all congruence options have been selected)
-> each congruence type then randomly without replacement selects from four possible variants 
- each response receives visual and auditory feedback for 200ms (see editable parameters)
- if the last trial was timed-out, the block stops

3. Instruction block with one 'fully incongruent' example (can be repeated as often as necessary)

4. Test block: runs for 90 seconds (see editable parameters)
- randomly without replacement selects from 4 different congruence options:
fully congruent, stim congruent, stim incongruent, fully incongruent
(reset after all congruence options have been selected)
-> each congruence type then randomly without replacement selects from four possible variants 
- each response receives visual and auditory feedback for 200ms (see editable parameters)
- if the last trial was timed-out, the block stops

Note: summary variables for the test are based on completed trials only (timed-out trial is not
considered for correct and incorrect counts)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________

different versions of the task as well as stimuli used by Burgoyne et al (2023) provided at:
https://osf.io/7q598/.
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________

different versions of the task as well as stimuli used by Burgoyne et al (2023) provided at:
https://osf.io/7q598/.

Instructions were modelled based on the provided eprime script
___________________________________________________________________________________________________________________	
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: