Return to the Trail Making Test page
___________________________________________________________________________________________________________________	

									      Trail-Making Test
___________________________________________________________________________________________________________________	


Script Author: Sean Draine, Ph.D. (seandr@millisecond.com) for Millisecond Software, LLC
last updated:  11-05-2019 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 11-05-2019 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a computerized version of the Trail-Making Test (4 trails included).
The trial making test is an executive function test of visual attention and task switching.

References:
	
Armitages, S. G. (1946) An analysis of certain psychological rests used for the evaluation of brain injury. 
Psychological Monographs, 60, 1.
	
Reitan, R. M. (1958). Validity of the Trail Making Test as an Indicator of Organic Brain Damage. 
Perceptual and Motor Skills, 8, 271-276. 

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are asked to move the mouse in specific, predetermined sequences from nodes to nodes.											  

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

(1) Raw data file: 'trailmakingtest_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)
								
computer.touch:					1 = the current screen is a touchscreen; 
								0 = the current screen is not a touchscreen
									
date, time, 						date and time script was run 
subject, group, 					with the current subject/groupnumber
script.sessionid:					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. 
									
values.startDotNumber:			specifies the current dot that participant is on
values.targetDotNumber:			specifies the current dot that needs to be connected next
values.sampleAErrors:				counts the errors made on SampleA Trail
values.trail1Errors:				counts the errors made on Trail1
values.sampleBErrors:				counts the errors made on SampleB Trail
values.trail2Errors:				counts the errors made on Trail2
values.errortrail_samplea-
values.errortrail_trail2:				saves all missed circles in the order made for each trail separately
values.sampleATime:				time (in ms) spent on SampleA Trail
values.trail1Time:					time (in ms) spent on Trail1
values.sampleBTime:				time (in ms) spent on SampleB Trail
values.trail2Time:					time (in ms) spent on Trail2


(2) Summary data file: 'trailmakingtest_summary*.iqdat' (a separate file for each participant)

									
computer.platform:				the platform the script was run on (win/mac/ios/android)

computer.touch:					1 = the current screen is a touchscreen; 
								0 = the current screen is not a touchscreen

script.startdate:					date script was run
script.starttime:					time script was started
script.subjectid:					assigned subject id number
script.groupid:					assigned group id number
script.sessionid:					assigned session id number
script.elapsedtime:				time it took to run script (in ms); measured from onset to offset of script
script.completed:					0 = script was not completed (prematurely aborted); 
								1 = script was completed (all conditions run)

values.sampleAErrors:						counts the errors made on SampleA Trail
values.sampleATime:						time (in ms) spent on SampleA Trail
values.sampleBErrors:						counts the errors made on SampleB Trail
values.sampleBTime:						time (in ms) spent on SampleB Trail
values.trail1Errors:						counts the errors made on Trail1
values.trail1Time:							time (in ms) spent on Trail1
values.trail2Errors:						counts the errors made on Trail2
values.trail2Time:							time (in ms) spent on Trail2
expressions.combined_errors:				adds errors made on all 4 trails
expressions.combined_trailtime:			combines the time (in ms) it took all 4 trails

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
This script runs 4 trails (sampleA, trailA, sampleB, trailB)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
are provided in the included scripts

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

/showTestErrorFeedback:					true = a yellow halo is presented over the correct circle (default)
										false = no extra errorfeedback is given (incorrect path is still erased however)