User Manual: Inquisit Affective Priming Procedure with Words


___________________________________________________________________________________________________________________	

							AFFECTIVE PRIMING - TEMPLATE with prime words and prime targets
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 06-09-2015
last updated:  02-16-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-16-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a simple Affective Priming procedure with supraliminal word primes and word targets.
In general, priming procedures are simple response-timed binary categorization tasks of items from two target
categories  (e.g. positive vs. negative adjectives). Priming Procedures are based on the assumption that 
people respond faster if the target category was already 'mentally activated' by briefly presenting items 
(called 'primes') that are closely connected in one's mind. Thus, a person should be faster to quickly categorize
the target word 'good' as 'positive' after the brief presentation of the prime word 'ice-cream' (assuming
good and ice-cream are associated in one's mind) than after the brief presentation of the prime word 'famine' 
(assuming good and famine are not closely associated in one's mind).
If the primes are presented with a temporal duration that can be consciously processed, the primes are
called 'supraliminal'. 

The implemented procedure is not based on any particular published paradigm.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are asked to categorize affective target words into pleasant and unpleasant categories.
For baseline measures, a baseline supraliminal prime '***' precedes the target words.
For test measures, affective supraliminal word primes precede the target words.  

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

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

(1) Raw data file: 'affectivepriming_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 such as feedback trials. Thus, trialnum 
										may not reflect the number of main trials run per block. 
									
primecategory:						Unpleasant vs Pleasant
targetcategory:						Unpleasant vs Pleasant
primeitemnumber:					stores the itemnumber of the currently presented prime
prime:								stores the presented prime
targetitemnumber:					stores the itemnumber of the currently presented target
target:								stores the presented target


response:							scancode of the pressed response button (Example:)
										18 = E =left
										23 = I =  right
										57 = spacebar
									
responseCategory:					the interpretation of the key-response: "pleasant" or "unpleasant"									
									
correct:							accuracy of response: 1 = correct response; 0 = otherwise
latency: 							the response latency (in ms); measured from: onset of target



(2) Summary data file: 'affectivepriming_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)

propcorrect:			overall proportion correct (across baseline and test)
meanRT:					overall mean correct response time in ms (across baseline and test)

propcorrect_base:		proportion correct baseline trials
meanRT_base:			mean latency (ms) of correct baseline trials
propcorrect_U_base:		proportion correct Unpleasant baseline trials
meanRT_U_base:			mean latency (ms) of correct Unpleasant baseline trials
propcorrect_P_base:		proportion correct Pleasant baseline trials
meanRT_P_base:			mean latency (ms) of correct Pleasant baseline trials

propcorrect_test:		proportion correct test trials
meanRT_test:			mean latency (ms) of correct test trials
propcorrect_UU_test:	proportion correct test trials that pair Unpleasant primes with Unpleasant targets
meanRT_UU_test:			mean latency (in ms) of correct test trials that pair Unpleasant primes with Unpleasant targets
propcorrect_UP_test:	proportion correct test trials that pair Unpleasant primes with Pleasant targets
meanRT_UP_test:			mean latency (in ms) of correct test trials that pair Unpleasant primes with Pleasant targets
propcorrect_PU_test:	proportion correct test trials that pair Pleasant primes with Unpleasant targets
meanRT_PU_test:			mean latency (in ms) of correct test trials that pair Pleasant primes with Unpleasant targets
propcorrect_PP_test:	proportion correct test trials that pair Pleasant primes with Pleasant targets
meanRT_PP_test:			mean latency (in ms) of correct test trials that pair Pleasant primes with Pleasant targets

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
2 affective primes (pleasant vs unpleasant) x 2 affective targets (pleasant vs unpleasant), tested within subjects

1. baseline ("practice"): 48 trials (all 48 targets) are tested with a baseline prime (***); targets are selected at random
2. test: 48 trials (all 48 targets); targets are selected at random
	- all 48 words occur once as prime and once as target
	- prime and target are never the same
	NOTE: in rare circumstances, the prime can be repeated to ensure that target and prime are not the same

Trialsequence:		
Prime (200ms, editable) -> prime-target ISI (100ms, editable) 
-> Targets (until response; latency measured from onset of target)->ITI (2500ms)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
Words are taken from:
Draine, S.C, & Greenwald, A.G. (1998). Replicable Unconscious Semantic Priming. Journal of Experimental Psychology: 
General, 127, 286-303.

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

/baselineprime:				the symbols used for the baseline "prime"
/primeheight:				the size of the primes in % of canvas height (default: 5%)
/targetheight:				the size of the targets in % of canvas height (default: 5%)

/primeduration:				the duration of the primes in ms (default: 200ms)
/PT_ISI:					the duration of the prime-target interstimulus interval (default: 100ms)
/ITI:						the intertrial interval (default: 2500ms)

/responsekeyleft:			the left response key (default: E) //in this script the left response key is used as the unpleasant key
/responsekeyright:			the right response key (default: I) //in this script the right response key is used as the pleasant key