Return to the Corsi Visual Spatial Memory Test page
						
									Corsi Visual Spatial Memory Test (forward)

SCRIPT INFO

Script Author: David Nitz (dave@millisecond.com) for Millisecond Software, LLC 

last updated:  10-13-2017 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC
Copyright ©  10-13-2017 Millisecond Software


BACKGROUND INFO

											*Purpose*
	This script implements the Forward Corsi Block Tapping Task as described in:

	Kessels, R.P.C., van Zandvoort, M.J.E., Postma, A., Kappelle, L.J., & de Haan, E.H.F. (2000).
	The Corsi block-tapping task: Standardization and normative data. Applied Neuropsychology,
	7(4), 252-258.

	Corsi, P. M. (1972). Human memory and the medial temporal region of the brain. 
	Dissertation Abstracts International, 34, 819B.


											  *Task*
Participants are presented with a screen of 9 boxes. The boxes light up in a pre-fixed sequence (constant across participants)
and participants are asked to click on the boxes in the same order they were lit.
The sequence length starts at level = 3 boxes and can increase to up to level 8. Participants get 3 chances
at each sequence length. If one of the sequences was entered correctly, the next sequence starts. 
The test terminates with three incorrect responses in a row or after the last trial on level 8.
A practice session with 2 trials (5 boxes, 3 lit) is run before the test to familiarize participants with the set-up.


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

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

roundsPerLevel						running count of the number of attempts per level (usually 3 unless the replacement sequence is played also -> then 4)											
replacementTrial					1 = the current sequence is a replacement; 0 = otherwise	
										Note: one replacement per level is provided. To get the replacement sequence, participant needs to 
										enter 'done' without providing a response (values.respstring = "")
seqnumber							The ordinal number of the current block sequence. 
									A maximum of 18 sequences (+ 6 possible make-up sequences) are given in ascending order.
seqlength							Length of the current block sequence (current level tested).
sequence							The current sequence
response							the response of the participant in a given trial ('1'-'9', 'done', 'reset)
respstring							The sequence entered by the participant.
latency								the latency of the response (in ms)
correct								1 = the current sequence was recalled correctly;  0 = otherwise
sequenceError						1 = the error made is a sequence error; 0 = otherwise
										sequence error: the correct blocks were selected but the order was incorrect
consecutiveErrors:					running count of consecutive errors (within and across blocks); resets with each correct response										
nCorrectInLevel						Holds the number of correctly recalled sequences in the current block.
										Note: participant has to get at least 2 trials per level correct to increase 'blockspan' 

nCorrectTotal						Total number of correctly recalled sequences across the whole task
nErrorsTotal						Total number of errors made across all levels (includes non-tapped sequences that did not qualify for replacement)
nSequenceErrors						counts the number of sequence errors made across the task

blockspan							The achieved Block Span: longest sequence length that was correctly reproduced at least twice
workingTime_s						stores the duration of the test session (in s)
								
									
(2) Summary data file: 'corsivisualspatialmemorytest_forward_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; 1 = script was completed (all conditions run)
nCorrectTotal								Total number of correctly recalled sequences across the whole task.
nErrorsTotal								Total number of errors made across all levels
nSequenceErrors								counts the number of sequence errors made across the task
blockspan									The achieved Block Span: longest sequence length that was correctly reproduced at least twice
workingTime_s								stores the duration of the test session (in s)


EXPERIMENTAL SET-UP

(1) Practice
* 2 trials with predetermined sequences of 3 boxes (see section Editable Lists)
* 5 boxes presented, 3 are lit
	* each box is lit for 1000ms with an isi of 250ms (default)
	* a beep is played after the last box to signal that response can be entered 
* participants can make as many corrections as they want before submitting their response
* feedback is provided	
* if incorrect response is submitted, the trial is repeated until participant enters the correct sequence
or reaches the max number of practice trials (default in this script: 20)
* it is not possible to omit a practice trial

(2) Test
* tests levels: 3-8
* 3 trials with predetermined sequences per level (see section Editable Lists)
* 9 boxes presented
	* each box is lit for 1000ms with an isi of 250ms (default)
	* a beep is played after the last box to signal that response can be entered 
* participants can make as many corrections as they want before submitting their response
* no feedback is provided
* once per level, a 'missed' sequence can be made-up. Participant has to press NEXT without providing a 
response. In that case, a make-up sequence is provided.
* script terminates after
a) three incorrect responses in a row are submitted OR
b) the third response of level 8 is submitted

BlockSpan: 
longest sequence length that was correctly reproduced at least twice


INSTRUCTIONS
provided by Millisecond Software - 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:

	boardcolor				Display color for the virtual game board.
	blocksize				Size of blocks in % of canvassize.
	showscores				'true' -> show score summary at the end of the procedure.
							'false' -> don't show score summary at the end of the procedure.
							Default is 'true'.
	tapinterval				Interval between 'taps' in ms. Default is '1000'.
	posttapinterval			Time between erasing a previously highlighted block and highlighting the 
							next one in ms.
	maxPracticeTrials		the maximum number of practice trials provided before script terminates (default: 20)

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