User Manual: Inquisit Emotional Stroop Test - ABCD Consortium - Touch Input on ipads (in person testing)


						
___________________________________________________________________________________________________________________	

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

Script Copyright © 12-14-2022 Millisecond Software

This script has been made available to the Millisecond Software Library by the ABCD Research Consortium.
The script was optimized for ABCD to be run on ipads for in person testing.

Note: this script has been customized for the GENFI-NeuroDev Project under Dr. E. Finger
(verbal instructions removed)

Millisecond Software thanks Lisa Graf for generously sharing the German translations!

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

This script can be run on its own or in conjunction with script 'batch.iqx'.
The batch script counterbalances the assignment to
Stroop version one (lp = left positive) 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. "glücklich" face paired with word "freudig") or an incongruent one (e.g. "happy face" paired with word "wütend").
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)*

/testdate:						the testdate information entered at the start of testing
/id:							the id entered at the start of testing
/language:						the selected language

build:							Inquisit build
computer.platform:				the platform the script was run on (win/mac/ios/android)
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
blockcode, blocknum:			the name and number of the current block
trialcode, trialnum: 			the name and number of the currently recorded trial
									(Note: not all trials that are run might record data; by default data is collected unless /recorddata = false is set for a particular trial/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:					"glücklich" vs. "wütend"
/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 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)*

/testdate:						the testdate information entered at the start of testing
/id:							the id entered at the start of testing
/language:						the selected language

inquisit.version:					the version of Inquisit
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:					subject id number
script.groupId:						group id number
script.elapsedTime:					time it took to run script (in ms)

/completed:							0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)

/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 congruent/incongruent pairings" block
/ACC_equalCongruent:				proportion correct in "equal numbers of congruent/incongruent pairings" block
/ACC_equalIncongrent:				proportion correct in "equal numbers of congruent/incongruent 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 congruent/incongruent pairings" block
/Str_ConAngfEqual_ACC:				proportion correct of congruent 'angry face' trials in "equal numbers of congruent/incongruent pairings" block
/Str_IncHapfEqual_ACC:				proportion correct of incongruent 'happy face' trials in "equal numbers of congruent/incongruent pairings" block
/Str_IncAngfEqual_ACC:				proportion correct of incongruent 'angry face' trials in "equal numbers of congruent/incongruent 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 congruent/incongruent pairings" block
/meanRT_equalCongruent:				mean correct latency (in ms) in "equal numbers of congruent/incongruent pairings" block
/meanRT_equalIncongruent:			mean correct latency (in ms) in "equal numbers of congruent/incongruent 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 congruent/incongruent pairings" block
/Str_ConAngfEqual_RT:				mean correct response times (in ms) in congruent 'angry face' trials in "equal numbers of congruent/incongruent pairings" block
/Str_IncHapfEqual_RT:				mean correct response times (in ms) in incongruent 'happy face' trials in "equal numbers of congruent/incongruent pairings" block
/Str_IncAngfEqual_RT:				mean correct response times (in ms) in incongruent 'angry face' trials in "equal numbers of congruent/incongruent 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%)