User Manual: Inquisit Auditory Verbal Learning Task (Verbal Recall)


___________________________________________________________________________________________________________________	

								Modified Rey Auditory Verbal Learning Test (ModRey) 
								- Batch Script-
								- oral recall-
___________________________________________________________________________________________________________________	

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

Script Copyright © 03-29-2023 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 presents the words orally and collects soundcaptures of the spoken recall responses.
These soundcaptures have to be manually scored for accuracy.
Recognition and Source Responses (part2) are collected via keyboard input.

!Note: Millisecond Software also offers an alternative implementation of the Modrey with written 
recall input and the option of oral and/or visual word presentation.  Written recall in those scripts 
is captured via textboxes that are scored by the script automatically.

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

This script implements a batch script. It calls

- Script modrey_oralrecall_part1.iqjs
- Script modrey_oralrecall_part2.iqjs

in this fixed order.
Note that scripts 'modrey_oralrecall_part1.iqjs' and 'modrey_oralrecall_part2.iqjs' can also be run outside 
this batch script.

Add any number of Inquisit scripts in between the two parts to fill the recommended
delay of 1.5h. (see for additional information below under element batch.main)

//////////////////////////////////////////////////////
///////Script modrey_oralrecall_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_oralrecall_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 1 3/4- 2hours (including the delay of 1.5h)
Part 1 takes roughly: 10-15 minutes
Part 2 takes roughly: 5 minutes
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
uses the words of the ModRey (Hale et al, 2019)
(words were pronounced with Google Translate and saved as .wav files)

Groupnumber 1 (odd) - Runs version1 stimuli (see modrey_items_form1.iqjs)
Groupnumber 2 (even) - runs version2 stimuli (see modrey_items_form2.iqjs)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
are provided by Millisecond Software - can be edited in the individual scripts

___________________________________________________________________________________________________________________	
DATA
___________________________________________________________________________________________________________________	
see individual scripts
"modrey_oralrecall_part1.iqjs"
"modrey_oralrecall_part2.iqjs"



___________________________________________________________________________________________________________________	

								Modified Rey Auditory Verbal Learning Test (ModRey)
								- oral recall - 
___________________________________________________________________________________________________________________	

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

Script Copyright ©  09-30-2024 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 presents the words orally and collects soundcaptures of the spoken recall responses.
These soundcaptures have to be manually scored for accuracy.
Recognition and Source Responses (part2) are collected via keyboard input.

!Note: Millisecond Software also offers an alternative implementation of the Modrey with written 
recall input and the option of oral and/or visual word presentation.  Written recall in those scripts 
is captured via textboxes that are scored by the script automatically.

//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_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 speed of
1 word per second. Once the list has finished, participants are asked to recall 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) 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----------------------------------------

//(4) Delay: 1.5h//

/////////////////////////////////////////////
///////Script modrey_part2.iqjs:////////
/////////////////////////////////////////////

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

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

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

//(8) 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_oralrecall_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:							counts the number of immediate recall trials run
countAllRecallRounds:				counts the number of ALL (immediate + delayed) recall trials run

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
									//Note: soundcaptures are stored
latency: 							the response latency (in ms); measured until 'continue' button is pressed

(2) Summary data file: 'modrey_oralrecall_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:			needs to be manually computed
recallScoreSDFR:		needs to be manually computed
									
recallScoreIRListB:	needs to be manually computed								

//Immediate Recall ACCURACY//
ir1:					needs to be manually computed
ir2:					needs to be manually computed 
ir3:					needs to be manually computed
									
___________________________________________________________________________________________________________________	
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 recall prompt appears (self-paced)

(II) 1 block: List 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 recall prompt appears (self-paced)

(III) 1 block (after delay): Free Recall Task with list A (SDFR) after a short delay
- 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)

Groupnumber 1 (odd) - Runs version1 stimuli (see modrey_items_form1.iqjs)
Groupnumber 2 (even) - runs version2 stimuli (see modrey_items_form2.iqjs)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
are provided by Millisecond Software - change under 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:



___________________________________________________________________________________________________________________	

								Modified Rey Auditory Verbal Learning Test (ModRey) 
								- oral recall - 								
___________________________________________________________________________________________________________________	

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

Script Copyright ©  10-03-2024 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 presents the words orally and collects soundcaptures of the spoken recall responses.
These soundcaptures have to be manually scored for accuracy.
Recognition and Source Responses (part2) are collected via keyboard input.

