Return to the Emotional Stroop Test - ABCD Consortium - Touch Input page
___________________________________________________________________________________________________________________	

									ABCD Emotional Stroop (Version 2)
							- 'good' button on the right, 'bad' button on the left-
___________________________________________________________________________________________________________________

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

Script Copyright © 03-13-2020 Millisecond Software

This script has been made available to the Millisecond Software Library by the ABCD Research Consortium.
The script was designed to be run on ipads.

___________________________________________________________________________________________________________________
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_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
script.sessionid:					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. 
									
values.wordposition:				1 = word appears on top; 2 = word appears on bottom
values.word_y:						stores the vertical coordinate of the current word (in % of canvas height)
values.congruence:					1 = congruent; 2 = incongruent (emotion word and emotion image depict opposite emotions)
values.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
										
values.correctButton:				stores the correct response button for the current trial
response:							the participant's response (selected response button)
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_summary*.iqdat' (a separate file for each participant)*

computer.platform:					the platform the script was run on (win/mac/ios/android)
script.startdate:					date script was run
script.starttime:					time script was started
script.subjectid:					assigned subject id number
script.groupid:						assigned group id number
script.sessionid:					assigned session id number
script.elapsedtime:					time it took to run script (in ms); measured from onset to offset of script
script.completed:					0 = script was not completed (prematurely aborted); 
									1 = script was completed (all conditions run)
								
								
values.keyAssignment:						"leftnegative" => left response key is negative; right response key is positive
								

values.ACC_practice1:						proportion correct in final practice1 run
values.practice1Runs:						number of practice1 runs needed
values.ACC_practice2:						proportion correct in final practice2 run
values.practice2Runs:						number of practice2 runs needed

expressions.ACC_all:						proportion correct overall (across all test trials)

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

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

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

expressions.meanRT_all: 					mean correct latency (in ms) overall

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

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

expressions.meanRT_congruent:				mean correct latency (in ms) in "congruent" pairings trials (across test blocks)
expressions.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: order of blocks randomly determined

(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%
													
/responsebuttonSize:					proportional sizing of response buttons (default: 8%)