User Manual: Inquisit Manikin Task


___________________________________________________________________________________________________________________	

						*STIMULUS RESPONSE COMPATIBILITY TASK (SRCT)*
___________________________________________________________________________________________________________________	

Script Author: original Inquisit script written by Barkby et al (2012)
last updated:  10-16-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a Stimulus Response Compatibility Task (SRCT); a reaction time task used
to measure the speed of automatic approach/avoidance tendencies towards particular item categories.

The implemented procedure is described in:

Barkby, H., Dickson, J.M., Roper, L., & Field, M. (2012). To Approach or Avoid Alcohol? Automatic and Self-
Reported Motivational Tendencies in Alcohol Dependence. Alcoholism: Clinical and Experimental Research, 36, 
361-368.

Millisecond Software LLC thanks Dr. Matt Field for generously providing the original scripts as well
as the original stimuli!

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are presented with either an alcohol-related picture or a control picture. 
Depending on instructions, they are asked to press the arrow keys of the numeric
key pad (default, can be changed under EDITABLE VALUES) so as to move a manikin,
that is either presented above (top) or below (bottom) the picture,  towards (or away) from the alcohol related 
pictures and away (towards) the control pictures.

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

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

(1) Raw data file: 'srct_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.								
									
(parameter) responseKeyUp:		default scancode for the up-key (key "Y")
(parameter) responseKeyDown:	default scancode for the down-key (key "B")
(parameter) responseKeyLeft:	default scancode for the left-key (key "F")
(parameter) responseKeyRight:	default scancode for the right-key (key "J")

expCondition:	6 experimental conditions; subject assignment by groupnumber
				Experiment runs 3 main blocks (block.main_approach_alc, block.main_avoid_alc, block.main_left_alc/block.main_right_alc).
				The order of the 3 main blocks is counterbalanced across participants. 
				Furthermore, half the participants in each counterbalanced condition run block.main_right_alc, the other half
				run block.main_left_alc => 6 conditions
									
stimulus:						contains the name of the picture image

corrResponse:					stores the correct scancode response code

response:						the participant's response (scancode of response button)
								21 = Y
								48 = B
								33 = F
								36 = J

correct:						the correctness of the response (1 = correct; 0 = incorrect)
latency: 						the response latency (in ms)


(2) Summary data file: 'srct_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)
									
expCondition:	6 experimental conditions; subject assignment by groupnumber
				Experiment runs 3 main blocks (block.main_approach_alc, block.main_avoid_alc, block.main_left_alc/block.main_right_alc).
				The order of the 3 main blocks is counterbalanced across participants. 
				Furthermore, half the participants in each counterbalanced condition run block.main_right_alc, the other half
				run block.main_left_alc => 6 conditions
								
propCorrTotal:					overall proportion correct (test trials only)
meanRTTotal:					overall mean latency (in ms) of correct test trials

propCorrAlcApproach:			proportion correct Alcohol Approach test trials
meanRTAlcApproach:				mean latency (in ms) of correct Alcohol Approach test trials

propCorrAlcAvoid:				proportion correct Alcohol Avoid test trials
meanRTAlcAvoid:				mean latency (in ms) of correct Alcohol Avoid test trials

propCorrCtrlApproach:			proportion correct Control Approach test trials
meanRTCtrlApproach:			mean latency (in ms) of correct Control Approach test trials

propCorrCtrlAvoid:				proportion correct Control Avoid test trials
meanRTCtrlAvoid:				mean latency (in ms) of correct Control Avoid test trials

propCorrAlcLeft:				proportion correct Alcohol Left test trials
meanRTAlcLeft:					mean latency (in ms) of correct Alcohol Left test trials

propCorrAlcRight:				proportion correct Alcohol Right test trials
meanRTAlcRight:				mean latency (in ms) of correct Alcohol Right test trials

propCorrCtrlLeft:				proportion correct Control Left test trials
meanRTCtrlLeft:				mean latency (in ms) of correct Control Left test trials

propCorrCtrlRight:				proportion correct Control Right test trials
meanRTCtrlRight:				mean latency (in ms) of correct Control Right test trials


___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

Experiment runs 3 main blocks (block.main_approach_alc, block.main_avoid_alc, block.main_left_alc/block.main_right_alc).
The order of the 3 main blocks is counterbalanced across participants. 
Furthermore, half the participants in each counterbalanced condition run block.main_right_alc, the other half
run block.main_left_alc.
=> 6 experimental conditions, assignment by groupnumber (default, can be changed under EXPERIMENT)

Blocks:
1. block.main_approach_alc: move the manikin towards alcohol related pictures and away from control pictures
(in half the trials manikin is on top, in the other half the manikin is on the bottom)
2. block.main_avoid_alc: move the manikin away from alcohol related pictures and towards control pictures
(in half the trials manikin is on top, in the other half the manikin is on the bottom)
3a. block.main_left_alc: move the manikin to the left for alcholo related pictures and to the right for control pictures
(in half the trials manikin is on top, in the other half the manikin is on the bottom)
3b. block.main_right_alc: move the manikin to the right for alcholo related pictures and to the left for control pictures
(in half the trials manikin is on top, in the other half the manikin is on the bottom)

Each main block has 8 practice trials and 2 x 28 experimental trials (= 2 subblocks). For each subblock of each main block (e.g. block.main_approach_alc) 
the type of trial is randomly sampled  from the four corresponding trials (e.g. trial.AlcApproach_ManikinTop, trial.AlcApproach_ManikinBottom, trial.CtrlAvoid_ManikinBottom, trial.CtrlAvoid_ManikinTop) 
without replacement => 14 alcohol images and 14 control images are shown, 7 of each with the manikin on top and 7 with the manikin on the bottom.
Over the course of the 2 x 28 trials (= 2 subblocks), each picture appears twice (once in the first subblock, once in the second subblock), 
once with the manikin on top and once with the manikin on the bottom. 

Trials:
* A blank screen is shown for 1000ms, followed by the alcholol-related or control picture with a manikin on top or on the bottom
* a correct response is followed by showing a video of the manikin moving in the correct direction (duration: 1000ms)
* an incorrect response is followed by a red "X" in the middle of the screen (duration: 1000ms)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions are the originals. To edit go to section Editable Instructions.

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
14 alcohol related and 14 control pictures. 

!!! NOTE: The stimuli are culturally specific and may not work for a study outside the intended culture. 
To use your own images go to Editable Stimuli-> item.alcoholPics and item.controlPics
and substitute your own.

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

/responseKeyUp: = "Y"				default label for the up key (used in instructions)
/responseKeyDown: = "B"				default label for the down key (used in instructions)
/responseKeyLeft: = "F"				default label for the left key (used in instructions)
/responseKeyRight: = "J"			default label for the right key (used in instructions)