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


___________________________________________________________________________________________________________________	

								Modified Rey Auditory Verbal Learning Test (ModRey) 
								- Batch Script-
								- written recall-
								(Turkish version)
___________________________________________________________________________________________________________________	

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

Script Copyright © 10-03-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 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	
___________________________________________________________________________________________________________________	

This script implements a batch script. It calls

- Script modrey_writtenrecall_part1.iqjs
- Script modrey_writtenrecall_part2.iqjs

in this fixed order and transfers summary data from part1 to part2 automatically.
Note that scripts 'modrey_writtenrecall_part1.iqjs' and 'modrey_writtenrecall_part2.iqjs' can also be run outside 
this batch script. However, in that case, no summary data transfer from part1 to part2 will take place.

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_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 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

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

___________________________________________________________________________________________________________________	
DATA
___________________________________________________________________________________________________________________	
see individual scripts
"modrey_writtenrecall_part1_turkish.iqjs"
"modrey_writtenrecall_part2_turkish.iqjs"



___________________________________________________________________________________________________________________	

								Modified Rey Auditory Verbal Learning Test (ModRey)
								- written recall -
								(Turkish instructions) 								
___________________________________________________________________________________________________________________	

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

Turkish translations generously shared by Gülsüm Gündo Du
___________________________________________________________________________________________________________________
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)

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) 
								- written recall - 
								(Turkish instructions)
___________________________________________________________________________________________________________________	

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

Turkish translations generously shared by Gülsüm Gündo Du
___________________________________________________________________________________________________________________
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 +/- 5 minutes
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	 
The fields in the data files are:

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

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

(2) Summary data file: 'modrey_writtenrecall_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											
									
///NOTE: if not explicitly mentioned, all summary variables refer to list A performance										

//IMMEDIATE RECALL scores//									
recallScoreIR: 			sum of all correctly recalled items across the 3 IMMEDIATE recall trials from part1 (Max: 60)
recallScoreIRListB:		number of correctly recalled items from the IMMEDIATE recall trial with list B from part1 (Max: 20)

//FREE RECALL SCORES//	
recallScoreSDFR:			correctly recalled items across SDFR (short delay free recall trial) during part1 (Max: 20)		
recallScoreLDFR: 			correctly recalled items across LDFR (long delay free recall trial) during part2 (Max: 20)	
recallScoreFR:				the sum of correctly recalled items across both free recall trials (SDFR + LDFR) (Max: 40)
recallScoreLDFRListB: 		correctly recalled items across LDFR (long delay free recall trial) with list B items during part2 (Max: 20)	 

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


//ADDITIONAL://
ldfrRecalledWords: 	a storage variable that stores all the words recalled for LDFR trial

recallIntrusions:		a storage variable that stores all recall intrusion words from the LDFR trial (list A only)
						Note: check for misspelled words here and adjust scores accordingly 
						
ldfrListBRecalledWords: a storage variable that stores all the words recalled for LDFR trial with list B words

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

(I) 1 block: Free Recall Task of list A (LDFR)
- enter recalled words from list A into a textbox (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: Free Recall Task of list B (LDFR_listB)
- enter recalled words from list B into a textbox (self-paced)

(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)

(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.

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