User Manual: Inquisit Auditory Verbal Learning Task with Immediate Written Recall - Form 1


										English Version
										
										(Version 1)
																														


___________________________________________________________________________________________________________________	

								Modified Rey Auditory Verbal Learning Test (ModRey)
								- written recall - 
								
								PART1: LEARNING & IMMEDIATE RECALL
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 03-17-2022
last updated:  05-01-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright ©  05-01-2025 Millisecond Software
___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements an Inquisit version of the Modified Rey Auditory Verbal Learning Test (ModRey)
by Hale et al (2019). The ModRey is a test of episodic memory performance in non-clinical and 
pre-clinical populations. It differs from the Rey Auditory Verbal Learning Test (RAVLT) by 
increasing its difficulty. Specifically the authors
a) increased the number of items for the target and distractor lists from from 15 to 20
b) decreased the number of learning trials from 5 to 3
c) added an additional free recall trial of distractor list
d) added a source memory task

The original ModRey presents the words orally and collects oral responses.
This Inquisit implementation provides the option to choose whether to present the words only orally, 
only visually or both at the same time. By default, the words are presented only visually.
Recall responses are always collected in written format (via textboxes).
Recognition and Source Responses (part2) are collected via keyboard input.

!Note: Millisecond Software also offers an alternative implementation of the Modrey with oral recall input.
Verbal recall in those scripts is captured as soundcaptures that have to be scored manually.

//References//
Hale C, Last BS, Meier IB, Yeung LK, Budge M, Sloan RP, Small SA, Brickman AM. 
The ModRey: An Episodic Memory Test for Nonclinical and Preclinical Populations. 
Assessment. 2019 Sep;26(6):1154-1161. 
doi: 10.1177/1073191117723113. 
Epub 2017 Aug 11. PMID: 28799411; PMCID: PMC5829025.

Adjustments to z-scores as described by:
Gregg, A. & Sedikides, C. (2010). Narcissistic Fragility:
Rethinking Its Links to Explicit and Implicit Self-esteem, Self and Identity, 9:2, 142-161 (p.148)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

//////////////////////////////////////////////////////
///////Script modrey_written recall_part1.iqjs:////////
//////////////////////////////////////////////////////

//(1) Learning Phase with Immediate Recall://
Participants are presented a list of 20 verbal words (fixed sequence, list A), one at a time at a time.
Once the list has finished, a textbox appears and participants are asked to enter as 
many of the list words as they remember, in any order. The list learning/immediate recall task is 
repeated 2 more times.

//(2) Introduction of Distractor List://
Then participants are distracted with distractor list B (one time).

//(3) Short Delay

//(4) Free Recall of List A://
After listB, participants are asked to recall all words from list A 
(list A is not presented anymore)

------------------End of part1----------------------------------------

//(5) Delay: 1.5h//

/////////////////////////////////////////////////////
///////Script modrey_writtenrecall_part2.iqjs:////////
/////////////////////////////////////////////////////

//(6) Delayed recall of List A//
- participants work through through a delayed recall test of list A

//(7) Delayed recall of List B//
- participants work through through a delayed recall test of list B

//(8) Recognition Test (List A) - 66 trials// 
-target words are list A words; 
-distractors are phonetically similar and 
-list B words

//(9) Source Test://
List A and List B words are presented in fixed order and participant has to decide
the words' source list (A or B)

___________________________________________________________________________________________________________________	
DURATION
___________________________________________________________________________________________________________________

The default setup of this script takes about +/- 10 minutes
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	 
The fields in the data files are:

(1) Raw data file: 'modrey_writtenrecall_part1_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:							with the current subject id

group: 								with the current group id
									Note: 
									group id = 1 => run form 1
									group id = 2 => run form 2
									
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 bloc
										
(parameter) list:					target list A 
(parameter)	form:					form 1																	
										
countIR:							the number of immediate recall trials run
countAllRecallRounds:				counts the number of ALL (immediate + delayed) recall trials ru

stimulusItem:						the presented stimuli in order of trial presentation
stimulusNumber:						the itemnumber of 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)

recall:								stores the recall text input (with single commas to separate the different words)
countCorrectRecall:				tracks the number of correctly recalled words per trial

recallWordEstimate:					stores the computer-derived estimate of the number of words recalled
										Note: see below of algorithm implemented. 
										Algorithm does not check whether the recalled words are actual words.
										
nrOtherRecalledWords:				stores the number of other recalled words that are not list words

intrusionOther:						stores the character strings contained in the recall string that are not list words
										Note: misspelled study words will show up here
										
word1Recall-
word20Recall:						stores the number of times the first (second, third, etc) word of list A was recalled									


(2) Summary data file: 'modrey_writtenrecall_part1_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 subject group id
							Note: 
							group id = 1 => run form 1
							group id = 2 => run form 2
									
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)
									
(parameter) list:		target list A 
(parameter)	form:		form 1											
									
///NOTE: if not explicitly mentioned, all summary variables refer to list A performance									
									
