Return to the Pursuit Rotor Task page
						
									       PURSUIT ROTOR TASK
SCRIPT INFO

original Coder: Jeffrey Q. Ouyang (qijia.ouyang@gmail.com)
last updated:  	08-15-2016 by K.Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright ©  08-15-2016 Millisecond Software


BACKGROUND INFO 

											*Purpose*
This script implements the Pursuit Rotor Task; a task to measure manual dexterity and visual-motor tracking abilities.

References:
-The Multivariate Study of Pursuit Rotor Skill Development, 11 Aug. 2011, http://www.science.smith.edu/departments/EXER_SCI/Faculty/DS/PR.html
-Measuring Hand/Eye Coordination, 11 Aug. 2011, http://www.psywww.com/intropsych/ch07_cognition/measuring_hand_eye_coordination.html
-Pursuit Rotor, 11 Aug. 2011, http://sourceforge.net/apps/mediawiki/pebl/index.php?title=Pursuit_Rotor

											  *Task*
Participant tracks a red target with mouse cursor, as the target moves steadily in a circular path. 


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

(1) Raw data file: 'PursuitRotor_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 
/usedCanvas:						data file variable that stores the dimension of the experimental canvas (in pixels) used for the task
/radius:							the radius of the track in pixels
/targetDiscSize:					the size of the target disc in pixels
/trialDuration:						the duration of one trial/one rotation in ms (default: 10000ms)
/NumTrials:							the number of trials to run (default: 4)
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) 

/sum_offDurations_trial:			the sum of the durations spent OFF the target disk per trial (in ms)
/timeOnTarget_trial:				the duration spent ON the target disk per trial (in ms)
/sum_offDurations_total:			the sum of the durations spent OFF the target disk across all trials (in ms)
/timeOnTarget_total:				the duration spent ON the target disk across trials (in ms)
/meanDistanceFromCenterDisc_trial:	the mean distance (in pixels) of recorded mouse positions from the center of the animated circle per trial
/meanOffDistanceDisc_trial:			the mean distance (in pixels) of recorded mouse positions from the target disc (to edges of disc; not the center)per trial
/meanDistanceFromCenterDisc_total:	the mean distance (in pixels) of recorded mouse position from the center of the animated circle across trials
/meanOffDistanceDisc_total:			the mean distance (in pixels) of recorded mouse positions from the target disc (to edges of disc; not the center)across trials
list.targetDistances_trial.itemcount: stores the number of recorded mouse movements per trial
list.targetDistances_total.itemcount: stores the number of recorded mouse movements across trials
										Note: the distance data should only be considered valid if participant continously moved the mouse around;
										if few mouse movements are recorded, the collected distance data are questionable
										
(2) Summary data file: 'PursuitRotor_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)
/usedCanvas:						data file variable that stores the dimension of the experimental canvas (in pixels) used for the task
/radius:							the radius of the track in pixels
/targetDiscSize:					the size of the target disc in pixels
/trialDuration:						the duration of one trial/one rotation in ms (default: 10000ms)
/NumTrials:							the number of trials to run (default: 4)
/sum_offDurations_total:			the sum of the durations spent OFF the target disk across all trials (in ms)
list.targetDistances_total.itemcount: stores the number of recorded mouse movements across trials
										Note: the (distance) data should only be considered valid if participant continously moved the mouse around;
										if few mouse movements are recorded, the collected distance data are questionable
/timeOnTarget_total:				the duration spent ON the target disk across trials (in ms)
/meanDistanceFromCenterDisc_total:	the mean distance (in pixels) of recorded mouse positions from the center of the animated circle across trials
/meanOffDistanceDisc_total:			the mean distance (in pixels) of recorded mouse positions from the target disc (to edges of disc; not the center) across trials


EXPERIMENTAL SET-UP
- task runs 4 trials (default; can be edited under section Editable Parameters) on a 800px x 600px canvas (default; can be edited under section Defaults)
- each trial takes 10s (default; can be edited under section Editable Parameters)
- when participant move the mouse; mouse position is compared to disc position
(Note: task relies on participant continously moving the mouse; if no movements occur, data are not updated and summary values are questionnable)

INSTRUCTIONS
can be edited under section 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:

/trialDuration:				the duration of one trial/one rotation in ms (default: 10000ms)
/radius:					the radius of the track in pixels
/targetDiscSize:			the size of the target disc in pixels
/NumTrials:					the number of trials to run (default: 4)

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