User Manual: Inquisit Emotional Stroop Test - ABCD Consortium - Keyboard Input


___________________________________________________________________________________________________________________	

									ABCD Emotional Stroop (keyboard version2)
								-'good' key on the right, 'bad' key on the left-
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 04-26-2017
last updated:  10-17-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 10-17-2023 Millisecond Software

This script has been made available to the Millisecond Software Library by the ABCD Research Consortium.
The script was originally designed for ABCD to be run on ipads and 
was adapted by Millisecond to run with keyboards for the Millisecond Library.

In this script the 'good' key is on the right and the 'bad' key is on the left.

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This Inquisit script implements an Emotional Stroop Script designed for a touchcreen.
The Inquisit script is based on an existing e-prime script by: Dr. Marie Banich

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants categorize words as "good" feeling (happy, joyful) or a "bad" feeling (angry, upset).
The words are presented on the top or bottom of images. The image either show a word congruent face emotion
(e.g. "happy" face paired with word "joyful") or an incongruent one (e.g. "happy face" paired with word "angry").
Images depict happy and angry emotions of teens.
Participants work through 2 test blocks: one block presents 25% incongruent pairings and 75% congruent pairings,
and the other block presents an equal number of congruent and incongruent pairings. Block order is determined randomly.

In this script, the response button for 'bad' is located on the left side and the response button for 'good' is located
on the right side of the screen.

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

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

(1) Raw data file: 'abcdemotionalstroop_ln_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.
								
keyAssignment:					"leftnegative" => left response key is negative; right response key is positive								
									
wordPosition:					1 = word appears on top; 2 = word appears on bottom
wordY:							stores the vertical coordinate of the current word (in % of canvas height)
congruence:						1 = congruent; 2 = incongruent (emotion word and emotion image depict opposite emotions)
selectStim:						itemnumber of selected stimulus

stimulusitem.1-:				the presented stimuli in order of trial presentation
stimulusItem.3:					1) an empty stimulus (clearScreen)
								2) presented image
								3) presented word
										
correctButton:					stores the correct response button for the current trial

response:						the participant's response (scancode of response key)
								16 = Q = left ("bad")
								25 = P = right ("good")

correct:						accuracy of response: 1 = correct response; 0 = otherwise
latency: 						the response latency (in ms); measured from: onset of image/word pair
list.accuracy.mean:				proportion correct of current block		


(2) Summary data file: 'abcdemotionalstroop_ln_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)
								
keyAssignment:					"leftnegative" => left response key is negative; right response key is positive								
																
accPractice1:					proportion correct in final practice1 run
practice1Runs:					number of practice1 runs needed
accPractice2:					proportion correct in final practice2 run
practice2Runs:					number of practice2 runs needed

accAll:						proportion correct overall (across all test trials)
accMoreCongruent:				proportion correct in "more congruent pairings" block
accMoreCongruentCongruent:		proportion correct on congruent trials in "more congruent pairings" block
accMoreCongruentIncongruent:	proportion correct on incongruent trials in "more congruent pairings" block
accEqual:						proportion correct in "equal numbers of congruentincongruent pairings" block
accEqualCongruent:				proportion correct in "equal numbers of congruentincongruent pairings" block
accEqualIncongrent:			proportion correct in "equal numbers of congruentincongruent pairings" block
accCongruent:					proportion correct in "congruent" pairings trials (across test blocks)
accIncongruent:				proportion correct in "incongruent" pairings trials (across test blocks)
strConHapfEqualAcc:			proportion correct of congruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
strConAngfEqualAcc:			proportion correct of congruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
strIncHapfEqualAcc:			proportion correct of incongruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
strIncAngfEqualAcc:			proportion correct of incongruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
strConHapf75ConAcc:			proportion correct of congruent 'happy face' trials in "more congruent pairings" block
strConAngf75ConAcc:			proportion correct of congruent 'angry face' trials in "more congruent pairings" block
strIncHapf75ConAcc:			proportion correct of incongruent 'happy face' trials in "more congruent pairings" block
strIncAngf75ConAcc:			proportion correct of incongruent 'angry face' trials in "more congruent pairings" block

