Return to the Time Wall Estimation Task page
						
										TIME WALL ESTIMATION TASK

SCRIPT INFO

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 05-07-2015
last updated:  01-05-2016 by K.Borchert for Millisecond Software LLC

Copyright ©  01-05-2016 Millisecond Software


BACKGROUND INFO

											*Purpose*
This script implements a Time Wall Task similar to the one described by:

UNIFIED TRI-SERVICE COGNITIVE PERFORMANCE ASSESSMENT BATTERY (UTC-PAB) I. DESIGN AND SPECIFICATION OF THE BATTERY. 
ENGLUND, C.E., REEVES. D.L., SHINGLEDECKER, C.A., THORNE, D.R., WILSON, K.P., & HEGGE. F.W. (1987).
REPORT NO. 87-10, NAVAL HEALTH RESEARCH CENTER, P 0 BOX 85122, SAN DIEGO, CALIFORNIA 92138
NAVAL MEDICAL RESEARCH AND DEVELOPMENT COMMAND, BETHESDA, MARYLAND (p.46)

The Time Wall Task assesses Time Estimation.

											  *Task*
Participants watch a disk falling from the top of the screen. On its way to the bottom (default: 10s) it passes behind a wall with 
a disk-sized hole in it.
Once the disk is completely behind the wall (default: 6s), participants are asked to estimate via pressing the Spacebar 
how long it would take the disk to completely cover the hole (default: 8s, measured from start of trial).


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

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

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject:			date and time script was run with the current subjectnumber 
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) 

/totalfallduration:				the time (in ms) it takes for the disk to fall from the top (starting off canvas) to the bottom (ending off canvas)
/fallduration1:					the time (in ms) it takes the disk to be completely covered by the wall
response:						the participant's response (57 = pressed Spacebar within valid response window)
/validresponse:					1 = a valid response within the response window was given
								0 = no valid response within the response window was given
/estimatedtime:					stores the estimated time (in ms) disk would fully cover the wall hole
									(measured from trial start until participant responds)
/time_hole:						the time (in ms) it takes for disk to fully cover the hole
/earlyresponses:				sums up the early responses (=> pressing Spacebar before disk is fully behind wall) per trial
									Note: early responses don't interrupt the trial


(2) Summary data file: 'TimeWallEstimation_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)
/taskduration:					duration of block.timewallestimation
/countresponses:				counts all valid responses
/nr_timeouts:					counts number of time-outs (= number of invalid responses)
/time_hole:						the time (in ms) it should take trial.diskfalling theoretically to move the disk the distance from first time behind the wall
								to cover the wall hole completely.
/mean_estimationtime: 			mean estimation time of judging how long it takes the disk to fill the wall hole
									(measured from time that disk is completely covered by wall) 
/constanterror:					estimation error as measured by difference (mean_estimationtime - time_hole)
/properror:						proportional error of estimated time to actual time
/variableerror:					standard deviation time of judging how long it takes the disk to fill the wall hole
									(measured from time that disk is completely covered by wall) 
/CV_estimationtime:				coefficient of variation (Englund et al: 100* std/mean)
/sum_earlyresponses:			sums up the number of early responses across experiment

/circleradius:					sets the radius of the disk in canvas height % (default: 5%)
/totalfallduration:				sets the time (in ms) needed for the disk to fall from the top (not seen yet) to the bottom (not seen anymore) (default: 10000ms)
/nr_steps_destinationwall:		sets the canvas % steps the disk needs to be fully covered by wall (default: 66)
/nr_steps_destinationhole:		sets the canvas % steps the disk needs to fully cover the wall hole (default: 88)
/speed:							calculates the speed in ms/% canvas of the falling disk based on totalfallduration and the start and end y-coordinates of the falling disk
/time_hole:						calculates the time (in ms) it takes for disk to fully cover the hole
/time_wall:						calculates the time (in ms) it takes for disk to be fully covered by wall
/start_y:						calculates the starting y coordinate of the falling disk based on circleradius (start: disk is not yet seen)
/end_y:							calculates the ending y coordinate of the falling disk based on circleradius (end: disk is not seen anymore)
/walltop_y:						calculates the y-coordinate of the top of the wall based on parameters.circleradius and parameters.nr_steps_destinationwall
/wall_y:						calculates the y-coordinate of the wall when it first covers the disk completey based on parameters.circleradius and parameters.nr_steps_destinationwall
/hole_y:						calculates the y-coordinate of the hole based on parameters.circleradius and parameters.nr_steps_destinationhole

EXPERIMENTAL SET-UP
By default this script runs 10 estimation tasks (editable parameter) or is over after 300s (editable parameter) 
whichever comes first. At the default speed the disk is completely covered by the wall by 6s, covers the wall hole by 8s and drops off 
the canvas at 10s.
Once the disk is completely covered by the wall, the script waits for a response from the participant (early responses are counted but ignored otherwise). 
If participant presses the Spacebar within 30s (editable parameter) after the disk is completely covered by the wall, the response is 
counted as valid and the wall hole is filled with the color of the falling disk (visual feedback of a valid response). 
A new estimation task (if applicable) is started after 500ms (editable parameter). 
If participant does not press the Spacebar within 30s, a beep is played (auditory feedback of invalid response) and a new task starts 
after 1s (editable parameter).

SCREEN SET-UP
The stimuli in this task are all proportionally sized to the active screen canvas (this script uses a width:height = 4:3 canvas by default)

INSTRUCTIONS
adapted from Englund et al (1987) - can be edited under 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:

/responsekey:							scancode of the response key
											Note: scancodes under Tools -> Keyboard Scancodes (default: 57)
/responsekey_label:						label of the response key (default: )

/nr_estimations:						number of estimation cycles (default: 10)
/maxtime:								the total time (in ms) the test should maximally take (default: 300000ms)
											!!!Note: the script stops either after parameters.nr_estimations (10) or parameters.maxtime; whichever comes first

/max_trialduration:						maximum trial duration for trial.fallingdisk (default: 30000ms)
/beeppause:								time-out pause after a beep trial (= participant took longer than parameters.max_trialduration to respond) before the next estimation sequence is started (default: 1000ms)
/iti:									the intertrial pause (in ms) after each valid time estimation cycle (default: 500ms)

/circleradius:							sets the radius of the disk in canvas height % (default: 5%)
/totalfallduration:						sets the time (in ms) needed for the disk to fall from the top (not seen yet) to the bottom (not seen anymore) (default: 10000ms)
/nr_steps_destinationwall:				sets the steps (1 step = 1% of the canvas height) the disk needs to take from the start point to the point where it's first fully covered by wall (default: 66)
/nr_steps_destinationhole:				sets the steps (1 step = 1% of the canvas height) the disk needs to fall from the start point to the point where it fully covers the wall hole (default: 88)
					
Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Security Statement | Employment