User Manual: Inquisit Token Test


___________________________________________________________________________________________________________________	

										TOKEN TEST - computerized adaptation*
										(Spanish Version)
___________________________________________________________________________________________________________________	

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

Script Copyright © 03-29-2023 Millisecond Software

Millisecond Software thanks José Félix Mozo del Castillo for generously sharing his translation!
___________________________________________________________________________________________________________________
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 OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	
The fields 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
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.										
										
trialCounterPerPhase:				number of trials run per phase
itemNumber:						the number of the currently selected item 
instructions:					stores the currently selected instructions
attempts:						stores the number of attempts per trial (Max 2)

response:						the participant's response
								Note: 
								lSRed = large square red; 
								sSRed = small square red; 
								lCRed = large circle red; 
								sCRed = 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
points:							stores the points for the current trial (0-2)
phasePoints:					stores the accumulated points for the current phase
totalPoints:					stores the accumulated points across phases
 
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)

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)	

pointsPhase1-
pointsPhase5:					stores the accumulated points separately for each of the 5 phases (Max for each phase: 20)

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:

/runPhase1:				true = phase1 is run; false = phase1 is skipped (default: true)
/runPhase2:				true = phase1 is run; false = phase2 is skipped (default: true)
/runPhase3:				true = phase1 is run; false = phase3 is skipped (default: true)
/runPhase4:				true = phase1 is run; false = phase4 is skipped (default: true)
/runPhase5:				true = phase1 is run; false = phase5 is skipped (default: true)

/instructionsDuration:	the time in ms for instruction trials (default: 5000)
/phase1TimeLimit:			the time in ms for phase 1 task (default: 10000)
/phase2TimeLimit:			the time in ms for phase 2 task (default: 12000)
/phase3TimeLimit:			the time in ms for phase 3 task (default: 15000)
/phase4TimeLimit:			the time in ms for phase 4 task (default: 18000)
/phase5TimeLimit:			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%)