Return to the Spatial Reconstruction Task page
						
										SPATIAL RECONSTRUCTION TASK

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

Script Copyright © 08-05-2016 Millisecond Software


Millisecond Software thanks Dr. Lok-Kin Yeung for his collaboration on this script!


BACKGROUND INFO 

											*Purpose*
This script implements a computerized Spatial Reconstruction Task based on:

Watson, P.D., Voss, J.L, Warren, D.E., Tranel, D.T. and Cohen, N.J. (2013). Spatial Reconstruction by Patients with Hippocampal 
Damage is Dominated by Relational Memory Errors. HIPPOCAMPUS 23:570–580.


											  *Task*
Participants are asked to study an arrangement of 2-5 objects on the screen (objects are presented on a white, square board in the center
of the screen) for 20s. Then the board is cleared. After a further delay (4s), the objects reappear on the top of the board,
and participants are asked to re-create the original arrangement.	

NOTE: by default, this script runs trials with N = 5 objects only. 
Code to run blocks with other N as well as code to run a mixed block are also provided under section BLOCKS.									  
  


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

(1) Raw data file: 'SpatialReconstructionTask_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) 
/N:								number of objects on the current board (2-5)
/object1-
/object5:						contain the itemnumbers assigned to the objects presented in position old1 - position old5 in the current trial
/response:						the response 
								(for reconstruction_select trials: response indicates the dropsource object (here: the board) or 'submit')
/lastDraggedObject:				the last object that was moved in the current trial
/latency:						response latency in ms (measured from start of trial until stims are dropped on the board or submit button selected)
/reconstructionDuration:		contains the cumulative duration (in ms) of the reconstruction phase (measured from onset of first reconstruction trial until submit button is pressed)
/old1_x-
/old5_y:						contain the original x/y coordinates (in canvas pixels) of the objects
/new1_x-
/new5_y:						contain the current x/y coordinates of the dragged objects (in canvas pixels)


Note: for implemented algorithms of the following measures, see section EXPRESSIONS for more detailed info
/misplacement1-
/misplacement5:					store the misplacements of object1-5 (in pixels)
								Note: Misplacement -> difference of placed object from original position
/meanTrial_misplacement:		mean trial misplacement (in pixels) (-> trial.evaluation)							
/edgeResizing12 -
/edgeResizing45:				store the edge resizing measurement for each possible object pair	
								Note: Edge Resizing -> Difference in distance between original object pairs (e.g. old1 and old2) and the placed objects (new1 and new2) (measured in pixels)
/meanTrial_EdgeResizing:		mean Trial Edge Resizing (in pixels) (-> trial.evaluation)
/Distortion12 -
/Distortion45:					store the distortion measurement for each possible object pair	
								Note: Distortions/Rearrangement: 1 = the relative X OR Y position (but NOT both) of two objects have been swapped; 0 = otherwise
/propTrial_Distortion:			proportion Distortions per Trial (-> trial.evaluation)
/Swap12 -
/Swap45:						store the Swap measurement for each possible object pair	
								Note: Swaps/Rearrangement: 1 = the relative X AND Y position of two objects have been swapped; 0 = otherwise
/propTrial_Swap:				proportion Swaps per Trial (-> trial.evaluation)


								
Note: it is possible with Inquisit lab to take screencaptures of the original positions and the placed positions.
To take such screenshots, go to section TRIAL and follow instructions.
								

(2) Summary data file: 'SpatialReconstructionTask_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)
/mean_Misplacement:				calculates the mean of all Misplacement trial means 
								-> Misplacement: difference of placed object from original position (measured in pixels)
/SD_Misplacement:				calculates the standard deviation of all misplacement trial means
/mean_EdgeResizing:				calculates the mean of all Edge Resizing trial means
								-> Edge Resizing: Difference in distance between original object pairs (e.g. position1 and position2) and the placed objects (drag1 and drag2) (measured in pixels)
/SD_EdgeResizing:				calculates the standard deviation of all edge resizing trial means
/meanProp_Distortion:			mean of all test trial Distortion proportions 
								Distortions/Rearrangement: 1= the relative X or Y position (but not both) of two objects have been swapped; 0 = otherwise							
/SD_Distortion:					standarddeviation of all test trial Distortion proportions
/meanProp_Swap:					mean of all test trial Swap proportions
								Swap: 1 = both relative X and Y positions of two objects have been swapped; 0 = otherwise
/SD_Swap:						standard deviation of all test trial Swap proportions	

Note: separate measures for different N can be added to summary data file. Go to section DATA and follow instructions

* separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section
"DATA" and follow further instructions



EXPERIMENTAL SET-UP

UserInterface: 
the active canvas (= part of the screen that is used for this study) is set to be the largest possible 
4:3 proportion of the current screen. Of this 4:3 canvas, the largest possible center square is used as the 'object board' to 
present and re-arrange the objects. This board is white; the remaining parts of the active canvas is black. 
A submit button is placed on the bottom right of the background canvas next to the 'board'. 
Objects Positions are defined in % of the active canvas (not the 'board'); however, these positions are then internally converted
into the corresponding pixels of the current canvas (depends on monitor). Objects can be positioned randomly (default) or with predetermined
positions (go to section Editable Parameters for further instructions).

Practice Block:
* by default, this script runs one practice block with N=5 objects of 5 trials (objects are randomly placed)
* each trial randomly selects the objects
* code to run N=2, N=3, N=4 object blocks as well as a mixed design block that runs all N (2-5) is provided under section BLOCKS

Test Block:
* by default, this script runs one test block with N = 5 objects (objects are randomly placed by default) of 15 trials
* each trial randomly selects the objects
* code to run N=2, N=3, N=4 blocks as well as a mixed design block that runs all N (2-5) is provided under section BLOCKS

Trial Sequence:
fixation cross (2000ms) -> Object Arrangement (20000ms) -> Empty Board (4000ms) 
-> Board with objects to arrange (no time limit): divided into
a) trial.reconstruction: measures latencies until a stimulus is dropped or 'submit' button is selected
b) trial.evaluation: evaluates the responses and records final placements into data file
-> ITI (1000ms)

Notes
1. all durations are editable under section Editable Parameters
2. objects can be randomly placed or with predetermined positions (controlled by parameters.randomPositions under section Editable Parameters)
for test trials (practice trials always run with random positions)
3. objects are not repeated until all 150 stimuli have been presented

STIMULI
150 squiggles used by Neal Cohen and researchers (contact email: njc@illinois.edu).
see section Editable Stimuli

INSTRUCTIONS
see 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:

/fixationDuration:					duration (in ms) of the fixation cross at the start of each trial (default; 2000ms)
/studyDuration:						the time (in ms) allocated to study the object arrangements (default: 20000ms)
/eraseBoardDuration:				the presentation duration (in ms) of the erased board (default: 4000ms)
/iti:								the intertrial interval (in ms) after each trial (default: 500ms)

/picSize:							the size of the images in % of canvas height (default: 10%)

/randomPositions:					true(1): random positions will be determined for each object for test trials (default)
									false(0): predetermined positions will be used for each object for test trials
									-> go to section Editable Lists and set the positions
									Note: practice trials run with random positions

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