User Manual: Inquisit Delayed Matching to Sample Task (DMTS)


___________________________________________________________________________________________________________________	

									DELAYED MATCHED-TO-SAMPLE (DMTS)
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-27-2015
last updated:  01-20-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-20-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script runs the a Delayed Matched to Sample Procedure (DMTS) similarly to the one published in

PAULE, M. G., BUSHNELL, P. J., MAURISSEN, J. P. J., WENGER, G. R.,
BUCCAFUSCO, J. J., CHELONIS, J. J., et al. (1998). Symposium overview: The
use of delayed matching-to-sample procedures in studies of short-term memory
in animals and humans. Neurotoxicology and Teratology, 20, 493-502. (p.497)

The implemented DMTS procedure is intended for animal research.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are presented with a target color disk (e.g. red) for a minimum of 5s (default). After the minimum
viewing time a mouse click will remove the target and start the delay interval. Several delays are tested.
Once the delay is over, two colored disks are presented on the bottom of the screen.
One of the disk has the same color as the target (red); the other is a comparison color (yellow or green).
Participants need to press the target color (Note: for a non-matched to sample procedure, simply go to
trial.dmts_match and follow instructions).
Clicking one of the colored disks initiates an intertrial interval of 5s (default).

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

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

(1) Raw data file: 'dmts_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. 
										
delaycondition:					1 = delay1; 2 = delay2; 3 = delay3; 4 = delay4
delay:							stores the currently tested delay
targetlocation:					1 = left; 2 = right
targetcolor:					1 = red; 2 = green; 3 = yellow
compcolor:						1 = red; 2 = green; 3 = yellow				

Stimulusitem:					the presented stimuli in order of trial presentation
response:						the participant's response
correct:						the correctness of the response (1 = correct; 0 = incorrect)
latency: 						the response latency (in ms)


(2) Summary data file: 'dmts_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 all delays)
meanRT:							overall mean correct response latency (in ms)

propcorrect_delay1:				proportion correct for Delay 1 Trials
meanRT_delay1:					mean correct response latency (in ms) for Delay 1 Trials
propcorrect_delay2:				proportion correct for Delay 2 Trials
meanRT_delay2:					mean correct response latency (in ms) for Delay 2 Trials
propcorrect_delay3:				proportion correct for Delay 3 Trials
meanRT_delay3:					mean correct response latency (in ms) for Delay 3 Trials
propcorrect_delay4:				proportion correct for Delay 4 Trials
meanRT_delay4:					mean correct response latency (in ms) for Delay 4 Trials

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
3 colors: red, green, yellow 
4 delays: predetermined

* Each color is presented equally often as target and each color is paired with each other equally often.
Target colors appear equally often on the left and right.
=> for 3 target colors x 2 comp colors x 2 locations x 4 delays =>  48 trials per block.dmts
* block.dmts is run twice for 2 x 48 = 96 trials
* Order of trials is randomly determined.

Trial Sequence:
- stimulus for minimum 5000ms (screen needs to be pressed to move on)
- delay (0,1000,4000,20000ms)
- stimulus and comp stimulus until response 
- iti for 5000ms

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
are red, green, and yellow disks presented on a black background.
Stimuli were prepared in Paint.Net by Millisecond Software

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
default script is designed for animal research

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

/min_stimulusduration:					minimum presentation duration of the targets in ms (default: 5000ms)

/delay1:								0 ms delay
/delay2:								short delay (unless individualized delays are determined) in ms (default: 1000ms)
/delay3:								medium delay (unless individualized delays are determined) in ms (default: 4000ms)
/delay4:								long delay (unless individualized delays are determined) in ms (default: 20000ms)

/iti:									inter trial interval in ms (default: 5000ms)