User Manual: Inquisit Time Perception Bias Test


___________________________________________________________________________________________________________________	

										*TIME PERCEPTION BIAS TEST*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
last updated:  10-23-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 10-23-2023 Millisecond Software

Millisecond thanks Joe Vitriol and Dr. Gordon Moskowitz for their help with this script
and for sharing the original geometric shapes used!

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a time perception bias test. The test is based on the assumption that
people overestimate the duration of items that heighten their arousal.

The implemented procedure is based on:

Gordon B. Moskowitz, G.B., Olcaysoy Okten, I. & Gooch, C.M. (2015).
On Race and Time. Psychological Science, 26, 1783-1794.
DOI: https://doi.org/10.1177/0956797615599547 (Experiment1)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
People tend to overestimate the duration of items that heighten their arousal.
In this script, people are asked to estimate the duration of items from 2 categories that
frequently elicit anxiety: spiders and dogs, and a control category (shoes) that is
assumed to be arousal neutral.

Each target item is presented after a geometric shape. The geometric shapes act as the 'standard' stimuli 
and are always presented for the same fixed duration (here: 600ms). 
The target items, on the other hand, are presented for variable durations (with the same number of 
durations being longer and shorter than the standard). 
Participant are asked to decide whether the target stimuli were presented for a longer or 
shorter duration than the preceding standard. 
The proportion of longer judgements is taken as a measure of time bias for arousal-neutral (baseline bias) and
potentially arousal-positive targets.

Note: Control and target categories can easily be altered.

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

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

(1) Raw data file: 'timeperceptionbiastest_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.
																			
countBlocks:					tracks the number of test blocks run										
countTrials:					tracks the number of trials run within a block (resets for each block)

compCategory:					stores the current comparison category presented									
stimulusItem:					standard stimulus presented
compStim:						the current comparison stimulus presented


(parameter) standardDuration:	the duration (in ms) of the standard object (here: geometric figure) (default: 600ms)
								during the test trials (demo trials = 1000ms, default)

compDuration:					stores the current comparison duration (in ms)

response:						the participant's response (scancode of response button: 31 = S; 38 = L)
responseCategory:				1 = longer judgment; 0 = otherwise
latency: 						the response latency (in ms); measured from offset of comparison stimulus


(2) Summary data file: 'timeperceptionbiastest_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)
																	
(parameter) standardDuration:	the duration (in ms) of the standard object (here: geometric figure) (default: 600ms)
								during the test trials									

propLonger:						proportion of "longer" judgment across all trials and blocks

ctrlCategory:				the control category (here: SHOES)
propLongerControl:			overall proportion of "longer" judgments for control items
propLongerControl1:			proportion of "longer" judgments for control comp duration 1 (default: 300ms)
propLongerControl2:			proportion of "longer" judgments for control comp duration 2 (default: 380ms)
propLongerControl3:			proportion of "longer" judgments for control comp duration 3 (default: 480ms)
propLongerControl4:			proportion of "longer" judgments for control comp duration 4 (default: 600ms)
propLongerControl5:			proportion of "longer" judgments for control comp duration 5 (default: 760ms)
propLongerControl6:			proportion of "longer" judgments for control comp duration 6 (default: 960ms)
propLongerControl7:			proportion of "longer" judgments for control comp duration 7 (default: 1200ms)

targetACategory:			the targetA category (here: SPIDERS)
propLongerTargetA:			overall proportion of "longer" judgments for targetA items
propLongerTargetA1:			proportion of "longer" judgments for targetA comp duration 1 (default: 300ms)
propLongerTargetA2:			proportion of "longer" judgments for targetA comp duration 2 (default: 380ms)
propLongerTargetA3:			proportion of "longer" judgments for targetA comp duration 3 (default: 480ms)
propLongerTargetA4:			proportion of "longer" judgments for targetA comp duration 4 (default: 600ms)
propLongerTargetA5:			proportion of "longer" judgments for targetA comp duration 5 (default: 760ms)
propLongerTargetA6:			proportion of "longer" judgments for targetA comp duration 6 (default: 960ms)
propLongerTargetA7:			proportion of "longer" judgments for targetA comp duration 7 (default: 1200ms)

targetBCategory:			the targetB category (here: DOGS)
propLongerTargetB:			overall proportion of "longer" judgments for targetB items
propLongerTargetB1:			proportion of "longer" judgments for targetB comp duration 1 (default: 300ms)
propLongerTargetB2:			proportion of "longer" judgments for targetB comp duration 2 (default: 380ms)
propLongerTargetB3:			proportion of "longer" judgments for targetB comp duration 3 (default: 480ms)
propLongerTargetB4:			proportion of "longer" judgments for targetB comp duration 4 (default: 600ms)
propLongerTargetB5:			proportion of "longer" judgments for targetB comp duration 5 (default: 760ms)
propLongerTargetB6:			proportion of "longer" judgments for targetB comp duration 6 (default: 960ms)
propLongerTargetB7:			proportion of "longer" judgments for targetB comp duration 7 (default: 1200ms)


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

Method of Constant Stimuli:
each target category uses a fixed set of durations that are presented in a randomized order.

1. Demo/Practice:
- 5 trials to get familiarized with the set-up
- stimuli are selected from random object/animal categories

2. Test:
- 4 blocks (editable, under section Editable Parameters
- each blocks presents: 
	- 21 control trials (here: shoes), 21 target A (here: spiders), 21 target B (here: dogs) 
	(number of trials are editable under section Editable Parameters) => 63 trials per block
	- each comparison trial randomly (without replacements) selects from 7 fixed durations: 300,380,480,600,760,960,1200 (in ms)
		=> 3 shorter than standard, 1 at standard, 3 above standard (for each category)
		=> 3 repetitions of each comparison duration per category per block => 12 repetitions of each comparison duration per category across 4 blocks
		The minimum recommended number of comparison duration repetitions per category is 10.
	- trial order is random

Trial Sequence:
standard (randomly selected geometric shape) for 600ms 
-> comparison stimuli for variable duration -> Judgment via keypress (S = shorter; L = longer)
-> ITI (default: 1000ms)	

Note:
By default each block repeats the same stimuli as the one before; stimuli are randomly selected
To avoid repeats, add as many items to the respective item elements (under editable stimuli) as trials should be run overall,
across all blocks for each condition (e.g. use 84 stimuli instead of 21 for target A for no repeats across blocks)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
- geometric shapes generously shared by Dr. Gordon Moskowitz
- images of shoes, spiders, dogs were collected from the internet
and converted in black and white pics in Paint.Net

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

Trial/Block Numbers:
Note: trial numbers should be divisible by the number of comp durations run (default: 7)
/controlTrials:							number of control (control) trials (default: 21)
/targetATrials:							number of target A trials (default: 21)
/targetBTrials:							number of target B trials (default: 21)
/maxBlocks:								number of blocks to run (default: 4)

Note: 
The minimum recommended total number of comparison duration repetitions per category is 10.
The default settings run a total of 12 repetitions per category.


/standardDuration:						the duration (in ms) of the standard object (here: geometric figure) (default: 600ms)
/standardDurationDemo:					the duration (in ms) of the standard object during the demo trials (default: 1000ms)
/iti:									the intertrial interval (in ms) between response and presentation of the next standard stim
/readyDuration:							the duration (in ms) of the 'get ready' trial

/shorterDurationResponseKey:			the key used to make "shorter" judgements (default: "S"); left response key			
/longerDurationResponseKey:				the key used to make "longer" judgements (default: "L"); right response key