!Note: Millisecond Software also offers an alternative implementation of the Modrey with written 
recall input and the option of oral and/or visual word presentation.  Written recall in those scripts 
is captured via textboxes that are scored by the script automatically.

//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_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 speed of
1 word per second. Once the list has finished, participants are asked to recall 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) 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----------------------------------------

//(4) Delay: 1.5h//

/////////////////////////////////////////////
///////Script modrey_part2.iqjs:////////
/////////////////////////////////////////////

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

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

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

//(8) 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 +/- 5 minutes
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	 
The fields in the data files are:

(1) Raw data file: 'modrey_oralrecall_part2_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/main list (A) 
(parameter)	form:					form 1	

listCategory:						"A", "B" or "N" 														
									
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
responseText:						the letter of the response key pressed (if applicable for Recog and Source)
correct:							the correctness of the response (1 = correct; 0 = incorrect)
latency: 							the response latency (in ms)


(2) Summary data file: 'modrey_oralrecall_part2_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											
																		

//IMMEDIATE RECALL scores//									
recallScoreIR: 			needs to be computed manually
recallScoreIRListB: 		needs to be computed manually		

//FREE RECALL SCORES//	
recallScoreSDFR:			needs to be computed manually	
recallScoreLDFR: 			needs to be computed manually
recallScoreFR: 			needs to be computed manually
recallScoreLDFRListB: 	needs to be computed manually

//RECOG scores//	
recogScore:				the number of correctly identified recognition items (Max: 66)
rHitsRecog:				hitrate of correctly identifying list A words (list A words = signal)
rMissRecog:				missrate of identifying list A words (list A words = signal)
rFAsRecog:				commission rate of incorrectly identifying non-list A words as A words (list B + new words = noise)
rCRRecog:				correct rejection rate of non-list A words

*Adjustments to z-scores as recommended 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)

zHrRecog:					calculates the z-score for the hitrate. Adjustments are made if the hitrate = 0 (increased to 0.005) or 1 (decreased to 0.995), see Gregg & Sedikides (2010)
zFrRecog: 				calculates the z-score for the commission rate. Adjustments are made if the commission rate = 0 (increased to 0.005) or 1 (decreased to 0.995), see Gregg & Sedikides (2010)

dPrimeRecog:				Computes d' (parametric measure of discriminability btw. signals and noise)
							=> Range (in this script): 
							-5.1516586840152740479 <= dprime <= 5.1516586840152740479 (=perfect performance)
							=> The higher the value, the better signals (list A words) were overall distinguished from noise 
							(list B words and new words)
							(d' = 0: chance performance; 
							negative d-primes: participant treated noise as signals and signals as noise)
							
cRecog: 		c-criterion in signal detection:The absolute value of c provides an indication of the strength of
				the response bias/response style
				negative: participant more likely to report that signal (non-alcoholic stimuli) is present (liberal response style);
				may favor faster responding in speed-accuracy trade-off response paradigms
				positive: favoring caution (conservative response style)							
							
							
//RECOG scores//							
sourceScore:				the number of correctly identified source items (Max: 40)
sourceCorrectA:			the number of correctly identified list A source items (Max: 20) 
sourceCorrectB:			the number of correctly identified list B source items (Max: 20)

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

(I) 1 block: Free Recall Task of list A (LDFR)
- recall words from list A  (self-paced, soundcaptures)

(II) 1 block: Free Recall Task of list B (LDFR_listB)
- recall words from list B  (self-paced, soundcaptures)

(III) Recognition Task:
20 words from list A, 20 words from list B, and 26 non-list words are presented in fixed order.
For each word, participant has to decide whether the word is a list A word (=signal) or not
(=noise); responses via keyboard input

(IV) Source Task:
20 words from list A, 20 words from list B; presented in fixed order. 
Participant is asked to categorize each word as listA or listB word.
responses via keyboard input
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
uses the words of the ModRey (Hale et al, 2019)
(words were pronounced with Google Translate and saved as .wav files)

Groupnumber 1 (odd) - Runs version1 stimuli (see modrey_items_form1.iqjs)
Groupnumber 2 (even) - runs version2 stimuli (see modrey_items_form2.iqjs)
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
are provided by Millisecond Software - change under 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: