User Manual: Inquisit Temporal Reproduction Task


___________________________________________________________________________________________________________________	

										*TEMPORAL REPRODUCTION*
___________________________________________________________________________________________________________________	

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

Script Copyright © 03-02-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements the Temporal Reproduction procedure as described in:

Wittmann, M., Leland, D.S., Jan Churan, J. & Paulus, M.P.(2007). Impaired time perception and motor timing
in stimulant-dependent subjects. Drug and Alcohol Dependence, 90, 183–192.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are asked to estimate the duration of a target tone (tone 1, 1-5s) by manually 
interrupting (-> Spacebar) a comparison tone (tone 2) when they think tone 2 was played as long as tone 1.
Participants are actively discouraged from counting seconds by introducting a distractor task.
Before tone 1 is played two target symbols appear on the screen that participants are asked to remember for
a later forced-choice recognition task. At the end of the entire trial sequence, a comparison symbol is presented and 
participants have to decide whether this symbol was one of the two target symbols.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 8 minutes to complete
___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

(1) Raw data file: 'remporalreproduction_raw*.iqdat' (a separate file for each participant)

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..
									
firstdistractor:				stores the index of the first distractor symbol
seconddistractor:				stores the index of the second distractor symbol
select_compdistractor:			stores current index of the comparison distractor
tone1duration:					stores the current duration of Tone1

estimation_rt:					latency of estimation (in ms)
response:						the participant's response

correct:						the correctness of the response (1 = correct; 0 = incorrect)
								Note: relevant only for comp-distractor question
									
latency: 						the response latency (in ms)


(2) Summary data file: 'temporalreproduction_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)
								
distractortask_errorrate:		recognition error proportion for distractortask

mean_estimation_t1 -:			mean estimation time (in ms) for t1 to t5
mean_estimation_t5

std_estimation_t1- :			standard deviation of the estimation times for t1 to t5
std_estimation_t5

cv_t1-:							coefficient of variation for t1 to t5			
cv_t5

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
a) Main Task: Temporal Reproduction
IV = duration of target tone (here: 1000ms, 2000ms, 3000ms, 4000, 5000ms) tested within-subjects
Main DV: latency of estimation (how long it takes participants to press <Spacebar> after Tone 2 starts playing)

*Each level of the IV is repeated 6 times for a total of 30 trials.
*the order is determined randomly
*target tone 1 (300Hz)/comparison tone 2 (600Hz) have a maximum duration of 20,000ms/25,000ms in this script 
(replace under section Editable Stimuli for longer durations; the tones for this script were created with
Audacity)

b) Distractor Task: forced-choice Recognition Task
Note: the original article does not specify the details of this task
In this script: 10 symbols (customize under section Editable Stimuli)
* each symbol appears 6 times as one of the target symbols
* in half the time the comparison symbol is familiar 
(it's randomly decided which one of the two symbols is chosen for familiar trials)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
provided by Millisecond Software - can be edited under section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions provided with this script are not the originals. Customize 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:

/durationbtwtones:					posttrialpause after presenting tone1 in ms(default: 1000)
/ITI:								intertrialinterval, break inbetween main trial sequences in ms (default: 2000)
/distractorduration:				duration of the target distractors in ms(default: 1000)

tone1 duration settings (in ms):	the 5 levels of the IV
/t1 = 1000										
/t2 = 2000							Note: the provided sound files last for max 20s(tone1)/25s(tone2); for longer durations	
/t3 = 3000							these sound files need to be replaced
/t4 = 4000
/t5 = 5000