recallScoreIR:			sum of all correctly recalled items across the 3 IMMEDIATE recall trials (Max: 60)
recallScoreSDFR:		sum of all correctly recalled items across Short Delay Free Recall Trial (Max: 20)
									
recallScoreIRListB:	number of correctly recalled items from list B									

//Immediate Recall ACCURACY//
meanWordRecall:		mean of the estimated number of words recalled per trial (IMMEDIATE RECALL only)- independent of recall accuracy
meanRecall:				mean number of correctly recalled words per trial (IMMEDIATE RECALL only)

ir1:					number of correctly recalled words on trial 1
ir2:					number of correctly recalled words on trial 2  
ir3:					number of correctly recalled words on trial 3

//Individual Words Recall/Intrusions during Immediate Recall//
propWord1Recall-
propWord20Recall:		stores the recall proportion of words in study positions 1 - 20 
						across the number of IMMEDIATE recall trials
						(Max: 3/3 for each item)
						Example: word 1(here: market)
						=> word in list position 1 was remembered x out of 3 times during immediate recall
				
meanIntrusionsIR:		mean number of intrusions on recall lists (recalling words that were not on the list) - immediate recall trials only

//Recall across ALL recall trials (immediate + free recall)//
Recall ALL:								
ir1RecalledWords-
sdfrRecalledWords:		stores the list of the recalled words for trial1, trial2, trial3 (IMMEDIATE RECALL)
						trial4 (free recall trial)																	

recallIntrusions:		a storage variable that stores all recall intrusion words across the 4 recall trials (list A only)
						Note: check for misspelled words here and adjust scores accordingly 
									
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

(I) 3 blocks: List Learning/Recall Task with list A (IR1-IR3)
- the words are presented with a 2s SOA (editable)
- the order of the words is predetermined and the same across all 3 blocks
- at the end a textbox appears and prompts participants to enter all the words they remember (self-paced)

Recall Task: Scoring Algorithms
Algorithm to estimate number of recalled words:
In general this algorithm uses the number of a specific word separator (here: comma)
to estimate the number of words in between the separators: estimated word count = number of separators + 1
The algorithm uses several steps to clean up the text input to ensure as much as 
possible that only single commas are used as word separators. It also removes
trailing commas from the input if necessary.

Steps:
(1) textbox response is stored in values.Recall (Example: values.Recall = "bed; chair; table") 
(note: there is a space AND a ; after bed and chair)

(2) values.Recall replaces 7 types of possible word separator symbols (e.g. ";", " ") with a comma 
(Example: values.Recall = "bed,,chair,,table")

(3) values.Recall adds a comma to the first item 
(Example: values.Recall = ",bed,,chair,,table")

(3) values.Recall replaces all consecutive commas with a single comma 
(Example: values.Recall = ",bed,chair,table")

(4) if values.Recall does not end in a comma at this point, this comma is added 
(Example: values.Recall = ",bed,chair,table,")

(5) the length of the variable values.Recall is stored in variable values.recallLength 
(Example: values.recallLength = 17)

(6) a second variable (values.reducedRecall) deletes all commas in values.Recall 
(Example: values.reducedRecall = "bedchairtable" => length: 13)

(7) the word count estimate = length of values.Recall* - length of values.reducedRecall - 1 (extra comma) 
(Example: estimate = 17 - 13 - 1 = 3)
		*with length = number of characters 

Note: the recall scoring algorithms implemented in this script depend on participants 
(a) using the implemented separators
(b) make no spelling mistakes
(c) don't use phonetically similar words (e.g. pain instead of pane)
Manual checks of the raw data might be necessary to adjust the scores (see values.intrusionOther)

(II) 1 block: List Learning/Recall Task with list B (IR_listB)
- the words are presented with a 2s SOA
- the order of the words is predetermined and the same across all 3 blocks
- at the end a textbox appears and prompts participants to enter all the words they remember (self-paced)

(III) 1 block (after delay): Free Recall Task with list A (SDFR)
- enter words into a textbox (self-paced)

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
uses the words of the ModRey (Hale et al, 2019)
(words were pronounced with Google Translate and saved as .wav files)

can be run with version1 stimuli (see modrey_items_form1.iqjs)
can be run with version2 stimuli (see modrey_items_form2.iqjs)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
are provided by Millisecond Software - see script "modrey_writtenrecall_part1_instructions_inc.iqjs"

___________________________________________________________________________________________________________________	
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:

//Stimuli Parameters:
/ runAudioWords = false		// false = run audio stimuli; false = does not run audio stimuli
/ runVisualWords = true		// true = run verbal stimuli; false = does not run audio stimuli
							//Note: if both are set to 'true' they both appear

//Timing Parameters:
/ soa = 2000				//stimulus onset asynchrony (in ms): the words are presented roughly
							//2s apart
							
/ sdfrDelayMS = 60000		//short delay (in ms) of the SDFR free recall of list A
							
/ finishTrialDurationMS = 60000	//the current duration (in ms) of the finish Trial.