Return to the Time Wall Estimation Task page
___________________________________________________________________________________________________________________	

											*TIME WALL ESTIMATION TASK*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 05-07-2015
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 Time Wall Task; an assessment of time estimation.

The implemented procedure is based on:

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)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
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).

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 1.5 minutes to complete

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

parameters.totalfallduration:		the time (in ms) it takes for the disk to fall from the top (starting off canvas) to the bottom 
								(ending off canvas)

response:						the participant's response (57 = pressed Spacebar within valid response window)

values.validresponse:				1 = a valid response within the response window was given
								0 = no valid response within the response window was given

expressions.time_hole:			the time (in ms) it takes for disk to fully cover the hole (from start of falling)
								=> "correct" response
									
values.estimatedtime:				stores the estimated time (in ms) disk would fully cover the wall hole
								(measured from trial start until participant responds)


values.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)

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.countresponses:				counts all valid responses
values.nr_timeouts:					counts number of time-outs (= number of invalid responses)

expressions.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.
									
expressions.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) 
									
expressions.constanterror:				estimation error as measured by difference (mean_estimationtime - time_hole)
expressions.properror:				proportional error of estimated time to actual time
expressions.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) 
										
expressions.cv_estimationtime:			coefficient of variation (Englund et al: 100* std/mean)

values.sum_earlyresponses:			sums up the number of early responses across experiment

parameters.circleradius:					sets the radius of the disk in canvas height % (default: 5%)
parameters.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)
parameters.nr_steps_destinationwall:		sets the canvas % steps the disk needs to be fully covered by wall (default: 66)
parameters.nr_steps_destinationhole:		sets the canvas % steps the disk needs to fully cover the wall hole (default: 88)

expressions.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
expressions.time_hole:					calculates the time (in ms) it takes for disk to fully cover the hole
expressions.time_wall:					calculates the time (in ms) it takes for disk to be fully covered by wall
expressions.start_y:						calculates the starting y coordinate of the falling disk based on circleradius (start: disk is not yet seen)
expressions.end_y:						calculates the ending y coordinate of the falling disk based on circleradius (end: disk is not seen anymore)
expressions.walltop_y:					calculates the y-coordinate of the top of the wall based on parameters.circleradius and parameters.nr_steps_destinationwall
expressions.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
expressions.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 | Privacy Statement | Security Statement | GDPR
Website Security Test