Return to the Spatial Processing Task page
						
								SPATIAL PROCESSING TASK
SCRIPT INFO

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 06-02-2014
last updated: 01-19-2016 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Copyright © 01-19-2016 Millisecond Software


BACKGROUND INFO

											*Purpose*
This script runs a spatial processing task described by:

Englund, C.E., Reeves. D.L., Shingledecker, C.A., Thorne, D.R., Wilson, K.P., & Hegge. F.W. (1987).
Unified Tri-Service Cognitive Performance Assessment Battery (UTC-PAB) I. Design and Specification of the Battery. 
Report No. 87-10, Naval Health Research Center, P 0 BOX 85122, San Diego, CA 92138
Naval Medical Research and Development Command, Bethesday, MD (task description: p.26)

The Spatial Processing task was designed to target spatial orientation rotation and short-term memory.


											  *Task*
Participants are presented sequentially with two 2,4, or 6 bar histograms. The first histogram is the target
histogram. It is always presented in the vertical, upright position. The second histogram is the comparison
histogram. It can be rotated clockwise 0deg (2 bars), 90/270deg (4 bars), or 180deg (6 bars).
The task is to decide as fast as possible if the comparison histogram is congruent or incongruent to the target.


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

(1) Raw data file: 'SpatialProcessing_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) 

/training:						1 = training block; 0 = test block
/cognitiveload:					1 = low; 2 = medium; 3 = high cognitive load condition
/nr_bars:						2, 4, or 6 histogram bars
/orientation:					1 (0deg rotation), 2 (90deg clockwise rotation), 3 (180deg clockwise rotation), 4 (270deg clockwise rotation)
/congruence:					1 = target and comparison histogram are congruent; 2 = target and comparison histogram are incongruent
/counttrials_lcl-hcl:				counts all trials per cognitive loading condition (reset after training)
									(lcl = low cognitive load; mcl = medicum cognitive load; hcl = high cognitive load)

response:						the participant's response
/responsecategory:				"correct response", "incorrect response", "no response" (= trial timed out before active response was given)
correct:						the correctness of the response
latency: 						the response latency
/nr_boxes1_1 -
/nr_boxes6_1:					number of boxes (=height) of bars used for 2, 4, and 6 bar target histograms

/nr_boxes1_2 -
/nr_boxes6_2:					number of boxes (=height) of bars used for 2, 4, and 6 bar comparison histograms
/valid:							debug helper variable that stores whether the incongruent comparison stimuli is really
								incongruent (1 = incongruent; 0 = accidentally congruent for incongruent trial => the trial should be considered invalid)
									Note: the algorithm used to determine bar heights for incongruent comparison histograms (see EXPRESSIONS) 
									should prevent that accidental congruent histograms are used for incongruent histograms. 


(2) Summary data file: 'SpatialProcessing_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)
/propcorrect_lcl-
/propcorrect_hcl:				proportion correct responses by cognitive loading level (across all test blocks)
								(lcl = low cognitive load; mcl = medicum cognitive load; hcl = high cognitive load)
/meanRT_lcl-
/meanRT_hcl:					mean latency of correct responses by cognitive loading level (across all test blocks)
								(lcl = low cognitive load; mcl = medicum cognitive load; hcl = high cognitive load)

EXPERIMENTAL SET-UP

3 different cognitive load/demand levels tested in a blocked design (by default, the order of the blocks is randomly determined):
Level1: 2 bars at 0 degree rotation (low cognitive demand)
Level2: 4 bars at 90/270 degree rotation (medium cognitive demand)
Level3: 6 bars at 180degree roation (high cognitive demand)

* Each training/test block lasts 3min by default (Editable Value). Number of training and test blocks
can be set under Editable Values.
* Congruence is randomly sampled (with replacement) with the same probability for congruent and incongruent histograms
(controlled via list.congruence)
* Congruence key assignment can be counterbalanced via groupnumber (odd and even groupnumbers run
the opposite key assignment)

Trial Set-Up:
1) Target Histogram presented for 3s (default, Editable Value) with the label '1' under it
2) followed by an interstimulus blank screen of 1s (default, Editable Value)
3) Comparison Histogram presented with the label '2' under it
	a) Training: 15s duration
	b) Test: 1.5s (2 bars), 2.5s (4 bars) and 3.5s (6bars) durations
	Only responses that are given within those time limits are accepted. A valid response
	immediately ends the histogram presentation.
4) Any left-over time (response was given before time limit was up) is added to a blank screen acting as an 
intertrial interval (iti)
(for training: for iti purposes the time limits used for the test are used to determine the iti duration)

STIMULI
2, 4, 6 bar Histograms presented in an (invisible) 6 x 6 matrix
The height of each bar (1-6) is determined randomly with the constraint that no 
height can be repeated for a given histogram.

INSTRUCTIONS
Instructions are not original to the task. They are provided by Millisecond Software
as htm pages and simple page elements and can be edited either by changing
the provided html files or directly under 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:
/responsekey1:							scancode of the first response key (default: 30)
/responsekey2:							scancode of the second response key (default: 38)
											Note: scancodes under Tools -> Keyboard Scancodes
/responsekey1_label:					label of the first response key (default: A)
/responsekey2_label:					label of the second response key (default: L)
											Note: response keys are counterbalanced by groupnumber, see section EXPERIMENT

Appearance of Histograms:
/boxheight:								sets the size of the 36 boxes (default: 10%)
/x_matrix-							 
/y_matrix:								top/left coordinates of the matrix 
/spacing:								manipulates the space between bars (default: 0.4)
/boxcolor:								the color of the histogram bars (default: blue)
/showindividualboxes:					true: individual boxes are shown (horizontal spacing as well as vertical spacing is shown)
										false: only bars are shown (only vertical spacing is shown)
/fontsize:								fontsize of the histogram label (default: 3%)

/blocked:								true:	the 4 different orientations are tested in a blocked design
										false:	the 4 different orientations are tested in a mixed design
/nr_trainingblocks_lcl:					Number of training blocks to be run for the low cognitive load condition (default: 2)
/nr_testblocks_lcl:						Number of test blocks to be run for the low cognitive load condition (default: 2)
/nr_trainingblocks_mcl:					Number of training blocks to be run for the medium cognitive load condition (default: 2)
/nr_testblocks_mcl:						Number of test blocks to be run for the low cognitive load condition (default: 2)
/nr_trainingblocks_hcl:					Number of training blocks to be run for the high cognitive load condition (default: 2)
/nr_testblocks_hcl:						Number of test blocks to be run for the high cognitive load condition (default: 2)
											Note: Englund et al (1987) write that "Stable performance is
											achieved with 6 to 10 training trials (3 minutes each) at each loading level"
											'trials' = blocks in this script

Duration Parameters:
/targetduration:						presentation time of the target histogram (default: 3000ms)
/comparisonduration_lcl:				presentation time of the 2-bar comparison histogram (default: 1500ms)
/comparisonduration_mcl:				presentation time of the 4-bar comparison histogram (default: 2500ms)
/comparisonduration_hcl:				presentation time of the 6-bar comparison histogram (default: 3500ms)
/responseduration_training:				the presentation time of the comparison histogram during training (default: 15000ms)
/isi:									empty screen between offset of target and onset of comparison stimuli (default: 1000ms)
/iti:									default empty screen between offset of comparison stimuli and onset of new target stimuli (default: 0ms)
											Note: if participant responds before the current comparisonduration is done, the 'missing'
											time is added to the iti
/blockduration:							the duration of a block (default: 180000ms = 3min)
											Note: after 3 min the block stops



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