Spatial Reconstruction Task

Technical Manual

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com), Millisecond

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

Created: January 07, 2016

Last Modified: January 01, 2024 by K. Borchert (katjab@millisecond.com), Millisecond

Script Copyright © Millisecond Software, LLC

Background

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.

Duration

15 minutes

Description

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.

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.

Procedure

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 for test trials (practice trials always run with random positions)
(controlled by parameters.randomPositions under section Editable Parameters)
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

Instructions are not original to the task. They are provided by Millisecond
as htm/html pages and can be edited by changing the provided htm/html files.
To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac)
or Notepad (Windows).

Summary Data

File Name: spatialreconstructiontask_summary*.iqdat

Data Fields

NameDescription
inquisit.version Inquisit version number
computer.platform Device platform: win | mac |ios | android
startDate Date the session was run
startTime Time the session was run
subjectId Participant ID
groupId Group number
sessionId Session number
elapsedTime Session duration in ms
completed 0 = Test was not completed
1 = Test was completed
meanMisplacement Calculates the mean of all Misplacement trial means
-> Misplacement: difference of placed object from original position (measured in pixels)
stdMisplacement Calculates the standard deviation of all misplacement trial means
meanEdgeResizing 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)
stdEdgeResizing Calculates the standard deviation of all edge resizing trial means
meanPropDistortion 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
meanPropSwap Mean of all test trial Swap proportions
Swap
1 = both relative X and Y positions of two objects have been swapped
0 = otherwise
separate measures for different N can be added to summary data file. Go to section DATA and follow instructions

Raw Data

File Name: spatialreconstructiontask_raw*.iqdat

Data Fields

NameDescription
build Inquisit version number
computer.platform Device platform: win | mac |ios | android
date Date the session was run
time Time the session was run
subject Participant ID
group Group number
session Session number
blockCode Name of the current block
blockNum Number of the current block
trialCode Name of the current trial
trialNum Number of the current trial
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)
old1X-
old5Y Contain the original x/y coordinates (in canvas pixels) of the objects
new1X-
new5Y Contain the current x/y coordinates of the dragged objects (in canvas pixels)
for implemented algorithms of the following measures, see section EXPRESSIONS for more detailed info
misplacement1-
misplacement5 Store the misplacements of object1-5 (in pixels)
Misplacement -> difference of placed object from
original position
meanTrialMisplacement Mean trial misplacement (in pixels) (-> trial.evaluation)
edgeResizing12 -
edgeResizing45 Store the edge resizing measurement for each possible object pair
Edge Resizing -> Difference in distance between original object pairs (e.g. old1 and old2) and the placed objects (new1 and new2) (measured in pixels)
meanTrialEdgeResizing Mean Trial Edge Resizing (in pixels) (-> trial.evaluation)
distortion12 -
distortion45 Store the distortion measurement for each possible object pair
Distortions/Rearrangement: 1 = the relative X OR Y position (but NOT both) of two objects have been swapped; 0 = otherwise
propTrialDistortion Proportion Distortions per Trial (-> trial.evaluation)
swap12 -
swap45 Store the Swap measurement for each possible object pair
Swaps/Rearrangement: 1 = the relative X AND Y position of two objects have been swapped; 0 = otherwise
propTrialSwap Proportion Swaps per Trial (-> trial.evaluation)
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.

Parameters

The procedure can be adjusted by setting the following parameters.

NameDescriptionDefault
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 20000ms
eraseBoardDuration The presentation duration (in ms) of the erased board 4000ms
iti The intertrial interval (in ms) after each trial 500ms
picSize The size of the images in % of canvas height 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
practice trials run with random positions