User Manual: Inquisit Visual Simon Task


___________________________________________________________________________________________________________________	

										*Visual Simon Task*
___________________________________________________________________________________________________________________

last updated:  10-12-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC
Script Copyright © 10-12-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a simple visual Simon Task, a measure of visuospatial attention and 
inhibitory control processes. The classic Simon Effects refers to the observation of 
stimulus-response compatibility: stimuli congruent in spatial location and response button location
(e.g. stimulus presented on the left screen and response button is located on the left side)
elicit faster responding than stimuli incongruent in spatial location and response button location
(e.g. stimulus presented on the left screen and response button is located on the right side).

The implemented procedure is based on:

Bialystok, E., Craik, F. I. M., Klein, R., & Viswanathan, M. (2004). Bilingualism, Aging, 
and Cognitive Control: Evidence From the Simon Task. Psychology and Aging, 19(2), 290-303.

original Simon Task:

Simon, J.R. & Wolf, J.D. (1963). Choice reaction times as a function of angular stimulus-response 
correspondence and age. Ergonomics, 6, 99-105.

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________	
Brief overview taken from Bialystok et al., 2004, p. 292 (slightly adapted):

Each trial begins with a fixation cross in the center of the screen that remains visible for 800 ms
and is followed by a 250-ms blank interval. At the end of this interval, a red or blue square appears 
on either the left or the right side of the screen and remains on the screen for 1,000 ms if there is 
no response. Participants are instructed to press the left 'A' key when they see a blue square 
and the right 'L' key when they see a red square. Response timing begins with the onset of the 
stimulus, and the response terminates the stimulus. There is a 500-ms blank interval before the onset 
of the next trial.

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

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	

(1) Raw data file: 'visualsimontask_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. 
										
countTrials:					trial count (resets after each practice session)										
										
congruence:						congruent (stim position and response button position on the same side) vs. incongruent
stimhpos:						left vs. right (the position of the stimulus on the screen)
stimType:						Blue Square vs. Red Square

response:						the participant's response (scancode of response key)
								30 = 'A' key
								38 = 'L' key
										
response:						left vs. right (the interpreted key response, 30 => left; 38 => right)
										
correct:						the correctness of the response (1 = correct; 0 = incorrect)
latency: 						the response latency in ms; measured from onset of stimulus


(2) Summary data file: 'visualsimontask_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)
									
propCorrect:					proportion correct across all test trials
meanRT:							mean latency of correct test trials in ms
propCorrectCongruent:			proportion correct of congruent test trials
meanRTCongruent:				mean latency of correct congruent test trials in ms
propCorrectIncongruent:		proportion correct of incongruent test trials
meanRTIncongruent:				mean latency of correct incongruent test trials in ms

simonEffect:					ms difference in "[mean corrRT Incongruent] - [mean corrRT Congruent]"
								positive value: participants responded faster when stimulus location and response button location 
								were congruent ("stimulus-response compatibility") => Simon Effect
								[negative value: participants responded faster when stimulus location and response button location 
								were incongruent]

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
The experiment begins with eight practice trials, and participants must complete all eight trials success-
fully to proceed to the experimental trials. If a mistake is made, participants are given additional
pratice trials until all eight trials are completed without error.
	
The following 28 experimental trials, half of which present the square on the same side as the associ-
ated response key (congruent trials) and half of which present the square on the opposite side 
(incongruent trials), are presented in a randomized order.	

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
red and blue square - size can be controlled via parameters.squaresize under section Editable Parameters

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions are not original to the task. They are provided by Millisecond Software
as htm/html pages and simple page elements and can be edited either by changing
the provided htm/html files or directly under Editable Instructions.
To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac)
or Notepad (Windows).

___________________________________________________________________________________________________________________	
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:

/responseKeyBlueLeft:			the left response button for a blue square (default: "A")
/responseKeyredRight:			the right response button for a red square (default: "L")

/fixationCrossDuration:		the duration of the fixation cross in ms (default: 800)
/isi:							the interstimulus interval between fixation cross and square in ms (default: 250)
/responseWindow:				the responsewindow/duration of square in ms (default: 1000)
/iti:							the intertrial interval in ms (default: 500)

/leftX:						the left square coordinate in % of screen canvas (default: 15%)
/rightX:						the left square coordinate in % of screen canvas (default: 85%)
/squareSize:					the square size in % of canvas height (default: 25%)