User Manual: Inquisit Rey Visual Design Learning Test

															 
___________________________________________________________________________________________________________________	

								*REY VISUAL DESIGN LEARNING TEST (RVDLT)*
___________________________________________________________________________________________________________________	

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

Script Copyright © 08-25-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements the Rey Visual Design Learning Test (RVDLT), an assessment tool for immediate/delayed 
and recognition memory for non-verbal items.

The implemented procedure is based on:
P. Wilhelm (2004). Reliability and Validity of the Rey Visual Design Learning
Test in Primary School Children, Journal of Clinical and Experimental Neuropsychology, 26:7,
981-994, DOI: 10.1080/13803390490511076

__________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________	
Participants are presented 15 simple figures. Each figure is presented for 2s (default).
Afterwards recall (immediate/delayed) and recognition tests are given.
											  
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 15 minutes to complete

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

(1) Raw data file: 'reyvisuallearningtest_raw*.iqdat' (a separate file for each participant)

build:							The specific Inquisit version used (the 'build') that was run
computer.platform:				the platform the script was run on (win/mac/ios/android)
date, time: 					date and time script was run 
subject, group: 				with the current subject/groupnumber
session:						with the current session id

blockcode, blocknum:			the name and number of the current block (built-in Inquisit variable)
trialcode, trialnum: 			the name and number of the currently recorded trial (built-in Inquisit variable)
									Note: trialnum is a built-in Inquisit variable; it counts all trials run; even those
									that do not store data to the data file such as feedback trials. Thus, trialnum 
									may not reflect the number of main trials run per block.	
										
testPhase:						stores the recall iteration (1 to 3: immediate recall; 4 = delayed; 5 = recognition)
recallType:						"immediate" vs. "delayed"
recallCountPic:					stores the number of the recalled image
stimulusitem:					the presented stimuli in order of trial presentation
response:						the participant's response
correct:						the correctness of the response (1 = correct; 0 = incorrect)
latency: 						the response latency (in ms)
recognitionSelections:			stores all selected images in the Recognition Task

(2) Summary data file: 'reyvisuallearningtest_summary*.iqdat' (a separate file for each participant)

inquisit.version:				Inquisit version run
computer.platform:				the platform the script was run on (win/mac/ios/android)
startDate:						date script was run
startTime:						time script was started
subjectid:						assigned subject id number
groupid:						assigned group id number
sessionid:						assigned session id number
elapsedTime:					time it took to run script (in ms); measured from onset to offset of script
completed:						0 = script was not completed (prematurely aborted); 
								1 = script was completed (all conditions run)

Recognition_numberSelected:		retrieves the number of selected items in the Recognition Task
Recognition_hitRate:			calculates the hit rate in the Recognition Task
Recognition_faRate:				calculates the false alarm rate in the Recognition Task
recognitionSelections:			stores all selected images in the Recognition Task

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
5 blocks (to change the order of blocks or add/subtract blocks from the default procedure, go to section Experiment)

3 repeats: Figure Presentations (each figure is presented for 2s) -> Immediate Recall Session 
(a screenshot of the drawn figures will be produced and stored for later analysis)
- the order of the figures is predetermined and the same for each participant (see picture.testFigure)
- recall task terminates after 15 figures have been collected
1: Delayed Recall Session
1: Recognition Task: 
- presents a 5x6 matrix of 15 old and 15 new figures (matrix location is randomly assigned for each participant)
- participants are asked to select all the figures they remember
- once a figure is selected, it gets erased from the matrix
- task terminates after 15 figures have been selected


___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
see section Editable Stimuli
(stimuli are reproduced based on the info published in: Wilhelm (2004)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Instructions are not original to the task. They are provided by Millisecond Software
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).
__________________________________________________________________________________________________________________	
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:

/stimPresentation:			figure presentation duration in ms (default: 2000)
/picSize:					size of figure image in canvas screen percentages (default: 40%)
/delay:						delay duration in ms before delayed recall (default: 60000ms = 1 minute)