Return to the Tower of London Task page
						
				Tower of London Task (TOL) -- Krikorian et al. (1994) Version
				
SCRIPT INFO

Script Author: David Nitz (dave@millisecond.com) for Millisecond Software, LLC
last updated: 03-22-2016 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Copyright © 03-22-2016 Millisecond Software


BACKGROUND INFO

											*Purpose*
	This script implements the 'Tower of London' task originally described in:
	
	Shallice, T. (1982). Specifc impairments of planning. Philosophical Transactions of the Royal 
	Society of London, Biology, 298, 199-209.

	Procedural details were adapted from:
	Krikorian, R., Bartok, J., & Gay, N. (1994). Tower of London procedure: A standard method 
	and developmental data. Journal of Clinical and Experimental Neuropsychology, 16, 840-850.
	
	Task instructions were adapted from:
	Anderson, P., Anderson, V., & Lajoie, G. (1996). The Tower of London test: Validation and 
	standardization for pediatric populations. The Clinical Neuropsychologist, 10, 54-65.

	Further references:	
	Berg, W. K. & Byrd, D. L. (2002). The Tower of London spatial problem-solving task:
	Enhancing clinical and research implementation. Journal of Clinical and Experimental 
	Neuropsychology, 24(5), 586-604.
 
											  *Task*
Participants need to figure out how to move and arrange three colorfuls discs on 3 provided pegs 
in such a way to achieve a specific solution pattern. 


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

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

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
blockcode, blocknum:			the name and number of the current block
trialcode, trialnum: 			the name and number of the currently recorded trial
									(Note: not all trials that are run might record data; by default data is collected unless /recorddata = false is set for a particular trial/block) 
response:						response made
latency:						the latency of the response in ms (or if no response: trialduration)
problemnumber					Current problem number. By default the task consists of 1 practice
									problem and 12 test problems presented sequentially. 0 indicates 
									a practice problem.
subjectattempts					Number of current attempts to solve the given problem.
targetmoves						Number of prescribed moves for the current problem.
subjectmoves					Number of subject-performed moves for the current problem.
excessmoves						Returns the difference between number of moves performed by the subject and the number of target moves for a given problem.
movestring						Text string containing a record of performed moves. E.g. "B2R3"
									indicates that the blue ball (B) was moved to peg 2 (center) and 
									the red ball (R) was moved to peg 3 (right).
targetachieved					Returns true as soon as the subject has successfully reached a given
										problem's target / goal state. Otherwise false.
problemscore					Score awarded for solving the current problem. See Krikorian et
									al. (1994) for details.
totalscore						Score achieved across the whole set of test problems. Computed
									as the sum of individual problem scores. Maximum is 36 in the 
									standard version.
firstmovetime					Returns the time (in ms) elapsed between initial presentation of 
										the target configuration and the initialization of the subject's first
										move. Sometimes also referred to as "planning time" or simply
										"latency". Note: Measure is computed separately for each attempt.
executiontime					Computed as solutiontime - firstmovetime. Note: Measure is 
										computed separately for each attempt.
solutiontime					Returns the time (in ms) elapsed between initial presentation of
										the target configuration and a subject's successful solution.
										Note: Measure is computed separately for each attempt.
t_choicestart					Absolute start time for trial.choice in ms. May be used to derive
									additional measures during data analysis (e.g. mean move time).
t_choiceend						Absolute end time for trial.choice in ms. May be used to derive
									additional measures during data analysis (e.g. mean move time).

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

script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				subject id number
script.groupid:					group id number
script.elapsedtime:				time it took to run script (in ms)
computer.platform:				the platform the script was run on
/completed:						0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)
totalscore:						Score achieved across the whole set of test problems. 
									Computed as the sum of individual problem scores. Maximum is 36 in the standard version.


EXPERIMENTAL SET-UP
1 Practice trial (problem with 2 moves)
12 Test trials (2 problems with 2 moves, 2 problems with 3 moves, 4 problems with 4 moves, 4 problems with 5 moves: tested sequentially in fixed order)

Per Problem:
* no time limit
* reset button provided
* 3 attempts per problem to solve it given the max. number of moves. After failure to solve a problem in 3 attempts,
participants are moved to the next problem in the sequence (participants can also move ahead to the next problem
by clicking a 'next' button)
	
STIMULI
see section Editable Stimuli
(to re-create new target states, try EmptyPegs.pptx - provided by Millisecond Software)

INSTRUCTIONS
see section Editable Instructions. Instructions are provided in the form of *.html pages. Edits can be made
to the html-files directly.

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:

	maxattempts						Allowed number of attempts to solve any given problem with
									minimum amount of moves. Default is 3.
	npracticeproblems				Number of practice problems. By default, the task contains 1
									practice problem and 12 test problems. Default is 1. 
	n_a_slots						Capacity of peg 1 (left). Default is 3.
	n_b_slots						Capacity of peg 2 (center). Default is 2.
	n_c_slots						Capacity of peg 3 (right). Default is 1.
	intertrialinterval				The intertrial interval (time between problems) in ms. Default is 1000.
	feedbackduration				Duration of performance feedback in ms. Default is 2000.
	h1 -> h3						Horizontal coordinates of pegs 1, 2 and 3 in screen percentages.
									Defaults are 20%, 50% and 80%.
	v1 -> v3						Available vertical coordinates for the three balls in screen 
									percentages. Defaults are 80%, 65%, 50%.
	r_startX, r_startY				Determines the red ball's start position (horizontal, vertical).
	g_startX, g_startY				Determines the green ball's start position (horizontal, vertical).
	b_startX, b_startY				Determines the blue ball's start position (horizontal, vertical).

Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Security Statement | Employment