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:  05-18-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 05-18-2022 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 FILE INFORMATION 
___________________________________________________________________________________________________________________ 
The default data stored 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
word_y:							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
								
ACC_practice1:					proportion correct in final practice1 run
practice1Runs:					number of practice1 runs needed
ACC_practice2:					proportion correct in final practice2 run
practice2Runs:					number of practice2 runs needed

ACC_all:						proportion correct overall (across all test trials)

ACC_moreCongruent:				proportion correct in "more congruent pairings" block
ACC_moreCongruentCongruent:		proportion correct on congruent trials in "more congruent pairings" block
ACC_moreCongruentIncongruent:	proportion correct on incongruent trials in "more congruent pairings" block

ACC_equal:						proportion correct in "equal numbers of congruentincongruent pairings" block
ACC_equalCongruent:				proportion correct in "equal numbers of congruentincongruent pairings" block
ACC_equalIncongruent:			proportion correct in "equal numbers of congruentincongruent pairings" block

ACC_congruent:					proportion correct in "congruent" pairings trials (across test blocks)
ACC_incongruent:				proportion correct in "incongruent" pairings trials (across test blocks)

meanRT_all: 					mean correct latency (in ms) overall

meanRT_moreCongruent:			mean correct latency (in ms) in "more congruent pairings" block
meanRT_moreCongruentCongruent:	mean correct latency (in ms) on congruent trials in "more congruent pairings" block
meanRT_moreCongruentIncongruent:mean correct latency (in ms) on incongruent trials in "more congruent pairings" block

meanRT_equal:					mean correct latency (in ms) in "equal numbers of congruentincongruent pairings" block
meanRT_equalCongruent:			mean correct latency (in ms) in "equal numbers of congruentincongruent pairings" block
meanRT_equalIncongruent:		mean correct latency (in ms) in "equal numbers of congruentincongruent pairings" block

meanRT_congruent:				mean correct latency (in ms) in "congruent" pairings trials (across test blocks)
meanRT_incongruent:				mean correct latency (in ms) in "incongruent" pairings trials (across test blocks)

* separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section
"DATA" and follow further instructions

___________________________________________________________________________________________________________________	
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:
/wordPresentationTime_practice:					word duration (in ms) during practice trials (default: 2500ms)
/feedbackDuration:								feedback duration (in ms) during practice
/wordPresentationTime_test:						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%)
/top_y:											vertical coordinate of top word in relation to canvas (default: 40%)
/bottom_y:										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")