meanRTAll: 					mean correct latency (in ms) overall
meanRTMoreCongruent:			mean correct latency (in ms) in "more congruent pairings" block
meanRTMoreCongruentCongruent:	mean correct latency (in ms) on congruent trials in "more congruent pairings" block
meanRTMoreCongruentIncongruent:mean correct latency (in ms) on incongruent trials in "more congruent pairings" block
meanRTEqual:					mean correct latency (in ms) in "equal numbers of congruentincongruent pairings" block
meanRTEqualCongruent:			mean correct latency (in ms) in "equal numbers of congruentincongruent pairings" block
meanRTEqualIncongruent:		mean correct latency (in ms) in "equal numbers of congruentincongruent pairings" block
meanRTCongruent:				mean correct latency (in ms) in "congruent" pairings trials (across test blocks)
meanRTIncongruent:				mean correct latency (in ms) in "incongruent" pairings trials (across test blocks)
strConHapfEqualRT:			mean correct response times (in ms) in congruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
strConAngfEqualRT:			mean correct response times (in ms) in congruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
strIncHapfEqualRT:			mean correct response times (in ms) in incongruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
strIncAngfEqualRT:			mean correct response times (in ms) in incongruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
strConHapf75ConRT:			mean correct response times (in ms) in congruent 'happy face' trials in "more congruent pairings" block
strConAngf75ConRT:			mean correct response times (in ms) in congruent 'angry face' trials in "more congruent pairings" block
strIncHapf75ConRT:			mean correct response times (in ms) in incongruent 'happy face' trials in "more congruent pairings" block
strIncAngf75ConRT:			mean correct response times (in ms) in incongruent 'angry face' trials in "more congruent pairings" block

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

1. Practice Block: 8 trials selected from 6 possible combinations
=> feedback provided
=> practice block is repeated if proportion correct of the last 8 trials is < 75%

2. Practice Block: 4 trials (good-top-congruent, good-bottom-incongruent, bad-bottom-congruent, bad-top-incongruent)
=> feedback provided
=> practice block is repeated if proportion correct is < 100%


3. 2 Test Blocks: 

(1) More Congruent Pairings: 48 trials - order of trials randomly determined
-36 congruent word valence - pic valence pairings (fixed pairs)
-12 incongruent word valence - pic valence pairings (fixed pairs)
	- half the words appear on top of image, the other on the bottom
 
(2) Equal number of congruent and incongruent pairings
-24 congruent word valence - pic valence pairings (fixed pairs)
-24 incongruent word valence - pic valence pairings (fixed pairs)
	- half the words appear on top of image, the other on the bottom
	
Trial Sequence:
Word/image (for: 2000ms) -> ITI: 1500ms (during practice: ITI provides feedback for 2000ms)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
provided by ABCD research consortium.
pictures taken from: The NIMH Child Emotional Faces Picture Set (NIMH-ChEFS)
http://devepi.duhs.duke.edu/NIMH_Pictures.html

*position of words on images as well as size of words and images can be edited under section Editable Parameters 
*words are presented in cyan with a black shadow

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by ABCD research consortium - can be edited under section Editable Instructions

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

Duration Parameters:
/wordPresentationTimePractice:					word duration (in ms) during practice trials (default: 2500ms)
/feedbackDuration:								feedback duration (in ms) during practice
/wordPresentationTimeTest:						word duration (in ms) during test trials (default: 2500ms)
/iti:											intertrial interval (in ms) between test trials (default: 1500ms)
/readyDuration:									duration (in ms) of ready trial (default: 3000ms)

interface:
/wordSize:										sizing of words proportional to canvas height (default: 5%)
/picSize:										sizing of images proportional to canvas height (default: 45%)
/topY:											vertical coordinate of top word in relation to canvas (default: 40%)
/bottomY:										vertical coordinate of bottom word in relation to canvas (default: 60%)
													Note: top of canvas = 0%; bottom of canvas = 100%

/leftResponseKey:								the left response key (default: "Q")
/rightResponseKey:								the right response key (default: "P")