Return to the Token Test page
___________________________________________________________________________________________________________________	

										TOKEN TEST - computerized adaptation*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 10-15-2015
last updated:  12-31-2019 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 12-31-2019 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a computerized adaptation of the original Token Test for Aphasia as described in:

DeRenzi, E. & Vignolo, L.A. (1962). The Token Test: A Sensitive Test to detect Receptive disturbances
in Aphasiacs, Brain, 85, 665-678.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are presented rows of rectangles and circles in different colors and are given visual and 
(by default) verbal* instructions of what to do with these rectangles and circles 
(Example: "Click on the red rectangle").
The test has 5 phases (10 trials each) that are getting progressively more difficult.

* the verbal instructions are provided with the built-in Inquisit voiceover feature. 
It can easily be turned off if needed.
___________________________________________________________________________________________________________________	
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: 'tokentest_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
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.trialcount_phase:		number of trials run per phase
values.itemnumber:				the number of the currently selected item 
values.instructions:				stores the currently selected instructions
values.attempts:					stores the number of attempts per trial (Max 2)

response:							the participant's response
									Note: 
									lS_red = large square red; 
									sS_red = small square red; 
									lC_red = large circle red; 
									sC_red = small circle red (etc.)
									
									R2C1 = empty cell of row 2 column 1 - R2C5 (empty cells below squares) - used in phase 5 only
									R2C1 = below red square; 
									R2C2 = below blue square; 
									R2C3 = below green square; 
									R2C4 = below yellow square; 
									R2C5 = below purple square
									R4C1 = empty cell of row 4 column 1 - R4C5 (empty cells below circles) - used in phase 5 only
									R4C1 = below blue circle; 
									R4C2 = below purple circle; 
									R4C3 = below red circle; 
									R4C4 = below yellow circle; 
									R4C5 = below green circle
									background = participant clicked the canvas and not any of the shapes 
									0 = noresponse
									
correct:							the correctness of the response (1 = correct; 0 = incorrect)
latency: 							the response latency (in ms) of the data-recording trial
values.points:						stores the points for the current trial (0-2)
values.phasepoints:				stores the accumulated points for the current phase
values.totalpoints:				stores the accumulated points across phases
 
values.repeat:						0 = the trial will not be repeated; 
									1 = the trial will be repeated

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

computer.platform:				the platform the script was run on (win/mac/ios/android)
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.points_phase1-
values.points_phase5:			stores the accumulated points separately for each of the 5 phases (Max for each phase: 20)

values.totalpoints:				stores the accumulated points across phases (Max: 100)

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

The test runs 5 phases: each phase is getting progressively more difficult

Phase 1: 
a row of large squares (random order of colors: red, purple, blue, green, yellow) 
a row of large circles (random order of colors: red, purple, blue, green, yellow)
10 simple instructions such as "Click on the yellow square" - randomized order for each participant
Each task has a predetermined time limit (see Editable Parameters) and can be repeated once

Phase2: 
a row of large squares (random order of colors: red, purple, blue, green, yellow) 
a row of small squares (random order of colors: red, purple, blue, green, yellow) 
a row of large circles (random order of colors: red, purple, blue, green, yellow)
a row of large circles (random order of colors: red, purple, blue, green, yellow)
10 simple instructions such as "Click on the large yellow square" - randomized order for each participant
Each task has a predetermined time limit (see Editable Parameters) and can be repeated once

Phase 3: 
a row of large squares (random order of colors: red, purple, blue, green, yellow) 
a row of large circles (random order of colors: red, purple, blue, green, yellow)
10 instructions such as "Click on the yellow square and the blue circle" - randomized order for each participant
Each task has a predetermined time limit (see Editable Parameters) and can be repeated once

Phase4: 
a row of large squares (random order of colors: red, purple, blue, green, yellow) 
a row of small squares (random order of colors: red, purple, blue, green, yellow) 
a row of large circles (random order of colors: red, purple, blue, green, yellow)
a row of large circles (random order of colors: red, purple, blue, green, yellow)
10 audio instructions such as "Click on the large yellow square and the small blue circle" - randomized order for each participant
Each task has a predetermined time limit (see Editable Parameters) and can be repeated once

Phase5: 
a row of large squares (random order of colors: red, purple, blue, green, yellow) 
(empty row)
a row of large circles (random order of colors: red, purple, blue, green, yellow)
(empty row)
10 idiosyncratic audio instructions such as "Drop the yellow circle on the red square"* - order is the same for each participant
Each task has a predetermined time limit (see Editable Parameters) and can be repeated once

* the original DeRenzi & Vignolo (1962) study uses 20 instructions; not all of these 20 instructions can be easily
translated from a 3D-world onto a 2-D computer screen. 

Scoring in this script:
Participants get 2 chances per trial.
First Run: if correct 2 points
Second Run: if correct 1 point

Maximum Number of Points: 5 phases x 10 trials x 2 = 100 points

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
see section Editable Instructions.
By default, the instructions are presented visually (but can be easily exchanged with auditory ones).

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

/run_phase1:				true = phase1 is run; false = phase1 is skipped (default: true)
/run_phase2:				true = phase1 is run; false = phase2 is skipped (default: true)
/run_phase3:				true = phase1 is run; false = phase3 is skipped (default: true)
/run_phase4:				true = phase1 is run; false = phase4 is skipped (default: true)
/run_phase5:				true = phase1 is run; false = phase5 is skipped (default: true)

/instructionsduration:	the time in ms for instruction trials (default: 5000)
/phase1_timelimit:			the time in ms for phase 1 task (default: 10000)
/phase2_timelimit:			the time in ms for phase 2 task (default: 12000)
/phase3_timelimit:			the time in ms for phase 3 task (default: 15000)
/phase4_timelimit:			the time in ms for phase 4 task (default: 18000)
/phase5_timelimit:			the time in ms for phase 1 task (default: 20000)
/iti:							the time in ms for the trials in between tasks (either next or repeat message) (default: 2000)

/largesize:					the size of the large items in canvas height percentage (default: 20%)
/smallsize:					the size of the small items in canvas height percentage (default: 10%)