User Manual: Inquisit Partner GNAT


___________________________________________________________________________________________________________________	

										Partner GNAT Script
___________________________________________________________________________________________________________________	

last updated:  10-07-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 10-07-2024 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
											
This script implements a partner Go-Nogo Association Task (GNAT) using the category 'partner' as the target category.

In general, the GNAT procedure uses the Go-Nogo framework of responding to signal and noise stimuli to investigate implicit bias 
towards a target category. In contrast to reaction time based tests of implicit bias (e.g. Implicit Association Test), 
the GNAT framework mainly focuses on accuracy data and specifically d prime measures (measures of sensitivity to distinguish
signals from noise in signal detection theory) to infer implicit bias. 

For example, a positive association of 'partner' (the target signal) is suggested if the dprime measure in the condition
'Partner-Good' (aka both 'partner' and good attributes are signals) is greater than the dprime measure in the condition 'Partner-Bad' 
(aka both 'partner' and bad attributes are signals).											
											
																						
This script implements the Partner GNAT procedure (study 2) described in:

Lee, S., Rogge, R. D., & Reis, H. T. (2010). Assessing the seeds of relationship decay: Using implicit evaluations to detect 
the early stages of disillusionment. Psychological Science, 21(6), 857-864.

This script calculates d'prime values.

Adjustments to z-scores as described by:
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)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are asked to categorize attributes and partner-related items (e.g words  "supportive", "partner name") 
into predetermined categories via keystroke presses. The basic task is to press the Spacebar if an item (e.g. supportive")
belongs to the category currently being tested (e.g. "Constructive"") and to do nothing if it doesn't.
For practice, participants sort items into categories "Constructive", and "Destructive".
For the test, participants are asked to sort categories into the paired/combined categories (e.g. 
"Partner OR Constructive"). When an item belongs to either one of these two categories, 
participants should press the Spacebar.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 5 minutes to complete

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

(1) Raw data file: 'partnergnat_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. 
										
stimulusItem:						the presented stimuli in order of trial presentation
response:							the participant's response (scancode of response buttons)
correct:							accuracy of response: 1 = correct response; 0 = otherwise
latency: 							the response latency (in ms); measured from: onset of stimuli

(2) Summary data file: 'partnergnat_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)
								
Note: z-score calculations: adjustments (see Gregg & Sedikides, 2010, p.148)
If the hit rate  FA rate is 0 => 0.005 is used instead (aka 0.005 is added to the hitFA rate)
IF the hit rate  FA rate is 1.0 => 0.995 is used instead (aka 0.005 is subtracted from the hitFA rate)

pgHits: 			number of Hits for the partner/good pairing
pgFalseAlarms: 		number of false alarms for the partner/good pairing
pbHits: 			number of Hits for the partner/bad pairing
pbFalseAlarms: 		number of false alarms for the partner/bad pairing

pgHr:				hitrate for partner/good pairing
pgMr:				miss rate for partner/good pairing
pgFr:				false alarm rate for partner/good pairing
pgCr:				correct rejection rate for partner/good pairing
pgZHr:				z-value of hitrate for partner/good pairing
pgZFr:				z-value of false alarm rate for partner/good pairing

pgDPrime:			d' for partner/good pairing
					=> Range (in this script): 
					-5.1516586840152740479 <= dprime <= 5.1516586840152740479 (=perfect performance)

pgC: 				c-criterion in signal detection:The absolute value of c provides an indication of the strength of
					the response bias/response style
					negative: participant more likely to report that signal (go stims) is present (liberal response style);
					may favor faster responding in speed-accuracy trade-off response paradigms
					positive: favoring caution (conservative response style)									
									
pbHr:				hitrate for partner/bad pairing
pbMr:				miss rate for partner/bad pairing
pbFr:				false alarm rate for partner/bad pairing
pbCr:				correct rejection rate for partner/bad pairing
pbZHr:				z-value of hitrate for partner/bad pairing
pb z-fr:			z-value of false alarm rate for partner/bad pairing

pbDPrime:			d' for partner/bad pairing
					=> Range (in this script): 
					-5.1516586840152740479 <= dprime <= 5.1516586840152740479 (=perfect performance)
					
pbC:				measure of response bias (c-criterium)					
					
					
dPrimeDiff:			the difference in dprime btw. 'partner-good' and 'partner-bad'
					=> if d prime for 'partner-good' is larger than for 'partner-bad' (positive difference):
					participant more closely associated Partner with Good than with Bad attributes
					=> if d prime for 'partner-good' is smaller than for 'partner-bad' (negative difference):
					participant more closely associated Partner with Bad than with Good attributes								

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
* 2 Practice Blocks of 16 trials (8 go/8 nogo): good  -> bad
-> items are randomly sampled 
* 2 test blocks (order counterbalanced by groupnumber): 
-> testing of paired categories "partner OR good" vs. "partner OR bad" 
-> items are randomly sampled
-> 70 trials: 20 partner (go trials), 20 attribute go trials, 30 attribute no-go trials
	
___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
can be edited under section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
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:

	intertrialinterval			default is 400ms
	responsetimeout				default is 600ms