User Manual: Inquisit Simon Squared

>
___________________________________________________________________________________________________________________	
										
										Simon 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 SimonSquared task designed by Burgoyne et al (2023).
The SimonSquared 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') - an arrow pointing left or right- on 
the left or right side of the screen.

Below the target, participants get two response options:
a left response stimulus displaying the words LEFT or RIGHT and a right response 
stimulus displaying LEFT or RIGHT (left and right stimuli are orthogonal to
each other)

Participants are asked to match the direction of the target arrow
to the semantic label of the response buttons.
Afterwards they briefly receive feedback before the task continues.

The setup of the targets/response options fall into four different congruence categories:
"FullyCongruent": target arrow direction and screen position as well as semantic label and screen position are congruent
"StimCongruent": target arrow direction and screen position are congruent but semantic label and screen position are incongruent
"StimIncongruent": target arrow direction and screen position are incongruent but semantic label and screen position are congruent
"FullyIncongruent": target arrow direction and screen position as well as semantic label and screen position are incongruent

___________________________________________________________________________________________________________________	
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: 'simonSquared_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 arrow direction and screen position as well as semantic label and screen position are congruent
							"StimCongruent": target arrow direction and screen position are congruent but semantic label and screen position are incongruent
							"StimIncongruent": target arrow direction and screen position are incongruent but semantic label and screen position are congruent
							"FullyIncongruent": target arrow direction and screen position as well as semantic label and screen position are incongruent

targetStim:					the top stimulus: 0 = left pointing arrow; 1 = right pointing arrow
targetImage:				stores the presented image of the target arrow 
targetPositionPct:			stores the screen position of the target arrow in canvas width percentages
								25%: presented on the left side
								75%: presented on the right side
			
leftStim:					the response word on the left response button
rightStim:					the response word on the right response button

corrResp:					the currently correct response button (left or right)
							correct => the response stimulus whose middle arrow matches the target simons
							
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: 'simonSquared_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 two 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 two 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: