User Manual: Inquisit Stroop Squared


___________________________________________________________________________________________________________________	

								      Stroop Squared
									  (German instructions)
___________________________________________________________________________________________________________________	


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

Translation provided by K. Borchert for Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of the StroopSquared task designed by Burgoyne et al (2023).
The StroopSquared 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 word (the 'target') which is either the word 'RED' or 'BLUE' in either a 
red or a blue display color. Below the target, participants get two response buttons:
a left response button displaying the word 'RED' or 'BLUE' in either a 
red or a blue display color and a right response button displaying the word 'RED' or 'BLUE'
(opposite word from left) in either a red or a blue display color (color is opposite from left color).
Participants are asked to choose (mouse or touch) the response button that displays the semantic word 
that is congruent with the display color of the target word.
According to Burgoyne et al (2023) "the challenge is for participants to pay attention to the display
color of the target stimulus and the semantic meaning of the response options."

The setup of the targets/response options fall into four different congruence categories:
"FullyCongruent": target word and display color as well as response words and response display colors are congruent
"StimCongruent": target word and display color congruent BUT response words and response display colors are incongruent
"StimIncongruent": target word and display color are incongruent BUT response words and response display colors are congruent
"FullyIncongruent": target word and display color are incongruent AND response words and response display colors are incongruent

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

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

(1) Raw data file: 'stroopsquared_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": target word and display color as well as response words and response display colors are congruent
							"StimCongruent": target word and display color congruent BUT response words and response display colors are incongruent
							"StimIncongruent": target word and display color are incongruent BUT response words and response display colors are congruent
							"FullyIncongruent": target word and display color are incongruent AND response words and response display colors are incongruent


targetWord:					the top word (RED or BLUE)
targetColor:				the display color of the target word (red or blue)	
			
leftWord:					the response word on the left response button
leftColor:					the display color of the response word on the left response button
rightWord:					the response word on the right response button
rightColor:					the display color of the response word on the right response button

corrResp:					the currently correct response button (left or right)
							correct => the response stimulus whose semantic meaning matches the target color

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

//for debugging purposes:
text.left.textColor:		stores the color code for the left text item (#ff0000 = red; #0000ff = blue)
text.right.textColor:		stores the color code for the right text item


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