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
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.
15 minutes
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.
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
150 squiggles used by Neal Cohen and researchers (contact email: njc@illinois.edu).
see section Editable Stimuli
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).
File Name: spatialreconstructiontask_summary*.iqdat
| Name | Description |
|---|---|
| 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 |
File Name: spatialreconstructiontask_raw*.iqdat
| Name | Description |
|---|---|
| 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. |
The procedure can be adjusted by setting the following parameters.
| Name | Description | Default |
|---|---|---|
| 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 |