User Manual: Inquisit Emotional Go / No-Go Task


___________________________________________________________________________________________________________________	

									Emotional Go/Nogo Task
									(Bulgarian Version)
___________________________________________________________________________________________________________________	


script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 03-01-2018
last updated:  09-25-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 09-25-2024 Millisecond Software

Bulgarian Translation generously shared by Dr. Jasmin Vassileva

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________

Go/Nogo Tasks are used as behavioral measures of inhibition. The Emotional Go/No Tasks leverages
this paradigm to investigate emotion processing, especially emotion recognition and emotion regulation.
The implemented procedure is based on:											

Tottenham, N., Hare, T.A. & and B. J. Casey, B.J. (2011). Behavioral assessment of emotion discrimination, emotion
regulation, and cognitive control in childhood, adolescence, and adulthood.
Frontiers in Psychology, doi: 10.3389/fpsyg.2011.00039.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants view images of fearful/happy/sad/angry or neutral facial expressions and are asked
to 
Condition 1: press the spacebar when they see a fearful face ("go") and only then (nogo images: neutral faces)
Condition 2: press the spacebar when they see a neutral face ("go") and only then (nogo images: fearful faces)
Condition 3: press the spacebar when they see a happy face ("go") and only then (nogo images: neutral faces)
Condition 4: press the spacebar when they see a neutral face ("go") and only then (nogo images: happy faces)
Condition 5: press the spacebar when they see a sad face ("go") and only then (nogo images: neutral faces)
Condition 6: press the spacebar when they see a neutral face ("go") and only then (nogo images: sad faces)
Condition 7: press the spacebar when they see a angry face ("go") and only then (nogo images: neutral faces)
Condition 8: press the spacebar when they see a neutral face ("go") and only then (nogo images: angry faces)

___________________________________________________________________________________________________________________	
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: 'emotionalgonogo_bulgarian_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. (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) 
										
condition:							practice, NF, FN, NH, HN, NS, SN, NA, AN (first letter = go stim; second letter = nogo)
goFaces:							"NEUTRAL" vs. "FEAR" vs. "happy" vs. "SAD" vs. "ANGRY" (current go faces)
noGoFaces:							"NEUTRAL" vs. "FEAR" vs. "happy" vs. "SAD" vs. "ANGRY" (current nogo faces)
iti:								current intertrial interval (default: 0)
image:								the presented image

response:							the participant's response: Scancode of response key
									57 = spacebar
									0 = no response
									(21 = Y; 49 = N)
									
correct:							accuracy of response: 1 = correct response; 0 = otherwise

responseOutcome:					go trials: HIT (correctly pressing response key), MISS (response key was not pressed); 
									nogo trials: FA (false alarm = incorrectly pressing response key), CR (correct rejection: response key was not pressed)
									
latency: 							the response latency (in ms) of the current trial (does not have to be a go, nogo trial)

responseTime:						response time (in ms) of current practice and test go/nogo trials, 
									measured from onset of image (Note: if no response, 'RT' is empty)
							
								
(2) Summary data file: 'emotionalgonogo_bulgarian_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)

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)
									
Note: this script does not remove outliers
Note: the following expressions calculate z-scores based on hit and FA rate.(see Gregg & Sedikides, 2010, p.148)
If the hit rate / FA rate is 0 => 0.005 is used instead
IF the hit rate / FA rate is 1.0 => 0.995 is used instead

reference:
Gregg, A. & Sedikides, C. (2010). Narcissistic Fragility:
Rethinking Its Links to Explicit and Implicit Self-esteem, Self and Identity, 9:2, 142-161 (p.148)

hitRate:				the overall  Hit rate across all blocks ( Hit = pressing spacebar for go stimuli)
missRate:				the overall Miss rate (1-hitRate)

faRate:					the overall Commissionrate across all blocks (Commissionrate = pressing spacebar for nogo stimuli)
						overall Commissionrate-rate = overall Commission Error = measure of overall cognitive control (Tottenham et al, 2011, p.3)
						The higher the commission error rate, the more often the nogo-response was not inbibited and thus
						the lower cognitive control of the response.

corrRejectRate:			the overall Correct Rejection rate (1-faRate)						
							
zHitRate:				the z-score of the overall  Hitrate										
zFARate:				the z-score of the overall Commissionrate rate

