Return to the Prospective Memory Task - Form B page
															
___________________________________________________________________________________________________________________	

									*EVENT-BASED PROSPECTIVE MEMORY TASK*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 10-01-2015
last updated:  11-01-2019 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 11-01-2019 Millisecond Softwaree

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a computerized Event-based Prospective Memory Task similarly 
to the non-computerized one described in Cheng et al (2013).
Prospective Memory (event based) = Remembering to do in the case a certain event happens.

Reference:
Cheng, H., Yang, Z., Dong, B., Chen, C., Zhang, M., Huang, Z., Chen, Z & Kai Wang, K. (2013).
Chemotherapy-induced prospective memory impairment in patients with breast cancer.
Psycho-Oncology 22, 2391–2395 (2013)
Published online 15 May 2013 in Wiley Online Library (wileyonlinelibrary.com). DOI: 10.1002/pon.3291.

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________	
Participants are told that they participate in a visual search experiment. They are presented 'cards'
with 12 items randomly presented in a 4x3 matrix; 10 of these items belong to one category and 2 to another 
('outsiders'). Participant are asked to select the 2 outsiders by mouse click.

Prospective Memory Task1: Before the start of the task participants are also asked to do an exta click with their mouse 
whenever the 2 outsiders are two particular target words (here: "antilope" and "hamster").

Prospective Memory Task2: Additionally they are asked to let the experimenters know whether they consider
themselves to be 'morning' or 'night' people.
For this purpose, a general comment box is provided at the end of the task.

*Note: in Cheng et al (2013)
Prospective Memory Task 1: tap the desk whenever the 2 target words appear
Prospective Memory Task 2: at the end of the experiment, tell your experimenter your phone number

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 5 minutes to complete

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

(1) Raw data file: 'prospectivememorytask_versionb_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
script.sessionid:					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.
										
										
values.version:					"B"	(version B runs the morning/night question as Prospective Memory Task 2)

values.majority:					refers to the majority category (1-6)	
										1 = countries
										2 = fruit
										3 = cars
										4 = flowers
										5 = insects
										6 = cities
										
values.trialtype:					1 = target trial; 2 = foil trial				
																				
values.outsider:					refers to the outsider category (1-4; 5 = target category)	
										1 = metals
										2 = clothes
										3 = rivers
										4 = furniture pieces
										5 = mammals (TARGETS)
values.outsider1-
values.outsider2:					store the 2 randomly assigned outsider (minority) words
response:							the participant's response
 
correct:							the correctness of the response (1 = correct; 0 = incorrect)
										=> foil trials: lbuttondown is correct response; target trials: lbuttondown is correct response
										
values.finalCorrect:					0 = did not select any correct outsider; 
									1 = selected one correct outsider; 
									2 = selected both correct outsiders
									
latency: 							the response latency (in ms)

values.response1:					the first selected item
values.response2:					the second selected item

values.Hit:						stores the number of hits 
								(=pressing mouse button during intertrial interval after a target trial to indicate the target outsiders)
									
values.Miss:						stores the number of misses
								(=pressing mouse button during intertrial interval after a target trial to indicate the target outsiders)
									
values.FA:						stores the number of false alarms
								(=pressing mouse button during intertrial interval after a non-target trial to indicate the target outsiders)
									
values.CR:						stores the number of correct rejections
								(=pressing mouse button during intertrial interval after a non-target trial to indicate the target outsiders)	
									
										
values.prospectiveMemory2Response:	stores the reported handedness (-> Prospective Memory Task II)
											Note: the computer can only determine if the comment left for experimenter contains the word 'left' or 'right'
											=> the responses should be manually checked to make sure, no response that indicates a recall of the handedness task was missed.

values.finalpoints:					number of final target points earned
									(number of hits + 2 points for Prospective Memory Task 2)

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

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

values.version:					"B"	(version B runs the morning/night question as Prospective Memory Task 2)

values.Hit:						stores the number of hits 
								(=pressing mouse button during intertrial interval after a target trial to indicate the target outsiders)
									
values.Miss:						stores the number of misses
								(=pressing mouse button during intertrial interval after a target trial to indicate the target outsiders)
									
values.FA:						stores the number of false alarms
								(=pressing mouse button during intertrial interval after a non-target trial to indicate the target outsiders)
									
values.CR:						stores the number of correct rejections
								(=pressing mouse button during intertrial interval after a non-target trial to indicate the target outsiders)
									
							
Prospective Memory Task 2 Response:	stores the reported handedness (-> Prospective Memory Task II)
											Note: the computer can only determine if the comment left for experimenter contains the word 'left' or 'right'
											=> the responses should be manually checked to make sure, no response that indicates a recall of the handedness task was missed.

values.prospectiveMemory2Response:	number of final target points earned
											(number of hits + 2 points for Prospective Memory Task 2)

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

* 1 Test Block of 30 trials (6 main categories x (4 outsider categories + 1 target outsider categories))
* Target Trials: 5th, 10th, 15th, 20th, 25th, 30th (target trials randomly selected from the 6 possible combinations)
* The remaining 24 trials are randomly selected 
* Participants have as much time as needed to find the outliers

Scoring: for each successful mouse-press, participants earned a point. No penalties are given for False Alarms
(but False Alarms are recorded for subsequent data analyses).
Participants earn an additional 2 points for remembering to enter whether they consider themselves to be
"morning" or "night" people
Max: 8 points

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
Stimuli are not original to Cheng et al (2013).
In this script, there are 6 categories of main stimuli and 5 categories of outsider stimuli 
(one of them the target stimuli).
Each majority category is presented with each outsider category once (=> 6 x 5 = 30 trials).
The 2 outsider stimuli of a foil category are randomly selected from a group of 6. 
The stimuli can easily be edited under section Editable Lists.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
The provided instructions are not original to Cheng et al (2013). They are provided by Millisecond Software and 
are easily editable 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.

/ITIduration:		the duration of the intertrial interval in ms. The intertrial interval is the trial 
					that records an additional mouse press for Memory Task 1 (default: 2000ms)