User Manual for Inquisit's Emotional Stroop Test - ABCD Consortium - Touch Input


						
___________________________________________________________________________________________________________________	

									ABCD Emotional Stroop (Version 2)
							- 'good' button on the right, 'bad' button on the left-
							
											(Smart Phone Version)
___________________________________________________________________________________________________________________
Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 10-12-2018
last updated:  03-01-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 03-01-2022 Millisecond Software

This script has been made available to the Millisecond Software Library by the ABCD Research Consortium.
The script (originally used on ipads) was updated/optimized for ABCD to be run on smart phones for remote testing.

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This Inquisit script implements an Emotional Stroop Script designed for a touchcreen (Note: this version
is specifically updated to run on smaller smart phones).
The Inquisit script is based on an existing e-prime script by Dr. Marie Banich.

This script can be run on its own or in conjunction with script 'remotetesting_instructions.iqx'.
'remotetesting_instructions.iqx': script that tests that the screen sizing roughly fits a smart phone.
The combined sequence is run by script 'batch.iqx'. The batch script also controls the assignment to
Stroop version one (lp = left position) and Stroop version two (ln = left negative).

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants categorize words as "good feeling" (happy, joyful) or "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.

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

information about the current screen size:
expressions.screenWidth_inmm 
expressions.screenHeight_inmm

date, time: 					date and time script was run 
subject, group: 				with the current subject/groupnumber
session:						with the current session id

keyAssignment:					"leftnegative" => left response key is negative; right response key is positive

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.

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)
faceemotion:					"happy" vs. "angry"
selectStim:						itemnumber of selected stimulus

stimulusitem:					the presented stimuli in order of trial presentation
								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 (selected response button)
correct:						accuracy of response: 1 = correct response; 0 = otherwise
latency: 						the response latency (in ms); measured from: onset of imageword 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)

information about the current screen size:
expressions.screenWidth_inmm 
expressions.screenHeight_inmm

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_equalIncongrent:			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)
Str_ConHapfEqual_ACC:			proportion correct of congruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
Str_ConAngfEqual_ACC:			proportion correct of congruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
Str_IncHapfEqual_ACC:			proportion correct of incongruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
Str_IncAngfEqual_ACC:			proportion correct of incongruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
Str_ConHapf75Con_ACC:			proportion correct of congruent 'happy face' trials in "more congruent pairings" block
Str_ConAngf75Con_ACC:			proportion correct of congruent 'angry face' trials in "more congruent pairings" block
Str_IncHapf75Con_ACC:			proportion correct of incongruent 'happy face' trials in "more congruent pairings" block
Str_IncAngf75Con_ACC:			proportion correct of incongruent 'angry face' trials in "more congruent pairings" block

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)
Str_ConHapfEqual_RT:			mean correct response times (in ms) in congruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
Str_ConAngfEqual_RT:			mean correct response times (in ms) in congruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
Str_IncHapfEqual_RT:			mean correct response times (in ms) in incongruent 'happy face' trials in "equal numbers of congruentincongruent pairings" block
Str_IncAngfEqual_RT:			mean correct response times (in ms) in incongruent 'angry face' trials in "equal numbers of congruentincongruent pairings" block
Str_ConHapf75Con_RT:			mean correct response times (in ms) in congruent 'happy face' trials in "more congruent pairings" block
Str_ConAngf75Con_RT:			mean correct response times (in ms) in congruent 'angry face' trials in "more congruent pairings" block
Str_IncHapf75Con_RT:			mean correct response times (in ms) in incongruent 'happy face' trials in "more congruent pairings" block
Str_IncAngf75Con_RT:			mean correct response times (in ms) in incongruent 'angry face' trials in "more congruent pairings" block

* 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: blocks tested in sequence

(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
Note: instructions are given verbally and visually

___________________________________________________________________________________________________________________	
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%)												

/test_setting = "remote"(don't change)