dPrime:					difference btw. (z_hitrate - z_FA): measure of Sensitivity 
							Note: This measure is the main measure for Emotion Recognition in this paradigm (Tottenham et al, 2011, p.3)
							The higher the value, the better signals (go stimuli) were overall separated from noise (nogo) stimuli.
							(d' = 0: chance performance)	
							Thus: the higher the value, the better overall Emotion Recognition.
																								
meanHitRT:				the overall mean Hit response time (in ms) 
sdHitRT:				standard deviation of the Hit response times across blocks (in ms)


hitRateNF:				the Hit rate in NF block  (NF = neutral go, fear nogo)
missRateNF:				the Miss rate in NF block
faRateNF:				the Commissionrate in NF block
corrRejectRateNF:		the Correct Rejection rate in NF block
zHitRateNF:				the z-score of the NF  Hitrate
zFARateNF:				the z-score of the NF Commissionrate-rate
dPrimeNF:				difference btw. (z_hitrate - z_FA) in NF block: measure of Sensitivity
cNF:					criterium measure
hitRTNF:				mean Hit response time (in ms) in NF block
								
hitRateFN:				the Hit rate in FN block  (FN = neutral go, fear nogo)
missRateFN:				the Miss rate in FN block
faRateFN:				the Commissionrate in FN block
corrRejectRateFN:		the Correct Rejection rate in FN block
zHitRateFN:				the z-score of the FN  Hitrate
zFARateFN:				the z-score of the FN Commissionrate-rate
dPrimeFN:				difference btw. (z_hitrate - z_FA) in FN block: measure of Sensitivity
cFN:					criterium measure
hitRTFN:				mean Hit response time (in ms) in FN block

(same for all other conditions)

faRateEmotions:			Commission Errors for erroneously responding to Nogo Emotion stimuli
							=> can be used a measure for Emotion Regulation (Tottenham et al, 2011, p.3),
							in this paradigm operationalized as the ability to inhibit responses
							to emotionally valanced stimuli. 
							=> The higher the commission rate, the lower the ability to regulate emotions.
								

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

Practice: optional (see parameters.runPractice)
* 10 trials (5 go, 5 nogo)
* script uses item.practice as the go-stimuli (default facial expression: surprise) and neutral as no-go
* provides feedback for 1000ms

Test: 
8 Conditions: order of conditions is randomly determined
FN: go = fear; nogo = neutral (by default: fear faces are repeated twice after reset; neutral faces are repeated once)
NF: go = neutral; nogo = fear (by default: neutral faces are repeated twice after reset; fear faces are repeated once)
HN: go = happy; nogo = neutral (by default: happy faces are repeated twice after reset; neutral faces are repeated once)
NH: go = neutral; nogo = happy (by default: neutral faces are repeated twice after reset; happy faces are repeated once)
SN: go = sad; nogo = neutral (by default: sad faces are repeated twice after reset; neutral faces are repeated once)
NS: go = neutral; nogo = sad (by default: neutral faces are repeated twice after reset; sad faces are repeated once)
AN: go = angry; nogo = neutral (by default: angry faces are repeated twice after reset; neutral faces are repeated once)
NA: go = neutral; nogo = angry (by default: neutral faces are repeated twice after reset; angry faces are repeated once)

* Each condition runs 30 trials (20 go trials, 10 nogo trial); trial order of go-nogo trials is generated at random
Note: this script runs 2/3 go trials, 1/3 nogo trials (Trottenheim et al al report 70%:30%)


Trial Sequence:

image (500ms) -> fixation cross (1000ms): response timeout after 1500ms
-> iti = 0 (see list.iti) (iti presents fixation cross)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
Trottenheim et al (2011, p. 2) used 10 adults (five females and five males) per facial expression.

The stimuli used in this scripts are placeholder stimuli only.
They can be edited under section Editable Stimuli.

The placeholder stimuli have the same image names as the following NIMSTIMS
for neutral (ne), happy (ha), sad (sa), fearful (fe) and angry (an) faces (all open mouth expressions)
female: 2, 5, 13, 14, 18
male: 21, 23, 24, 41, 42

practice stimuli (surprise (sp) and neutral (ne) expressions) are stand-ins for:
female: 1, 11, 15 
male: 32, 39

NOTE: The NIMSTIMS image files need to be converted to *png files (or the *png extensions used in this script need to be converted to *bmp )

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
provided by Millisecond Software - 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:

/fixationSize:					proportional sizing of fixation cross (relative to canvas height) (default: 10%)
/picSize:						proportional sizing of images (relative to canvas height) (default: 50%)

/runPractice:					true: script runs a short practice session with item.practice as the go items
								false: script does not run a practice session

/practiceFeedbackDuration:		the duration (in ms) of the practice Feedback (default: 1000ms)
/getReadyDuration:				the duration (in ms) of the 'ready' trial (default: 5000ms)
/startFixation:					the duration (in ms) of the first fixation cross in a block (default: 2500ms)
/endFixation:					the duration (in ms) of the last (red) fixation cross in a block (default: 2000ms)
/picDuration:					the duration (in ms) of the images (default: 500ms)
/responseDuration:				the response timeout (in ms), measured from onset of image (default: 1500ms)

/goKey:							the go-key (default: " " = spacebar)